APP4MC AMALTHEA Headless Migration Tool


Launch via executable jar (uses the bnd launcher)

  java -jar amalthea_migration.jar [-v, --version <model_version>] [-r, --recursive] [-nb, --nobackup] <filename>

    Options:
      -v, --version   The model version to which the model should be migrated to [optional].
                      If not provided the latest supported version will be used.

      -r, --recursive If folders should be traversed recursively [optional].
                      If not provided only the files in the given folder will be migrated.

      -nb, --nobackup If backup files should be created before the migration process [optional].
                      If not provided a backup file will be created for every model file.

    Parameter:
      filename        The filename of the model file or the folder that contains model files to migrate


    Examples:

    Trigger a migration of the test.amxmi file to the latest supported model version:
    java -jar amalthea_migration.jar test.amxmi

    Trigger a migration of the test.amxmi file to model version 0.9.5:
    java -jar amalthea_migration.jar -v 0.9.5 test.amxmi

    Trigger a migration of the test.amxmi file to the latest supported model version without file backup:
    java -jar amalthea_migration.jar -nb test.amxmi

    Trigger a migration of all model files in the folder test to the latest supported model version:
    java -jar amalthea_migration.jar test

    Trigger a migration of all model files in the folder test and subfolders to the latest supported model version:
    java -jar amalthea_migration.jar -r test

    Open the model migration in interactive mode:
    java -jar -Dosgi.console= amalthea_migration.jar

	Start the migration with modified console log level (default is ERROR):
	java -jar -Dapp4mc.log.level=DEBUG amalthea_migration.jar



OSGi console interaction:

  app4mc:convert - start an AMALTHEA model migration

    convert [-v, --version <model_version>] [-r, --recursive <true|false>] [-nb, --nobackup <true|false>] <filename>

    Options:
      -v, --version   The model version to which the model should be migrated to [optional].
                      If not provided the latest supported version will be used.

      -r, --recursive If folders should be traversed recursively [optional].
                      Value needs to be provided as true|false.
                      If not provided only the files in the given folder will be migrated.

      -nb, --nobackup If backup files should be created before the migration process [optional].
                      Value needs to be provided as true|false.
                      If not provided a backup file will be created for every model file.

    Parameter:
      filename        The filename of the model file or the folder that contains model files to migrate

  help - lists all available commands in the OSGi shell

  exit - exit the OSGi console