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 you want to modify.
When you issue this command the following occurs:
- Connects to the deployment manager.
- Stops all servers.
- Changes the node configuration on the deployment manager.
- Synchronizes the node.
For more information about where to run this command, see Using
command line tools.
Supported configurations: You can use the
renameNode command
to modify managed nodes. However, you cannot use it to modify the
node name for a deployment manager node. If you need to modify the
node name for a deployment manager node, you must modify the
WAS_NODE variable
within the
profile_root/deployment_manager_name/bin/setupCmdLine file.
For more information, see topics about renaming deployment manager
nodes.
sptcfg
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>
- Specifies 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>
- Specifies the user name for authentication if security is enabled.
Acts the same as the -user option. The user name that you choose must
be a pre-existing user name.
- -password <pwd>
- Specifies the password for authentication if security is enabled.
The password that you choose must be one that is associated with a
pre-existing user name.
- -logfile <filename>
- Specifies the 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.