| 1 |
--- |
| 2 |
features: |
| 3 |
- | |
| 4 |
Hitachi driver: Add a config option ``hitachi_group_name_format`` for |
| 5 |
hostgroup name format. |
| 6 |
|
| 7 |
When using this option, users can specify the name format of |
| 8 |
host groups or iSCSI targets. |
| 9 |
Rules of the format: |
| 10 |
|
| 11 |
* Usable characters are alphanumerics, ".", "@", "_", ":", "-", |
| 12 |
"{" and "}". "{" and "}" can be used only in variables. |
| 13 |
* The specified value must start with ``HBSD-``. |
| 14 |
* You can use the following variables: |
| 15 |
|
| 16 |
``{wwn}`` |
| 17 |
`FC driver only.` This is replaced with the smallest |
| 18 |
WWPN of the WWPNs of the connecting node. |
| 19 |
``{ip}`` |
| 20 |
`iSCSI driver only.` This is replaced with the IP address of |
| 21 |
the connecting node. |
| 22 |
``{host}`` |
| 23 |
This is replaced with the host name of the connecting node. |
| 24 |
|
| 25 |
* You can use each variable in the specified value no more than once. |
| 26 |
* The specified value must include the following variables: |
| 27 |
|
| 28 |
* FC driver: ``{wwn}`` |
| 29 |
* iSCSI driver: ``{ip}`` |
| 30 |
|
| 31 |
* The maximum length of a specified value is as follows: |
| 32 |
|
| 33 |
* FC driver: 64 |
| 34 |
* iSCSI driver: 32 |
| 35 |
|
| 36 |
* In the length calculation, use the following values as the length of |
| 37 |
each variable: |
| 38 |
|
| 39 |
* ``{wwn}``: 16 |
| 40 |
* ``{ip}``: 15 |
| 41 |
* ``{host}``: 1 |
| 42 |
|
| 43 |
* If the specified value includes ``{host}``, the following rules apply: |
| 44 |
|
| 45 |
* characters that are not permitted for this parameter, they are |
| 46 |
replaced with ``_``. |
| 47 |
* If the length of the name after variable replacement exceeds |
| 48 |
the maximum length of host group (iSCSI target) names, the |
| 49 |
host name is truncated so that the length of the host groups or |
| 50 |
iSCSI targets do not exceed the maximum length. |
| 51 |
|
| 52 |
If you specify this parameter, it is recommended that you specify ``True`` |
| 53 |
for the ``hitachi_group_create`` parameter to collect necessary |
| 54 |
information automatically. |
| 55 |
|
| 56 |
Examples: |
| 57 |
|
| 58 |
* FC driver: ``HBSD-{host}-{wwn}`` |
| 59 |
* iSCSI driver: ``HBSD-{host}-{ip}`` |