Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

After migrating ALM users and execution statuses, you can run several instances of the wizard to migrate multiple projects simultaneously. The Follow the migration steps below explain how to start migrating the first project. To start parallel migration of other projects, you need to create 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.

Note
  • Put the .jar file to a new folder 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

1. Start Create a new folder on a computer that has access to both HP ALM and Zephyr and put the .jar file (hpqc-zee-<release>.jar) you downloaded when performing preliminary steps to that folder.

1. Start the .jar file:

  • Open the command prompt.

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

  • Run the following command:

...

Dserver.port is the port on the server where the .jar file will run. For example, -Dserver.port=44444.
(warning) The port number must be different for each migration sessionwizard instance.
Xms2048m and -Xmx2048m are the minimum and maximum memory that can be allocated for running the .jar file.
hpqc-zee-x.x.x.jar is the file you downloaded. For example, hpqc-zee-1.5.5.jar.

...

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

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 the migration completes, you will see a report in each instance of the wizard:

...

Info

You can also view the migration log (the logs/zephyr.log file) in each folder where the .jar file resides.

After migrating all the of your projects, you need to disable the users that are disabled in ALM and perform full reindexing in Zephyr. To learn how to do that, see Post-Migration Steps.

...