Skip to content

HA health check

The Management Interface can provide a summary and availability of a HA Pair by running the ha-status command on either the Primary or Secondary server. The HA will be marked as OK or Degraded.

If marked as Degraded, it may be due to the following:

  • A difference in configuration between the Primary and Secondary servers
  • An issue with the database replication
  • A mismatch in server versions due to only upgrading the Primary server

When HA is Degraded, a notification banner will be displayed on the Admin Interface and only cleared when the HA health check returns an OK status.

Degraded banner

An email notification will also be triggered after the HA status fails on two consecutive health check intervals and sent to users who have a valid email configured and belong to the PAM owners role group.

To view a current overview of a HA Pair:

  1. Within the Management Interface SSH window, at the command prompt type:

    ha-status

  2. Depending on whether you are logged on to the Primary or Secondary server you may see the following information presented when you run command:

    Setting
    Information presented
    Primary PAM Server Active or Demoted
    IP address
    Floating IP address IP address configured as the floating IP address for the HA Pair
    Secondary PAM Server Standby or Promoted Active
    IP address
    - this host Indicates the server you are logged onto
    High Availability status OK or Degraded
    SMB share Recommendation message is not configured
    Warning message if the share is low on disk space. Triggered when the share is 80% full

    Example: The following shows the overview of a typical BAU HA Pair with an:

    • Active Primary
    • Standby Secondary
    • Floating IP address
    • Host logged onto

    ha-status run on Primary Active Primary overview

    ha-status run on Secondary Standby Secondary overview

An overview of your HA Pair can also be viewed in the Admin Interface > System Configuration > High Availability tab.

High Availability tab