Run synchronization tasks

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.

Synchronizer can run only one task at a time for a particular link. When you have multiple links configured, Synchronizer can run only one full synchronization task at a time, or five incremental tasks from different links.

If a task is scheduled to start automatically and another task is still running, Synchronizer resolves the conflict as follows:

  • The second task waits in a queue and runs immediately after the first task is completed.

    If the second task is of the same type (for example, both are incremental tasks), the second task does not run at all.

  • If both an incremental task and a full task are scheduled to run at the same time, the full task runs first. The incremental task enters a queue and runs when the full task is completed.

  • If the maximum number of tasks is already running, any additionally scheduled task waits in a queue, and runs as soon as one of the currently running tasks is completed.

If the maximum number of tasks is already running, you cannot start running a manual task.

Note: Records that are locked in a specific endpoint are not synchronized. Check the report at the end of any task to determine if any records were not synchronized, and why. If mapped records were not synchronized because they were locked during the run, you can update them by doing one of the following:

  • Running another incremental synchronization task after the record is modified again.

  • Resetting the link time stamp, as described in Reset a link time stamp or history.

  • Running a full synchronization task.

For details about how records are handled in incremental and full synchronizations, see Synchronization task types.

What do you want to do?

Execution pane options

While a task is running, the Execution pane at the bottom of the Synchronizer Client window enables you to do the following:

Cancel Current Task Cancel the task execution at any stage.
View Report When the task is completed, click to view a summary of the task run. For details about the data shown in the report, see View run history, reports, or logs.
Refresh Progress

Enabled only when Auto Refresh is not selected.

Click at any stage to display the next information message in the task progress.

Auto Refresh

Click to have the Synchronizer Client periodically display information messages in the Execution pane.

Clear to prevent the automatic display of these information messages.