1. Home
  2. Tekla Structures
  3. Share models and files
  4. Working collaboratively within a Tekla Structures model
  5. Tekla Model Sharing
  6. React to Tekla Model Sharing error messages

React to Tekla Model Sharing error messages

Tekla Structures
Modified: 9 Oct 2023
2024
Tekla Structures

React to Tekla Model Sharing error messages

If you encounter problems, check the following error messages for troubleshooting.

For general Tekla Model Sharing troubleshooting instructions, see Troubleshooting Tekla Model Sharing.

Licensing, sign-in, and opening errors

Message: Failed to open model.

Description: This message appears when the selected model cannot be opened.

This can happen if a model is corrupted, or if another program is reserving files that are important for opening the model.

Solution:
  1. Look for errors in the following log files:

    • In the \logs folder under the model folder: modelsharing.log, error_<user>_<YYYYMMDD>_<HHMMSS>.log, and sharingfacade.log

    • In the \TeklaStructuresModels folder: TeklaStructures_<user>.log

    • In the \Users\<user>\AppData\Local\Tekla DataSharing folder: ClientLog_cat.txt and ClientLog_dog.txt

  2. Proceed as the error messages require.

    For example, if another application is blocking a file, close that application.

  3. If you do not know how to proceed or the issues persist, contact Tekla Structures support.

- - -

Message: Invalid database files have been detected: [invalid files]

Description: When you open a shared model, certain database files are checked.

This message appears if there are issues in the database files that are checked. The invalid files are listed at the end of the error message.

Solution:
  1. Look for errors in the following log files:

    • In the \logs folder under the model folder: modelsharing.log, error_<user>_<YYYYMMDD>_<HHMMSS>.log, and sharingfacade.log

    • In the \TeklaStructuresModels folder: TeklaStructures_<user>.log

    • In the \Users\<user>\AppData\Local\Tekla DataSharing folder: ClientLog_cat.txt and ClientLog_dog.txt

  2. Proceed as the error messages require.

    For example, if another application is blocking a file, close that application.

  3. If the model is currently open, diagnose and repair the model.
  4. If the problem persists, try to take a backup copy in use by replacing all .db files in the model folder with .db.bak files.

- - -

Message: Login failed

Description: Signing in to the Tekla Model Sharing sharing service has failed.

Solution:
  1. Open Internet Explorer and clear the browser cookies.
  2. Optionally, sign out from all Tekla Online services and ensure the services do not automatically remember your sign-in information.
  3. Try signing in again.
  4. If the issues persist, contact Tekla Structures support.

- - -

Message: Model does not exist.

Description: The model that you are trying to open has been deleted from the Tekla Model Sharing Service.

Solution: If you need to access the deleted model, contact Tekla Structures support.

- - -

Message: Model requires environment: [Environment name]

Description: The model has been shared with a particular environment, but you are trying to join the model using another environment.

We recommend that you use the original environment, if possible. Using another environment might cause problems when you are working with the model.

Solution: According to your situation, do either of the following:
  • To join the model with another environment, click OK.
  • To use the original environment, click Cancel and switch to the original environment.

- - -

Message: The command could not be completed, Tekla Structures must close. After restarting Tekla Structures run diagnose & repair command and try again.

Description: Tekla Structures cannot perform the selected command right now because of errors and inconsistencies in model objects or the library database (xslib).

Solution:
  1. Restart Tekla Structures.
  2. Open the shared model that you were working with when Tekla Structures was closed.
  3. On the File menu, click Diagnose & repair, and select an appropriate command.

    For more information, see Diagnose and repair the model.

  4. Try to perform the selected command again.

- - -

Message: The command could not be completed, Tekla Structures must close. Try again after restarting Tekla Structures.

Description: Tekla Structures cannot perform the selected command right now.

For example, this might happen because of a database issue or a canceled operation.

Solution:
  1. Restart Tekla Structures.
  2. Open the shared model that you were working with when Tekla Structures was closed.
  3. Try to perform the selected command again.
  4. If the issues persist, contact Tekla Structures support.

- - -

Message: You do not have permissions to remove model from service.

