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 Configure an external web server. For information on how to integrate the PPM Server with an external Web server, see.Integrate an external web server with a PPM Server.

  2. Stop the PPM Server. (See Start and stop 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 Configure 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.

  14. Generate a new service for the new node, as follows:

    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.

      To create a Windows service for the nodes in a cluster, run ksvc.exe for each node in the cluster.

      Examples:

      ksvc install <Node1_Name> -kh <PPM_Home> -jh <JAVA_HOME>
      ksvc install <Node2_Name> -kh <PPM_Home> -jh <JAVA_HOME>
      ksvc install <Node3_Name> -kh <PPM_Home> -jh <JAVA_HOME>

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.