switchrcconsistgrp

You can use the switchrcconsistgrp command to reverse the roles of primary and secondary virtual disks in a Remote Copy consistency group when that consistency group is in a consistent state. This change will be applied to all the relationships in the consistency group.

Syntax

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

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

Parameters

-primary master | aux
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
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 in a consistency group, perhaps as part of a graceful failover. Write access to the former primary vdisks is lost and write access to the new primary vdisks is acquired. This command will only be 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. This command will therefore only succeed when the consistency group is in one of the following states:

The consistency group moves to the ConsistentSynchronized state after successful completion of this command. If you specify the -primary argument with the current primary, the command has no affect.

Possible failures

Examples

An invocation example

svctask switchrcconsistgrp -primary aux rccopy2