Prerequisites and System Requirements

1. Supported operating systems:
   • Linux RHEL/CentOS 6
   • Linux RHEL/CentOS 7
2. The list of packages that should be installed before FIXEdge's installation: 
   • unzip

   • libtool-ltdl

      optional since v. 5.11.0

     java-1.7.0-openjdk

     $ sudo yum install java-1.7.0-openjdk

   To install them use the following commands with superuser rights:

   $ 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

• engine.license

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

   FIXEdge prior v. 5.11.3

  fixicc-linux-x.x.x.zip

  fixaj2-license.bin

Steps to Install

$ 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 root 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:

    FIXEdge prior v. 5.11.3

   Import the fixaj2-license.bin license in FIXICC GUI:
   Help -> Import license...

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

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

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

Please refer to FIXICC User Guide for detailed instructions.

Installation complete

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.

FIXICC agent doesn't start

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

2. Find the messages with [ERROR] and [FATAL] level. These messages are able to help with understanding of the possible issues. If there is a requirement for technical assistance then contact the support team SupportFIXProducts@epam.com. 

FIXEdge doesn't start from FIXICC

1. Go to the B2BITS/FIXEdge/bin directory and run FIXEdge:

   $ cd /home/user/B2BITS/FIXEdge/bin
   $ ./FixEdge1.run.sh

2. If the script was executed successfully then go to the /home/user/B2BITS/FIXEdge/fixicc-agent/logs directory and open fixicc-agent.log with any text editor (otherwise go to the 'FIXEdge doesn't start with 'FixEdge1.run.sh' script' section).

3. Check if the following note exists in the log and make sure that the path presented below lead to the existing engine.properties file:

   [UtilProperties] Properties load successful: /home/user/B2BITS/FIXEdge/fixicc-agent/../FIXEdge1/conf/engine.properties

4. If the note is absent find the messages with [ERROR] and [FATAL] level. These messages are able to help with understanding of the possible issues. If there is a requirement for technical assistance then contact the support team SupportFIXProducts@epam.com. 

FIXEdge doesn't start with 'FixEdge1.run.sh' script

1. Go to the B2BITS/FIXEdge/FIXEdge1/log directory and open FixEdge.log with any text editor.
2. Find the messages with [ERROR] or [FATAL] level. These messages are able to help with understanding of the possible issues. If there is a requirement for technical assistance then contact the support team SupportFIXProducts@epam.com. 

FIXEdge cannot start with an incorrect or expired license

1.  Go to the B2BITS/FIXEdge/FIXEdge1/log directory and open FixEdge.log with any text editor.

   1. Request a new license file from the sales team sales@btobits.com if the FixEdge.log file contains the following error:

      ERROR   [Engine]  140410078865152  License is expired – components will be stopped! Please contact us at SupportFIXAntenna@epam.com for further assistance.

   2. Make sure that the license file has a correct 'engine.license' name and placed in the root directory of FIXEdge if the FixEdge.log file contains the following error:

      ERROR   [FL_FixEngine]  140029176809248  Unable to initialize EngineAdaptor. Reason: Please check the FIX Engine's settings: Cannot open the file "/home/user/B2BITS/FIXEdge/bin/../engine.license" (the "LicenseFile" property). No such file or directory. (Error code = 2)

2. Restart FIXEdge after updating the license to apply the changes.

Binary files and shell scripts have no "executable" permissions

1.  Set the permissions for the needed files with the following command:

   $ chmod 755 /home/user/B2BITS/FIXEdge/fixicc-agent/bin/*