Preliminary Steps
In HP ALM
Make sure the names of all ALM users, tests, releases, cycles, phases and so on contain at least two characters. If you have such entities, please rename them before migration. Otherwise, they will be ignored.
Rename ALM release folders if they contain special or international characters. Although the wizard does not migrate release folders, it migrates the releases these folders contain. So, if you have release folders with such names, they will be ignored and the releases will not be migrated.
Ensure you can access HP ALM using admin credentials. The admin account you will use must have access to all ALM modules.
In Zephyr
If you have a project with the same name in Zephyr, rename it.
Ensure you can access Zephyr using Test Manager credentials.
Steps to perform on the computer where the Migration Wizard will run
Allocate at least 10 GB of memory for the wizard process (data is processed in batches to optimize the performance and reduce memory usage). The system should have 16 GB of memory in total.
Download and install Java Runtime Environment 1.8 or later.
Download the
.jar
file of the ALM Migration Wizard (HPQC-ZE-<release>) from the Zephyr Downloads Center:https://support.smartbear.com/downloads/zephyr/
Place the file in a folder (for example, NewMigration) on a computer that has access to both HP ALM and Zephyr.
Start the Wizard’s .jar file
Open the command prompt.
Navigate to the directory where the
.jar
file is located.Run the following command:
java -jar -Dserver.port=xxxxx -Xms2048m -Xmx2048m hpqc-zee-x.x.x.jar
Here,
–
Dserver.port=xxxxx
is the port on the server where the.jar
file will run. For example,-Dserver.port=44444
.–
Xms2048m
andXmx2048m
are the minimum and maximum memory that can be allocated for running the.jar
file. 2048 MB in our example.–
hpqc-zee-x.x.x.jar
is the file you downloaded. For example,hpqc-zee-1.5.5.jar
.
Note
Once you run the command, the logs/zephyr.log
file will be created in the same folder where the .jar
file resides. This log will collect all the migration details.
Now you can start migrating your projects.