FreeKB - IBM WebSphere Remove (unfederate) a node from network deployment manager (removeNode)
IBM WebSphere - Remove (unfederate) a node from network deployment manager (removeNode)

The removal of a node that has been federated into a deployment manager will NOT delete the nodes application servers. The removal of a node from a deployment manager simply unfederates the node from the deployment manager. The node can still be managed via command line tools or via the nodes stand alone admin console.

Backup the node profile

If the cell is running on a Linux system, it's a good idea to backup the node profile prior to unfederating the node from the cell, so that the node profile can easily be restored, if needed. The command can be used to backup the node profile. -backupProfile -profileName profile001 -backupFile profile001.backup vs.

If the node was created via the command, then the command can be used to unfederate the node from the cell.

If the node was created via the command, I think the only way to unfederate the node from the cell is via the admin console, because the -delete command would delete the profile.

Using the WebSphere admin console

  1. In the WebSphere admin console, expand System Administration and select Nodes.
  2. Checkmark the node you want to remove and select Remove Node.

If Remove Node fails to remove the node, you can try using Force Delete. Don't worry, Force Delete will not delete the node. Force Delete is just a more aggressive removal of the node from the dmgr.

  1. Select OK.
  2. Select Save.

Using the command line (

You will run this command from the system that contains the node that you want to remove from the deployment manager (e.g. the node server). Only user accounts that have the Administrator role are permitted to run the removeNode command. This will stop the node agent and the application servers (aka JVMs) in the node.



There will be a prompt to provide a username and password. Use a username and password of a user that has the Administrator or Operator role on the deployment manager.

Username: deployment_manager_username
Password: deployment_manager_password


Or the -username and -password command line options can be used.

${WAS_INSTALL_ROOT}/profiles/your_profile/bin/ -username john.doe -password itsasecret


Be aware that after you remove the node from the dmgr, some references to the node will remain. You can use the cleanupNode.bat (Windows) or (Linux) command on the dmgr to remove the references to the node.

${WAS_INSTALL_ROOT}/profiles/your_profile/bin/ your_node -profileName your_profile


If the removal of the node is successful, something like this should be displayed.

ADMU2024I: Removal of node node01 is complete.


Add a Comment

We will never share your name or email with anyone. Enter your email if you would like to be notified when we respond to your comment.

Please enter f266f in the box below so that we can be sure you are a human.


Web design by yours truely - me, myself, and I   |   |