Add user defined extra capabilities

[OpenStack Infra]

https://review.openstack.org/59967
commit 9bcd7285b575cdcf0fe521bf01609bd21c48fd1c
Author: Ollie Leahy <email address hidden>
Date: Thu Jan 9 15:14:11 2014 +0000

    Add user defined extra capabilities

    Provide a mechanism that will allow sys admins who are managing cinder
    installations with multiple backends to assign key/value pairs to
    backends. The key/value pairs can be used by the capabilities scheduler
    to select between backends when requests specify volume types.

    For example a sysadmin could specify the key 'service_level' with the
    values 'high', 'medium' and 'low' for different backends. The sys admin
    specifies the 'service_level' for each backend in cinder.conf as a json
    string, for example:

    extra_capabilities='{"service_level"="high"}'

    or

    extra_capabilities='{"service_level"="medium"}'

    DocImpact
    Implements: blueprint admin-defined-capabilities
    Change-Id: I1ee9dcb22b3f097c3f3b2a70b0cb672930407cc9

[Andreas Jaeger (jaegerandi)]

The config option itself is documented in doc/common/tables/cinder-api.xml, do we need further documentation or is this enough?

[Tom Fifield (fifieldt)]

indeed. Cinder option text should probably be updated

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/143850
Committed: https://git.openstack.org/cgit/openstack/cinder/commit/?id=a2a1123247a735f8fb18089ef857dc2b77b8a960
Submitter: Jenkins
Branch: master

commit a2a1123247a735f8fb18089ef857dc2b77b8a960
Author: Tom Fifield <email address hidden>
Date: Wed Dec 24 23:38:32 2014 +0900

    Expand the description of extra_capabilities

    The existing description of extra_capabilities was a bit terse,
    meaning deployers couldn't easily gauge the power of this option.
    This patch expands the textual description using information from
    the blueprint and original commit message, so it can be picked
    up automatically by the documentation.

    Change-Id: Iac2b6d8a3ce4875a8c1d9874dd7f0e4cf7c435c0
    Closes-Bug: 1288044

[Tom Fifield (fifieldt)]

cinder patch merged, this now just needs a run of autogenerate-config-docd