Overview

License files for EPAM B2BITS FIX products have an expiration date and the license file should be updated once it is expired.

The new version of the license file should be requested from sales@b2bits.com 

FIXEdge C++

By default, the license information is stored in the “engine.license” file, which is placed in the FIXEdge root directory. The path to the license is defined in the LicenseFile property of the “engine.properties” configuration file.

All changes in the FIXEdge license file will be applied only after the FIXEdge server restart.

Normal operations

After the FIXEdge server start the appropriate message will be printed in the log file if the license is valid:

<timestamp>   WARN    [Engine]  <thread>  The license for the '<company>' expires in <Number> days. Please contact us at sales@b2bits.com for further assistance.

Expired or incorrect license file

FIXEdge C++ won't start with an incorrect or expired license.

The appropriate messages will be printed in the log file in case of incorrect/expired license file.

The message below will be printed in the log file in case of license missing:

<timestamp> ERROR   [FL_FixEngine]  <thread> Unable to initialize EngineAdaptor. Reason: Please check the FIX Engine's settings: Cannot open the file "<installation dir>\engine.license" (the "LicenseFile" property). The system cannot find the file specified. (Error code = 2)
<timestamp> FATAL   [CC_Layer]  <thread> FIX Layer has failed to initialize: Unable to initialize FIX Engine.

The messages below will be printed in the log file in case of incorrect/expired license file:

<timestamp> ERROR [Engine] <thread> License is expired - components will be stopped! Please contact us at sales@b2bits.com for further assistance. 
… 
<timestamp> ERROR [Engine] <thread> License is not valid - components will be stopped! Please contact us at sales@b2bits.com for further assistance.

How to update the license file

Copy or update the "engine.license" file in the FIXEdge installation directory with the new one and restart FIXEdge.

In case if the path to the license is changed, please refer to the appropriate path in the LicenseFile property of the “engine.properties” configuration file.

Docker container with FIXEdge

Docker image expects the directory with the license file to be mounted to /etc/fixedge directory inside the container. 

Put the license to dir and pass the path to license dir when running the container. E.g if the following command will mount $(pwd)/license/ directory with the license:

docker run -it -v $(pwd)/license:/etc/fixedge \
               -v $(pwd)/logs:/var/log/fixedge \
               -p 8901:8901 -p 8005:8005 -p 8905:8905 -p --expose 1234/udp \
               b2bitsepam/fixedge-cpp:latest

FIXICC / FIXICC H2

We would like to recommend to use FIX Integrated Control Center H2 (FIXICC H2) together with FIXEdge servers. The appropriate information about FIXICC H2 license update can be found here. 

FIX Integrated Control Center (FIXICC) is obsolete and out of support; the latest FIXICC version is 2.13.2. We would like to recommend to use FIXICC H2 instead. The appropriate information about FIXICC license update can be found here.

FIXEdge Java

Since version 1.10.3 FIXEdge Java has a separate license file that should be requested from sales@b2bits.com 

License information is stored in the "fixedgej-license.bin" file. The license file is expected to be placed in the FIXEdge Java root folder.

All changes in the FIXEdge license file will be applied only after the FIXEdge server restart.

Normal operations

After the FIXEdge server start the appropriate message will be printed in the log file if the license is valid:

<timestamp> [INFO ] [main] c.e.f.Application - B2Bits FIX Edge Java. License valid until: <DATE>. Please contact us at sales@b2bits.com to report illegal B2Bits FIX Edge Java copy or to obtain/renew your license.

Expired or incorrect license file

FIXEdge Java won't start with an incorrect or expired license.

The appropriate messages will be printed in the log file in case of incorrect/expired license file.

<timestamp>   ERROR    [Engine]  <thread>  FixEdge Java license is invalid or expired. Please contact us at 1(888)378-0666 to renew/obtain your license.

How to update the license file

Copy or update the "fixedgej-license.bin" file in the FIXEdge installation directory with the new one and restart FIXEdge.

Since version FIXEdge Java v.1.10.3 FIX Antenna Java license should be updated separately. The license information is stored in the "fixaj2-license.bin" file. The appropriate information about FIX Antenna Java license update can be found here.

FIXEdge Java prior to v.1.10.3

FIXEdge Java versions prior to the 1.10.3 are obsolete and out of support; support agreement covers only two latest FIXEdge Java versions.

The license information is stored in the "fixaj2-license.bin" file for FIXEdge Java versions earlier than 1.10.3.

In order to update the license on the versions prior to v.1.10.3 please copy or update the "fixaj2-license.bin" file in the FIXEdge installation directory with the new one and restart FIXEdge.

FIXICC / FIXICC H2

