Try TT Now

Upgrading

Overview

You can upgrade to a higher version of the BrokerTec 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 BrokerTec 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.

Upgrading to 7.17 or higher for a Multi-Member Configuration

To upgrade to BrokerTec Gateway 7.17 or higher for a Multi-Member configuration

  1. Upgrade the multi-member BrokerTec Gateway to 7.17.
  2. Rename the fill sequence file (e.g. Btec-A_FillSeqStore.dat) on the multi-member gateway to Btec-A_TTF_<Root_ID>_FillSeqStore.dat
  3. Remove the following parameters from the existing hostinfo.cfg file if they are present.
    • ResubmitOnSessionDown=1 When removed, the gateway behaves as if orders inactivated by the exchange due to a session loss will be on hold.
    • ResubmitOnStartup=1 - When removed, the gateway behaves as if orders inactivated by the exchange will be left on hold during initialization.
    • ForceAutoAggress=1 - By default, the gateway sets as passive or aggressive based on how the order was placed by the client trading application.
    • PollingInterval - Functionality is removed from the gateway.
    • HeartbeatInterval - By default, the gateway behaves as if set to 8 seconds. This parameter does not need to be configured.
    Note

    Contact TT Engineering before configuring the HeartbeatInterval parameter

  4. Configure the existing hostinfo.cfg with the new format using the hostinfo.cfg_master file as a reference.

    After the multi-member BrokerTec Gateway upgrade installation is complete, the Order Server can use either format. However, once the format is changed to the new multi-member version, the Member IDs (the "M" of MGT) of the exchange members used for order routing must be configured in the [Member_<member ID>] section using the Member= parameter.

  5. Assign the Member values of traders which will be allowed to trade on the multi-member gateway.
  6. If existing traders' Member-Group-Trader IDs do not have a Member configured on the gateway, those traders’ IDs must be updated. Refer to the BrokerTec Gateway Migration Guide for information about updating direct trader IDs for multi-member gateways.

Upgrade Procedures

You can use a BrokerTec 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 BrokerTec 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 BrokerTec 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:
    • BrokerTec Gateway Fill Server
    • BrokerTec Gateway Price Server
    • BrokerTec Gateway Order Server
    • BrokerTec Gateway Key Server
    • BrokerTec Gateway Order Routers, etc. (if present)
  4. If upgrading intraday, backup and rename the current session’s Audit File.
  5. Double-click the BrokerTec 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.

Rebooting the Server

When rebooting the server, TT strongly recommends performing the reboot outside of actual trading hours (e.g., after the market close). In addition, you must all stop all TT services as shown in the procedure below.

To reboot your server:

  1. Once trading has ceased, access the server.
  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:
    • Fill Server
    • Price Server
    • Order Server
    • Key Server
    • Order Routers, etc. (if present)
    Warning

    Rebooting without stopping all TT services may corrupt datfiles and result in GTC orders being removed from the TT Order Book while still working at the exchange.

  4. Once all TT services have stopped, perform the reboot.

Working with Master Files

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

  • hostinfo.cfg_master
  • ttchron.ini_master

These files contain updated settings and parameters for the upgraded version of the TT Gateway. When upgrading, the BrokerTec 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. This is illustrated in 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.
  2. Copy changes from the Master File and paste into the relevant sections of the original configuration file.
  3. Save your changes and close both files.
  4. You can continue to edit your configuration files as described in the sections below.