This section describes environment definition commands for replication management.
NAME
swsrpsetvol - sets the replication source volumes and replication destination volumes
SYNOPSIS
/opt/FJSVswsrp/bin/swsrpsetvol [-n] [-u] [-Xgroup groupName] originalVolumeName replicaVolumeName
/opt/FJSVswsrp/bin/swsrpsetvol [-n] [-u] -o (ORG|REP|BOTH) [-Xgroup groupName] originalVolumeName replicaVolumeName
/opt/FJSVswsrp/bin/swsrpsetvol [-h serverName] [-n] [-u] [-Xgroup groupName] originalVolumeName replicaVolumeName
/opt/FJSVswsrp/bin/swsrpsetvol [-h serverName] [-n] [-u] -o (ORG|REP|BOTH) [-Xgroup groupName] originalVolumeName replicaVolumeName
DESCRIPTION
This command sets the replication source volumes and replication destination volumes that are used in a replication operation. Execute this command to declare that the replication operation is performed using the specified replication volumes.
OPTIONS
When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.
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.
When performing the server-to-server replication, specify the operation server(s) authorized to manage replication.
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.
When BOTH has been specified, all commands can be executed from either the replication source server or the replication destination server.
When ORG or REP was specified, the non-operation server cannot issue the following commands:
However, in the following cases, the non-operation server can issue the above commands.
When specifying the -d option with the swsrpdelvol command.
When specifying the -c option with the swsrpcancel command.
When specifying the -b option with the swsrpcancel command.
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 are 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 hyphens (-), underscore (_), number sign (#) and period (.). The first character must be a single-byte alphanumeric character. Up to 64 characters can be used.
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 "/dev/vg01" of Managed Server "SRC-SV" as the replication source volume and volume "/dev/vg02" 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 following example shows the command executed on "SRC-SV":
# /opt/FJSVswsrp/bin/swsrpsetvol -u -o ORG /dev/vg01 /dev/vg02@TARG-SV swsrpsetvol completed #
When the same settings are made from "TARG-SV", the example is as follows (be careful with the volume name):
# /opt/FJSVswsrp/bin/swsrpsetvol -u -o ORG /dev/vg01@SRC-SV /dev/vg02 swsrpsetvol completed #
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 server-to-server replication.
Changes have been made to the logical disk configuration that cannot be supported by AdvancedCopy Manager.
A volume group is inactive in the volume group specification.
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 using a volume group as a source volume or replica volume, the following applies:
Be sure to specify the pairs of a volume group as a source volume and replica volume. Note that this does not work between platforms
The same volume group cannot be registered as a source volume and replica volume.
When registering a volume group as a source volume and replica volume, make the logical disk configuration the same.
When you change physical information on volumes (ie, partition size, drive letter, and box information on ETERNUS Disk storage system device using such functions as an OS management tool (format command etc ) or ETERNUS Web GUI provided by ETERNUS Disk storage system, you need to reset the registered replication volume information associated with the changed volumes, by following these steps:
Delete the replication volume information using the swsrpdelvol command.
Refer to "Add/Reload Device" in the Web Console Guide to reload the configuration. Otherwise the stgxfwcmsetdev command is executed in a Management Server.
Reset the replication volume information using the swsrpsetvol command.
When you use a replication destination volume by mounting 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 group configuration conditions are not met.
This command cannot be executed while any of the following commands are running:
NAME
swsrpvolinfo - displays the replication volume information
SYNOPSIS
/opt/FJSVswsrp/bin/swsrpvolinfo [-L] [originalVolumeName]
/opt/FJSVswsrp/bin/swsrpvolinfo [-h serverName] [-L] [originalVolumeName]
DESCRIPTION
This command displays the replication volume information registered by the swsrpsetvol command.
The following information is displayed.
Title | Description |
|---|---|
Server | Displays a Managed Server name. |
Original-Volume | Displays a replication source volume name. |
Size | Displays the volume size. Additionally, in the case of a volume group, displays the size of the physical disk on which the logical disk exists. |
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
When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.
Specifies that information is 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:
# /opt/FJSVswsrp/bin/swsrpvolinfo -h SRC-SV Server Original-Volume Size Replica-Volume Size Copy Op-Server SRC-SV /dev/vg01@SRC-SV 4.0 Gbyte /dev/vg01@TARG-SV 4.0 Gbyte uni-direction original SRC-SV /dev/vg02@SRC-SV 4.0 Gbyte /dev/vg02@TARG-SV 5.0 Gbyte bi-direction original SRC-SV /dev/vg03@SRC-SV 9.1 Gbyte /dev/vg03@TARG-SV 9.1 Gbyte bi-direction replica SRC-SV /dev/vg04@SRC-SV 7.5 Gbyte /dev/vg04@TARG-SV 7.5 Gbyte bi-direction both #
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
/opt/FJSVswsrp/bin/swsrpdelvol [-e] [-d] originalVolumeName replicaVolumeName
/opt/FJSVswsrp/bin/swsrpdelvol [-h serverName] [-e] [-d] originalVolumeName replicaVolumeName
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
When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
When performing the server-to-server replication, specify the name of the operation server configured with the swsrpsetvol command.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.
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 server-to-server replication. 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 server-to-server replication.
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:
# /opt/FJSVswsrp/bin/swsrpdelvol /dev/vg01 /dev/vg01@TARG-SV swsrpdelvol completed #
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.
A volume group is inactive in the volume group specification.
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.
If a logical volume is deleted, or if changes are made to its configuration that cannot be supported by AdvancedCopy Manager, replica volume information cannot be deleted. In this case, perform processing of a or b shown below.
Specify the -e option and execute the command, after checking that an Advanced Copy is not processing in the replica volume to be deleted (if an Advanced Copy is running, stop the Advanced Copy processing in the target ETERNUS Disk storage system).
Execute the command after re-creating the logical volume with a configuration that AdvancedCopy Manager can support, or after returning the logical volume configuration to its original state.
This command cannot be executed while any of the following commands are running:
NAME
swsrprecbuffstat - displays information for the REC buffer
SYNOPSIS
/opt/FJSVswsrp/bin/swsrprecbuffstat [-L] volumeName
/opt/FJSVswsrp/bin/swsrprecbuffstat [-h server-Name] [-L] volumeName
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 is 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. If "Use" Is SEND, the usage rate of the REC buffer is displayed as a percentage. The usage rate may not be 0 %, even if REC is not being performed in Consistency mode. If "Use" Is RECV, "0%" is always displayed. "----" is 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
When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.
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":
# /opt/FJSVswsrp/bin/swsrprecbuffstat -L /dev/hdisk10@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID DiskBuff DiskRate 1 SEND 25% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB active 50% # /opt/FJSVswsrp/bin/swsrprecbuffstat -L /dev/hdisk11@Server1 BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ID Use Rate RemoteBoxID DiskBuff DiskRate 1 RECV 0% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA --- --- #
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"]
# /opt/FJSVswsrp/bin/swsrprecbuffstat -L /dev/hdisk10@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID DiskBuff DiskRate 1 SEND 25% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB active 0% 2 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB --- --- #
[Command executed on Managed Server "Server2"]
# /opt/FJSVswsrp/bin/swsrprecbuffstat -L /dev/hdisk20@Server2 BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ID Use Rate RemoteBoxID DiskBuff DiskRate 1 RECV 0% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA --- --- 2 SEND 12% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA active 0% #
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"]
# /opt/FJSVswsrp/bin/swsrprecbuffstat -L /dev/hdisk10@Server1 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% #
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 takes a short time for changes to REC buffer settings to take effect, during which time the buffer may become unusable (the Rate column is 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
/opt/FJSVswsrp/bin/swsrprecbuffset -Xbuffid buffer-id -Xbuffuse {SEND|RECV} volumeName
/opt/FJSVswsrp/bin/swsrprecbuffset [-h serverName] -Xbuffid buffer-id -Xbuffuse {SEND|RECV} volumeName
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
When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.
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":
# /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/hdisk10@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 SEND 25% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB # /opt/FJSVswsrp/bin/swsrprecbuffset -Xbuffid 1 -Xbuffuse RECV /dev/hdisk10@Server1 swsrprecbuffset completed # /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/hdisk10@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB # /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/hdisk11@Server1 BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ID Use Rate RemoteBoxID 1 RECV 0% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA # /opt/FJSVswsrp/bin/swsrprecbuffset -Xbuffid 1 -Xbuffuse SEND /dev/hdisk11@Server1 swsrprecbuffset completed # /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/hdisk11@Server1 BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ID Use Rate RemoteBoxID 1 SEND 12% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA #
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"]
# /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/hdisk10@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 SEND 25% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB 2 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB # /opt/FJSVswsrp/bin/swsrprecbuffset -Xbuffid 1 -Xbuffuse SEND /dev/hdisk11@Server1 swsrprecbuffset completed # /opt/FJSVswsrp/bin/swsrprecbuffset -Xbuffid 2 -Xbuffuse RECV /dev/hdisk11@Server1 swsrprecbuffset completed # /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/hdisk11@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 SEND 12% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB 2 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB #
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.
It takes a short time for changes to buffer settings to take effect, during which time the REC buffer becomes unusable. Do not perform REC operations during this time.
This command cannot be executed while any of the following commands are running:
