Adding a new node to an existing cluster

To add a new node member to an existing IBM® WebSphere® Application Server cluster on which InfoSphere® MDM is installed, you must configure the node-cluster relationship by running the configureNewNodeInCluster madconfig target.

About this task

When you add a new node to an existing WebSphere Application Server cluster on which InfoSphere MDM is configured, you must create the node, attach it to the deployment manager, and then configure the server and the database. The configuration is automated using the configureNewNodeInCluster madconfig target.

The new node can be configured on a separate machine or on one that already has one or more existing profiles.

Procedure

  1. Create a new WebSphere Application Server node and attach it to an existing WebSphere Application Server deployment manager (Dmgr) by running the following command from a command line on the application server:
    cd /opt/IBM/WebSphere/AppServer/bin
    ./manageprofiles.sh -create -profileName PROFILE_NAME –profilePath /opt/IBM/WebSphere/AppServer/profiles/PROFILE_NAME –templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/managed –federateLater false -dmgrAdminUserName USER_NAME -dmgrAdminPassword PASSWORD –dmgrHost DMGR_HOST -dmgrPort DMGR_PORT
    Replace the variables in the command with the appropriate profile name, path, user name, password, Dmgr host, and Dmgr port for your deployment. For example:
    cd /opt/IBM/WebSphere/AppServer/bin
    cd /opt/IBM/WebSphere/AppServer/bin
    ./manageprofiles.sh -create -profileName AppSrv03 –profilePath /opt/IBM/WebSphere/AppServer/profiles/AppSrv03 –templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/managed –federateLater false -dmgrAdminUserName perf01 -dmgrAdminPassword perf01 –dmgrHost perf01host -dmgrPort 8879
    When the command completes, the new node will appear in the WebSphere Application Server Integrated Solutions Console (admin console).
  2. Open the WebSphere Application Server Integrated Solutions Console and navigate to System administration > Nodes to confirm that the new node is present.
  3. Add a new server instance to the cluster on the new node.
    Assuming that the name of the cluster is MDMCluster:
    1. In the WebSphere Application Server Integrated Solutions Console, navigate to WebSphere application server clusters > MDMCluster > Cluster members and click New.
    2. Give a name to the new member, select the new node from the list, then save and synchronize the settings.
    3. Navigate to WebSphere application server clusters > MDMCluster > Cluster members to confirm that the new member is present in the list of nodes.
  4. In in the WebSphere Application Server Integrated Solutions Console, provide a database driver path value for your new node.
    1. Navigate to Environment > WebSphere Variables
    2. Set the scope to the newly added node.
    3. Provide the database driver path value:
      • When the database type is IBM Db2®, provide a value for DB2_JDBC_DRIVER_PATH.
      • When the database type is Oracle, provide a value for ORACLE_JDBC_DRIVER_PATH.
      • When the database type is Microsoft SQL Server, provide a value for MSSQL_SERVER_JDBC_DRIVER_PATH.
  5. Start all of the nodes and cluster members.
  6. If the server where the new node resides uses a Microsoft Windows operating system, create an ODBC data source.
    1. In the WebSphere Application Server Integrated Solutions Console, go to <WAS_PROFILE_DIR>/installedApps/<CELL>/MDM-native-<INSTANCE_ID>.ear/native.war/scripts.
    2. Run the following commands:
      madconfig register_odbc
      madconfig create_datasource -Dmad.db.dsn=<DATABASE_NAME>_<INSTANCE_ID>
    3. Provide the following input values as prompted by the script:
      • database host
      • port
      • name
      • user
      • password
  7. Run the configureNewNodeInCluster madconfig script:
    1. Go to <MDM_INSTALL_HOME>/mds/scripts.
    2. Run the madconfig script:
      • For Microsoft Windows systems, run the following command:
        madconfig configureNewNodeInCluster
      • For UNIX based systems, run the following command:
        ./madconfig.sh configureNewNodeInCluster
    3. The configureNewNodeInCluster madconfig target requests values for the following parameters:
      • Node name
      • Name of the new member added to the cluster
      • WebSphere Application Server password
      • Database password
      • Trust file password
      Note: The script reads other required values from the <MDM_INSTALL_HOME>/properties/mdm_install.properties file.

Results

After receiving the parameter values, the configureNewNodeInCluster madconfig target performs the following operations:

  • Installs the InfoSphere MDM operational server on the newly added member by invoking the install_native_engine_ear madconfig target. This target also creates the MDM data source.
  • Configures the newly added cluster member by adding the JVM level configuration, populating the WebSphere variables.
  • Synchronizes the nodes in the server deployment to reflect the user security for InfoSphere MDM by invoking the full_sync madconfig target.
  • Adds the details of the new member to the APPINSTANCE and CONFIGELEMENT tables.
  • Restarts the cluster.