Initial Synchronization

Owned by Jeff Gleeson
Last updated: Jan 11, 2024
3 min read

Initial Synchronization overview

Initial synchronization allows you to synchronize the Jira project items and Azure DevOps project work items that existed before the TFS4JIRA Synchronizer was installed. This can be used for migrating items from one platform to the other or as the first step for creating an ongoing synchronization between the two platforms.

You can only start one initial synchronization per profile at a time. Wait for the initial sync to end before starting a new one.

You can access initial sync in several different ways:

  • Top of the sync profile page
    Go to the TFS4JIRA Synchronizer page, select Sync profiles, and select a completed sync profile from the list. Click Sync initials items from the top right side of the profile’s Overview page.

  • Synchronization Profile options
    Click the Options icon (…)for the sync profile and select Start initial sync from the menu. If the profile configuration is incomplete, The sync initial items option is unavailable.

  • You’re ready to sync success message
    When you have successfully completed all the sync profile steps, you will see a success message letting you know the profile has been successfully configured. Click Sync initial items to start the initial sync.

Start the Initial Synchronization

  1. When the Start Initial Sync dialog opens, complete the following:

    • Start date - issues created starting from this date are included in the sync.

    • Sync direction - select the direction issues migrated from Jira to Azure or from Azure to Jira.

  2. Once completed, click Start initial sync. The Initial items to sync is scheduled to start message appears.

  3. Click See overview to return to the profile Overview page, or click Back to profiles list to return to that page.

Track the Initial Synchronization progress

  1. Return to the profile Overview page to track the progress of the initial sync.
    The In Progress panel displays the synchronization status and the synchronization id.

  2. Click See details for information regarding the synch session and number of items synched or failing.

  3. Click Abort initial sync to stop the synchronization.

    When successful, the Initial items sync: Succeeded message appears with information regarding the number of items successfully synced.

  4. Click See Details to open the sync session.

This page contains:

  • the synchronization id

  • the start, end, and duration times of the initial sync

  • The number of successful and failed synced items

  • The Jira item number and the Azure ID