Child pages
  • Running Resync

This documentation relates to an older version 2.0 of the Structure Plugin for JIRA. View the current documentation home.

Skip to end of metadata
Go to start of metadata

A resync, or full resynchronization, is a one-time process activated manually by the user to bring Structure and some other aspect of issues to the same page. Resync typically scans all issues that may be affected - contrary to the incremental synchronization, which inspects only issues that have been changed.

For example, running resync on a Saved Filter synchronizer (in Add mode) runs the related Saved Filter and makes sure all issues from the result set are in the structure. When the same synchronizer is working in the background, it checks only those issues that have been changed.

Resync Directions

Resync is also different from incremental synchronization in that it has a direction. The incremental sync tries to apply changes on both sides to the other side, if possible, depending on where the change has happened: with GreenHopper synchronizer, if you change the rank (issue position in backlog on the Planning Board), its position in the structure is also changed; and if you change the position in the structure, GreenHopper's rank is changed. However, when applying Resync, you need to choose which side of the data is to be taken as the final version and which is to be updated.

Resync can be run:

  • from Structure, which means that the issue hierarchy in the Structure is the final data and the synchronizer should update whatever it syncs with. This is what happens when you export from a structure.
  • into Structure, which means that the issue hierarchy is going to be updated (or issues possibly added or removed), and whatever the synchronizer syncs with has the final say. This is what happens when you import into a structure.

A synchronizer may support resyncing in only one direction. For example, Saved Filter synchronizer, which adds issues from a saved filter result, can only sync into Structure.

Running Resync

To run a resync:

  1. Open Manage Structure page using top navigation Structure
  2. Click Settings link in the Sync With column for your structure
  3. On the synchronization settings page, find the synchronizer you'd like to Resync, and either
    1. Click Resync
    2. Click Resync and Enable if the synchronizer is disabled and you'd like to enable it immediately after Resync finishes
  4. Select a direction for the Resync. For example, GreenHopper → Structure means that the data will be taken from GreenHopper and the structure will be rearranged. If a direction is not supported by the synchronizer, it will be disabled.
  5. Click Start Resync.

    Resyncing in a wrong direction may lead to data loss! Please make sure you understand that you're doing the correct thing and confirm running the resync when a confirmation dialog appears.

  6. The job status page that appears will tell you when the Resync has finished.

If the synchronizer is currently running an incremental synchronization, the resync will wait until it finishes.