Migrating apps

Migrating apps means moving apps from an older version of Qlik Sense to a newer version.

You are most likely to need to migrate an app in the following circumstances:

• When upgrading Qlik Sense.
• When importing an old app.

Apps are migrated automatically, both during an upgrade of Qlik Sense and when importing old apps. If the migration is successful, no manual steps are required. Migrated apps are available in the hub.

You can migrate apps from version 1.0 of Qlik Sense and newer, to more recent versions of Qlik Sense.

Apps that have not been migrated

When apps have not been migrated, the Apps tab on the QMC start page, shows the number of unmigrated apps. The number does not necessarily indicate that a migration has failed, it may also be that there are apps that have not yet been migrated.

With unmigrated apps, the apps overview page has an extra column, Migration status.

The following five status values can be displayed when migrating an app:

• Successful
• Ongoing
• Pending
• Migration failed
• Unknown (Displayed when there are apps with the status Pending or Ongoing, and the administrator restarts the Qlik Sense repository service (QRS), before the migration of these apps has been completed.)

Any status, except Successful, will add to the number displayed on the apps tab on the QMC start page. If all apps are successfully migrated, the migrate button and migration status column are not displayed on the apps overview page.

Migrating apps manually

If some apps have failed to migrate automatically, you can try migrating them manually.

Do the following:

1. Navigate to the apps overview page.

2. Select the apps with the status Migration failed or Unknown.

3. In the action bar at the bottom, click Migrate.

   The migration is started. If other apps are being migrated, the selected apps will have the status Pending.

The apps are migrated.