Tekla Structures installation for administrators

Last updated August 26, 2017 by Tekla User Assistance tekla.documentation@trimble.com

Software version: 

Tekla Structures installation for administrators

Tekla Structures installation for administrators

You can install Tekla Structures on a workstation by either downloading the software and environments from Tekla Downloadsonline portal service for downloading Tekla product family software packages and applications

For example, Tekla Structures can be downloaded from Tekla Downloads.

Tekla Downloads is one of the Tekla Online services.

, or by centralized installation using MSI packages.

Installation from DVD is available in China. For other countries, DVD installation is available on demand only.

In addition to installing Tekla Structures on a local workstation, you also need to install a license server. If you only use one license of Tekla Structures , you can install the license server on the same computer as Tekla Structures.

If your company takes part in external projects, or if more than one user works with the same model within the company, we recommend that you use Tekla Model Sharingcloud service for collaboration and for storing and sharing a model

Tekla Model Sharing is one of the Tekla Online services.

. With Tekla Model Sharing , the users in your company can work with the same shared modelmodel used for collaboration over the Tekla Model Sharing service

With a shared model, each user works with their own model and the changes are shared through Tekla Model Sharing. A shared model requires the use of a single-user model. The same model cannot be a shared model and a multi-user model.

, offline and with high performance, and synchronize the changes with other team members even in a low-speed network. Tekla Model Sharing requires a separate subscription. You can view and manage your company's shared models with Tekla Model Sharing Management Console.

Installation requirements

Operating system

Tekla Structures installation requires that the operating system of the computer is one of the following:

  • Windows 7 SP1 64-bit
  • Windows 8.1 64-bit
  • Windows 10 64-bit

If the operating system is not one of these, the installation is cancelled. The installation also requires that Microsoft .NET Framework 4.5.1 or newer is installed on the computer. The installation of .NET Framework 4.5.1 is included in the Tekla Structures installation package, and it is executed if needed.

Hardware recommendations

For information on recommended hardware, see Tekla Structures 2017 Hardware recommendations.

Installing Tekla Structures

You can install Tekla Structures software and environments from Tekla Downloads. To have the latest software in use, we recommend that you install the latest service pack of Tekla Structures. Service packs include improvements and fixes to the latest, or a previous main or intermediate Tekla Structures version. Service packs are available for all users with a valid maintenance contract.


You need to install Tekla Structures with administrator rights.

When you use centralized installation to install Tekla Structures on the client computers, the end users do not necessary need administrator rights.

Tekla Structures installation wizard has detailed instructions about the installation. For more information, see also Install Tekla Structures.

Centralized installation of Tekla Structures

Installing Tekla Structures centrally across the company network saves time in a large company when there are many Tekla Structures users.

Centralized installation allows you to run the Tekla Structures installation silently in the background so that the users do not see the installation wizard dialog boxes. For detailed information on centralized installation, see Centralized distribution of Tekla Structures 2017.

Installing the license server

FlexNet licensing system

Tekla Structures uses a licensing system called FlexNet Publisher License Management (FlexNet), a system provided by Flexera Software. The FlexNet licensing system is activation-based, which means that hardware locks or passwords are not required. Instead, a floating license system is used where the license is stored on a license server.

When a user starts Tekla Structures , the program checks for an available license from the license server and uses that license. When the user exits Tekla Structures , the license becomes available for other users. For offline use, the user can borrow a license from the server and then return it later.

In an activation-based licensing system, the following tasks need to be performed before users can start using Tekla Structures :

  • Install and set up a license server on a computer.
  • Save the entitlement certificate and activate the licenses.
  • Connect each client computer with Tekla Structures to the license server.

Remember to take a backup of your license entitlements.

For more information, see Tekla Structures licensing system.

Operating system

The server that is used as the Tekla Structures license server does not have to be very efficient or have maximum performance capability. However, it is important to ensure that the server hardware is reliable, and to maintain the server system carefully. See Tekla Structures 2017 Hardware recommendations for information on operating systems and virtual machine platforms.

For more detailed information on how to set up the license server, see Installing Tekla Structures license server and Checklist for the Tekla Structures license server administrator.

Useful information on the FlexNet system can be found in the documents provided with the installation and in Tekla Downloads. The following introductions are available:

  • FlexNet License Administration Guides by Flexera Software are general guides that contain, for example, instructions on how to create user groups and manage access rights:
    • C:\TeklaStructures\License\Server\fnp_LicAdmin.pdf
    • C:\TeklaStructures\License\Server\LicenseAdministration.pdf

Using multiple license servers in one company

You may want to spread your license pool on several servers in your company. You may have offices in many cities, each office with its own license server, or you may simply want to divide the license pool if there is server downtime.

