stoprcrelationship

You can use the stoprcrelationship command to stop the copy process for a Remote Copy relationship. It may also be used to enable write access to a consistent secondary VDisk.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svctask -- -- stoprcrelationship -- --+-----------+-- ------>
                                          '- -access -'

>--+- rc_rel_id ---+-------------------------------------------><
   '- rc_rel_name -'

Parameters

-access
Specifies the allow access flag which gives the user write access to a consistent secondary.
rc_rel_id | rc_rel_name
Specifies the ID or name of the relationship to stop. Specify only for stand-alone relationships.

Description

This command applies to a standalone relationship. It will be rejected if it is addressed to a relationship that is part of a consistency group. You can issue this command to stop a relationship that is copying from primary to secondary.

If the relationship is in an inconsistent state, any copy operation stops and will not resume until you issue a svctask startrcrelationship command. Write activity will no longer be copied from the primary to the secondary virtual disk. For a relationship in the ConsistentSynchronized state, this command causes a consistency freeze.

When a relationship is in a consistent state (ie, in the ConsistentStopped, ConsistentSynchronized, or ConsistentDisconnected state) then the -access argument may be used with the stoprcrelationship command to enable write access to the secondary virtual disk.

Initial state Final state Notes
InconsistentStopped InconsistentStopped
InconsistentCopying InconsistentStopped
ConsistentStopped ConsistentStopped -access permitted
ConsistentSynchronized ConsistentStopped -access permitted
Idling ConsistentStopped -access permitted
IdlingDisconnected unchanged A relationship may move to stopped state when reconnected.
InconsistentDisconnected InconsistentStopped On the cluster issuing the svctask stoprcrelationship command.
InconsistentDisconnected unchanged On the disconnected cluster.
ConsistentDisconnected ConsistentStopped On the cluster issuing the svctask stoprcrelationship command, -access permitted.
ConsistentDisconnected unchanged On the disconnected cluster, -access permitted.

Possible failures

Examples

An invocation example

svctask stoprcrelationship rccopy1