External Web Server, Multiple Machines

In a server cluster, a <PPM_Home> directory must reside on each machine, each with a server running against the same database.

To set up a cluster with an external Web server on multiple machines:

  1. Install the PPM Server on the first machine in the cluster and configure it so that it is integrated with an external Web server.

    Note: For information about how to configure a machine for integration with an external Web server, see Configuring an External Web Server. For information on how to integrate the PPM Server with an external Web server, see.Integrating an External Web Server with a PPM Server.

  2. Stop the PPM Server. (See Starting and Stopping the PPM Server on a Single-Server System.)

  3. Stop the external Web server.

  4. Make sure that the common directories that the servers use (<PPM_Home>/logs, <PPM_Home>/reports, <PPM_Home>/attachments, and <PPM_Home>/transfers) are shared.

    Note: Set the permissions for the shared directories so that users of each machine in the cluster can read from and write to them.

  5. Modify the workers.properties file to include relevant information about the nodes in the cluster. (See Configuring the Workers Properties File.)

  6. Modify the server.conf file to include an @node directive for each node in the cluster, including those hosted on different machines.

  7. In the server.conf file, before the first @node directive, add the cluster-specific parameters listed in Server Parameters Required for Server Clustering.

  8. To apply the changes to all nodes on the machine that are part of the cluster, from <PPM_Home>/bin, run kUpdateHtml.sh.

  9. After you configure the first server to include all additional nodes, copy the entire <PPM_Home>/server directory from machine1 to machine2, to the BASE_PATH defined in the @node directive.

  10. Zip the file, send it using FTP, and then unzip it at the destination.

  11. Put a new license on machine2, as required by the new IP address.

  12. Run kUpdateHtml.sh on both host machines to apply the server.conf changes.

  13. Start the PPM Server using the Windows service.

    In a multiple-machine configuration, you must generate the services on all machines running Windows.

Note: The keys in the security directory are required to read encrypted values in server.conf and the database. The same keys must be present on all nodes in the cluster.