Defining Migration of Preferences

When upgrading from release 12.0 or later, your preference values are migrated to ensure a smooth transition.

The migration process occurs when Modeler is started for the first time. When the migration is complete, a dialog box informs you of the migration. Click the Show Details… button to view a detailed log of the migrated preferences. If the dialog box indicates, you may have to restart Modeler for the migrated preferences to become effective.

Note the following:

  • The migration of preference values occurs when all of the following conditions are true:
    • No preference file exists. (This is always true when Modeler is started for the first time after installation.)
    • A previous release of Modeler (12.0 or later) is already installed.
  • If more than one previous release (12.0 and later) is already installed, the migration process uses the most recent release.
  • To bypass the migration process, use the -skip_preferences_migration command-line option when starting Modeler.

The migration of preference values is based on conversion information defined in preference definition (.pref) files. If you create preferences, your preferences and their values are automatically migrated during an upgrade. To suppress the migration or to apply a conversion to a preference value, you can define delta blocks in preference definition (.pref) files.

This section includes the following topics: