blob: 79e366587b7ca508188d479e62df4f6cac0a660b [file] [log] [blame]
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