Asynchronous migration

Asynchronous migration is a background process that runs after an upgraded Quality Management (QM) server is started. The migration execution is asynchronous and does not prevent the server from working or users from performing normal activities while the migration runs.

The migration is executed through migrators. Migrators run a set of modification tasks on specific artifact types that require migration. The migration is performed on chunks of data, and runs periodically until the migration is finished or the migrator is disabled. Some new features might not be displayed in the UI until the migration is finished.

Administrators can use the asynchronous migration console to monitor the migration tasks or stop a migrator from running. The console is available at the following location: https://<domain>:<port>/<qm-context>/migration.

 Image of the  Asynchronous migration console

In the Asynchronous migration framework console, each row represents the task of a single migrator. Information that is displayed regarding the task includes:
  • Name and Description of the migrator.
  • Dependency column displays the name of a migrator that must be complete before this migrator can run.
  • Enabled column indicates whether the migrator is scheduled to run.
  • State column shows the status of the migrator.
  • Last Run Duration column provides the time it took for the migrator to run during the last execution.
  • Remaining and Completed columns show the number of artifacts that are pending and completed.
The migration states that are available:
  • UNKNOWN: The migrator has not run yet.
  • INITIALIZATION_STARTED: The migrator is being initialized.
  • IN_PROGRESS: The initialization is complete and the migrator has started.
  • WAITING_DEPENDENCY: The initialization is complete, but the migrator will not run until a dependency migrator is finished.
  • COMPLETE: The migrator execution is complete.
  • INCONCLUSIVE: A problem occurred during the initialization or execution of the migrator.

To enable or disable a migrator, click the name of the migrator in the console and set the enabled property to true or false.

Image of enabling or disabling migrator