FreeKB - Add (federate) a remote node to a WebSphere network deployment manager
Add (federate) a remote node to a WebSphere network deployment manager

Home > Search


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.

 


Firewall

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, "example.com" 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/addNode.sh example.com 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

 

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/addNode.sh example.com 8879 -noagent

 


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.

 



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




Comments


August 12th, 2019 by Paolo Supino
In the nodes screen above in the 'version' column there is 'Base 9.0.0.6' and 'ND 9.0.0.6' (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).