Try TT Now

Installing

Overview

The following procedures describe how to install the TT User Setup Client and TT User Setup Server. You typically install a Maser TT User Setup Server (with client) on one machine, a Slave TT User Setup Server (with client) on another machine, and a TT User Setup Client on as many machines as needed (for example, on each risk administrator's workstation).

You can install TT User Setup using the installation wizard, or the command line interface. Refer to the following sections for more information:

Installing TT User Setup Using the Installation Wizard (7.4 to 7.17.10)

Note

TT recommends installing TT Update on the TT User Setup client. This eliminates the need to manually upgrade the TT User Setup client, and ensures that the client version always matches the TT User Setup server version.

The following installation instructions apply to TT User Setup Servers (both master and slaves) as well as TT User Setup Clients.

To install TT User Setup:

  1. Double-click the TT User Setup installation executable to start the installation wizard.
  2. Follow the on-screen instructions until the wizard displays the Component Selection window.
  3. If this machine is a TT User Setup Server, install both the server and the client by checking both the TT User Setup Client and TT User Setup Server check boxes. If this machine is a TT User Setup client not controlled by TT Update, check only the TT User Setup Client checkbox.

    The client installation installs only the TT User Setup Client software. The server installation installs the TT User Setup Server, as well as the TT User Setup Utility, TT Messaging, TT Chron, and Guardian.

  4. Continue following the on-screen instructions until the wizard displays the Installation Completed window.
    Note

    During the installation you will be prompted to browse to an aconfig.xml file. If this is the first TT product in your network, skip this step and allow the installation to create a custom aconfig.xml file. If this is not the first TT product in your network, browse to a copy of the current aconfig.xml file for your network.

  5. Click Finish.

You have successfully installed the TT User Setup Client and/or Server.

Note

If you installed only the TT User Setup client, then installation is complete. If you installed a TT User Setup server, continue to Applying the GuardServer License and then complete the remaining topics in this chapter.

Installing TT User Setup Using the Installation Wizard (7.17.13 or Higher)

Note

TT recommends installing TT Update on the TT User Setup client. This eliminates the need to manually upgrade the TT User Setup client, and ensures that the client version always matches the TT User Setup server version.

The following installation instructions apply to TT User Setup Servers (both master and slaves) as well as TT User Setup Clients.

To install TT User Setup:

  1. Double-click the TT User Setup installation executable to start the installation wizard.
  2. Follow the on-screen instructions until the wizard displays the Component Selection window.
  3. If this machine is a TT User Setup Server, install both the server and the client by checking both the TT User Setup Client and TT User Setup Server check boxes. If this machine is a TT User Setup and/or TT User Setup API client, check only the TT User Setup Client and/or TT User Setup API checkbox.

    The client installation installs only the TT User Setup Client or API software. The server installation installs the TT User Setup Server, as well as the TT User Setup Utility, TT Messaging, TT Chron, and Guardian.

  4. Continue following the on-screen instructions until the wizard displays the Installation Completed window.
    Note

    During the installation you will be prompted to browse to an aconfig.xml file. If this is the first TT product in your network, skip this step and allow the installation to create a custom aconfig.xml file. If this is not the first TT product in your network, browse to a copy of the current aconfig.xml file for your network.

  5. Click Finish.

You have successfully installed the TT User Setup Client, API, and/or Server.

Note

If you installed only the TT User Setup client or API, then installation is complete. If you installed a TT User Setup server, continue to Applying the GuardServer License and then complete the remaining topics in this chapter.

Installing TT User Setup 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., tt_user_setup_r7.4.6p17.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, such as Notepad, 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”

installconfig=c:ttconfig

installdata=c:ttdatfiles

installlog=c:ttlogfiles

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 TT User Setup 7.4.6 package 17 using an installation configuration file named Install.txt located on the C: drive:

tt_user_setup_r7.4.6p17.exe -a --installcfg=c:Install.txt

To install TT User Setup using the command line interface:

  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 (from the Start menu, select Run, and then type cmd).
  3. When the command window appears, enter 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.

TT User Setup Command Line Installation Arguments
ArgumentFunction

--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=[“force”| “promptrestart”|“norestart”]

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.

--setupclient

Specifies that the client component should be installed for TT User Setup.

Note

The Components dialog will NOT be suppressed if the –-setupserver parameter is also passed, or if TT User Setup server is already installed.

--setupapi=1

Specifies that the API component should be installed for TT User Setup.

Note

Applies to 7.17.13 and later.

--setupserver

Specifies that the server component should be installed for TT User Setup. .

Note

The Components dialog will NOT be suppressed if the –-setupserver parameter is passed.

--ttustypesilent

Suppresses the display of the Components dialog even if the Server type is selected.

--noadminutil

Specifies that the User Setup Administration Utility should not be launched after installation.

--accept_eula

Accepts the license agreement and stores the accepted EULA.

--skipdesktop

Skips adding desktop icons to the desktop.

--nofinaldialogs

Suppress the final success or fail dialog.

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

Note: When installing on a machine running Windows Server 2008, if you place the install root in the Program Files directory, you must select a different location for the ttconfig, ttdatfiles and ttlogfiles directories by using the installconfig, installdata and installlog arguments.

--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. The installroot must also be specified.

Note

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

Note

If you installed only the TT User Setup client, then installation is complete. If you installed a TT User Setup server, complete the remaining topics in this chapter.

Applying the GuardServer License

TT User Setup Server can only be run on a machine that is running a licensed GuardServer. If there is no available license, then contact your TAM and request a LOGIN SERVER license for the TTGLOBAL exchange.

Once you receive your license from TT, you must apply it using the Guardian License Setup window. After the license is published, the Guardian Applications and Exchange Servers Tree will display the GuardServer and Login Server under the appropriate exchange or TTGLOBAL section.

To apply and publish a license

  1. Log into Guardian as an administrator.
  2. From the Admin menu, click License Setup.
  3. Click Load File and then browse to your new license file.
    Note

    The license file has an .LMT extension.

    The License Setup window refreshes and displays your license.

  4. From the License Setup window, highlight your license and click Publish.
Note

TT recommends that you publish after trading hours.

You have successfully applied and published a license.

When TT User Setup Servers are running, each server will display a GuardServer and Login Server in Guardian. These components are listed under the TTGLOBAL section of the Guardian Applications and Exchange Servers tree.

Synchronizing System Clocks

If you use the optional Max Concurrent Logins functionality in TT User Setup, the system clocks on all TT User Setup Servers must be in synch and running on the same time zone. A common way to do this is to connect the TT User Setup Servers to a Network Time Protocol (NTP) server. For more information about NTP and Time Synchronization, refer to the TT Hardware / Software Optimizations and Recommendations Reference Guide.

Initially Starting Guardian and GuardServer

After installing the TT User Setup Server(s), start the TT Guardian and TT Guardian Server services, but do not start the TT User Setup service(s) or TT Chron. For a first-time installation of TT User Setup, the TT Guardian Server requires a few minutes to initialize and sync with the risk data in the environment, as well as download all the trader MGTs from Guardian. When determining the amount of initialization time required, you should consider the size of the environment. Larger environments require more time.

Note

Before starting the TT Guardian and TT Guardian Server services, your setup may require you to first configure the Guardian Daemon settings (i.e. the port or multicast address), by clicking Daemon Setup on the Config menu in the Guardian client.

Note

By default, the TT Guardian and TT Guardian Server services are installed as automatic services and should start whenever your machine is started.

To start Guardian and GuardServer via the Services window

  1. From the Control Panel, click Administrative Tools, and then Services.
  2. Start the TT Guardian and TT Guardian Server services.

Initially Configuring TT User Setup Using the TT User Setup Utility

Before using your TT User Setup Server, you must run the TT User Setup Utility, which is accessible from your desktop or your machine's install directory (~tttt_user_setupUserSetupUtil.exe).

From the TT User Setup Utility, perform the following procedures:

Any update made in the TT User Setup utility (other than creating a database, creating initial database tables, and upgrading an existing database) is read from the Master Server and the data is automatically pushed to any Slave Servers. Because of this, when running a TT User Setup utility procedure other than those mentioned above, you only have to run the procedure on the server designated as the Master Server.

Note

You must restart the TT User Setup Server after making any changes in the TTUserSetupServer.ini file or in the TT User Setup Utility.

Creating an Empty User Setup Database

Perform the following procedure to create a database for your TT User Setup Server and to define a destination for your database file.

To create an empty database:

  1. Open the TT User Setup Utility (using the desktop icon or tttt_user_setupUserSetupUtil.exe).

    (7.17)

    (7.4)

  2. Click Create Empty TT User Setup DB.

    The Create TT User Setup DB window displays.

  3. In the New TT User Setup DB field, choose either the default database name or create a custom name.
  4. In the Create in folder field, ensure the destination path for your database file is properly configured. If you need to modify the path, click Select Folder.
    Note

    If you change the name or location of your database, make sure to update the Database Location as described in Editing the Server Configuration File .

  5. Click Create.

Creating the Database Tables and Initial Data

After creating a database, you must then run SQL scripts to format your database and create database tables.

To create the database tables and initial data:

  1. From the TTUserSetupUtil window, click Run SQL Script Against TT User Setup DB.

    The Run SQL Script window displays.

  2. Click the Create database tables and initial data option.
  3. In the TT User Setup DB file field, ensure the filename matches the database you created in the Creating an Empty User Setup Database procedure. If it doesn't match, click Browse and locate the file.
  4. Click Run.

    A Log window displays as the scripts run. If successful, the Log window should display the following message:

    If your Log window displays differently or indicates an error, contact TT's Customer Support Center.

Editing the Server Configuration File

Use this feature to update the TTUserSetupServer.ini file without opening and manually updating the file. The Edit Server Configuration File window contains the following options:

  • Database Replication Role section: Configure one TT User Setup Server as a Master, and configure each additional TT User Setup Server as a Slave. Each environment must contain exactly one running master TT User Setup Server. New servers are configured as Slave by default.
  • Database Location section: Sets the name and location of the newly created database in the TTUserSetupServer.ini file.

To edit the server configuration file:

  1. From the TTUserSetupUtil window, click Edit Server Configuration File.
  2. From the Database Replication Role section, select either Master or Slave.
    • The Master TT User Setup Server is installed exactly once in each environment. You must select this option if this is the first installation of a TT User Setup Server to ensure that a Master Server is available.
    • Select the Slave option if a Master TT User Setup Server is already installed. The Slave will be installed on a separate server from the Master TT User Setup Server and will maintain its own database (.mdb) file that is synchronized with the Master Server's database.
  3. In the PreSharedKey field, enter the password that will be shared between the Master and Slave servers. TT User Setup will verify that the PreSharedKey from any Slave matches the Master before syncing the database with the Master server.
  4. From the Database Location section, in the TT User Setup DB file field, accept the default database file or click Browse to locate the correct database file.
  5. Click Save.
Note

You should regularly back up the local database (.mdb file) and the TTUserSetupServer.ini file on the TT User Setup Master Server machine. For additional information on database backup, refer to the topic entitled Restoring Master Server Data from a Backup.