Using the Cluster Support Plug-in

Learn how to manage a container as part of a cluster in Policy Manager.

Using Admin Console Managing Containers

Supported Platforms: 7.1, 7.2, 8.0

Table of Contents

  1. Introduction
  2. Configuration

Introduction

The Cluster Support plug-in provides support for group administration of multiple containers via a single Administration Console. The clustering feature is based on the idea of a Master node and a set of Slave nodes that all share a common set of feature bundles and configuration. When the clustering feature is installed, any Container Instance may be configured as either a Master or Slave. All Slaves will periodically synchronize their state with the Master node. If the Master node becomes unavailable for any reason, the slaves will remain in their last configured state.

Here's how it works:

The Cluster Support plug-in should be installed into a Master and Slave Container instance using the Administration Console. When the installation is complete, navigate to the Configuration tab, select the com.soa.cluster category, configure the master and slave nodes, and click Save.

Master Node

On the Master node, select the Act as a master node radio button.

Slave Node

For a Slave node, select Act as a slave node, and enter the "Master Hostname" and "Master Port" of the Master Node in the text boxes. Any number of Slave Nodes can use a single master.

Advanced Option

The Advanced configuration option is only required in cases where specific configuration PIDs (i.e., Process Identifiers) should not be replicated between cluster nodes.

Refer to the Policy Manager Configuration Categories and Settings Guide for a description of each configuration category.

Note: This is an is an advanced Policy Manager feature. Contact Customer Support if you need assistance using this advanced option.

Back to top

Configuration

To use the Cluster Support plug-in you will need two Policy Manager containers (one that will be designated as Master and one that will be designated as Slave).

Prerequisites
  • Platform version 7.1 or above must be installed.
Step 1: Configure Policy Manager "Master" Container
  1. Launch the Configure Container Instance Wizard - <release directory>\bin\startup configurator
  2. Define the Policy Manager "Master" container (PM).
  3. In the Administration Console, select Available Features > Features filter, and install the Policy Manager features (Policy Manager Services and Policy Manager Console).
  4. Select Available Features > Plug-in filter, and install Cluster Support. Do not configure keys as this step was already performed when you installed the two Policy Manager features.
  5. Select the Configuration tab. In the Configuration Categories section, select com.soa.cluster.
  6. Select Act as master node and save.
  7. Select com.soa.database.config (as illustrated below), click Add Property, add encryptValues=false, click Apply, then Apply Changes.


  8. Restart the Policy Manager container instance (System tab > Restart).
  9. After the container restart is complete, log back into the Administration console, and select the Configuration tab. In the Configuration Categories section, select com.soa.database.config.
  10. Update the database password (as illustrated below), and Apply Changes.


Step 2: Configure Policy Manager "Slave" Container
  1. Launch the Configure Container Instance Wizard - <release directory>\bin\startup configurator
  2. Define the Policy Manager "Slave" container (PM1).
  3. In the Administration Console, select Available Features > Plug-in filter, and install Cluster Support. Do not install the two Policy Manager features in this container.
  4. Select the Configuration tab. In the Configuration Categories section, select com.soa.cluster.
  5. Select Act as slave node, enter Host (PM) and Port, then save.

Back to top