This section describes operation commands for backup management.
Note
All operational commands require that a Tape Server and its daemon be active. If a command is issued when either is not active, the command outputs a message and terminates with an error.
NAME
acmbackup - Backup of data
SYNOPSIS
[For Solaris/Linux]
/opt/FJSVswstc/bin/acmbackup [-suspend | -T] [-m Media] [-o] [-w] [-b Backup-Type] Device-Name [-Xdevmap Device-Map-File]
[For HP-UX/AIX]
/opt/FJSVswstc/bin/acmbackup [-suspend | -T] [-m Media] [-o] [-w] [-b Backup-Type] Device-Name [-Xdevmap Device-Map-File]
[For Windows]
program-directory\bin\acmbackup [-suspend | -T] [-m Media] [-o] [-w] [-b Backup-Type] Device-Name [-Xdevmap Device-Map-File] [-Xflush]
DESCRIPTION
This command backs up transaction volume data.
The command works differently depending on the specified backup destination media and the status of the advanced copy that is being executed:
When only disk or both disk and tape are specified as the backup destination media
When synchronous processing (EC) is not performed
Snapshot processing (OPC) is performed and processing information, such as the date and backup volume of a copy target, is registered into backup history information. This is called snapshot type high speed backup.
When synchronous processing (EC) is performed
The state of synchronous processing is checked and, in the case of an equivalency 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. Backup forming this manner is called synchronous high speed backup. The backup will abort if an equivalency maintenance state is not reached.
To use the Suspend/Resume function for synchronous high speed backup, execute the backup command with -suspend specified, and suspend backup synchronous processing.
In both cases, a backup is established and access to the backup volume is available immediately after the command execution.
When only tape is specified as the backup destination media
Data is backed up directly from a transaction volume to tape regardless of the state of synchronous processing. No backup volume is used.
Before performing backup, AdvancedCopy Manager executes the backup pre-processing shell script (OpcBackup.pre) and tape copy pre-processing script (TapeCopy.pre). When backup is completed, it executes the backup post-processing shell script (OpcBackup.post) and tape copy post-processing script (TapeCopy.post).
For information on customizing these shell scripts, refer to "Appendix A Pre-processing and Post-processing of Backup, Restoration, and Tape Copy".
OPTIONS
For backup to both disks and tape, you may want to perform day management backup to tape. In this case, execute acmbackup with DISK specified in the -m option to perform backup to disk only, then execute acmtphistcopy with DAY specified in the -b option to create a day management tape history.
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 is described. If this option is not specified, the target backup volume will be 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 Storage Server) using an absolute pathname. A file name specified in Device-Map-File must not include any national characters.
Specifies the flushing of the file system buffer of the transaction volume instead of locking the transaction volume. Before this option is specified, all write processing on the transaction volume must be stopped. (During a backup process where the write processing is not stopped, the reliability of the transaction volume data is not guaranteed.)
The file system buffer can be flushed by specifying 'on' for BufferFlushOnly in the transaction volume locking specification file for backups instead of this option.
For details, refer to "Transaction volume locking specification file for backups" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
This results in synchronous high-speed backup using the Suspend/Resume function.
This option cannot be specified if the -T option has been specified.
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 cabinet when the ETERNUS storage system supports the QuickOPC function.
If this option is not specified, ordinary snapshot processing (OPC without using the QuickOPC function) is started. This option must always be specified to perform backup using differential snapshots.
This option cannot be specified if TAPE has been specified in the -m option.
This option cannot be specified if the -suspend option has been specified.
Specifies the management mode for writing backup data to tape.
Specify GEN for generation management backup.
Specify DAY for day management backup.
If this option is omitted, tape backup is performed in generation management mode.
If DISK is specified in the -m option, this option cannot be specified.
If BOTH is specified in the -m option, DAY cannot be specified in this option.
Specifies the type of backup destination media.
Specify DISK for backup to disk.
Specify TAPE for backup to tape.
Specify BOTH for backup to disk and tape.
If this option is omitted, backup is performed to both disk and tape.
Specifies that backup data be saved to tape without waiting for OPC copying to be completed.
Because this function causes writing backup data to tape to begin as soon as copying begins, it affects job server performance in regard to transaction volume access.
This option can be specified only if BOTH is specified in the -m option or the -m option is omitted.
This option cannot be specified for synchronous backup.
If the option is omitted, the command waits for OPC copying to be completed.
Specifies that the command not wait for writing to tape to be completed.
If DISK or TAPE is specified in the -m option, this option cannot be specified.
If this option is omitted, the command is completed after waiting for writing to tape to be completed.
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Back up a transaction volume (/dev/dsk/c1t0d5s3) to both disk and tape. Perform generation management backup to tape. The command returns when backup to disk is complete.
# /opt/FJSVswstc/bin/acmbackup -m BOTH -b GEN -w /dev/dsk/c1t0d5s3 /dev/dsk/c1t0d5s3 acmbackup completed #
Back up a transaction volume "dev/dsk/c1t1d0s6" to tape in day management mode:
# /opt/FJSVswstc/bin/acmbackup -m TAPE -b DAY /dev/dsk/c1t1d0s6 /dev/dsk/c1t1d0s6 acmbackup completed #
NOTES
To guarantee data, this command performs backup after inhibiting access to transaction and backup volumes from other processes. Thus, the drive letters of devices are not assigned. This command terminates with an error if a drive letter of a transaction volume is assigned or if:
The mount point has directories to which other volumes are to be 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 backup administrator authority. If the transaction volume must not be unmounted, create backup copies with the following procedure:
Execute the sync command to synchronize the transaction volume and file system.
Execute this command.
Execute the fsck command for the backup volume, and check the file system.
You cannot perform backup in the following cases. In these cases, do as described in [System Administrator's Response] in the message that will be output
No backup policy has been specified for the transaction volume.
An error is detected during writing to tape.
The OPC Backup executed one generation earlier was unsuccessful.
Restore is currently being executed for the transaction volume that is targeted for processing.
The mount point set at registration of a transaction volume has been changed.
A device containing SynfinityFILE resources consisting of multiple transaction volumes is mounted.
Restoration is being executed using backup history information that will cause a generation overflow.
An unused backup volume could not be acquired to be used as the copying destination.
Any of the cabinet information (cabinet identifier, OLU number, EXTENT start position, and EXTENT size) of a transaction volume has been changed.
A backup volume defined as the copy destination is mounted.
The specified transaction volume is busy performing backup to tape, restoration from tape, copying to tape, or deletion of history information from tape.
The -suspend option is specified when the state is other than synchronous processing.
The -T option is specified when SDX objects are backed up on a logical volume basis (for Solaris only).
In the following cases backup cannot be performed:
When the backup volume specified by the device map file (in the 'to' column) cannot be used in a pair with the transaction volume. This occurs if:
The specified backup volume is in use, or
The partition sizes of the operating volume and the backup volume are different.
When the device map file contains an error (refer to "5.3.9.1 Describing a device map file").
When the device map file name includes a national character
When an ordinary volume is specified as the transaction volume and a GDS logical volume as the backup volume.
When a GDS logical volume is specified as the transaction volume and an ordinary volume as the backup volume
As a result of backup, tape backup history information may exceed the number of preservation generations specified by the tape backup management class command. In this case, unlike for a backup to disk, the excess backup history information on tape is not immediately deleted. The Tape Server is automatically checked at a regular interval to determine whether the specified number of preservation generations has been exceeded. If it has been exceeded, the oldest history is deleted. For the settings for this automatic check, refer to "Setting of a Server Option File" in the "ETERNUS SF AdvancedCopy Manager Installation Guide".
If backup to disk fails when backup to both disk and tape is specified, the command terminates without performing backup to tape.
In contrast, if backup to tape fails, backup to disk can still succeed.
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.
The processing scripts are not executed before and after in the following case:
The mirror slice of the SDX object is TEMP.
On Solaris, differential snapshot fast backups cannot be performed during GDS linkage.
For notes of the backup with Windows, refer to "swstbackup (Backup execution command)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
Refer to "13.1.1 General Notes" for additional information on executing backup,.
This command can only be executed while none of the following commands are running:
swstsrsemtch (Resource match command)
swstsvrset (Storage Server configuration command)
swstdevinfoset (Device configuration command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
Point
At this time, if existing backup history information satisfies the condition of the number of saved generations specified by the backup policy setting 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 is specified for the backup history information, then a backup volume with the Suspend or tracking state is not cleared and remains in use.
In the case of a SynfinityFILE file system whose transaction volume consists of more than one device (multipartition), backup cannot be performed using pre-processing and post-processing scripts to execute unmount/mount.
In the case of a SynfinityFILE file system that consists of more than one device (multipartition), unmount the file system before backup is performed and mount it after backup is completed.
When the SynfinityFILE and AdvancedCopy Manager configurations are as follows:
# sfxinfo /dev/dsk/c1t3d10s1 ID special size mount Type 0 /dev/dsk/c1t3d10s1(800019) 25986 /mnt META 0 /dev/dsk/c1t3d10s1(800019) 105751 /mnt DATA 1 /dev/dsk/c1t3d15s3(800028) 5120 /mnt LOG 2 /dev/dsk/c1t3d16s3(800030) 131736 /mnt DATA # /opt/FJSVswstc/bin/acmdevdisp -t Server Device Size Device-Mode Mount-Point (Method) Backup-Engine SV1 /dev/dsk/c1t3d10s1 128.0 Mbyte Transaction /mnt (ufs) AdvancedCopy SV1 /dev/dsk/c1t3d15s3 5.0 Mbyte Transaction /mnt (ufs) AdvancedCopy SV1 /dev/dsk/c1t3d16s3 128.0 Mbyte Transaction /mnt (ufs) AdvancedCopy
Backup procedure
# umount /mnt # /opt/FJSVswstc/bin/acmbackup /dev/dsk/c1t3d10s1 /dev/dsk/c1t3d10s1 acmbackup completed # /opt/FJSVswstc/bin/acmbackup /dev/dsk/c1t3d15s3 /dev/dsk/c1t3d15s3 acmbackup completed # /opt/FJSVswstc/bin/acmbackup /dev/dsk/c1t3d16s3 /dev/dsk/c1t3d16s3 acmbackup completed # mount -F sfxfs /dev/dsk/c1t3d10s1 /mnt #
NAME
acmtphistcopy - Copying of backup history to tape
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmtphistcopy [-b Backup-Type] [-g Generation-No | -v Version-No] Device-Name
[For Windows]
program-directory\bin\acmtphistcopy [-b Backup-Type] [-g Generation-No | -v Version-No] Device-Name
DESCRIPTION
This command copies backup history information from disk to tape.
Data in the backup volume storing the backup history data of the specified disk is copied to tape. The data is managed with the same absolute generation number as the backup history of the copy source disk.
Backup history information cannot be copied unless a tape backup policy has been set.
A backup data management mode (generation management or day management) can be set. The default is generation management.
OPTIONS
If the -g and -v options are omitted, the latest disk history information is copied to tape.
Specifies the management mode for the data copied to tape.
Specify GEN for generation management.
Specify DAY for day management.
The default is generation management.
Specifies a relative generation number for the data copied to tape.
Relative generation numbers can be checked for with "11.2.2.9 acmhistdisp (History information display command)".
This option cannot be specified together with the -v option.
Specifies an absolute generation number for the data copied to tape.
Absolute generation numbers can be checked for with "11.2.2.9 acmhistdisp (History information display command)".
This option cannot be specified together with the -g option.
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Copy the latest backup of transaction volume "/dev/dsk/c1t0d0s6" to tape.
# /opt/FJSVswstc/bin/acmtphistcopy /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d0s6 acmtphistcopy completed #
With day management specified, copy the backup history with relative generation number 2 in a transaction volume (/dev/dsk/c1t0d5s3) to tape.
# /opt/FJSVswstc/bin/acmtphistcopy -g 2 -b DAY /dev/dsk/c1t0d5s3 /dev/dsk/c1t0d5s3 acmtphistcopy completed #
NOTES
If generation management history for the specified backup already exists on tape, copying to tape with generation management specified cannot be performed. In this case, perform copying to tape with day management specified. In day management mode, the same history information can be copied as many times as desired.
Backup data cannot be copied to tape in the following cases:
When a tape backup policy has not been set.
When the specified transaction volume is busy with backup to tape, restoration from tape, copying to tape, or deletion of history information from tape
When an error is detected during writing to tape.
This command can be executed only while none of the following commands are running:
swstsrsemtch (Resource match command)
swstsvrset (Storage Server configuration command)
swstdevinfoset (Device configuration command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
NAME
acmtpcancelback - Cancellation of tape backup
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmtpcancelback Device-Name[For Windows]
program-directory\bin\acmtpcancelback Device-NameDESCRIPTION
The command cancels backup of transaction volume data or backup volume data directly to the tape.
OPTIONS
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Cancel the tape backup operation of a transaction volume (/dev/dsk/c1t1d0s6).
# /opt/FJSVswstc/bin/acmtpcancelback /dev/dsk/c1t1d0s6 /dev/dsk/c1t1d0s6 acmtpcancelback completed #
NOTES
As a result of tape backup being cancelled under the following conditions, the maximum number of backup generations may be exceeded.
The same number of generations of backup history information as that set as the number of preservation generations that existed at the start of tape backup,
The tape backup is executed without specifying the data management method or by specifying the generation management as the data management method.
This command does not delete exceeded old history information. Therefore, by canceling the operation, the number of preservation generations may be exceeded if the write operation to the tape has been completed. In this instance, the history information deletion command must be used to delete unnecessary history information and re-start the backup operation.
The tape backup operation cannot be cancelled when the specified transaction volume has not been backed up to a tape or not copied to a tape.
In this instance, a notification message "swstm0157 The corresponding processing is not started or is already ended." will be displayed and will terminate the operation (the end status is a normal end).
NAME
acmrestore - Restoring of data
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmrestore [-g Generation-No | -v Version-No | -t Backup-Time] [-m Media] [-r Restore-Device-Name] [-f PhysicalIP-File] [-Xgds-softcopy] Device-Name
[For Windows]
program-directory\bin\acmrestore [-g Generation-No | -v Version-No | -t Backup-Time] [-m Media] [-r Restore-Device-Name] [-f PhysicalIP-File] [-Xgds-softcopy] Device-Name
DESCRIPTION
This command restores the data covered by backup history information. For restoration of disk data, the OPC function is used. For restoration of tape data, the backup data on tape is written directly to the restoration destination volume, and the recovery control file saved to tape during backup is also restored simultaneously.
The user can specify disk or tape as the restoration data source. If this option is omitted, data is restored from a disk if the history information is on the disk or from tape if the history information is on tape.
OPTIONS
If the -g, -v, and -t options are not specified, the latest history information subject to generation management is restored.
Specifies the relative generation number of the data to be restored.
Only data whose generation is managed can be specified in this option.
To check the relative generation number, execute "11.2.2.9 acmhistdisp (History information display command)".
When this option is specified, the -m option must also be specified.
This option cannot be specified together with the -v or -t option.
Specifies the absolute generation number of the data to be restored.
Only data whose generation is managed can be specified in this option.
To check the relative generation number, execute "11.2.2.9 acmhistdisp (History information display command)".
This option cannot be specified together with the -g or -t option.
Specifies the day management start date and time of the data to be restored.
Only data subject to day management can be specified in this option.
To check the day management start date and time, execute "11.2.2.9 acmhistdisp (History information display command)".
Specify the backup date and time in the "YYYY/MM/DD hh:mm:ss" format.
YYYY: Year (four digits)
MM: Month (two digits)
DD: Day (two digits)
hh: Hour (two digits)
mm: Minute (two digits)
ss: Seconds (two digits)
This option cannot be specified together with the -g or -v option.
If DISK is specified in the -m option, this option cannot be specified.
Specifies the media from which restoration is to be performed.
Specify DISK for restoration from a disk.
Specify TAPE for restoration from tape.
If this option is omitted, restoration is performed from a disk if the history information is on the disk or from tape if the history information is on tape. If the -t option is specified, restoration is always performed from tape even if this option is omitted.
Specifies the restoration destination device for restoration to a device other than a transaction volume.
This option cannot be specified for GDS logical volumes.
Specifies the absolute path of the file that contains the physical IP address of a Storage Server.
The file specified in this option must be allocated to the server on which the command is executed.
Specify the option only when the Storage Server satisfies the following conditions:
The Storage Server is in a cluster system.
The cluster service is stopped.
For information on the file that contains the physical IP address, refer to "Appendix B Restoring from the Tape when the Cluster Service is Stopped".
Specifies that restoration be performed by software-based copying in GDS Snapshot linkage mode. If this option is omitted, restoration is performed by OPC.
This option cannot be specified for restoration of history information on tape.
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies the block device name of transaction volume.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
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 the data displayed by "11.2.2.9 acmhistdisp (History information display command)".
# /opt/FJSVswstc/bin/acmrestore -g 2 -m DISK /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d0s6 acmrestore completed #
Restore the data that was backed up at 06:12:55 on February 2, 2005 under day management.
# /opt/FJSVswstc/bin/acmrestore -t "2005/02/02 06:12:55" /dev/dsk/c1t1d0s6 /dev/dsk/c1t1d0s6 acmrestore completed #
If the Suspend/Resume function is used for the backup on the transaction volume, the suspended synchronous processing is deleted and the restore command is executed. For synchronous processing during suspend control, refer to the data displayed by "11.2.2.13 acmsyncstat (Synchronous backup progress display command)". Execute "11.2.2.12 acmcancelsync (Synchronous backup cancel command)" to cancel the synchronous processing.
# /opt/FJSVswstc/bin/acmsyncstat /dev/dsk/c1t0d0s6 Server Transaction-Disk Backup-Disk Status Execute serv1 /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s5 suspend ---- serv1 /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s6 executing 75% # /opt/FJSVswstc/bin/acmcancelsync -all /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d0s6 acmcancelsync completed # /opt/FJSVswstc/bin/acmsyncstat /dev/dsk/c1t0d0s6 Server Transaction-Disk Backup-Disk Status Execute serv1 /dev/dsk/c1t0d0s6 ---- ---- ---- # /opt/FJSVswstc/bin/acmrestore /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d0s6 acmrestore completed #
NOTES
Because copying is performed in units of devices, backup data cannot be restored in units of files.
When the restore command is executed, AdvancedCopy Manager first executes the restoration pre-processing shell script (OpcRestore.pre), copies data, and then executes the restoration post-processing shell script (OpcRestore.post). For information on customizing these scripts, refer to "Appendix A Pre-processing and Post-processing of Backup, Restoration, and Tape Copy".
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.
You cannot perform restoration or recovery in the following cases. In these cases, do as described in [System Administrator's Response] in the message that will be output.
Both relative and absolute generation numbers have been specified.
The specified backup history is not found.
A device registered as a transaction volume has been specified in the -r option.
When a device registered as a backup volume has been specified in the -r option, and 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 has been used to back up a certain transaction volume, then data will be overwritten. You are recommended not to specify a backup volume as a restore destination device.
A slice including VTOC is specified for the -r option.
The restoration is performed immediately after backup (during actual OPC copying) is performed (except when the combination of transaction volume and backup volume used for backup and restore is the same). In this case, perform restoration after the 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 above.
If the SynfinityFILE file system is already mounted before restoration of devices of the SynfinityFILE file system consisting of multiple partitions, unmount the SynfinityFILE file system, and then restore all devices that make up the SynfinityFILE file system.
A transaction volume in the process of synchronous backup processing is specified.
Any of the cabinet information (cabinet identifier, OLU number, EXTENT start position, and EXTENT size) of a transaction volume to be restored has been changed.
The mount point set at registration of a transaction volume has been changed.
An SDX object has been specified in a parameter in the -r option.
The -Xgds-softcopy option is specified for a device that is not a GDS logical volume.
A GDS logical volume is specified as the restoration destination volume of an ordinary transaction volume.
If an error is detected during reading from tape
If the specified transaction volume is busy in restoration from a backup tape (excluding a case in which the restoration destination is different), copying to tape, or deletion of history information from tape
A suspended or tracking backup volume cannot be used as a restore destination volume.
The restore command cannot be executed on a transaction volume during the synchronous processing (during copying by EC, in the equivalency maintenance status, in the Suspend state).
If the following error occurs during restore processing, then execute the backup synchronous processing cancel 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 running."
or
"swst0634 OPC cannot be run. (SCSI command busy)"
For details on how to use SDX objects of GDS, refer to "5.7.2.1 Configuration and conditions of unsupported SDX objects" and "13.1.5 Notes on SDX Object Operations".
For notes of the restore with Windows, refer to "swstrestore (Restore execution command)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
Refer to "13.1.1 General Notes" for additional information on executing restoration.
This command can be executed only while none of the following commands are running:
swstsvrset (Storage Server configuration command)
swstdevinfoset (Device configuration command)
swstsrsemtch (Resource match command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
Point
A device that can be specified as a restoration destination must:
be at least the same size as the original transaction volume
be a volume other than a transaction volume
contain no backup data
not be under synchronous processing
not be under restoration
be the same size as the original transaction volume if restoration from a disk is performed, or be the same size as or larger than the original transaction volume if restoration from tape is performed
On a transaction volume on which a file system has been constructed, restore a specific file as follows:
Mount a backup volume. Confirm the backup volume using the backup history list screen or "11.2.2.9 acmhistdisp (History information display command)".
Copy the file to be restored, for example by executing the cp command.
Unmount the backup volume.
For the SynfinityFILE file system, follow the procedure below:
Execute the following commands for a backup volume:
# sfxadm RAW-device-name-of-the-backup-volume # fsck -F sfxfs -o f RAW-device-name-of-the-backup-volume
Mount the backup volume:
# mount -F sfxsfs backup-volume-name mount-point-name
Copy the file to be restored, for example by executing the cp command.
Unmount the backup volume:
# unmount backup-volume-name or mount-point-name
In the case of a SynfinityFILE file system that consists of more than one device (multipartition), backup cannot be performed using pre-processing and post-processing scripts to execute unmount/mount.
In this case, unmount the file system before restoration is performed and mount it after the restoration is completed.
When the SynfinityFILE and AdvancedCopy Manager configurations are as follows:
# sfxinfo /dev/dsk/c1t3d10s1 ID special size mount Type 0 /dev/dsk/c1t3d10s1(800019) 25986 /mnt META 0 /dev/dsk/c1t3d10s1(800019) 105751 /mnt DATA 1 /dev/dsk/c1t3d15s3(800028) 5120 /mnt LOG 2 /dev/dsk/c1t3d16s3(800030) 131736 /mnt DATA # /opt/FJSVswstc/bin/acmdevdisp -t Server Device Size Device-Mode Mount-Point (Method) Backup-Engine SV1 /dev/dsk/c1t3d10s1 128.0 Mbyte Transaction /mnt (ufs) AdvancedCopy SV1 /dev/dsk/c1t3d15s3 5.0 Mbyte Transaction /mnt (ufs) AdvancedCopy SV1 /dev/dsk/c1t3d16s3 128.0 Mbyte Transaction /mnt (ufs) AdvancedCopy
Restore procedure
# umount /mnt # /opt/FJSVswstc/bin/acmrestore /dev/dsk/c1t3d10s1 /dev/dsk/c1t3d10s1 acmrestore completed # /opt/FJSVswstc/bin/acmrestore /dev/dsk/c1t3d15s3 /dev/dsk/c1t3d15s3 acmrestore completed # /opt/FJSVswstc/bin/acmrestore /dev/dsk/c1t3d16s2 /dev/dsk/c1t3d16s3 acmrestore completed # mount -F sfxfs /dev/dsk/c1t3d10s1 /mnt #
When the SynfinityFILE file system is restored, the restore destination device may not be able to be mounted. In this event, use the following procedure to mount the device:
Execute the following on the restore destination device:
# sfxadm raw-device-name-of-restore-destination-device
Mount the restore destination device as follows:
# mount -F sfxfs restore-destination-device-name mount-point-name
This command cancels OPC-based restoration.
For more information, refer to "swstcancelrest (Restore cancellation command)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
Note
Restoration from tape cannot be canceled.
NAME
acmtpcancelrest - Cancellation of restoration from tape
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmtpcancelrest [-g Generation-No | -v Version-No | -t Backup-Time] [-r Restore-Device-Name] Device-Name
[For Windows]
program-directory\bin\acmtpcancelrest [-g Generation-No | -v Version-No | -t Backup-Time] [-r Restore-Device-Name] Device-Name
DESCRIPTION
This command cancels restoration from the tape.
OPTIONS
If none of the -g, -v, and -t options is specified, restoration of the backup history that is managed by the generation will be cancelled.
Specifies the relative generation number of data being restored.
This option cannot be specified together with the -v or -t option.
To check the relative generation number, specify the -l option and execute "11.2.2.8 acmtpreqstat (Tape execution status history display command)".
Specifies the relative generation number of data being restored.
This option cannot be specified together with the -g or -t option.
To check the relative generation number, specify the -l option and execute "11.2.2.8 acmtpreqstat (Tape execution status history display command)".
Specifies the start date and time of the day management in the data to be restored.
This option cannot be specified together with the -g or -v option.
To check the start date and time of the day management, specify the -l option and execute "11.2.2.8 acmtpreqstat (Tape execution status history display command)".
Specify the start date and time of the day management in the "YYYY/MM/DD hh:mm:ss" format. The "YYYY/MM/DD hh:mm:ss" format is as follows:
YYYY: Year (four digits)
MM: Month (two digits)
DD: Day (two digits)
hh: Hour (two digits)
mm: Minute (two digits)
ss: Seconds (two digits)
Specifies the name of the device when restored to a device other than a transaction volume.
To check the device name, specify the -l option and execute "11.2.2.8 acmtpreqstat (Tape execution status history display command)".
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies the block device name of transaction volume.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Cancel the tape restoration operation of history information with the absolute generation number 1 in the transaction volume (/dev/dsk/c1t1d0s6).
# /opt/FJSVswstc/bin/acmtpcancelrest -v 1 /dev/dsk/c1t1d0s6 /dev/dsk/c1t1d0s6 acmtpcancelrest completed #
NOTES
Because a part of the data would have been copied before this command is used to cancel restoration of data from the tape, the status of the transaction volume will be incomplete and so it cannot be used. The data must be restored using 11.2.2.4 acmrestore (Restore command) once again.
The tape restore operation cannot be cancelled when the specified transaction volume has not been restored from a tape.
In this instance, a notification message "swstm0157 The corresponding processing is not started or is already ended." will be displayed and will terminate the operation (the end status is a normal end).
This command displays the progress of restoration from the disk.
For more information, refer to "swstreststat (Restore execution status display command)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
Note
The progress of restoration from tape is not displayed.
NAME
acmtpreqstat - Display of the history of execution statuses of the tape
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmtpreqstat [-l] [-v] [Device-Name][For Windows]
program-directory\bin\acmtpreqstat [-l] [-v] [Device-Name]DESCRIPTION
The command displays the execution status of the processing by the tape manager currently in progress.
The command displays the execution status of the following:
Direct tape backup from the transaction volume
Copying data from the backup volume to the tape
Restoration data from the tape
Deletion of the backup history information on the tape
This command displays information on the executed processing from the latest.
OPTIONS
In addition to the tape execution history information, displays the command option specified when the command was executed
Displays the details of the tape execution history information
OPERANDS
For Solaris, Linux, HP-UX, or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
If this operand is omitted, the tape execution history of all the transaction volumes will be displayed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display the tape execution history information of all transaction volumes.
# /opt/FJSVswstc/bin/acmtpreqstat Server Transaction-Volume Request Execute-Date Status server01 /dev/dsk/c1t1d22s1 Delete 2007/02/22 09:15 Deleting server01 /dev/dsk/c1t1d20s1 Backup 2007/02/22 09:00 Preprocessing server01 /dev/dsk/c1t1d23s1 Restore 2007/02/22 08:00 Reading( 90%) #
Display the tape execution history information of the transaction volume (/dev/dsk/c1t1d0s6) and the command options by specifying the -l option.
# /opt/FJSVswstc/bin/acmtpreqstat -l /dev/dsk/c1t1d23s1 Server Transaction-Volume Request Execute-Date Status CmdOptions server01 /dev/dsk/c1t1d23s1 Restore 2007/02/22 08:00 Reading( 90%) [-v 10 -r /dev/dsk/c1t1d24s1] #
Display the detailed tape execution history information of the transaction volume (/dev/dsk/c1t1d0s6) by specifying the -v option.
# /opt/FJSVswstc/bin/ acmtpreqstat -v /dev/dsk/c1t1d20s1
Server Transaction-Volume Request Execute-Date End-Date Status Pool-Name Message
server01 /dev/dsk/c1t1d20s1 Backup 2007/02/22 09:00 ----/--/-- --:-- Preprocessing POOL01 ----
#
The contents displayed are as follows:
Key word | Description |
|---|---|
Server | Displays the Storage Server name |
Transaction-Volume | For Solaris, Linux, HP-UX or AIX, displays the device name For Windows, displays the AdvancedCopy Manager device name |
Request | Displays the processing name with the character strings shown below: "Backup": Backup on the tape, copy to the tape "Restore": Restore from the tape "Delete": Delete the tape history information |
Execute-Date | Displays the time and date when the tape manager accepted the processing Displays in the " YYYY/MM/DD hh:mm" format YYYYY indicates the year, MM indicates the month, DD indicates the day, hh indicates the hour and mm indicates the minute. The system time and date of the server will be displayed as the time and date. |
End-Date | Displays the time and date when the tape manager ended the processing. Displays in the " YYYY/MM/DD hh:mm" format. YYYYY indicates the year, MM indicates the month, DD indicates the day, hh indicates the hour and mm indicates the minute. The system time and date of the server will be displayed as the time and date. Displays only when the -v option is specified. If the processing has not ended, displays "----/--/-- --:--" |
Status | Displays the execution status of the processing or the progress rate of the write operation to the tape or the read operation from the tape with the character strings shown below: "Preprocessing": Pre-processing of backup/restore is being executed "Writing(xxx%)": Progress status of the tape write operation "Reading(xxx%)": Progress status of the tape read operation "Waiting-tape(xxx%)": Progress status of the tape write/read operation before the tape wait status is reached "Postprocessing": Post-processing of backup/restore is being executed "Cancel": Canceling of backup/restore is being executed "Deleting": Deletion of tape history information is being executed |
Pool-Name | Displays the storage pool name of the tape backup destination Displays when the processing name is "Backup" Displays "----" if the processing name is "Restore" and "Delete" or "Backup" but the tape write operation has not started Displays only when the -v option is specified |
CmdOptions | Displays the option and the value of the option specified Displays only when the -l option is specified |
Message | Displays a warning message or an error message "::" is displayed at the end of messages. If multiple messages are output, "::" is also displayed between messages. Displays "----" if the message doest not exist Displays only when the -v option is specified |
NAME
acmhistdisp - Display of backup history
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmhistdisp [-l] [Device-Name][For Windows]
program-directory\bin\acmhistdisp [-l] [Device-Name]DESCRIPTION
This command displays information on the backup history.
Generation management information is displayed after "Generation Management Backup" is output. Day management information is displayed after "Day Management Backup" is output.
OPTIONS
Displays detailed history information about a backup to tape.
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
If this operand is omitted, the backup history information of all the transaction volumes will be displayed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display the backup history information of all the transaction volumes.
# /opt/FJSVswstc/bin/acmhistdisp Generation Management Backup Server = StrgSV01 Device=/dev/dsk/c1t0d0s6 Mount-Point=/mnt/Tran1 (ufs) Generation Version Backup-Date Backup-Device Status Execute Tape-Gen 1 10 2004/11/12 22:00 /dev/dsk/c1t0d2s6 succeeded ---- 1 2 9 2004/11/11 22:00 /dev/dsk/c1t0d4s6 succeeded ---- 2 - 8 2004/11/10 22:00 - succeeded ---- 3 Day Management Backup Server=StrgSV01 Device=/dev/dsk/c1t0d0s6 Mount-Point=/mnt/Tran1 (ufs) TapeCopy-Date Backup-Date Expiration-Date 2004/11/01 09:35:02 2004/11/01 09:30 2004/12/01 09:35:02 #
Display detailed backup history information for a transaction volume (/dev/dsk/c1t1d10s1), using the -l option.
# /opt/FJSVswstc/bin/acmhistdisp -l /dev/dsk/c1t1d10s1 Generation Management Backup Server = StrgSV01 Device=/dev/dsk/c1t1d10s1 Mount-Point=/work1 (ufs) Generation Version Backup-Date Backup-Device Status Execute Tape-Gen CopyID Pool-Name Backup-Tape 1 10 2000/11/12 21:00 /dev/dsk/c1t0d2s6 executing 75 1 1 TapePool4 LT00059 2 9 2000/11/11 21:00 /dev/dsk/c1t0d4s6 succeeded ---- 2 1 TapePool4 LT00059 Day Management Backup Server = StrgSV01 Device=/dev/dsk/c1t1d10s1 Mount-Point=/work1 (ufs) TapeCopy-Date Backup-Date Expiration-Date Pool-Name Backup-Tape 2004/03/01 10:35:02 2004/03/01 10:30 2004/03/08 10:35:02 TapePool5 LT00040 #
The table below lists displayed information items for a generation management backup.
Keyword | Description |
|---|---|
Server | Displays a Storage Server name. |
Device | For Solaris, Linux, HP-UX or AIX, displays a device name. For Windows, displays the AdvancedCopy Manager device name. |
Mount-Point | For Solaris, Linux, HP-UX or AIX, displays the mount point name of the device and the file system type in parentheses. For Windows, displays the drive letter of a device. The file system type of the device is displayed inside the parentheses. |
Generation | Displays the relative generation number of disk backup data. The most recent backup history of backups is "1", and the generation indicates how many generations earlier the target backup history is in relation to "1". This item is displayed only for backup data on a disk. |
Version | Displays the absolute generation number. |
Backup-Date | Displays the backup start date and time in the "YYYY /MM /DD hh:mm" format. YYYY is the year, MM is the month, DD is the day, hh is the hour, and mm is the minute. For a backup performed only to disk, or to both disk and tape, the system date and time of the Storage Server is displayed. For a backup performed only to tape, the system date and time of the Tape Server is displayed. |
Backup-Device | Displays the backup volume name. This item is displayed only for backup data on a disk. |
Status | The copying progress is indicated by one of the following character strings: "succeeded": OPC copying is completed. "executing": OPC copying is in progress. "failed": OPC copying has been interrupted by an error. "halt": OPC copying is in the halt state. "gds-error": GDS copying has ended abnormally. This item is displayed only for backup data on a disk. |
Execute | Displays how much has been copied in percentage terms if "executing" is displayed in the Status field. If a string other than "executing" is displayed in the Status field, "----" is displayed. This item is displayed only for backup data on a disk. |
Tape-Gen | Displays the relative generation number of backup data on tape. This option displays the relative number of the generation of the target backup history, assuming that the latest backup history is 1. This item is displayed only for backup data on tape. |
CopyID | Displays the tape copy ID (fixed to 1). This item is displayed only for backup data on tape. The item is displayed only if the -l option is specified. |
Pool-Name | Displays the name of the storage pool to which tape backup was performed. This item is displayed only for backup data on tape. The item is displayed only if the -l option is specified. |
Backup-Tape | Displays the name of the tape volume to which backup was performed. If multiple tape volumes are applicable, their displayed names are delimited by a comma (,). This item is displayed only for backup data on tape. The item is displayed only if the -l option is specified. |
The table below lists displayed information items for day management backup.
Keyword | Description |
|---|---|
Server | Displays a Storage Server name. |
Device | For Solaris, Linux, HP-UX or AIX, displays a device name. For Windows, displays the AdvancedCopy Manager device name. |
Mount-Point | For Solaris, Linux, HP-UX or AIX, displays the mount point name of the device and shows the file system type in parentheses. For Windows, displays the drive letter of a device. The file system type of the device is displayed inside parentheses. |
TapeCopy-Date | Displays the start date and time of day management backup to tape in the "YYYY/MM/DD hh:mm:ss" format. YYYY is the year, MM is the month, DD is the day, hh is the hour, mm is the minute, and ss is the seconds. The date and time of the Tape Server is displayed. |
Backup-Date | Displays the backup start date and time in the "YYYY /MM /DD hh:mm" format. YYYY is the year, MM is the month, DD is the day, hh is the hour, and mm is the minute. For a backup performed only to disk, or to both disk and tape, the system date and time of the Storage Server is displayed. For a backup performed only to tape, the system date and time of the Tape Server is displayed. |
Expiration-Date | Displays the expiry date and time of day management backup to tape in the "YYYY/MM/DD hh:mm:ss" format. YYYY is the year, MM is the month, DD is the day, hh is the hour, mm is the minute, and ss is the seconds. The date and time of the Tape Server is displayed. If "NoLimit" is specified for the number of preservation days in the tape backup management class, "Never" is displayed. |
Pool-Name | Displays the name of the storage pool to which tape backup was performed. This item is displayed only if the -l option is specified. |
Backup-Tape | Displays the name of the tape volume to which backup was performed. If multiple tape volumes are applicable, their displayed names are delimited by a comma (,). This item is displayed only if the -l option is specified. |
NOTES
If "failed" or "halt" is displayed in the "Status" field, a hardware error may have occurred. Refer to "9.3 Troubleshooting for a Hardware Error during backup".
If "gds-error" is displayed in the Status field, a problem with GDS is assumed to have occurred. Correct the cause of the GDS problem, and take action as follows:
If backup synchronous processing is being executed, cancel it using "11.2.2.12 acmcancelsync (Synchronous backup cancel command)".
If snapshot backup is being executed, delete the backup history information using "11.2.2.10 acmhistdel (History information delete command)".
If restoration is in progress, execute "11.2.3.1 swstsrsemtch (Resource match command)", and perform restoration again.
NAME
acmhistdel - Deletion of backup history
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmhistdel {-g Generation-No | -v Version-No | -z} -m DISK [-emergency] Device-Name/opt/FJSVswstc/bin/acmhistdel {-g Generation-No | -v Version-No | -t TapeCopy-Date | -z} -m TAPE Device-Name/opt/FJSVswstc/bin/acmhistdel { -v Version-No | -z} [-m BOTH] [-emergency] Device-Name[For Windows]
program-directory\bin\acmhistdel {-g Generation-No | -v Version-No | -z} -m DISK [-emergency] Device-Nameprogram-directory\bin\acmhistdel {-g Generation-No | -v Version-No | -t TapeCopy-Date | -z} -m TAPE Device-Nameprogram-directory\bin\acmhistdel { -v Version-No | -z} [-m BOTH] [-emergency] Device-NameDESCRIPTION
This command deletes backup history information.
In cases involving a disk backup history, deleting history information for a backup volume causes the volume to be released and become an empty backup volume.
In cases involving a tape backup history, deleting history information from a tape area causes the area to become free. If backup data remains after the tape area becomes free, the area cannot be reused.
If a backup history is on both disk and tape, the user can delete the backup history from either of them.
OPTIONS
Specifies the relative generation number of history information for the generation management backup to be deleted.
When this option is specified, the -m option must also be specified.
This option cannot be specified together with the -v, -z or -t option.
To check the relative generation number, execute "11.2.2.9 acmhistdisp (History information display command)".
Specifies the absolute generation number of the history information for the generation management backup to be deleted.
This option cannot be specified together with the -g, -z or -t option.
To check the absolute generation number, execute "11.2.2.9 acmhistdisp (History information display command)".
Specifies the backup date and time of the day management backup history to be deleted.
To check the backup date and time, execute "11.2.2.9 acmhistdisp (History information display command)".
Specify the backup date and time in the "YYYY/MM/DD hh:mm:ss" format.
YYYY: Year (four digits)
MM: Month (two digits)
DD: Day (two digits)
hh: Hour (two digits)
mm: Minute (two digits)
ss: Seconds (two digits)
This option cannot be specified together with the -g, -v or -z option.
Specifies that all backup history information be deleted.
This option cannot be specified together with the -g, -v, -t or -c option.
Specifies the media from which backup data is to be deleted.
Specify DISK to delete the backup data and its history information from a disk.
Specify TAPE to delete the backup data and its history information from tape.
Specify BOTH to delete the backup data and its history from both disk and tape.
If multiple backup data items have been saved to tape, all of them are deleted.
If this option is omitted, the backup data and its history information saved to both disk and tape are deleted.
BOTH can be specified only if the -v or -z option is specified.
Specifies that the command be executed in emergency mode.
OPC session confirmation is not performed in this mode.
If TAPE is specified in the -m option, this option cannot be specified.
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Delete the backup history of absolute generation number 10 in a transaction volume (/dev/dsk/c1t0d0s6).
# /opt/FJSVswstc/bin/acmhistdel -v 10 /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d0s6 acmhistdel completed #
Delete the disk backup history information with relative generation number 2 of a transaction volume (/dev/dsk/c1t0d0s6).
# /opt/FJSVswstc/bin/acmhistdel -g 2 -m DISK /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d0s6 acmhistdel completed #
Delete the backup history information whose day management start time is 06:12:55, February 2, 2005 in a transaction volume (/dev/dsk/c1t0d5s3).
# /opt/FJSVswstc/bin/acmhistdel -t "2005/02/02 06:12:55" c1t0d5s3 /dev/dsk/c1t0d5s3 acmhistdel completed #
NOTES
If "failed" is displayed in the "Status" field by "11.2.2.9 acmhistdisp (History information display command)", a hardware failure is assumed. Refer to "9.3 Troubleshooting for a Hardware Error during backup".
You cannot delete backup history information if:
The backup history information specified by the -g, -v, -t or -z option is not found.
The specified backup history information is used in restoration.
The -t option is specified for deleting the history of a generation management backup.
The -v, -g or -m option is specified for deleting the history of a day management backup.
None of the -z, -g, -v, -t or -d options is specified.
The -m option is not specified and a relative generation number is specified.
The user may simultaneously set copy storage pools and write history information to multiple storage pools. In this case, history information cannot be deleted in storage pool units.
OPC sessions are neither confirmed nor cancelled by execution in emergency operation mode. If an OPC session is in the error suspended state or halt state, then unmanaged sessions remain. In this event, ETERNUSmgr or GRmgr must be used to cancel these sessions.
Execution is not possible in emergency operation mode for a transaction volume on a machine in the SP series.
If history information for which the OPC physical copy has not completed is deleted during backups, (other than differential snapshot fast backups), the physical copy for the deleted history information will be terminated. Data in the backup volume is incomplete because of the unfinished copying.
The backup volume enters the unused state when the history information is deleted. It becomes available when the next backup is performed.
For differential snapshot fast backups, OPC physical copies continue even if their history information is deleted before they complete.
The backup volume remains in use even after the history information is deleted, and is still available for backing up the associated transaction volume.
For details on how to use SDX objects of GDS, refer to "5.7.2.1 Configuration and conditions of unsupported SDX objects" and "13.1.5 Notes on SDX Object Operations".
This command can be executed only while none of the following commands are running:
swstsrsemtch (Resource match command)
swstsvrset (Storage Server configuration command)
swstdevinfoset (Device configuration command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
Point
Deleting the suspended history information does not cancel the synchronous processing (EC session).
Deleting the tracking history information does not cancel the tracking processing (OPC session).
In synchronous high-speed backup with -suspend specified, the backup volume remains in use even after the history information is deleted.
In differential snapshot high-speed backup with -T specified, the backup volume remains in use even after the history information is deleted.
NAME
acmstartsync - Start of synchronous backup
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmstartsync [-Xgds-softcopy | -Xgds-selectcopy] Device-Name [-Xdevmap Device-Map-File]
[For Windows]
program-directory\bin\acmstartsync [-Xgds-softcopy | -Xgds-selectcopy] Device-Name [-Xdevmap Device-Map-File]
DESCRIPTION
This command starts backup synchronous processing (disk-to-disk copy using EC).
For a GDS transaction volume, synchronous processing by software-copy is also possible.
OPTIONS
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, the target backup volume will be automatically selected. To execute this command on a remote basis using the -h option, specify a device map file (of a Storage Server) using an absolute pathname. A file name specified in Device-Map-File must not include any national characters.
Specifies the start of backup synchronous processing of an SDX object and use of the software-copy function instead of the advanced copy function.
If you specify this option to start differential copying when the advanced copy function is being used, advanced copy processing stops and software-copy processing starts.
You can specify the option when the function in linkage with GDS Snapshot is being used.
Specifies that GDS select the copy processing method of an SDX object.
You can specify the option when the function is being used in linkage with GDS Snapshot.
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Start synchronous backup processing of a transaction volume (/dev/dsk/c1t0d0s6).
# /opt/FJSVswstc/bin/acmstartsync /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d0s6 acmstartsync completed. #
Backup synchronous processing of a logical volume (/dev/sfdsk/CLS01/dsk/VOL01) of an SDX object is started. The copy processing method is software-copy.
# /opt/FJSVswstc/bin/acmstartsync -Xgds-softcopy /dev/sfdsk/CLS01/dsk/VOL01 /dev/sfdsk/CLS01/dsk/VOL01 acmstartsync completed. #
Backup synchronous processing of a logical volume (/dev/sfdsk/CLS01/dsk/VOL01) of an SDX object is started, and GDS selects the copy processing method.
# /opt/FJSVswstc/bin/acmstartsync -Xgds-selectcopy /dev/sfdsk/CLS01/dsk/VOL01 /dev/sfdsk/CLS01/dsk/VOL01 acmstartsync completed #
NOTES
When you execute this command for a transaction volume to which the backup synchronous processing is being executed, the message, "swst0301 Backup synchronous processing is being executed" is output and then the command is terminated normally.
You cannot start backup synchronous processing in the following cases. In any of the cases below, take an action according to the "System administrator response" message that will be displayed.
A device that does not support the EC function (no linkage with GDS Snapshot) is specified.
When the backup volumes required to start 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.
The -Xgds-softcopy option is specified for a device that is not a GDS logical volume. Alternatively, the -Xgds-selectcopy option is specified for a device that is not a GDS logical volume.
For Windows, when a backup volume could not be locked.
For Windows, when the backup volume locking specification file for backups is invalid.
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.
In the following cases, backup synchronous processing with the output destination backup volume specified cannot be started:
The backup volume specified in the device map file cannot be used as the backup volume to be paired with the transaction volume. This occurs if either of the following conditions is not met:
The specified backup volume is in the unused state.
The transaction volume and backup volume have the same partition size.
The target transaction volume is incorrectly described in the device map file (Refer to "5.3.9.1 Describing a device map file").
Any national language character is included in the device map file name.
An ordinary volume is specified as the transaction volume and a GDS logical volume as the backup volume.
A GDS logical volume is specified as the transaction volume and an ordinary volume as the backup volume.
For details on how to use SDX objects of GDS, refer to "5.7.2.1 Configuration and conditions of unsupported SDX objects" and "13.1.5 Notes on SDX Object Operations".
If any of the following commands is running, this command cannot be executed:
swstsrsemtch (Resource match command)
swstsvrset (Storage Server configuration command)
swstdevinfoset (Device configuration command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
Point
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 starts (ie, a full copy is performed).
Even if already in use, the transaction volume where the synchronous processing started, and the suspended backup volume can be used as backup destinations.
NAME
acmcancelsync - Cancellation of synchronous backup
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmcancelsync [-emergency] [-bd Backup-Device-Name | -all] Device-Name
[For Windows]
program-directory\bin\acmcancelsync [-emergency] [-bd Backup-Device-Name | -all] Device-Name
DESCRIPTION
Backup synchronous processing may be canceled during copying by EC, under the equivalency maintenance 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, the copying being performed at that time terminates abnormally. In this case, use this command to cancel the backup synchronous processing. "11.2.2.13 acmsyncstat (Synchronous backup progress display command)" can be used to check for errors.
OPTIONS
Specifies that the command should operate in emergency operation mode.
In such cases, EC sessions are neither confirmed nor cancelled.
If this option is specified for a volume on a machine in the SP-series it will be ignored.
The synchronous processing on a specific backup volume can be cancelled. To do so, specify the backup volume name in an operand. The backup volume name and -all option cannot be specified together. Specify the copy destination backup volume name. Specify the block device name for the specified device.
All of the synchronous processing of the transaction volume can be specified to be cancelled. This specification and the -bd option cannot be specified together.
OPERANDS
For Solaris, Linux, HP-UX, or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
The partition name is specified for the SDX object.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Cancel synchronous backup processing of a transaction volume (/dev/dsk/c1t0d0s6).
# /opt/FJSVswstc/bin/acmcancelsync /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d0s6 acmcancelsync completed. #
Backup synchronous processing of transaction volume (/dev/dsk/c1t0d0s6) is cancelled in emergency operation mode.
# /opt/FJSVswstc/bin/acmcancelsync -emergency /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d0s6 acmcancelsync completed. #
The backup synchronous processing of the backup volume (/dev/dsk/c1t0d2s6) can be specified to be canceled from the transaction volume (/dev/dsk/c1t0d0s6).
# /opt/FJSVswstc/bin/acmsyncstat /dev/dsk/c1t0d0s6 Server Transaction-Disk Backup-Disk Status Execute Work2 /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s5 suspend ---- Work2 /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s6 executing 75% # /opt/FJSVswstc/bin/acmcancelsync /dev/dsk/c1t0d0s6 -bd /dev/dsk/c1t0d2s6 /dev/dsk/c1t0d0s6 acmcancelsync completed. # /opt/FJSVswstc/bin/acmsyncstat /dev/dsk/c1t0d0s6 Server Transaction-Disk Backup-Disk Status Execute Work2 /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s5 suspend ---- #
All of the backup synchronous processing of the transaction volume (/dev/dsk/c1t0d0s6) can be specified to be cancelled.
# /opt/FJSVswstc/bin/acmsyncstat /dev/dsk/c1t0d0s6 Server Transaction-Disk Backup-Disk Status Execute Work2 /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s5 suspend ---- Work2 /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s6 executing 75% # /opt/FJSVswstc/bin/acmcancelsync /dev/dsk/c1t0d0s6 -all /dev/dsk/c1t0d0s6 acmcancelsync completed. # /opt/FJSVswstc/bin/acmsyncstat /dev/dsk/c1t0d0s6 Server Transaction-Disk Backup-Disk Status Execute Work2 /dev/dsk/c1t0d0s6 ---- ---- ---- #
NOTES
EC sessions are neither confirmed nor cancelled by execution in emergency operation mode. If an EC session is in the error suspended state or the halt state, then unmanaged sessions remain. In this event, ETERNUSmgr or GRmgr must be used to cancel these sessions.
For details on how to use SDX objects of GDS, refer to "5.7.2.1 Configuration and conditions of unsupported SDX objects" and "13.1.5 Notes on SDX Object Operations".
This command can be executed only while none of the following commands are running:
swstsrsemtch (Resource match command)
swstsvrset (Storage Server configuration command)
swstdevinfoset (Device configuration command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
NAME
acmsyncstat - Display of processing progress of synchronous backup
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmsyncstat [Device-Name][For Windows]
program-directory\bin\acmsyncstat [Device-Name]DESCRIPTION
The execution status of the backup synchronous processing is displayed (during copying, under the equivalency maintenance 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.
OPERANDS
For Solaris, Linux, HP-UX, or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
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
Display the synchronous backup processing status of a transaction volume (/dev/dsk/c1t0d0s6).
# /opt/FJSVswstc/bin/acmsyncstat /dev/dsk/c1t0d0s6 Server Transaction-Disk Backup-Disk Status Execute Work1 /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s5 suspend ---- Work1 /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s6 executing 75% #
Display the synchronous backup processing status of all transaction volumes.
# /opt/FJSVswstc/bin/acmsyncstat Server Transaction-Disk Backup-Disk Status Execute Work1 /dev/dsk/c1t0d0s3 /dev/dsk/c1t0d2s1 suspend ---- Work1 /dev/dsk/c1t0d0s3 /dev/dsk/c1t0d2s3 executing 75% Work1 /dev/dsk/c1t0d0s3 /dev/dsk/c1t0d3s3 suspend ---- Work1 /dev/dsk/c1t0d1s3 /dev/dsk/c1t0d3s5 equivalent 100% Work1 /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s6 failed ---- Work1 /dev/dsk/c1t0d1s4 ---- ---- ---- #
The table below lists the meaning of each title.
Title | Description |
|---|---|
Server | Indicates the name of the Storage Server. |
Transaction-Disk | Indicates the name of the transaction volume. |
Backup-Disk | Indicates the name of the backup volume. When backup synchronous processing is not being executed, the system displays "----". |
Status | Indicates the status of backup synchronous processing:
|
Execute | Indicates the progress of the backup synchronous processing by EC or software-copy as a percentage (0 to 100%). "----" is displayed when the status is Suspend and when backup synchronous processing is not taking place. |
NOTES
If "failed" or "halt" is indicated as the status of the backup synchronous processing (in the Status field), a hardware failure may have occurred. Correct the cause of the hardware problem, and take action according to "9.3 Troubleshooting for a Hardware Error during backup".
If "nosession" is indicated as the status of the backup synchronous processing (in the Status field)," resource information may be inconsistent. Use "11.2.3.1 swstsrsemtch (Resource match command)" to remove the inconsistency from the resource information.
If "gds-error" is the status displayed in the Status field, a problem with GDS is assumed to have occurred Correct the cause of the GDS problem, and take action as follows:
If backup synchronous processing is being executed, cancel it using "11.2.2.12 acmcancelsync (Synchronous backup cancel command)".
If snapshot backup is being executed, delete the backup history information using "11.2.2.10 acmhistdel (History information delete command)".
If restoration is in progress, execute "11.2.3.1 swstsrsemtch (Resource match command)", and perform restoration again.
NAME
acmexecstat - Display of command execution statuses
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmexecstat [Device-Name][For Windows]
program-directory\bin\acmexecstat [Device-Name]DESCRIPTION
This command displays the execution status of other commands executed on a transaction volume. The execution status of OPC/EC will be displayed if OPC/EC is being executed. This command displays the progress of any current backup to or restoration from tape. Generation management information is displayed after "Generation Management Backup" is output. Day management information is displayed after "Day Management Backup" is output.
OPERANDS
For Solaris, Linux, HP-UX, or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
If this operand is omitted, the execution statuses of all the transaction volumes will be displayed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display the execution statuses of transaction volumes.
# /opt/FJSVswstc/bin/acmexecstat Generation Management Backup Server Device Last-Backup-Date DiskInterval Status Mount-Point (Method) DiskExecute TapeInterval TapeExecute server1 /dev/dsk/c1t0d0s3 2004/12/11 12:20 OK IDLE /usr1 (ufs) ---- OK ---- server1 /dev/dsk/c1t0d0s4 2004/12/10 12:20 DELAY=1 EXEC /usr2 (ufs) sync(22%) OK Writing(50%) server1 /dev/dsk/c1t0d0s5 2004/12/09 12:20 DELAY=2 EXEC /usr3 (ufs) snapshot(45%) OK Writing(10%) Day Management Backup Server Device Last-Backup-Date Status Mount-Point (Method) TapeInterval TapeExecute server1 /dev/dsk/c1t0d0s3 2004/12/11 12:20 IDLE /usr1 (ufs) OK ---- server1 /dev/dsk/c1t0d0s4 2004/12/10 12:20 IDLE /usr2 (ufs) OK ---- server1 /dev/dsk/c1t0d0s5 2004/12/09 12:20 IDLE /usr3 (ufs) OK ---- #
The following information will be displayed.
Keyword | Description | ||
|---|---|---|---|
Server | Displays the Storage Server name. | ||
Device | For Solaris, Linux, HP-UX, or AIX, displays the device name. For Windows, displays the AdvancedCopy Manager device name. | ||
Last-Backup-Date | Displays the last backup date. * Displays the time when the backup execution command was accepted. | ||
DiskInterval | Displays how many days have passed after the specified number of interval days since the last backup date has been exceeded. This item will be displayed as "DELAY=number-of-days-passing". "OK" will be displayed if the number of interval days has not been exceeded. | ||
Status | Displays whether command execution is in progress on the transaction volume. If execution is in progress, "EXEC" is displayed; otherwise, "IDLE" is displayed. | ||
Mount-Point (Method) | For Solaris, Linux, HP-UX, or AIX, displays the mount point name of a transaction volume followed by the file system type in parentheses. For Windows, displays the drive letter of a device. The file system type of the device is displayed in parentheses. If no existing mount point is applicable, " ---- (----)" is displayed. | ||
DiskExecute | Displays the name of the command being executed or the progress of copying. | ||
"----" | Neither a command nor OPC/EC is being executed. | ||
"swststartsync" | The backup synchronous processing start command is being processed. | ||
"swstcancelsync" | The backup synchronous processing cancel command is being processed. | ||
"swstbackup" | This backup command is being processed. | ||
"swstrestore" | This restore command is being processing. | ||
"swstcancelrest" | The restore cancel command is being processed. | ||
"swstbkpolset" | The backup policy setting command is being processed. | ||
"swstbkpoldel" | The backup policy delete command is being processed. | ||
"swsthistdel" | The history information delete command is being processed. | ||
"swstcanceltrk" | The tracking cancel command is being processed | ||
"sync(xxx%)" | The progress of backup synchronous processing | ||
"sync(failed)" | EC ended abnormally. | ||
"sync(halt)" | EC is in the halt state. | ||
"snapshot(xxx%)" | The progress of OPC backup | ||
"snapshot(failed)" | OPC backup ended abnormally. | ||
"snapshot(halt)" | OPC backup is in the halt state. | ||
"restore(xxx%)" | The progress of restoration | ||
"restore(failed)" | OPC restoration ended abnormally. | ||
"restore(halt)" | OPC restoration is in the halt state. | ||
"gds-error" | GDS copying ended abnormally. | ||
TapeInterval | If the number of days that have elapsed since the last backup is equal to or greater than the number of interval days defined in the tape backup policy, the number of days that have elapsed since the last day in the interval is displayed in the "DELAY=number-of-elapsed days" format. If the number of interval days has not elapsed, "OK" is displayed. (The number of interval days defined in the tape backup policy is the "number of interval days (generation management) for generation management" or "number of interval days (day management) for day management.") | ||
TapeExecute | Displays the progress of writing to or reading from tape. | ||
"----" | Neither writing to tape nor reading from tape is being performed. | ||
"Writing(xxx%)" | Shows the progress of writing to tape (0% to 100%) | ||
"Reading(xxx%)" | Shows the progress of reading from tape (0% to 100%) | ||
"Waiting-tape(xxx%)" | Waiting for tape. The progress of writing to or reading from tape is displayed (0% to 100%) | ||
When multiple types of processing are executed for a transaction volume (such as when the backup synchronous processing start command is entered during copying of a snapshot high-speed backup), the DiskExecute and TapeExecute column displays conform to the following rules:
The display of a command name takes priority if both copying and command are in progress.
When a disk copy of snap-shot backup and a disk copy of 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 for snap-shot backup or backup synchronous processing due to a restriction of the Fujitsu ETERNUS storage system.)
If multiple tape restore operations are executed for the same transaction volume, the progress of the processing executed last is displayed. (Multiple restore operations that specify the same transaction volume can be performed concurrently if the restoration destinations are different.)
The table below lists the displayed items for day management backup.
Keyword | Description | |
|---|---|---|
Server | Displays a Storage Server name. | |
Device | For Solaris, Linux, HP-UX, or AIX, displays a device name. For Windows, displays the AdvancedCopy Manager device name. | |
Last-Backup-Date | Displays the last backup date. * Displays the time when the backup execution command was accepted. | |
Status | Displays whether execution for a transaction volume is in progress. If execution is in progress, "EXEC" is displayed; otherwise, "IDLE" is displayed. | |
Mount-Point (Method) | For Solaris, Linux, HP-UX, or AIX, displays the mount point name of a transaction volume followed by an FSType in parentheses. If no existing mount point is applicable, " ---- (----)" is displayed. | |
TapeInterval | If the number of days that have elapsed since the date of the last backup is equal to or greater than the number of interval days defined in the tape backup policy, the number of days that have elapsed since the last day in the interval is displayed in the "DELAY=number-of-elapsed days" format. If the number of interval days has not elapsed, "OK" is displayed. (The number of interval days defined in the tape backup policy is the "number of interval days (generation management) for generation management" or "number of interval days (day management) for day management.") | |
TapeExecute | Displays the progress of writing to or reading from tape. | |
"----" | Neither writing to tape nor reading from tape is being performed. | |
"Writing(xxx%)" | Shows the progress of writing to tape (0% to 100%) | |
"Reading(xxx%)" | Shows the progress of reading from tape (0% to 100%) | |
"Waiting-tape(xxx%)" | Waiting for tape. The progress of writing to or reading from tape is displayed (0% to 100%) | |
During synchronous high-speed backup with -suspend specified, no operation ("----") is indicated in the DiskExecute field.
NOTES
If "sync (failed)", "snapshot(failed)", "restore(failed)", "sync (halt)", "snapshot(halt)" or "restore(halt)" is displayed in the "DiskExecute" field, a hardware error may have occurred. After removing the cause of the hardware error, do as follows:
For "sync (failed)"
To cancel backup synchronous processing, execute "11.2.2.12 acmcancelsync (Synchronous backup cancel command)".
If "snapshot (failed)" is displayed
To delete backup history information, execute "11.2.2.10 acmhistdel (History information delete command)".
If "restore (failed)" is displayed
Cancel restoration using "11.2.2.5 swstcancelrest (Restore cancellation command)".
The executed command is displayed in the "DiskExecute" field with the prefix "swst" even though the prefix of the command is actually "acm".
If "gds-error" is the status displayed in the Status field, a problem with GDS is assumed to have occurred. Correct the cause of the GDS problem, and take action as follows:
If backup synchronous processing is being executed, cancel it by executing "11.2.2.12 acmcancelsync (Synchronous backup cancel command)".
If snapshot backup is being executed, delete the backup history information by executing "11.2.2.10 acmhistdel (History information delete command)".
If restoration is in progress, execute "11.2.3.1 swstsrsemtch (Resource match command)", and perform restoration again.
NAME
acmcanceltrk - Cancellation of tracking
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmcanceltrk [-copy | -emergency] Device-Name {-bd Backup-Device-Name | -all}
[For Windows]
program-directory\bin\acmcanceltrk [-copy | -emergency] Device-Name {-bd Backup-Device-Name | -all}
DESCRIPTION
This command stops tracking processing for QuickOPC.
OPTIONS
Specifies that physical copying, if active, should also be stopped (that is, the OPC session should be canceled).
This option cannot be specified for a backup volume that has already been a backup history. For a volume whose copy destination volume has been a backup history, delete the history information in advance using 11.2.2.10 acmhistdel (History information delete command).
Specifies that the command should operate in emergency operation mode.
The command does not check tracking processing and does not stop tracking processing and 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 together with the -all option.
Stops the entire tracking processing specified for the transaction volumes. This option cannot be specified together with the -bd option.
OPERANDS
For Solaris, Linux, HP-UX, or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
The following example stops the tracking processing.
# /opt/FJSVswstc/bin/acmcanceltrk /dev/dsk/c1t0d1s1 -bd /dev/dsk/c1t0d2s1 /dev/dsk/c1t0d1s1 acmcanceltrk completed #
The following example stops tracking processing and physical copying.
/opt/FJSVacms/bin/acmdevdisp -t -b -u Server Device Size Device-Mode Mount-Point (Method) Backup-Engine SV1 /dev/dsk/c1t0d1s1 1.0 Gbyte Transaction /mnt/tran1 (ufs) AdvancedCopy SV1 /dev/dsk/c1t0d2s1 1.0 Gbyte Backup(used-T) ---- (----) AdvancedCopy : # /opt/FJSVswstc/bin/acmtrkstat /dev/dsk/c1t0d1s1 Server Transaction-Disk Backup-Disk Status Execute Update SV1 /dev/dsk/c1t0d1s1 /dev/dsk/c1t0d2s1 executing 33% ----- # /opt/FJSVswstc/bin/acmcanceltrk -copy /dev/dsk/c1t0d1s1 -bd /dev/dsk/c1t0d2s1 /dev/dsk/c1t0d1s1 acmcanceltrk completed #
NOTES
Tracking processing cannot be stopped under the following condition:
Tracking processing is not performed for the specified copy source and destination volumes.
This command cannot be executed if any of the following commands are running:
swstsrsemtch (Resource match command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
NAME
acmtrkstat - Display of tracking statuses
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmtrkstat [Device-Name][For Windows]
program-directory\bin\acmtrkstat [Device-Name]DESCRIPTION
This command displays the status of tracking processing.
When multiple types of tracking processing exist for one transaction volume, the command displays the statuses of all types of tracking processing.
OPERANDS
For Solaris, Linux, HP-UX, or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
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.
# /opt/FJSVswstc/bin/acmtrkstat Server Transaction-Disk Backup-Disk Status Execute Update SV1 /dev/dsk/c1t0d1s1 /dev/dsk/c1t0d2s1 tracking ---- 12% SV1 /dev/dsk/c1t0d2s1 /dev/dsk/c1t0d4s1 executing 75% ---- SV1 /dev/dsk/c1t0d5s1 ---- ---- ---- ---- SV1 /dev/dsk/c1t0d6s1 /dev/dsk/c1t0d7s1 executing 31% ---- #
The displayed data is explained below.
Title | Description |
|---|---|
Server | Displays the Storage Server name. |
Transaction-Disk | Displays the transaction volume name. |
Backup-Disk | Displays the backup volume name. Displays "----" when the volume is not in the tracking status. |
Status | Displays the execution status. "----": Not in the process of tracking "executing": In the process of physical copying and tracking "tracking": In the process of tracking "failed": Physical copying or tracking terminated abnormally "nosession": No session exists (eg, resource information is inconsistent) |
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 | When "tracking" is displayed in the Status column, displays the amount of updated data after QuickOPC (logical copying) as a percentage,. "----" is displayed when "executing" is displayed in the Status column. |
NOTES
Execution status information cannot be displayed for transaction volumes that are linked to GDS snapshot.
When the execution status (displayed in the "Status" column) is "failed," a hardware problem is assumed to have occurred. Fix the cause of the problem and then re-execute the differential snapshot backup.
When the execution status (displayed in the "Status" column) is "nosession," the resource information is probably inconsistent. Use 11.2.3.1 swstsrsemtch (Resource match command) to remove any inconsistencies from the resource information.
The execution status of tracking processing cannot be displayed under the following conditions:
[For Solaris]
When the transaction volume or backup volume is a VxVM logical volume, and the volume configuration of the logical volume has been changed to one that is not supported by AdvancedCopy Manager.
When the transaction volume or backup volume is a VxVM logical volume, and the logical volume has been deleted from VxVM.
[For HP-UX]
When the logical disk configuration is changed to a configuration that is not supported by AdvancedCopy Manager.
When a volume group is specified and the volume group is inactive.
For Windows, allocate a drive letter temporarily to a device.
For details on the command, refer to "swstdrvset (Drive letter allocation command)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
For Windows, the drive character currently assigned to the device is canceled.
For details on the command, refer to "swstdrvunset (Drive letter de-allocation command)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
For Windows, this command dismounts the specified volume.
For details on the command, refer to "swstdismount (Dismount command)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
For Windows, this command unlocks a volume.
For details on the command, refer to "swstvolunlock (Volume unlock command)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
For Windows, this command displays information about a locked volume.
For details on the command, refer to "swstvollockstat (Locked-volume information display command)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".