Migrating UPIA models from previous versions

In previous versions of the IBM® Rational® modeling products, the UPIA modeling resources are based upon either a different profile, from which the UPIA profile is derived, or an earlier version of the UPIA profile. When a model from a previous release is opened, it is automatically migrated to the latest version of the UPIA profile. Auto-migration converts the previous profiles, models and diagram files into their equivalents, but there is no support for saving these resources back into the previous format.

About this task

When a previous version of a modeling resource is opened, the Rational modeling products will detect the older version and automatically perform the migration in memory. If the user does not save the model, the format of the corresponding resource on disk will remain in the previous version. When the user saves the model, the resource on disk is written in the newest version.
Note: Once a profile, model, or diagram resource has been migrated to this version and saved, the previous versions of the Rational modeling products will no longer be able to open those resources.

As part of the migration, the profile applied to the model is upgraded to the latest version, along with all of the applied stereotypes. Stereotypes and stereotype properties that have been renamed are also updated. If you added the appropriate keywords to model elements in anticipation of stereotype changes being made in the latest version of the UPIA profile, during migration the new stereotype is applied to the element; if possible, the keyword is removed. In cases where stereotypes or stereotype properties no longer exist in the newer profile, the stereotype will be removed and the corresponding model element will be marked with the "deprecated" keyword. The user must manually delete these model elements if they are no longer applicable.

For more information on UPIA profile and modeling tool changes in releases of IBM Rational modeling products, see the IBM Software Support document "UPIA modeling feature - Summary of profile and modeling changes."


Feedback