Table of Contents | ||||
---|---|---|---|---|
|
Introduction
Zephyr HP ALM Migration Adapter is a unique API-driven solution that lets you migrate your data from HP ALM directly into Zephyr Enterprise. The solution works with either an On-Prem or a Cloud installation of Zephyr Enterprise.
Note |
---|
|
ALM and Zephyr Compatibility
...
ALM Adapter Version
...
ZE Version
...
HP ALM/QC Version
...
1.5.x
...
6.7 and later
...
15.0
12.6
12.5
11.5
Planning
Planning is an important phase of migration. This phase involves:
Determining HP ALM artifacts that need to be migrated
Reviewing environments and configurations
Optimizing stage environments
The sections below explain these in more details:
...
Determine HP ALM artifacts that need to be migrated
It is important to acknowledge that not all the data you have in legacy system remains good to be transferred. In this phase, you should review how your testing methodologies and practices have changed over time and determine the right HP ALM artifacts that makes sense to transfer to Zephyr.
...
Review environments and configurations
Not all HP ALM environments are configured the same. Please review the hardware configuration, memory allocation, API throttling configurations, network topology etc for each HP ALM environment.
Determine the migration style
There are two possibilities for the migration: big bang migration or trickle migration.
...
Planning is an important phase of migration. Before migrating your projects, you need to:
Determine what projects and which entities you want to migrate because not all ALM data can be migrated to Zephyr (see below).
Review hardware and network configurations.
Check memory allocation.
Optimize staging environments, if needed.
Perform a dry run
We recommend that you first perform a dry run in a staging environment before migrating your projects. Migrate a small project to see that everything runs smoothly and the migrated project meets your expectations. To perform this test migration, use the latest versions of Zephyr Enterprise and ALM Migration Wizard.
Tip |
---|
Hints:
|
Schedule migration
You can migrate projects either over a weekend when both HP ALM and Zephyr are shut down for users
...
, or you may take an incremental approach by having both HP ALM and Zephyr available in parallel during the weeks
...
or months, and moving projects from HP ALM to Zephyr based on your business needs.
With either approach, we undertake at least one week of review, preparation and optimization of stage environment; this includes optimization of system that has Zephyr HP ALM Migration adapter installed. Full access to stage environment is required.
Adapter Overview
The Zephyr HP ALM Migration adapter uses REST APIs to extract data from HP ALM and import data into Zephyr Enterprise. The section below provides a high-level overview of the communication between the Zephyr Enterprise instance, the HP ALM instance, and the Zephyr HP ALM Migration adapter:
...
The current version of the Zephyr HP ALM Migration Adapter supports migration of the following types of entities:
Projects
Users
Requirements
Tests
Test Attachments
Test Steps
Step Attachments
Test Folder Organization
Test Custom Fields
Release
Cycle
Test Run (Test Execution in Zephyr)
...
Entity names
When preparing for migration, keep in mind that some ALM and Zephyr entities have different names. The table below compares the names of the main entities:
Entity name in Zephyr | Entity name in HP ALM |
---|---|
Requirements | Requirements |
Test Repository | Test Plan |
Test Planning | Test Lab |
Test Execution | Test Runs |
Migration specifics & limitations
Not all ALM data can be migrated to Zephyr Enterprise and . Also, the migrated data should comply with certain Zephyr requirements. The table below provides detailed information on the migration specifics and limitations you need to keep in mind when planning migration of your projects:
Version
Release Date
Release Notes
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
Component | Migration specifics & limitations |
---|---|
Domain | Since Zephyr does not have the domain concept, no domains are created in Zephyr. To differentiate the domains, the name of each migrated project is preceded by the domain name in Zephyr: |
Users |
|
Releases |
|
Requirements |
|
Test cases |
|
Cycles |
|
Cycle phases |
|
Executions |
|
Custom fields |
|
Attachments |
|
Defects |
|
Accounts |
|
Indexing |
|
Migrating Defects from HP ALM to Jira
The current process for migrating historical defects from HP ALM into Jira involves the following steps:
The defects are exported from HP ALM using APIs available from HP
The defects are then imported into Jira by using Jira REST API calls or via a .CSV file
Setup & Usage Instructions
For setup and usage instructions, please refer to Using the Zephyr HP ALM Migration Adapter.
Additional Questions
For any questions, please contact Zephyr Support: https://support.getzephyr.com
Before sending a request to our Support team, you can create an archive containing system information and various logs that will help us debug the issue. To learn how to create the archive, see Support ZIP File.
Version History
Authentication |
|