chrcconsistgrp

Use the chrcconsistgrp command to modify attributes of an existing Metro Mirror, Global Mirror, or active-active consistency group, such as changing the name of a consistency group.

Syntax

 chrcconsistgrp    [ { [  -name  new_name_arg  ] | [  -cycleperiodseconds  period  ] | [  -cyclingmode  {  none  |  multi  } ] } ] [ {  -global  |  -metro  } ]   {  rc_consist_group_name  |  rc_consist_group_id  }

Parameters

-namenew_name_arg
(Optional) Specifies the new name to assign to the consistency group.
-cycleperiodsecondsperiod
(Optional) Specifies the cycle period in seconds. The minimum cycle period value is 60 seconds, and the default is 300 seconds.
This defines an optional cycle period that applies to Global Mirror relationships with a cycling mode of multi. A Global Mirror relationship using the multicycling_mode performs a complete cycle each period. It might be provided for any relationship, but cannot be used for none when considering Metro or Global Mirror relationships.
-cyclingmodenone | multi
(Optional) Specifies the behavior of Global Mirror for this relationship.
  • Specifying none, the default, gives identical behavior to Global Mirror in previous versions of Lenovo Storage V series.
  • Specifying multi uses the cycling protocol.
To start a relationship with cycling_mode set to multi, change volumes must be defined for the relationship.
Note: The cycling_mode can only be changed when the relationship is stopped and in consistent_stopped or inconsistent_stopped states.
-metro
(Optional) Specifies the change in the consistency group's copy type and converts a Global Mirror (with or without change volumes) relationship to a Metro Mirror relationship.
Remember: To use this parameter the consistency group must be stopped (inconsistent_stopped, consistent_stopped, or idling)
-global
(Optional) Specifies the change in the consistency group's copy type and converts a Metro Mirror relationship to a Global Mirror relationship. This parameter is not mutually-exclusive with -cyclingmode. If you do not specify -cyclingmode and the relationship is Metro Mirror, the cycling_mode value is none.
Remember: To use this parameter the consistency group must be stopped (inconsistent_stopped, consistent_stopped, or idling)
rc_consist_group_name | rc_consist_group_id
(Required) Specifies the ID or existing name of the consistency group that you want to modify.

Description

This command modifies the specified attributes of the supplied consistency group, one attribute at a time.

All parameters are mutually-exclusive with the exception of the -cyclingmode, which is mutually-exclusive with all parameters but -global.

Note: One of the optional parameters must be specified.

You can change a relationship or consistency group between copy types even if replication is stopped. Consistency protection is preserved across all types, so a relationship or consistency group that is in consistent_copying state before being stopped retains the consistent copy on the secondary system when the copying type is changed.

Note: You cannot set cycling mode to multi-cycling mode if there is a relationship where the primary and secondary volume are different sizes.

A Global Mirror consistency group with cycling mode set to multi requires that change volumes are defined for the primary and secondary volumes of each relationship in the group before it can be started.

For intersystem relationships the;
  • -cycleperiodseconds and -cyclingmode parameters can only be specified when the two systems are connected. If the two systems become disconnected while the command is being processed, then the command might be completed with the change having been performed at the system that received the task invocation only (and the other system is updated upon re-connection).
For consistency groups that are active-active, you cannot change the copy type or cycling mode. This means you cannot specify these parameters:
  • -global
  • -metro
  • -cyclingmode

An invocation example to change a consistency group name from rc_testgrp to rctestone.

chrcconsistgrp -name rctestone rc_testgrp

The resulting output:

No feedback