Manta Flow Upgrade Guide

This page explains how to upgrade an existing Manta Flow installation. If no version of Manta Flow has been installed, refer to the Manta Flow Installation Guide: Linux or Manta Flow Installation Guide: Windows. Before upgrading, check the Release Notes for compatibility changes, noted in italics, made to any version newer than the one you are updating from. These changes will need to be reflected in your configuration for IBM Automatic Data Lineage to work after the upgrade. Allocate extra time and secure any resources needed to make such changes.

As of IBM Automatic Data Lineage R42.15, you can upgrade only from R42.14. If you are upgrading from an earlier version, upgrade to R42.14 first and then upgrade to R42.15.

Repository Usage Statistics Collection Before every upgrade export 30 days repository usage statics from the Admin UI. Follow the guidelines below for extraction:
1. Log in into Admin UI and navigate to Configuration tab
2. From the left side Menu click on Maintenance and MANTA Repository Usage section in the middle.
3. Click on the calendar icon and select a date at least 30 days prior to date of upgrade.
4. Click on export
5. Provide the exported zip file to IBM representative.

The installer handles the upgrade on its own.

Before starting the upgrade:
1. Verify that your system meets the Manta Technical Requirements, which may have been updated when new versions of Automatic Data Lineage were released.
  1. Verify that there is enough disk space available .
2. You may want to purge old logs to reduce the disk space usage.
3. Review the Release Notes for every version of Automatic Data Lineage between the one you have now and the one you are upgrading to — especially the notes prefixed with “ Important additional information”, which indicates additional changes that need to be made after the upgrade.
Shut down all the Automatic Data Lineage services.
Verify that there are no Automatic Data Lineage processes running.
1. On Windows:
  1. Open Task Manager.
  2. Go to the Details tab.
  3. Add the Image path name and Command line columns. (Right-click on the header line and choose Select Columns.)
  4. Check all running java processes and terminate them if they are related to Manta.
2. On Linux:
  1. Run the following command.
```
ps -ef | grep manta
```
  2. Terminate all the processes; for example, using kill -f <PID>.
Run the installation process.
1. On Windows, run MantaFlow-x.y-windows-installer-*.exe using an admin account, and follow the instructions on the screen.
2. On Linux, run MantaFlow-x.y-linux-x64-installer-*.run using a root account, and follow the instructions on the screen.
Select the preferred Java version for Automatic Data Lineage to use. The installer only offers supported versions. When upgrading from an older version of Java, selecting the desired Java version in the installer is enough. The upgrade JDK used in the platform is handled automatically.
Complete the installation.
Apply the manual changes described in the Release Notes that are prefixed with “Important additional information”.
1. If using third-party integrations (Collibra, EDC, IGC), update the model to the one provided by Automatic Data Lineage with the new release. Do this by following the instructions for individual third-party connector configurations.