Failover setup (2.7)

Configuration Article | CA-20230509-MF-01

VDG Sense | Setup | Failover

 

Introduction

This article explains the function of the Failover tab. For more information about Failover please read this article: https://tkhsecurity.atlassian.net/wiki/spaces/KB/pages/9168945685/How+failover+works .

The Failover tab holds configuration for the following items:

  • The servers which need to be monitored

  • The clients which need to be informed when a server has been taken over

  • Configuration for Failover functions

  • Status information

Limitations

  • A Failover server can take over 1 server, this means if the failover server is already taking over a failing server and another server fails, this server cannot be taken over

  • Only 1 Failover server per Master-Slave configuration is supported

Server configuration

The Servers tab contain the monitored servers and corresponding settings for the selected server.

 

The selected server has the following settings:

  • Host

    • The IP address of the monitored server

  • Port

    • prefined, cannot be changed

  • Is Master

    • Define if the server is the management server.

  • Cluster name

    • For future use, should be the same for all servers and clients

  • Username / password

    • credentials to login to server

  • Database config

    • The database configuration of the selected server

  • Automatically take over server

    • If enabled the Failover server will automatically take over a server

  • Take over

    • Take over the selected server

  • Automatically restore server

    • If enabled the Failover server will automatically restore a server

  • Restore

    • Restore failover server to default state

  • Backup Button '+”

    • To create a new backup of the selected server press the + button. 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

 

To add a server to the serverlist click the ‘+’-button.

  • Host

    • The IP address of the monitored server

  • Port

    • prefined, cannot be changed

  • Username / password

    • credentials to login to server

Client configuration

The Clients tab contains the clients which need to be informed that a server has been taken over. This is required because the clients in that list are instructed to login by the failover server. If clients are not in this list and a server fails, the client keeps showing ‘server lost’ as it is unware of the failed server which has been taken over.

 

To add a client to the client list click the ‘+’-button.

  • Host

    • The IP address of the monitored server

  • Port

    • prefined, cannot be changed

  • Cluster name

    • For future use, should be the same for all servers and clients

Settings

 

  • 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 to Failover Address

    • The IP address of the network adapter of the failover server. This is used in a failover situation for the other servers to communicate with the failover server.

  • Client to Failover Address

    • The IP address of the network adapter for the client of the failover server. This is used in a failover situation for the clients to communicate with the failover server.

  • Daily backup time

    • Time when the settings backup needs to take place. This wil by in UTC time.

  • Failover Database Config

    • The (postgres) database credentials of the failover server

Timeouts

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

 

Type

Default value

Min value

Max value

Description

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.

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 in the server tab.

You can fill in the parameter under the advanced tab of the server.

 

  • Failover storepath

    • The storepath of the Failover : \\<Failover server address>\<monitored server address>

  • Failover OS username

    • The Operating System username of the Failover server

  • Failover OS password
    The Operating System password of the Failover server