FIXEdge 6.18.0 Migration Guide

This document provides step-by-step instructions for upgrading to FIXEdge 6.18.0, ensuring a smooth transition and compatibility with the latest changes.

Installation

Please refer to the FIXEdge Installation Guide for more details.

Prerequisites

• Ensure Java 11 is installed.

• For Linux OS ensure the following libraries are installed:

  libtool-ltdl unixODBC

For ZIP or TAR.GZ Installations

• Set up the environment variable JAVA_HOME.

Known Issue

Description: When FIXEdge is installed using a TAR.GZ package along with fixicc-agent, the FIXEdge log may show an error related to missing libjsig.so, preventing proper startup. The issue arises because JAVA_HOME is not correctly applied when starting FIXEdge.

Workaround: Add the following line to FixEdge1.run.sh to ensure JAVA_HOME is correctly used:

For RPM Installations

• Select Java 11 using the following command:

  update-alternatives --config java

• If Java is installed manually (not via a package manager), verify that the following file contains the correct Java path:

Upgrade Process

Please refer to the FIXEdge upgrade instruction for more details.

1. Verify that Java 11 is installed and set up correctly. If upgrading from an earlier version, JRE can be removed from the FIXEdge folder (Java from JAVA_HOME will be used instead).

2. Note that the following files have been updated in FIXEdge 6.18.0 and should be reviewed for compatibility. If you are using custom versions of these files, please restore any changes you have made.

   1. Windows:

   2. Linux:

3. Copy and overwrite all files in FIXEdge/plugins directory with new plugin files from the FIXEdge package.

Upgrading FIXICC and FIXICC-Agent

FIXICC and FIXICC-Agent have been moved from the FIXEdge package to separate packages. Download and unzip the packages for FIXICC and FIXICC-Agent.

1. Make sure that there is a backup copy of the working installation of FIXICC and FIXICC-Agent.

2. Remove the existing <FIXEdge installation>/fixicc-agent/ and <FIXEdge installation>/fixicc/ directories.

3. Copy all files from the new fixicc-agent package into the <FIXEdge installation>/fixicc-agent/ directory and all files from the new fixicc package into the <FIXEdge installation>/fixicc/ directory.

4. If there were changes in fixicc-agent and fixicc configuration then replace the new configuration with the configuration from the backup.

   1. The default Windows path for fixicc-agent configuration is:

   2. The default Linux path for fixicc-agent configuration is:

If fixicc-agent should be in another location, update agent.properties accordingly.

Both FIXICC and FIXICC-Agent require Java 8 and include their own JRE. If fixicc and fixicc-agent are on the same machine, you can use fixicc-agent's JRE:

1. Update the following line in FIXEdge/fixicc/etc/fixicc.conf:

2. Remove the JRE from the fixicc folder.

Upgrading Transport Adaptors

FIXEdge 6.18.0 includes updates for Java-based transport adaptors to ensure compatibility with Java 11.

JMS Adaptor

1. Replace all JAR files in the following directories with new versions from the FIXEdge package:

2. Replace the following files or update the versions of the corresponding Java libraries listed in the -Djava.class.path property within the JVM_Options.jvmopts file:

RabbitMQ Adaptor

1. Replace all JAR files in:

2. Replace the following files or update the versions of the corresponding Java libraries listed in the -Djava.class.path property within the JVM_Options.jvmopts file:

CamelTA Adaptor

1. Replace all JAR files in:

2. Replace the following files or update the versions of the corresponding Java libraries listed in the -Djava.class.path property within the JVM_Options.jvmopts file:

   1. Windows:

   2. Linux: