How to invoke AMALTHEA model migration

AMALTHEA model migration utility is developed as a eclipse plugin and it is part of APP4MC distribution ( from release 0.7.0)

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

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

On click of AMALTHEA Model Migration action, selected files are parsed and the following information is retrieved:

1. AMALTHEA model version to which model is belonging to
2. Referred AMALTHEA models inside the selected model ( i.e. case of cross document references)
   • AMALTHEA model version to which these models are belonging to

Once the above information is successfully retrieved, following Model Migration dialog is opened:

Model Migration dialog consists of following information:

1. Selected AMALTHEA model files : These are the models which are explicitly selected by the user
2. Model scope files : These are the model files which are referred in the models explicitly selected by the user
   Example: In the dialog shown above, mapping.amxmi is the file selected by the user, and it contains references to the model elements of : sw.amxmi, sw.amxmi-sw, default.amxmi-os. Due to this reason, all these referred models are selected implicitly for model migration
   Note: In case if the selected/referred models are having the different AMALTHEA model versions, migration can not be proceeded and the following error dialog is displayed
   
3. Input model version : This is the AMALTHEA model version to which both selected & referred models are belonging to
   
   Note: AMALTHEA model versions are represented with the following naming convention in this dialog
   

   AMALTHEA 1.0.3	itea.103
   AMALTHEA4public 1.1.0	itea.110
   AMALTHEA4public 1.1.1	itea.111
   APP4MC 0.7.0	0.7.0
   APP4MC 0.7.1	0.7.1
   APP4MC 0.7.2	0.7.2

   
   
4. Output model version : This is the AMALTHEA model version to which both selected & referred models should be migrated to
5. Output directory : This is the location where migrated AMALTHEA models should be generated.
   Note: This option is available only if the specified output model version is 1.1.1 or higher.
   In case of AMALTHEA model versions 1.0.3 and 1.1.0 - > Model scope is set as project, where as from version 1.1.1 and higher - > model scope is limited to a folder. Due to this reason below is the behavior of model migration utility :

   • If the output model version is selected as 1.1.1 or higher - > migrated models are generated in a single folder (due to scope restriction) specified by the user
   • If the output model version is selected as 1.1.0 - > input model files will be overwritten by the migrated model files

• 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.

Special cases:

• Handling of input model files with name in the following format : <model name>.amxmi-<sub model name> ( Example: test.amxmi-sw)
  • From 1.1.1 version, files of these extension are not recognized by the AMALTHEA loader as AMALTHEA models, due to this reason if such files are supplied as input to model migration utility - > generated files will be of following convention <model name>.amxmi-<sub model name>.amxmi ( Example: test.amxmi-sw.amxmi).
    For details refer to the below image containing both input models and migrated models :