Installation documentation is broken or outdated

[Dr. Jens Harbott]

http://docs.openstack.org/developer/gnocchi/configuration.html#configuration calls for the download of
https://raw.githubusercontent.com/openstack/gnocchi/master/etc/gnocchi/gnocchi-config-generator.conf in order to generate an initial config file, but that file seems to have been removed for 2.0.

[Dr. Jens Harbott (j-harbott)]

After looking at the repo, I found the file at https://raw.githubusercontent.com/openstack/gnocchi/master/gnocchi-config-generator.conf but if I try to use it, the next error is:

$ oslo-config-generator --config-file=gnocchi-config-generator.conf --output-file=gnocchi.conf
Traceback (most recent call last):
  File "/usr/local/bin/oslo-config-generator", line 11, in <module>
    sys.exit(main())
  File "/usr/local/lib/python2.7/dist-packages/oslo_config/generator.py", line 419, in main
    generate(conf)
  File "/usr/local/lib/python2.7/dist-packages/oslo_config/generator.py", line 401, in generate
    groups = _get_groups(_list_opts(conf.namespace))
  File "/usr/local/lib/python2.7/dist-packages/oslo_config/generator.py", line 333, in _list_opts
    loaders = _get_raw_opts_loaders(namespaces)
  File "/usr/local/lib/python2.7/dist-packages/oslo_config/generator.py", line 305, in _get_raw_opts_loaders
    invoke_on_load=False)
  File "/usr/local/lib/python2.7/dist-packages/stevedore/named.py", line 55, in __init__
    verify_requirements)
  File "/usr/local/lib/python2.7/dist-packages/stevedore/extension.py", line 171, in _load_plugins
    self._on_load_failure_callback(self, ep, err)
  File "/usr/local/lib/python2.7/dist-packages/stevedore/extension.py", line 163, in _load_plugins
    verify_requirements,
  File "/usr/local/lib/python2.7/dist-packages/stevedore/named.py", line 123, in _load_one_plugin
    verify_requirements,
  File "/usr/local/lib/python2.7/dist-packages/stevedore/extension.py", line 186, in _load_one_plugin
    plugin = ep.load(require=verify_requirements)
  File "/usr/lib/python2.7/dist-packages/pkg_resources.py", line 2088, in load
    entry = __import__(self.module_name, globals(),globals(), ['__name__'])
  File "/usr/local/lib/python2.7/dist-packages/gnocchi/opts.py", line 20, in <module>
    import gnocchi.indexer
  File "/usr/local/lib/python2.7/dist-packages/gnocchi/indexer/__init__.py", line 22, in <module>
    from oslo_utils import netutils
  File "/usr/local/lib/python2.7/dist-packages/oslo_utils/netutils.py", line 281, in <module>
    class _ModifiedSplitResult(parse.SplitResult):
AttributeError: 'Module_six_moves_urllib_parse' object has no attribute 'SplitResult'

The platform I am running on is Ubuntu Trusty and I installed with

pip install gnocchi[postgresql,ceph,keystone,doc,test]

[Julien Danjou (jdanjou)]

What version of python-six is installed on your system?

[Dr. Jens Harbott (j-harbott)]

# apt-cache policy python-six
python-six:
  Installed: 1.5.2-1ubuntu1
  Candidate: 1.5.2-1ubuntu1
  Version table:
 *** 1.5.2-1ubuntu1 0
        500 http://archive.ubuntu.com/ubuntu/ trusty-updates/main amd64 Packages
        100 /var/lib/dpkg/status
     1.5.2-1 0
        500 http://archive.ubuntu.com/ubuntu/ trusty/main amd64 Packages

I had to install these packages in order to get the pip install working:

python-pip python-dev libpq-dev python-numpy

After doing a "pip install -U six", the config-generator works fine indeed with six=1.10.0 installed.

[Julien Danjou (jdanjou)]

Yup, so this a problem with pip not satisfying requirements. oslo.utils wants six 1.9.0 minimum.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/291282

[Dr. Jens Harbott (j-harbott)]

If I understand pip correctly, since gnocchi requires six directly, but without any version requirement, once that is satisfied, all later requirements are ignored. So probably gnocchi should have six >=1.9.0 in its requirements to make pip install work.

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/291282
Committed: https://git.openstack.org/cgit/openstack/gnocchi/commit/?id=a48f3322a1fcec99e3cc4eabd5157fc929c9ed81
Submitter: Jenkins
Branch: master

commit a48f3322a1fcec99e3cc4eabd5157fc929c9ed81
Author: Julien Danjou <email address hidden>
Date: Thu Mar 10 17:26:02 2016 +0100

    doc: fix link to config generator conf file

    Change-Id: I9c5322ec9de709105a7b1e091245f43c4a21de1c
    Closes-Bug: #1555658

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: stable/2.0
Review: https://review.openstack.org/291666

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/291666
Committed: https://git.openstack.org/cgit/openstack/gnocchi/commit/?id=70252c845becb53f06b60e4afee606b8c20207da
Submitter: Jenkins
Branch: stable/2.0

commit 70252c845becb53f06b60e4afee606b8c20207da
Author: Julien Danjou <email address hidden>
Date: Thu Mar 10 17:26:02 2016 +0100

    doc: fix link to config generator conf file

    Change-Id: I9c5322ec9de709105a7b1e091245f43c4a21de1c
    Closes-Bug: #1555658
    (cherry picked from commit a48f3322a1fcec99e3cc4eabd5157fc929c9ed81)