Tekla Structures installation for administrators
You can install Tekla Structures on a workstation using the standard installation packages or by creating your own centralized installation using MSI packages. You can also run Tekla Structures in a Citrix virtual environment.
To use Tekla Structures , you also need to install a license server.
Tekla Online services use Trimble Identityuser account to Tekla online services and other Trimble services
For a Tekla Structures user, Trimble Identity is a single sign-on account which enables the user’s online identity management. The organization that the user’s Trimble Identity belongs to, determines the user’s access rights. Trimble Identity is needed, for example, for Tekla Campus and Tekla Warehouse, and to log in to Tekla User Assistance.
for identification. You can use your Trimble Identity with other Trimble services, such as Trimble Connect(1) Trimble’s platform for microservices in the cloud
(1) Trimble Connect platform’s microservices include services for uploading, storing, processing, and managing or consuming data. These services are meant to provide common solutions required by multiple applications.
(2) application for information sharing and collaboration for construction projects that is based on the Trimble Connect platform
(2) Reference models are used in Trimble Connect application instead of using import and export.
(2) Trimble Connect application includes web, desktop and mobile clients, and the Sync tool, for example.
and SketchUp 3D Warehouse.
Each organization has at least one account administrator, who is responsible for managing the organization group used in Tekla Online services. As an administrator, you manage the people in your organization group so that they can access the services they need. Several people in your organization can be administrators. The first user is invited by a Trimble representative, and that person is then responsible for adding other users and administrators as necessary.
As an administrator, you are responsible for:
- Inviting employees to your organization's user group to include them in your organization's maintenance contract and allow them access to the following services:
- Tekla Model Sharingcloud service for collaboration and for storing and sharing a model
Tekla Model Sharing is one of the Tekla online services.
. You must also choose the individual users who are allowed to use your organization's Tekla Model Sharing licenses and keep track of license expiration date(s).
- Tekla discussion forumsite where the users can have discussions and ask questions
Tekla Discussion Forum has a wish list for sending ideas and wishes.
Tekla Discussion Forum is one of the Tekla online services.
- Some additional content in Tekla User Assistanceonline help and self-support service for Tekla Structures
Tekla User Assistance includes instructions, support articles, and instructional videos, and it offers a possibility for feedback.
Tekla User Assistance is one of the Tekla online services.
and 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.
- Tekla Model Sharingcloud service for collaboration and for storing and sharing a model
- Removing people from your organization's user group when they no longer belong to your organization.
For more information, see Trimble Identity for Tekla Online services and Managing Trimble Identities and Tekla Model Sharing licenses.
Operating system and hardware recommendations
Tekla Structures can be installed on recent 64-bit Windows operating systems.
If the operating system is not one of the supported versions of Windows, 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.
For more information on recommended operating system and hardware specifications, see Tekla Structures 2018 Hardware Recommendations.
Installing Tekla Structures
You can download 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 to a previous main version or service pack of Tekla Structures. 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 2018.
Installation in a virtual environment
You can also run Tekla Structures in a Citrix virtual environment. Applicationpart of Tekla Structures functionality that is developed in order to extend the capability of Tekla Structures but that is not included in the Tekla Structures installation
and desktop virtualization allow users to run software from a Citrix server on the network without locally-installed Tekla Structures on their workstation. For detailed information on virtualized installation, see Using Tekla Structures with application and desktop virtualization.
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.
If you only use one license of Tekla Structures , you can install the license server on the same computer as Tekla Structures , making the license available on this one workstation. In an environment with multiple licenses and users, you install the license server in your company network, which allows for more flexible and efficient use of your licenses according to need.
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 connected to the same license server. For offline use, the user can borrow a license from the server and then return it later.
To see which license server version to use with your current Tekla Structures version , see Which license server version to use.
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.
Keep backup copies of your license entitlements in a safe place.
For more information, see Tekla Structures licensing 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 2018 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:
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:
- In Tekla Structures , open a model and click File > Settings > Change license server.
- In the Server address box, give the port@host addresses of the license servers separated with a semicolon (; ).
- 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:
- Go to Tekla Structures Licensing > LMTOOLS through the Start menu or Start screen , depending on your Windows operating system.
- 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.
- Click Override Path.
- 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.
If your company takes part in external projects, or whenever more than one user works with the same model at different locations, we recommend that you use Tekla Model Sharing instead. 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 Management Console for Tekla Model Sharing.
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 in your organization's internal network using standard TCP/IP networking 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 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.
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 times, 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 Warehouse.
You can install .tsep packages in three different ways.
- Double-click the .tsep installer that you have downloaded.
- 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.
- 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.
- 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.
- Click Import and browse to the .tsep installer that you want to install.
- 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.
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 checks the available .tsep installers from the \To be installed folder and installs them automatically. If there is an older version of the same extension package, it is uninstalled before installing the new version. Installation is cancelled if the same or newer version has already been installed.
- The installed .tsep installers are stored in the %XSDATADIR%\Extensions\Installed folder.
- Invalid .tsep installers are uninstalled and moved to the %XSDATADIR%\Extensions\Invalid installations folder.
- 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>]
robocopy "\\Server1\prod\TeklaStructures\2017\Environments_TSEP" "C:\ProgramData\Tekla Structures\2017\Extensions\To be installed" *.tsep
This command will take all .tsep installers from the \Server1 network directory and copy them to the local user's \To be installed folder.
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
You can install service packs on top of the existing installation of Tekla Structures. You can update to new service packs without updating the existing licenses. A new Tekla Structures version installs as a separate instance and can exist on the same workstation with other Tekla Structures versions. An update to a new version requires that you also update your licenses, as the licenses have a highest allowed version.
If you already have an older version of Tekla Structures installed on your computer, you can use Migration Wizardtool that is used when taking into use an updated version of Tekla Structures for copying settings defined by the user in the earlier version
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:
- 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 you start using a new Tekla Structures version, 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 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 Create 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 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.