Versions of Tekla Structures that have reached end of life can no longer connect to the Tekla Model Sharing service. The Model Sharing Recovery Tool lets you recover a shared model when the version of Tekla Structures in which the model was created can no longer connect to the Tekla Model Sharing service.
Administrators and users can reconstruct a local version of a shared model and convert it into a single-user model.
Model recovery has two stages:
-
A Tekla Model Sharing administrator creates a recovery package in the Management Console.
-
A user restores the model in the Tekla Structures main version in which the shared model was created, using the Model Sharing Recovery Tool extension.
The recovery package is a .zip file. It contains the closest baseline packet for the chosen version, the change packets in order up to that version, and a packet.dat manifest. The manifest lists chronological version numbers and change-packet GUIDs.
After a successful restore, Tekla Structures opens the reconstructed model as a single-user model. A user can open the model in a newer version of Tekla Structures and share it again to continue working collaboratively in the model.
Create a model recovery package
Create a recovery .zip file for one shared model version in the Management Console.
This task is for a Tekla Model Sharing administrator.
Tekla Model Sharing administrators start recovery by assembling the package in the Management Console.
- In the navigation pane of the Management Console for Tekla Model Sharing, click
Models to list all the shared models of your company account.
- In the Versions column for the model, click the
icon.
The Versions of the model dialog opens.
Restore a shared model with the Model Recovery Tool
Use the Model Sharing Recovery Tool extension to restore the recovery package .zip file in the Tekla Structures main version in which the shared model was created.
Before you begin, ensure that:
- You can access the recovery package .zip file from the computer where you use Tekla Structures.
- Tekla Structures is the same main version in which the shared model was created. The model information in the Management Console shows the Tekla Structures main version in which the shared model was created.
This task can be done by a Tekla Structures user or by a Tekla Model Sharing administrator.
The Model Sharing Recovery Tool extension unpacks the baseline, reads packet.dat, and applies each change packet in order. A console window shows the actions and the final result.
After successful execution, the tool outputs a reconstructed model and automatically opens it in Tekla Structures as a single-user model.
If restoring the model fails, check the following issues:
- Wrong Tekla Structures version: start the main version that is shown in model information in the Management Console.
- The extension does not run: open an existing model or create a new model before you start the extension.
- The archive fails: the .zip file must contain the baseline, the change packets, and packet.dat. If the file is incomplete, download the package again from the Management Console.
- A packet fails: read the console messages for the failing packet GUID or for missing disk permissions.
Share the recovered model
The recovered model is a single-user model. To work collaboratively in the recovered model, share it again in a newer version of Tekla Structures.