volume select replication enable

Enables replication of the selected volume to a replication partner. Before you can replicate a volume individually or as part of a volume collection, you must enable the volume for replication.

Note: You must have already established a partnership with the group that will store the replicas, as described in partner create.

Enabling replication on a volume does not create any actual replicas. See volume select replication create-replica or volume select schedule create for information about creating replicas.

To enable replication for a volume, specify:

The amount of pool space to reserve for tracking volume changes during replication (local replication reserve) and for storing the failback snapshot. You can also enable the temporary use of free pool space if the local replication reserve is not big enough to hold all the volume changes during replication.
The partner that will store the replica set.
The portion of delegated space on the partner to reserve for storing the replica set (remote reserve).
Whether to use manual replication for the first data transfer for the volume.
Whether to keep the failback snapshot (most recent complete replica) in the local replication reserve. If you choose to keep the failback snapshot, you will need more local replication reserve space than if not. If the failback snapshot exists, you may be able to synchronize the groups upon failback by replicating only volume changes.

See the Group Administration guide for more information about failback.

Format

volume select vol_name replication enable partner_name [parameter...]

Variables

vol_name	Name of volume to be replicated.
partner_name	Group name of a partner.

Parameters

remote-rep-reserve n%	Portion of delegated space on the partner that will be reserved for the volume’s replica set (replica reserve). The default is 200% of the volume size; the minimum is 105%. You must specify the percent sign. If there is insufficient replica reserve to complete a replication, you will receive a console message stating that the replication has been paused and the amount by which the replica reserve must be increased to complete the replication.
local-rep-reserve n%	Amount of pool space used to track volume changes during replication (local replication reserve) and store the failback snapshot, if enabled. The default is 100% of the volume size; the minimum is 5%. Reserving less than 100% is not recommended. You must specify the percent sign. If you choose to keep the failback snapshot, you will need more local replication reserve than if you do not. The recommended amount of local replication reserve is the amount you would need normally, plus another 100%. For example, if the local replication reserve is 90% and you choose to keep the failback snapshot, the local replication reserve should be set to 190%. If there is insufficient local replication reserve to track the changes (and the borrow-space parameter is not set to enabled), you will receive a console message stating that the replication has been cancelled.
borrow-space enable\|disable	Controls whether to temporarily use free pool space if the local replication reserve is not big enough to track the volume changes during replication. The default is enable. Be sure to enable this parameter if you reserve less than 100% of the volume size for the local replication reserve, or less than 200% if keeping the failback snapshot. If there is insufficient pool space to track the changes, you will receive a console message stating that the replication has been cancelled.
keep-failback	Keep a failback snapshot in the local replication reserve. The failback snapshot may enable you to fail back to the primary group by synchronizing only the volume changes.
first-manual-xfer	Specifies that the first data transfer for the volume (the entire volume contents) will be done manually; that is, by transporting physical media containing the volume data to the location of the secondary group and loading it into the replica set. For more information about manual replication, see the Group Administration manual.

Examples

The following command enables replication of volume newvol to group group2, using the default local replication reserve and replica reserve values:

> volume select newvol replication enable group2

Replication is enabled.

Replicas will not be created until initiated using the " replication create-replica " command or by the replication schedule.

________________________ Replication Information ________________________

PartnerName: group2 Remote-Rep-Reserve: 200%

Local-Rep-Reserve: 100% Borrow-Space: enabled

DesiredStatus: enabled Status: ready

RemoteISCSIName: Remaining Data: 0MB

iqn.2001-05.com.equallogic:0-8a0906- Completed Data: 0MB

8d4cc1902-0d246640e7f46375-newvol.1 StartingTime: None

Keep-Failback: disabled FailbackBaselevel: None

_________________________________________________________________________

________________________________ History ________________________________

StartTime EndTime Data Transfer

-------------------- -------------------- ---------- ---------------

The following command enables replication of volume vol-thin1 to group group2, using the default local replication reserve and replica reserve values, and specifying manual replication for the first data transfer:

> volume select vol-thin1 replication enable group2 first-manual-xfer

Replication is enabled.

Replicas will not be created until initiated using the " replication create-replica " command or by the replication schedule.

Please ensure that groupname and outbound-password is used to establish connection to the replica snap on the secondary.

________________________ Replication Information ________________________

PartnerName: group2 Remote-Rep-Reserve: 200%

Local-Rep-Reserve: 100% Borrow-Space: enabled

DesiredStatus: enabled Status: ready

RemoteISCSIName: Remaining Data: 0MB

iqn.2001-05.com.equallogic:0-8a0906- Completed Data: 0MB

7eecc1902-24046640e7c46375-vol-thin1 StartingTime: None

.1 Keep-Failback: disabled

FailbackBaselevel: None

_________________________________________________________________________

________________________________ History ________________________________

StartTime EndTime Data Transfer

-------------------- -------------------- ---------- ---------------

The following command enables replication of volume dbvol to group group2, using the default local replication reserve and replica reserve values and keeping the failback snapshot:

> volume select vol2 replication enable group2 keep-failback

Replication is enabled.

Replicas will not be created until initiated using the " replication create-replica " command or by the replication schedule.

________________________ Replication Information ________________________

PartnerName: group2 Remote-Rep-Reserve: 200%

Local-Rep-Reserve: 100% Borrow-Space: enabled

DesiredStatus: enabled Status: ready

RemoteISCSIName: Remaining Data: 0MB

iqn.2001-05.com.equallogic:0-8a0906- Completed Data: 0MB

e87cc1902-83795358e264614f-vol2.1 StartingTime: None

Keep-Failback: enabled FailbackBaselevel: None

_________________________________________________________________________

________________________________ History ________________________________

StartTime EndTime Data Transfer

-------------------- -------------------- ---------- ---------------

2007-04-05:09:53:06 2007-04-05:10:08:12 0MB success