Description: For safety reasons, only Tekla Model Sharing users with the Owner role can exclude models from the Tekla Model Sharing sharing service.

This message appears if you are trying to exclude a model from the Tekla Model Sharing sharing service, but your role (Editor, Viewer, or Project viewer) does not allow doing that.

Solution: Do either of the following:
  • Ask a user with the Owner role to change your role.
  • Ask a user with the Owner role to exclude the model from the Tekla Model Sharing sharing service.

- - -

Message: Your Tekla Model Sharing license subscription expires in [X] days.

Description: Your Tekla Model Sharing subscription is about to expire.

Solution: Contact your organization's administrator and ask them to renew your subscription.

File removal errors

Message: Removing model from the service failed.

Description: Tekla Structures cannot exclude the model from the Tekla Model Sharing sharing service.

Solution:
  1. Try again.
  2. If the issues persist, contact Tekla Structures support.

- - -

Message: Removing model from the computer failed.

Description: You cannot delete the selected model from your computer.

Solution:
  1. Ensure that the model still exists on your computer.
  2. Ensure that the model or any of its files are not open in Tekla Structures or in another application.
  3. Try again.

- - -

Message: Removing model from the computer failed. Model is in use.

Description: You cannot delete the selected model from your computer because the model is currently open.

Solution:
  1. Close the model.
  2. Try deleting the model again.

- - -

Message: The Tekla Cloud service cannot be removed from list of known services.

Description: Users cannot delete the Tekla Cloud service.

Role and permission errors

Message: Your permission level has been modified. You no longer have permissions to manage users for this shared model. You can continue to use the model otherwise. Contact the model owner if you need permissions.

Description: A Tekla Model Sharing user with the Owner role has changed your role in the shared model, so that you can no longer manage the users of the model in the Users dialog box.

Solution:

Do either of the following:

  • Ask a user with the Owner role to change your role to Owner. Then, try again.
  • Ask a user with the Owner role to manage the users as necessary.

Sharing and connection errors

Message: Check the port number.

Description: The port number is incorrect.

Solution:

  1. Find out the correct port number.
  2. Type the correct port number, and try again.

- - -

Message: Check the server name.

Description: The server name is incorrect.

Solution:

  1. Find out the correct server name.
  2. Type the correct server name, and try again.

- - -

Message: Connecting to model sharing service failed as the email is already in use in another organization.

Please check the model sharing log, and contact Tekla Structures support if the problem persists.

Description: You cannot connect to the Tekla Model Sharing service because the email address that you are using has been added to another organization.

A user can only be added to one organization at a time.

Solution: According to your needs, do one of the following:

  • Ask your organization's administrator to move you back to the original organization and add you to the new organization as an external license user.

    This way, you can work on existing models. Note that as an external user, you cannot start sharing new models.

  • Create a new email address in the new organization, and then, create a new Trimble Identity using the new account.
  • If you need full access to the models of both organizations, contact Tekla Structures support.

- - -

Message: Connection to proxy server failed.

Description: Tekla Model Sharing cannot connect to the proxy server.

Solution:
  1. Ensure that you have access to the proxy server.
  2. Ensure that the proxy server is running.

Even when Tekla Model Sharing cannot connect to the proxy server, Tekla Model Sharing can retrieve information using the sharing service.

- - -

Message: Different Tekla Structures versions cannot be used in the same model sharing project.

You can save the model and start sharing again to create a new project, or close the model without saving and continue with the original version [version number].

Description: All users need to use the same Tekla Structures version when working on a shared model.

This message appears if you try to open a shared model with a different Tekla Structures version.

Solution: Do either of the following:
  • Save the model in the Tekla Structures version that you are using, and start sharing the newly saved model.
  • Close the model without saving it and open the model using the Tekla Structures version with which the model was originally shared.

- - -

Message: Exclude from sharing failed.

Description: Tekla Structures cannot exclude the model from the Tekla Model Sharing sharing service.

