Try TT Now

Installing with the Command Line Interface

Overview

Use the command line interface to expedite the installation process by suppressing some or all of the dialog boxes that appear during a GUI installation. This becomes particularly useful when installing multiple instances of the BVMF Gateway.

When entering the command, use the following syntax:

packagename.exe -a --argument1=value --argument2=value where:

packagename.exe equals the name of the executable file (e.g., bvmf_r7.15.2.0p27.exe).

-a identifies that arguments follow in the command.

--argument1 equals the arguments you wish to use from the table below.

Creating an Install Configuration File

For multiple installs, you can open a text editor, such as Notepad, and create an install configuration file that contains a list of arguments you wish to use. When creating an install configuration file, you must list each argument on a separate line.

Example Install Configuration File

installroot=c:program filestt

exhangename=BVMF-B

countrycode=US

zipcode=60606

reboot=force

Once created, you can rename the file. Then, you can begin the installation by adding the filename to the --installcfg argument. The example below shows the command line argument to install BVMF package 27 using a install configuration file named Install.txt located on the C: drive:

bvmf_r7.15.2.0p27.exe -a --installcfg=c:Install.txt

Installing via Command Line Interface

To begin the command line installation:

  1. Download the package executable file from the TT Customer Portal. To simplify the install, place the file on the server’s <root drive>.
  2. Open a command window by selecting Run on the Start menu and typing CMD.
  3. When the command window appears, use the cd <root drive>: command to navigate to the location of the executable.
  4. Enter the name of the executable file followed by -a and the arguments you wish to use.

    Example Installation Arguments for the BVMF Gateway:

    Entering:

    bvmf_r7.15.2.0p27.exe -a --installroot=c:program filestt --exhangename=BVMF-B --countrycode=US --zipcode=60606 --reboot=force

    causes the BVMF Gateway installation to perform the following:

    • The Gateway installs into the c:program filestt directory
    • The exchange-flavor equals BVMF-B
    • The country code equals US and the zip code equals 60606
    • The server automatically reboots after the install completes
Installation Arguments

Argument

Function

--aconfigxml=<file location>

Specify the path to an existing aconfig.xml file. Suppresses the Browse for aconfig.xml dialog box and uses the provided network aconfig.xml file.

Using this argument causes the installation to update the revision count on the existing network aconfig.xml file.

Warning

Do not use the ovr command when supplying an existing network aconfig.xml file.

--countrycode=<2-digit countrycode> --zipcode=<zipcode>

Suppresses the Locale Information dialog and adds the country code and zip code values to the location.cfg file.

You must supply both arguments.

--exchangename =<Exchange-Flavor>

Suppresses the Available Exchange Names dialog and sets the Exchange-Flavor for the BVMF Gateway.

--reboot=force

Sets the server’s behavior following the installation. The --reboot command uses the following values:

  • norestart: The installation does not reboot the server. In addition, the installation suppresses the Reboot Now dialog.
  • force: The installation reboots the server without displaying the Reboot Now dialog.
  • promptrestart: The installation displays the Reboot Now dialog.
Note

If the --reboot command is not present, the installation exhibits the default behavior.

--skipdesktop

Sets the installation to not add desktop icons.

--ttmdcfg=ttmd.cfg, ovr

Sets the location of the ttmd.cfg file. You must set this value equal to ttmd.cfg.

In addition, you must add the ovr argument to overwrite an existing ttmd.cfg file.

Install Location Arguments

Warning

The following arguments only apply if this is the first TT product installed on the server. Subsequent installations automatically write to an existing TT folder, even if you supply the following arguments.

--installroot=[path]

Sets the directory path for all install files and folders and suppresses the prompt for installation path during first time installations.

--installconfig=[path]

Suppresses the Customize Destination Folders dialog and sets the location for the hostinfo.cfg, custommultipliers.cfg, ttchron.ini and ttclean.ini configuration files.

Also, this argument sets the location of additional TT component configuration files (i.e., ttmd.cfg, DNModifications.cfg).

--installdata=[path]

Sets the location for system data files.

--installuserdata=[path]

Sets the location for user data files.

--installlog=[path]

Sets the location for log files.

--installpathlist=[pathlist]

Sets the location for all files listed above (i.e., configuration, log, user, and system data files). The value of this parameter must equal a comma separated list of installation paths that must include the installroot and must appear in the following order: installroot,installconfig,installlog,installuserdata,installdata

Any omitted values causes those files to be written to the installroot location.

Note

You can not add this argument to an installation configuration file.

Additional Installation Arguments

TT Gateways 7.16 and higher support an additional command line argument for setting the gateway mode on install.

Additional Installation Arguments

Argument

Function

--gwinstallmode=[mode]

where [mode] equals either 1, 2, or 3

Sets whether the user performs a ‘traditional’ (i.e., install all TT Gateway components) or a limited, component-specific install.

This setting has three options:

  • 1: Traditional mode - installs all components for market data and orders/fills including the Price Server, Order Server, Fill Server, and GuardServer.

    For Eurex Gateways, this option also installs the OTC Router.

  • 2: Order/Fill mode - only installs components required for orders and fills including the PriceProxy (as a service only) and Order Server, Fill Server, and GuardServer.

    For Eurex Gateways, this option also installs the OTC Router.

  • 3: MPF mode - only installs components required for market data including the Price Server and GuardServer.
Note

You must use the -a command prior to passing any command line argument.

Post-Install

If using the --gwinstallmode argument to install an order/fill or MPF mode gateway, you must manually update the ttchron.ini and hostinfo.cfg files to comment-out the sections for the uninstalled services by adding a hash (#) symbol before each line in the section.

When installing an order/fill gateway with --gwinstallmode=2, you must comment-out the Price Server section.

When installing an MPF gateway with --gwinstallmode=3, you must comment-out the Order Server, Fill Server, and Order Router (if applicable) sections.

Upgrading

You cannot use the --gwinstallmode argument to change an existing gateway’s mode. When upgrading an existing gateway, the --gwinstallmode argument is ignored and the gateway automatically installs in the same mode as the existing gateway.

You must uninstall the existing gateway prior to installing the gateway in a different mode.