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
- Download Linux version of FIXEye Agent from client space or on http://www.b2bits.com/trading_solutions/fix_log_analyzers.html
Extract it to the required directory. For example:
Unpack the archivetar -xzvf FIXEyeAgent-1.3.2.0-linux-x64.tar.gz -C /FIXEdge/
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
`- Configure fixeye-agent.properties, which mainly describes agent logging parameters;
User credentials are configured under user_config.xml. It will be used for FIXEye to connect to FIXEye agent;
To run as daemon, execute:
Start the servicecd /FIXEdge/fixeye-agent; ./fixeye-agent-svc.sh start
- 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:
- Create configuration directory, make sure it has sufficient permissions
- Move these files there:
fixeye-agent.config
fixeye-agent.properties
user_config.xml - Amend run.sh considering that configuration is now in another directory. For example:
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>
-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:
Name | Example value | Default Value | Description |
---|---|---|---|
Consul.Enabled | true |
| Sets if Consul is enabled or not |
Consul.Host | 10.68.21.156 | localhost | Hostname or IP address of the Consul Agent |
Consul.Port | 8500 | 8500 | The number of the Port configured for Consul Agent |
Consul.ReconnectInterval | 1000 | 1000 | The interval between reconnect attempts in milliseconds |
Consul.ServerName |
| - | 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.Host | 10.68.21.156 | localhost | Hostname or IP address of FIXEye agent to register FIXEye agent services in Consul |
Consul.Services.HealthChecks.Interval | 5 | 5 | Interval to check registered service by Consul |
Consul.Services.HealthChecks.Timeout | 5 | 5 | Timeout to check registered service by Consul |
Consul.SSL | true | false | Sets 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 |
Related articles
FIX Engine parameters#Loggingparameters