After migrating ALM users and execution statuses, you can run several instances of the wizard to start simultaneous migration of multiple projects. To start the first instance:
1. Run the JAR file you downloaded when performing preliminary steps:
1. Open the command prompt or terminal.
2. Navigate to the directory where the downloaded JAR file is located.
3. Run the following command:
java -jar -Dserver.port=44444 -Xms2048m -Xmx2048m hpqc-zee-1.5.4.jar
-Dserver.port is the port on the server where the JAR file will run.
-Xms2048m and -Xmx2048m are the minimum and maximum memory that can be allocated for running the JAR file:
Once you run the command, the logs/zephyr.log file will be created in the folder where the hpqc-zee-1.5.4.jar file resides. This log will collect all the details of the migration.
2. Run the migration wizard in the browser and specify the required data:
1. 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:44444. The migration wizard will open:
2. Populate all the fields on the Zephyr & HP QC Configuration page and click Save Config:
3. On the subsequent screen, review the values, update them if needed, then click Next:
4. The next screen lists three options:
- Migrate All ALM Users, Testcase & TestStep Execution Status
- Migrate a Project
- Disable Users
Select Migrate a Project and click Next:
5. Select the QC domain to which the project belongs in HP ALM and click Next:
6. Select the project you want to migrate and click Next:
7. 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 will have no attachments in Zephyr.
For a list of migration limitations, see Limitations.
Now, to start migrating another project, repeat all the steps described above, but this time, specify another port number, the name of the project you want to migrate, and the domain the project belongs to. The number of concurrent migration sessions is not limited, but we recommend that you launch a reasonable number of instances to avoid performance issues.
8. After the migration completes, you will see a report in each instance of the wizard:
After migrating all of your projects, you need to disable those users who are disabled in HP ALM. To learn how to do that, see Disable Users.