9.1 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 the swstdevinfoset command is used to specify a Logical Unit (disk).

The backup operations of AdvancedCopy Manager using the Storage Cluster Continuous Copy function are not supported.

Note

Operating Environment for Command Execution

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

Table 9.1 Operating Environment for Executing Backup Management Commands
Command	Operating Environment of AdvancedCopy Manager
swstbackstat	The daemons or 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 -h option and device name are specified
swstbackup	To execute this command on a Management Server with the -h option specified, the daemons or 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 or services of the Managed Server must be operating.
swstbkpoldel	To execute this command on a Managed Server, the daemons or services of the Management Server must be operating. To execute this command on a Management Server with the -h option specified, the daemons or services of the Management Server and target Managed Server must be operating.
swstbkpoldisp	The daemons or 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 -h option and device name are specified
swstbkpolset	To execute this command on a Managed Server, the daemons or services of the Management Server must be operating. To execute this command on a Management Server with the -h option specified, the daemons or 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 or 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 or 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 or services of the Managed Server must be operating.
swstcanceltrk	To execute this command on a Management Server with the -h option specified, the daemons or services of the Management Server and target Managed Server must be operating.
swstdevdisp	The daemons or 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 -h option and device name are specified To execute this command with the -o option specified, the daemons or services of the Management Server must be operating.
swstdevinfoset	To execute this command on a Managed Server, the daemons or services of the Management Server must be operating. To execute this command on a Management Server with the -h option specified, the daemons or services of the Management Server and target Managed Server must be operating.
swstexecstat	The daemons or 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 -h option and device name are specified
swsthistdel	To execute this command on a Management Server with the -h option specified, the daemons or services of the Management Server and target Managed Server must be operating.
swsthistdisp	The daemons or 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 -h option and device name are specified
swstresback	-
swstresrst	The daemons or services of the Management Server must be operating. When the Managed Server runs on Windows, the daemons or services of the Managed Server must be always operating.
swstrestore	To execute this command on a Management Server with the -h option specified, the daemons or services of the Management Server and target Managed Server must be operating.
swstreststat	The daemons or 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 -h option and device name are specified
swstsrsemtch	To execute this command on a Management Server with the -h option specified, the daemons or services of the Management Server and target Managed Server must be operating. To execute this command on a Managed Server, the daemons or services of the Management Server must be operating. When the Managed Server runs on Windows, the daemons or services of the Managed Server must be always operating.
swststartsync	To execute this command on a Management Server with the -h option specified, the daemons or services of the Management Server and target Managed Server must be operating. When the Managed Server runs on Windows, the daemons or services of the Managed Server must be operating.
swstsvrdisp	To execute this command on a Management Server with the -h option specified, the daemons or services of the Management Server and target Managed Server must be operating.
swstsvrset	To execute this command on a Managed Server, the daemons or services of the Management Server must be operating. To execute this command on a Management Server with the -h option specified, the daemons or services of the Management Server and target Managed Server must be operating.
swstsyncstat	The daemons or 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 -h option and device name are specified
swsttrkstat	The daemons or 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 -h option and device name are specified

Note

In Cluster Operation, there is the following note.

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=logicalNodeName
# 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 9.2 Commands When Cluster Operation Is Used
Command Name	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 depend on the existence of the -h option and device name. For details, refer to the following table.

Table 9.3 Display Contents of 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 is 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.