Export and import link configuration and data

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.

Export link configurations and or mapping data to files that you can import and reuse to create new links.

You can export and import data using the following methods:

Exported file Description
XML configuration file

Export a configuration file to reuse the configuration of a synchronization link.

Tip: To export and import only field mappings for a specific link, see Map endpoint fields instead.

Configurations are exported to an XML file saved in a location you define, and include:

  • The link name

  • Email notification information

  • Data from the following tabs:

    • Connectivity

    • Scheduling

    • Filters

    • Rules

    • Field Mapping

For a list of modifications to make when importing this file as a new link, see Create a link from an exported XML file.

.ZIP backup file

Export a .ZIP file to reuse all data for a synchronization link, such as moving the link to another synchronization server.

The .ZIP file includes all configurations exported to the XML configuration file, as well as entity mappings, and link synchronization history.

The exported information is saved in a <link name>.zip file, in the <ALM Synchronizer installation directory>\backup directory on the Synchronizer server. This location is defined per server. For details about changing this location, see Configure server options.


  • The name of the exported .zip file is not editable and is based on the name of the link. If you have already backed up data for the link or a link with the same name, exporting link data will overwrite the existing backup file.
  • If you plan to import this link to NextGen Synchronizer, make sure not to export a link that synchronizes requirements in sub-folders.

    To migrate such a link to NextGen Synchronizer, do the following:

    - Restructure your requirement tree to avoid using sub-folders.

    - Re-run the synchronization in ALM Synchronizer.

    - Export the link from ALM Synchronizer.

  • For considerations about importing the .ZIP file as a new link and steps required, see Create a link from an exported .ZIP file.

What do you want to do?