For example, you can divide your total license entitlement on several servers simply by activating one half of your licenses on one server and the other half of the licenses on another server. This way, if there is a maintenance break on one of the servers, you can advise your users to obtain the license from the other server.

You can also configure Tekla Structures to check licenses from several servers:

  1. In Tekla Structures , open a model and click File > Settings > Change license server.
  2. In the Server address box, give the port@host addresses of the license servers separated with a semicolon (; ).
  3. Click OK.

    The updates will take place the next time you start Tekla Structures.


Defining several license servers may slow down the starting of Tekla Structures. Therefore, we do not recommend defining more than two servers in the Connect to license server dialog box.

Monitor license usage

You can monitor the usage of Tekla Structures in your company based on the licensing information. The tool for monitoring the license usage is called LMTOOLS , and it is delivered with the Tekla Structures license server. The license server statistics area on the Statistics tab displays information about the license use. For more information, see Tekla Structures License Administration Tool options and settings.

To view which licenses are currently in use, you need to have administrator rights and take the following steps on your license server:

  1. Go to  Tekla Structures Licensing > LMTOOLS  through the  Start  menu or  Start screen , depending on your Windows operating system. 
  2. On the Utilities tab, define which license server you want to monitor. Type tekla in the Vendor Name box and your license server port@host definition in the Path box.
  3. Click Override Path.
  4. On the Server Status tab, click Perform Status Enquiry. You will now receive a listing of how many licenses and which configurations are activated on the server, and how many of the licenses are in use at the moment of enquiry.

The status enquiry functionality uses abbreviations of Tekla Structures configurations. You can find the description of the abbreviations in your entitlement certificate or in Tekla Structures License Administration Tool.

For a comprehensive description of the status enquiry syntax, see LMTOOLS options and settings used in Tekla Structures licensing.

Tekla Structures multi-user server

Multi-user mode allows several users to access the same model simultaneously. Multi-user modemode in which several users can work on the same model using their own working models

is suitable for local teams with projects where the team members work in the same location, and do not necessarily have an Internet connection.

The multi-user modelmodel that is used for collaboration and that is opened in multi-user mode

consists of a single master modelmulti-user model from and to which information is fetched and saved in multi-user mode, and into which Tekla Structures merges changes that individual users make in the working models

It is not possible to work on the master model.

. Each user can access this model and open a local view of the model. The local view is called a working modelmulti-user model that an individual user works on in multi-user mode

Working model is a local copy of a master model and the user’s current model.

. Any changes a user makes to the working model are local and not visible to other users until the working model is saved to the master model. The multi-user system can contain several client computers, where users work on their working models. The master model can be located anywhere in the network, including any of the client computers.

A Tekla Structures multi-user system runs on a TCP/IP network and consists of:

  • Tekla Structures multi-user server computer running xs_server.exe (started by the AlwaysUp utility)
  • A file server computer containing the master model
  • Client computers running Tekla Structures

The image below shows one possible configuration of the multi-user system.

The multi-user server is a separate installation that is available in Tekla Downloads.

For instructions on how to install the multi-user server and on how to run the multi-user server as a service, see Multi-user system.


When more than one user is working within the same model in different locations and at different time, use Tekla Model Sharing instead of the multi-user mode.

Installing .tsep packages

Tekla Structures extension packages, .tsep packages, are Tekla Structures extensions or additional environment content installers. .tsep packages are available for download in Tekla Warehouseservice for collaboration and for storing and sharing Tekla Structures content

In Tekla Warehouse the content items are stored in collections. Tekla Warehouse includes the Tekla Warehouse Service and the Tekla Warehouse web site.

Tekla Warehouse is one of the Tekla Online services.


You can install .tsep packages in three different ways.

Direct installation

  1. Double-click the .tsep installer that you have downloaded.
  2. The Tekla Structures extension manager dialog box opens with the name of the extension that is going to be installed.

    By default .tsep installers are opened with Tekla Structures extension manager. Some .tsep installers are run directly from Tekla Warehouse with the Insert into model option.

  3. Select the Tekla Structures versions to which you want to import and click the Import button. The next time you start Tekla Structures , the extension is automatically installed, and it is shown in Tekla Structures extension manager.

If the .tsep installer is not set to open with Tekla Structures extension manager by default, you can set it manually. Right-click on the .tsep installer and select Properties. In Opens with , select Change and browse to TsepFileDispatcherLauncher.

Installation in Tekla Structures extension manager

