Verifying Successful Cluster Configuration

  1. If you are using an external Web server, start it and check for errors.

    If the server does not start, make sure that the values in the workers.properties file are correct. If you have already validated the external Web server configuration, the problem is likely in this file.

  2. Start one of the nodes, and then try to connect to it.

    If you cannot connect to the node, check the server.conf file and correct any errors you find.

  3. Start the remaining nodes in the cluster, one at a time.

    Caution: If your PPM instance includes multiple nodes in a cluster configuration, you must start these nodes one at a time. Make sure that you wait until each node is fully started before you start the next node.

  4. Use the kStatus.sh script to confirm that all server nodes are running.

    If a node is not running, check the server log files in <PPM_Home>/server/<PPM Server>/log for errors.

In addition, make sure that:

  • Multiple users logging on are automatically distributed to all nodes. Use server reports to verify which users are logged on to which nodes.

  • If you shut down a node, users logged on to the other nodes can continue to work. Users logged on to the shut down node can log on again and continue to work.

  • If more than one node in your cluster is dedicated to running services (recommended), and you shut down a services node, the services that were running on the node start on another services node. (For more information, see Services Isolation.)

    Note: If you have only one services node in a cluster, and it is shut down, the services will not run because only nodes that handle user traffic are up and running.

Disabling Nodes from Running Background Services

We recommend that, if you have a server cluster configured, and there are nodes in the cluster that do not handle incoming user requests, you disable the nodes from running the PPM background service.

To disable nodes that receive no user traffic from running background services:

  1. Stop the nodes.

    Note: For instructions on how to start and stop PPM Servers, see Starting and Stopping the PPM Server on a Single-Server System.

  2. Navigate to the <PPM_Home> directory, and then open the server.conf file in a text editor.

  3. Under PPM_HOME, do the following:

    1. To the nodes that are to receive user requests, add the following:

      com.kintana.core.server.SERVICES_ENABLED=false
    2. To the nodes that are not to receive user requests, add the following:

      com.kintana.core.server.SERVICES_ENABLED=true

      Note: For information about adding parameters to nodes in a server cluster, see @node Directive in the server.conf File .

  4. Navigate to the <PPM_Home>/bin directory, and then run the kUpdateHtml.sh script.

  5. Start the nodes.

    Tip: Wait for a few seconds between each node startup.

Tip: To restrict services to nodes that receive no user traffic, remove the service node from the workers.properties file during external web server integration configuration or remove it from hard load balancer redirection list.