Upgrading models and their fragments to the latest product version

You can upgrade a model and all the fragments that it owns to the latest version of the product at the same time, instead of individually. Upgrading a model and its owned fragments at the same time saves time and memory resources because the model and fragments do not have to go through the silent migration process each time that you load the model.

About this task

Upgrading the entire model at one time is helpful when you have a large model that is based on an older version of the product, and that is divided into thousands of owned fragments. When you open this type of model in the newest version of the product, all the fragments load silently and migrate to the latest underlying schema of the product. This migration process can take a long time and use a large amount of system resources depending on the size of the model and how it is divided into fragments.

If you make a simple change to the model, such as modifying one fragment, when you save the model and underlying fragment, the only artifacts that save in the new format are the model itself and the specific fragment that you modified. All the other fragments remain in the older format and, therefore, must go through the silent migration process again the next time that you load the model. However, you can force the model and all related fragments to upgrade so that every artifact is saved as the latest version at the same time.

To upgrade a model and its owned fragments at the same time:

Procedure

  1. Open the model to upgrade and ensure that you have both read and write access to all the owned fragments.
  2. After the model fully loads, in the Model Editor view, click the Details tab.
  3. Under the Model Operations area, click Upgrade. The Upgrade Model window opens and warns that the product might appear unresponsive for an unknown length of time, and that you should not interrupt the process until the migration is complete.
  4. To upgrade the model and its related fragments, click Yes.

Results

The model and all its associated fragments are upgraded and saved.

Feedback