Debian Codegraph @

releasenotes/notes/hitachi-vsp-add-hostgroup-name-format-option-4c8e4a5ddd69b9bd.yaml

raw
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}``