Try TT Now

Upgrading

Preparing to Upgrade

Warning

The MX Gateway Version 7.X and higher will abort an installation or upgrade if your machine is running Windows 2000. Before upgrading to Version 7.X and higher, you must ensure that your machine is on a version of the Windows platform supported by TT. Please refer to the TT Trading Systems - Hardware and Software Requirements Version 7.X document for details.

You can upgrade to a higher version of the MX Gateway by running the installation package on the same machine.

Stopping Services

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.

Note

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 MX 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.

Warning

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.

For information about updating your configuration files when upgrading, refer to Master Files .

Upgrade Procedure

You can use a MX Gateway setup to upgrade an existing installation.

Note

TT recommends creating backup copies of all existing configuration files prior to upgrading your TT Gateway.

To upgrade your TT Gateway:

  1. Obtain a copy of the latest MX 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 MX Gateway.
  2. Click on the Start menu, then select the Administrative Tools, then Services.
  3. In the list of services, locate and manually stop all TT Gateway related services including:
    • MX Gateway Fill Server
    • MX Gateway Price Server
    • MX Gateway Order Server
    • MX Gateway Key Server
    • MX Gateway Order Routers, etc. (if present)
  4. If upgrading intraday, backup and rename the current session’s Audit File.
  5. Double-click the MX Gateway setup executable file to launch the installer.

    A verification dialog box displays.

  6. Select Yes to continue with the upgrade.

    When the upgrade completes, the InstallShield Wizard Completed dialog box displays.

  7. Select Finish to exit the install and perform a reboot, if required.

Master Files

To help accurately update your configuration files during upgrades, MX Gateways install with the following template “Master” configuration files located in the <root drive>:ttExchange-Flavor folder:

  • <Exchange-flavor>hostinfo.cfg_master
  • ttchron.ini_master
  • ttclean.ini_master

These files contain updated settings and parameters for the upgraded version of the TT Gateway. When upgrading, the MX Gateway retains your previous configuration settings. After installing, you can update your configuration files by copying the relevant changes from the Master files to your existing configuration files using the following procedure:

To update your existing configuration files using the Master files as reference:

  1. Open both the existing configuration file and the related Master File in a text editor.
  2. Copy changes from the Master File and paste them into the relevant sections of the original configuration file.
  3. Save your changes and close both files.