| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
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/migration-steps/migrate-multiple-projects-in-parallel/2--migrate-projects.html |
| Info |
|---|
For a list of migration specifics, see Migration Specifics & Limitations. |
After migrating ALM users and execution statuses, you can run several instances of the wizard to start simultaneous migration of multiple projects. The project migration procedure consists of three stages:
Preliminary steps
...
Make sure the names of all ALM 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. Otherwise, they will be ignored.
...
If you have a project with the same name in Zephyr, delete or rename it.
...
migrate multiple projects simultaneously. Follow the migration steps below to start a new wizard instance and migrate a project to Zephyr. The number of concurrent wizard instances is not limited, however, we recommend that you do not migrate too many projects in parallel to avoid performance issues.
Important
Put the wizard’s
.jarfile to a new folder on your hard drive for each migration session. The folder will contain the migration log.Specify a different port for different wizard instances.
Start a new wizard instance in a new browser tab.
Migration steps
Create a new folder on a computer that has access to both HP ALM and Zephyr, and
put the.jarfile (hpqc-zee-<release>.jar) you downloaded when performing preliminary steps to that folder.Start the
.jarfile:
Open the command prompt.
Navigate to the directory where the
.jarfile is located.Run the following command:
java -jar -Dserver.port=
...
xxxxx -Xms2048m -Xmx2048m hpqc-zee-x.x.x.jar
...
– Dserver.port is the port on the server where the .jar file will run.
...
For example, -Dserver.port=55555.
Important: Use different port numbers for different wizard instances running concurrently.
– Xms2048m and Xmx2048m are the minimum and maximum memory that can be allocated for running the .jar file
...
Migration steps
Run the migration wizard in the browser and specify the required data:
...
. 2048 MB in our example.
– hpqc-zee-x.x.x.jar is the file you downloaded. For example, hpqc-zee-1.5.5.jar.
...
3. Open your browser and enter <IP address>:<port> where <IP address> is that of the computer where you ran the
...
.jar file and <port> is the port number you specified when running the
...
.jar file. For example, localhost:
...
55555. Please remember that you should use different ports for different wizard instances.
The Migration Wizard page will open:
...
...
| Info |
|---|
Start each wizard instance in a new browser tab. |
4. Populate all the fields on the Zephyr & HP QC Configuration page and click Save Config:
...
| Note |
|---|
You must log in to Zephyr as test.manager and your ALM administrator account must have access to all ALM modules. |
...
5. On the subsequent screen, review the values, update them if needed, then click Next:
...
...
6.
...
On the next screen
...
- Migrate All ALM Users, Testcase & TestStep Execution Status
- Migrate a Project
- Disable Users
...
select Migrate a Project and click Next:
...
...
7. Select the QC domain to which the project belongs in HP ALM and click Next:
...
...
8. Select the project you want to migrate and click Next:
...
...
9. The wizard will show a list of entities available in the specified HP ALM project. Choose the entities you want to import to Zephyr and click Start Importing:
...
...
You can choose to migrate only some of the entities. For example, if you unselect Releases, all the items related to releases will be unselected as well. In this case, no releases will be migrated. All the migrated test cases will be placed in the Project
...
Test Repository folder, and all the migrated requirements will be placed in the Project Requirements folder.
Migrated test step attachments will be in the Attachments section of test cases. Test steps have no attachments in Zephyr.
Now, to start migrating another project:
1. Create a new folder and place the downloaded .jar file in it.
2. Run the file and specify a different port in the following command: java -jar -Dserver.port=44444 -Xms2048m -Xmx2048m hpqc-zee-x.x.x.jar.
3. Repeat all the migration steps (1-7), but this time, at step one, enter the port number you specified in the command.
4. Start a new wizard instance in a new browser tab.
The number of concurrent migration sessions is not limited, however, we recommend that you launch a reasonable number of instances to avoid performance issues.
...
After you start migration, do not change the users' logins or passwords (both in Zephyr and in ALM).
Migration results
After the migration completes, you will see a report in each instance of the wizard:
...
...
| Info |
|---|
You can also view the migration log (the |
Continue reading
After migrating all of your projects, you need to do disable the following:
...
users that are disabled in
...
ALM and perform full reindexing in Zephyr.
To learn how to do that, see –
➡ Post-Migration Steps
See Also
...