This section describes environment definition commands for replication management.
NAME
swsrpsetvol - sets the replication source volumes and replication destination volumes
SYNOPSIS
program-directory\bin\swsrpsetvol [-n] [-u] [-Xvtoc] [-Xgroup Group-Name] Original-Volume-Name Replica-Volume-Name
program-directory\bin\swsrpsetvol [-n] [-u] [-Xvtoc] -o {ORG|REP|BOTH} [-Xgroup Group-Name] Original-Volume-Name Replica-Volume-Name
program-directory\bin\swsrpsetvol -h Server-Name [-n] [-u] [-Xvtoc] [-Xgroup Group-Name] Original-Volume-Name Replica-Volume-Name
program-directory\bin\swsrpsetvol -h Server-Name [-n] [-u] -o {ORG|REP|BOTH} [-Xvtoc] [-Xgroup Group-Name] Original-Volume-Name Replica-Volume-Name
DESCRIPTION
This command sets the replication source volumes and replication destination volumes that will be used in a replication operation. Execute this command to declare that the replication operation will performed using the specified replication volumes.
OPTIONS
Specifies the name of a Storage Server that is subject to the replication operation. This option is valid only on a Storage Management Server.
If this option is omitted, the Storage Server on which the command is entered will be the target of the processing.
Specifies the direction of copying.
If this option is specified, copying is performed only in the direction from replication source volume to a replication destination volume. Copying from a replication destination volume to a replication source volume is prohibited.
If this option is omitted, copying between the replication source and replication destination volumes is bidirectional.
Specifies the operation server.
Specify one of the following for this operand:
ORG: Sets the replication source server as the operation server.
REP: Sets the replication destination server as the operation server.
BOTH: Sets both the copy-source server and copy-destination server as operation servers.
On the server that is not specified as the operation server, only the following commands can be executed for a replication volume:
swsrpvolinfo (Replication volume information display command)
swsrpcancel (Replication cancellation command) (The forcible stop option is required.)
Specifying BOTH in the operand enables the execution of all commands on both the copy-source server and copy-destination server. Note that the BOTH option is usable when the versions of both servers are 11.0/V11.0L10 or later.
This option is valid only for replication between servers.
If this option is omitted, replication volume information cannot be set when the sizes of the replication source volume and replication destination volume are different.
When this option is specified, the sizes of the replication source volume and replication destination volume are not checked. Use this option when volume sizes are different (for example, for replication between different OSs).
When the volume sizes of the replication source volume and replication destination volume are different, copying is performed as follows:
The address at which copying starts is the first sector of the replication destination volume.
The copy data size is the size of the smaller volume.
Therefore, ensure that the size of the copy destination volume is the same size or larger than the size of the copy source volume.
Specifies that the copy source and copy destination volumes will be registered in a group.
If the specified group does not exist, a new group is created. Otherwise, the specified copy source and copy destination volumes are added to an existing group.
The characters that can be used for the group name are single-byte alphanumeric characters, the minus sign (-), underscore (_), number sign (#) and period (.). The first character must be a single-byte alphanumeric character. Up to 64 characters can be used.
If this option is not specified, Solaris slices that include VTOC cannot be set as replication source volumes or replication destination volumes.
Specification of this option avoids checking to see whether or not replication source and replication destination volumes include VTOC.
This option is specified for the following replication source and replication destination volumes:
Under Solaris, VTOC-labeled disk slices that contain VTOC
Under Solaris, a VTOC-labeled disk second slice that indicates the entire disk
This option is ignored if it is set for volumes other than the above.
OPERANDS
Specifies a replication source volume name.
For the volume names of other servers, use the format "Volume-Name@Storage-Server-Name."
Specifies an 1.5 Managing a Device on AdvancedCopy Manager for the volume name.
Specifies a replication destination volume name.
For the volume names of other servers, use the format "Volume-Name@Storage-Server-Name."
Specifies an 1.5 Managing a Device on AdvancedCopy Manager for the volume name.
EXIT STATUS
=0:Completed successfully
>0:Terminated abnormally
EXAMPLES
Set replication volume information by specifying volume g1d1p1 of Storage Server SRC-SV as the replication source volume, and volume g2d1p1 of Storage Server TARG-SV as the replication destination volume. In addition, specify one-way copying for the copy direction and specify the replication source server (SRC-SV) as the operation server. The example below shows the command executed on SRC-SV.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpsetvol -u -o ORG g1d1p1 g2d1p1@TARG-SV swsrpsetvol completed C:\>
When the same settings are made from TARG-SV, the example is as follows (be careful with the volume name):
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpsetvol -u -o ORG g1d1p1@SRC-SV g2d1p1 swsrpsetvol completed C:\>
NOTES
Replication volume information cannot be set if:
Replication volume information has already been set.
The specified replication source volume and replication destination volume are already set as the replication destination volume and the replication source volume respectively.
The -n option is not specified when the sizes of the replication source volume and the replication destination volume are different.
Two volumes that have the same cabinet information (ie, box identifier, OLU number, EXTENT start position, and EXTENT size) as the cabinet information of the specified two volumes have already been set as replication volumes.
The replication destination volume has been registered as a backup volume by the backup management function.
The replication source volume has been registered as a backup volume by the backup management function and bi-directional copying is specified as a replication volume attribute.
The specified replication destination volume and replication source volume are volumes belonging to other servers (at least one volume must be a volume on the local server).
If the replication source volume and the replication destination volume are located on another ETERNUS disk storage systems, the remote copy function of the ETERNUS disk storage systems is not correctly set.
Communication with the Storage Management Server fails.
Communication with a destination server fails for replication between servers.
The replication source volume or the replication destination volume exists in ETERNUS DX60, ETERNUS DX80 or ETERNUS DX90, and the license of its ETERNUS disk storage system is not registered in the License Manager.
When you change physical information on volumes (ie, partition size, cabinet information on ETERNUS disk storage systems, and Logical Unit (disk) size) using such functions as an OS management tool (for example, Disk Management) or GRmgr provided by the ETERNUS disk storage systems, you need to reset the registered replication volume information associated with the changed volumes, according to the following procedures:
Delete the replication volume information by swsrpdelvol (Replication volume information deletion command).
In the GUI client, "information acquisition/reflection" of all devices is performed. Otherwise stgxfwcmsetdev (Device information collection / reflection command) is executed in a Storage Management Server.
Reset the replication volume information with swsrpsetvol (Replication volume information configuration command).
Also, when you add a new device or delete a device (including general devices other than ETERNUS disk storage systems), perform the "acquire and reflect all device information" operation listed in the GUI client to update the relationship table for AdvancedCopy Manager device names and OS information.
When you use a replication destination volume by mounting or by allocating a drive letter after a replication volume is created in another partition, the size of the replication destination volume must exactly match the size of the replication destination volume to the byte. If you do not use a replication destination volume (for example, when you need copy data, you restore it to the replication source volume and then use it), the size of the replication destination volume can be larger than the size of the replication source volume.
Group configurations cannot be made in the following cases:
When the group configuration conditions are not met
When both servers involved in inter-server replication are not running version 13.0 or later
This command cannot be executed while any of the following commands are running:
swsrpsetvol (Replication volume information setting command)
swsrpdelvol (Replication volume information deletion command)
swsrprecbuffset (REC transfer buffer settings change command)
swsrpstartsync (Backup synchronous processing start command)
swsrpdbinfo_ex2k3/swsrpdbinfo_exchange (Exchange database information registration command)
swsrpvssbackup_exchange (Exchange VSS backup execution command)
swsrpvssretore_exchange (Exchange VSS restore execution command)
swsrpshadowadm_exchange (Exchange VSS shadow copy management command)
swsrpshadowadm (Shadow copy management command)
NAME
swsrpvolinfo - displays the replication volume information
SYNOPSIS
program-directory\bin\swsrpvolinfo [-L] [Original-Volumue-Name]
program-directory\bin\swsrpvolinfo -h Server-Name [-L] [Original-Volume-Name]
DESCRIPTION
This command displays the replication volume information registered by swsrpsetvol (Replication volume information setting command).
The following information will be displayed:
Title | Description |
---|---|
Server | Displays a Storage Server name. |
Original-Volume | Displays a replication source volume name. |
Size | Displays the volume size. |
Replica-Volume | Displays a replication destination volume name. |
Copy | Displays the copying direction. uni-direction: One-way copying from a replication source volume to a replication destination volume is allowed. |
Op-Server | Displays the operation server of a pair of replication volumes. original: The replication source server is the operation server. |
Group [Only when -L option is specified] | Displays the group name. "----"is displayed if the copy source and destination volumes are not registered in a group. |
OPTIONS
Specifies a Storage Server name.
This option is valid only on a Storage Management Server.
Specifies that information will be displayed using the extended format.
Refer to the table in the example following for information about the items that are displayed when this option is specified.
The items that are displayed may be expanded to support new functions provided by future versions.
OPERANDS
Specifies a replication source volume name.
For the volume names of other servers, use the format "Volume-Name@Storage-Server-Name."
Specifies an 1.5 Managing a Device on AdvancedCopy Manager for the volume name.
Displays all the replication volume information for the specified replication source volume. If this operand is omitted, all the replication volume information existing on the Storage Server on which this command is executed is displayed.
EXIT STATUS
=0:Completed successfully
>0:Terminated abnormally
EXAMPLES
Direct that all the replication volume information on a Storage Management Server is to be displayed on Storage Server SRC-SV.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpvolinfo -h SRC-SV Server Original-Volume Size Replica-Volume Size Copy Op-Server SRC-SV g1d1p1@SRC-SV 4.0Gbyte g2d1p1@TARG-SV 4.0Gbyte uni-direction original SRC-SV g1d2p1@SRC-SV 4.0Gbyte g2d2p1@TARG-SV 5.0Gbyte bi-direction original SRC-SV g1d3p1@SRC-SV 9.1Gbyte g2d3p1@TARG-SV 9.1Gbyte bi-direction replica SRC-SV g1d4p1@SRC-SV 7.5Gbyte g2d4p1@TARG-SV 7.5Gbyte bi-direction both C:\>
NOTES
Replication volume information cannot be displayed if:
The specified volume has not been set as a replication source volume
This command cannot be executed while the following command is running:
NAME
swsrpdelvol - delete the replication volume
SYNOPSIS
program-directory\bin\swsrpdelvol [-e] [-d] Original-Volume-Name Replica-Volume-Name
program-directory\bin\swsrpdelvol -h Server-Name [-e] [-d] Original-Volume-Name Replica-Volume-Name
DESCRIPTION
Delete the replication volume information that has been set.
If copy processing is being performed on a replication volume that is to be deleted, execute the command after the copy processing has stopped.
OPTIONS
Specifies a Storage Server name.
This option is valid only on a Storage Management Server.
Emergency mode is available for operations.
Specifies deleting replica volume information without checking the execution state of an advanced copy. Use this option only when it is clear that the advanced copy has not executed.
Specifies that no communication should take place between the linked servers in replication between servers. When this option is specified, replication volume information is deleted without communication taking place between the linked servers.
Use the option only when recovery of one of the linked servers cannot be expected.
The option is valid only for replication between servers.
The option can be used on the server not specified as the operation server.
OPERANDS
Specifies a replication source volume name.
For the volume names of other servers, use the format "Volume-Name@Storage-Server-Name."
Specifies an 1.5 Managing a Device on AdvancedCopy Manager for the volume name.
Specifies a replication destination volume name.
For the volume names of other servers, use the format "Volume-Name@Storage-Server-Name."
Specifies an 1.5 Managing a Device on AdvancedCopy Manager for the volume name.
EXIT STATUS
=0:Completed successfully
>0:Terminated abnormally
EXAMPLES
Delete replication volume information on Storage Server SRC-SV.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpdelvol g1d1p1 g2d1p1@TARG-SV swsrpdelvol completed C:\>
NOTES
Replication volume information cannot be deleted if:
The specified replication source volume and the replication destination volume are not set as replication volumes.
The copy processing (synchronization processing and snapshot processing) is performed between replication volumes.
For server-to-server replication, the Storage Server that executed the command is not the operation server of the replication volume.
Communication with a Storage Management Server fails.
For server-to-server replication, communication with a destination server fails.
However, OPC sessions are neither confirmed nor cancelled by execution in emergency operation mode. If an OPC session is in the error suspended state or halt state, then unmanaged sessions remain. In this event, ETERNUS Web GUI must be used to cancel these sessions.
This command cannot be executed while any of the following commands are running:
swsrpsetvol (Replication volume information setting command)
swsrpdelvol (Replication volume information deletion command)
swsrprecbuffset (REC transfer buffer settings change command)
swsrpstartsync (Backup synchronous processing start command)
swsrpdbinfo_ex2k3/swsrpdbinfo_exchange (Exchange database information registration command)
swsrpvssbackup_exchange (Exchange VSS backup execution command)
swsrpvssretore_exchange (Exchange VSS restore execution command)
swsrpshadowadm_exchange (Exchange VSS shadow copy management command)
swsrpshadowadm (Shadow copy management command)
NAME
swsrprecbuffstat - displays information for the transfer buffer
SYNOPSIS
program-directory\bin\swsrprecbuffstat Volume-Name
program-directory\bin\swsrprecbuffstat -h Server-Name Volume-Name
DESCRIPTION
This command displays information for the transfer buffer used by ETERNUS disk storage systems when REC is performed in Consistency mode.
The following information will be displayed:
Title | Description |
---|---|
BoxID | The box identifier for the cabinet connected to the server where the command was executed. |
ID | The ID for the transfer buffer. |
Use | The attribute (usage) for the transfer buffer. SEND : Transfer buffer for sending data |
Rate | The usage rate of the transfer buffer as a percentage.
"----" will be displayed if the transfer buffer cannot be used. |
RemoteBoxID | The box identifier for the cabinet performing a remote copy. |
DiskBuff | Displays the REC disk buffer status only when the -L option is specified:
The following codes are displayed at code=xx in the case of warning or inactive.:
|
DiskRate | Displays the busy rate as a percentage if the REC Disk buffer state is "active" or "warning" only when the -L option is specified. If the REC Disk buffer is not being used, 0% is displayed. |
OPTIONS
Specifies the name of a Storage Server.
You can use this option only for a Storage Management Server.
This option specifies to display in extended format.
Refer to the execution example table for the items that are displayed when this option is specified.
Note that additional items corresponding to new functions in future versions might be displayed in future when this option is specified.
OPERANDS
Specifies the name of a volume that has been registered as a replication volume.
You can only specify volumes that are connected to the Storage Server where the command is executed.
Specifies an 1.5 Managing a Device on AdvancedCopy Manager as the volume name.
EXIT STATUS
=0:Completed successfully
>0:Terminated abnormally
EXAMPLES
Display information for the transfer buffer used by the REC, and replication is performed within the Storage Server "Server1".
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d10p1@Server1 -L BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID DiskBuff DiskRate 1 SEND 25% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB active 50% C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d20p1@Server1 BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ID Use Rate RemoteBoxID DiskBuff DiskRate 1 RECV 0% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA --- --- C:\>
Display information for the transfer buffer used by the REC in an environment where replication is being performed between Storage Server "Server1" and Storage Server "Server2".
[Command executed on Storage Server "Server1"]
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d10p1@Server1 -L BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID DiskBuff DiskRate 1 SEND 25% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB active 0% 2 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB --- --- C:\>
[Command executed on Storage Server "Server2"]
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d30p1@Server2 -L BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ID Use Rate RemoteBoxID DiskBuff DiskRate 1 RECV 0% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA --- --- 2 SEND 12% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA active 0% C:\>
Display information for the transfer buffer used by the REC if a cabinet where the copy source volume is located has been set up to make remote copies to multiple cabinets, and replication is being performed between Storage Server "Server1" and Storage Server "Server2"
[Command executed on Storage Server "Server1"]
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d10p1@Server1 -L BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID DiskBuff DiskRate 1 SEND 25% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB warning(code=08) 0% 2 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB --- --- 3 SEND 12% CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC active 50% 4 RECV 0% CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC --- --- 5 SEND 12% DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD invalid --- 6 RECV 0% EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE --- --- 7 SEND 12% FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF inactive(code=05) --- 8 SEND 12% GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG active 0% C:\>
NOTES
Information is displayed only for cabinets that contain replication volumes for the server where the command was executed.
If inter-box replication is being performed between servers, then the command must be executed on both servers involved in the replication in order to check information for the transfer buffers in both cabinets.
It will take a short time for changes to REC transfer buffer settings to take effect, during which time the buffer may become unusable (the "Rate" field will be displayed as "----"). In this case, wait about one minute and then execute the command again.
This command cannot be executed while the following command is running:
NAME
swsrprecbuffset - changes the settings of the transfer buffer
SYNOPSIS
program-directory\bin\swsrprecbuffset -Xbuffid buffer-id -Xbuffuse {SEND|RECV} Volume-Name
program-directory\bin\swsrprecbuffset -h Server-Name -Xbuffid buffer-id -Xbuffuse {SEND|RECV} Volume-Name
DESCRIPTION
This command changes the settings of the transfer buffer used by ETERNUS disk storage systems when REC is performed in Consistency mode.
For information about the setting method of REC transfer buffer, refer to "User's Guide Setup / Maintenance" of ETERNUS Web GUI.
OPTIONS
Specifies the name of a Storage Server.
You can use this option only for a Storage Management Server.
Specifies the ID for the transfer buffer.
Specifies the usage for the transfer buffer.
SEND : Transfer buffer for sending data
RECV : Transfer buffer for receiving data
OPERANDS
Specifies the name of a volume that has been registered as a replication volume.
You can only specify volumes that are connected to the Storage Server where the command is executed.
Specifies an 1.5 Managing a Device on AdvancedCopy Manager as the volume name.
EXIT STATUS
=0:Completed successfully
>0:Terminated abnormally
EXAMPLES
Change the attributes for the transfer buffer used by the REC, and replication is being performed within the Storage Server "Server1"
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d10p1@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 SEND 25% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffset -Xbuffid 1 -Xbuffuse RECV g1d10p1@Server1 swsrprecbuffset completed C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d10p1@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d20p1@Server1 BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ID Use Rate RemoteBoxID 1 RECV 0% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffset -Xbuffid 1 -Xbuffuse SEND g1d20p1@Server1 swsrprecbuffset completed C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d20p1@Server1 BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ID Use Rate RemoteBoxID 1 SEND 12% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA C:\>
Change the connected cabinet for the transfer buffer of the copy source volume , and replication is being performed between Storage Server "Server1" and Storage Server "Server2".
[Command executed on Storage Server "Server1"]
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d10p1@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 SEND 25% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB 2 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffset -Xbuffid 1 -Xbuffuse SEND g1d20p1@Server1 swsrprecbuffset completed C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffset -Xbuffid 2 -Xbuffuse RECV g1d20p1@Server1 swsrprecbuffset completed C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d20p1@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 SEND 12% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB 2 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB C:\>
NOTES
Settings for dedicated REC buffers must be made in advance.
Change the settings while there are no asynchronous Consistency mode sessions in either the ACTIVE or ERROR SUSPEND state.
Information can be changed only for cabinets that contain replication volumes for the server where the command was executed.
It will take a short time for changes to buffer settings to take effect, during which time the transfer buffer will become unusable. Do not perform REC operations during this time.
This command cannot be executed while any of the following commands are running:
swsrpsetvol (Replication volume information setting command)
swsrpdelvol (Replication volume information deletion command)
swsrpstartsync (Backup synchronous processing start command)
swsrpdbinfo_ex2k3/swsrpdbinfo_exchange (Exchange database information registration command)
swsrpvssbackup_exchange (Exchange VSS backup execution command)
swsrpvssretore_exchange (Exchange VSS restore execution command)
swsrpshadowadm_exchange (Exchange VSS shadow copy management command)
swsrpshadowadm (Shadow copy management command)