From HP ALM

Introduction

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 below.

Supported Zephyr, HP ALM, and wizard versions

Zephyr Enterprise 7.14 and above | ALM Migration Wizard 1.6.9
HP ALM versions supported:
- 15.0
- 12.6
- 12.5
- 11.5
Important
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:

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

Version	Release date	Release notes
1.5.9	October, 2021	Compatible with Zephyr Enterprise 7.5 and later. Improvement: ALM Migration Wizard can now migrate multi-select custom fields from HP ALM.
1.5.8	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.
1.5.7	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.
1.5.6	April , 2021	Improvements: Various back-end improvements. Bug fixes: Sometimes, duplicate custom fields were created during migration. Some test case field values were not migrated.
1.5.5	March 2, 2021	Improvements: 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.
1.5.4	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.
1.5.3	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.
1.5.2	September 3, 2020	Compatibility with Zephyr Enterprise 6.8.
1.5.1	July 16, 2020	Bug fixes.
1.5	June 18, 2020	Compatibility with Zephyr Enterprise 6.7.x.
1.4.1	July 16, 2020	Bug fixes.
1.4	June 18, 2020	Bug fixes.
1.3	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.
1.2	September 16, 2019	Improved migration of test cases to a specific Releases instead of at the Project level. Bug fixes.
1.1	July 25, 2019	Added support for self-signed certificates.
1.0	May 23, 2018	Added support for additional entities.
0.1	September 08, 2017	Initial version.