Upgrading to Transformation Advisor 4.0 from 3.X

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.

     ./launch.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:

   ./launch.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.

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.

Complete the following steps to migrate your data:

1. Export the data you currently have in Transformation Advisor using the bulk export API in TA 2.5

   (http/https)://<hostname>:2220/openapi/ui/advisor/v2/collectionArchives/bulkExport
   (http/https)://<hostname>:2220/openapi/ui/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 exported data into Transformation Advisor 3.0 using the bulkImport API

   (http/https)://<hostname>:2220/openapi/ui/advisor/v2/collectionArchives/bulkImport
   

A video showing the upgrade process is available here.