FIXEdge Java 1.11.0 and Later: Quick setup

Owned by Leeza Gavronsky (Unlicensed)
Last updated: Dec 09, 2024 by author

FIXEdge Java packages are cluster ready. Minimal changes are required.

Please refer to the Quick Start Guide for installation instructions and setup several nodes on different boxes. After installation, update the configuration

  1. Define a unique node name for each instance (conf/cluster.xml):

    <instance-name>fej1</instance-name>

  2. (Optional) If Hazelcast Split Brain Protection mechanism must be used, then it is required to enable it and define the minimum number of machines required in a cluster for the cluster to remain in an operational state (conf/cluster.xml):

    <split-brain-protection name="fixedgeJQuorum" enabled="true"> 
	<minimum-cluster-size>2</minimum-cluster-size>
</split-brain-protection>

    Please note that the minimum value for minimum-cluster-size is 2.

  3. Modify FIXEdgeJ (Linux) or FIXEdgeJ.bat (Windows) and update -Dspring.profiles.active in DEFAULT_JVM_OPTS:

    DEFAULT_JVM_OPTS='"-Dspring.profiles.active=fej-ha" "-DLog4jContextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector"'

  4. Define parameters for FIX session replication in session configuration (for example, in conf/session/samples/s_fixDefault.propertiesto enable for all FIX session samples)

    # use the Persistence API for storing the FIX session state
storageFactory=com.epam.fixengine.storage.persistence.PersistenceEnableFactory
# use the Persistence API implementation with replication between nodes
storage.persistenceFactoryBuilder=com.epam.fixengine.storage.persistence.ReplicatedPersistenceFactoryBuilder
# replication timeout in milliseconds. A zero value for this option will enable asynchronous replication for the FIX session.
replicationTimeout=0