Table of Contents

Installing TSM

Once you have Purchased TSM, you will be sent a CD or link to the TSM installation file (tsm_7_installer.exe). Before running the installer:

  1. On the machine which will host the TSM server, download and install Java from http://www.java.com/en/download/index.jsp
  2. Once completed, run the TSM installer program. Ensure you right-click on it and select 'Run as Administrator'.
  3. The installation wizard will appear. Click the 'Extract' button.
  4. Click 'Next' at the Welcome screen.
  5. Read the Terms and Conditions and select 'I accept' then click 'Next'.
  6. Select the directory to install to. This will need to be a local directory on the server. If the directory does not exist, you will be prompted to confirm its creation. If it does already exist you will be prompted to overwrite it. Note: If choosing an existing directory, it needs to be accessible to the 'Local System' user account.
  7. Select whether to install a new PostgreSQL server instance, or host the TSM database on an existing SQL server - MSSQL, PostgreSQL, or MYSQL are supported. Note: You will need to contact your IT to confirm if an existing SQL server is already installed, and obtain the required connection details.

Installing a New SQL Server

  1. PostgreSQL requires the creation of a local Windows account (called 'postgres') to run. On the Database System Administrator screen, enter and confirm the password for this account ('postgres' by default).
  2. Choose the names of the databases within the PostgreSQL to store the TSM data ('tsm' and 'tsm_repository' by default). Note these must be different.

Installing to an Existing SQL Sever

  1. After selecting to use an existing SQL server, choose which type of server to connect to and click 'Next'.
  2. Enter the IP address and Port # of the SQL server (Default port for MSSQL is 1433, 3306 for MYSQL, and 5433 for PostgreSQL). For MSSQL, also enter an Instance name. Note: We recommend installing the TSM server on the same machine as the SQL server. In this case, use 127.0.0.1 as the IP address.
  3. Select whether to use an existing database or create a new database within the server.
  4. Enter the username and password of a SQL Server Administrator. (This account will need rights to create new databases or write to existing databases specified).
  5. Enter the database names to use (new or existing). Note these must be different.

Installing the TSM Server

  1. Enter Port numbers to use for the TSM application server. These are 8080 and 1099 by default. Use the 'Check Availability' buttons to ensure these ports aren't already in use.
  2. Click 'Next'. TSM will be installed using the SQL server settings specified.
  3. Once the application is installed, select whether to create shortcuts on the desktop or start menu.

Set Up the Clients

  1. On each machine you wish to install the client application on, install Java.
  2. Once complete bring up a web browser and type in the url:
     <Server Name>:<Port>/servoy-client/tsm_head.jnlp

    Where <Server Name> is the IP address or DNS name of the server hosting TSM, and <Port> is the HTTP port specified in the setup. (e.g. http://tsmserver:8080/servoy-client/tsm_head.jnlp)

  3. Select to open the JNLP file, and OK through any security prompts.
  4. TSM will open, and create a shortcut on the current desktop which can be used to access the program in the future.
  5. Log in by specifying an organisation, username, and password.

If you have any problems, see the Troubleshooting Guide on resolving common issues which arise during installation.