renameNode command

A short name is assigned to a node during installation and customization. Use the renameNode command to modify the node name of a federated server.

Launch this command from the node whose name we want to modify. When we issue this command the following occurs:

1. Connects to the deployment manager.

2. Stops all servers.

3. Changes the node configuration on the deployment manager.
4. Synchronizes the node.

For more information about where to run this command, see Using command line tools.

Use the renameNode command to modify managed nodes. However, we cannot use it to modify the node name for a deployment manager node. If we need to modify the node name for a deployment manager node, we must modify the WAS_NODE variable within the profile_root/deployment_manager_name/bin/setupCmdLine file. See topics about renaming deployment manager nodes.

Syntax

The command syntax is as follows:

(Windows)

renameNode.bat dmgr_host dmgr_port node 
[-nodeshortname name][-trace][-conntype type][-username uid]
[-password pwd][-logfile filename] [-help]

(UNIX) (ZOS)

renameNode.sh dmgr_host dmgr_port node 
[-nodeshortname name][-trace][-conntype type][-username uid]
[-password pwd][-logfile filename] [-help]

(iSeries)

renameNode dmgr_host dmgr_port node 
[-nodeshortname name][-trace][-conntype type][-username uid]
[-password pwd][-logfile filename] [-help]

Parameters

The following options are available for the renameNode command:

-nodeshortname <name>

The short name of the node.

-trace

Generates additional trace information in the log file for debugging purposes.

-conntype <type>

The JMX connector type to use for connecting to the deployment manager. Valid types are SOAP or RMI, which stands for Remote Method Invocation.

-username <uid>

User name for authentication if security is enabled. Acts the same as the -user option. The user name chosen must be a pre-existing user name.

-password <pwd>

Password for authentication if security is enabled. The password chosen must be one associated with a pre-existing user name.

-logfile <filename>

Location of the log file to which trace information is written. By default, the log file is called renameNode.log and is created in the logs directory of the profile for the node being renamed.

-help

Prints a usage statement.

-?

Prints a usage statement.

Usage scenario

The following examples demonstrate correct syntax:

(Windows)

renameNode.bat localhost 8879 newnode

(UNIX) (ZOS)

renameNode.sh localhost 8879 newnode

(iSeries)

renameNode localhost 8879 newnode

Use command-line tools

Renaming deployment manager nodes