Add a node to a cluster 

Add a new node to an existing cluster.

Before you begin

You must already have a cluster with at least one member.

Ensure that you have installed IBM WAS Network Deployment (Application Server option) on the new node.

If you are adding a node to a Search cluster, do not use these instructions. Instead, use the instructions in the Add an additional Search node to a cluster topic.

About this task

To add a node to a cluster...


  1. Add a new node to the DM cell:

    1. Log into the new node.

    2. Open a command prompt and change to the bin directory of the local WAS profile:


        where <profile_name> is the name of the applicable WAS profile on this node.

    3. Run the addNode command to add this node to the DM cell: .

        addnode [dmgr_host] [dmgr_port] [-username uid] [-password pwd] [-localusername localuid] [-localpassword localpwd]

        where dmgr_host is the host name of the dmgr, dmgr_port is the SOAP port of the deployment manager (the default is 8879), uid and pwd are the DM administrator username and password, and localuid and localpwd are the username and password for the node's WAS administrator.

    4. Open the addNode.log file and confirm that the node was successfully added to the DM cell. The file is stored in the following location:

  2. Copy the relevant JDBC files from the DM node to this node, placing them in the same location as the JDBC files on the DM. If, for example, you copied the db2jcc.jar file from the C:\IBM\SQLLIB directory on the DM, you need to copy the same file to the C:\IBM\SQLLIB directory on this node. See the following table to determine which files to copy. See the following table to determine which files to copy:

      Table 1. JDBC files
      Database type JDBC files
      DB2 db2jcc.jar

      db2jcc_license_cu.jar sql

      Oracle ojdbc6.jar
      SQL Server sqljdbc4.jar

  3. Ensure that the shared folders that are used for the application content stores in the cluster are accessible from the new node: from the new node, try to access the shared directories.

  4. Add additional members to an existing IBM Connections cluster:

    1. Log in to the dmgr Integration Solutions Console.

    2. Click Servers>Clusters>cluster_name>Cluster members>New. Specify the following information about the new cluster member:

        Member name

          The name of the server instance that is created for the cluster. The DM will create a new server instance with this name.
          Note: Each member name in the same cluster must be unique. The Integration Solutions Console will prevent you from re-using the same member name in a cluster.

        Select node

          The node where the server instance resides.

        Click Add Member to add this member to the cluster member list.

    3. Click Next to go to the summary page where you can examine detailed information about this cluster member. Click Finish to complete this step or click Previous to modify the settings.

    4. Click Save to save the configuration.

    5. Click Server>Servers>Clusters>cluster_name>Cluster members. In the member list, click the new member that you added in the previous step.

    6. On the detailed configuration page, click Ports to expand the port information of the member. Make a note of the WC_defaulthost and WC_defaulthost_secure port numbers. For example, the WC_defaulthost port number is typically 9084, while the WC_defaulthost_secure port number is typically 9447.

    7. Click Environment>Virtual Hosts>default_host>Host Aliases>New. Enter the following information for the host alias for the WC_defaulthost port:

        Host name

          The IP address or DNS host name of the node where the new member resides.


          The port number for WC_defaulthost. For example, 9084.

        Click OK to complete the virtual host configuration.

    8. Click Save to save the configuration.

    9. Repeat the previous two sub-steps to add the host alias for the WC_defaulthost_secure port.

    10. Click System administration>Nodes.

    11. In the node list page, select all the nodes where the target cluster members reside, and then click Synchronize to perform a synchronization between the nodes.

What to do next

Configure IBM HTTP Server to connect to this node. For more information, see the Configure IBM HTTP Server and Define IBM HTTP Server for a node topics.

Repeat this task for each new node that you want to add to a cluster.

(AIX or Linux only) If you have installed the Search application on the new node, configure the path variables to point to that application. For more information, see the Setting AIX or Linux path variables for Search topic.

If you experience interoperability failure, you might be running two servers on the same host with the same name. This problem can cause the Search and News applications to fail. For more information, go to the NameNotFoundException from JNDI lookup operation web page.

Parent topic

Optional post-installation tasks

Related concepts
Configure IBM HTTP Server

Related tasks

Setting AIX or Linux path variables for Search
Install IBM WAS
Define IBM HTTP Server
Add an additional Search node to a cluster

September 20, 2011 8:26:41 AM


Sep 20, 2011 8:26:41 AM Fixed formating errors. 2 Sep 20, 2011 8:15:32 AM Fixed formating errors. 1