8.4 Replication Management Commands

This section describes operations using Replication Management Commands.

Note

Only a root user can execute all the commands of replication management. When command execution is carried out by other users, a message "swsrp0601 This Command cannot be run. This is because the user is not a root user." is displayed, and the command aborts.

Note

Operating environment for command execution

The table below lists the requirements for the operating environment in which to execute the different commands.

Table 8.16 Operating environment when executing replication management commands
Command	Operating environment of AdvancedCopy Manager
swsrpcancel	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be operating. When the Managed Server runs on Windows and is in EC operation, Windows services required by the copy destination Managed Server must be running (except when the -m or -t option is specified). For inter-server replication in EC equivalency status, the associated server must be operating (except when the -m option is specified).
swsrpchsync	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swsrpdelvol	To execute this command on a Managed Server, Windows services required by the Management Server must be running. To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running. For inter-server replication, Windows services required by the Managed Server in communication must be running (except when the -d option is specified).
swsrprecbuffstat	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swsrprecbuffset	To execute this command on a Managed Server, Windows services required by the Management Server must be running. To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swsrpmake	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running. When the Managed Server runs on Windows and is engaged in intra-server replication and EC operation, Windows services required by the Managed Server must be running. For inter-server replication, Windows services required by the Managed Server in communication must be running (except when the -m or -t option is specified).
swsrprecoverres	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running. When the Managed Server runs on Windows, Windows services required by the Managed Server must be running. To specify the -r option, Windows services required by the Management Server must be running.
swsrprevsync	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swsrpsetvol	To execute this command on a Managed Server, Windows services required by the Management Server must be running. To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running. For inter-server replication, Windows services required by the Managed Server in communication must be running.
swsrpstartsync	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running. When the Managed Server runs on Windows, Windows services required by the Managed Server must be running. For inter-server replication, the associated server must be running (except a case where the -m option is specified).
swsrpstat	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.
swsrpvolinfo	To execute this command on a Management Server with the -h option specified, Windows services required by the Management Server and target Managed Server must be running.

Note

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. 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, indicates whether environment variables must be configured and shows the nodes on which commands are executable. For notes and cautions on command execution, refer to the Remarks column.

Table 8.17 Commands when cluster operation is used
Command	Environment variable	Command execution node	Remarks
swsrpsetvol	Required	Transaction operation node	-
swsrpvolinfo	Required	Transaction operation node	-
swsrpdelvol	Required	Transaction operation node	-
swsrprecbuffstat	Required	Transaction operation node	-
swsrprecbuffset	Required	Transaction operation node	-
swsrpstartsync	Required	Transaction operation node	-
swsrpmake	Required	Transaction operation node	-
swsrpstat	Required	Transaction operation node	-
swsrpcancel	Required	Transaction operation node	-
swsrpchsync	Required	Transaction operation node	-
swsrprevsync	Required	Transaction operation node	-
swsrprecoverres	Required	Transaction operation node	-