Customizing consistency group name

You can customize the consistency group name of the storage subsystems.

Custom consistency group (CG) name for EMC storage subsystem

You can customize the consistency group names of the EMC storage subsystems at both home and backup sites, and assign two different custom consistency group names at the home site and the backup site. The option customcgname is used to set the custom consistency group name for the home site storage, and the option bsitecgname is used to set custom consistency group name at the backup site. The options to set up or modify the custom consistency group names for both home site and the backup site can be used only before the first discovery of the host group or the workgroup. After the first discovery, setting up or modifying the custom consistency group name is not allowed. Also, setting up or modifying the custom consistency group name is not allowed when an operation is in progress in the host group or in the workgroup.

To create a host group with custom consistency group name at the home site and at the backup site, run the following command:
```
ksysmgr add hg <host_group_name> hosts=<host1[,host2,...]> customcgname=<CgName> bsitecgname=<CgName>
```
An output similar to the following example is displayed:
```
Host_group <host_group_name> added successfully
```

To modify a host group with custom consistency group name at the home site and at the backup site, run the following command:

ksysmgr modify host_group <host_group_name> options customcgname=<CgName> bsitecgname=<CgName>

An output similar to the following example is displayed:

For Host_group <host_group_name> attribute(s) 'customcgname', 'bsitecgname' was successfully modified.

To view the details of a custom consistency group name, run the following command:

ksysmgr q hg <host_group_name>

An output similar to the following example is displayed:

Name:                <host_group_name>
Home Site Hosts:     none
Backup Site Hosts:   none
Workgroups:          none
Memory_capacity:     Priority Based Settings
                     low:100
                     medium:100
                     high:100
CPU_capacity:        Priority Based Settings
                     low:100
                     medium:100
                     high:100
Skip_power_on:       No
sriov_override:       No
Vnic_override:        No
Site:
Vswitchmap:          Not currently set
Vlanmap:             Not currently set
DrVswitchmap:        Not currently set
DrVlanmap:           Not currently set
Type:                symmetric
Custom CG Name:      <host_group_name>_HSITECG
Backup Site CG Name: <host_group_name>_BSITECG

To create a workgroup with custom consistency group name at the home site and at the backup site, run the following command:
```
ksysmgr add workgroup <name> vm=<vmname1[,vmname2...]> [customcgname=<CgName>] [bsitecgname=<CgName>]
```

To modify a workgroup with custom consistency group name at the home site and at the backup site, run the following command:

ksysmgr modify workgroup <name>
      { [policy=<add | delete> vm=<vmname1|vmuuid1[,vmname2|vmuuid2...]>]
        [customcgname=<CgName>]
        [bsitecgname=<CgName>] }

To view the details of a custom consistency group name in a disk group, run the following command:

ksysmgr query disk_group

An output similar to the following example is displayed:

Name:            VMRDG_appy_DR_Site2_3
Site:            Site2
Hosts:           Host1_Site2
Storages:        saremote_emc
CG:              DWG2_Bsite_cg

Name:            VMRDG_appy_DR_Site1_3
Site:            Site1
Hosts:           Host1_Site1
Storages:        salocal_emc
CG:              DWG2_Hsite_cg

Note:

If the custom consistency group name is not provided for the EMC storage subsystem for the backup site or the home site, the KSYS subsystem automatically provides a default consistency group name for the EMC storage subsystems.
If the workgroup feature is enabled for the host group, the custom consistency group name cannot be assigned at the host group level. In such cases, you must assign the custom consistency group name for each workgroup separately.

Custom consistency group (CG) name for IBM XIV, IBM SAN Volume Controller (SVC), and Hitachi storage systems

You can customize the consistency group names of the IBM XIV, IBM SAN Volume Controller (SVC), and Hitachi storage systems. The consistency group name can be customized during the creation or modification of a host group or a workgroup. You can customize the consistency group name only before the first discovery of the host group or the workgroup. After the first discovery, setting up or modifying the custom consistency group name is not allowed. Also, setting up or modifying the custom consistency group name is not allowed when an operation is in progress in the host group or in the workgroup. The same customized consistency group name of a storage system is used for both the home site and the backup site.

To create a host group with custom consistency group name, run the following command:
```
ksysmgr add host_group <host_group_name> hosts=<host1[,host2,...]> [customcgname=<CgName>] 
```
Note: The SVC storage system considers only 15 characters for the consistency group name. If the input name (customcgname) consists of more than 15 characters, only the first 15 characters are considered for the consistency group name and the other characters are ignored during consistency group creation on storage. Similarly, each storage system type has its own criteria for the maximum length for the consistency group name. So, ensure that the consistency group name is in accordance with the respective storage system.
To modify a host group with custom consistency group name, run the following command:
```
ksysmgr modify host_group <name> options [customcgname=<CgName>]
```
An output similar to the following example is displayed:
```
For host_group <name> attribute(s) 'customcgname' was successfully modified.
```
To create a workgroup with custom consistency group name, run the following command:
```
ksysmgr add workgroup <name> vm=<vmname1[,vmname2...]> [customcgname=<CgName>]
```

To modify a workgroup with custom consistency group name, run the following command:

ksysmgr modify workgroup <name>
      { [policy=<add | delete> vm=<vmname1|vmuuid1[,vmname2|vmuuid2...]>]
        [customcgname=<CgName>]}

To view the details of a custom consistency group name in a host group, run the following command:

ksysmgr query hg [<host_group_name>]

An output similar to the following example is displayed:

Name:                <hostgroup_name>
Home Site Hosts:     none
Backup Site Hosts:   none
Workgroups:          none
Memory_capacity:     Priority Based Settings
                     low:100
                     medium:100
                     high:100
CPU_capacity:        Priority Based Settings
                     low:100
                     medium:100
                     high:100
Skip_power_on:       No
sriov_override:       No
Vnic_override:        No
Site:
Vswitchmap:          Not currently set
Vlanmap:             Not currently set
DrVswitchmap:        Not currently set
DrVlanmap:           Not currently set
Type:                symmetric
Custom CG Name:      Hg2_customCg
Backup Site CG Name: Hg2_customCg

To view the details of a custom consistency group name in a workgroup, run the following command:

ksysmgr query wg [<WGName>]

An output similar to the following example is displayed:

Name:                DWG2
VMs:                 x66xxxxx005         
                     x66xxxxx004
Host_group:          HG1
Site:                Austin
Custom CG Name:      DWG2_CUSTOMCG
Backup Site CG Name: DWG2_CUSTOMCG

To view the details of a custom consistency group name in a disk group, run the following command:

ksysmgr query disk_group [<disk_group_name>]

An output similar to the following example is displayed:

Name:            VMRDG_appy_DR_America_2
Site:            America
Hosts:           night_9179-MHD-1081BA6
Storages:        saremote_svc
CG:              Hg2_customCg

Name:            VMRDG_appy_DR_India_2
Site:            India
Hosts:           d66crimea-8246-L2T-1006D4A
Storages:        salocal_svc
CG:              Hg2_customCg

Note: If the workgroup feature is enabled for the host group,the custom consistency group name cannot be assigned at the host group level. In such cases, you must assign the custom consistency group name for each workgroup separately.