Try TT Now

MPF Installation

Overview

In an MPF environment, you must install Price Proxy on all mapped TT Gateways (servers that host the client applications’ Price API connections) or on a standalone server. Installation can be performed using the installation wizard or using a command line interface. When installing on a mapped TT Gateway, you must install the TT Gateway software before installing Price Proxy. For instructions on installing the appropriate TT Gateway, refer to that TT Gateway’s SAM.

Do not install the Price Proxy package onto the MPF Server.

Installing Price Proxy Using the Installation Wizard

To install the Price Proxy on a mapped TT Gateway:

  1. Run the Price Proxy setup package.

    The License Agreement dialog box appears.

  2. Read the License Agreement.
  3. To accept the License Agreement, click I accept the terms in the license agreement.
  4. Click Next.
  5. If this is the first TT product installed on this machine, the Setup Type dialog box appears. Click Install Now to install the Price Proxy files into the C:tt directory, or select Customize and then select an alternate location for the Price Proxy files.

    The Browse to aconfig.xml dialog box appears.

  6. Click Browse and then navigate to the location of the aconfig.xml file.

    aconfig.xml is located in <root drive>:ttconfig.

    Warning

    You must provide the existing aconfig.xml from the host TT Gateway during installation. If not, all TT machines in your trading system can fail.

  7. Double-click the aconfig.xml file and then click Next.
  8. The Locale Information dialog box appears.
  9. In the Country Code list, click the name of the country in which the mapped TT Gateway resides.

    Your selection here may activate the Zip Code box (e.g., you select the United States). If the Zip Code box does not activate, skip to this step.

  10. If the Zip Code box activates, in the Zip Code box, type a five-digit zip code.
  11. Click Next.

    The Define Proxy Servers dialog box appears.

  12. For clean installations, click Add to create new instances of Price Proxy. Continue with this step.
  13. For upgrades, the Define Proxy Servers window lists all existing Price Proxy instances. From this dialog box, you can perform the following:
    • Click Add to create a new Price Proxy instance. Continue with this step.
    • Click Remove to delete an existing Price Proxy. A Confirm dialog appears. Click Yes and continue with this step.
    • Click Edit to change the Service Name and/or Service Description for an existing Price Proxy. If the Service Name already exists, the Adding Invalid Proxy name dialog box appears. Enter a new unique Service Name and continue with this step.
    • Click Next to continue with the upgrade without changing existing Price Proxy instances. Skip to this step.
  14. The Proxy Server Information dialog box appears:
  15. Enter a Service Name for the Price Proxy instance.
    • You can use only alpha-numeric characters, spaces, and underscores.
    • The name you use here, appended by the string _PriceProxy, sets the name of the Price Proxy Windows service, but has no affect on how the Price Proxy appears in Guardian.
    • You must configure priceproxy.ini and ttchron.ini with whatever name you use here followed by _PriceProxy.
  16. Enter a Service Description for the Price Proxy Instance, and then click OK.
    Warning

    Currently TT supports only one Price Proxy per mapped TT Gateway. To use multiple instances of Price Proxy, you must setup Price Proxy on a standalone server.

  17. Click Next.

    The installation completes. For clean installs, the Restart dialog box appears.

  18. Click Reboot Now.

Installing Price Proxy Using the Command Line Interface

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 is useful when you want to perform a silent or remote installation.

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., priceproxy_r7.14.0p1.exe)
  • -a identifies that arguments follow in the command
  • --argument1 equals the arguments you wish to use from the table below.
Note

Argument values that include a space must be enclosed in quotation marks.

For multiple installations, you can open a text editor, and create an install configuration file that contains a list of arguments you want 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”reboot=force

Once created, you can give the file any name you want. You can then begin the installation by issuing the packagename.exe-a command with the --installcfg<filename> argument.

The following example shows the command line argument used to install Price Proxy 7.14.0 package 1 using an installation configuration file named Install.txt located on the C: drive:

priceproxy_r7.14.0p1.exe -a --installcfg=c:Install.txt

To install Price Proxy using the command line interface:

  1. Download the 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 (from the Start menu, select Run, and then type 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 want to use. lists the available arguments.
    Note

    Argument values that include a space must be enclosed in quotation marks.

Price Proxy Command Line Installation Arguments
ArgumentFunction

--countrycode=<countrycode>

Suppresses the Locale Information dialog and adds the country code and zip code values to the location.cfg file. Both countrycode and zipcode must be specified.

--zipcode=<zipcode>

--installcfg = <file>

Sets the filename and location for the file containing applicable command line interface commands. Enter one command per line and omit leading “--“.

--reboot = <“norestart”| “promptrestart”|“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.
  • promptrestart: The installation displays the Reboot Now dialog.
  • force: The installation reboots the server without displaying the Reboot Now dialog.
Note

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

--addproxies=<proxyname: proxydesc,proxyname: proxydesc,...proxyname: proxydesc>

Suppresses the Define Proxy Servers dialog box and is a comma-separated list of price proxy services names and service descriptions.

  • You can use only alpha-numeric characters and underscores in the proxyname or proxydesc. To use spaces, create an installation configuration file that contains --addproxies as an argument.
  • --addproxies=none bypasses the dialog without adding any proxies.
  • The proxyname used here, appended by the string _PriceProxy, sets the name of the Price Proxy Windows service, but has no affect on how the Price Proxy appears in Guardian.
  • You must configure priceproxy.ini and ttchron.ini with whatever name you use here followed by _PriceProxy.

Note: These names and descriptions are passed as-is to the created services, without the error checking and filtering provided by the Define Proxy Server dialog.

--aconfigxml=<file[,“ovr”]>

Suppresses the Browse to aconfig.xml dialog and specifies the AConfig.xml filename and location to be used. An optional parameter “ovr” determines whether or not to overwrite any existing AConfig.xml file in the default directory. If "ovr" is omitted, the AConfig.xml file is not overwritten.

For example, --aconfigxml=C:testaconfig.xml,ovr

Installation 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 Setup Type dialog. The ‘tt’ folder will be appended to the path if it is not provided.

--installconfig = <path>

Sets the location for TT configuration files (e.g., ttmd.cfg, ttmrd.cfg, DNModifications.cfg). The installroot must also be specified.

--installdata = <path>

Sets the location for system data files. The installroot must also be specified.

--installuserdata = <path>

Sets the location for user data files. The installroot must also be specified.

--installlog = <path>

Sets the location for log files. The installroot must also be specified.

--installpathlist = <pathlist>

Suppresses the Setup Type dialog and 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. installroot cannot be omitted.

Note

Do not add the installpathlist argument to an install configuration file.