### How to invoke AMALTHEA model migration

#### Simple migration

An attempt to open an older model file in the model editor will show the following dialog.

The default button will simply migrate the selected file ...

- provided it doesn’t have any references (only allowing single file migration)
- the original file is renamed (the version string is added, e.g. “model_0.9.2.amxmi”)
- a log file with the current date is created (e.g. “ModelMigration__2019-07-30_15_43_44.log”)

#### Migration dialog

AMALTHEA model migration utility is developed as a eclipse plugin and it is part of APP4MC distribution

Model migration utility can be invoked by selecting the required models to be migrated in the UI and specifying the target AMALTHEA version to which models should be migrated

Step 1: Selection of AMALTHEA models

> Possible selections are:
> - a single .amxmi file
> - a folder that contains at least one .amxmi file
> - a project that contains at least one .amxmi file

Step 2: Opening AMALTHEA Model Migration dialog and configuring migration inputs

On click of AMALTHEA Model Migration action, the following Model Migration dialog is opened:

Model Migration dialog consists of following information:

1. Selected AMALTHEA model files: These are the models which are included in the selection
   Note: The check box “recursive” allows to include the contents of subfolders
2. Input model versions are displayed in the second column of the table
   Note: In case of different AMALTHEA model versions in one folder, a warning will be shown.
3. Output model version : This is the AMALTHEA model version to which the selected models files should be migrated to
4. If the check box “Create backup file” is checked then a backup file with the same name suffix as in “Simple migration” is created before the migration. Otherwise the migration will be executed in place.

Step 3: Model migration

> Once the required parameters are configured in the model migration dialog, click on “Migrate Models” button in the dialog to invoke migration.

The result of the migration will be shown in a new dialog:

Additionally a log file with the current date is created next to the migrated files (e.g. “ModelMigration__2019-07-30_15_43_44.log”).