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.
|
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.
|
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- |
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- |
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- |
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- |
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 .
|
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. |