IBM WebSphere - Add (federate) a node into network deployment manager (addNode)

In a WebSphere application server (WAS), a node contains one or more application servers (aka JVMs). In IHS, a node contains the web server. There are two types of nodes - a managed node and an unmanaged node. A managed node is a node that contains an application server. A managed node has a node agent or administrative agent to manage its servers, and an unmanaged node does not.

Adding nodes to a network deployment manager allows you to control certain things on the node. Adding a node to a dmgr is known as "federating a node." For example, you can start or stop the application server, start or stop the web server, start or stop an application, and deploy a new application to the application server.



If you have a firewall between your dmgr and node server, such as iptable or firewalld (Linux), the SOAP port and CELL_DISCOVERY_ADDRESS ports must be opened, as these ports are used for communication between the dgmr and node agent servers. By default, 8879 is the SOAP port and 7277 is the CELL_DISCOVERY_ADDRESS port. If you have to update your firewall to allow access to the SOAP port and CELL_DISCOVERY_ADRESS port, you will probably need to restart the dgmr. Cell discovery is how the dmgr discovers the node agent.


Using the command line

The addNode command is used to federate a WAS node into the dmgr. You will invoke the addNode script from the server that contains the WAS node that you want to add to the deployment manager. Only user account that have the Administrator or Configurator role are permitted to run the addNode command. In this example, "" is the hostname of the deployment manager, and 8879 is the SOAP port of the deployment manager. It is usually best to use the -includeapps options, to ensure that the applications in the node are included, and that the correct version of the app is included.

${WAS_INSTALL_ROOT}/profiles/your_profile/bin/ 8879 -includeapps


If administrative security is enable and your username and password are not defined in the soap.client.props file, there will be a prompt to provide a username and password. Use the username and password of the deployment manager.

Username: deployment_manager_username
Password: deployment_manager_password


There will be another prompt to provide a username and password. Use the username and password for the node.

Username: node_username
Password: node_password


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

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


By default, the application server will be restarted when it is federated into the deployment manager. The -noagent option can be used to not restart the application server.

${WAS_INSTALL_ROOT}/profiles/your_profile/bin/ 8879 -noagent


If the federation is successful, the followiing should be displayed.

ADMU0003I: Node node01 has been successfully federated.


web console - managed node

Be aware that this will restart the remote application server.

  1. In the network deployment manager (dmgr) web console, expand System Administration and select Nodes.
  2. Select Add Node.
  3. Select Managed node.

  1. Enter the hostname, port, username, and password of the remote node, check Include applications, and select OK.


web console - unmanaged node

In the network deployment manager (dmgr) web console, expand System Administration and select Nodes. Select Add Node. Select Unmanaged node.


Enter any name you want for name and the hostname of the server that contains the unmanaged node. Select OK.


The unmanaged node should now be include in the Nodes. Be aware that this does not establish communication between the dmgr and unmanaged node. 


If the unmanaged node is an IHS web server, refer to one of these articles for the steps on how to establish communication between the dmgr and web server.


In this example, there are 3 managed nodes (node01 node02 was1CellManager1) and 1 unmanaged node (IHS).  Notice that only managed nodes display a status and can be synchronized.


Did you find this article helpful?

If so, consider buying me a coffee over at Buy Me A Coffee

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 490d0 in the box below so that we can be sure you are a human.


August 12th, 2019 by Paolo Supino
In the nodes screen above in the 'version' column there is 'Base' and 'ND' (I noticed the same on our WebSphere installations. The question: What is the difference between a node with version "Base ...." and "ND ...."?

August 13th, 2019 by Jeremy (moderator)
BASE is a stand alone WebSphere application server. ND stands for Network Deploy and is the deployment manager (dmgr).

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