We would like to recommend to use FIX Integrated Control Center H2 (FIXICC H2) together with FIXEdge servers. The appropriate information about FIXICC H2 license update can be found here. 

FIX Integrated Control Center (FIXICC) is obsolete and out of support; the latest FIXICC version is 2.13.2. We would like to recommend to use FIXICC H2 instead. The appropriate information about FIXICC license update can be found here.

FIXICC H2

We would like to recommend to use FIX Integrated Control Center H2 (FIXICC H2) together with FIXEdge servers.

FIX Integrated Control Center H2 (FIXICC H2) works without a license file so updating license is not needed.

FIXEye Agent

Since version 2.0.0.28 license information is stored in the "fixeye-agent.license" file that should be requested from sales@b2bits.com 

The license file "fixeye-agent.license" is expected to be placed in the FIXEye Agent root folder.

The appropriate information about FIXEye Agent license update can be found here.

FIXICC

FIX Integrated Control Center (FIXICC) is obsolete and out of support; the latest FIXICC version is 2.13.2. We would like to recommend to use FIXICC H2 instead.

FIXICC works without a license file so updating license is not needed.

FIXICC Agent

FIXICC Agent is obsolete and out of support.

FIXICC Agent works without a license file so updating the license is not needed.

FIX Antenna C++/HFT/.NET

License information is stored in the "engine.license" file that should be requested from sales@b2bits.com 

The license file "engine.license" is expected to be placed in the FIX Antenna root folder.

In order to apply a new license, it is enough to replace the current file with the newer one. Make sure that after restarting the application the relevant record about the correct license has appeared in the log file.

FIX Antenna C++ Market data handlers 

List of handlers:

• B3

• JSE (Mit)

• MOEX ASTS

• MOEX Spectra

The default license filename is "engine.license". The default location is the root directory of the Market Data Handler package.

In order to apply a new license, it is enough to replace the current file with the newer one.

FIX Antenna C++ CME MDP3 Handler

The default license filename is 'b2b_cme_mdp_handler.license'. The default location is the root directory of the CME MDP3 Handler package.

Order Entry (FIX Antenna C++)

The default license filename is "engine.license". The default location is the root directory of the Order Entry package.

In order to apply a new license, it is enough to replace the current file with the newer one.

FIX Antenna Java

License information is stored in the "fixaj2-license.bin" file that should be requested from sales@b2bits.com 

The license file "fixaj2-license.bin" is expected to be placed into one of the following places:

• in application CLASSPATH. Usually, the best place for the license file is a configuration directory which is added to CLASSPATH.

• in the application working directory.

• in the user home directory. This variant can be useful to provide the same license file for applications, stunned by the same user on the same box.

In order to apply a new license, it is enough to replace the current file with the newer one. Make sure that after restarting the application the relevant record about the correct license has appeared in the log file.

Market Data Handlers (FIX Antenna Java)

The default license filename is "fixaj2-license.bin". In order to apply a new license please follow the FIX Antenna Java license update instructions.

Order Entry (FIX Antenna Java)

The default license filename is "fixaj2-license.bin". In order to apply a new license please follow the FIX Antenna Java license update instructions.

FIX Antenna Python

License information is stored in the "engine.license" file that should be requested from sales@b2bits.com 

The license file "engine.license" is expected to be placed in the FIX Antenna root folder.

In order to apply a new license, it is enough to replace the current file with the newer one. Make sure that after restarting the application the relevant record about the correct license has appeared in the log file.

FIX Antenna .Net Core

The default license filename is 'fa-net-license.bin'. Just update the license file with a new one.

The file should be located into one of the following places:

• in the application working directory.

• in the user home directory.

FIX Eye

Since version 4.0.11 FIX Eye works without license file so updating license is not needed

FIXEye Agent

Prior to version 2.0.0.28, FIX Eye Agent works without license file so updating license is not needed

Since version 2.0.0.28 license information is stored in the "fixeye-agent.license" file that should be requested from sales@b2bits.com 

The license file "fixeye-agent.license" is expected to be placed in the FIXEye Agent root folder.

FIX Client Simulator

The license information is stored in the “engine.license” file, which is placed in the FIX Client Simulator root directory. 

FIX Client Simulator won't start without license file. Please see the error message example:

FIX Client Simulator will not work correctly in case of incorrect/expired license file. The appropriate messages will be printed in the log file in case of incorrect/expired license file:

[ERROR] <timestamp> <thread> [Engine] - License is expired - components will be stopped! Please contact us at sales@b2bits.com for further assistance.

The same time there will be errors during actions with existing/new sessions:

How to update the license file

In order to apply a new license, it is enough to replace the current file with the new one and restart the application.