Run an integrity check

Note: This topic is relevant for ALM Synchronizer for Agile Manager only. For details about the NextGen Synchronizer see NextGen Synchronizer, or search using the NextGen Synchronizer filter.

If you are still using ALM Synchronizer, we recommend migrating to the more robust NextGen Synchronizer embedded in Agile Manager's configuration area.

Integrity checks identify possible problems that can occur during the synchronization process.

You must run an integrity check after making changes to a link and before you can enable the link and run synchronization tasks on it. Run integrity checks after creating a new link, modifying a link, or modifying the schema for one of the link's endpoints.

Integrity checks verify both general settings for the link, and the field mappings defined for the link. Each individual check within the integrity check can pass or fail. The integrity check passes only if none of the individual checks within it fail.

Caution: If you do not run an integrity check, or if the integrity check does not pass, the link remains unvalidated and cannot be enabled for synchronization. For more information about link states, see Enable or disable a link.

  1. Select Run Task > Run Integrity Check or click Run > Integrity Check.

  2. View details about the integrity check in the Execution pane at the bottom of the Synchronizer Client window. Click View Report to view the full, detailed report, with any extra error messages. You might want to view the detailed report if your integrity check failed, to determine specifically which checks failed and how to fix the link.

  3. After you fix the link, run the integrity check again.

Click below for details about the checks performed during integrity checks, as displayed in the run report.