[Docs] Cinder multiple stores for glance
Change-Id: I1ec4d3f3f57f8a0576ea5ed09a289ab27882104b
This commit is contained in:
Abhishek Kekane
parent
552d902b91
commit
9bd06d24ac
@ -912,11 +912,6 @@ using a pool called ``images``, run::
|
|||||||
Configuring the Cinder Storage Backend
|
Configuring the Cinder Storage Backend
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
**Note**: Currently Cinder store is experimental. Current deployers should be
|
|
||||||
aware that the use of it in production right now may be risky. It is expected
|
|
||||||
to work well with most iSCSI Cinder backends such as LVM iSCSI, but will not
|
|
||||||
work with some backends especially if they don't support host-attach.
|
|
||||||
|
|
||||||
**Note**: To create a Cinder volume from an image in this store quickly, additional
|
**Note**: To create a Cinder volume from an image in this store quickly, additional
|
||||||
settings are required. Please see the
|
settings are required. Please see the
|
||||||
`Volume-backed image <https://docs.openstack.org/cinder/latest/admin/blockstorage-volume-backed-image.html>`_
|
`Volume-backed image <https://docs.openstack.org/cinder/latest/admin/blockstorage-volume-backed-image.html>`_
|
||||||
@ -1057,6 +1052,228 @@ documentation for more information.
|
|||||||
|
|
||||||
Path to the rootwrap configuration file to use for running commands as root.
|
Path to the rootwrap configuration file to use for running commands as root.
|
||||||
|
|
||||||
|
Configuring multiple Cinder Storage Backend
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
From Victoria onwards Glance fully supports configuring multiple cinder
|
||||||
|
backends and user/operator will decide which cinder backend to use. While
|
||||||
|
using cinder as a store for glance, operator may configure which volume
|
||||||
|
types to used by setting the ``enabled_backends`` configuration option in
|
||||||
|
``glance-api.conf``. For each of the stores defined in ``enabled_backends``
|
||||||
|
administrator has to set specific ``volume_type`` using
|
||||||
|
``cinder_volume_type`` configuration option in its own config section.
|
||||||
|
|
||||||
|
**NOTE** Even in cinder one backend can be associated with multiple
|
||||||
|
volume type(s), glance will support only one store per cinder volume type.
|
||||||
|
|
||||||
|
Below are some multiple cinder store configuration examples.
|
||||||
|
|
||||||
|
Example 1: Fresh deployment
|
||||||
|
|
||||||
|
For example, if cinder has configured 2 volume types `fast` and `slow` then
|
||||||
|
glance configuration should look like;::
|
||||||
|
|
||||||
|
[DEFAULT]
|
||||||
|
# list of enabled stores identified by their property group name
|
||||||
|
enabled_backends = fast:cinder, slow:cinder
|
||||||
|
|
||||||
|
# the default store, if not set glance-api service will not start
|
||||||
|
[glance_store]
|
||||||
|
default_backend = fast
|
||||||
|
|
||||||
|
# conf props for fast store instance
|
||||||
|
[fast]
|
||||||
|
rootwrap_config = /etc/glance/rootwrap.conf
|
||||||
|
cinder_volume_type = glance-fast
|
||||||
|
description = LVM based cinder store
|
||||||
|
cinder_catalog_info = volumev2::publicURL
|
||||||
|
cinder_store_auth_address = http://localhost/identity/v3
|
||||||
|
cinder_store_user_name = glance
|
||||||
|
cinder_store_password = admin
|
||||||
|
cinder_store_project_name = service
|
||||||
|
# etc..
|
||||||
|
|
||||||
|
# conf props for slow store instance
|
||||||
|
[slow]
|
||||||
|
rootwrap_config = /etc/glance/rootwrap.conf
|
||||||
|
cinder_volume_type = glance-slow
|
||||||
|
description = NFS based cinder store
|
||||||
|
cinder_catalog_info = volumev2::publicURL
|
||||||
|
cinder_store_auth_address = http://localhost/identity/v3
|
||||||
|
cinder_store_user_name = glance
|
||||||
|
cinder_store_password = admin
|
||||||
|
cinder_store_project_name = service
|
||||||
|
# etc..
|
||||||
|
|
||||||
|
Example 2: Upgrade from single cinder store to multiple cinder stores, if
|
||||||
|
`default_volume_type` is set in `cinder.conf` and `cinder_volume_type` is
|
||||||
|
also set in `glance-api.conf` then operator needs to create one store in
|
||||||
|
glance where `cinder_volume_type` is same as the old glance configuration::
|
||||||
|
|
||||||
|
# cinder.conf
|
||||||
|
The glance administrator has to find out what the default volume-type is
|
||||||
|
in the cinder installation, so he/she needs to discuss with either cinder
|
||||||
|
admin or cloud admin to identify default volume-type from cinder and then
|
||||||
|
explicitly configure that as the value of ``cinder_volume_type``.
|
||||||
|
|
||||||
|
Example config before upgrade::
|
||||||
|
|
||||||
|
# old configuration in glance
|
||||||
|
[glance_store]
|
||||||
|
stores = cinder, file, http
|
||||||
|
default_store = cinder
|
||||||
|
cinder_state_transition_timeout = 300
|
||||||
|
rootwrap_config = /etc/glance/rootwrap.conf
|
||||||
|
cinder_catalog_info = volumev2::publicURL
|
||||||
|
cinder_volume_type = glance-old
|
||||||
|
|
||||||
|
Example config after upgrade::
|
||||||
|
|
||||||
|
# new configuration in glance
|
||||||
|
[DEFAULT]
|
||||||
|
enabled_backends = old:cinder, new:cinder
|
||||||
|
|
||||||
|
[glance_store]
|
||||||
|
default_backend = new
|
||||||
|
|
||||||
|
[new]
|
||||||
|
rootwrap_config = /etc/glance/rootwrap.conf
|
||||||
|
cinder_volume_type = glance-new
|
||||||
|
description = LVM based cinder store
|
||||||
|
cinder_catalog_info = volumev2::publicURL
|
||||||
|
cinder_store_auth_address = http://localhost/identity/v3
|
||||||
|
cinder_store_user_name = glance
|
||||||
|
cinder_store_password = admin
|
||||||
|
cinder_store_project_name = service
|
||||||
|
# etc..
|
||||||
|
|
||||||
|
[old]
|
||||||
|
rootwrap_config = /etc/glance/rootwrap.conf
|
||||||
|
cinder_volume_type = glance-old # as per old cinder.conf
|
||||||
|
description = NFS based cinder store
|
||||||
|
cinder_catalog_info = volumev2::publicURL
|
||||||
|
cinder_store_auth_address = http://localhost/identity/v3
|
||||||
|
cinder_store_user_name = glance
|
||||||
|
cinder_store_password = admin
|
||||||
|
cinder_store_project_name = service
|
||||||
|
# etc..
|
||||||
|
|
||||||
|
Example 3: Upgrade from single cinder store to multiple cinder stores, if
|
||||||
|
`default_volume_type` is not set in `cinder.conf` neither `cinder_volume_type`
|
||||||
|
set in `glance-api.conf` then administrator needs to create one store in
|
||||||
|
glance to replicate exact old configuration::
|
||||||
|
|
||||||
|
# cinder.conf
|
||||||
|
The glance administrator has to find out what the default volume-type is
|
||||||
|
in the cinder installation, so he/she needs to discuss with either cinder
|
||||||
|
admin or cloud admin to identify default volume-type from cinder and then
|
||||||
|
explicitly configure that as the value of ``cinder_volume_type``.
|
||||||
|
|
||||||
|
Example config before upgrade::
|
||||||
|
|
||||||
|
# old configuration in glance
|
||||||
|
[glance_store]
|
||||||
|
stores = cinder, file, http
|
||||||
|
default_store = cinder
|
||||||
|
cinder_state_transition_timeout = 300
|
||||||
|
rootwrap_config = /etc/glance/rootwrap.conf
|
||||||
|
cinder_catalog_info = volumev2::publicURL
|
||||||
|
|
||||||
|
Example config after upgrade::
|
||||||
|
|
||||||
|
# new configuration in glance
|
||||||
|
[DEFAULT]
|
||||||
|
enabled_backends = old:cinder, new:cinder
|
||||||
|
|
||||||
|
[glance_store]
|
||||||
|
default_backend = new
|
||||||
|
|
||||||
|
# cinder store as per old (single store configuration)
|
||||||
|
[old]
|
||||||
|
rootwrap_config = /etc/glance/rootwrap.conf
|
||||||
|
description = LVM based cinder store
|
||||||
|
cinder_catalog_info = volumev2::publicURL
|
||||||
|
cinder_store_auth_address = http://localhost/identity/v3
|
||||||
|
cinder_store_user_name = glance
|
||||||
|
cinder_store_password = admin
|
||||||
|
cinder_store_project_name = service
|
||||||
|
# etc..
|
||||||
|
|
||||||
|
[new]
|
||||||
|
rootwrap_config = /etc/glance/rootwrap.conf
|
||||||
|
cinder_volume_type = glance-new
|
||||||
|
description = NFS based cinder store
|
||||||
|
cinder_catalog_info = volumev2::publicURL
|
||||||
|
cinder_store_auth_address = http://localhost/identity/v3
|
||||||
|
cinder_store_user_name = glance
|
||||||
|
cinder_store_password = admin
|
||||||
|
cinder_store_project_name = service
|
||||||
|
# etc..
|
||||||
|
|
||||||
|
Example 4: Upgrade from single cinder store to multiple cinder stores, if
|
||||||
|
`default_volume_type` is set in `cinder.conf` but `cinder_volume_type` is
|
||||||
|
not set in `glance-api.conf` then administrator needs to set
|
||||||
|
`cinder_volume_type` same as the `default_backend` set in `cinder.conf` to
|
||||||
|
one of the store::
|
||||||
|
|
||||||
|
# cinder.conf
|
||||||
|
The glance administrator has to find out what the default volume-type is
|
||||||
|
in the cinder installation, so he/she needs to discuss with either cinder
|
||||||
|
admin or cloud admin to identify default volume-type from cinder and then
|
||||||
|
explicitly configure that as the value of ``cinder_volume_type``.
|
||||||
|
|
||||||
|
Example config before upgrade::
|
||||||
|
|
||||||
|
# old configuration in glance
|
||||||
|
[glance_store]
|
||||||
|
stores = cinder, file, http
|
||||||
|
default_store = cinder
|
||||||
|
cinder_state_transition_timeout = 300
|
||||||
|
rootwrap_config = /etc/glance/rootwrap.conf
|
||||||
|
cinder_catalog_info = volumev2::publicURL
|
||||||
|
|
||||||
|
Example config after upgrade::
|
||||||
|
|
||||||
|
# new configuration in glance
|
||||||
|
[DEFAULT]
|
||||||
|
enabled_backends = old:cinder,new:cinder
|
||||||
|
|
||||||
|
[glance_store]
|
||||||
|
default_backend = old
|
||||||
|
|
||||||
|
[old]
|
||||||
|
rootwrap_config = /etc/glance/rootwrap.conf
|
||||||
|
cinder_volume_type = glance-old # as per old cinder.conf
|
||||||
|
description = LVM based cinder store
|
||||||
|
cinder_catalog_info = volumev2::publicURL
|
||||||
|
cinder_store_auth_address = http://localhost/identity/v3
|
||||||
|
cinder_store_user_name = glance
|
||||||
|
cinder_store_password = admin
|
||||||
|
cinder_store_project_name = service
|
||||||
|
# etc..
|
||||||
|
|
||||||
|
[new]
|
||||||
|
rootwrap_config = /etc/glance/rootwrap.conf
|
||||||
|
cinder_volume_type = glance-new
|
||||||
|
description = NFS based cinder store
|
||||||
|
cinder_catalog_info = volumev2::publicURL
|
||||||
|
cinder_store_auth_address = http://localhost/identity/v3
|
||||||
|
cinder_store_user_name = glance
|
||||||
|
cinder_store_password = admin
|
||||||
|
cinder_store_project_name = service
|
||||||
|
# etc..
|
||||||
|
|
||||||
|
While upgrading from single cinder stores to multiple single stores, location
|
||||||
|
URLs for legacy images will be changed from ``cinder://volume-id`` to
|
||||||
|
``cinder://store-name/volume-id``.
|
||||||
|
|
||||||
|
**Note** After upgrade from single cinder store to use multiple cinder
|
||||||
|
stores the first ``image-list`` or first ``GET`` or ``image-show`` call for
|
||||||
|
image will take additional time as we will perform the lazy loading
|
||||||
|
operation to update legacy image location url to use new image location urls.
|
||||||
|
Subsequent ``GET`` or ``image-list`` or ``image-show`` calls will perform as
|
||||||
|
they were performing earlier.
|
||||||
|
|
||||||
Configuring the VMware Storage Backend
|
Configuring the VMware Storage Backend
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user