Data Migration

Edit online

The recommended approach for any data migration is to upload the original zip files that the discovery tool produced. This can be done via the UI. If you no longer have those zip files, or you have a very large number of zip files then use the steps outlined in the following section.

Note: Do not uninstall your existing version of Transformation Advisor until you have exported any data necessary for your migration.

The steps for data migration are slightly different depending on where you have deployed Transformation Advisor.

Data Migration on Red Hat OpenShift Container Platform

Complete the following steps to migrate your data.

Back up your existing database

  1. Export your data directory from the CouchDB container.
  2. Export the data you currently have in Transformation Advisor.
    • Use the bulk export API in Transformation Advisor 2.5. Full details can be found here.
    • /advisor/v2/collectionArchives/bulkExport
    • /advisor/v2/workspaces/{workspaceId}/collectionArchives/bulkExport

Install Transformation Advisor

  1. Install Transformation Advisor 3.0 on a different OCP cluster.

    • If you do not have another OCP cluster available, complete the following steps:

      1. Detach the PersistentVolumeClaim used by Transformation Advisor 2.5.x from the Transformation Advisor instance. Doing this allows you to keep the Transformation Advisor data when you uninstall version 2.5.x. If you need to revert, re-install 2.5.x and specify the preserved PersistentVolumeClaim as an existingClaim. For more information on detaching the claim, see Preserving the PersistentVolumeClaim.

      2. Uninstall your existing Transformation Advisor 2.5.x.

      3. Install Transformation Advisor 3.0.

Import your data

  1. Import your exported data into Transformation Advisor 3.0 using the bulkImport API. Full details can be found here.

    • /advisor/v2/collectionArchives/bulkImport

Cleanup

  1. If you have installed Transformation Advisor on a new cluster, you should not delete your old Transformation Advisor instance.