This section describes operation commands for backup management.
NAME
swstbackup - backup
SYNOPSIS
/opt/FJSVswsts/bin/swstbackup [-suspend|-T] deviceName [-Xdevmap deviceMapFile]
/opt/FJSVswsts/bin/swstbackup [-h serverName] [-suspend|-T] deviceName [-Xdevmap deviceMapFile]
DESCRIPTION
When using this command, the operation changes according to different states of the Advanced Copy that is being executed.
When synchronous processing (EC) is not performed
Snapshot processing (OPC) is performed and the processing of information, such as the TimeStamp and backup volume of a copy target, is registered into backup history information.
When synchronous processing (EC) is performed
The state of synchronous processing is checked and, in the case of an equivalent maintenance state, backup synchronous processing is suspended. Information such as time and backup volume of a copy target is simultaneously registered into backup history information. A backup of this form is called synchronous high-speed backup. Note that it aborts when an equivalent maintenance state is not reached. To use the "Chapter 4 Backup Operation Using Suspend/Resume Function" for synchronous high-speed backup, execute the backup command with -suspend option specified, and suspend backup synchronous processing.
In the above cases, a backup is established, and access to the backup volume is available immediately after the execution command.
AdvancedCopy Manager executes backup pre-processing and post-processing scripts before and after backup.
For information on customizing these scripts, refer to "Appendix A Pre-processing and Post-processing of Backup and Restoration".
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 a target backup volume to perform the snapshot fast backup. In the operand, specify a "device map file" in which a combination of a transaction volume and a target backup volume are described. If this option is not specified, the target backup volume is automatically selected by the backup function. To execute this command on a remote basis using the -h option, specify a device map file (of a Managed Server) using an absolute pathname. A file name specified in Device-Map-File must not include any national character.
This results in synchronous high-speed backup using the "Chapter 4 Backup Operation Using Suspend/Resume Function".
Specifies that the differential snapshot high-speed backup be executed.
This option cannot be specified during synchronous processing.
This option is valid only for copying within a box when the ETERNUS Disk storage system supports the QuickOPC function.
If this option is not specified, ordinary snapshot processing (ie, OPC without using the QuickOPC function) is started. This option must always be specified to perform a backup operation using differential snapshots.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Back up a transaction volume:
# /opt/FJSVswsts/bin/swstbackup /dev/vg01 /dev/vg01 swstbackup completed #
NOTES
To preserve data integrity, this command performs the backup only after inhibiting access to both transaction and backup volumes from all other processes. Thus, drive letters, logical volume names or device labels of devices are unassigned. This command terminates with an error if a drive letter, logical volume name or device label of a transaction volume is assigned or if:
The mount point has directories to which other volumes are also mounted.
The volume has a file in use.
To mount a transaction volume from a server other than the server on which this command is entered, unmount the transaction volume, using the authority of the backup administrator.
When setting a volume group as a transaction volume, and backing up or restoring it, modify the pre-processing and post-processing script for backup (using an Administrator account) so that unmount/mount of all logical devices is carried out.
Backup cannot be executed in the following situations:
No backup policy has been specified for the specified transaction volume.
The backup that was executed one generation earlier was unsuccessful.
Restore is being performed to the transaction volume that is to be backed up.
Synchronous backup processing is performed in a transaction volume to be processed, but the state of equivalence is not reached;
Restoration is being executed using backup history information that causes a generation overflow (this may occur when restoration is performed using the backup volume of the oldest history).
Any of the box information (box identifier, OLU number, EXTENT start position, and EXTENT size) of a transaction volume has been changed.
No unused backup volume was available for use as the copying destination.
The replication management function is executing a process for the target transaction volume.
The replication management function is executing a process for the target backup volume.
The replication management function is executing a process for backup records exceeding the number of preservation generations.
Changes have been made to the logical disk configuration which cannot be supported by AdvancedCopy Manager.
A volume group is inactive in the volume group specification.
You cannot perform backup if:
The backup volume specified by the device map file cannot be paired with the transaction volume. This occurs if:
The specified backup volume is in use.
The transaction volume and the backup volume are not the same partition size.
The device map file contains an error (refer to "3.4.9.1 Describing Device Map File").
The device map file name includes a national character.
At this time, if existing backup history information satisfies the condition of the number of saved generations specified by the swstbkpolset command, then information on the oldest generation is automatically deleted from the backup history information during the backup process, and the backup volume is cleared. However, if -suspend or -T option is specified for the backup history information, then the backup volume with the Suspend or tracking state is not cleared and the backup volume remains in use.
The transaction volume on which the backup command is executed, one other transaction volume, and the suspended or tracking backup volume cannot be specified as backup destinations in the device map file.
This command can be executed only while none of the following commands are running:
NAME
swstbackstat - displays the completion status of a backup
SYNOPSIS
/opt/FJSVswsts/bin/swstbackstat [deviceName]
/opt/FJSVswsts/bin/swstbackstat [-h serverName] [deviceName]
DESCRIPTION
This command displays the completion status of a backup that is being performed using the swstbackup command.
The following information is displayed.
Title | Description |
|---|---|
Server | Displays a Managed Server name. |
Transaction-Disk | Displays the AdvancedCopy Manager device name of a transaction volume. |
Backup-Disk | Displays a backup volume name. |
Status | Displays a backup completion status using one of the following character strings: "----": No backup has been collected (ie, no history exists). |
Execute | Displays how much has been copied in percentage terms if "executing" is displayed in the Status column. Displays "----" unless "executing" 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.
OPERANDS
Specifies the AdvancedCopy Manager device name corresponding to a transaction volume.
If this operand is omitted, the backup execution statuses of all the transaction volumes are displayed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display the actual copying execution status:
# /opt/FJSVswsts/bin/swstbackstat Server Transaction-Disk Backup-Disk Status Execute job1 /dev/vg00 /dev/vg02 succeeded ---- job1 /dev/vg01 ---- ---- ---- : #
NOTES
Do not use the OPC stop function of ETERNUS Web GUI while the snapshot fast backup is in progress. If you do use the OPC stop function of ETERNUS Web GUI, this command displays "succeeded" in the Status column whether or not the backup has actually been successful.
If "failed", "halt", or "?????" is displayed in the Status column, a hardware error, etc. may have occurred. Refer to "7.3 Troubleshooting: Hardware Error During Backup" for information about this.
Backup execution status display cannot be executed in the following circumstances:
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.
NAME
swstrestore - restore
SYNOPSIS
/opt/FJSVswsts/bin/swstrestore [-g generationNo | -v versionNo] [-r restoreDeviceName] deviceName
/opt/FJSVswsts/bin/swstrestore [-h serverName] [-g generationNo | -v versionNo][-r restoreDeviceName] deviceName
DESCRIPTION
The data that exists in backup history information is restored using OPC.
When this command is executed, AdvancedCopy Manager performs the restoration pre-processing and post-processing scripts before and after copying data using OPC. For more information on customizing these scripts, refer to "Appendix A Pre-processing and Post-processing of Backup and Restoration".
You can restore data to a device that is not a transaction volume. When you do so, the device must not be registered as a transaction volume and the device must have the same amount of space available as the specified transaction volume.
You can restore data to a device that is not a transaction volume. When you do so, the device must not be registered as a transaction volume and must have the same size as the specified transaction volume. To restore data on a volume other than a transaction volume, refer to "9.1.4 Notes on Restoration".
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 relative generation number of data to be restored.
Check the relative generation number using the swsthistdisp command.
Specifies the absolute generation number of data to be restored.
Check the absolute generation number using the swsthistdisp command.
Specifies a restore destination device name to restore data to any device other than a transaction volume.
Note: If neither the -g or -v option is specified, the latest information from the information history management is restored.
OPERANDS
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Restore data with relative generation number 2. For information on the relative generation number, refer to data displayed using the swsthistdisp command:
# /opt/FJSVswsts/bin/swstrestore -g 2 /dev/vg01 /dev/vg01 swstrestore completed #
If the "Chapter 4 Backup Operation Using Suspend/Resume Function" is used for the backup operation on the transaction volume, the suspended synchronous processing is deleted and the restore command is executed. For information on the suspended synchronous processing, refer to the data displayed by the swstsyncstat command. Execute the swstcancelsync command to cancel the synchronous processing:
# /opt/FJSVswsts/bin/swstsyncstat /dev/vg01 Server Transaction-Disk Backup-Disk Status Execute job2 /dev/vg01 /dev/vg02 suspend ---- job2 /dev/vg01 /dev/vg03 executing 75% # /opt/FJSVswsts/bin/swstcancelsync -all /dev/vg01 /dev/vg01 swstcancelsync completed # /opt/FJSVswsts/bin/swstsyncstat /dev/vg01 Server Transaction-Disk Backup-Disk Status Execute job2 /dev/vg01 ---- ---- ---- # /opt/FJSVswsts/bin/swstrestore /dev/vg01 /dev/vg01 swstrestore completed #
NOTES
On a transaction volume on which a file system has been constructed, restore a specific file as follows:
Mount a backup volume. Check the backup volume by using the Backup History List screen or the swsthistdisp command.
For the procedure for mounting the backup volume, refer to "9.1.4 Notes on Restoration".
Copy the file to be restored by executing, for example, the cp command.
Unmount the backup volume.
If a transaction volume is mounted from a server other than the server on which this command is entered, execute this command after unmounting the transaction volume, using the authority of the backup administrator.
Restoration or recovery cannot be executed in the following situations:
When both relative and absolute generation numbers have been specified.
When a device registered as a transaction volume has been specified in a parameter with the -r option.
When a device registered as a backup volume has been specified in a parameter with the -r option, the device has been registered in the backup registration information of a certain transaction volume. If you restore data to a backup volume without registered backup data, and the backup volume is used to back up a certain transaction volume, then data is overwritten. It is recommended that a backup volume should NEVER be specified as a restore destination device.
When you perform restoration immediately after starting backup where the actual copying using OPC is still in progress, (except when the combination of transaction volume and backup volume is the same for backup and restoration). A restoration should always be performed after the actual copying using OPC is completed. Alternatively, on a transaction volume on which a file system has been constructed, perform restoration according to the method described in the Point "In a transaction volume on which a file system has been constructed, restore a specific file" above.
A transaction volume currently in use with synchronous backup processing is specified.
When any of the box information (box identifier, OLU number, EXTENT start position, and EXTENT size) of a transaction volume to be restored has been changed.
The replication management function is executing a process for the target transaction volume.
The replication management function is executing a process for the device specified in the -r option.
The mount point set at registration of a transaction volume has been changed.
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 suspended or tracking backup volume cannot be used as the restore destination volume.
The restore command cannot be executed on a transaction volume during synchronous processing (eg, during copying by EC, under the equivalency maintained status, in the Suspend state).
If the following errors occur during restore processing, then execute the swstcancelsync command (with the -all option specified) to cancel all of the synchronous processing of the transaction volume, and execute the restore command:
"swst0639 This Command cannot be run. This is because a copy is currently running"
"swst0634 OPC cannot be run. Error code=26 (SCSI command busy)"
This command can only be executed while none of the following commands are running:
NAME
swstcancelrest - cancels OPC-based restoration
SYNOPSIS
/opt/FJSVswsts/bin/swstcancelrest [-g generationNo | -v versionNo] [-r restoreDeviceName] [-emergency] deviceName
/opt/FJSVswsts/bin/swstcancelrest [-h serverName][-g generationNo | -v versionNo][-r restoreDeviceName] [-emergency] deviceName
DESCRIPTION
This command cancels OPC-based restoration.
A hardware error is displayed when the swstrestore command is executed while data is being copied using OPC. Fix the cause of the hardware error and repeat restoration using the swstrestore command.
Check whether a fault occurred using the swstreststat command.
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 relative generation number of data being restored.
This option cannot be specified at the same time as the -v option.
Check the relative generation number using the swstreststat command.
Specifies the absolute generation number of data being restored.
This option cannot be specified at the same time as the -g option.
Check the absolute generation number using the swstreststat command.
Specifies the device name if data is restored to any other device than a transaction volume.
Check the device name using the swstreststat command.
Emergency operation mode is available for operations.
In such cases, OPC sessions are neither confirmed nor cancelled.
Note: The restoration of the latest history information is cancelled if neither the -g or -v option is specified.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Cancel restoration of the transaction volume:
# /opt/FJSVswsts/bin/swstcancelrest -g 1 /dev/vg01 /dev/vg01 swstcancelrest completed. #
Cancelling a restore of the latest history information on the transaction volume in emergency operation mode:
# /opt/FJSVswsts/bin/swstcancelrest -emergency /dev/vg02 /dev/vg02 swstcancelrest completed. #
NOTES
If you cancel OPC-based restoration using this command, the transaction volume is in an incomplete state and can no longer be used because part of the data has already been overwritten by the copy process. Perform restoration again using the swstrestore command.
You cannot cancel restoration if:
The history specified in the -g or -v option does not exist.
Restoration is not performed on the device specified in the -r option.
Restoration is not performed from the specified history. In this case, processing is terminated with an information message "swst0303 Restoration for specified restoration device is not performed". The end status after this message is a normal end.
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 replication management function is executing a process for the target transaction volume
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 case, ETERNUS Web GUI must be used to cancel these sessions.
This command can only be executed while none of the following commands are running:
NAME
swstreststat - displays the execution status of restoration
SYNOPSIS
/opt/FJSVswsts/bin/swstreststat [-g generationNo | -v versionNo] [deviceName]
/opt/FJSVswsts/bin/swstreststat [-h serverName] [-g generationNo | -v versionNo] [deviceName]
DESCRIPTION
This command displays the execution status of restoration.
The following information is displayed.
Title | Description |
|---|---|
Server | Displays a Managed Server name. |
Transaction-Disk | Displays the AdvancedCopy Manager device name of a transaction volume. |
Generation | Displays the relative generation number of restored backup data. |
Version | Displays the absolute generation number of restored backup data. |
Backup-Disk | Displays the name of a backup volume from which data should be copied and restored. |
Restore-Device | Displays a restoration target device name unless data is copied and restored to a transaction volume. |
Status | Displays the execution status: "----": No copying using OPC is in progress. |
Execute | Displays how much has been copied in percentage terms if "executing" is displayed in the Status column. Displays "----" unless "executing" 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.
Specifies the relative generation number of data whose restore execution status is to be displayed.
Check the relative generation number using the swsthistdisp command.
Specifies the absolute generation number of data whose restore execution status is to be displayed.
Check the absolute generation number using the swsthistdisp command.
The restore execution statuses of all the histories are displayed if both the -g and -v options are omitted.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
If this operand is omitted, the restore execution statuses of all the transaction volumes are displayed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display the restore execution statuses of transaction volumes:
# /opt/FJSVswsts/bin/swstreststat Server Transaction-Disk Generation Version Backup-Disk Restore-Device Status Execute job2 /dev/vg01 1 10 /dev/vg10 /dev/vg20 executing 75% job2 /dev/vg02 ---- ---- ---- ---- ---- ---- job2 /dev/vg03 2 12 /dev/vg11 ---- succeeded ---- job2 /dev/vg04 3 13 /dev/vg12 /dev/vg21 executing 75% : #
NOTES
Do not use the OPC stop function of ETERNUS Web GUI while the snapshot fast backup is in progress. If you use the OPC stop function of ETERNUS Web GUI, this command displays "succeeded" whether or not the restoration has actually been successful.
If "failed", "halt", or "?????" is displayed in the Status column, a hardware error, etc. may have occurred. Refer to "7.3 Troubleshooting: Hardware Error During Backup" for information about this.
If no generation number has been specified in the -v or -g option, the restore execution statuses of all the histories are displayed. If, at this time, restoration is not in progress from any of the histories, "----" is displayed in all the information columns other than "Server" and "Transaction-Disk".
In the following cases, restore execution status display processing cannot be executed:
Changes have been made to the logical disk configuration which cannot be supported by AdvancedCopy Manager.
A volume group is in an inactive state in volume group specification.
NAME
swsthistdisp - displays the backup history information
SYNOPSIS
/opt/FJSVswsts/bin/swsthistdisp [deviceName]
/opt/FJSVswsts/bin/swsthistdisp [-h serverName] [deviceName]
DESCRIPTION
This command displays history information in relation to data that has been backed up.
The following information is displayed.
Title | Description |
|---|---|
Server | Displays a Managed Server name. |
Device | Displays the AdvancedCopy Manager device name. |
Mount-Point | Displays the mount point of a device. The file system type of the mount point is displayed inside the parentheses. However, AIX does not display mount points. Therefore, "---- (----)" is always displayed. |
Generation | Displays a relative generation number. |
Version | Displays an absolute generation number. |
Backup-Date | Displays a TimeStamp reflecting when backup has been completed. |
Backup-Disk | Displays the name of a backup volume to which data has been backed up. |
Status | Displays an actual copying execution status using one of the following character strings: "succeeded": Copying using OPC has been completed. This item is not displayed if no backup history information exists. |
Execute | Displays how much has been copied in percentage terms if "executing" is displayed in the Status column. Displays "----" unless "executing" is displayed. This item is not displayed if no backup history information exists. |
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.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
If this operand is omitted, the backup history information of all the transaction volumes is displayed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display the backup history information of all the transaction volumes:
# /opt/FJSVswsts/bin/swsthistdisp Server=StrgSV01 Device=/dev/vg01 Mount-Point=---- (----) Generation Version Backup-Date Backup-Disk Status Execute 1 10 2000/11/12 22:00 /dev/vg02 succeeded ---- 2 9 2000/11/11 22:00 /dev/vg03 succeeded ---- : #
NOTES
If "failed", "halt", or "?????" is displayed in the Status column, a hardware error, etc. may have occurred. Refer to "7.3 Troubleshooting: Hardware Error During Backup" for information about this.
In the following cases, history information display processing cannot be executed:
Changes have been made to the logical disk configuration which cannot be supported by AdvancedCopy Manager.
A volume group is in an inactive state in volume group specification.
NAME
swsthistdel - deletes backup history information
SYNOPSIS
/opt/FJSVswsts/bin/swsthistdel -g generationNo| -v versionNo | -z [-emergency] deviceName
/opt/FJSVswsts/bin/swsthistdel [-h serverName] -g generationNo| -v versionNo | -z [-emergency] deviceName
DESCRIPTION
This command deletes backup history information.
The backup volume of the deleted history is released and becomes an empty backup volume.
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 relative generation number of backup history information to be deleted.
This option cannot be specified at the same time as the -v or -z option.
Check the relative generation number using the swsthistdisp command.
Specifies the absolute generation number of backup history information to be deleted.
This option cannot be specified at the same time as the -g or -z option.
Check the absolute generation number using the swsthistdisp command.
Specifies that all the backup history information is to be deleted.
This option cannot be specified at the same time as the -g or -v option.
Emergency operation mode is available for operations.
In such cases, OPC sessions are neither confirmed nor cancelled.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Delete a history with absolute generation number 10 of a transaction volume:
# /opt/FJSVswsts/bin/swsthistdel -v 10 /dev/vg01 /dev/vg01 swsthistdel completed #
The history information of relative generation number 1 of the transaction volume is deleted in the emergency operation mode:
# /opt/FJSVswsts/bin/swsthistdel -g 1 -emergency /dev/vg02 /dev/vg02 swsthistdel completed #
NOTES
You cannot delete backup history information if:
The backup history information specified in the -g or -v option does not exist.
The specified backup history information is currently being used in a restoration.
Changes have been made to the logical disk configuration which cannot be supported by AdvancedCopy Manager.
A volume group is in an inactive state in volume group specification.
The replication management function is executing a process for the target transaction volume.
The replication management function is executing a process for the target backup volume.
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 case, ETERNUS Web GUI must be used to cancel these sessions.
Deleting the suspended history information does not cancel the synchronous processing (in an EC session).
Deleting the tracking history information does not cancel the tracking processing (in an OPC session).
In synchronous high-speed backup with -suspend option specified, the backup volume remains in use even after the history information is deleted.
In differential snapshot high-speed backup with -T option specified, the backup volume remains in use even after the history information is deleted.
If the history information is deleted while the OPC physical copy has not been completed in a backup operation mode other than the differential snapshot high-speed backup, physical copying of the deleted history is interrupted. In this case, the data in the backup volume is incomplete (ie, copy has stopped part way through). The backup volume is put in the unused state upon deletion of the history information and becomes ready for use in the next backup.
In the differential snapshot high-speed backup mode, the physical copying of the deleted history is continued even after the history information on the incomplete OPC physical copy is deleted. Even after deletion of the history information, the backup volume is in the busy state and becomes ready for use in the next backup of the relevant transaction volume.
This command can be executed only while none of the following commands are running:
NAME
swststartsync - starts backup synchronous processing
SYNOPSIS
/opt/FJSVswsts/bin/swststartsync deviceName [-Xdevmap deviceMapFile]
/opt/FJSVswsts/bin/swststartsync [-h serverName] deviceName [-Xdevmap deviceMapFile]
DESCRIPTION
This command starts backup synchronous processing (ie, it starts disk-to-disk copy using EC).
Even if it is already in use, the transaction volume where the synchronous processing started s well as the suspended backup volume can be used as backup destinations.
Except for the transaction volume where the synchronous processing started and the suspended backup volume, transaction volumes cannot be specified as backup destinations in the device map file.
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 a target backup volume to perform the backup synchronous processing. In the operand, specify a device map file in which a combination of a transaction volume and a target backup volume is described. If this option is not specified, a target backup volume is automatically selected. To execute this command on a remote basis using the -h option, specify a device map file of a Managed Server using an absolute pathname. A file name specified in Device-Map-File must not include any national characters.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
To start the backup synchronous processing for a transaction volume:
# /opt/FJSVswsts/bin/swststartsync /dev/vg01 /dev/vg01 swststartsync completed. #
NOTES
When you execute the backup synchronous processing start command for a transaction volume to which the backup synchronous processing is already being executed, the message "swst0301 Backup synchronous processing is already in progress." is output.
You cannot start backup synchronous processing in the following cases. In any of the cases below, perform the action according to the [System Administrator Corrective Action] message.
When specifying a device that does not support the EC function.
When the backup volumes required for starting the backup synchronous processing cannot be obtained.
When specifying a device that is being restored by OPC.
When mounting the backup volume to which data is copied.
Changes have been made to the logical disk configuration which cannot be supported by AdvancedCopy Manager.
A volume group is inactive in the volume group specification.
The replication management function is executing a process for the target transaction volume.
If a suspended backup volume is the transaction volume at the start of the synchronous processing, then the suspended backup volume is selected as the backup destination with the highest priority, and the synchronous processing restarts (ie, differential copy) starts. Otherwise, the synchronous processing (ie, full copy) starts.
This command cannot be executed when any of the following commands are running:
NAME
swstcancelsync - cancels the backup synchronous processing
SYNOPSIS
/opt/FJSVswsts/bin/swstcancelsync [-emergency] [-bd Backup-Device-Name | -all] Device-Name
/opt/FJSVswsts/bin/swstcancelsync [-h serverName] [-emergency] [-bd backupDeviceName | -all] deviceName
DESCRIPTION
The backup synchronous processing can be cancelled during copying by EC or under the equivalency maintained status.
The synchronous processing can be cancelled with the backup volume during copying by EC, under the equivalency maintained status, or while the Suspend state is set. Specifying cancellation of all of the synchronous processing cancels all of the backup synchronous processing including those in the Suspended state.
If the system detects an error while backup synchronous processing is being executed, copying in progress at that time terminates abnormally. In this case, use this command to cancel the backup synchronous processing. Use the swstsyncstat command to check for the error.
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.
Emergency operation mode is available for operations.
In such cases, EC sessions are neither confirmed nor cancelled.
The synchronous processing on a specific backup volume can be cancelled.
Specify the copy destination backup volume name. In the operand, specify the AdvancedCopy Manager device name for the specified device.
Note that the backup volume name and the -all option cannot be specified together.
All of the synchronous processing of the transaction volume can be specified to be cancelled. Note that this specification and the -bd option cannot be used together.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Cancelling backup synchronous processing to a transaction volume:
# /opt/FJSVswsts/bin/swstcancelsync /dev/vg01 /dev/vg01 swstcancelsync completed. #
Cancelling backup synchronous processing of transaction volume in the emergency operation mode:
# /opt/FJSVswsts/bin/swstcancelsync -emergency /dev/vg02 /dev/vg02 swstcancelsync completed. #
Cancelling backup synchronous processing of the backup volume from the transaction volume:
# /opt/FJSVswsts/bin/swstsyncstat /dev/vg04 Server Transaction-Disk Backup-Disk Status Execute job2 /dev/vg04 /dev/vg05 suspend ---- job2 /dev/vg04 /dev/vg06 executing 75% # /opt/FJSVswsts/bin/swstcancelsync /dev/vg04 -bd /dev/vg06 /dev/vg04 swstcancelsync completed. # /opt/FJSVswsts/bin/swstsyncstat /dev/vg04 Server Transaction-Disk Backup-Disk Status Execute job2 /dev/vg04 /dev/vg05 suspend ---- #
Cancelling all of the backup synchronous processing of the transaction volume:
# /opt/FJSVswsts/bin/swstsyncstat /dev/vg07 Server Transaction-Disk Backup-Disk Status Execute job2 /dev/vg07 /dev/vg08 suspend ---- job2 /dev/vg07 /dev/vg09 executing 75% # /opt/FJSVswsts/bin/swstcancelsync /dev/vg07 -all /dev/vg07 swstcancelsync completed. # /opt/FJSVswsts/bin/swstsyncstat /dev/vg07 Server Transaction-Disk Backup-Disk Status Execute job2 /dev/vg07 ---- ---- ---- #
NOTES
However, EC sessions are neither confirmed nor cancelled by execution in the emergency operation mode. If an EC session is in the error suspended state or the halt state, then unmanaged sessions remain. In this event, ETERNUS Web GUI must be used to cancel these sessions.
You cannot cancel synchronous backup processing in the following case:
Changes have been made to the logical disk configuration which cannot be supported by AdvancedCopy Manager.
When a volume group is inactive in the volume group specification.
The replication management function is executing a process for the target transaction volume.
This command cannot be executed when any of the following commands are running:
NAME
swstsyncstat - displays the execution status of the backup synchronous processing
SYNOPSIS
/opt/FJSVswsts/bin/swstsyncstat [deviceName]
/opt/FJSVswsts/bin/swstsyncstat [-h serverName] [deviceName]
DESCRIPTION
The execution status of the backup synchronous processing is displayed (during copying, under the equivalency maintained status, or in the suspended status).
If one transaction volume has multiple EC sessions, then the statuses of all of these EC sessions are displayed.
The table below lists the meaning of each title.
Title | Description |
|---|---|
Server | Displays the name of the Managed Server. |
Transaction-Disk | Displays the AdvancedCopy Manager device name of a transaction volume. |
Backup-Disk | Displays the name of the backup volume. |
Status | Displays the status of backup synchronous processing: "----": Backup synchronous processing is not being executed. |
Execute | Displays the progress of the backup synchronous processing as a percentage (0 to 100%). |
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.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
When you omit the device name, the system displays the status of backup synchronous processing for all of the transaction volumes.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
To display the status of backup synchronous processing to a transaction volume:
# /opt/FJSVswsts/bin/swstsyncstat /dev/vg01 Server Transaction-Disk Backup-Disk Status Execute job1 /dev/vg01 /dev/vg02 suspend ---- job1 /dev/vg01 /dev/vg03 executing 75% #
To display the status of backup synchronous processing for all of the transaction volumes:
# /opt/FJSVswsts/bin/swstsyncstat Server Transaction-Disk Backup-Disk Status Execute job1 /dev/vg01 /dev/vg05 suspend ---- job1 /dev/vg01 /dev/vg06 executing 75% job1 /dev/vg01 /dev/vg07 suspend ---- job1 /dev/vg02 /dev/vg08 equivalent 100% job1 /dev/vg03 /dev/vg09 failed ---- job1 /dev/vg04 ---- ---- ---- #
NOTES
If "failed", "halt", or "?????" is indicated as the status of the backup synchronous processing (in the Status column), a hardware failure, etc. has possibly occurred. Refer to "7.3 Troubleshooting: Hardware Error During Backup" for more information about this.
If "nosession" is indicated as the status of the backup synchronous processing (in the Status column), resource information having inconsistency is a possible cause. Use the swstsrsemtch command to remove the inconsistency from the resource information.
In the following cases, backup synchronous processing progress display command cannot be executed:
Changes have been made to the logical disk configuration which cannot be supported by AdvancedCopy Manager.
A volume group is in an inactive state in volume group specification.
NAME
swstexecstat - displays the execution status of other commands executed
SYNOPSIS
/opt/FJSVswsts/bin/swstexecstat [-j] [deviceName]
/opt/FJSVswsts/bin/swstexecstat [-j] [-h serverName] [deviceName]
DESCRIPTION
This command displays the execution status of other commands executed on a transaction volume. The execution status of OPC or EC is displayed if OPC/EC is being executed.
The following information is displayed.
Title | Description |
|---|---|
Server | Displays a Managed Server name. |
Device | Displays the AdvancedCopy Manager device name. |
Last-Backup-Date | Displays the time when the last backup execution command was accepted. |
Interval | Displays how many days have passed after the specified number of interval days since the last backup date has been exceeded. This item is displayed as "DELAY=number-of-days-passing". "OK" is displayed if the number of interval days has not been exceeded. |
Status | Displays whether any of the following commands is being executed on a transaction volume. If so, "EXEC" is displayed. Otherwise, "IDLE" is displayed. |
Mount-Point (Method) | Displays the mount point of a device. The file system type of the mount point is displayed inside the parentheses. However, AIX does not display mount points. Therefore, "---- (----)" is always displayed. |
Execute | Displays the name of the command being executed or the progress of copying. "----": Neither a command, OPC, nor EC is being executed. During synchronous high-speed backup with -suspend specified, no operation ("----") is indicated in the Execute column. |
If multiple processes are performed on transaction volumes (for example, when the backup synchronous processing start command is issued while a real copy of the snapshot backup is being handled), the display in the Execute column conforms to the following rules:
The display of a command name takes priority if both copying and command executions are in progress.
When a disk copy of the snapshot backup and a disk copy of the backup synchronous processing are being handled simultaneously, the progress of the disk copy of the backup synchronous processing is displayed. A disk copy for restoration is not performed during disk copy of the snapshot backup or backup synchronous processing due to a restriction of ETERNUS Disk storage system.
The following information is displayed when -j option is specified.
Title | Description |
|---|---|
Server | Displays a Managed Server name. |
Device | Displays the AdvancedCopy Manager device name. |
Execute-Date | Displays the command execution date and time (TimeStamp). |
Status | Displays whether any of the following commands are being executed on a transaction volume. If so, "EXEC" is displayed. Otherwise, "IDLE" is displayed. |
Mount-Point (Method) | Displays the mount point of a device. The file system type of the mount point is displayed inside the parentheses. However, AIX does not display mount points. Therefore, "---- (----)" is always displayed. |
Execute | Displays the name of the command being executed or the progress of copying. "----": Neither a command, OPC, nor EC is being executed. During synchronous high-speed backup with -suspend specified, no operation ("----") is indicated in the Execute column. |
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 to display information in another format.
OPERANDS
Specifies the AdvancedCopy Manager device name corresponding to a transaction volume.
If this operand is omitted, the execution statuses of all the transaction volumes are displayed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display the execution statuses of transaction volumes:
# /opt/FJSVswsts/bin/swstexecstat Server Device Last-Backup-Date Interval Status Mount-Point (Method) Execute job1 /dev/vg01 2000/12/11 12:20 OK IDLE ---- (----) ---- job1 /dev/vg02 2000/12/10 12:20 DELAY=1 IDLE ---- (----) sync(22%) job1 /dev/vg03 2000/12/09 12:20 DELAY=2 IDLE ---- (----) snapshot(45%) : #
An example of using the -j option is as follows:
# /opt/FJSVswsts/bin/swstexecstat -j Server Device Execute-Date Status Mount-Point (Method) Execute job1 /dev/vg01 2000/12/11 12:20 IDLE ---- (----) ---- job1 /dev/vg02 2000/12/10 12:20 IDLE ---- (----) sync(22%) job1 /dev/vg03 2000/12/09 12:20 IDLE ---- (----) snapshot(45%) : #
NOTES
If "sync (failed)", "snapshot(failed)", "restore(failed)", "restore(halt)", or "?????" is displayed in the Execute column, a hardware error may have occurred. Refer to "7.3 Troubleshooting: Hardware Error During Backup" for more information about this.
In the following cases, execution status display command cannot be executed:
Changes have been made to the logical disk configuration which cannot be supported by AdvancedCopy Manager.
A volume group is in an inactive state in volume group specification.
NAME
swstcanceltrk - stops tracking processing
SYNOPSIS
/opt/FJSVswsts/bin/swstcanceltrk [-copy | -emergency] deviceName (-bd backupDeviceName | -all)
/opt/FJSVswsts/bin/swstcanceltrk [-h serverName] [-copy | -emergency] deviceName (-bd backupDeviceName | -all)
DESCRIPTION
This command stops tracking processing.
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 physical copying, if active, should also be stopped (the OPC session should be cancelled).
This option cannot be specified for a backup volume that has already contained a backup history. For a volume whose copy destination volume has contained a backup history, delete the history information in advance using the swsthistdel command.
Specifies that the command should operate in the emergency operation mode.
The command does not check tracking processing and does not stop tracking processing or the OPC session.
Stops tracking processing for the specified backup volume. Specify the target backup volume name as an operand. This option cannot be specified at the same time as the -all option.
Stops the entire tracking processing specified for the transaction volumes. This option cannot be specified at the same time as the -bd option.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
The following example stops the tracking processing that was specified for the backup volume from the transaction volume:
# /opt/FJSVswsts/bin/swstcanceltrk /dev/vg03 -bd /dev/vg08 /dev/vg03 swstcanceltrk completed. #
The following example stops tracking processing and physical copying that were specified for the transaction volume:
# /opt/FJSVswsts/bin/swsttrkstat /dev/vg03 Server Transaction-Disk Backup-Disk Status Execute Update job2 /dev/vg03 /dev/vg03 executing 33% ----- # /opt/FJSVswsts/bin/swstcanceltrk -copy /dev/vg03 -bd /dev/vg08 /dev/vg03 swstcanceltrk completed. #
NOTES
If the command is executed in emergency operation mode, no OPC session is cancelled. A session that is not managed remains in operation if the command is entered during tracking. The session must be cancelled using ETERNUS Web GUI.
Tracking processing cannot be stopped under the following condition. In this case, take action according to "System Administrator Corrective Action" provided for the message output.
When tracking processing is not performed for the specified copy source and destination volumes.
This command cannot be executed while one of the following commands is being executed:
NAME
swsttrkstat - displays the status of tracking processing
SYNOPSIS
/opt/FJSVswsts/bin/swsttrkstat [deviceName]
/opt/FJSVswsts/bin/swsttrkstat [-h serverName] [deviceName]
DESCRIPTION
This command displays the status of tracking processing.
When multiple types of synchronous processing are running on one transaction volume, the command displays the statuses of all types of tracking processing.
The displayed data is explained below.
Title | Description |
|---|---|
Server | Displays a Managed Server name. |
Transaction-Disk | Displays the AdvancedCopy Manager device name of a transaction volume. |
Backup-Disk | Displays a backup volume name. |
Status | Displays the execution status. "----": Not in the process of tracking |
Execute | Displays the progress of copying as a percentage when "executing" is displayed in the Status column. "----" is displayed when "tracking" is displayed in the Status column. |
Update | Displays the amount of updated data after logical copying as a percentage when "tracking" is displayed in the Status column. "----" is displayed when "executing" is displayed in the Status column. |
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.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
If this operand is omitted, the command displays the statuses of tracking processing for all transaction volumes.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
The following example displays the status of tracking processing of a transaction volume:
# /opt/FJSVswsts/bin/swsttrkstat /dev/vg03 Server Transaction-Disk Backup-Disk Status Execute Update job1 /dev/vg03 /dev/vg08 tracking ---- 12% #
The following example displays the status of tracking processing of all transaction volumes:
# /opt/FJSVswsts/bin/swsttrkstat Server Transaction-Disk Backup-Disk Status Execute Update job1 /dev/vg03 /dev/vg09 nosession ---- ---- job1 /dev/vg04 /dev/vg10 executing 75% ---- job1 /dev/vg05 /dev/vg11 failed ---- ---- job1 /dev/vg06 /dev/vg12 ????? ---- ---- job1 /dev/vg07 /dev/vg13 tracking ---- 12% job1 /dev/vg08 ---- ---- ---- ---- : #
NOTES
When the execution status (ie, the value displayed in the "Status" column) is "failed" or "?????", a hardware problem, etc. has occurred. Refer to "7.3 Troubleshooting: Hardware Error During Backup" for more information about this.
When the execution status (ie, the value displayed in the "Status" column) is "nosession," the resource information is probably inconsistent. Use the swstsrsemtch command to remove any inconsistencies from the resource information.
The execution status of the tracking process cannot be displayed under the following conditions:
Changes have been made to the logical disk configuration which cannot be supported by AdvancedCopy Manager.
A volume group is in an inactive state in volume group specification.
