switchrcconsistgrp

The switchrcconsistgrp command reverses the roles of the primary and secondary virtual disks (VDisks) in a Metro Mirror or Global Mirror consistency group when that consistency group is in a consistent state. All the relationships in the consistency group are affected by this change.

Syntax

Read syntax diagramSkip visual syntax diagram
>>- svctask -- -- switchrcconsistgrp -- ------------------------>

>-- -primary --+- master -+--+- rc_consist_group_id ---+-------><
               '- aux ----'  '- rc_consist_group_name -'   

Parameters

-primary master | aux
(Required) Specifies whether the master or auxiliary side of the relationships in the group will become the primary VDisks.
rc_consist_group_id | rc_consist_group_name
(Required) Specifies the ID or name of the consistency group to switch.

Description

This command applies to a consistency group. It is normally issued to reverse the roles of the primary and secondary virtual disks in a consistency group, perhaps as part of a failover process that is associated with a disaster recovery event. Write access to the former primary VDisks is lost and write access to the new primary VDisks is acquired. This command is successful when the consistency group is in a connected, consistent state, and when reversing the direction of the relationships would not lead to a loss of consistency, for example, when the consistency group is consistent and synchronized. The consistency group must be in one of the following states in order for the switchrcconsistgrp command to process correctly:
  • ConsistentSynchronized
  • ConsistentStopped and Synchronized
  • Idling and Synchronized
The consistency group moves to the ConsistentSynchronized state after the successful completion of this command. If you specify the -primary parameter and it is the same as the current primary, the command has no effect.

An invocation example

svctask switchrcconsistgrp -primary aux rccopy2

The resulting output

No feedback
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2003, 2009. All Rights Reserved.