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 that uses the
multicycling_mode performs a complete cycle each period. It might be provided for any
relationship, but cannot be used for none in 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 Storwize V5000.
- 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 be changed only 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 except for 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 it is 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
volumes 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 be specified only when the two systems are connected.
If the two systems become disconnected while the command is being processed, the command might
complete with the change that is performed on the system that received the task invocation only. The
other system is updated upon reconnection.
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