chvolumegroupreplication

Use the chvolumegroupreplication command to change the replication properties of a volume group.

Syntax

Parameters

-mode independent | production

(Optional) Specifies the replication mode for the local volume group. Value can be independent or production.

-accessdivergedcopy

(Optional) Allow independent access to be enabled to a recovery copy of a volume group when the image that exists may be one that has diverged from the production copy of the volume group. This parameter is required to enable independent access before a synchronisation has completed following a recovery test or restarting replication from the independent state.

Note:

Changing the replication mode to independent while a recovery test is active will promote the volumes in-use for the recovery test to independent copies.
Starting a recovery test is prohibited if the recovery copy does not have a valid recovery point.
By default, independent access is prohibited if the recovery copy does not have a valid recovery point, but this can be bypassed using the -accessdivergedcopy option.

-checkpoint

(Optional) Specifies that the system should start a replication checkpoint. The checkpoint_achieved field in the lsvolumegroupreplication view indicates when the recovery copy of the volume group has a recovery point no earlier than the time this command completes.

This command can be issued on the production or recovery copy of a volume group.

This parameter cannot be specified with any other parameters and cannot be used for volume groups in a HA partition.

-startrecoverytest

(Optional) Starts a disaster recovery test on the local system, enabling host access to the volumes in the specified volume group. This operation can only be used on the system that has the recovery copy of the volume group.

-stoprecoverytest

(Optional) Stops an active disaster recovery test on the local system.

-unsuspend

(Optional) Specifies that replication is allowed to continue after a system failure, such as a dead domain or T3 recovery.

Note: This operation can only be used after a system failure, when the location status of the local system is reported as suspended in the lsvolumegroupreplication view. To recover from this state, you have the following options for recovery:

Before you fail over to the recovery system, you can validate data on the production copy. To failover to the recovery system, issue chvolumegroupreplication -mode independent on the recovery system. This action is recommended when the production system is reporting the suspended state.
On the system that is reporting the suspended state, issue the chvolumegroupreplication -unsuspend command to restart replication in the current direction. Use this command when the recovery copy of the data is reporting the suspended state.

volumegroup_id | volumegroup_name| volumegroup_uuid: (Mandatory) Specifies the ID or name or universally unique identifier of the local volume group to be modified.

Note: This command is available during the upgrade process.

When using the partition IP address to run this command, consider the following:

The user must identify objects using the name or UUID. Short IDs cannot be specified when using the partition IP address.
Only objects belonging to the partition can be created or acted upon. When creating new objects, the -partition parameter will be auto-populated for the partition. You cannot move items out of a partition when using the partition IP address.

A concise invocation example

chvolumegroupreplication -mode independent volumegroup4

The concise resulting output:

No feedback.