Solution:
  1. Look for errors in the following log files:
    • In the \logs folder under the model folder: modelsharing.log, error_<user>_<YYYYMMDD>_<HHMMSS>.log, and sharingfacade.log

    • In the \TeklaStructuresModels folder: TeklaStructures_<user>.log

    • In the \Users\<user>\AppData\Local\Tekla DataSharing folder: ClientLog_cat.txt and ClientLog_dog.txt

  2. Proceed as the error messages require.

    For example, if another application is blocking a file, close that application.

  3. If you do not know how to proceed or the issues persist, contact Tekla Structures support.

- - -

Message: Failed to write out model changes. Reason: Failed to create the data. Path is too long. maximum length is 125.

Description: The shared model is located on a network drive whose path is too long.

- - -

Message: Fatal database integrity error discovered during the operation. Use the Diagnose Model command to find problematic objects.

Description: Some of the databases that the model uses have been corrupted. Tekla Structures needs to diagnose the model to find out how the model can be repaired.

Solution:
  1. Go to File menu and select Diagnose & repair > Diagnose model.

    The errors and inconsistencies found in the model are listed in a report. Some of them are automatically corrected, some of them are warnings that you need to correct manually.

    For more information, see Diagnose and repair the model.

  2. If you do not know how to proceed or the issues persist, contact Tekla Structures support.

- - -

Message: Not enough memory.

Description: A change management operation has failed because of insufficient system memory.

- - -

Message: Operation is not allowed for shared model.

Description: This message appears when you are trying to fix ID gaps in a shared model. Fixing ID gaps is only used to repair models that are not shared and that have been saved in Tekla Structures 2016i or older.

Solution:
  1. To release memory, close some open applications.
  2. Try again.

- - -

Message: Sharing operation failed.

Description: Tekla Model Sharing cannot find all necessary information.

Solution:
  1. Ensure that you have not used characters that Tekla Model Sharing cannot recognize, such as semicolon (;).
  2. Look for errors in the following log files:

    • In the \logs folder under the model folder: modelsharing.log, error_<user>_<YYYYMMDD>_<HHMMSS>.log, and sharingfacade.log

    • In the \TeklaStructuresModels folder: TeklaStructures_<user>.log

    • In the \Users\<user>\AppData\Local\Tekla DataSharing folder: ClientLog_cat.txt and ClientLog_dog.txt

  3. Proceed as the error messages require.

    For example, if another application is blocking a file, close that application.

  4. If you do not know how to proceed or the issues persist, contact Tekla Structures support.

- - -

Message: Sharing operation failed. Please check the Internet connection and Tekla Model Sharing Status in https://status.tekla.com/.

Description: Tekla Model Sharing cannot retrieve all necessary information.

Solution:
  1. Check that your Internet connection works properly.
  2. Go to https://status.tekla.com/ and check the Tekla Model Sharing Status.

- - -

Message: Sharing operation failed. Please check the model sharing log, and contact Tekla Structures support if the problem persists.

Description: Tekla Model Sharing cannot retrieve all necessary information.

Solution:
  1. Open the \logs folder under the model folder.
  2. Look for error messages in the modelsharing.log file.
  3. Proceed as the error messages require.
  4. If you do not know how to proceed or the issues persist, contact Tekla Structures support.

- - -

Message: Sharing operation failed. Service could not be reached - realm or server address could be wrong. Please check the model sharing log, and contact Tekla Structures support if the problem persists.

Description: Tekla Model Sharing cannot retrieve all necessary information.

Solution:
  1. Open the \logs folder under the model folder.
  2. Look for error messages in the modelsharing.log file.
  3. Proceed as the error messages require.
  4. If you do not know how to proceed or the issues persist, contact Tekla Structures support.

- - -

Message: Invalid database files have been detected: [invalid files].

The versions of these databases do not match. To enable sharing operations in this model, backup files will be used.

Description: Some of the databases used in the shared model have been deleted or replaced with irrelevant databases. Instead, Tekla Structures automatically uses the available backup files. You do not need to react to this message.

- - -

Message: Invalid database files have been detected: [invalid files].

The versions of these databases do not match. To enable sharing operations in this model, databases are needed from a model that has the correct version (packet number).

Description: Some of the databases used in the shared model have been deleted or replaced with irrelevant databases. Because of this, Tekla Structures cannot open the model.