You can also install a .tsep installer from Tekla Structures extension manager in Tekla Structures.

  1. In the Applications & components cataloguser interface for displaying or modifying information in categorized lists

    For example, profile catalog and shape catalog are catalogs.

    , click > Manage extensions > Extension manager to open Tekla Structures extension manager.
  2. Click Import and browse to the .tsep installer that you want to install.
  3. Click Open.

    The imported .tsep is installed the next time you start Tekla Structures. It is shown in Tekla Structures extension manager , and is ready for use in the Applications & components catalog.

Centralized installation

You can centrally install a batch of .tsep installers across company workstations. This method is meant for system administrators.

By default, the .tsep installers waiting for installation are stored in \ProgramData\Tekla Structures\ <version> \Extensions\To be installed. To install centrally, you need to copy the .tsep installers to the %XSDATADIR%\Extensions\To be installed folder. Create the \To be installed folder if it does not exist yet.

When Tekla Structures starts, it will check the available .tsep installers from the \To be installed folder and install the installers automatically.

  • The installed .tsep installers are stored in the %XSDATADIR%\Extensions\Installed folder.
  • The invalid .tsep installers are uninstalled and moved to the %XSDATADIR%\Extensions\Invalid installations folder.
  • The cancelled .tsep installers are stored in %XSDATADIR%\Extensions\Cancelled installations.

Copying .tsep installers

We recommend that you use ROBOCOPY from the command prompt ( cmd.exe ) to copy the .tsep installers. More information on ROBOCOPY can be found on the Microsoft website, for example.

The basic syntax for ROBOCOPY is: robocopy <Source> <Destination> [<File>[ ...]] [<Options>]

For example, to copy .tsep installers:
"C:\ProgramData\Tekla Structures\2017\Extensions\To be installed"

This command will take all .tsep installers from the \Server1 network directory and copy them to the local user's \To be installed folder.

Centralized uninstallation

You can uninstall .tsep packages in batches by creating an empty file without an extension, with the name RemoveExtensionOnStartup , in \ProgramData\Tekla Structures\ <version> \Extensions\Installed\[Extension_To_Be_Uninstalled]. The extensions are removed the next time Tekla Structures is started.

Upgrading Tekla Structures

If you already have an older version of Tekla Structures installed on your computer, you can use Migration Wizardtool that is used for copying settings defined by the user in the earlier version of Tekla Structures

Migration wizard is typically used when starting to use a new version of Tekla Structures. The migration wizard can be used to copy settings included in initialization files.

to copy the personal settings to the new version. With the Migration Wizard you can choose to copy any of the following settings and values:

  • user.ini file
  • Registry values, such as:
    • Toolbars
    • Dialog boxes
    • General options

When you customize Tekla Structures , for example, add or change drawing or report templates and catalog entries, we strongly recommend that you create project and firm folders for the customized files. This is useful if you want to store the files for future use, or if you want to retain them when you install a new release.

Tekla Structures does not replace files in the project and firm folders when you install a new release. You can retain your customized files without having to copy and paste, or export and import from the previous versions. This makes upgrading faster and easier. If you have customized previous Tekla Structures versions without using firm or project folders, you will need to transfer the customized information to the next Tekla Structures version.

Before taking a new Tekla Structures version into use, always test that the old company settings work.


If you want to copy the settings later, you can start Migration Wizard manually by double-clicking the MigrationWizard.exe in the \Tekla Structures\ <version> \nt\bin\applications\Tekla\Migrations folder. You can select the version from which the settings are copied and the version to which the settings are copied.

Folder structure

Folder structure on local computer

See Tekla Structures installation folders for information on how the folder structure on the local computer is set up.

Company folder structure

We recommend using a central file folder for storing the models and setup files for the company-specific settings and the project-specific settings. Tekla Structures then reads the settings from the central file server. When upgrading to a new Tekla Structures version, or updating the company logo, for example, the files only need to be replaced in one place. This way taking backups and upgrading is easier.

For more information, see Project and firm folders.


As all valuable information and work your company stores, it is also important to take backups of the model folders, and firm and project settings. If your company has a system for taking automatic scheduled backups, schedule your system to take the backups at night time, outside working hours to prevent any possible conflicts in the model. Do not forget to also take a backup of the license entitlements.

Virus protection

Virus protection software has sometimes caused problems in saving models and drawings to the model folderfolder that is used for storing files associated with a model

Tekla Structures stores all files associated with a model in a folder it creates with the same name as the model database (.db1).

In multi-user mode all users access the same model folder.

. These problems may occur especially if you have your model saved on a network drive. We strongly recommend that you add Tekla Structures into the safe list of your antivirus system, and to set up your virus protection in a way that actions in your model folder are not blocked or scanned.

Quick feedback

The feedback you give here is not visible to other users. We use your comments to improve our content.
We use this to prevent automated spam submissions.
Content rating: 
Average page rating: 3.5 (2 votes)
Refresh page after voting to show updated result.