glance/releasenotes/notes/consistent-store-names-57374b9505d530d0.yaml
Dharini Chandrasekar dfa0682cac Fixing inconsistency in Glance store names.
The store names used in glance and glance_store are not in sync with
each other.

This can confuse operators who have to use different names to refer to
the same store while setting values for configuration options such as
``store_type_preference`` in glance and configuration option like
``store`` in glance_store. This inconsistency may also confuse
developers during code changes, complicating future code changes with
respect to this.

Mapping store names: ``vmware_datastore`` and ``filesystem``
to ``vmware`` and ``file`` respectively to be in sync with glance_store
entry point names and at the same time accommodate backward
compatibility for old configuration files that might still be using
``filesystem`` and ``vmware_datastore``.
Note: This change applies only when multiple image locations are being
used and ``location_strategy`` configuration option is set to
``store_type``.

Note: This change does not require a config refresh change.

Impact:
UpgradeImpact

Credit:
This patch has a release note authored by Brian Rosmaita

Change-Id: I3d8593cdae6780ae721afedcf47dd45afa684f25
Closes-Bug: #1615852
2016-09-23 16:11:18 +00:00

33 lines
1.4 KiB
YAML

---
upgrade:
- |
Some backend store names were inconsistent between glance
and glance_store. This meant that operators of the
VMware datastore or file system store were required to use
store names in ``glance-api.conf`` that did not correspond
to any valid identifier in glance_store. As this situation
encouraged misconfiguration and operator unhappiness, we
have made the store names consistent in the Newton
release. What this means for you:
* This change applies only to operators who are using
multiple image locations
* This change applies only to operators using the VMware
datastore or filesystem stores
* This change applies only to the ``store_type_preference``
option
* *VMware datastore operators*: The old name, now
**DEPRECATED**, was ``vmware_datastore``. The **new**
name, used in both glance and glance_store, is
``vmware``
* *File system store operators*: the old name, now
**DEPRECATED**, was ``filesystem``. The **new** name,
used in both glance and glance_store, is ``file``
* This change is backward compatible, that is, the old
names will be recognized by the code during the deprecation
period. Support for the deprecated names will be removed in
the **Pike** release
* We strongly encourage operators to modify their
``glance-api.conf`` files immediately to use the **new**
names