Solution:
  1. In the shared model, join the packet that is mentioned in the error message.
  2. Open File Explorer and copy the necessary database file to the newer version of the model.
  3. Try opening the model again.

- - -

Message: This model has been shared in a previous version. Sharing operations cannot be used in this release. If you save the model in this version, it will be excluded from sharing.

/

This model has been shared in a previous version. If you save it now, it will be excluded from sharing.

Description: The current model has been shared in an earlier Tekla Structures version, so you cannot share your changes or read in other users' changes with a newer Tekla Structures version.

Solution:

Do either of the following:

  • Close the model without saving, and open it with the earlier Tekla Structures version with which it has been shared.
  • If you want to use the current version of Tekla Structures, save the model and start sharing the model again with the newer version.

    Note that all other Tekla Structures users in the project also need to use the newer version.

Read-in and write out errors

Message: Another user has reserved the next write out

Description: This message appears if another user has already reserved the next write out.

You cannot reserve the next write out if another user has already reserved it.

Solution: Do any of the following:

  • Find out who the other user is and ask them to release the next write out.
  • Wait for the other user to write out their changes before you write out your changes.
  • Wait for an hour.

    If the other user does not write out their changes in that time, the next write out will be released.

  • Ask a user with administrator rights to unlock the model in Management Console for Tekla Model Sharing.

    When an administrator unlocks the model, the next write out is released.

- - -

Message: Failed to populate the changes list

Description: This message appears when change management fails to show the list of latest changes.

Solution:

  1. Look for errors in the following log files:

    • In the \logs folder under the model folder: modelsharing.log, error_<user>_<YYYYMMDD>_<HHMMSS>.log, and sharingfacade.log

    • In the \TeklaStructuresModels folder: TeklaStructures_<user>.log

    • In the \Users\<user>\AppData\Local\Tekla DataSharing folder: ClientLog_cat.txt and ClientLog_dog.txt

  2. Contact Tekla Structures support.

- - -

Message: Failed to release next write out.

Description: This message appears if you cannot release the write out that you previously reserved.

This is usually an Internet connection issue.

Solution:

  1. Check your Internet connection.
  2. Try again.

    OR

    Wait one hour. The write out is automatically released after that time.

- - -

Message: Failed to reserve next write out.

Description: This message appears if you cannot reserve the next write out.

Solution:

  1. Check your Internet connection.
  2. Try again.

    OR

    Find out if another user has reserved the next write out. If yes, you can ask them to release the next write out.

- - -

Message: No new shared data available.

Description: You can only read in changes that other users have shared.

This message appears in the status bar at the bottom of Tekla Structures when you try to read in other users' changes, but no new changes have been shared.

- - -

Message: Please provide comment for operation

Description: A comment is required whenever you reserve the next write out in a shared model.

This message appears if you have attempted to reserve the next write out without typing a comment.

Solution:
  1. Click OK to close the error message.
  2. Type a comment that describes why you want to reserve the next write out.
  3. Click Reserve.

- - -

Message: The following characters are not allowed in Code or Comment field: < & >

Description: This message appears if you try to use the characters "<", "&", or ">" when you type a revision code or comment at write-out.

Note that you can only type revision codes or comments if the Enable write out revision comment check box is selected in the Sharing settings dialog box.

Solution:
  1. Remove the forbidden characters from the revision code or revision comment.
  2. Click Save to write out your changes.

- - -

Message: The revision code exceeds maximum length ([X] out of [Y] characters used).

Description: The revision code that you have typed is too long.

Solution: Type a shorter revision code.

- - -

Message: The revision comment exceeds maximum length ([X] out of [Y] characters used.)

Description: The revision comment that you have typed is too long.

Solution: Type a shorter revision comment.

- - -

Message: Write Out is not allowed because the model is not up to date. Use Read In to update the model.

Description: You cannot write out your changes before you have read in the changes that other users have made before you.

Solution:
  1. On the File menu, click Sharing > Read in, or click on the Quick Access Toolbar.
  2. View the changes made by other users.
  3. To share your changes, on the File menu, click Sharing > Write out, or click on the Quick Access Toolbar.
Was this helpful?
Previous
Next