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

Read syntax diagramSkip visual syntax diagram chrcconsistgrp -namenew_name_arg-cycleperiodsecondsperiod-cyclingmodenonemulti-global-metrorc_consist_group_namerc_consist_group_id

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 (1 minute) and the maximum is 86400 seconds (1 day). The default is 300 seconds (5 minutes).
This parameter defines an optional cycle period that applies to Global Mirror relationships with a cycling mode of multi. A Global Mirror relationship that uses the multi cycling_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.
-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 IBM Spectrum Virtualize .
  • 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. It 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