/
FIXEdge installation on Linux. Step by step instruction

FIXEdge installation on Linux. Step by step instruction

Jan 30, 2025

 

NOTE!

If you are using a web-based FIXICC H2 version please follow FIXEdge C++ with FIXICC H2: Deployment Guide

Prerequisites and System Requirements

  1. Supported operating systems:

    • Linux RHEL/CentOS 7 (support discontinued starting with FIXEdge 7.0.0)

    • Linux RHEL/RockyLinux 9 (starting with FIXEdge 7.0.0)

  2. The list of packages that should be installed before FIXEdge's installation: 

    • unzip

    • libtool-ltdl

    To install them use the following commands with superuser permissions:

    $ sudo yum install unzip $ sudo yum install libtool-ltdl

  3. The list of ports that should be opened:

    • TCP: 8005, 8901, 8902, 8905.

    • UDP: 1234

Deployment of FIXEdge

FIXEdge Components

  • FIXEdge-x.x.x.tar.gz - FIXEdge package

  • engine.license - FIXEdge license file

  • fixicc-x.x.x.zip - this package is used for launching FIX Integrated Control Center on Windows PC

Steps to Install

Expected packages are located in /home/user/downloads.

The installation assumes that FIXEdge will be installed in /home/user/B2BITS under user's home directory.

Create B2BITS directory:

$ cd /home/user/ $ mkdir B2BITS

  1. Unpack the FIXEdge-x.x.x.tar.gz archive:

    $ tar xvf downloads/FIXEdge-x.x.x.tar.gz -C /home/user/B2BITS

  2. Put the engine.license file into the FIXEdge's directory:

    $ cp downloads/engine.license /home/user/B2BITS/FIXEdge/

  3. Install FIXICC Agent daemon with sudo user rights:

    $ cd /home/user/B2BITS/FIXEdge/fixicc-agent/bin/ # ./installDaemon.sh

    Start FIXICC Agent daemon:

    $ ./startDaemonNoPriv.sh

    It can take up to several minutes to start at the first time:

  4. Launch FIXICC on local (Linux) machine or on Windows PC (use the fixicc-x.x.x.zip package):

    Linux

    $ ./B2BITS/FIXEdge/fixicc/bin/fixicc

    Windows

    \fixicc\bin\fixicc.exe

  5. Use option 'Add Server' to add FIXEdge server with the following parameters:

    Type: B2BITS FIX Edge Host: localhost (or host of the machine with FIXEdge) Port: 8005 Username: admin Password: admin

  6. Select the 'Connect' option in the context menu of the created server.

  7. Select the 'Start Server' option in the context menu of the created server. 

Please refer to FIXICC User Guide for detailed instructions.

Installation complete

See also:

How to setup secure SSL/TLS connесtion between FIXEdge, FIXICC-agent and FIXICC

How to change FIXICC Agent password

Perform these steps instead step #2 of Installation.

  1. Put license file (engine.license) into FIXEdge's root dir:

    $ cp downloads/engine.license /home/user/B2BITS/FixEdge/v.5.8.0.x

  2. Unpack fixicc-agent-2.x.x.zip into FIXEdge's root dir:

    $ unzip downloads/fixicc-agent-2.x.x.zip -d /home/user/B2BITS/FixEdge/v.5.8.0.x

  3. Put license file (fixaj2-license.bin) into FIXICC Agent conf dir (fixicc-agent/conf):

    $ cp downloads/fixaj2-license.bin /home/user/B2BITS/FixEdge/v.5.8.0.x/fixicc-agent/conf

  4. Configure paths to FIXEdge files in B2BITS/FixEdge/v.5.8.0.x/fixicc-agent/conf/agent.properties:

    • ServerHome = ..

    • StartFile = bin/FixEdge1.run.sh

    • StopFile = bin/FixEdge1.stop.sh

    • LogUrl = ../FixEdge1/log

Continue Installation from step #3.

Troubleshooting

FIXICC doesn't connect to FIXICC agent

  1. Go to the /home/user/B2BITS/FIXEdge/fixicc-agent/logs directory and open fixicc-agent.log with any text editor.

    1. Check if the following notes exist in the log:

      INFO|13743/0|Service FIXICC - Agent Server|14-06-19 20:39:15|Agent is started successfully INFO|13743/0|Service FIXICC - Agent Server|14-06-19 20:39:15|Agent started on port: 8005

    2. If the notes are absent then go to the 'FIXICC agent doesn't start' section.

  2. Select the 'Edit Server' option in the context menu of the FIXEdge server in FIXICC. 

  3. Make sure that the value of the 'Port' and 'Host' in the 'Basic Settings' corresponds to the FIXICC Agent port and the host of the FIXEdge machine.

  4. Make sure that all ports from the 'Prerequisites and system requirements' section are opened and reachable by telnet from the remote host.

    telnet <remote host> 8005