Running the UML Migration

Warning

We strongly recommend creating a backup of each database with UML 1.4 content in ARIS 7.x before migrating it to UML 2 in ARIS UML Designer 9.x or a following version. By doing so migration problems based on inconsistencies in the UML 1.4 data can be fixed in ARIS UML Designer 7.x.

When starting the UML migration, only the administrator should be logged into the database.

UML 1.4 diagrams and elements which have not been created or saved by ARIS UML Designer 7.x are not migrated.

The UML migration is started on the Administration tab of ARIS UML Designer 9.x or a following version. You can access the Administration tab if you have selected the working environment Configuration & Administration.

After having logged into a database, its pop-up menu provides the menu item Convert to UML 2:

UML Migration Menu

This menu item opens a dialog where some options for the UML migration can be specified:

UML Migration Dialog

The option Logging level specifies the level of details which are written into the migration log file. The file is created in the log directory of the ARIS Design Server. Its name is created based on the following schema: uml2migration_<name of the database>_<date>_<time>.log. Parts of the schema marked by angled brackets are filled with the actual values.

The option Do not delete converted UML elements, which is disabled by default, is described in the chapter UML Migration Basics.

There is also an ARIS report API of the UML migration available which allows migrating databases by script (see ARIS > Help > ARIS Script > Methods for reports and semantic checks > Global objects > Report component interfaces > OMF > OMF > migrateDatabaseToOmf).

Depending on the size of the database and its amount of UML 1.4 content the UML migration takes a few seconds up to several hours.