startrcconsistgrp

You can use the startrcconsistgrp command to start the Remote Copy consistency group copy process, set the direction of copy if undefined, and optionally mark the secondary VDisks of the consistency group as clean.

Syntax

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

>--+--------------------------+-- --+----------+-- ------------->
   '- -primary --+- master -+-'     '- -force -'
                 '- aux ----'

>--+----------+-- --+- rc_consist_group_id ---+----------------><
   '- -clean -'     '- rc_consist_group_name -'

Parameters

-primary master | aux
This parameter specifies the copy direction by defining wether the master or auxiliary will become the primary (source). This parameter is required when the primary is undefined, for example if the consistency group is in the idling state. The primary (direction) argument specifies which disk is the primary, that is, the source disk.
-force
Optionally specifies the force parameter. This argument permits the copy operation to resume even if it might lead to a temporary loss of consistency while synchronization occurs.
-clean
Optionally specifies the clean parameter. This marks the secondary VDisk as clean for each of the relationships belonging to the group.
rc_consist_group_id | rc_consist_group_name
Specifies the ID or name of the consistency group to start.

Description

This command starts a Remote Copy consistency group.

This command can only be issued to a consistency group that is connected. For a consistency group that is idling, this command assigns a copy direction (primary and secondary roles) and begins the copy process. Otherwise this command restarts a previous copy process that was stopped either by a stop command or by some I/O error.

If the resumption of the copy process will lead to a period when the relationship is not consistent, then you must specify the force flag when restarting the relationship. This situation could arise if, say, the relationship had been stopped, and then further writes had been performed on the original primary of the relationship. The use of the force flag here is a reminder that the data on the secondary will not be useful for Disaster Recovery purposes while it is in an inconsistent state.

In the idling state, you must provide the primary argument. In other connected states, you can provide the primary argument, but it must match the existing setting.

The -force flag is required if consistency would be lost by starting a copy operation. This would occur, if write operations on either primary or secondary vdisks have taken place since the ConsistentStopped or idling state was entered. If the command is issued without the -force flag is such circumstances, the command will fail. In general, the -force flag will be required if the group is in one of the following states:

The -force flag is not required if the group is in one of the following states:

However, the command will not fail if you do specify the -force flag.

The clean flag is used when a Remote Copy group is started and the secondary vdisks in this group are assumed to be clean. Clean in this sense means that any changes that have been made at the secondary are ignored and only changes made at the primary are considered when synchronising primary and secondary. This flag could be used in the following scenario:

  1. A consistency group is created with the synchronized flag. (At this point it does not matter if the primary and secondary contain the same data, even though the use of the synchronised flag implies that this is true).
  2. A stoprcconsistgrp command is issued with the -allow access flag. This permits access to the secondary. Change recording begins at the primary.
  3. An image of the primary is captured and loaded on to the secondary. It is permissible to allow updates to the primary during the image copy as this image need only be a fuzzy image of the primary.
  4. A startrcconsistgrp command with primary = master, the force flag and the clean flag is issued. This causes the auxiliary to be marked clean, and changes on the master that have occurred since the consistency group was stopped are copied to the auxiliary.
  5. Once the background copy has completed, relationships in the group will be consistent and synchronized.

Possible failures

Examples

An invocation example

svctask startrcconsistgrp rccopy1