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?
Run link tasks automatically
Note: If you do not specifically schedule synchronizations, you must run synchronizations manually.
-
Run an integrity check.
-
Configure the task schedule in the link's Scheduling tab:
From the navigation tree or the links grid, open the link, and click Edit.
Click the Scheduling tab, and then select Enable scheduling.
Note: To disable automatic scheduling, clear the Enable scheduling checkbox.
Schedule synchronization tasks to run in one of the following modes:
Schedule every: Schedule synchronization tasks to run at regular intervals, either hours, minutes, or for full synchronizations, days.
Run task at: Schedule synchronization tasks to run at a specific time every day, or at a specific time on specific days.
For details about the differences between incremental and full synchronizations, see Synchronization task types.
-
Enable the link. The link's tasks run as scheduled, and the progress is shown in the Execution pane below.
If a task is currently running for a specific link, a green arrow
is added to the link's icon in the navigation tree. Click Refresh Selected 
to update the information displayed.
to select specific days of the week. Run link tasks manually
Use the following steps to run integrity tests, incremental synchronization tasks, and full synchronization tasks.
- Enable the link.
-
Select the link on which you want to run the task and run the task using the Run toolbar button
or the Run Task menu commands. The task progress is displayed in the Execution pane below.
Monitor the progress of a currently running task
In the navigation tree, right-click the link on which the task is running, and select View Run.
The task's progress is displayed in the Execution pane below.
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. |
