Monitoring a Failover Manager Cluster¶
You can configure PEM to display status information about one or more Failover Manager clusters on the Streaming Replication dashboard. Before configuring PEM to monitor a Failover Manager cluster, you must install and configure Streaming Replication and Failover Manager on the cluster.
Please note that your Streaming Replication recovery.conf file must include the following parameters:
For information about installing and configuring Failover Manager and Streaming Replication, please see the EnterpriseDB Failover Manager Guide, available at www.enterprisedb.com.
To configure PEM to monitor a Failover Manager cluster, use the PEM client to create a server definition for the master node of the Failover Manager cluster. Use the tabs on the New Server Registration dialog to specify general connection properties for the master node; use fields on the Advanced tab to specify information about the Failover Manager cluster:
- Use the EFM Cluster Name field to specify the name of the Failover Manager cluster. The cluster name is the prefix of the name of the cluster properties file. For example, if your cluster properties file is named efm.properties, your cluster name is efm.
- Use the EFM Installation Path field to specify the location of the Failover Manager binary file. By default, the Failover Manager binary file is installed in /usr/efm-2.1/bin.
After saving the server definition, the master node will be included in the list of servers under the PEM Server Directory in the PEM client Object browser tree, and will be displayed on the Global Overview dashboard. To view the Streaming Replication Analysis dashboard and the status of the Failover Manager cluster, right click on the name of the master node in the Object browser tree control and navigate through the Dashboards menu to select Streaming Replication Analysis.
Promoting a Cluster¶
Select the Replace Cluster Master menu selection on the Management menu to start the failover process. When you select Replace Cluster Master, a popup opens, asking you to confirm that you wish to replace the current master node:
Select No to exit the popup without replacing the current master node.
Select Yes to remove the current master node from the Failover Manager cluster and promote a standby node to the role of read/write master node within a Failover Manager cluster. The node with the highest promotion priority (defined in Failover Manager) will become the new master node. PEM will display a dialog, reporting the job status.
When the job completes and the Streaming Replication Analysis dashboard refreshes, you can review the Failover Manager Node Status table to confirm that a standby node has been promoted to the role of master within the Failover Manager cluster.