IBM Business Process Manager, V8.0.1, All platforms > Reference > Commands and scripts > Command-line utilities > configureNode command-line utility > configureNode examples

Example: Multiple machines hosting the deployment manager and three nodes: Advanced, PS, DB2

Use the configureNode command-line utility to create a Process Server topology for IBM Business Process Manager Advanced with a deployment manager and three nodes on four different machines, using a DB2 database.

This example assumes that you have four machines and you want to create the following configuration:

Machine Node Messaging cluster Support cluster Application target cluster Web cluster
M03 Dmgr - - -  
M04 Node01 1 0 1 0
M05 Node02 0 1 0 1
M06 Node03 1 1 1 1

Procedure

  1. Copy the following sample properties files:

    • install_root/util/ndUtils/std/samples/sample_adv_ps_dmgr.properties

    • install_root/util/ndUtils/std/samples/sample_adv_ps_node.properties

  2. Create a new deployment manager file, for example adv_dmgr.properties and three custom node files, for example node01.properties, node02.properties, and node03.properties. Update the files with the required values.

    Important: If you are using an Oracle database instead of a DB2 database, you must include the database user name and password for all databases, including the optional ones. The database user name must be different for each database.

    Example of deployment manager file:

    # filename: adv_dmgr.properties
    
    server.type = PS       # Process Center (PCS) or Process Server (PS)
    
    # Dmgr setting
    hostName=M03.ibm.com
    adminUserName=admin
    adminPassword=admin
    
    nodeName=Dmgr
    initialPortAssignment=12030
    
    # Environment settings environment.type = Test
    processCenterURL= http://M01:9080 #(optional, if not set, the environment is offline PS)
    repository.user = admin #(optional, if not set, the environment is offline PS)
    repository.credential = admin #(optional, if not set, the environment is offline PS)
    
    # Database settings dbType=DB2	
    dbServerName=M01
    dbPortNumber=50000
    
    # DB for Process Server
    prcsvr.dbName = BPMDB2
    prcsvr.dbUserName = bpmadmin
    prcsvr.dbPassword = s0m3passw0rd
    
    # DB for Performance Data Warehouse perfDW.dbName = PDWDB2
    perfDW.dbUserName = bpmadmin
    perfDW.dbPassword = s0m3passw0rd
    
    # DB for Common DB
    cmn.dbName=CMNDB2
    cmn.dbUserName=bpmadmin
    cmn.dbPassword=s0m3passw0rd
    
    # DB for Business Process Choreographer bpc.dbName=BPEDB2
    bpc.dbUserName=s0m3passw0rd
    bpc.dbPassword=bpmadmin
    

    Examples of custom node files:

    # filename: node01.properties
    
    nodeName=Node01
    initialPortAssignment=12809
    
    # Basic Install environment information
    server.type = PS       # Process Center (PCS) or Process Server (PS)
    install.type = Advanced # Optional
    
    #Install clusters on this node
    install.cluster.support = 1
    install.cluster.AppTarget = 1 
    install.cluster.message = 0
    install.cluster.web = 0
    
    # Database settings dbType=DB2	
    
    # Deployment Manager Properties
    dmgr.hostName=M03.ibm.com
    dmgr.adminUserName=admin
    dmgr.adminPassword=admin
    dmgr.initialPortAssignment=12030
    
    # filename: node02.properties
    
    nodeName=Node02
    initialPortAssignment=14809
    
    # Basic Install environment information
    server.type = PS       # Process Center (PCS) or Process Server (PS)
    install.type = Advanced # Optional
    
    #Install clusters on this node
    install.cluster.support = 0
    install.cluster.AppTarget = 0
    install.cluster.message = 1
    install.cluster.web = 1
    
    # Database settings dbType=DB2	
    
    # Deployment Manager Properties
    dmgr.hostName=M03.ibm.com
    dmgr.adminUserName=admin
    dmgr.adminPassword=admin
    dmgr.initialPortAssignment=12030
    
    # filename: node03.properties
    
    nodeName=Node03
    initialPortAssignment=16809
    
    # Basic Install environment information
    server.type = PS       # Process Center (PCS) or Process Server (PS)
    install.type = Advanced # Optional
    
    #Install clusters on this node
    install.cluster.support = 1
    install.cluster.AppTarget = 1
    install.cluster.message = 1
    install.cluster.web = 1
    
    # Database settings dbType=DB2	
    
    # Deployment Manager Properties
    dmgr.hostName=M03.ibm.com
    dmgr.adminUserName=admin
    dmgr.adminPassword=admin
    dmgr.initialPortAssignment=12030
    

  3. Run the configureNode command on the four machines.

    1. Log on to machine M03 and run the following command:

      • install_root\util\ndUtils\configureNode.bat -dmgr_response adv_dmgr.properties

      • install_root/util/ndUtils/configureNode.sh -dmgr_response adv_dmgr.properties

    2. Log on to machine M04 and run the following command:

      • install_root\util\ndUtils\configureNode.bat -response node01.properties

      • install_root/util/ndUtils/configureNode.sh -response node01.properties

    3. Log on to machine M05 and run the following command:

      • install_root\util\ndUtils\configureNode.bat -response node02.properties

      • install_root/util/ndUtils/configureNode.sh -response node02.properties

    4. Log on to machine M06 and run the following command:

      • install_root\util\ndUtils\configureNode.bat -response node03.properties

      • install_root/util/ndUtils/configureNode.sh -response node03.properties

Parent topic: configureNode examples