Users don't have access to all settings

[Roman Prykhodchenko]

Puppet manifests only set the very essential settings for Fuel Client like server address and user's credentials. A connection timeout, a HTTP proxy, profiling settings and any other parameters that will be introduced in future cannot be set because users basically don't know about them.

There is a need to put an example configuration files to /usr/share/doc directory.

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/239700
Committed: https://git.openstack.org/cgit/openstack/python-fuelclient/commit/?id=7c2de5aadabac766950c095140a7958b1ae18489
Submitter: Jenkins
Branch: master

commit 7c2de5aadabac766950c095140a7958b1ae18489
Author: Roman Prykhodchenko <email address hidden>
Date: Tue Oct 27 16:47:10 2015 +0100

    Install an example of a configuration file

    It's a common practice to put example file to /usr/share/doc to
    give users access to all available settings.

    DocImpact
    Closes-bug: #1510860
    Change-Id: Ie6c312329500613cdfa185be36ea950ffcf28fe7

[Egor Kotko (ykotko)]

The file fuel_client.yaml exists in the files list of the package (http://perestroika-repo-tst.infra.mirantis.net/mos-repos/centos/mos8.0-centos6-fuel/os/x86_64/Packages/python-fuelclient-8.0.0-1.mos236.noarch.rpm):
#rpm -ql python-fuelclient
...
/usr/share/doc/python-fuelclient-8.0.0/fuel_client.yaml

and package is installed:
[root@nailgun doc]# rpm -qa | grep python-fuelclient
python-fuelclient-8.0.0-236.1.git555eeac.noarch

but there is no file (fuel_client.yaml) :
[root@nailgun doc]# ls -lah /usr/share/doc/python-fuelclient-8.0.0/fuel_client.yaml
ls: cannot access /usr/share/doc/python-fuelclient-8.0.0/fuel_client.yaml: No such file or directory

VERSION:
  feature_groups:
    - mirantis
  production: "docker"
  release: "8.0"
  openstack_version: "2015.1.0-8.0"
  api: "1.0"
  build_number: "105"
  build_id: "105"
  fuel-nailgun_sha: "af02bd8f9aac1a1007f3ce17e5d7842853bd7758"
  python-fuelclient_sha: "555eeac8810c36b0616f5d12277e9099a53bb338"
  fuel-agent_sha: "9da73b497be5f91cb79f91e74d73eb0525be1c71"
  fuel-nailgun-agent_sha: "00b4b11553c250f22c0079fb74c8b782dcb7b740"
  astute_sha: "687458e949dedfa6877e3a2e683f8ee0c1cbd43c"
  fuel-library_sha: "01272e0a719c940ef3df5b4167990ff811da1b10"
  fuel-ostf_sha: "25c87380395f2e42ca01ea6357b72d4407ff4201"
  fuel-createmirror_sha: "5b61266e19eb7cdc745fea7a7d97c90f2515c921"
  fuelmenu_sha: "153c91e884a4601d30f8ebe3349170f96e3456e2"
  shotgun_sha: "25dd78a3118267e3616df0727ce746e7dead2d67"
  network-checker_sha: "518f7ef2706e564950469435f7cf27df175e1b27"
  fuel-upgrade_sha: "1e894e26d4e1423a9b0d66abd6a79505f4175ff6"
  fuelmain_sha: "b9b39ee9d3bbdb1883d924840ab691b95e1ef4d1"

[Sergey Kulanov (skulanov)]

Folks, a little update:

rpm -qs python-fuelclient
....
....
normal /usr/lib/python2.6/site-packages/python_fuelclient-8.0.0-py2.6.egg-info/entry_points.txt
normal /usr/lib/python2.6/site-packages/python_fuelclient-8.0.0-py2.6.egg-info/not-zip-safe
normal /usr/lib/python2.6/site-packages/python_fuelclient-8.0.0-py2.6.egg-info/requires.txt
normal /usr/lib/python2.6/site-packages/python_fuelclient-8.0.0-py2.6.egg-info/top_level.txt
not installed /usr/share/doc/python-fuelclient-8.0.0
not installed /usr/share/doc/python-fuelclient-8.0.0/fuel_client.yaml

it seems that we install python_fuelclient without docs, probably anaconda(?):

/var/log/anaconda.yum.log:[2015-11-02 15:24:01,795] DEBUG : TSINFO: Marking python-fuelclient-8.0.0-236.1.git555eeac.noarch as install for fuel-8.0.0-6168.1.gitebcee8b.noarch
/var/log/anaconda.yum.log:[2015-11-02 15:24:02,528] DEBUG : TSINFO: Marking 1:python-oslo-config-1.6.0-1.mos284.noarch as install for python-fuelclient-8.0.0-236.1.git555eeac.noarch
/var/log/anaconda.yum.log:[2015-11-02 15:24:02,529] DEBUG : TSINFO: Marking python-oslo-serialization-1.2.0-1.mos79.noarch as install for python-fuelclient-8.0.0-236.1.git555eeac.noarch
/var/log/anaconda.yum.log:[2015-11-02 15:24:02,531] DEBUG : TSINFO: Marking python-oslo-utils-1.2.1-1.mos176.noarch as install for python-fuelclient-8.0.0-236.1.git555eeac.noarch
/var/log/anaconda.yum.log:[2015-11-02 15:24:02,532] DEBUG : TSINFO: Marking python-oslo-i18n-1.3.1-1.mos131.noarch as install for python-fuelclient-8.0.0-236.1.git555eeac.noarch
/var/log/anaconda.yum.log:[2015-11-02 15:24:02,533] DEBUG : TSINFO: Marking python-cliff-1.9.0-1.el6.mira3.noarch as install for python-fuelclient-8.0.0-236.1.git555eeac.noarch

Then, when you run
$ yum reinstall python-fuelclient
$ rpm -qs python-fuelclient

normal /usr/lib/python2.6/site-packages/python_fuelclient-8.0.0-py2.6.egg-info/not-zip-safe
normal /usr/lib/python2.6/site-packages/python_fuelclient-8.0.0-py2.6.egg-info/requires.txt
normal /usr/lib/python2.6/site-packages/python_fuelclient-8.0.0-py2.6.egg-info/top_level.txt
normal /usr/share/doc/python-fuelclient-8.0.0
normal /usr/share/doc/python-fuelclient-8.0.0/fuel_client.yaml

[root@nailgun doc]# ls -la /usr/share/doc/python-fuelclient-8.0.0
total 12
drwxr-xr-x 2 root root 4096 Nov 2 15:41 .
drwxr-xr-x. 74 root root 4096 Nov 2 15:41 ..
-rw-r--r-- 1 root root 421 Oct 30 10:20 fuel_client.yaml

[Sergey Kulanov (skulanov)]

yep, exactly it seems anaconda configuration

https://github.com/openstack/fuel-main/blob/master/iso/ks.template#L240

[OpenStack Infra (hudson-openstack)]

Related fix proposed to branch: master
Review: https://review.openstack.org/240912

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/240912
Committed: https://git.openstack.org/cgit/openstack/fuel-main/commit/?id=2da9f556da9c4d469e86b956287d59703f7b15dc
Submitter: Jenkins
Branch: master

commit 2da9f556da9c4d469e86b956287d59703f7b15dc
Author: Sergey Kulanov <email address hidden>
Date: Mon Nov 2 18:06:09 2015 +0200

    [kickstart] Install documentation together with packages

    Remove --excludedocs flag for packages in kickstart

    Change-Id: I92d8fbe3f6e1e077761fa9047f5b30913cdd5e2e
    Related-bug: #1510860