Starting and stopping Metro Mirror, Global Mirror, or active-active relationships by using the CLI

You can use the command-line interface (CLI) to start and stop stand-alone Metro Mirror, Global Mirror, or active-active relationships. Relationships that are members of consistency groups must be started and stopped by using the consistency group CLI commands.

About this task

Complete these steps to start or stop Metro Mirror, Global Mirror or active-active relationships:

Note: Avoid concurrent service actions that affect the same remote-copy relationship or consistency group in multiple clustered systems. Where possible, run command-line interface (CLI) commands, including scripted CLI commands, on each clustered system sequentially. Running commands sequentially ensures that no single relationship or consistency group is processing concurrent commands from multiple sources.

Procedure

To start a Metro Mirror, Global Mirror, or an active-active relationship, run the startrcrelationship command.
For example, enter the following command:
```
startrcrelationship rc_rel_id
```
Where rc_rel_id is the ID of the relationship that you want to start in a stand-alone relationship.
Note: Active-active relationships can be started only if they have a state of idling.
When you restart a Metro Mirror, Global Mirror, or an active-active relationship, you can determine the previous copy direction from the previous_primary attribute that is displayed by using the lsrcrelationship command.
To stop a Metro Mirror or Global Mirror relationship, run the stoprcrelationship command. This command applies to a stand-alone relationship.
For example, enter the following command:
```
stoprcrelationship rc_rel_id
```
Where rc_rel_id is the ID of the stand-alone relationship that you want to stop mirroring I/O.
To stop an active-active relationship, the following conditions must be met:
- The -access parameter is specified.
- The state of the relationship is consistent_copying.
- The status of the relationship is primary_offline.
For example, enter the following command:
```
stoprcrelationship rc_rel_id -access 
```
Where rc_rel_id is the ID of the active-active relationship that you want to stop. The -access parameter gives hosts read or write access to a volume in an active-active relationship that contains an older but a consistent image that can be used in a disaster recovery scenario.
To restart a Metro Mirror or a Global Mirror relationship in the idling state, run the startrcrelationship command. You must use the -primary parameter to specify the copy direction if the relationship was stopped using the -access parameter. To determine the copy direction before the relationship was stopped, run the lsrcrelationship command. The previous_primary field indicates which volume was the primary (source) volume for the relationship before the relationship was stopped. When the relationship is in the idling state, the value is either master or aux. For active-active relationships which are part of a HyperSwap volume the previous_primary field is not used and the value is blank.
For example, to restart a relationship that has been stopped using the -access parameter, enter the following command:
```
startrcrelationship -primary rc_copy_direction rc_rel_id
```
Where rc_copy_direction is the value for the primary (source) volume and rc_rel_id is the ID of the relationship that you want to start in a stand-alone relationship.