Versions Compared

Version Old Version 10 New Version 11
Changes made by

Edward Stolyar (Deactivated)

Edward Stolyar (Deactivated)

Saved on

Key

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

For a list of migration limitationsspecifics, 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. To start the first instance:

...

The project migration procedure consists of three stages:

  • Pre-migration steps

  • Migration steps

  • Post-migration steps

Pre-migration steps

  1. Make sure the names of all ALM tests, releases, cycles, phases and so on consist of at least two characters. If you have such entities, please rename them before migration. Otherwise, they will be ignored.

  2. Rename ALM release folders if they contain special or international characters. Otherwise, they will be ignored.

  3. Run the downloaded .jar file.

Migration steps

...

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:

...

Note

You must log in to Zephyr as test.manager and your ALM administrator account must have access to all ALM modules.

3. On the subsequent screen, review the values, update them if needed, then click Next:

...

Info

  • 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.For a list of migration limitations, see Limitations.

Now, to start migrating another project, repeat all the steps described above:

1. Create a new folder and place the .jar file in it.
2. Run the file and specify another 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,

...

enter the port number you specified in the command.

...

4. Start a new wizard instance in a new browser tab.

(info) The number of concurrent migration sessions is not limited, however, 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:

...

Post-migration steps

After migrating all of your projects, you need to disable those do the following:

  1. Disable the users that are disabled in HP ALM

...

  1. (all the imported users are enabled in Zephyr).

  2. Perform full reindexing in Zephyr.

See Also

ALM Migration Wizard Overview
Setup InstructionsSet Up ALM Migration Wizard