Manta Flow Installation Guide: Windows

Important information

Important: Prior to installing IBM Manta Data Lineage, review the prerequisites here: IBM Manta Data Lineage Technical Requirements
Important: It is recommended to not modify the default ports provided during the installation, but if required, ensure the Manta administrator notes this change. You can find information regarding the ports needed for installation here: IBM Manta Data Lineage Technical Requirements
Important: This guide is for INITIAL installations of Manta Data Lineage. If you are performing an upgrade to an already existing instance of Manta Data Lineage, refer to this guide: Manta Flow Upgrade Guide
Important: This guide is applicable to Manta Data Lineage R42 and later.

Installation instructions

Follow these steps to install Manta Data Lineage:

  1. Download the most up-to-date version of Manta Data Lineage from IBM Support.

  2. Unzip the installer: mantaflow-windows-42.y.z.zip

  3. Run the installer application file as Administrator: mantaflow-42.y.z-windows-installer

    1. It may take a few minutes for the Setup Installer to launch. Wait up to a few minutes for the application to load successfully.

  4. Setup will begin, choose Next.

    step1-20240109-173046.png

  5. Choose the directory to install Manta Data Lineage to, then click Next.

    step2-20240109-165523.png

  6. Choose the correct version of Java to use with Manta Data Lineage and then press OK.

    1. There are certain vendors and versions of Java that are unsupported. Review these here: IBM Manta Data Lineage Technical Requirements

      step3-20240109-165553.png

  7. Choose to override the default machine name and change Machine hostname from localhost to your machine's Fully Qualified Domain Name (FQDN). Depending on how your server's network is configured, providing the FQDN in this field may sometimes create issues when trying to access Manta from another machine. If that is the case, you can try using your machine's hostname instead of the FQDN.

    If there is no hostname or FQDN assigned to your machine (within the network), or if there is no DNS resolver set up, you may also use your machine's IP address.

    Moreover, if you want Manta to start up every time your server starts up (recommended), check to install it as a system service.

    image-20240112-165521.png

  8. Up to and including R42.6: Input the path to the license.key file provided by Manta Data Lineage and press Next.

    step5-20240109-174053.png

    As of R42.7: the license.key file is not needed anymore.

  9. Configure your Keycloak Port, Username, and passwords. Override the Public Keycloak URL by replacing “localhost” with the provided name in step 7. The Publick Keycloak URL should look like this: http://$FULLY_QUALIFIED_DOMAIN_NAME:9090/auth then click Next.

    1. If the machine leverages a load balancer or reverse proxy, it is recommended to review the following article to ensure you are configuring the Public Keycloak URL correctly: Networking Setup Examples

      image-20240112-171224.png

  10. Configure the Artemis port, then click Next.

    step7-20240109-165948.png

  11. Configure the Configuration Service port, then click Next.

    step8-20240109-170008.png

  12. Configure the Open Manta Designer (OMD) port, then click Next.

    step9-20240109-170029.png

  13. Configure the Launcher port, then click Next.

    step10-20240109-170056.png

  14. Configure the AdminUI port, then click Next.

    step11-20240109-170120.png

  15. Configure the Flow Server and Neo4j ports, then click Next.

    step12-20240109-170143.png

  16. Configure the Agent port, then click Next.

    step13-20240109-170209.png

  17. If using Caddy HTTPS Proxy, click to enable and configure the two ports. Then click Next.

    1. If using Caddy, all traffic will be rerouted through the defined Caddy HTTPS Proxy port.

      step14-20240109-170257.png

  18. If no problems are detected, the installer will let you know. Click Next.

    step15-20240109-170326.png

  19. You are now ready to begin the installation. Click Next.

    image-20240112-171422.png

  20. You will notice a progress bar displaying the current step of the installation process. You may notice the application becomes unresponsive - this is correct. Allow adequate time for the installer to complete.

    step17-20240109-170434.png

  21. Once complete, click Launch Manta Applications, and then click Finish.

    image-20240112-171608.png

  22. Your default browser should open on the host machine and take you to the Manta Launcher webpage: http://$FULLY_QUALIFIED_DOMAIN_NAME:<LAUNCHER_PORT>/manta-launcher. This will list out all services with their respective URLs for accessing. You are now ready to begin using Manta Data Lineage.

    image-20240112-170020.png

If there are any services returning a status other than “Running” after the installation, report it to IBM Support.