Failover setup

Knowledge Base - Failover
2.6.1 - 30/07/2019
Print

Introduction

This article explains the function of the Failover tab. The Failover tab shows the list of configured Failover servers on the left side, the list of monitored server of the selected Failover server  in the middle and the configuration of the selected failover server on the right side. In the lower left corner of the screen are plus and minus buttons are there to add or remove failover servers or to add and remove monitored servers.

See below for an example of a failover server and associated monitored servers, in this case the failover server is monitoring two servers:

Cluster configuration

Before configuring a failover server, the server must be part of the cluster of the servers it wants to monitor. This is needed to be able to receive the settings from these servers. . To add the failover to the cluster, follow the same steps as adding a slave server to the cluster installation. Add the failover server to the management server-list and join the cluster setup by clicking the JOIN button.

For more information about cluster setup, visit the Cluster configuration article.

After joining the cluster, remove the Failover server from the server list.

 

Servers

To add a server to the monitored server list, open the Failover tab in the Configuration, and select the “Servers” subtab. Below the list, click the ‘+’-button to add a server to the list.

The selected server has the following settings:

  • Host/Port
    The IP address + port of the monitored server. The port by default is 51410.
  • HTTP Port
    The NGINX port on the server. The port by default is 443.
  • Authorization button
    The authorization status of the monitored server. This is used for the failover to correctly login on the failed server. To authorize the failover server, click the “Authorize” button and fill in the administrator credentials. To deauthorize, click the button after a successful authorization.

  • Backup Button
    Create a new backup of the selected server. The last backup will be used for the failed server. Automatic back-ups can be configured in the Options menu, but when adding a server for the first time, a manual back-up is required

 

 

Options

  • Backup Directory
    The path of the folder that contains the monitored server backups
  • Store Path
    The path of the folder that will contain video storage while failover is active
  • Server Communication Address
    The IP address of the network adapter for the server.
  • Server Communication Port
    The port the Video Manager listens on
  • Client Communication Address
    The IP address of the network adapter for the client
  • OpenAPI Host / Port
    The IP and port address of NGINX
  • Daily Backup
    Enable or disable daily backup of settings. It is recommended to enable this setting as this will ensure the Failover server always has the latest settings.
  • UTC time
    Time when the settings backup needs to take place in UTC
  • Automatically take over server
    If enabled the failover server will automatically takeover the monitored server which has failed. If disabled, the failover take over must be done manually.
  • Automatically restore server
    If enabled the failover server will automatically restore the original configuration when the monitored server is restored. If disabled, the failover restore must be done manually.

 

Timeouts

In the Timeouts subtab, you can set the timeout values of various failed states.

Type Default value Min value Max value Description
Connected 5 minutes 5 minutes 60 minutes A network connection has been made, but the first startup message has not been received
Started 5 minutes 5 minutes 60 minutes The startup message has been received, but the first keep-alive message has not been received
Keep alive 30 seconds 30 seconds 300 seconds No new keep-alive message is received
Normal shutdown 15 minutes 5 minutes 60 minutes The server has been shutdown normally, but has not restarted yet
Abnormal shutdown 5 minutes 5 minutes 60 minutes The server has exited with an error and has not restarted yet

Status

The status tab shows a log of the Failover and which servers are being monitored. To manually take over a server, click the  “Takeover” button. Choose the server which you would like to Takeover in the dialog and click “OK”. This will start the failover procedure regardless of the current server connection status.

To manually restore the server. Click the button  “Restore” after the takeover procedure has been completed.

 

 

Storage

To access the recorded videodata on the failover server, the monitored server needs to know where to find it. This is done by adding a configuration parameter to the file ‘DivaServer.ini’ for DIVA or ‘SenseVideoManager.ini’ for Sense, which can be found in the server settings folder.

The syntax of the configuration parameter is as follows:

[FailoverStorePath]

Value=<Failover server address><monitored server address>

For example if the Failover server has IP address ‘192.168.204.151’ and the monitored server has IP address ‘192.168.205.2’ the configuration option in DivaServer.ini / SenseVideoManager.ini on the monitored server looks like this:

Failover_settings_5

Plugin

For more information about configuring the Failover plugin, click here.


Related articles

Failover