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:
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.
Stop the PPM Server. (See Starting and Stopping the PPM Server on a Single-Server System.)
Stop the external Web server.
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.
workers.propertiesfile to include relevant information about the nodes in the cluster. (See Configuring the Workers Properties File.)
server.conffile to include an
@nodedirective for each node in the cluster, including those hosted on different machines.
If the nodes in the cluster are running on different machines, specify the
>server configuration directive for each
Note: You must specify the
BASE_LOG_DIR, REPORT_DIR, ATTACHMENT_DIRNAME,and
TRANSFER_PATH.The rest of the log directories are derived from these four directories. Consider specifying these before the first
@nodeso that you do not have to specify them in each and every
On a Windows system, you must use the UNC format. You cannot use the local shared drive letter. Use forward slashes.
To enable a node to share these directories, you must start the PPM Windows services using the PPM user account that has read and write permission on the shared host.
On a UNIX system, you must NFS-mount the shared directories locally with the same directory structure.
server.conffile, before the first
@nodedirective, add the cluster-specific parameters listed in Server parameters required for server clustering.
@nodedirective, do the following:
Set values for the parameters listed in Table 1. Server configuration parameters affected by clustering (External Web Server, Multiple Machines column). The values should be the same for all nodes in the cluster.
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, PPM provides port set values that you can use for up to five separate nodes in a cluster. These port sets are listed in Sample Port Sets.)
To apply the changes to all nodes on the machine that are part of the cluster, from
After you configure the first server to include all additional nodes, copy the entire
<PPM_Home>/serverdirectory from machine1 to machine2, to the
BASE_PATHdefined in the
Zip the file, send it using FTP, and then unzip it at the destination.
After you copy the file, change the directory to
<PPM_Home>/serveron the new machine, and then rename the
The server name must match the value set for the
The directories on machine1 could be:
<PPM_Home>+ server/ + node1
The directories on machine2 could be:
<PPM_Home>+ server/ + node2
Put a new license on machine2, as required by the new IP address.
kUpdateHtml.shon both host machines to apply the
Start the PPM Server using the Windows service.
In a multiple-machine configuration, you must generate the services on all machines running Windows.
Generate a new service for the new node, as follows:
The configuration wizard starts up.
Select Configure Windows Services.
Follow the prompts to create the service.
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.