switchrcrelationship

You can use the switchrcrelationship to reverse the roles of primary and secondary virtual disks in a Remote Copy 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
Specifies whether the master or auxiliary is to be the primary.
rc_rel_id | rc_rel_name
Specifies the ID or name of the relationship to switch.

Description

This command applies to a stand-alone relationship. It will be 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 or consistency group, perhaps as part of a graceful failover. Write access to the old primary is lost and write access to the new primary is acquired. This command will only be successful when the relationship is in a connected, consistent state, and when reversing the direction of the relationship would not lead to a loss of consistency, ie when the relationship is consistent and synchronized. This command will therefore only succeed when the relationship is in one of the following states:

The relationship 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 switchrcrelationship -primary master rccopy2