This article is intended to help customers who use ICE Trade Capture connection to upgrade their FIXEdge-based solution to the latest version. The article provides upgrade instruction for the following scenarios:

• Pure installation of the new version of the ICE Trade Capture solution;

• Upgrade of the existing ICE Trade Capture setup.

Please note, if you have multiple connections (not only ICE Trade Capture) on the same FIXEdge instance, contact SupportFIXAntenna@epam.com to get full upgrade instruction.

This section shows how to set up a new version of ICE Trade Capture solution. It is assumed that:

• The package contains the latest ICE Trade Capture Solution version with all the new features and bug fixes.

• Package contains only one ICE Handler component and only one ICE Trade Capture session supposed to be connected to only one ICE Trade Capture feed.

• All customer's specific ICE Trade Capture configurations and database schemes will be discarded.

• No migration of existing data from the current database to the new upgraded database takes place (means new clean Database from the package to be set up).

• It is required to enter all ICE specific credentials to the new configuration setup following the instruction.

• After the solution start, trades from last 2 days will be re-requested and stored into the database.

1. Make sure you have sufficient administration permissions for further uninstall/install procedures.

2. Download the new ICE Trade Capture solution package for the corresponding OS version from the Client Space.

3. Keep your current installation for backup purposes.

4. Make a copy of your current Database scheme;

5. Make a copy of your current license (engine.license file). If your license has expired or was lost, contact sales@btobits.com to obtain the new one.

1. Unpack the new version of ICE Trade Capture solution to a separate folder.

2. Take the details from you current installation and adjust the configuration following the step 3 from How to deploy the package and make it work.

3. In case several ICE Handler components should be used to connect to multiple ICE Trade Capture feeds:

   1. Create copies of the ICE Handler from the new package (libICEHandler-gcc44-MD-x64.so in Linux package and ICEHandler-vc10-MD-x64.dll in Windows package), give them names according to your specifics, and put to the /bin folder.

   2. Adjust configuration accordingly.

4. Copy your FIXEdge license into the license file path.

5. Stop your current FIXEdge instance.

6. Stop your current FIXICC-agent instance.

7. Uninstall your current FIXEdge and FIXICC Agent instances (means deregister these services from the system):

   1. For Windows: run FIXEdge1.uninstall.cmd from the /bin directory and uninstallService.FIXEdge1.bat from fixicc-agent\bat directory.

   2. For Linux: run uninstallDaemon.sh from fixicc-agent\bat directory.

8. Remove all the files except servers.xml from FIXICC's working dir .fixicc/dev usually placed in the C:\Users\%USER%\AppData\Roaming directory.

9. Upgrade the Database scheme with the new one provided in the package in the DB_script directory.

10. Execute 'MSSQL_ICETrdCapt.sql', 'MSSQL_ICESecDef.sql', 'MSSQL_ICEStrategies.sql', and 'MSSQL_ICE_sp_AllocationReport.sql' scripts against the database to create or upgrade stored procedures (adjust change the database name if necessary). 

11. Install new FIXEdge and FIXICC Agent instances (means register these services in the system):

    1. For Windows: run FIXEdge1.install.cmd from the /bin directory and installService.FIXEdge1.bat from the fixicc-agent\bat directory.

    2. For Linux: run installDaemon.sh from fixicc-agent\bat directory.

12. Start the new FIXICC-agent instance.

13. Start FIXEdge via FIX Integrated Control Center (FIXICC).

If you need to revert changes in order to use your original ICE Trade Capture version (that was used before the upgrade), you need to do the following steps:

1. Stop the FIXEdge instance.

2. Stop the FIXICC-agent instance.

3. Uninstall the FIXEdge and FIXICC Agent instances (which means deregister them from the system).

4. Remove all the files except servers.xml from FIXICC's working dir .fixicc/dev usually placed in the C:\Users\%USER%\AppData\Roaming directory.

5. Restore the Database scheme used previously.

6. Install the FIXEdge instance of the previously used ICE Trade Capture package.

7. Install the FIXICC-agent instance of the previously used ICE Trade Capture package.

8. Start the FIXICC-agent process of the previously used ICE Trade Capture package.

9. Start the FIXEdge process of the previously used ICE Trade Capture package.

This section shows how to upgrade an existing version of ICE Trade Capture solution. It is assumed that after the upgrade:

• ICE Trade Capture solution will contain latest FIXEdge version with all the new features and bug fixes.

• All customer's specific ICE Trade Capture configurations and database schemes will be kept as is (means no ICE Trade Capture specific changes and enhancements from the new package will come).

• All the existing data in the current Database will be kept as is.

1. Make sure you have sufficient administration permissions for further uninstall/install procedures.

2. Download the new ICE Trade Capture solution package for the corresponding OS version from the Client Space.

3. Stop the FIXEdge instance.

4. Stop the FIXICC-agent instance.

5. Remove all the files except servers.xml from FIXICC's working dir .fixicc/dev usually placed in the C:\Users\%USER%\AppData\Roaming directory.

6. Make a backup copy of your current installation (configuration and binaries).

7. Make a backup copy of your current license (engine.license). If your license has expired or was lost, contact sales@btobits.com to obtain the new one.