How to setup backup connection

Owned by Andrei Bakhteev (Unlicensed)
Last updated: Nov 09, 2018 by AntonA (Unlicensed)
2 min read


Overview

FIXEdge server configuration allows switching between two endpoints of initiator FIX-session (Primary and Backup) when connection is lost.

Switching to the backup connection


The primary connection has been lost → switching to the backup connection

It is possible to configure Initiator FIX Session when FIXEdge in case of a disconnection will connect to the Backup Server. Use the following parameters to set the backup connection:

FIXEdge.properties
FixLayer.FixEngine.Session.MySession.EnableAutoSwitchToBackupConnection = true
FixLayer.FixEngine.Session.MySession.Backup.Host = <backup server host>
FixLayer.FixEngine.Session.MySession.Backup.Port = <backup server port>

Only one backup connection is supported.

Switching back to the primary connection

If the Backup Server crashes or the connection is broken, to restore the FIX Session to the Primary Server, you need to specify the property EnableAutoSwitchToBackupConnection = true for Backup FIX Session too.

The backup connection has been lost → switching back to the primary connection

FIXEdge.properties
FixLayer.FixEngine.Session.MySession.EnableAutoSwitchToBackupConnection = true
FixLayer.FixEngine.Session.MySession.Backup.EnableAutoSwitchToBackupConnection = true
FixLayer.FixEngine.Session.MySession.Backup.Host = <backup server host>
FixLayer.FixEngine.Session.MySession.Backup.Port = <backup server port>

Cyclic reconnection

That FIXEdge continued connection attempts when the Primary and Backup Servers are not available, use EnableCyclicSwitchBackupConnection parameter. The EnableCyclicSwitchBackupConnection parameter is set for the Primary and Backup FIX Sessions:

FIXEdge.properties
FixLayer.FixEngine.Session.MySession.EnableAutoSwitchToBackupConnection = true
FixLayer.FixEngine.Session.MySession.EnableCyclicSwitchBackupConnection = true
FixLayer.FixEngine.Session.MySession.Backup.EnableAutoSwitchToBackupConnection = true
FixLayer.FixEngine.Session.MySession.Backup.EnableCyclicSwitchBackupConnection = true
FixLayer.FixEngine.Session.MySession.Backup.Host = <backup server host>
FixLayer.FixEngine.Session.MySession.Backup.Port = <backup server port>

Message sequence numbers reset

If Backup/Primary Server will start FIX Session from MsgSeqNum(34)=1,  set ForceSeqNumReset parameter. MsgSeqNum(34) will reset on each Logon to Primary or Backup Servers (cyclic reconnection):

FIXEdge.properties
FixLayer.FixEngine.Session.MySession.EnableAutoSwitchToBackupConnection = true
FixLayer.FixEngine.Session.MySession.EnableCyclicSwitchBackupConnection = true
FixLayer.FixEngine.Session.MySession.ForceSeqNumReset = 2
FixLayer.FixEngine.Session.MySession.Backup.EnableAutoSwitchToBackupConnection = true
FixLayer.FixEngine.Session.MySession.Backup.EnableCyclicSwitchBackupConnection = true
FixLayer.FixEngine.Session.MySession.Backup.ForceSeqNumReset = 2
FixLayer.FixEngine.Session.MySession.Backup.Host = <backup server host>
FixLayer.FixEngine.Session.MySession.Backup.Port = <backup server port>