Migrate a Single Project

Note

For a list of migration specifics, see Migration Specifics and Limitations.

You can migrate your projects in this mode if you want to migrate only one project, or if you have a number of comparatively small projects.

Migration steps

  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:

    2587426861.png
  2. Populate all the fields on the Zephyr & HP QC Configuration page and click Save Config:

    2587426867.png

    Important

    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:

    2587426873.png
  4. On the next screen, select Migrate a Project and click Next:

    2587426879.png
  5. Select the QC domain to which the project belongs in HP ALM and click Next:

    2587131940.png
  6. Select the project you want to migrate and click Next:

    2587262997.png
  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:

    2587131948.png

    Note

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

    • If a user with the same name already exists in Zephyr, the user will not be migrated.

    • Migrated test step attachments will be in the Attachments section of test cases. Test steps have no attachments in Zephyr.

    • After you start migration, do not change the users' logins or passwords (both in Zephyr and in ALM).

Migration results

After the migration completes, the wizard will show a report:

2585460859.png

Note

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

Continue reading

After migrating the project, 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.

See Also

Planning

Preliminary Steps

FAQ

Publication date: