ALM Migration Wizard is a unique API-driven solution that lets you migrate data from HP ALM directly to Zephyr Enterprise (the wizard uses REST API operations to extract data from HP ALM and import it to Zephyr Enterprise). The solution works with both On-Prem and Cloud editions of Zephyr Enterprise. For information on the latest version of the wizard, see Version history.

Supported Zephyr, HP ALM, and wizard versions

  • Zephyr Enterprise 7.5 and above | ALM Migration Wizard 1.5.9

  • Zephyr Enterprise 6.7 to Zephyr Enterprise 7.4.1 | ALM Migration Wizard 1.5.8

  • HP ALM versions supported:

    • 15.0

    • 12.6

    • 12.5

    • 11.5

We highly recommend that you use the latest versions of Zephyr Enterprise and ALM Migration Wizard.

Supported migration entities

The current version of the wizard supports migration of the following entities:

  • Users

  • Projects

  • Releases

  • Requirements

  • Test cases and test steps

  • Mapping of test cases to requirements

  • Test runs and test cycles

  • Execution history

  • Custom fields

  • Test Attachments

  • Test Folder Organization

Migration procedure

The migration procedure comprises several steps: you start the Migration Wizard, configure a migration session and start migrating your project. For detailed information on how to plan migration and perform all the required steps, see the following topics:

  1. Planning

  2. Preliminary steps

  3. Migration steps

  4. Post-migration steps

Technical support

Should you have any questions, please contact our Zephyr Customer Care team. Before sending a request, please create an archive containing system information and various logs, and attach it to your request. It will help us debug the issue faster.

For answers to frequently asked questions, see FAQ.

Version history


Release date

Release notes


October, 2021

Compatible with Zephyr Enterprise 7.5 and later.


  • ALM Migration Wizard can now migrate multi-select custom fields from HP ALM.


October, 2021

Compatible with Zephyr Enterprise 6.7 to Zephyr Enterprise 7.4.1.

Bug fixes:

  • Sometimes, files attached to test cases could not be migrated.

  • In some cases, test results could not be migrated to Zephyr’s Test Execution folder.


June, 2021

Compatible with Zephyr Enterprise 6.7 to Zephyr Enterprise 7.4.1

Bug fixes:

  • Sometimes, test executions were migrated.

  • If a username contained a tab character (\t), an error occurred during migration, and the migration failed.


April , 2021


Various back-end improvements.

Bug fixes:

  • Sometimes, duplicate custom fields were created during migration.

  • Some test case field values were not migrated.


March 2, 2021


  •  HP ALM might have custom fields that already exist in Zephyr. To avoid duplicating custom fields, version 1.5.5 introduces the following changes:

    • If a custom field coming from HP ALM already exists in Zephyr:

      • No new custom field is created, the existing field will be used.

      • If an ALM field has a different data type, a new custom field with the same name postfixed with ALM is created in Zephyr.

      • In case of custom picklist fields, the items of the ALM field are appended to the existing picklist field.

  • In HP ALM, test cases can be assigned multiple time to the same cycle phase. To replicate this behavior in Zephyr, a number of test case copies are created in Zephyr and are assigned to such a phase.

  • Old logs are no longer deleted. Previously, the adapter kept only the last 8 logs. You can still delete old logs manually.

Bug fixes:

  • Sometimes, the status of certain test cases was not migrated.


January 7, 2021

  • You can now perform parallel migration, which speeds up the migration process when migrating several projects.

  • Performance improvements (multi-threading and bulk operations)

  • Support for proxy.

  • Support for HP ALM 15.0.

  • Additional check points to control migration.

  • Bug fixes.


October 13, 2020

  • Support for migrating test sets not assigned to any cycle in HP ALM.

  • Support for migrating unexecuted test cases.

  • Support for migrating Actual Results data from HP ALM.

  • Support for migrating attachments at the Test Step and Evidence levels.

  • When a test set is not assigned to a cycle, keep the hierarchy at the Test Case Repo level.

  • Support for migrating test cases even if the HP ALM user has been deleted.

  • Additional help when authentication fails.

  • Updated time measurements from milliseconds.

  • Bug fixes.


September 3, 2020

Compatibility with Zephyr Enterprise 6.8.


July 16, 2020

Bug fixes.


June 18, 2020

Compatibility with Zephyr Enterprise 6.7.x.


July 16, 2020

Bug fixes.


June 18, 2020

Bug fixes.


October 30, 2019

  • Test cases have been moved to the project level.

  • Test cases can now be added to releases as cycles and phases.

  • Now you can map a requirement to a test case if it is mapped in HP ALM:

    • Test cases which do not belong to a test set will be moved to the default release of Zephyr Enterprise along with mapped requirements to maintain mapping coverage.


September 16, 2019

  • Improved migration of test cases to a specific Releases instead of at the Project level.

  • Bug fixes.


July 25, 2019

Added support for self-signed certificates.


May 23, 2018

Added support for additional entities.


September 08, 2017

Initial version.

See also

Migrating to Zephyr Enterprise
Preliminary Steps
Migration Steps
Post-Migration Steps