removeNode command
The removeNode command returns a node from a Network Deployment
distributed administration cell to a base WebSphere Application Server installation.
You must run this command from the install_root/bin directory of
a WebSphere Application Server installation.
The removeNode command only removes the node-specific configuration
from the cell. This command does not uninstall any applications that were
installed as the result of executing an addNode command. Such applications
can subsequently deploy on additional servers in the Network Deployment cell.
As a consequence, an addNode command with the -includeapps option executed
after a removeNode command does not move the applications into the
cell because they already exist from the first addNode command. The
resulting application servers added on the node do not contain any applications.
To deal with this situation, add the node and use the deployment manager to
manage the applications. Add the applications to the servers on the node after
it is incorporated into the cell.
The removeNode command does the following:
- Stops all of the running server processes in the node, including the node
agent process.
- Removes the configuration documents for the node from the cell repository
by sending commands to the deployment manager.
- Copies the original application server cell configuration into the active
configuration.
Depending on the size and location of the new node you remove from the
cell, this command can take a few minutes to complete.
Syntax
The command syntax is as follows:
removeNode [options]
All
arguments are optional.
Parameters
The following options are available for
the removeNode command:
- -quiet
- Suppresses the progress information that the removeNode command
prints in normal mode.
- -logfile <fileName>
- Specifies the location of the log file to which information is written.
- -replacelog
- Replaces the log file instead of appending to the current log.
- -trace
- Generates trace information into a file for debugging purposes.
- -statusport <portNumber>
- Specifies that an administrator can set the port number for the node agent
status callback.
- -username <name>
- Specifies the user name for authentication if security is enabled. Acts
the same as the -user option.
- -user <name>
- Specifies the user name for authentication if security is enabled. Acts
the same as the -username option.
- -password <password>
- Specifies the password for authentication if security is enabled.
- -force
- Cleans up the local node configuration regardless of whether you can reach
the deployment manager for cell repository cleanup. After using the -force parameter,
you may need to use the cleanupNode command on the deployment manager.
- -help
- Prints a usage statement.
- -?
- Prints a usage statement.
Usage scenario
The following examples demonstrate
correct syntax:
removeNode -quiet
removeNode -trace (produces the removeNode.log file)

Best practices for adding nodes using command line tools
addNode command
Searchable topic ID:
rxml_removenode
Last updated: Jun 21, 2007 8:07:48 PM CDT
WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/ae/rxml_removenode.html