External web server, single machine

To set up a cluster with an external Web server on a single machine:

  1. Stop the PPM Server. (See Start and stop the PPM Server on a single-server system).

  2. Stop the external Web server.

  3. Modify the workers.properties file to include relevant information about the nodes in the cluster. (See Configure the Workers Properties file.)

  4. Create the <PPM_Home>/server directory.

    Make a copy of the first server directory (the entire directory) at the same level as the first.

    Example:

    <PPM_Home>
+ server
    + node1
    + node2

    Note: Use the value specified for the KINTANA_SERVER_NAME parameter in the server.conf file that corresponds to the subdirectory node for that system.

  5. Open the server.conf file in a text editor and add an @node directive for each node.

  6. Before the first @node directive, add the cluster-specific parameters listed in Server parameters required for server clustering.

  7. After each @node directive, do the following:

    1. Set values for the parameters listed in Table 1. Server configuration parameters affected by clustering (External Web Server, Single Machine column). The values should be the same for all nodes in the cluster.

    2. Add and specify unique values for the parameters described in Table 3. Required node-specific parameter for multiple nodes on a single host.

      For your convenience, the table in Sample Port Sets lists port set values that you can use for up to five separate nodes in a cluster. (These are simply here only for your convenience. You can use any available port numbers you want.)

  8. To apply the changes to all the servers in the cluster, from <PPM_Home>/bin, run kUpdateHtml.sh.

  9. If the PPM Server is running in a Windows environment, start it using the Windows service called "PPM Server_name," where <Server_Name> is the value of the KINTANA_SERVER_NAME parameter for the node in the cluster.

  10. Generate a new service for the new node.

    1. Open a command prompt, and then change to the <PPM_Home>\bin directory.

    2. Run ksvc.exe, as follows:

      ksvc install <PPM_Server_Name> -kh <PPM_Home> -jh <JAVA_HOME>

    Note: The value of <PPM_Server_Name> is the same as the value set for the KINTANA_SERVER_NAME parameter in the server.conf file.

  11. To validate the cluster, use the procedure provided in Verifying Successful Cluster Configuration.