FIXEye Agent installation (Linux)


The guide below describes how to install FIXEye Agent on Linux servers. It may be also used for the procedure of upgrade to newer version.

Step-by-step guide

  1. Download Linux version of FIXEye Agent from client space or on http://www.b2bits.com/trading_solutions/fix_log_analyzers.html
  2. Extract it to the required directory. For example:

    Unpack the archive
    tar -xzvf FIXEyeAgent-1.3.2.0-linux-x64.tar.gz -C /FIXEdge/
  3. Configure connection details in fixeye-agent.config file. Put down the port (make sure it is not blocked by a firewall), a file with entitled users, a path to FIX files and (since FIXEye Agent 2.0) a path to license file. Example of the file in result:

    cat fixeye-agent.config
    -port 8882 -users "user_config.xml" -f "/log/FIXEdge/*.in" "/log/FIXEdge/*.out" -licfile "fixeye-agent.license"

    Optionally, you can also define dictionaries for message validation with  extra "-d <file>" parameter. To see all the available options, use `./fixeye-agent –help`

    You might need to export the library directory before running it: `LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$PWD; export LD_LIBRARY_PATH; ./fixeye-agent --help`
  4. Configure fixeye-agent.properties, which mainly describes agent logging parameters;
  5. User credentials are configured under user_config.xml. It will be used for FIXEye to connect to FIXEye agent;

  6. To run as daemon, execute:

    Start the service
    cd /FIXEdge/fixeye-agent; ./fixeye-agent-svc.sh start
  7. Start FIXEye, click “Add Agent”. Put host (where the agent is), port (from fixeye-agent.config),  Login and Password (from user_config.xml). Detailed guide on FIXEye itself is in article FIXEye User Guide


In case you would like to have configuration files in a separate from binaries directory, perform additional steps:

  1. Create configuration directory, make sure it has sufficient permissions
  2. Move these files there:
    fixeye-agent.config
    fixeye-agent.properties
    user_config.xml
  3. Amend run.sh considering that configuration is now in another directory. For example:
cat run.sh
PRGDIR="/FIXEdge/fixeye-agent/"
CONFDIR="/conf/fixedge1-fixeye"
EXECUTABLE=fixeye-agent

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$PRGDIR
export LD_LIBRARY_PATH

cd $CONFDIR
exec "$PRGDIR"/"$EXECUTABLE" -console fixeye-agent.config

Upgrade to version 2.0 from older versions

To update the version of FIXEye Agent to 2.0 from the older one you need to replace all files in your current FIXEye Agent folder with the new ones from B2BITS clientspace FIXEye Agent package. 

Also you need to specify a path to the license file in fixeye-agent.config file in the following format:

-licfile <a path to the license file>
cat fixeye-agent.config
-port 8882 -users "user_config.xml" -f "/log/FIXEdge/*.in" "/log/FIXEdge/*.out" -licfile "fixeye-agent.license"

Consul configuration

To find the Consul installation instructions, please follow this link.

For non-production use, you can run the Consul in developer mode with the command: consul agent -dev.

For production use - please follow this link.

To configure the encrypted connection from FIXEye Agent to the Consul on the Consul side, please refer to this link.

FIXEye Agent Settings

Please configure FIXEye Agent to connect to Consul by setting the following properties:

NameExample value

Default Value

Description
Consul.Enabledtrue

false

Sets if Consul is enabled or not
Consul.Host10.68.21.156localhostHostname or IP address of the Consul Agent
Consul.Port85008500The number of the Port configured for Consul Agent
Consul.ReconnectInterval10001000The interval between reconnect attempts in milliseconds
Consul.ServerName

FIXEdge1

-The name of the FIXEdge server, if it is not empty, the agent will be registered in Discovery by Consul.ServerName-FIXEye-Agent. Is mandatory if Consul.Enabled is true
Consul.Services.Host10.68.21.156localhostHostname or IP address of FIXEye agent to register FIXEye agent services in Consul
Consul.Services.HealthChecks.Interval55Interval to check registered service by Consul
Consul.Services.HealthChecks.Timeout55Timeout to check registered service by Consul
Consul.SSLtruefalseSets if SSL is enabled or not
Consul.SSL.PrivateKey../FIXEyeAgent/conf/Consul.key-SSL private key
Consul.SSL.Certificate../FIXEyeAgent/conf/Consul.pem-SSL private certificate
Consul.SSL.CertificateAuthority../FIXEyeAgent/conf/Consul.crt-Path to the file or directory containing the CA/root certificates. Can be empty if the OpenSSL builtin CA certificates are used
FIXEye Agent properties file
#Sets if Consul is enabled or not
Consul.Enabled=true
#Hostname or IP address of the Consul Agent
Consul.Host=10.68.21.156
#The number of the Port configured for Consul Agent
Consul.Port=8500
#The interval between reconnect attempts in milliseconds
Consul.ReconnectInterval=1000
#The name of the FIXEdge server
Consul.ServerName=FIXEdge1
#Hostname or IP address of FIXEye agent to register FIXEye agent services in Consul
Consul.Services.Host=10.68.21.156
#Interval to check registered service by Consul
Consul.Services.HealthChecks.Interval=5
#Timeout to check registered service by Consul
Consul.Services.HealthChecks.Timeout=5
#Sets if SSL is enabled or not
Consul.SSL=true
#SSL private key
Consul.SSL.PrivateKey=../FIXEyeAgent/conf/Consul.key
#SSL private certificate
Consul.SSL.Certificate=../FIXEyeAgent/conf/Consul.pem
#Path to the file or directory containing the CA/root certificates
Consul.SSL.CertificateAuthority=../FIXEyeAgent/conf/Consul.crt

FIXEye User Guide

FIX Engine parameters#Loggingparameters