| ETERNUS SF AdvancedCopy Manager Operator's Guide for Tape Backup Option 13.0 -Microsoft(R) Windows(R) 2000/Microsoft(R) Windows Sever(TM) 2003-, -Solaris-, -HP-UX-, -Linux-, -AIX- |
|
Contents
Index
|
This chapter describes using commands.
For Windows, specify the program directory specified when it installs it for the path name of various commands described in this chapter.
The example of executing various commands in this chapter describes all the cases of Solaris.
This section describes operations using backup management commands. It is necessary to execute the command of backup management by the root user.
For Solaris, Linux, HP-UX, or AIX, the backup management commands must be executed by the root user. If a backup management command is executed by another user, the command outputs a message and terminates with an error.
For Windows, only the user belonging to the Administrators group can execute all the commands of backup management. When command execution is carried out by other users, a message is outputted and then, an error end.
When one of the following commands is executed on a server that is used for both the Storage Management Server and the Storage Server, information about only the server being used is displayed. The other display commands display information about all types of Storage Servers.
- History information display command
- Execution status display command
In cluster operation
In cluster operation, execute a command by taking the following steps:
- If necessary, specify the logical node name to the transaction in environment variable SWSTGNODE. For bsh, specify the environment variable as follows:
- Execute the command.
The table below lists the commands available in cluster operation, whether environment variables must be configured, and the nodes on which commands are executable. For notes and cautions on command execution, see the Remarks column.
Command
Environment variable
Command execution node
Remarks
acmsvrset
Required
Transaction operating node
-
acmsvrdisp
Required
Transaction operating node
-
acmdevinfoset
Required
Transaction operating node
-
acmdevdisp
Required
Transaction operating node
-
acmbkpolset
Required
Transaction operating node
-
acmbkpoldisp
Required
Transaction operating node
-
acmbkpoldel
Required
Transaction operating node
-
acmtpbkpolset
Required
Transaction operating node
-
acmtpbkpoldisp
Required
Transaction operating node
-
acmtpbkpoldel
Required
Transaction operating node
-
Acmtpmgmtclassset
Required
Transaction operating node
-
Acmtpmgmtclassdisp
Required
Transaction operating node
-
Acmtpmgmtclassdel
Required
Transaction operating node
-
acmbackup
Required
Transaction operating node
-
acmtphistcopy
Required
Transaction operating node
-
swstbackstat
Required
Transaction operating node
-
acmrestore
Required
Transaction operating node
-
swstcancelrest
Required
Transaction operating node
-
swstreststat
Required
Transaction operating node
-
acmhistdisp
Required
Transaction operating node
-
acmhistdel
Required
Transaction operating node
-
acmstartsync
Required
Transaction operating node
-
acmcancelsync
Required
Transaction operating node
-
acmsyncstat
Required
Transaction operating node
-
acmexecstat
Required
Transaction operating node
-
acmcanceltrk
Required
Transaction operating node
-
acmtrkstat
Required
Transaction operating node
-
swstsrsemtch
Required
Transaction operating node
-
swstresback
Required
Transaction operating node
-
swstresrst
Required
Transaction operating node
-
swstdrvset
Required
Transaction operating node
Windows only
swstdrvunset
Required
Transaction operating node
Windows only
swstdismount
Required
Transaction operating node
Windows only
swstvolunlock
Required
Transaction operating node
Windows only
swstvollockstat
Required
Transaction operating node
Windows only
This sub-section describes environment definition commands for backup management.
All environment definition commands require that a Tape Server and its daemon be started in advance. Otherwise, when one of the commands is executed, it outputs a message and terminates with an error.
To define a backup management environment, use the following commands:
|
Function |
Command name |
Description |
|---|---|---|
|
Storage Server configuration information setting command |
acmsvrset |
Sets the configuration information of a Storage Server. |
|
Storage Server configuration information display command |
acmsvrdisp |
Displays the configuration information of a Storage Server. |
|
Device information setting command |
acmdevinfoset |
Sets the use of a device. |
|
Device usage status display command |
acmdevdisp |
Displays the information of a device. |
|
Disk backup policy setting command |
acmbkpolset |
Sets a disk backup policy. |
|
Disk backup policy display command |
acmbkpoldisp |
Displays a set disk backup policy. |
|
Disk backup policy delete command |
acmbkpoldel |
Deletes a set disk backup policy. |
|
Tape backup policy setting command |
acmtpbkpolset |
Sets a tape backup policy. |
|
Tape backup policy display command |
acmtpbkpoldisp |
Displays a set tape backup policy. |
|
Tape backup policy delete command |
acmtpbkpoldel |
Deletes a set tape backup policy. |
|
Tape backup management class setting command |
acmtpmgmtclassset |
Sets a tape backup management class. |
|
Tape backup management class display command |
acmtpmgmtclasspoldisp |
Displays a set tape backup management class. |
|
Tape backup management class delete command |
acmtpmgmtclasspoldel |
Deletes a set tape backup management class. |
This command sets configuration information of a Storage Server. Execute this command to declare that this Storage Server is subject to the backup operation.
This command associates the specified Tape Server with a Storage Server. The Tape Server specified by this command manages backup to tape. The tape backup function cannot be used on a Storage Server not associated with the Tape Server.
If the server name, IP address, or port number of the Tape Server is changed, this command must be executed again to associate the Tape Server with the Storage Server.
[For Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmsvrset [-c RecCtrlFile-Directory] [-w Work-Directory] [-t Tape-Server] |
[For HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmsvrset [-t Tape-Server] |
[For Windows]
|
program-directory\bin\acmsvrset [-t Tape-Server] |
|
Option |
Description |
|---|---|
|
-t |
Specifies the name of the Tape Server to be associated with the Storage Server. |
= 0: Normal end
> 0: Abnormal end
The command sets configuration information about the Storage Server and associates the server with the Tape Server (tpserver1).
# /opt/FJSVswstc/bin/acmsvrset -t tpserver1 acmsvrset completed # |
The Storage Server configuration information cannot be set in the following cases:
- The -t option is omitted at the time of initial execution.
- The -t option is specified, Storage Server configuration information is already set, and a tape backup policy is set for an existing transaction volume.
- The specified Tape Server is not registered with the Storage Management Server.
This command can be executed only while none of the following commands are running.
- Storage Server configuration information setting command (acmsvrset)
- Backup policy setting command (acmbkpolset)
- Backup policy delete command (acmbkpoldel)
- Backup command (acmbackup)
- Restore command (acmrestore)
- Backup synchronous processing start command (acmstartsync)
- Backup synchronous processing cancel command (acmcancelsync)
- Device information setting command (acmdevinfoset)
- History information delete command (acmhistdel)
- Storage Server configuration information setting command (swstsvrset)
- Backup policy setting command (swstbkpolset)
- Backup policy deletion command (swstbkpoldel)
- Backup execution command (swstbackup)
- Restore execution command (swstrestore)
- Restore cancellation command (swstcancelrest)
- Backup synchronous processing start command (swststartsync)
- Backup synchronous processing cancel command (swstcancelsync)
- Device information setting command (swstdevinfoset)
- History information deletion command (swsthistdel)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
- Resource match command (swstsrsemtch)
- Tracking cancel command (acmcanceltrk)
This command displays configuration information of a Storage Server, which has been set using the "Storage Server configuration information setting command (acmsvrset)".
[For Solaris/Linux/HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmsvrdisp |
[For Windows]
|
program-directory\bin\acmsvrdisp |
= 0: Normal end
> 0: Abnormal end
This command displays Storage Server (srv1) configuration information.
# /opt/FJSVswstc/bin/acmsvrdisp Storage-Server = srv1 Tape-Server = tpserver1(10.10.10.10:1226) # |
The following information will be displayed.
|
Title |
Description |
|---|---|
|
Storage-Server |
Displays a Storage Server name. |
|
Tape-Server |
Displays a Tape Server name. The IP address and port number used for communication with the Tape Server are delimited by a colon ":" and displayed in parentheses. |
Set a volume that has been allocated to the disk array unit ETERNUS storage system as a transaction volume or backup volume.
A transaction volume refers to a volume that stores work data to be backed up.
A backup volume refers to a volume used to store a backup of this transaction data.
For details on devices can be registered on Windows as transaction and backup volumes, see "Device information setting command (swstdevinfoset)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
[For Solaris/Linux/HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmdevinfoset -t | -b | -o Device-Name |
[For Windows]
|
program-directory\bin\acmdevinfoset -t | -b | -o Device-Name |
|
Option |
Description |
|---|---|
|
-t |
Registers the specified device as a transaction volume. |
|
-b |
Registers the specified device as a backup volume. |
|
-o |
Deregisters the specified device if it has been registered as a work or backup volume. |
|
Operand |
Description |
|---|---|
|
Device-Name |
For Solaris, Linux, HP-UX, or AIX, specifies a block device name. For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, see "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]". |
= 0: Normal end
> 0: Abnormal end
Register a device (/dev/dsk/c1t0d0s6) as a transaction volume.
# /opt/FJSVswstc/bin/acmdevinfoset -t /dev/dsk/c1t0d0s6 acmdevinfoset completed # |
Register a device (/dev/dsk/c1t0d2s6) as a backup volume.
# /opt/FJSVswstc/bin/acmdevinfoset -b /dev/dsk/c1t0d2s6 acmdevinfoset completed # |
Deregister a device (/dev/dsk/c1t0d0s6) that has been registered as a transaction volume.
# /opt/FJSVswstc/bin/acmdevinfoset -o /dev/dsk/c1t0d0s6 acmdevinfoset completed # |
No device can be registered as a transaction volume if:
- Another device with the same logical volume information (cabinet identifier, OLU number, EXTENT start position, and EXTENT size) has already been registered as a transaction volume.
- The space of the device to be registered overlaps the space of an already registered work or backup volume.
No device can be registered as a backup volume if:
- Another device with the same logical volume information (cabinet identifier, OLU number, EXTENT start position, and EXTENT size) has already been registered as a transaction volume.
- The space of the device to be registered overlaps the space of an already registered transaction or backup volume.
- The device to be set up is already mounted.
- The device is an SDX object.
- When the device which it is going to set up is registered as a replication destination volume of replication management.
- When the device which it is going to set up is registered as replication source volume of the duplicate volume information in which the bi-directional copy of replication management is possible.
You must delete related backup history information before:
- Changing a backup volume to a transaction volume
- Canceling the setting of a backup volume
You must delete a backup policy specified on a transaction volume before:
- Changing a transaction volume to a backup volume
- Canceling the setting of a transaction volume
To perform the following changes, the related tracking processing (OPC session) must be canceled in advance.
- Changing the settings of a transaction volume in tracking processing
- Changing the settings of a backup volume in tracking processing
The following changes are not possible unless the related synchronous processing (EC session) is cancelled:
- Changing a setting of a suspended transaction volume
- Changing a setting of a suspended backup volume
For details on how to use SDX objects of GDS, see "Configuration and conditions of unsupported SDX objects" and "Notes on SDX Object Operations".
This command can be executed only while none of the following commands are running.
- Storage Server configuration information setting command (acmsvrset)
- Backup policy setting command (acmbkpolset)
- Backup policy delete command (acmbkpoldel)
- Backup command (acmbackup)
- Restore command (acmrestore)
- Backup synchronous processing start command (acmstartsync)
- Backup synchronous processing cancel command (acmcancelsync)
- Device information setting command (acmdevinfoset)
- History information delete command (acmhistdel)
- Storage Server configuration information setting command(swstsvrset)
- Backup policy setting command (swstbkpolset)
- Backup policy deletion command (swstbkpoldel)
- Backup execution command (swstbackup)
- Restore execution command (swstrestore)
- Restore cancellation command (swstcancelrest)
- Backup synchronous processing start command (swststartsync)
- Backup synchronous processing cancel command (swstcancelsync)
- Device information setting command (swstdevinfoset)
- History information deletion command (swsthistdel)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
- Resource match command (swstsrsemtch)
- Tracking cancel command (acmcanceltrk)
This command displays information on the transaction volumes, backup volumes, and other applicable devices that have been set by the "Device information setting command (acmdevinfoset)".
[For Solaris/Linux/HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmdevdisp [-t] [-b [-u]] [-o] [Device-Name] |
[For Windows]
|
program-directory\bin\acmdevdisp [-t] [-b [-u]] [-o] [Device-Name] |
|
Option |
Description |
|---|---|
|
-t |
Displays information on a device that has been set as a transaction volume. |
|
-b |
Displays a device that has been set as a backup volume. |
|
-u |
Changes the display format for the Device-Mode column (normally "Backup (used)") for backup volumes in the suspend or tracking status for which history information was deleted. |
|
-o |
Displays all the devices other than those set as a transaction or backup volume. |
Information on a device that has been set as a transaction volume will be displayed if all of the t, b, and o options are omitted.
|
Operand |
Description |
|---|---|
|
Device-Name |
For Solaris, Linux, HP-UX, or AIX, specifies a block device name. Displays device information on all the transaction volumes, if this operand and options are omitted. |
= 0: Normal end
> 0: Abnormal end
Display the used status of the registered devices.
# /opt/FJSVswstc/bin/acmdevdisp -tb Server Device Size Device-Mode Mount-Point (Method) Backup-Engine srv2 /dev/dsk/c1t0d0s6 1.0 Gbyte Transaction /mnt/tran1 (ufs) AdvancedCopy srv2 /dev/dsk/c1t1d0s6 1.0 Gbyte Transaction ---- (----) AdvancedCopy srv2 /dev/dsk/c1t0d2s6 1.0 Gbyte Backup (used) ---- (----) AdvancedCopy srv2 /dev/dsk/c1t0d2s3 1.0 Gbyte Backup (free) ---- (----) AdvancedCopy srv2 /dev/dsk/c1t0d7s6 2.0 Gbyte Backup (free) ---- (----) AdvancedCopy srv2 /dev/dsk/c1t0d7s3 2.0 Gbyte Backup (free) ---- (----) AdvancedCopy : # |
The following information will be displayed.
|
Title |
Description |
|---|---|
|
Server |
Displays a Storage Server name. |
|
Device |
For Solaris, Linux, HP-UX, or AIX, displays a device name. For Windows, displays a AdvancedCopy Manager device name. |
|
Size |
Displays the size of a partition allocated to a device. |
|
Device-Mode |
Displays a character string by which a device can be identified.
A backup volume is indicated as "Backup (used)" if it is being used or "Backup (free)" if it is not used. If a backup process is executed with -suspend specified, or if a differential snapshot backup is executed, the backup volume remains in use after history information is deleted. With the -u option specified, "Backup (used-S)" is displayed for a backup volume in the suspend status for which history information has been deleted. "Backup (used-T)" is displayed for a backup volume in the tracking status for which history information has been deleted. |
|
Mount-Point (Method) |
For Solaris, Linux, HP-UX, or AIX, displays the mount point of a device. The file system type of the mount point is displayed inside the parentheses. For Widnows, displays the drive letter of a device. The file system type of the device is displayed inside the parentheses. |
|
Backup-Engine |
Always displays the following: |
This command sets a backup policy (numbers of preservation generations and interval days). The number of preservation generations means how many generations of backup data should be kept. The number of interval days means the number of days after execution of backup in which the next backup should be performed.
Unless a disk is used as backup media, this command is not required.
Even if the number of interval days is specified, AdvancedCopy Manager does not automatically collect backup.
When you specify a backup policy, there must be as many backup volumes required operating according to the specified backup policy.
For the number of backup volumes required for an ordinary backup operation for transaction volumes, see "Preparing a backup volume" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Server.
[For Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmbkpolset [-i Interval-Days] [-s Save-Number][Device-Name] |
[For HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmbkpolset [-i Interval-Days] [-s Save-Number][Device-Name] |
[For Windows]
|
program-directory\bin\acmbkpolset [-i Interval-Days] [-s Save-Number][Device-Name] |
|
Option |
Description |
|---|---|
|
-I |
Specifies the number of interval days. You can specify a value between 1 and 366. If this option is omitted during initial registration, 30 will be set. If this option is omitted during update, the existing value will be inherited. |
|
-s |
Specifies the number of preservation generations. You can specify a value between 1 and 31. If this option is omitted during initial registration, 2 will be set. If this option is omitted during update, the existing value will be inherited. |
|
Operand |
Description |
|---|---|
|
Device-Name |
For Solaris, Linux, HP-UX, or AIX, specifies a device name. For information about the devices that can be specified, see "Supported Devices of Tape Backup of AdvancedCopy Manager". If the device name is omitted, the backup policy will be set for all the transaction volumes. |
= 0: Normal end
> 0: Abnormal end
To set 3 as the save number of a transaction volume (/dev/dsk/c1t0d5s3) as a backup policy:
| # /opt/FJSVswstc/bin/acmbkpolset -s 3 /dev/dsk/c1t0d5s3 /dev/dsk/c1t0d5s3 acmbkpolset completed # |
If this command without a transaction volume name is executed, the same backup policy is set for all transaction volumes.
Change of the number of preservation generations can be performed, if there "there is little history information in the time" than "the number of preservation generations to set up".
Ordinary transaction volumes must be backed up to ordinary backup volumes.
If the transaction volume is a GDS logical volume, the backup destination must be a backup volume of a GDS logical volume.
The backup policy cannot be set if:
- There are not as many backup volumes as the specified number of preservation generations.
- The number of preservation generations specified in an option exceeds the limit.
- The number of interval days specified in an option exceeds the limit.
This command can be executed only while none of the following commands is executed.
- Resource match command (swstsrsemtch)
- Device information setting command (acmdevinfoset)
- Storage Server configuration information setting command (acmsvrset)
- Device information setting command (swstdevinfoset)
- Storage Server configuration information setting command (swstsvrset)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
For details on how to use SDX objects of GDS, see "Configuration and conditions of unsupported SDX objects" and "Notes on SDX Object Operations".
This command displays a backup policy that has been set for a transaction volume.
[For Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmbkpoldisp [Device-Name] |
[For HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmbkpoldisp [Device-Name] |
[For Windows]
|
program-directory\bin\acmbkpoldisp [Device-Name] |
|
Operand |
Description |
|---|---|
|
Device-Name |
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, see "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]". If the device name is omitted, a backup policy for a transaction volume with a registered backup policy will be displayed. |
= 0: Normal end
> 0: Abnormal end
To display the backup policies of a transaction volume (/dev/dsk/c1t0d5s3):
# /opt/FJSVswstc/bin/acmbkpoldisp /dev/dsk/c1t0d5s3 Server Device Interval-Days Save-Number Mount-Point (Method) Transaction2 /dev/dsk/c1t0d5s3 30 2 /stg(ufs) # |
The following information will be displayed.
|
Title |
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. |
|
Interval-Days |
Displays a number of interval days. |
|
Save-Number |
Displays a number of preservation generations. |
|
Mount-Point (Method) |
For Solaris, Linux, HP-UX, or AIX, displays the mount point of a device. The file system type of the mount point will be displayed inside the parentheses. For Windows, displays the drive letter of a device. The file system type of the device is displayed inside the parentheses. |
This command deletes a backup policy that has been set.
If the transaction volume to be deleted has backup history information, delete the backup history information before executing this command.
[For Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmbkpoldel Device-Name |
[For HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmbkpoldel Device-Name |
[For Windows]
|
program-directory\bin\acmbkpoldel Device-Name |
|
Operand |
Description |
|---|---|
|
Device-Name |
For Solaris, Linux, HP-UX, or AIX, specify the block device name of transaction volume. For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, see "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]". |
= 0: Normal end
> 0: Abnormal end
To delete the backup policies of a transaction volume (/dev/dsk/c1t0d5s3):
| # /opt/FJSVswstc/bin/acmbkpoldel /dev/dsk/c1t0d5s3 /dev/dsk/c1t0d5s3 acmbkpoldel completed # |
No backup policy can be deleted if:
- The transaction volume to be deleted has backup history information.
- A transaction volume whose backup policies are to be deleted has already started backup synchronous processing.
This command can be executed only while none of the following commands are running.
- Storage Server configuration information setting command (swstsvrset)
- Device information setting command (swstdevinfoset)
- Resource match command (swstsrsemtch)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
- Device information setting command (acmdevinfoset)
- Storage Server configuration information setting command (acmsvrset)
This command sets a tape backup policy for a transaction volume and log group.
No backup operation can be performed without a set tape backup policy.
Even if the number of interval days is specified, Tape Backup of AdvancedCopy Manager does not automatically collect backup.
To set a tape backup policy, create a tape backup management class in advance for the Storage Server for which the policy is to be set. Without a tape backup management class, a tape backup policy cannot be set.
For details, see "Tape backup management class setting command (acmtpmgmtclassset)".
[For Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmtpbkpolset [-i backup-interval-days] [-d archive-interval-days] [-c Management-Class-Name] Device-Name |
[For HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmtpbkpolset [-i backup-interval-days] [-d archive-interval-days] [-c Management-Class-Name] Device-Name |
[For Windows]
|
program-directory\bin\acmtpbkpolset [-i backup-interval-days] [-d archive-interval-days] [-c Management-Class-Name] Device-Name |
|
Option |
Description |
|---|---|
|
-i |
Specifies the number of interval days for making a generation management backup. |
|
-d |
Specifies the number of interval days for making a day management backup. |
|
-c |
Specifies the name of a tape backup management class. |
|
Operand |
Description |
|---|---|
|
Device-Name |
For Solaris, Linux, HP-UX, or AIX, specifies a device name. For information about the devices that can be specified, see "Supported Devices of Tape Backup of AdvancedCopy Manager". For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, see "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]". |
= 0: Normal end
> 0: Abnormal end
Set a tape backup policy with the specified transaction volume (/dev/dsk/c1t0d5s3). ACM_CLASS2 is specified as the tape backup management class, and 10 days is specified as the number of interval days (generation management).
# /opt/FJSVswstc/bin/acmtpbkpolset -i 10 -c ACM_CLASS2 /dev/dsk/c1t0d5s3 /dev/dsk/c1t0d5s3 acmtpbkpolset completed # |
A backup policy cannot be set in the following cases:
- The number of interval days specified in an option exceeds the limit.
- The -c option is omitted in initial registration.
- The specified backup management class has not been created on the Storage Server.
This command cannot be executed while one of the following commands is being executed:
- Resource matching command (swstsrsemtch)
- Device information setting command (acmdevinfoset)
- Storage Server configuration information setting command (acmsvrset)
- Device information setting command (swstdevinfoset)
- Storage Server configuration information setting command (swstsvrset)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
This command displays the tape backup policies that are set for transaction volumes.
[For Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmtpbkpoldisp [Device-Name] |
[For HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmtpbkpoldisp [Device-Name] |
[For Windows]
|
program-directory\bin\acmtpbkpoldisp [Device-Name] |
|
Operand |
Description |
|---|---|
|
Device-Name |
For Solaris, Linux, HP-UX, or AIX, specifies the block device name. If the Device-Name operand is omitted, this command displays all the registered tape backup policies of transaction volumes. |
= 0: Normal end
> 0: Abnormal end
Display the backup policy for transaction volume (/dev/dsk/c1t0d5s3).
# /opt/FJSVswstc/bin/acmtpbkpoldisp /dev/dsk/c1t0d5s3 Server Device Backup-Interval-Days Archive-Interval-Days ManagementClassName Mount-Point (Method) srv2 /dev/dsk/c1t0d5s3 30 2 ACM-CLASS1 /stg(ufs) # |
The table below lists displayed information items.
|
Title |
Description |
|---|---|
|
Server |
Displays a Storage Server name. |
|
Device |
Displays a device name. |
|
Backup-Interval-Days |
Displays the number of interval days for generation management. |
|
Archive-Interval-Days |
Displays the number of interval days for day management. |
|
ManagementClassName |
Displays the name of a tape backup management class. |
|
Mount-Point (Method) |
For Solaris, Linux, HP-UX, or AIX, displays a device mount point name followed by the type of mount point file system in parentheses. For Windows, displays the AdvancedCopy Manager device name. |
This command deletes a set tape backup policy.
If there is backup history information for a transaction volume associated with the tape backup policy to be deleted, delete the backup history information before executing the command.
[For Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmtpbkpoldel Device-Name |
[For HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmtpbkpoldel Device-Name |
[For Windows]
|
program-directory\bin\acmtpbkpoldel Device-Name |
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies the block device name. |
= 0: Normal end
> 0: Abnormal end
Delete the backup policies of a transaction volume (/dev/dsk/c1t0d5s3):
| # /opt/FJSVswstc/bin/acmtpbkpoldel /dev/dsk/c1t0d5s3 /dev/dsk/c1t0d5s3 acmtpbkpoldel completed # |
A tape backup policy cannot be deleted in the following cases:
- Tape backup history information remains for a transaction volume associated with the policy to be deleted.
- A transaction volume associated with the policy to be deleted is being processed.
This command cannot be executed while one of the following commands is being executed:
- Resource matching command (swstsrsemtch)
- Device information setting command (acmdevinfoset)
- Storage Server configuration information setting command (acmsvrset)
- Device information setting command (swstdevinfoset)
- Storage Server configuration information setting command (swstsvrset)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
This command sets a tape backup management class.
The storage pools specified as the backup destinations must be created with TSM in advance.
[For Solaris/Linux/HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmtpmgmtclassset [-g gen_pool] [-d day_pool] [-s save-number] [-t limit-day] Management-Class-Name |
[For Windows]
|
program-directory\bin\acmtpmgmtclassset [-g gen_pool] [-d day_pool] [-s save-number] [-t limit-day] Management-Class-Name |
|
Option |
Description |
|---|---|
|
-g |
Sets the "generation management backup destination" specified in gen_pool. |
|
-d |
Sets the "day management backup destination" specified in day_pool. |
|
-s |
Sets the "number of preservation generations" specified in save-number. |
|
-t |
Sets the number of "preservation days" specified in limit-day. |
|
Operand |
Description |
|---|---|
|
Management-Class-Name |
Specifies a tape backup management class name. |
= 0: Normal end
> 0: Abnormal end
Create tape backup management class ACM_CLASS1 for preserving five generations of each backup in COPYPOOL and preserving day management backups for 30 days in ARCPOOL.
# /opt/FJSVswstc/bin/acmtpmgmtclassset -g COPYPOOL -d ARCPOOL -s 5 -t 30 ACM_CLASS1 ACM_CLASS1 acmtpmgmtclassset completed # |
Even for backup in only generation management mode or day management mode, the backup destination in the non-used management mode must also be specified. In this case, specify the same storage pool for both the "generation management backup destination" and "day management backup destination".
To automatically delete generations when a specific number of preservation generations or days is exceeded, the number of generations or days must be specified in the TSM server option file. If either one is specified, the Tape Server is checked at a regular interval to determine whether the specified value has been exceeded. If it has been exceeded, the oldest history is deleted. For details, see "Setting of a Server Option File" in the "ETERNUS SF AdvancedCopy Manager Installation Guide for Tape Backup Option".
The TSM command "expire" can delete the number of generations exceeding the limit.
For details of the command, see the "ETERNUS SF Backup TSM Edition Administrator's Reference".
tsm> expire inventory wait=<yes/no>
If "yes" is specified for "wait," the command is executed in the foreground. If "no" is specified, it is executed in the background. The default is "no."
When creating a storage pool, you can use lowercase letters in the storage pool name specified with a TSM command. Even in this case, TSM manages storage pool names with an assumption that all of the names are in uppercase letters. The storage pool name specified in acmtpmgmtclassset must be a name that is actually managed by TSM. No lowercase letters can be used.
A tape backup management class cannot be set in the following cases:
- Backup destinations for generation management and day management are not set during initial registration.
- A specified backup destination was not created as a TSM storage pool.
- The maximum allowable number of preservation generations or days is exceeded by the value specified in the respective option.
- The character string specified for the tape backup management class contains an invalid character or more than 30 characters.
This command cannot be executed while one of the following commands is being executed:
- Resource matching command (swstsrsemtch)
- Device information setting command (acmdevinfoset)
- Storage Server configuration information setting command (acmsvrset)
- Device information setting command (swstdevinfoset)
- Storage Server configuration information setting command (swstsvrset)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
This command displays a set backup management class.
[For Solaris/Linux/HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmtpmgmtclassdisp [Management-Class-Name] |
[For Windows]
|
program-directory\bin\acmtpmgmtclassdisp [Management-Class-Name] |
|
Operand |
Description |
|---|---|
|
Management-Class-Name |
Specifies the name of a tape backup management class. |
= 0: Normal end
> 0: Abnormal end
Display all set tape backup management classes.
# /opt/FJSVswstc/bin/acmtpmgmtclassdisp Server PolicyDomain PolicySet ManagementClass BackupCopyGroup ArchiveCopuGroup BackupPool Save-Number ArchivePool Limit-Day sever01 ACM_server01_POLICYDOM ACM_server01_POLICYSET ACM_CLASS1 standard standard COPYPOOL1 7 ARCHPOOL1 300 sever01 ACM_server01_POLICYDOM ACM_server01_POLICYSET ACM_CLASS2 standard standard COPYPOOL2 5 ARCHPOOL2 7 # |
The table below lists displayed information items.
|
Title |
Description |
|---|---|
|
Server |
Displays a Storage Server name. |
|
PolicyDomain |
Displays the "tape backup policy domain name". ACM_DOMAIN is always displayed. |
|
PolicySet |
Displays the "tape backup policy set" in which the tape backup management class is set. The tape backup policy set is automatically assigned in such a way that it is unique among Storage Servers, when a tape backup management class is set. |
|
ManagementClass |
Displays the "tape backup management class name". |
|
BackupCopyGroup |
Displays the "backup copy group name". |
|
ArchiveCopuGroup |
Displays the "archive copy group name". |
|
BackupPool |
Displays the name of the TSM primary storage pool of the "generation management backup destination". |
|
Save-Number |
Displays the "number of preservation generations". |
|
ArchivePool |
Displays the name of the TSM primary storage pool of the "day management backup destination". |
|
Limit-Day |
Displays the "number of preservation days". |
This command deletes a set tape backup management class.
A tape backup management class that is defined in the tape backup policy for a transaction volume cannot be deleted.
If the last tape backup management class among those registered in the tape backup policy domain is deleted, the tape backup policy domain and set tape backup policies are automatically deleted at the same time.
[For Solaris/Linux/HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmtpmgmtclassdel Management-Class-Name |
[For Windows]
|
program-directory\bin\acmtpmgmtclassdel Management-Class-Name |
|
Operand |
Description |
|---|---|
|
Management-Class-Name |
Specifies the name of a tape backup management class. |
= 0: Normal end
> 0: Abnormal end
Delete tape backup management class ACM_CLASS1.
# /opt/FJSVswstc/bin/acmtpmgmtclassdel ACM_CLASS1 ACM_CLASS1 acmtpmgmtclassdel completed # |
A tape backup management class cannot be deleted in the following case:
- The tape backup management class is defined in any tape backup policies.
This command cannot be executed while one of the following commands is being executed:
- Resource matching command (swstsrsemtch)
- Device information setting command (acmdevinfoset)
- Storage Server configuration information setting command (acmsvrset)
- Device information setting command (swstdevinfoset)
- Storage Server configuration information setting command (swstsvrset)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
This sub-section describes operation commands for backup management.
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.
To operate backup management, use the following commands:
|
Function |
Command name |
Description |
|---|---|---|
|
Backup execution command |
acmbackup |
Performs the synchronous high-speed backup or snapshot-type high-speed backup operation. |
|
Backup execution status display command |
swstbackstat |
Displays the backup progress status. |
|
Tape copy command |
acmtphistcopy |
Copies backup history information on a disk to tape. |
|
Restore execution command |
acmrestore |
Performs restoration. |
|
Restore cancellation command |
swstcancelrest |
Cancels the execution of restoration. |
|
Restore execution status display command |
swstreststat |
Displays the execution status of restoration. |
|
History information display command |
acmhistdisp |
Displays the history information that has been backed up. |
|
History information deletion command |
acmhistdel |
Deletes the history information that has been backed up. |
|
Backup synchronous processing start command |
acmstartsync |
Starts backup synchronous processing. |
| Backup synchronous processing cancel command |
acmcancelsync |
Aborts backup synchronous processing. |
|
Backup synchronous processing progress display command |
acmsyncstat |
Displays the progress of the backup synchronous processing. |
|
Execution status display command |
acmexecstat |
Displays the execution status of a command executed on a transaction volume. |
|
Tracking cancel command |
acmcanceltrk |
Stops tracking processing for a QuickOPC. |
|
Tracking status display command |
acmtrkstat |
Displays the status of tracking processing for a QuickOPC. |
|
Drive letter allocation command |
swstdrvset |
Allocates a drive letter temporarily to a device.(Windows only) |
|
Drive letter deallocation command |
swstdrvunset |
The drive character currently assigned to the device is canceled.(Windows only) |
|
Dismount command |
swstdismount |
Dismounts a volume.(Windows only) |
|
Volume unlock command |
swstvolunlock |
Unlocks a volume.(Windows only) |
|
Locked-volume information display command |
swstvollockstat |
Displays information about a volume locked(Windows only) |
Back up a transaction volume data.
This command works differently depending on the specified backup destination media or the status of advanced copy in progress:
In both cases, it is established as backup and access of backup volume is attained from immediately after this command execution.
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 preprocessing shell script (OpcBackup.pre) and tape copy preprocessing script (TapeCopy.pre). When backup is completed, it executes the backup postprocessing shell script (OpcBackup.post) and tape copy postprocessing script (TapeCopy.post).
You can customize these Shell script. For information on these shell scripts, see Appendix "Preprocessing and Postprocessing of Backup, Restoration, and Tape Copy".
[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] |
|
Option |
Description |
|
|---|---|---|
|
-Xdevmap |
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. 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 character. |
|
|
-Xflush |
Specifies flushing 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, then 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, see "Transaction volume locking specification file for backups" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]". |
|
|
-suspend |
This results in synchronous high-speed backup using the Suspend/Resume function. This option cannot be specified if the -T option has been specified. |
|
|
-T |
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 disk array supports the QuickOPC function. For the snapshot high-speed backup without specifying this option, ordinary snapshot processing (OPC without using the QuickOPC function) is started. This option must be always specified to perform a backup operation 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. |
|
|
-b |
Specifies the management mode for writing backup data to tape.
If this option is omitted, tape backup is performed in generation management mode. |
|
|
-m |
Specifies the type of backup destination media.
If this option is omitted, backup is performed to both disk and tape. |
|
|
-o |
Specifies that backup data be saved to tape without waiting for OPC copying to actually be completed. |
|
|
-w |
Specifies that the command not wait for writing to tape to be completed. |
|
*1 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 only disk, and then execute acmtphistcopy with DAY specified in the -b option to create a day management tape history.
|
Operand |
Description |
|---|---|
|
Device-Name |
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, see "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]". |
= 0: Normal end
> 0: Abnormal end
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 completed.
# /opt/FJSVswstc/bin/acmbackup -m BOTH -b GEN -w /dev/dsk/c1t0d5s3 /dev/dsk/c1t0d5s3 acmbackup completed # |
Back up 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 # |
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 authority of the backup administrator. 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 a message that will be output.
- No backup policy has been specified for the specified transaction volume.
- An error is detected during writing to tape.
- The OPC Backup executed one generation earlier was unsuccessful.
- A transaction volume on which OPC is in progress is specified.
- 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.
- Unused backup volume to be used as the copying destination could not be acquired.
- 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 in 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).
When as follows, output place backup volume cannot be specified and backup cannot be performed.
- When the backup volume specified by the device map file (or operand of the to option) cannot use it as backup volume of the operating volume used as a pair. Namely, when either of the following conditions is not satisfied.
- The specified backup volume is in an intact state.
- The partition size of operating volume and backup volume is the same.
- When an error is in the description about the object operating volume of a device map file (refer to "Describing a device map file").
- When the word character of each country is contained 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.
At this time, if existing backup history information satisfies the condition of 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 the backup volume with the Suspend or tracking state is not cleared and the backup volume remains in use.
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 the case 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, see "Setting of a Server Option File" in the "ETERNUS SF AdvancedCopy Manager Installation Guide for Tape Backup Option".
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 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.
For notes on executing backup, see "General Notes".
This command can be executed only while none of the following commands are running.
- Resource match command (swstsrsemtch)
- Device information setting command (acmdevinfoset)
- Storage Server configuration information setting command (acmsvrset)
- Storage Server configuration information setting command (swstsvrset)
- Device information setting command (swstdevinfoset)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
The processing script is not executed before and behind in the following cases.
- The mirror slice of the SDX object is TEMP.
On Solaris, differential snapshot fast backups cannot be performed during GDS linkage.
In the case of a SynfinityFILE file system whose transaction volume consists of more than one device (multipartition), backup cannot be performed by using preprocessing and postprocessing 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 that 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 # |
For notes of the backup with Windows, see " Backup execution command(swstbackup)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
This command copies backup history information on a disk to tape.
Data in the backup volume storing the backup history data of the specified disk is copied to tape. The data thus copied 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.
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.
[For Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmtphistcopy [-b Backup-Type] [-g Generation-No | -v Version-No] Device-Name |
[For 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 |
|
Option |
Description |
|---|---|
|
-b |
Specifies the management mode for the data copied to tape.
The default is generation management. |
|
-g |
Specifies a relative generation number for the data copied to tape. |
|
-v |
Specifies an absolute generation number for the data copied to tape. |
Note: If the -g and -v options are omitted, the latest disk history information is copied to tape.
|
Operand |
Description |
|---|---|
|
Device-Name |
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, see "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]". |
= 0: Normal end
> 0: Abnormal end
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 # |
Backup data cannot be copied to tape in the following cases:
This command can be executed only while none of the following commands are running.
- Resource match command (swstsrsemtch)
- Device information setting command (acmdevinfoset)
- Storage Server configuration information setting command (acmsvrset)
- Storage Server configuration information setting command (swstsvrset)
- Device information setting command (swstdevinfoset)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
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.
For restoration from tape, 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.
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 preprocessing shell script (OpcRestore.pre), copies data, and then executes the restoration postprocessing shell script (OpcRestore.post). These shell scripts can be customized. For more information on the shell scripts, see Appendix "Preprocessing and Postprocessing of Backup, Restoration, and Tape Copy".
The 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
[For Solaris/Linux]
|
# /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 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 |
|
Option |
Description |
|---|---|
|
-g |
Specifies the relative generation number of the data to be restored. |
|
-v |
Specifies the absolute generation number of the data to be restored. |
|
-t |
Specifies the day management start date and time of the data to be restored. If DISK is specified in the -m option, this option cannot be specified. |
|
-m |
Specifies the media from which restoration is to be performed. |
|
-r |
Specifies the restoration destination device for restoration to a device other than a transaction volume. |
|
-Xgds-softcopy |
Specifies that restoration be performed by software-based copying in GDS Snapshot linkage mode. If this option is omitted, restoration is performed by OPC. |
|
-f |
Specifies the absolute path of the file that contains the physical IP address of a Storage Server. |
Note: If the -g, -v, and -t options are not specified, the latest history information subject to generation management is restored.
|
Operand |
Description |
|---|---|
|
Device-Name |
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, see "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]". |
= 0: Normal end
> 0: Abnormal end
Restore data with relative generation number 2. For information on the relative generation number, see data displayed by the "History information display command (acmhistdisp)".
# /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 operation on the transaction volume, the suspended synchronous processing is deleted and the restore command is executed. For synchronous processing during suspend control, see the data displayed by the "Backup synchronous processing progress display command (acmsyncstat)". Execute the backup synchronous processing 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 # |
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 by using the backup history list screen or the "History information display command (acmhistdisp)".
- Copy the file to be restored by executing, for example, 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 by executing, for example, the cp command.
- Unmount the backup volume:
# unmount backup-volume-name or mount-point-name
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 a message that will be output.
- Both a 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 a parameter in the -r option.
- When a device registered as a backup volume has been specified in a parameter in 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 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 during actual OPC copying by backup. In this case, perform restoration 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 Points.
- 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, under the equivalency maintain 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 notes on executing restoration, see "General Notes".
This command can be executed only while none of the following commands are running.
- Storage Server configuration information setting command (swstsvrset)
- Device information setting command (acmdevinfoset)
- Storage Server configuration information setting command (acmsvrset)
- Device information setting command (swstdevinfoset)
- Resource match command (swstsrsemtch)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
In the case of a SynfinityFILE file system that consists of more than one device (multipartition), backup cannot be performed by using preprocessing and postprocessing 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 restoration is performed and mount it after that 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 restore destination 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
For details on how to use SDX objects of GDS, see "Configuration and conditions of unsupported SDX objects" and "Notes on SDX Object Operations".
For notes of the restore with Windows, see " Restore execution command(swstrestore)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
This command cancels OPC-based restoration.
For details of this command, see "Restore cancellation command (swstcancelrest)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
Restoration from tape cannot be canceled.
This command displays the progress of restoration from the disk.
For details of this command, see "Restore execution status display command (swstreststat)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
The progress of restoration from tape is not displayed.
This command displays history information that has been backed up.
Generation management information is displayed after "Generation Management Backup" is output. Day management information is displayed after "Day Management Backup" is output.
[for Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmhistdisp [-l] [Device-Name] |
[for HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmhistdisp [-l] [Device-Name] |
[for Windows]
|
program-directory\bin\acmhistdisp [-l] [Device-Name] |
|
Option |
Description |
|---|---|
|
-l |
Displays detailed history information about a backup to tape. |
|
Operand |
Description |
|---|---|
|
Device-Name |
For Solaris, Linux, HP-UX, or AIX, specifies the block device name. If this operand is omitted, the backup history information of all the transaction volumes will be displayed. |
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 transaction volume (/dev/dsk/c1t1d10s1) by 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 excuting 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 backup data. |
|
Version |
Displays the absolute generation number. |
|
Backup-Date |
Displays the date and time of completion of backup in the "YYYY/MM/DD hh:mm" format. |
|
Backup-Device |
Displays the backup volume name. |
|
Status |
The actual progress of copying is indicated by one of the following character strings: |
|
Execute |
The percentage of copying that has already been completed is displayed while "executing" is displayed in the Status field. If a string other than "executing" is displayed in the Status field, "----" is displayed. |
|
Tape-Gen |
Displays the relative generation number of backup data on tape. |
|
CopyID |
Displays the tape copy ID (fixed to 1). |
|
Pool-Name |
Displays the name of the storage pool to which tape backup was performed. |
|
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 (,). |
The table below list displayed information items for a 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 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. |
|
TapeCopy-Date |
Displays the day management start date and time of day management backup to tape in the "YYYY/MM/DD hh:mm:ss" format. |
|
Backup-Date |
Displays the date and time of completion of backup in the "YYYY/MM/DD hh:mm" format. |
|
Expiration-Date |
Displays the expiry date and time of day management backup to tape in the "YYYY/MM/DD hh:mm:ss" format. |
|
Pool-Name |
Displays the name of the storage pool to which tape backup was performed. |
|
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 (,). |
If "failed" or "halt" is displayed in the "Status" field, a hardware error may have occurred. Refer to "Troubleshooting for a Hardware Error, etc. occurring during backup".
If "gds-error" is the status displayed in the Status field, a problem with GDS is assumed. Correct the cause of the GDS problem, and take action as follows:
- If backup synchronous processing is being executed, cancel it by executing the "Backup synchronous processing cancel command (acmcancelsync)".
- If snapshot backup is being executed, delete the backup history information by executing the "History information delete command (acmhistdel)".
- If restoration is in progress, execute the "Resource match command (swstsrsemtch)", and perform restoration again.
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.
If "failed" is displayed in the "Status" field by the "History information display command (acmhistdisp)", a hardware failure is assumed. Refer to "Troubleshooting for a Hardware Error, etc. occurring during backup".
[for Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmhistdel {-g Generation | -v Version | -z} -m DISK [-emergency] Device-Name |
[for HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmhistdel {-g Generation | -v Version | -z} -m DISK [-emergency] Device-Name |
[for Windows]
|
program-directory\bin\acmhistdel {-g Generation | -v Version | -z} -m DISK [-emergency] Device-Name |
|
Option |
Description |
|
|---|---|---|
|
-g |
Specifies the relative generation number of history information for the generation management backup to be deleted. |
|
|
-v |
Specifies the absolute generation number of the history information for the generation management backup to be deleted. |
|
|
-t |
Specifies the backup date and time of the day management backup history to be deleted. |
|
|
-z |
Specifies that all backup history information be deleted. |
|
|
-m |
Specifies the media from which backup data is to be deleted.
If multiple backup data items have been saved to tape, all of them are deleted. |
|
|
-emergency |
Specifies that the command be executed in emergency mode. |
|
|
Operand |
Description |
|---|---|
|
Device-Name |
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, see "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]". |
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 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 # |
You cannot delete backup history information if:
- 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.
- If the -t option is specified for deleting the history of a generation management backup.
- If the -v, -g, or -m option is specified for deleting the history of a day management backup.
- If none of the -z, -g, -v, -t, and -d options is specified.
- If 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.
However, OPC sessions are neither confirmed nor cancelled by execution in emergency operation mode. If an OPC session is in the error suspended state or halt state, then unmanaged sessions remain. In this event, GRmgr or ETERNUSmgr 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.
Deleting the suspended history information does not cancel the synchronous processing (EC session).
Deleteing 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 the history information is deleted.
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.
This command can be executed only while none of the following commands are running.
- Resource match command (swstsrsemtch)
- Device information setting command (acmdevinfoset)
- Storage Server configuration information setting command (acmsvrset)
- Storage Server configuration information setting command (swstsvrset)
- Device information setting command (swstdevinfoset)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
For details on how to use SDX objects of GDS, see "Configuration and conditions of unsupported SDX objects" and "Notes on SDX Object Operations".
This command starts backup synchronous processing (starts disk-to-disk copy using EC).
For a GDS transaction volume, synchronous processing by software-copy is also possible.
[for Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmstartsync [-Xgds-softcopy | -Xgds-selectcopy] Device-Name [-Xdevmap Device-Map-File] |
[for 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] |
|
Option |
Description |
|---|---|
|
-Xdevmap |
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 character. |
|
-Xgds-softcopy |
Specifies the start of backup synchronous processing of an SDX object and use of the software-copy function instead of the advanced copy function. |
|
-Xgds-selectcopy |
Specifies that GDS select the copy processing method of an SDX object. |
|
Operand |
Description |
|---|---|
|
Device-Name |
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, see "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]". |
= 0: Normally end
> 0: Abnormally end
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. The copy processing method makes GDS select it.
# /opt/FJSVswstc/bin/acmstartsync -Xgds-selectcopy /dev/sfdsk/CLS01/dsk/VOL01 /dev/sfdsk/CLS01/dsk/VOL01 acmstartsync completed # |
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.
- 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.
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 (differential copy starts). Otherwise, the synchronous processing (full copy) starts.
Even if already in use, the transaction volume where the synchronous processing started and 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.
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 means that either of the following conditions is not satisfied:
- 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 "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.
When any of the following commands is running, this command cannot be executed:
- Resource match command (swstsrsemtch)
- Device information setting command (acmdevinfoset)
- Storage Server configuration information setting command (acmsvrset)
- Storage Server configuration information setting command (swstsvrset)
- Device information setting command (swstdevinfoset)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
For details on how to use SDX objects of GDS, see "Configuration and conditions of unsupported SDX objects" and "Notes on SDX Object Operations".
The backup synchronous processing during copying by EC or under the equivalency maintain status may be canceled.
The synchronous processing can be canceled with the backup volume during copying by EC, under the equivalency maintain 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 status.
If the system detects an error while backup synchronous processing is being executed, the copying being performed at that time terminates abnormally. In such a case, use this command to cancel the backup synchronous processing. The "Backup synchronous processing progress display command (acmsyncstat)" can be used to check for error occurrence.
[for Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmcancelsync [-emergency] [-bd Backup-Device-Name | -all] Device-Name |
[for 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 |
|
Option |
Description |
|---|---|
|
-emergency |
Emergency operation mode is available for operations. |
|
-bd |
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. |
|
-all |
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. |
|
Operand |
Description |
|---|---|
|
Device-Name |
For Solaris, Linux, HP-UX, or AIX, specifies the block device name.
The partition name is specified for the SDX object. |
|
Backup-Device-Name |
Specify the copy destination backup volume name. |
= 0: Normally end
> 0: Abnormally end
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 ---- ---- ---- # |
However, EC sessions are neither confirmed nor cancelled by execution in emergency operation mode. If an EC session is in the error suspended state or halt state, then unmanaged sessions remain. In this event, GRmgr or ETERNUSmgr must be used to cancel these sessions.
This command can be executed only while none of the following commands are running.
- Resource match command (swstsrsemtch)
- Device information setting command (acmdevinfoset)
- Storage Server configuration information setting command (acmsvrset)
- Storage Server configuration information setting command (swstsvrset)
- Device information setting command (swstdevinfoset)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
For details on how to use SDX objects of GDS, see "Configuration and conditions of unsupported SDX objects" and "Notes on SDX Object Operations".
The execution status of the backup synchronous processing is displayed (during copying, under the equivalency maintain status, in the suspended status).
If one transaction volume has multiple EC sessions, then the statuses of all of these EC sessions are displayed.
[for Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmsyncstat [Device-Name] |
[for HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmsyncstat [Device-Name] |
[for Windows]
|
program-directory\bin\acmsyncstat [Device-Name] |
|
Operand |
Description |
|---|---|
|
Device-Name |
For Solaris, Linux, HP-UX, or AIX, specifies the block device name. When you omit the device name, the system displays the status of backup synchronous processing for all of the transaction volumes. |
= 0: Normally end
> 0: Abnormally end
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. |
|
Status |
Indicates the status of backup synchronous processing:
|
|
Execute |
Indicates the progress of the backup synchronous processing by EC or softwear-copy as a percentage (0 to 100%). |
If "failed" or "halt" is indicated as the status of the backup synchronous processing (in the Status field), a hardware failure is considered. Correct the cause of the hardware problem, and take action by referring "Troubleshooting for a Hardware Error, etc. occurring during backup".
If "nosession" is indicated as the status of the backup synchronous processing (in the Status field)," resource information having inconsistency is considered. Use the "Resource match command (swstsrsemtch)" 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. Correct the cause of the GDS problem, and take action as follows:
- If backup synchronous processing is being executed, cancel it by executing the "Backup synchronous processing cancel command (acmcancelsync)".
- If snapshot backup is being executed, delete the backup history information by executing the "History information delete command (acmhistdel)".
- If restoration is in progress, execute the "Resource match command (swstsrsemtch)", and perform restoration again.
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 backup to or restoration from tape in progress. Generation management information is displayed after "Generation Management Backup" is output. Day management information is displayed after "Day Management Backup" is output.
[for Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmexecstat [Device-Name] |
[for HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmexecstat [Device-Name] |
[for Windows]
|
program-directory\bin\acmexecstat [Device-Name] |
|
Operand |
Description |
|---|---|
|
Device-Name |
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, see "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
|
= 0: Normal end
> 0: Abnormal end
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 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. |
||
|
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 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 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.
|
||
|
DiskExecute |
Displays the name of the executed command or the progress of copying. |
||
|
"----" |
No operation, such as a command, OPC, and 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%)" |
Progress of backup synchronous processing |
||
|
"sync(failed)" |
EC ended abnormally. |
||
|
"sync(halt)" |
EC is in the halt state. |
||
|
"snapshot(xxx%)" |
Progress of OPC backup |
||
|
"snapshot(failed)" |
OPC backup ended abnormally. |
||
|
"snapshot(halt)" |
OPC backup is in the halt state. |
||
|
"restore(xxx%)" |
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 date of the last backup equals 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%)" |
Progress of writing to tape (0% to 100%) |
||
|
"Reading(xxx%)" |
Progress of reading from tape (0% to 100%) |
||
|
"Waiting-tape(xxx%)" |
Waiting for tape. Progress of writing to or reading from tape (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 display conforms to the following rule:
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. |
|
|
TapeInterval |
If the number of days that have elapsed since the date of the last backup equals the number of interval days defined in the tape backup policy, the number of days that have elapsed since the last day in 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%)" |
Progress of writing to tape (0% to 100%) |
|
|
"Reading(xxx%)" |
Progress of reading from tape (0% to 100%) |
|
|
"Waiting-tape(xxx%)" |
Waiting for tape. Progress of writing to or reading from tape (0% to 100%) |
|
During synchronous high-speed backup with -suspend specified, no operation ("----") is indicated in the DiskExecute field.
If "sync (failed),", "snapshot(failed)", or "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 the "Backup synchronous processing cancel command (acmcancelsync)".
- If "snapshot(failed)" is displayed
To delete backup history information, execute the "History information delete command (acmhistdel)".
- If "restore(failed)" is displayed
Cancel restoration using the "Restore cancellation command (swstcancelrest)".
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. Correct the cause of the GDS problem, and take action as follows:
- If backup synchronous processing is being executed, cancel it by executing the "Backup synchronous processing cancel command (acmcancelsync)".
- If snapshot backup is being executed, delete the backup history information by executing the "History information delete command (acmhistdel)".
- If restoration is in progress, execute the "Resource match command (swstsrsemtch)", and perform restoration again.
This command stops tracking processing for a QuickOPC.
[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} |
|
Option |
Description |
|---|---|
|
-copy |
Specifies that physical copying, if active, should also be stopped (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 the history deletion command (acmhistdel). |
|
-emergency |
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. |
|
-bd |
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. |
|
-all |
Stops the entire tracking processing specified for the transaction volumes. This option cannot be specified together with the -bd option. |
|
Operand |
Description |
|---|---|
|
Device-Name |
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, see "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]". |
|
Backup-Device-Name |
Specifies a backup volume name. |
= 0: Normal end
> 0: Abnormal end
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
|
Tracking processing cannot be stopped under the following conditions.
- Tracking processing is not performed for the specified copy source and destination volumes.
This command cannot be executed while the following command is executed:
- Storage Server configuration information setting command (acmsvrset)
- Device information setting command (acmdevinfoset)
- Resource match command (swstsrsemtch)
- Resource backup command (swstresback)
- Resource restore command (swstresrst)
This command displays the status of tracking processing.
When multiple types of synchronous processing exist for one transaction volume, the command displays the statuses of all types of tracking processing.
Execution status information cannot be displayed for transaction volumes that are linked to GDS snapshot.
[For Solaris/Linux]
|
# /opt/FJSVswstc/bin/acmtrkstat [Device-Name] |
[For HP-UX/AIX]
|
# /opt/FJSVswstc/bin/acmtrkstat [Device-Name] |
[For Windows]
|
program-directory\bin\acmtrkstat [Device-Name] |
|
Operand |
Description |
|---|---|
|
Device-Name |
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, see "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. |
|
Log-Group-Name |
Specifies the log group name. |
= 0: Normal end
> 0: Abnormal end
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 a storage server name. |
|
Transaction-Disk |
Displays a transaction volume name. |
|
Backup-Disk |
Displays a backup volume name. Displays "----" when the volume is not in the tracking status. |
|
Status |
Displays the execution status. "----": Not in progress of tracking "executing": In progress of physical copying and tracking "tracking": In progress of tracking "failed": Physical copying or tracking terminated abnormally. "nosession": No session exists. (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 |
Displays the amount of updated data after QuickOPC (logical copying) as a percentage when "tracking" is displayed in the Status column. "----" is displayed when "executing" is displayed in the Status column. |
When the execution status (status displayed in the "Status" column) is "failed," a hardware problem is assumed. Remove the problem cause and then reexecute the differential snapshot backup.
When the execution status (status displayed in the "Status" column) is "nosession," the resource information is probably inconsistent. Use the resource matching command (swstsrsemtch) 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, 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, 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, see "Drive letter allocation command(swstdrvset)" 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, see "Drive letter deallocation command(swstdrvunset)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
For Windows, This command dismounts the specified volume.
For details on the command, see "Dismount command(swstdismount)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
For Windows, This command unlocks a volume.
For details on the command, see "Volume unlock command(swstvolunlock)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
For Windows, This command displays information about a volume locked.
For details on the command, see "Locked-volume information display command(swstvollockstat)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
This sub-section describes maintenance commands for backup management.
To operate backup management, use the following maintenance commands:
|
Function |
Command name |
Description |
|---|---|---|
|
Resource match command |
swstsrsemtch |
Recovers the consistency of information in a backup management files. |
|
Resource backup command |
swstresback |
Backs up a backup management files. |
|
Resource restore command |
swstresrst |
Restores a backup management files. |
This command makes recovery to make resource information consistent if a system failure, etc. has made the resource information inconsistent.
For details of the command, see "Resource match command (swstsrsemtch)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
This command backs up a backup management files to a specified directory.
For details of the command, see "Resource backup command (swstresback)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
A backup management files is restored from the specified directory.
Management books, such as Storage Server composition information.
For details of the command, see "Resource restore command (swstresrst)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
This section is explaining operation by the command of the configuration management, which manages the information of the servers and their devices for backup management or replication management.
This command changes the server change information of the Storage Management Server.
For details of the command, see "Management server information change command (stgcmmodnode)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Management Server.
For the change procedure using this command, see the following:
This command changes a user name and/or password used to access a repository. This command must be executed on the Storage Management Server.
For details of the command, see "Repository access user change command (stguserset)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Management Server.
The Storage Management Server is equipped with two or more network cards, and it is used when dividing and employing the IP address specified in case the IP address (IP address specified when it was the database creation at the time of Storage Management Server introduction) and Web screen with a Storage Server which communicate are used.
For details of the command, see "GUI connection information setting command (stgguiipset)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Management Server.
This command adds Storage Server information to be managed by AdvancedCopy Manager. It is necessary to execute this command on the Storage Management Server.
For details of the command, see "Server information addition command (stgxfwcmaddsrv)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Management Server.
This command changes the following server information managed by AdvancedCopy Manager.
For details of the command, see "Server information change command (stgxfwcmmodsrv)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Management Server.
This command deletes the Storage Server information that AdvancedCopy Manager is currently managing.
For details of the command, see "Server information deletion command (stgxfwcmdelsrv)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Management Server.
This command collects the latest device information detected by the server and displays the difference with the information managed by AdvancedCopy Manager.
For details of the command, see "Device information collection/reflection command (stgxfwcmsetdev)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Management Server.
This command deletes the device information currently being managed by AdvancedCopy Manager.
For details of the command, see "Device information deletion command (stgxfwcmdeldev)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Management Server.
This command displays the server information managed by ETERNUS SFAdvancedCopy Manager.
For details of the command, see "Server information display command (stxfwcmdispsrv)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Management Server.
This command displays the device managed by AdvancedCopy Manager.
For details of the command, see "Device information display command (stgxfwcmdispdev)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Management Server.
This command displays the information for the partitions that comprise a device managed by AdvancedCopy Manager.
For details of the command, see "Partition information display command (stgxfwcmdisppat)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Management Server.
This command displays values of environment settings in AdvancedCopy Manager.
For details of the command, see "Environment information display command (stgenvdisp)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Management Server.
The command registers the management information package backup execution server (the server on which the management information package backup command is executed).
The command deletes the management information package backup execution server.
The command displays information about the management information package backup execution server.
For details of the command, see "Management information package backup server registration/deletion command (stgmgrinfoset)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
This command makes backups of the management information stored on the Storage Servers and Storage Management Server.
For details of the command, see "Management information package backup command (stgmgrinfobkup)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
This command displays the status of execution of the management information package backup command.
For details of the command, see "Management information package backup status display command (stgmgrinfodisp)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
Specify the management unit of SDX objects handled by AdvancedCopy Manager. Moreover, the unit of operation of a present SDX object is displayed.
For details of the command, see "SDX object management unit setting command (stgxfwcmsetsdx)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
This section explains the commands that are executed on a Tape Server.
To execute the following commands on the Tape Server, the Tape Server and its daemon must be active. Otherwise, when one of the commands is executed, it outputs a message and terminates with an error.
- Tape restore command
- Tape history information display command
- Tape execution status display command
- Trace log output level setting command
- Server information change notification command
If multiple Tape Servers are installed, the only Storage Server that can be used with one of these commands is only the one associated with the Tape Server on which the command is executed.
This command checks the validity of the Tape Server definition files (devpath.conf and tsm.conf). The command can be executed even if the Tape backup daemon is inactive.
|
# /opt/FJSVswstm/bin/tbochkconf |
Check the validity of the Tape Server definition files.
# /opt/FJSVswstm/bin/tbochkconf tbochkconf completed # |
= 0: Normal end
> 0: Abnormal end
The command fails to make this check in the following cases:
- The definition files (devpath.conf and tsm.conf) are not found in /etc/opt/FJSVswstm/conf.
- A definition file contains a specification error. For information on definitions in the definition files, see "Customization of Tape Server" in the "ETERNUS SF AdvancedCopy Manager Installation Guide for Tape Backup Option".
Of the types of backup history information, data stored on tape is restored by this command.
When the command is used for restoration, neither preprocessing nor postprocessing is executed on the Storage Server. Therefore, it must be executed while the Storage Server is either stopped or not accessing the applicable transaction volume.
Restoration can be performed to any device other than transaction volumes. The device that can be specified as a restoration destination must:
- be a volume other than a transaction volume.
- be the same size or larger than the original transaction volume.
When this command is used for restoration, neither preprocessing nor postprocessing is performed on the Storage Server. If the command is executed while the transaction volume is being accessed, restoration of data is not guaranteed.
When the command is executed with a restoration destination volume specified, restoration is performed even if the specified volume contains backup data or synchronous processing is being executed. Performing restoration under this condition damages backup data. Therefore, when specifying a backup volume for the restoration destination, specify one that is not used.
|
# /opt/FJSVswstm/bin/tborestore -h Storage-Server [-g Generation-No | -v Version-No | -t Backup-Time] [-r Restore-Device-Name] [-d Restore-Storage-Server] Device-Name |
|
Option |
Description |
|---|---|
|
-h |
Specifies a Storage Server name. |
|
-g |
Specifies the relative generation number of the data to be restored. |
|
-v |
Specifies the absolute generation number of the history information for the generation management backup to be deleted. |
|
-t |
Specifies the day management start date and time of the data to be restored. |
|
-r |
Specifies the restoration destination device for restoration to a device other than a transaction volume. |
|
-d |
Specifies the restoration destination Storage Server name for restoration to a volume on a Storage Server different from that containing the original transaction volume. |
Note: If none of the -g, -v, and -t options is specified, the latest information among the backup history data subject to generation management is restored.
|
Operand |
Description |
|---|---|
|
Device-Name |
When the Storage server is Solaris/Linux/HP-UX/AIX, Specifies the block device name of transaction volume. When the Storage server is Windows, Specifies a AdvancedCopy Manager device name corresponding to a transaction volume. For details on the AdvancedCopy Manager device name, see "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]". |
= 0: Normal end
> 0: Abnormal end
Restore the data with relative generation number 2. For the relative generation numbers, see the data displayed by the "Tape history information display command (tbohistdisp)".
# /opt/FJSVswstm/bin/tborestore -h server01 -g 2 /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d0s6 tborestore completed # |
Restore the data that was backed up at 06:12:55 on February 2, 2005 under day management.
# /opt/FJSVswstm/bin/tborestore -h server01 -t "2005/02/02 06:12:55" /dev/dsk/c1t1d0s6 /dev/dsk/c1t1d0s6 tborestore completed # |
If one of the following events occurs, restoration fails. In this case, take appropriate action according to "System administrator response" in the output message.
- Both relative and absolute generation numbers are specified.
- A device registered as a transaction volume is specified for a parameter of the -r option.
- An SDX object is specified for a parameter of the -r option.
- A GDS logical volume is specified as the restoration destination volume of a normal transaction volume.
- An error is detected during reading from tape.
This command displays the execution status of a tape backup operation. During backup to or restoration from tape, the command displays the progress of backup or restore processing. Generation management information is displayed after "Generation Management Backup" is output. Day management information is displayed after "Day Management Backup" is output.
|
# /opt/FJSVswstm/bin/tboexecstat -h Storage-Server [Device-Name] |
|
Option |
Description |
|---|---|
|
-h |
Specifies a Storage Server name. |
|
Operand |
Description |
|---|---|
|
Device-Name |
When the Storage server is Solaris/Linux/HP-UX/AIX, Specifies the block device name of transaction volume. If this option is omitted, the execution statuses of all transaction volumes are displayed. |
= 0: Normal end
> 0: Abnormal end
The execution status of a transaction volume is displayed.
# /opt/FJSVswstm/bin/tboexecstat Generation Management Backup Server Device Last-Backup-Date Interval Status Mount-Point (Method) Execute server1 /dev/dsk/c1t0d0s3 2004/12/11 12:20 OK IDLE /usr1 (ufs) ---- server1 /dev/dsk/c1t0d0s4 2004/12/10 12:20 DELAY=1 IDLE /usr2 (ufs) Writing(50%) server1 /dev/dsk/c1t0d0s5 2004/12/09 12:20 DELAY=2 IDLE /usr3 (ufs) Writing(10%) Day Management Backup Server Device Last-Backup-Date Interval Status Mount-Point (Method) Execute server1 /dev/dsk/c1t0d0s3 2004/12/11 12:20 OK IDLE /usr1 (ufs) ---- server1 /dev/dsk/c1t0d0s4 2004/12/10 12:20 OK IDLE /usr2 (ufs) ---- server1 /dev/dsk/c1t0d0s5 2004/12/09 12:20 OK IDLE /usr3 (ufs) ---- # |
The table below lists the displayed items.
|
Keyword |
Description |
|
|---|---|---|
|
Server |
Displays the Storage Server name. |
|
|
Device |
When the Storage server is Solaris/Linux/HP-UX/AIX, Displays a device name. When the Storage server is Windows, displays a AdvancedCopy Manager device name. |
|
|
Last-Backup-Date |
Displays the date and time of the last backup. |
|
|
Interval |
If the number of days that have elapsed since the date of the last backup equals 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.") |
|
|
Status |
Displays whether tape-related execution for a transaction volume is in progress. If execution is in progress, "EXEC" is displayed; otherwise, "IDLE" is displayed. |
|
|
Mount-Point (Method) |
When the Storage server is Solaris/Linux/HP-UX/AIX, Displays the mount point name of a transaction volume followed by the file system type in parentheses. If no existing mount point is applicable, " ---- (----)" is displayed. |
|
|
Execute |
Displays the progress of writing to or reading from tape. |
|
|
"----" |
Neither writing to tape nor reading from tape is being performed. |
|
|
"Writing(xxx%)" |
Progress of writing to tape (0% to 100%) |
|
|
"Reading(xxx%)" |
Progress of reading from tape (0% to 100%) |
|
|
"Waiting-tape(xxx%)" |
Waiting for tape. Progress of writing to or reading from tape (0% to 100%) |
|
When multiple types of processing are executed for a transaction volume, the Execute column display conforms to the following rule:
This command displays history information that was backed up to tape.
Generation management information is displayed after "Generation Management Backup" is output. Day management information is displayed after "Day Management Backup" is output.
|
# /opt/FJSVswstm/bin/tbohistdisp -h Storage-Sarver [-l] [Device-Name] |
|
Option |
Description |
|
|---|---|---|
|
-h |
Specifies a Storage Server name. |
|
|
-l |
Displays detailed history information for a backup to tape. |
|
|
Operand |
Description |
|---|---|
|
Device-Name |
When the Storage server is Solaris/Linux/HP-UX/AIX, Specifies the block device name of transaction volume. If this option is omitted, the execution statuses of all transaction volumes are displayed. |
= 0: Normal end
> 0: Abnormal end
Display detailed backup history information for transaction volume "/dev/dsk/c1t1d10s1" on Storage Server server01 by specifying the -l option.
# /opt/FJSVswstm/bin/tbohistdisp -h server01 -l /dev/dsk/c1t1d10s1 Generation Management Backup Server=StrgSV01 Device=/dev/dsk/c1t1d10s1 Mount-Point=/work1 (ufs) Generation Version CopyID Backup-Date Pool-Name Backup-Tape 1 10 1 2000/11/12 21:00 TapePool4 LT00059 2 9 1 2000/11/11 21:00 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 the information items displayed for a generation management backup.
|
Keyword |
Description |
|---|---|
|
Server |
Displays a Storage Server name. |
|
Device |
When the Storage server is Solaris/Linux/HP-UX/AIX, Displays a device name. When the Storage server is Windows, displays a AdvancedCopy Manager device name. |
|
Mount-Point |
When the Storage server is Solaris/Linux/HP-UX/AIX, Displays the mount point name of the device and the file system type in parentheses. When the Storage server is Windows, 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 backup data. |
|
Version |
Displays an absolute generation number. |
|
Backup-Date |
Displays the date and time of completion of backup in the "YYYY/MM/DD hh:mm" format. |
|
CopyID |
Displays the tape copy ID (fixed at 1). |
|
Pool-Name |
Displays the name of the storage pool to which tape backup was performed. |
|
Backup-Tape |
Displays the name of the tape volume to which backup was performed. If multiple tape volumes are applicable, the displayed names are delimited by a comma (,). |
The table below lists the displayed information items for a day management backup.
|
Keyword |
Description |
|---|---|
|
Server |
Displays a Storage Server name. |
|
Device |
When the Storage server is Solaris/Linux/HP-UX/AIX, Displays a device name. When the Storage server is Windows, displays a AdvancedCopy Manager device name. |
|
Mount-Point |
When the Storage server is Solaris/Linux/HP-UX/AIX, Displays the mount point name of the device and the file system type in parentheses. When the Storage server is Windows, For Windows,Displays the drive letter of a device. The file system type of the device is displayed inside the parentheses. |
|
TapeCopy-Date |
Displays the day management start date and time of a day management backup to tape in the "YYYY/MM/DD hh:mm:ss" format. |
|
Backup-Date |
Displays the date and time of completion of backup in the "YYYY/MM/DD hh:mm" format. |
|
Expiration-Date |
Displays the expiry date and time of day management backup to tape in the "YYYY/MM/DD hh:mm:ss" format. |
|
Pool-Name |
Displays the name of the storage pool to which tape backup was performed. |
|
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 command backs up tape management information to the specified directory. The tape management information includes TSM databases.
|
# /opt/FJSVswstm/bin/tboresback Backup-Directory |
|
Operand |
Description |
|---|---|
|
Backup-Directory |
Specifies the name of the destination directory for backing up tape management information. |
Back up tape information to /home/backup:
# /opt/FJSVswstm/bin/tboresback /home/backup tboresback completed # |
You cannot perform backup if:
- The specified directory does not exist.
- Copying of data to the specified directory failed because of insufficient free space, etc.
- A file specified in the backup source TSM environment file (/etc/opt/FJSVswstm/conf/tsmbkfile) is not found. For information on the backup source TSM environment file, see "Backing up a tape management information".
The tape management information backup command cannot be executed while a request related to tape backup is being processed on the Tape Server.
This command restores tape management information from the specified directory. The tape management information includes TSM databases.
|
# /opt/FJSVswstm/bin/tboresrst Backup-Directory |
|
Operand |
Description |
|---|---|
|
Backup-Directory |
Specify the name of the directory to which to save the backup management files. |
Restore tape management information from /home/backup:
# /opt/FJSVswstm/bin/tboresrst /home/backup tboresrst completed # |
You cannot perform restoration if:
- The specified directory does not exist.
- The tape management information is not found in the specified directory.
- Copying of data from the specified directory for restoration failed because of insufficient free space, etc.
The tape management information restore command cannot be executed when the Tape daemon is active. For information how to stop the Tape Server daemon, see "Starting and stopping the AdvancedCopy Manager Tape daemon".
This command changes the output level of a Tape Server trace log to a file.
A trace log is a record of received commands and information on how they were processed. It is written to a dedicated file. The log provides the information required for analyzing error causes in the event that an error is detected during tape backup. Changing the trace log output level can change the amount of output information. The setting of the output level need not be changed for a normal backup operation.
|
# /opt/FJSVswstm/bin/tbomodlog Log-Level |
|
Operand |
Description |
|
|---|---|---|
|
Log-Level |
Specifies the trace log output level. |
|
Change the trace log output level to the detailed information level.
# /opt/FJSVswstm/bin/tbomodlog 2 tbomodlog completed # |
Performing a normal backup operation with the trace log level set to the detailed information level affects backup performance. To prevent this problem, perform the operation with the output log level set to the generation information level, except when collecting error survey information after an error occurrence.
When the server name, IP address, or port number of a Storage Server is changed, this command reflects the change to the Tape Server management information.
|
# /opt/FJSVswstm/bin/tbomodsrv server name |
|
Operand |
Description |
|
|---|---|---|
|
Server name |
Specifies a Storage Server name. |
|
After changing the Storage Server name from srv1 to node1, reflect the change to a Tape Server.
# /opt/FJSVswstm/bin/tbomodsrv node1 tbomodsrv completed # |
For the procedure for using this command to change server information, see the following:
This command obtains the information required for backing up the data of ETERNUS3000 disk array unit to tape in a multi-path environment. The command obtains such information from the ETERNUS3000 disk array unit.
This command must be executed at the following times:
|
# /opt/FJSVswstm/bin/tbogetoluinfo -l GRIPaddress [GRIPaddress ...] |
|
Option |
Description |
|---|---|
|
-l |
Specifies that ETERNUS3000 information be obtained from the ETERNUS3000 disk array unit specified by GRIPaddress via a LAN and written to the /var/opt/FJSVmplb/mplb_ext.conf file. |
|
Operand |
Description |
|---|---|
|
GRIPaddress |
Specifies the IP address of the ETERNUS3000 disk array unit from which information is to be obtained. The only applicable IP addresses are "IPv4." |
= 0: Normally end
> 0: Abnormally end
Obtain information from the ETERNUS3000 disk array unit specified by GRIPaddress (200.30.40.30).
# /opt/FJSVswstm/bin/tbogetoluinfo -l 200.30.40.30 200.30.40.30 completed. [total olu = 3] /var/opt/FJSVmplb/mplb_ext.conf was update. # |
To execute this command, the following conditions must be satisfied:
- The ETERNUS3000 disk array unit has the following firmware version or later:
Model
Firmware version
M100/M200/M400/M600
V20L32
M300/M500/M700
V10L10
- The Tape Server and ETERNUS3000 disk array unit are connected to a LAN.
- The Tape Server and ETERNUS3000 disk array unit are FC-connected.
- A GR multi-path driver is installed on the Tape Server.
- The tbochkconf command has been executed with the ETERNUS3000 access path written in the /etc/opt/FJSVswstm/conf/devpath.conf file.
The daemons of AdvancedCopy Manager can be started in the ways explained in this section.
A note on this command is as follows:
- Make sure that the SWSTGNODE environment variable is not set.
- Execute this command using the same LANG environment variable that of the code system used by the system.
- Only a root user can execute this command.
- For information on cluster operation, see "Starting and Stopping a Daemon" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide for cluster environment" corresponding to the cluster system.
See "Starting and stopping the communication daemon" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
See "Starting and stopping the RMI daemon" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
See "Starting and stopping the RDB daemon" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
See "Starting and stopping the authentication daemon" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
See "Starting and stopping the AdvancedCopy Manager daemons" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Server.
Enter the following command to start the Tape daemon.
# /etc/init.d/FJSVswstm start |
Enter the following command to stop the Tape daemon.
# /etc/init.d/FJSVswstm stop |
Only the Tape Server has the Tape daemon.
Enter the following command to start the TSM daemon.
# /etc/init.d/initTSM start |
Enter the following command to stop the TSM daemon.
# /etc/init.d/initTSM stop |
The TSM daemon runs only on the Tape Server.
|
Contents
Index
|