Hello!

Did you know that logged in users can see a lot more content?

Multi-user system

Last updated September 10, 2019 by Tekla User Assistance tekla.documentation@trimble.com

Software version: 
2019i

Multi-user system

Multi-user system

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

  • A server computer running the multi-user server ( xs_server.exe started by the AlwaysUp utility)

  • A file server computer containing the 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.

  • Client computers running Tekla Structures

For information on the recommended multi-user setup, see Hardware recommendations.

Tekla Structures multi-user server as a service

Tekla Structures multi-user server runs as a service that is started automatically when you start the computer. You do not need to log in to the service.

Tekla Structures multi-user server performs the following main tasks:

  • Locks the model when somebody saves or numbers the model

  • Identifies client computers

  • Keeps track of active multi-users

  • Gives numbers for general arrangement drawings and multidrawings

  • Displays warnings if an another user has already edited or is currently editing drawings or the same model objectobject that is represented in a model

    A model object is either created in a model or imported into it.

To optimize the performance of a multi-user system, run as few other programs as possible on the Tekla Structures multi-user server.

Server shutdown

Users should save their working models to the master model before the Tekla Structures multi-user server is stopped. If the service is stopped before saving the working models, for example because the server computer needs a restart, simply restart the service and have users save their working models to the master model.

Install Tekla Structures multi-user server as a service

The Tekla Structures multi-user server installer installs the multi-user server as a service. When you have installed the server, the service is always available and it is automatically started when the server computer is started. There is no need to log in and no need to start the server manually every time you start your computer. Tekla Structures multi-user server allows many users to work on the same model simultaneously.

We recommend that you use the latest multi-user server version available regardless of the Tekla Structures version that you use.

  1. Download the multi-user server software installation file from Tekla Downloads.
  2. Double-click the installation file to run the installation.
  3. Follow the steps in the installation wizard to complete the installation.

    The server is by default installed to:

    c:\Program Files (x86)\Tekla Structures Multiuser Server

    You cannot change the installation path during the installation.

    If you install the multi-user server on your own computer, the server name is the name of your computer.

    The multi-user server uses TCP/IP port 1238.

The installation log is written to the xs_server.log file that is available in c:\ProgramData\TeklaStructuresServer.

Restart the multi-user server service

If you receive an error message saying that the model is locked, it might be useful to restart the Tekla Structures multi-user server service. You can restart the multi-user server service without restarting the server computer.

  1. Ensure that all users of the Tekla Structures multi-user server have been logged out of Tekla Structures.
  2. Find and open the server computer that hosts the Tekla Structures multi-user server service.

    The name of the server computer is the same as the server name that you type when you log into the multi-user modelmodel that is used for collaboration and that is opened in multi-user mode

    .

  3. On the server computer, go to ..\ProgramData\TeklaStructuresServer.

    For example, C:\ProgramData\TeklaStructuresServer.

    In the ..\ProgramData\TeklaStructuresServer folder, you may find a file called tcpip_localhost_<xxxx>.db.

  4. If the tcpip_localhost_<xxxx>.db file exists in the ..\ProgramData\TeklaStructuresServer folder, delete the file.

    If the tcpip_localhost_<xxxx>.db does not exist in the <root folder>\ProgramData\TeklaStructuresServer folder, skip step 4.

  5. Open the Windows Start menu and type Services in the search field.
  6. Click Services.
  7. In the Services dialog box, find and select Tekla Structures Multiuser Server.
  8. Click Restart and wait until the Tekla Structures multi-user service restarts.

We recommend that you reserve a particular time during the workday when the multi-user server service is restarted.

You can use the Taskin the task manager, a representation of a piece of work that needs to be carried out in order to complete a project

Scheduler
app in Windows to create a task that automatically restarts Tekla Structures multi-user server.

Install a new instance of the multi-user server service

You can have several instances of the Tekla Structures multi-user server service on the same server computer.

Installing new instances of the multi-user server service is very important if you want to have several models with the same name, because the multi-user server uses the model name to identify models.

Note that you can have approximately 80 instances of the Tekla Structures multi-user server service on the same server computer. The exact maximum number of instances is not known. If you need a large number of multi-user server services, we recommend that you divide the services between multiple server computers.

  1. Find and open the server computer that hosts the multi-user server service.

    The name of the server computer is the same as the server name that you enter when you log into the multi-user model.

  2. Go to C:\Program Files (x86)\Tekla Structures Multiuser Server.
  3. To create a new instance of the Tekla Structures multi-user server service, right-click TS_MUSaas_Install.
  4. Select Run as administrator and click Yes to confirm.

    The related Command Prompt window opens. You can see the default service name, port number and destination for the new instance. The last character of the service name is the identifier of the instance.

    The default identifier is 2 , whereas the default port number is 1239.

  5. If necessary, change the identifier or port number of the new instance.

    To

    Do this

    Change the identifier

    1. Press I on the keyboard.

    2. Press Enter.

    3. Type the new identifier.

    4. Press Enter to change the identifier.

    Change the port number

    1. Press P on the keyboard.

    2. Press Enter.

    3. Type the new port number.

    4. Press Enter to change the port number.

  6. When you are ready, press any key on the keyboard except for I , P , or Q.

    A new instance of the Tekla Structures multi-user server is installed and started.

  7. Press any key on the keyboard to close the Command Prompt window.

Uninstall an instance of the multi-user server service

If you need to uninstall an instance of the Tekla Structures multi-user server service, do the following:

  1. Find and open the server computer that hosts the multi-user server service.

    The name of the server computer is the same as the server name that you enter when you log into the multi-user model.

  2. Go to C:\Program Files (x86)\Tekla Structures Multiuser Server.
  3. To create a new instance of the Tekla Structures multi-user server service, right-click TS_MUSaas_Uninstall.
  4. Select Run as administrator and click Yes to confirm.

    The related Command Prompt window opens.

  5. Type the identifier of the instance that you want to uninstall, and press Enter.

    The identifier is the last character of the instance name. For example, if the instance name is Tekla Structures Multiuser Server 2 , the identifier is 2.

  6. Type Y to confirm uninstalling the instance, and press Enter.

    The selected instance of the Tekla Structures multi-user server service is stopped and uninstalled. All files stored in the associated multi-user server folder are deleted.

  7. Press any key on the keyboard to close the Command Prompt window.

Change the server of a multi-user model

You can change the Tekla Structures server of a multi-user model.

  1. On the File menu, click Sharing > Change multi-user server .
  2. Enter the new server name or select it from the list.
  3. Click Change.

    If the connection to the new server cannot be established, the old connection is restored.

Note:

The file .This_is_multiuser_model located in 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.

defines whether the model is a multi-user or a single-user modelmodel that is opened in single-user mode

. The file includes also the name of the server. You can open the file using any standard text editor.

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: 
No votes yet