8.2 Backup Management Commands

This section describes operations using Backup Management Commands

Note

Only a root user can execute all the commands of backup management. When command execution is carried out by other users, a message "swst0601 This Command cannot be run. This is because the user is not a root user." is displayed and then, an error end.
Backup operations in Logical Units (disk units) are not supported. An error occurs if swstdevinfoset (Device information setting command) is used to specify a Logical Unit (disk).

Note

Operating environment for command execution

The table below lists the operating environment requirements for different commands.

Table 8.11 Operating environment for executing backup management commands
Command	Operating environment of AdvancedCopy Manager
swstbackstat	The daemons and services of the Management Server and target Managed Server must be operating in order to execute this command, if the Management Server has either of the following parameter designations: -h option specified No device name specified
swstbackup	To execute this command on a Management Server with the -h option specified, the daemons and services of the Management Server and target Managed Server must be operating. When the Managed Server runs on Windows and is in EC operation, the daemons and services of the Managed Server must be operating.
swstbkpoldel	To execute this command on a Managed Server, the daemons and services of the Management Server must be operating. To execute this command on a Management Server with the -h option specified, the daemons and services of the Management Server and target Managed Server must be operating.
swstbkpoldisp	The daemons and services of the Management Server and target Managed Server must be operating in order to execute this command, if the Management Server has either of the following parameter designations: -h option specified No device name specified
swstbkpolset	To execute this command on a Managed Server, the daemons and services of the Management Server must be operating. To execute this command on a Management Server with the -h option specified, the daemons and services of the Management Server and target Managed Server must be operating.
swstcancelrest	To execute this command on a Management Server with the -h option specified, the daemons and services of the Management Server and target Managed Server must be operating.
swstcancelsync	To execute this command on a Management Server with the -h option specified, the daemons and services of the Management Server and target Managed Server must be operating. When the Managed Server runs on Windows and is in EC operation, the daemons and services of the Managed Server must be operating.
swstcanceltrk	When this command is executed with the -h option specified on the Management Server, the daemons/services of the Management Server and target Managed Server must be active.
swstdevdisp	The daemons and services of the Management Server and target Managed Server must be operating in order to execute this command, if the Management Server has either of the following parameter designations: -h option specified No device name specified To execute this command with the -o option specified, the daemons and services of the Management Server must be operating.
swstdevinfoset	To execute this command on a Managed Server, the daemons and services of the Management Server must be operating. To execute this command on a Management Server with the -h option specified, the daemons and services of the Management Server and target Managed Server must be operating.
swstexecstat	The daemons and services of the Management Server and target Managed Server must be operating in order to execute this command on a Management Server with either of the following parameter designations: -h option specified No device name specified
swsthistdel	To execute this command on a Management Server with the -h option specified, the daemons and services of the Management Server and target Managed Server must be operating.
swsthistdisp	The daemons and services of the Management Server and target Managed Server must be operating in order to execute this command on a Management Server with either of the following parameter designations: -h option specified No device name specified
swstresback	-
swstresrst	To execute this command on a Management Server with the -h option specified, the daemons and services of the Management Server and target Managed Server must be operating. When the Managed Server runs on Windows, the daemons and services of the Managed Server must be operating. To execute this command with the -x option specified, the daemons and services of the Management Server must be operating.
swstrestore	To execute this command on a Management Server with the -h option specified, the daemons and services of the Management Server and target Managed Server must be operating.
swstreststat	The daemons and services of the Management Server and target Managed Server must be operating in order to execute this command on a Management Server with either of the following parameter designations: -h option specified No device name specified
swstsrsemtch	The daemons and services of the Management Server must be operating. To execute this command on a Management Server with the -h option specified, the daemons and services of the target Managed Server must be operating. When the Managed Server runs on Windows, the daemons and services of the Managed Server must be operating.
swststartsync	To execute this command on a Management Server with the -h option specified, the daemons and services of the Management Server and target Managed Server must be operating. When the Managed Server runs on Windows, the daemons and services of the Managed Server must be operating.
swstsvrdisp	To execute this command on a Management Server with the -h option specified, the daemons and services of the Management Server and target Managed Server must be operating.
swstsvrset	To execute this command on a Managed Server, the daemons and services of the Management Server must be operating. To execute this command on a Management Server with the -h option specified, the daemons and services of the Management Server and target Managed Server must be operating.
swstsyncstat	The daemons and services of the Management Server and target Managed Server must be operating in order to execute this command on a Management Server with either of the following parameter designations: -h option specified No device name specified
swsttrkstat	When this command is executed in either of the following formats on the Management Server, the daemons/services of the Management Server and target Managed Server must be active: -h option is specified No device name is specified

Note

In cluster operation

In cluster operation, execute a command by performing the following steps:

If necessary, specify the logical node name to the transaction in the environment variable SWSTGNODE. Specify the environment variable as follows:
```
# SWSTGNODE=logical-node-name
# export SWSTGNODE
```
Execute the command.

The table below lists the commands available in cluster operation, notes whether environment variables must be configured, and specifies the nodes on which commands are executable. For notes and cautions on command execution, refer to the Remarks column.

Table 8.12 Commands when cluster operation is used
Command	Environment variable	Command execution node	Remarks
swstsvrset	Required	Transaction operating node	-
swstsvrdisp	Required	Transaction operating node	-
swstdevinfoset	Required	Transaction operating node	-
swstdevdisp	Required	Transaction operating node	-
swstbkpolset	Required	Transaction operating node	-
swstbkpoldisp	Required	Transaction operating node	-
swstbkpoldel	Required	Transaction operating node	-
swstbackup	Required	Transaction operating node	-
swstbackstat	Required	Transaction operating node	-
swstrestore	Required	Transaction operating node	-
swstcancelrest	Required	Transaction operating node	-
swstreststat	Required	Transaction operating node	-
swsthistdisp	Required	Transaction operating node	-
swsthistdel	Required	Transaction operating node	-
swststartsync	Required	Transaction operating node	-
swstcancelsync	Required	Transaction operating node	-
swstsyncstat	Required	Transaction operating node	-
swstexecstat	Required	Transaction operating node	-
swstcanceltrk	Required	Transaction operating node	-
swsttrkstat	Required	Transaction operating node	-
swstsrsemtch	Required	Transaction operating node	-
swstresback	Required	Transaction operating node	-
swstresrst	Required	Transaction operation node	-

Note

In a Management Server, when a display-type command that has 'disp' or 'stat' at the end of the command name is executed, the display contents will depend on the existence of the -h option and device name. For details, refer to the following table.

Table 8.13 Display contents of the display-type commands in Management Server
-h option	Device name specified	Display contents
Does not exist	No	Displays all Managed Server information registered using the Backup management functionality. If an error occurs on any of the Managed Servers during display processing, the processing will be terminated.
Does not exist	Yes	Displays only the specified Management Server device information.
Exists	No	Displays all Managed Server information specified using the -h option.
Exists	Yes	Displays only the specified device information for the Managed Server specified using the -h option.