For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.

Analytics data migration

Learn about migrating data in the IBM MobileFirst™ Analytics.

The internals of the MobileFirst Analytics Console were improved, which required changing the format in which the data is stored. To continue to interact with the analytics data that was already collected, the data must be migrated into the new data format.

When we first view the MobileFirst Analytics Console after you upgrade to V8.0.0, no statistics are rendered in the MobileFirst Analytics Console. Your data is not lost, but it must be migrated to the new data format.

An alert is displayed on every page of the MobileFirst Analytics Console that reminds you that documents must be migrated. The alert text includes a link to the Migration page.

The following image shows a sample alert from the Overview page of the Dashboard section:

Migration page

We can access the Migration page from the wrench icon in the MobileFirst Analytics Console. From the Migration page, we can see how many documents must be migrated, and which indices they are stored on. Only one action is available: Perform Migration.

The following image shows the Migration page when you have documents that must be migrated:

Note: This process might take a long time, depending on the amount of data you have, and it cannot be stopped during migration.

The migration can take approximately 3 minutes to migrate 1 million documents on a single node with 32G of RAM, with 16G allocated to the JVM, with a 4-core processor. Documents that are not migrated are not queried, so they are not rendered in the MobileFirst Analytics Console.

If the migration fails while in progress, retry the migration. Retrying the migration does not remigrate documents that were already migrated, and your data integrity is maintained.

Parent topic: Install MobileFirst Analytics Server V8.0.0 on servers running previous versions