TT Gateway Upgrades
Most TT products allow upgrades when migrating to a newer version. Refer to the product release notes to verify whether your product supports an upgrade or requires a clean install.
Users must be aware of the impact on the product’s Version and Release (V.R.M.F.) prior to attempting an upgrade. TT only supports upgrades to one higher release. For example, users may upgrade from 7.16 to 7.17. But TT does not support direct upgrades from 7.15 to 7.17.
Users on older releases must first upgrade to a gateway one release higher than their current gateway. For example, if upgrading from 7.15, you must install 7.16 prior to installing 7.17.
In addition, user should always upgrade to the latest Modification and Fix (V.R.M.F.) when upgrading. For example, to successfully upgrade a CME Gateway from version 7.15, users should install version 18.104.22.168 then install 22.214.171.124.
Users may freely upgrade within a single Version and Release. For example, you do not need to incrementally upgrade when going from 7.17.1 to 7.17.40.
Before you Begin
You can upgrade to a higher version of the TT Gateway by running the installation package on the same machine.
Prior to running the installation package, the user must manually stop all TT Gateway services.
Running the installation package automatically stops the following TT-related processes: TT Chron, SNMP, TT Guardian, TT Guardian Server, TT Guardian Control, TTMRD, and TTMD.
Failure to stop all services causes the installer to log the following message in the installation logfile:
Error: Service <ServiceName> failed to stop. Please shutdown all TT applications and then re-launch this install.
If this message appears, you must manually stop the service(s) and restart the TT Gateway setup.
Backing Up Audit Files
If upgrading intraday, you must backup and rename the Audit File which was created that day. Audit Files are version specific. Due to potential changes, TT strongly recommends that you backup and rename the day’s Audit File. This allows the upgraded TT Gateway to create a new version of the day’s Audit File and avoid any potential errors.
Audit Files that contain content from multiple TT Gateway versions cannot be converted with the Audit Convert tool.
Failure to begin a new file when upgrading the TT Gateway results in an ‘Unknown record type’ error message and potentially lost data.
TT strongly recommends that you backup and rename the day’s Audit File if upgrading intraday.
General Upgrade Procedure
You can use a TT Gateway setup to upgrade an existing installation.
TT recommends creating backup copies of all existing configuration files prior to upgrading your TT Gateway.
To upgrade your TT Gateway:
- Obtain a copy of the latest TT Gateway setup executable file from either the TT Customer Portal or your TAM and place a copy of the file on the machine that currently hosts the TT Gateway.
- Click on the Start menu, then select the Administrative Tools, then Services.
- In the list of services, locate and manually
stop all TT Gateway related services including:
- TT Gateway Fill Server
- TT Gateway Price Server
- TT Gateway Order Server
- TT Gateway Key Server
- TT Gateway Order Routers, etc. (if present)
- If upgrading intraday, backup and rename the current session’s Audit File.
- Double-click the TT Gateway setup executable
file to launch the installer.
A verification dialog box displays.
- Select Yes to
continue with the upgrade.
When the upgrade completes, the InstallShield Wizard Completed dialog box displays.
- Select Finish to exit the install and perform a reboot, if required.
To help accurately update your configuration files during upgrades, TT Gateways install with a set of “Master” configuration files located in the <root drive>:ttconfig folder. A TT Gateway’s set of master template files always includes a ttchron.ini_master file as well as other files dependent on the type of TT Gateway that you install, which may include the following:
When upgrading your TT Gateway, the installation script does not touch any preexisting configuration files. The Master files contain all updated and new settings and parameters for the version of the TT Gateway that you install. Thus, after installation you can update your configuration files by copying the relevant changes from the Master files to your existing configuration files.
To update your existing configuration files using the Master Files as reference:
- Open both the existing configuration file and the related Master file.
- Copy changes from the Master file and paste into the relevant sections of the original configuration file.
- Save your changes and close both files.