The removeNode script

The removeNode command removes a node from a Network Deployment cell. After this process, the removed instance is a standalone base WebSphere Application Server instance. The removeNode script only removes the node specific configuration from the cell. It does not uninstall applications that installed when you add the node, because such applications may subsequently be deployed on additional servers in the network deployment cell. For usage instructions and examples, see Remove nodes from a Network Deployment instance.

Note: Depending on the size and location of the node you remove from the cell, this script can take a few minutes to complete.

Product

The removeNode script is available in the WebSphere Application Server product only.

Authority

To run this script, your user profile must have *ALLOBJ authority.

Syntax

The syntax of the removeNode script is:

removeNode [ -instance instance ] [ -force ] [ -nowait ]
 [ -quiet ] [ -logfile filename ] [ -replacelog ] [ -trace ]
 [ -username username ] [ -password password ]
 [ -help | -? ]

Parameters

The parameters of the removeNode script are:

• -instance
  Optional. The value instance specifies the name of the instance that represents the node to be removed from the Network Deployment cell. The default value is default, which represents the default instance.

• -force
  Optional. If you specify this parameter, the script removes the node from the cell even if it cannot connect to the deployment manager. The default is to not force the removal of a node. If you use the -force option to remove a node, use the Network Deployment cleanupNode script to remove the node from the deployment manager instance. See The cleanupNode script for more information.

• -nowait
  Optional. If you specify this parameter, the script returns control to the user without waiting for the node to be removed. The default is to wait for the node to be removed.

• -quiet
  Optional. If you specify this parameter, the script does not display informational messages. The default is to display informational messages while the script runs.

• -logfile
  Optional. The value filename specifies the location and name of the log file for the script. The default value is /QIBM/UserData/WebAS5/Base/instance/logs/removeNode.log where instance is the name of the instance that contains to which the server for which you want to display status.

• -replacelog
  Optional. If you specify this parameter, the script replaces the log file if it exists. By default the script appends to the log file if it exists.

• -trace
  Optional. If you specify this parameter, the script outputs additional trace information to the log file for the script. You should only specify this parameter if errors occur when you try to remove a node. The default is to not log additional trace information.

• -username
  This parameter is required if security is enabled for the server. The value username specifies the user name for authentication.

• -password
  This parameter is required if security is enabled for the server. The value password specifies the password for authentication.

• -help or -?
  This optional paramter prints the usage statement for the script.

Examples

These examples demonstrate correct syntax:

removeNode

This example removes the node associated with the default instance from the Network Deployment cell to which it belongs.

removeNode -instance testnode

This example removes the node associated with the testnode instance from the Network Deployment cell to which it belongs.