volume select replication select

Displays or modifies the selected volume replication configuration.

You can modify the local replication reserve or the replica reserve for a volume replication or enable the temporary use of free pool space if the local replication reserve is insufficient.

You can also choose to keep a failback snapshot in local replication reserve space. Note the failback replica will not be established until you create a replica.

Note: When a volume replication data transfer is in progress, you can reduce the local replication reserve only if the new local replication reserve size is more than what is currently being used to track volume changes.

When a volume replication data transfer is in progress, you can reduce the replica reserve only if the new replica reserve size is more than what is currently being used to store the replica set. Alternately, you can delete replicas (oldest first) to free up replica reserve space and then reduce the size of the replica reserve.

Format

volume select vol_name replication select partner_name show | [parameter...]

Variables

vol_name

Name of replicated volume.

partner_name

Group name of partner.

Parameters 

borrow-space enable|disable

Controls whether to temporarily use free pool space if the local replication reserve is not big enough to hold all 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. 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 enable|disable

Enables or disables keeping a failback snapshot for the volume.

After enabling, create a replica immediately to establish the failback baseline.

local-rep-reserve n%

Amount of pool space in the group that will be used to track volume changes during replication and store the failback snapshot (5% to 200% of the volume size). You must specify the percent sign.

If there is insufficient space 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.

remote-rep-reserve n%

Portion of delegated space on the partner that will be allocated to the volume’s replica set (105% to 200% of the volume size). 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.

Examples

The following command displays the replication configuration for volume vo14 on partner psgroup2:

> volume select vol4 replication select psgroup2 show

______________________ Replication Information ___________________

PartnerName: psgroup2                   Remote-Rep-Reserve: 200%

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

DesiredStatus: enabled                  Status: ready

RemoteISCSIName:                        Remaining Data: 0MB

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

  9434b0c01-462ff039c7241af9-11.1       StartingTime: None

Failback: disabled

__________________________________________________________________

 

____________________________ History ____________________________

 

StartTime            EndTime              Data       Transfer

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

Possible values for requested replication status (DesiredStatus field) on the primary group are shown in Table 6: Requested Replication Status on Primary Group.

Table 6: Requested Replication Status on Primary Group

Status

Description

disabled

Replication of the volume has been manually disabled.

enabled

Volume is enabled for replication.

paused

Replication of the volume has been manually paused.

Possible values for current replication status on the primary group (Status field) are shown in Table 7: Current Replication Status on Primary Group.

Table 7: Current Replication Status on Primary Group

Status

Description

auth-failure

Authentication between the partners failed.

Note: Check the passwords configured on the partners.

cancelling

Administrator cancelled the replication operation.

completed

A replication operation completed. For manual replication, indicates the administrator on the secondary group completed and confirmed the upload of volume data from the primary group.

disabled

Volume replication has been manually disabled.

failed

Volume replication has failed.

Note: Check the event log to determine why the replication operation failed.

in-progress

Volume is currently being replicated to the partner.

manual-in-progress

Manual replication of a volume has begun. Administrator intervention might be required to complete the transfer.

partner-down

Volume replication is disabled because the partner cannot be reached.

Note: Check the network connection between partners.

partner-paused-inbound

Partner administrator paused inbound replication.

partner-paused-outbound

Partner administrator paused outbound replication.

paused

Administrator paused replication to the partner.

paused-max-snap-reached

Volume replication paused because the partner has reached the maximum number of replicas or snapshots for a group.

To continue the replication, you must delete replicas (or snapshots) on the partner. If a schedule is being used to create replicas, you may want to lower value of the maximum number of replicas to keep setting.

paused-remote-reserve-
low

Volume replication was paused because the replica reserve must be increased. An event message will display the amount to which the replica reserve must be increased in order for the replication to complete.

Note: See volume select replication enable for information about increasing the replica reserve.

paused-remote-resize-
failed

Volume size was increased, but the corresponding replica reserve resize operation on the partner failed. Because replica reserve is based on volume size, when you increase the volume size, the replica reserve requirement automatically increases. To increase the replica reserve for a volume, delegated space must be available on the partner.

Note: If there is not enough partner space delegated to the group, request that the partner administrator increase the delegated space.

paused-partner-allows-
downgrades

Volume replication was paused because the partner group must be prevented from reverting to a firmware version prior to V3.2. See grpparams disallow-downgrades for more information.

paused-partner-needs-
upgrade

Volume replication was paused because the partner is running firmware that does not support the latest features.

ready

Volume is not currently being replicated.

waiting

Volume replication data transfer has not yet started because the maximum number of in-use replication iSCSI sessions has been reached.

Possible values for current replication status on the secondary group are shown in Table 8: Current Replication Status on Secondary Group .

Table 8: Current Replication Status on Secondary Group

Status

Description

auth-failure

Authentication between the partners failed.

Note: Check the passwords configured on the partners.

far-end-down

The primary group cannot be reached. Check the network connectivity between the partners.

incomplete

Replication is incomplete. For volumes configured to use manual transfer replication, this might mean that more transfer files need to be loaded into the replica placeholder.

ready

Volume is not currently being replicated.

stopped

Replication between the partners was stopped.