Upgrading to Transformation Advisor 4.0 from 3.X

There is no upgrade path to Transformation Advisor 4.0.

We recommend that you upload your existing zip files again or download the discovery tool and re-run it.

Follow the process below under section Upgrading to Transformation Advisor 3.0 from 2.5.X

Upgrade Instructions

  1. Backup your existing data. Choose the option to export all your zip files via the bulkExport found here.

  2. Download the latest version of transformationAdvisor.zip from here.

  3. Uninstall Transformation Advisor.

    • ./launchTransformationAdvisor.sh
    • Choose Option 2 (Uninstall but leave the data)

  4. Check the images have been removed.

    • docker images
    • There should be no Transformation Advisor images present

  5. Explode the latest transformation-advisor-local.zip you downloaded into a new location.

  6. cd into this exploded location.

  7. Restore the data to the new location:

    • cp -a <oldLocation>/data .
    • cp -a <oldLocation>/graph_data .
    • cp -a <oldLocation>/scripts/.neo4j_pass scripts/

  8. In the new location install Transformation Advisor:

    • ./launchTransformationAdvisor.sh
    • Accept the license agreement
    • Choose Option 1 (Install)

  9. Confirm the upgrade:

    • Navigate to the provided URL.
    • You should see a list of your existing workspaces.
    • Click the three vertical dots and select What's New to show the version of Transformation Advisor.

Upgrading to Transformation Advisor 3.0 from 2.5.X

There is no upgrade path to Transformation Advisor 3.0.

We recommend that you upload your existing zip files again or download the discovery tool and re-run it.

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

Complete the following steps to migrate your data:

  1. Export the data you currently have in Transformation Advisor Use the bulk export API in TA 2.5
    /advisor/v2/collectionArchives/bulkExport
    /advisor/v2/workspaces/{workspaceId}/collectionArchives/bulkExport

  2. Uninstall Transformation Advisor by selecting option 2 Uninstall Transformation Advisor (keep database data).

  3. Install Transformation Advisor
    Install Transformation Advisor 3.0 into a different location

  4. Import your data
    Import your exported data into Transformation Advisor 3.0 using the bulkImport API
    /advisor/v2/collectionArchives/bulkImport the bulk import API for TA 3.0

Upgrading Transformation Advisor on RHEL

A video showing the upgrade process is available here.

Note: As of Transformation Advisor release 2.5.0, the images for the trial version of the product have been migrated from Docker Hub to an IBM registry icr.io/appcafe. Therefore, if you already have a non-OCP (aka TA Local) installation of version 2.4.4 or earlier, the Check for latest Transformation Advisor option won't detect that the 2.5.0 release is available. Therefore, you must re-download the install scripts from the registration and download site and run the scripts as follows.