The cleanupNode script

The cleanupNode script removes a node configuration from the cell repository. Use this script to clean up a node only if you have a node defined in the cell configuration, but the node no longer exists. For usage instructions and examples, see Clean up nodes in a Network Deployment instance.

Product

The cleanupNode script is available with WebSphere Application Server Network Deployment only.

Authority

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

Syntax

The syntax of the cleanupNode script is:

cleanupNode node_name [ dmgr_host ] [ dmgr_port ]
 [ -instance instance ] [ -nowait ] [ -quiet ] [ -logfile filename ]
 [ -replacelog ] [ -trace ] [ -username username ]
 [ -password password ] [-help | -?]

Parameters

The parameters of the cleanupNode script are:

• node_name
  This is a required parameter. The value node_name specifies the name of the node that you want to clean up. This value is case sensitive.

• dmgr_host
  Optional. The value dmgr_host specifies the name of the machine that hosts your Network Deployment cell. The default value is localhost.

• dmgr_port
  Optional. The value dmgr_port specifies the SOAP port for your deployment manager. If you do not specify this parameter, the script uses 8879 for the SOAP port.

• -instance
  Optional. The value instance specifies the name of the Network Deployment instance that contains the node that you want to clean up. The default value is default.

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

• -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/ND/instance/logs/cleanupNode.log where instance is the name of your Network Deployment instance.

• -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 clean up 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:

cleanupNode myNode

Removes all configuration information for the node myNode from the default Network Deployment instance.

cleanup myNode -instance TestCell

Removes all configuration information for the node myNode from the Network Deployment instance TestCell.