Preliminary Steps

Owned by Edward Stolyar (Deactivated)
Last updated: Oct 10, 2024 by Dominik Trygar
2 min read

Starting October 11, 2024 (Zephyr Enterprise 8.2), the Zephyr Enterprise documentation moved from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise documentation page. Please see: https://support.smartbear.com/zephyr-enterprise/docs/en/migrating-to-zephyr-enterprise/from-hp-alm/preliminary-steps.html

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

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

  2. Download and install Java Runtime Environment 1.8 or later.

  3. Download the .jar file of the ALM Migration Wizard (HPQC-ZE-<release>) from the Zephyr Downloads Center:
    https://support.smartbear.com/downloads/zephyr/

     

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

  1. Open the command prompt.

  2. Navigate to the directory where the .jar file is located.

  3. 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 and Xmx2048m 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.

     

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.

Continue reading

Migration steps

See Also

Planning
FAQ