Run the Health Probe to Check the Server Status

Each ActivID AS instance is deployed with a Health Probe service providing the status of the server. This service is designed to help a load balancer check the status of the deployed set of ActivID Authentication Servers.

To access the ActivID AS Health Probe service, go to:

https://<hostname>:<port>/AIHealthCheck/probe

Where:

  • <hostname> − Hostname of the ActivID Authentication Server
  • <port> − HTTPs port number of the ActivID Authentication Server

The possible codes returned by the service are:

  • HTTP Status-Code 200 − OK - the ActivID AS is functional
  • HTTP Status-Code 503 − Service is unavailable - the ActivID AS is not functional (the database is down, the HSM is failing, the server is stopping, …)

You can view the status code returned by the probe using the following command:

Copy 
curl -i https://<hostname>:<port>/AIHealthCheck/probe

It might also timeout if the server is not available.

The status is refreshed every seven seconds (the minimum interval).

If there is an issue, the watchdogs integrated in ActivID AS will restart the applications to recover the service and, if necessary, restart the ActivID AS itself.

In a load balancing configuration, if one of the servers is not functioning, the requests will stop being sent to this server. Network monitoring software will use the probe to switch the traffic to the other ActivID AS while the original ActivID AS is not working as expected.