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 Managed Server that is subject to the replication operation.
This option can be specified only on a Management Server.
If this option is omitted, the Managed 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 Version 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
Under Solaris, an EFI-labeled disk MPxIO device 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@Managed-Server-Name".
Specifies the AdvancedCopy Manager device name for the Volume-Name.
Specifies a replication destination volume name.
For the volume names of other servers, use the format "Volume-Name@Managed-Server-Name".
Specifies the AdvancedCopy Manager device name for the Volume-Name.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Set replication volume information by specifying volume g1d1p1 of Managed Server SRC-SV as the replication source volume, and volume g2d1p1 of Managed 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 box information (ie, box identifier, OLU number, EXTENT start position, and EXTENT size) as the box 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 system, the remote copy function of the ETERNUS Disk storage system is not correctly set.
Communication with the Management Server fails.
Communication with a destination server fails for replication between servers.
The IP version registered on AdvancedCopy Manager differs between the replication source server and the replication destination server.
At least one of the replication source and target volumes has a FAT or FAT32 file system.
The license for the ETERNUS Disk storage system that contains the specified replication source/target volume is one of the following:
The license is not registered in the license management function.
The license is expired.
When you change physical information on volumes (ie, partition size, box information on ETERNUS Disk storage system, and Logical Unit (disk) size) using such functions as an OS management tool (for example, Disk Management) or ETERNUS Web GUI provided by the ETERNUS Disk storage system, 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 Web Console, "information acquisition/reflection" of all devices is performed. Otherwise stgxfwcmsetdev (Device information collection/reflection command) is executed in a Management Server.
Reset the replication volume information with swsrpsetvol (Replication volume information setting command).
Also, when you add a new device or delete a device (including general devices other than ETERNUS Disk storage system), perform the "acquire and reflect all device information" operation listed in the Web Console 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)
swsrpdbinfo_ex2k3/swsrpdbinfo_exchange (Exchange database information registration command)
swsrpvssbackup_exchange (Exchange VSS backup execution command)
swsrpvssrestore_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-Volume-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 Managed 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 the -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 Managed Server name.
This option can be specified only on a Management Server.
Specifies that information will be displayed using the extended format.
For the items displayed by this option, refer to the table in the description above.
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@Managed-Server-Name."
Specifies the AdvancedCopy Manager device name 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 Managed 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 Management Server is to be displayed on Managed Server SRC-SV:
C:\>C:\ETERNUS_SF\ACM\bin\swsrpvolinfo -h SRC-SV Server Original-Volume Size Replica-Volume Size Copy Op-Server SRC-SV g1d1p1@SRC-SV 4.0 Gbyte g2d1p1@TARG-SV 4.0 Gbyte uni-direction original SRC-SV g1d2p1@SRC-SV 4.0 Gbyte g2d2p1@TARG-SV 5.0 Gbyte bi-direction original SRC-SV g1d3p1@SRC-SV 9.1 Gbyte g2d3p1@TARG-SV 9.1 Gbyte bi-direction replica SRC-SV g1d4p1@SRC-SV 7.5 Gbyte g2d4p1@TARG-SV 7.5 Gbyte 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 - deletes 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
This command deletes 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 Managed Server name.
This option can be specified only on a 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@Managed-Server-Name".
Specifies the AdvancedCopy Manager device name for the Volume-Name.
Specifies a replication destination volume name.
For the volume names of other servers, use the format "Volume-Name@Managed-Server-Name".
Specifies the AdvancedCopy Manager device name for the Volume-Name.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Delete replication volume information on Managed 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 Managed Server that executed the command is not the operation server of the replication volume.
Communication with a 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, 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)
swsrpdbinfo_ex2k3/swsrpdbinfo_exchange (Exchange database information registration command)
swsrpvssbackup_exchange (Exchange VSS backup execution command)
swsrpvssrestore_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 REC buffer
SYNOPSIS
<program-directory>\bin\swsrprecbuffstat [-L] Volume-Name
<program-directory>\bin\swsrprecbuffstat -h Server-Name [-L] Volume-Name
DESCRIPTION
This command displays information for the REC buffer used by ETERNUS Disk storage system when REC is performed in Consistency mode.
The following information will be displayed:
Title | Description |
---|---|
BoxID | The box identifier for the box connected to the server where the command was executed. |
ID | The ID for the REC buffer. |
Use | The attribute (usage) for the REC buffer. SEND : REC buffer for sending data |
Rate | The usage rate of the REC buffer as a percentage.
"----" will be displayed if the REC buffer cannot be used. |
RemoteBoxID | The box identifier for the box performing a remote copy. |
DiskBuff | Displays the REC Disk buffer status only when -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 -L option is specified. If the REC Disk buffer is not being used, 0% is displayed. |
OPTIONS
Specifies the name of a Managed Server.
This option can be specified only on a Management Server.
This option specifies to display in extended format.
For the items displayed by this option, refer to the table in the description above.
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 Managed Server where the command is executed.
Specifies the AdvancedCopy Manager device name as the volume name.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display information for the REC buffer used by the REC, and replication is performed within the Managed 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 REC buffer used by the REC in an environment where replication is being performed between Managed Server "Server1" and Managed Server "Server2":
[Command executed on Managed 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 Managed 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 REC buffer used by the REC if a box where the copy source volume is located has been set up to make remote copies to multiple boxes, and replication is being performed between Managed Server "Server1" and Managed Server "Server2":
[Command executed on Managed 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 boxes 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 REC buffers in both boxes.
It will take a short time for changes to REC buffer settings to take effect, during which time the buffer may become unusable (the Rate column 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 REC 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 REC buffer used by ETERNUS Disk storage system when REC is performed in Consistency mode.
For information about the setting method of REC buffer, refer to "User's Guide Setup / Maintenance" of ETERNUS Web GUI.
OPTIONS
Specifies the name of a Managed Server.
This option can be specified only on a Management Server.
Specifies the ID for the REC buffer.
Specifies the usage for the REC buffer.
SEND : REC buffer for sending data
RECV : REC 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 Managed Server where the command is executed.
Specifies the AdvancedCopy Manager device name as the volume name.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Change the attributes for the REC buffer used by the REC, and replication is being performed within the Managed 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 box for the REC buffer of the copy source volume , and replication is being performed between Managed Server "Server1" and Managed Server "Server2":
[Command executed on Managed 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 Consistency mode sessions in either the ACTIVE or ERROR SUSPEND state.
Information can be changed only for boxes 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 REC 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)
swsrpdbinfo_ex2k3/swsrpdbinfo_exchange (Exchange database information registration command)
swsrpvssbackup_exchange (Exchange VSS backup execution command)
swsrpvssrestore_exchange (Exchange VSS restore execution command)
swsrpshadowadm_exchange (Exchange VSS shadow copy management command)
swsrpshadowadm (Shadow copy management command)