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:

export JAVA_HOME=<correct value>

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:
```
/usr/lib/systemd/system/fixedge.service
```

Upgrade Process

Please refer to the FIXEdge upgrade instruction for more details.

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).
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:
```
FIXEdge1.run.cmd
```
2. Linux:
```
FIXEdge1.run.sh (if TAR.GZ is used )
fixedge.service (if RPM is used)
```
Copy and overwrite all files in the 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.

Make sure that there is a backup copy of the working installation of FIXICC and FIXICC-Agent.
Remove the existing <FIXEdge installation>/fixicc-agent/ and <FIXEdge installation>/fixicc/ directories.
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.
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:
```
fixicc-agent\FIXEdge1.fixicc-agent\conf\
```
2. The default Linux path for fixicc-agent configuration is:
```
fixicc-agent/conf
```

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:

Update the following line in FIXEdge/fixicc/etc/fixicc.conf:
```
jdkhome=<path to JRE in fixicc-agent folder>
```
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

Replace all JAR files in the following directories with new versions from the FIXEdge package:
```
FIXEdge1/conf/jms-ta-distribution/lib
FIXEdge1/conf/jms-ta-distribution/tool/lib
```
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:
```
jms-ta-distribution/etc/JVM_Options.jvmopts
tool/bin/start.bat
```

RabbitMQ Adaptor

Replace all JAR files in:
```
FIXEdge1/conf/amqp-ta-distribution/lib
```
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:
```
amqp-ta-distribution/etc/JVM_Options.jvmopts
```

CamelTA Adaptor

Replace all JAR files in:
```
FIXEdge1/conf/camel-ta-distribution/lib
```

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:

Windows:

camel-ta-distribution/etc/JVM_Options.jvmopts

Linux:

camel-ta-distribution/etc/JVM_Options_legacy.jvmopts (if TAR.GZ is used)
camel-ta-distribution/etc/JVM_Options_windows.jvmopts (if RPM is used)