14.1 Backup Management Commands

This section describes operations using Backup Management Commands.

Note

Only a user belonging to the Administrators group can execute all the commands of backup management. When commands are executed by other users, the message "swst0601 This Command cannot be run because the user is not a root user." is generated and then the command aborts.
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 14.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
swstvolunlock	The daemons or services of the Management Server must be operating.
swstvollockstat	The daemons or services of the Management Server must be operating.

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:
```
set SWSTGNODE=logicalNodeName
```
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 14.2 Commands When Cluster Operation Is Used
Command	Environment Variable	Command Execution Node	Remarks
swstsvrset	Required	Transaction operation node	-
swstsvrdisp	Required	Transaction operation node	-
swstdevinfoset	Required	Transaction operation node	-
swstdevdisp	Required	Transaction operation node	-
swstbkpolset	Required	Transaction operation node	-
swstbkpoldisp	Required	Transaction operation node	-
swstbkpoldel	Required	Transaction operation node	-
swstbackup	Required	Transaction operation node	-
swstbackstat	Required	Transaction operation node	-
swstrestore	Required	Transaction operation node	-
swstcancelrest	Required	Transaction operation node	-
swstreststat	Required	Transaction operation node	-
swsthistdisp	Required	Transaction operation node	-
swsthistdel	Required	Transaction operation node	-
swststartsync	Required	Transaction operation node	-
swstcancelsync	Required	Transaction operation node	-
swstsyncstat	Required	Transaction operation node	-
swstexecstat	Required	Transaction operation node	-
swstdrvset	Required	Transaction operation node	-
swstdrvunset	Required	Transaction operation node	-
swstsrsemtch	Required	Transaction operation node	-
swstresback	Required	Transaction operation node	-
swstresrst	Required	Transaction operation node	-
swstdismount	Required	Transaction operation node	-
swstvolunlock	Required	Transaction operation node	-
swstvollockstat	Required	Transaction operation node	-
swstcanceltrk	Required	Transaction operation node	-
swsttrkstat	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 14.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.