switchrcrelationship

The switchrcrelationship command reverses the roles of primary and secondary virtual disks in a stand-alone Metro Mirror or Global Mirror relationship when that relationship is in a consistent state.

Syntax

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

>-- -primary --+- master -+--+- rc_rel_id ---+-----------------><
               '- aux ----'  '- rc_rel_name -'   

Parameters

-primary master | aux
(Required) Specifies whether the master disk or the auxiliary disk is to be the primary.
rc_rel_id | rc_rel_name
(Required) Specifies the ID or the name of the relationship to switch.

Description

The switchrcrelationship command applies to a stand-alone relationship. It is rejected if it is used to try to switch a relationship that is part of a consistency group. It is normally issued to reverse the roles of the primary and secondary virtual disk in a relationship perhaps as part of a failover process during a disaster recovery event. Write access to the old primary disk is lost and write access to the new primary disk is acquired. This command is successful when the relationship is in a connected, consistent state, and when reversing the direction of the relationship does not lead to a loss of consistency; that is, when the relationship is consistent and synchronized. The relationship must be in one of the following states in order for the switchrcrelationship command to process correctly:
  • ConsistentSynchronized
  • ConsistentStopped and Synchronized
  • Idling and Synchronized
The relationship moves to the ConsistentSynchronized state after the successful completion of this command. If you specify the -primary parameter with the current primary, the command has no effect.

An invocation example

svctask switchrcrelationship -primary master rccopy2

The resulting output

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