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.
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:
-
Within the Management Interface SSH window, at the command prompt type:
ha-status
-
Depending on whether you are logged on to the Primary or Secondary server you may see the following information presented when you run command:
SettingInformation 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 Primaryha-status
run on Secondary
An overview of your HA Pair can also be viewed in the Admin Interface > System Configuration > High Availability tab.