cinder/releasenotes/notes/hitachi-vsp-add-hostgroup-n...

60 lines
1.9 KiB
YAML

---
features:
- |
Hitachi driver: Add a config option ``hitachi_group_name_format`` for
hostgroup name format.
When using this option, users can specify the name format of
host groups or iSCSI targets.
Rules of the format:
* Usable characters are alphanumerics, ".", "@", "_", ":", "-",
"{" and "}". "{" and "}" can be used only in variables.
* The specified value must start with ``HBSD-``.
* You can use the following variables:
``{wwn}``
`FC driver only.` This is replaced with the smallest
WWPN of the WWPNs of the connecting node.
``{ip}``
`iSCSI driver only.` This is replaced with the IP address of
the connecting node.
``{host}``
This is replaced with the host name of the connecting node.
* You can use each variable in the specified value no more than once.
* The specified value must include the following variables:
* FC driver: ``{wwn}``
* iSCSI driver: ``{ip}``
* The maximum length of a specified value is as follows:
* FC driver: 64
* iSCSI driver: 32
* In the length calculation, use the following values as the length of
each variable:
* ``{wwn}``: 16
* ``{ip}``: 15
* ``{host}``: 1
* If the specified value includes ``{host}``, the following rules apply:
* characters that are not permitted for this parameter, they are
replaced with ``_``.
* If the length of the name after variable replacement exceeds
the maximum length of host group (iSCSI target) names, the
host name is truncated so that the length of the host groups or
iSCSI targets do not exceed the maximum length.
If you specify this parameter, it is recommended that you specify ``True``
for the ``hitachi_group_create`` parameter to collect necessary
information automatically.
Examples:
* FC driver: ``HBSD-{host}-{wwn}``
* iSCSI driver: ``HBSD-{host}-{ip}``