TT licenses and bills its products using license files, which define the number and type of TT client and server applications that the customer has paid to use.
After installing TT software, you must provide the set of license files that document the applications you pay to use. With the exception of TT’s Guardian application, you cannot use TT software without these license files:
- customername.txt (where customername is the name of the client): This file lists the client and server products licensed in the .LMT license file. It also describes the mode in which the product is licensed (Simulation or Production). For an example of a license text file, refer to the next section called Customername.txt.
- TTLICENSE.LMT (referred to as the .LMT file): This file is the actual license file that must be loaded into the TT Gateway so that the client can trade in Production or Simulation mode. Only one .LMT file controls the entire TT system at a client site. However, this file must be updated whenever the customer installs new products or renews his license with TT. TT encrypts this license file.
- .dll file: Named TT1300SW.dll. The .dll file contains the keys used to decrypt the TTLICENSE.LMT file discussed previously.
Guardian uses the .dll file to decrypt the .LMT file to determine which programs the customer can use. All licenses in the .LMT file include an expiration date after which you can no longer use the software. To continue using TT software, customers must review and renew their licenses on a quarterly basis.
At any time, you can quickly audit which client and server applications the customer has licensed. You can view your site license in either of two ways:
- View the customername.txt (TT recommends that you view the license file in this manner before upgrading or installing new TT software)
- View the license in Guardian
Using Guardian you can monitor the number of licensed applications (and their associated IP addresses) that are logged into the system while also viewing your license file.
To view customername.txt, either double-click the file or open it using a text editor (such as Notepad). TT stores this file in <root drive>:ttdatfiles.
The following diagram illustrates sample contents of a customername.txt file:
In the following explanations, the first two lines of the Client-Side Products section and four lines of the Server-Side Products section are described.
In the Client-Side Products section:
- In line item 1), the customer has licensed 20 (Qty) X_TRADER® clients (Product) for Production (the Simulation column is empty).
- In line item 2), the customer has licensed 20 (Qty) X_TRADER® clients (Product) for Simulation (the Simulation column reads SIMULATION).
- These X_TRADERs can access any and all TT Gateways (#Mkts*).
- The license for these client applications expires 01/15/2013 (Exp. Date).
In the Server-Side Products section:
- In line item 7), the customer has licensed a TT Eurex Gateway by the name of Eurex-B. This TT Gateway resides on a machine with the IP address of 10.17.68.100 (IP Address) and is licensed for Production use (the Simulation column is empty).
- In line item 8), the same TT Gateway is licensed for Simulation use (the Simulation column reads SIMULATION).
- Line items 9) and 10) show that the customer has licensed another TT Gateway by the same name (Eurex-B) but on another IP Address. This configuration is used to support hot failover.
- The license for these server applications expires 01/15/2013 (Exp. Date).
Viewing the License in Guardian
Guardian provides a different format for viewing your license:
For a description of this window and its columns, refer to Guardian Help.
To view the license in Guardian:
- Double-click TT in the system tray to open Guardian, and click Admin Login on the File menu to perform an administrator login (i.e., TTADMXXX001). Enter the Member Id, Group Id, Trader Id, and Password and click Login. When
you complete the administrator login, leave Guardian open.
- On the Admin menu, click License Setup.
License Usage View
In Guardian, you can view a list of all licensed applications according to your license file, and how many of these applications (and their associated IP addresses) are currently logged into the system.
To view license usage (connected clients) in Guardian:
- To open Guardian, double-click TT in the system tray.
- Click Admin Login on the File menu to perform an administrator login (i.e., TTADMXXX001). Enter the Member Id, Group Id, Trader Id, and Password and click Login. When you complete the administrator login, leave Guardian open.
- On the Tools menu, click View Connected Clients.
The Connected Client window appears.
- The Top Pane displays each connection on the TT Trading System. Thus, if a client application connects to two TT Gateways, it appears twice in the top pane; once for each TT Gateway connection. You can see this illustrated above in rows 1 and 2 in the top pane.
- The Bottom pane displays the contents of the license file (the numbers of licensed APIs and client applications) and the number of licenses left available for use. For each application, the bottom pane also displays in the Client IP column the IP address of each machine that currently uses a license.
- Close Guardian.
License Dump Files
If you run into licensing issues on your network, in Guardian, you can create a license dump file to help debug the problem.
To create and view a license dump file:
- To open Guardian, double-click TT in the system tray.
- Perform a TT Administrator login (i.e., TTADMXXX001).
- On the Guardian status view, click Guardserver.
- On the Tools menu click Dump Status. You can also right-click Guardserver in the exchange tree and select Dump Status.
- In <root drive>:ttlogfiles, locate the LicenseDmp.log file.
- Double-click the LicenseDmp.log file.
The license dump file displays in Notepad.