Troubleshooting for technical lineage via Edge

In this topic

Retrieve your Edge Site Id and Job Id

If you report an error with JDBC Technical lineage running on Edge, the Customer Support team can ask you for the Edge Site Id and Job Id. The team needs this information to access details about the error.

To retrieve the Job Id, see View the summary of an technical lineage synchronization.

To retrieve the Site Id:

  1. Go to Settings.
  2. In the Edge section, click Sites.
  3. Click the name of the Edge site.
    The Edge site Id is available in the ID field.

Message "Source 'source_name' was never processed with the current useSystemName flag"

Description Solution

This error occurs when atechnical lineage capability was synchronized with the following values set differently on Edge and for the lineage harvester:

Both values must be the same even if you use technical lineage via Edge and the lineage harvester for different data sources.

 Complete the following steps:
  • Ensure that the value for the Collibra system name setting is the same with the value of the useCollibraSystemName property in the lineage harvester configuration file.
  • Synchronize the technical lineage capability again.

Message "Failed to load artifacts message"

Description Solution

If the Technical Lineage synchronization activity was not successful and you see error "failed to load artifacts" in the Lineage harvester synchronization dialog, it means the Technical Lineage capability could not be loaded in Edge.

Report this error and the Job Id to the Customer Support team for further investigation.

Message "A UNIQUE constraint failed"

Message code Description Solution

MSG-LIN-2501

A UNIQUE constraint failed.

When a technical lineage capability was being synchronized, synchronization processing failed because two capabilities were added for one BI tool data source with two different source IDs.

To resolve this issue, complete the following steps:

  1. If you do not have a lineage harvester installed, install one.
  2. Enter the list-sources command and review the listed data sources to identify the data source that was added twice.
  3. Take any of the following actions:
    • If the technical lineage capability with the source ID that you want to remove still exists on Edge:
      1. On Edge, edit the technical lineage capability for the identified data source that you want to exclude by clearing the check box.
      2. Synchronize the technical lineage capability for your data source again.
    • If the technical lineage capability no longer exists on Edge:
      1. Enter the ignore-source command with the source ID that you want to remove.
      2. Enter the full-sync command to synchronize the technical lineage again.

Message "Failed to fetch lineage API key because of a client error"

Message code Description Solution

MSG-LIN-3001

The DGC user name and DGC user password are not defined or incorrect.

Complete the following steps:

Message "MountVolume.NewMounter initialization failed" does not exist"

Description Solution

You get the following message:

MountVolume.NewMounter initialization failed for volume \"pv-shared-folder-2d53d256-fd6b-4be8-a732-fe0f1c98704e-edge\" : path \"\/var\/lib\/edge\/storage\/dir\" does not exist

When a technical lineage capability that uses a Shared Storage connection was being synchronized, the Shared Storage connection folder with the name of dir did not exist.

Complete the following steps:

For more information, go to Creating technical lineage via Edge.