NAME
stgxfwcmmodsrv - changes the following server information
SYNOPSIS
/opt/FJSVswstf/bin/stgxfwcmmodsrv -n Server-Name [-s New-Server-Name] [-i New-IP-Address] [-p New-port-Number] | [-f server-information-change-instruction-filename [-y]]
DESCRIPTION
This command changes the following server information managed by AdvancedCopy Manager. It is necessary to execute this command on the Management Server.
A Managed Server IP address
A Managed Server port number
The server name of a Management Server
The server name of a Managed Server
Server information can also be changed as a batch while maintaining the consistency of multiple items of information between multiple servers in the managed system by specifying the server information change instruction file.
The following server information can be changed:
Management Server IP address
Managed Server IP address
Management Server port number
Managed Server port number
Server name of the Management Server
Server names of Managed Servers
OPTIONS
Specify a server name that is currently being managed.
Specify a server name displayed by stgxfwcmdispsrv (Server information display command) exactly as displayed, including the case.
Specify a new server name in less than 255 bytes. The usable characters are: 1-byte alphanumeric characters, minus sign (-), underscore (_), number sign (#), and period (.), with the first character being a 1-byte alphanumeric character. (A 2-byte character causes an error.)
Note that the new server name is case-sensitive. When specifying the server name in other commands or Web Console, enter the server name exactly as entered in this command, including the case.
Specify at the same time as the -n option.
Specify the IP address of the Managed Server to be added by IPv4 format.
Specify a physical IP address if the Managed Server is managed as a physical server. Specify a logical IP address if the IP address is made redundant and managed (as a logical server), as in a cluster environment.
Specify at the same time as the -n option.
Specify a port number required for post-change communication. The values are from 1024 to 65535)
Under the cluster environment, specify the port number that is allocated to service name stgxfws_? (Logical node name of AdvancedCopy Manager specified during cluster setup)
For non-cluster operations, specify the port number assigned to service name stgxfws.
Specify at the same time as the -n option.
Specify the absolute path of the server information change instruction filename.
This option can only be specified at the same time as than the -y option.
Format for the server information change instruction file
In the first line, enter the server name of a currently managed server, the information class to be changed, and the new value, delimited by spaces or tabs.
The information classes to be changed are as follows:
S: Server name
I: IP address
P: Port number
If multiple information classes, such as the IP address and the port number, need to be changed at the same server, enter the IP address change instruction, then enter the port number change instruction on the second line.
Manager I 10.10.20.10 Server1 I 10.10.20.20 Server1 P 9888 Server2 S DstServer
Specify this option to continue processing if the management system contains multiple servers and an error occurs at a specific server.
Remove the cause of the error at the server where the error occurred, and perform the required change procedure separately for that server.
Specify at the same time as the -f option.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
The IP address of a Managed Server (with server name: Server1) is changed to 10.20.30.40:
# /opt/FJSVswstf/bin/stgxfwcmmodsrv -n Server1 -i 10.20.30.40 stgxfwcmmodsrv completed #
The server name of a Managed Server (with server name: Server1) is changed to Agent5:
# /opt/FJSVswstf/bin/stgxfwcmmodsrv -n Server1 -s Agent5 stgxfwcmmodsrv completed #
The server information change instruction file is specified to change server information as a batch:
# /opt/FJSVswstf/bin/stgxfwcmmodsrv -f /acm/modfile stgxfwcmmodsrv completed #
The server information change instruction file is specified to change server information as a batch, even if an error occurs at a specific server:
# /opt/FJSVswstf/bin/stgxfwcmmodsrv -f /acm/modfile -y swstf2459 Resource adjustment command terminated abnormally. Server name=[Server1] swsrp0625 This command cannot be executed because execution of other AdvancedCopy Manager commands is in progress. stgxfwcmmodsrv completed, excluding the server where the error occurs #
NOTES
Since stgcmmodnode (Management Server information change command) is used to change the following server information, this information can only be changed if the server information change instruction file is specified:
The IP address of a Management Server
The port number of a Management Server
If the server information is going to be changed by using this command, the machine definition information must be changed in advance. Refer to the procedure given in "7.5 Changing the Operating Environment", for information on executing the processing.
This command can be executed only by root users.
Please perform the command in the location specified at the time of product installation.
When processing takes a long time, a period (.) is displayed until it is complete.
The following notes apply to changing the Management Server information (except when the -f option is specified):
Use stgcmmodnode (Management Server information change command) to change the IP address and port number, then restart the various AdvancedCopy Manager services.
After Management Server information is changed, execute stgcmmodnode (Management Server information change command) at the Managed Servers to set the changed Management Server information.
The following notes apply to changing the Managed Server information:
Stop the various AdvancedCopy Manager services before changing the IP address. Then, change the IP address in the software that provides the system or logical IP address and restart the AdvancedCopy Manager daemon.
Stop the various AdvancedCopy Manager services before changing the port number. Then, change the port number in the system and restart the AdvancedCopy Manager daemon.
The following notes apply when the -f option is specified:
The server name or IP address that is to be changed cannot be in use by another server that is currently managed.
The server name to be changed is case-sensitive. Specify a new server name displayed by stgxfwcmdispsrv (Server information display command) exactly as displayed, including the case.
The new server name is case-sensitive. When specifying the server name in other commands or Web Console, enter the server name exactly as entered in this command, including the case.
The Management Server that executes this command and the AdvancedCopy Manager services and Managed Server transactions at all Managed Servers managed by Management Server transactions must be running.
Backup management commands and replication management commands must not be executed at the Management Server that executes this command nor in the AdvancedCopy Manager services and Managed Server transactions at all Managed Servers managed by Management Server transactions.
If commands are executed, they may terminate abnormally. If the server information change command terminates abnormally, perform recovery as indicated in the error message. If backup management or replication management commands are accidentally executed during execution of the server information change command, and if the backup management and replication management commands terminate abnormally, re-execute the backup management or replication management commands after normal termination of the server information change command.
The following notes apply when the -y option is specified:
If this option is specified, processing will be forcibly continued if a communication or other error occurs for some servers. Therefore, consistency of the overall system cannot be maintained. Usually, do not specify this option.
Specify this option only when absolutely necessary due to problems at some servers.
Take the action indicated in the error message at the server which output the message. Normal operation is not possible until this action is taken, so take action promptly.
This command cannot be executed while the following commands are being executed:
This command cannot be executed while the following operations are being performed in the initial window by using the Web Console:
Addition of a new server
Change of a server
Deletion of a server
Acquisition and Reflection of Information on All Devices
Acquisition and Reflection of Information on a Specific Device
Deletion of device information
