chrcconsistgrp
Use the chrcconsistgrp command to modify attributes of an existing Metro Mirror or Global Mirror consistency group, such as changing the name of a consistency group.
Syntax
>>- chrcconsistgrp -- --+---------------------------------+-----> +- -name -- new_name_arg ---------+ +- -cycleperiodseconds -- period -+ '- -cyclingmode --+- none --+-----' '- multi -' >--+-----------+-- --+- rc_consist_group_name -+--------------->< +- -global -+ '- rc_consist_group_id ---' '- -metro --'
Parameters
- -name new_name_arg
- (Optional) Specifies the new name to assign to the consistency group.
- -cycleperiodseconds period
- (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 multi cycling_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.
- -cyclingmode none | 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® V3500.
- Specifying multi uses the cycling protocol.
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.
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.
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.
- -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).
An invocation example to change a consistency group name from rc_testgrp to rctestone.
chrcconsistgrp -name rctestone rc_testgrp
The resulting output:
No feedback