Preparing to install IBM Manta Data Lineage

Plan and prepare to install IBM Manta Data Lineage.

Before installing IBM Manta Data Lineage

Before you install IBM Manta Data Lineage, follow the section based on your install scenario:

New install

If you are installing IBM Manta Data Lineage without any previous versions of IBM Manta Data Lineage, or are not migrating from the previous iteration, MANTA Automated Data Lineage, then follow the instructions in Installing IBM Manta Data Lineage.

Upgrading from Version 4.8.x

If you are installing IBM Manta Data Lineage from an existing MANTA Automated Data Lineage in Version 4.8.x, follow these steps:
  1. Upgrade your Version 4.8.x IBM Knowledge Catalog (any edition) to Version 5.2.0.
    Note: Ensure that the enableKnowledgeGraph option is set to true in the wkc-cr.
    For more information, see Upgrading IBM Knowledge Catalog from Version 4.8 to Version 5.2.
  2. Uninstall MANTA Automated Data Lineage. For more information, see Uninstalling MANTA Automated Data Lineage (Masking flow).
    Important: When you uninstall MANTA Automated Data Lineage, the following will apply:
    • You will not be able to install back MANTA Automated Data Lineage once IBM Manta Data Lineage is installed.
    • All the configuration data and scanned lineage data from MANTA Automated Data Lineage will be lost. Only Metadata Imports from IBM Knowledge Catalog can be migrated using the migration tool for the supported data sources.
  3. Remove the Foundation Db cluster:
    oc delete fdbcluster wkc-foundationdb-cluster -n ${PROJECT_CPD_INST_OPERANDS}
    Note: The wdp-kg-ingestion-service and wkc-data-lineage-service pods may get stuck in the ContainerCreating state after running the command to remove the Foundation Db cluster.

    If this occurs, you can ignore this status and continue to the next step.

  4. Patch the IBM Knowledge Catalog wkc-cr with the option useFDB=false. For more information, see Specifying installation options.
    If the IBM Knowledge Catalog custom resource (wkc-cr) reconciliation fails, check if the wdp-kg-ingestion-service and wkc-data-lineage-service pods are stuck in the ContainerCreating status. If yes, then delete these two deployments:
    oc delete deploy wdp-kg-ingestion-service -n ${PROJECT_CPD_INST_OPERANDS}
oc delete deploy wkc-data-lineage-service -n ${PROJECT_CPD_INST_OPERANDS}
    Wait for the next reconciliation of the wkc-cr or restart the IBM Knowledge Catalog operator.
  5. Install IBM Manta Data Lineage. For more information, see Installing IBM Manta Data Lineage.
  6. You can migrate your lineage metadata import configuration from MANTA Automated Data Lineage. For information on migrating, see Migrating.

Upgrading from Version 5.0.x

If you are installing IBM Manta Data Lineage from an existing MANTA Automated Data Lineage in Version 5.0.x, follow these steps:
  1. Upgrade your Version 5.0.x IBM Knowledge Catalog (any edition) to Version 5.2.x.
    Note: Ensure that the enableKnowledgeGraph option is set to true in the wkc-cr.
    For more information, see Upgrading IBM Knowledge Catalog from Version 5.0 to Version 5.2.
  2. Uninstall MANTA Automated Data Lineage. For more information, see Uninstalling MANTA Automated Data Lineage (Masking flow).
    Important: When you uninstall MANTA Automated Data Lineage, the following will apply:
    • You will not be able to install back MANTA Automated Data Lineage once IBM Manta Data Lineage is installed.
    • All the configuration data and scanned lineage data from MANTA Automated Data Lineage will be lost. Only Metadata Imports from IBM Knowledge Catalog can be migrated using the migration tool for the supported data sources.
  3. Remove the Foundation Db cluster:
    oc delete fdbcluster wkc-foundationdb-cluster -n ${PROJECT_CPD_INST_OPERANDS}
    Note: The wdp-kg-ingestion-service and wkc-data-lineage-service pods may get stuck in the ContainerCreating state after running the command to remove the Foundation Db cluster.

    If this occurs, you can ignore this status and continue to the next step.

  4. Patch the IBM Knowledge Catalog wkc-cr with the option useFDB=false. For more information, see Specifying installation options.
    If the IBM Knowledge Catalog custom resource (wkc-cr) reconciliation fails, check if the wdp-kg-ingestion-service and wkc-data-lineage-service pods are stuck in the ContainerCreating status. If yes, then delete these two deployments:
    oc delete deploy wdp-kg-ingestion-service -n ${PROJECT_CPD_INST_OPERANDS}
oc delete deploy wkc-data-lineage-service -n ${PROJECT_CPD_INST_OPERANDS}
    Wait for the next reconciliation of the wkc-cr or restart the IBM Knowledge Catalog operator.
  5. Install IBM Manta Data Lineage. For more information, see Installing IBM Manta Data Lineage.
  6. You can migrate your lineage metadata import configuration from MANTA Automated Data Lineage. For information on migrating, see Migrating.

Migrating from MANTA Automated Data Lineage

If you have installed the latest version of MANTA Automated Data Lineage, but would like to switch to the newer IBM Manta Data Lineage, follow these steps:
  1. Check your version of IBM Knowledge Catalog and ensure it is also upgraded to the latest version.
    Note: Ensure that the enableKnowledgeGraph option is set to true in the wkc-cr.
  2. Uninstall MANTA Automated Data Lineage. For more information, see Uninstalling MANTA Automated Data Lineage (Masking flow).
  3. Remove the Foundation Db cluster:
    oc delete fdbcluster wkc-foundationdb-cluster -n ${PROJECT_CPD_INST_OPERANDS}
    Note: The wdp-kg-ingestion-service and wkc-data-lineage-service pods may get stuck in the ContainerCreating state after running the command to remove the Foundation Db cluster.

    If this occurs, you can ignore this status and continue to the next step.

  4. Patch the IBM Knowledge Catalog wkc-cr with the option useFDB=false. For more information, see Specifying installation options.
    If the IBM Knowledge Catalog custom resource (wkc-cr) reconciliation fails, check if the wdp-kg-ingestion-service and wkc-data-lineage-service pods are stuck in the ContainerCreating status. If yes, then delete these two deployments:
    oc delete deploy wdp-kg-ingestion-service -n ${PROJECT_CPD_INST_OPERANDS}
oc delete deploy wkc-data-lineage-service -n ${PROJECT_CPD_INST_OPERANDS}
    Wait for the next reconciliation of the wkc-cr or restart the IBM Knowledge Catalog operator.
  5. Install IBM Manta Data Lineage. For more information, see Installing IBM Manta Data Lineage.
  6. You can migrate your lineage metadata import configuration from MANTA Automated Data Lineage. For information on migrating, see Migrating.