Migrate to Zephyr Squad New Experience

The Migration Process

How to migrate?

The interface enables users to review the list of entities available for migration and identify those that will not be migrated before initiating the migration process.

Start the migration

  1. Navigate to Apps in your Jira workspace and select Migrate to new Squad.

    start-jiraView.png
  2. Mark the checkbox and click Start the Migration.

  3. If there is another migration in progress, you will not be able to begin. Wait for the other migration to complete. The next migration process will start automatically.

Warning

Once the migration starts, you can't cancel the process.

How to track progress?

Once the migration begins, you can track its progress in the user interface through a progress bar, which displays the overall progress for all projects. If the migration encounters issues or fails, the progress stops and the error message appears.

progress.png

Migration complete

completion_migr.png

Migration partially complete

migration_partially.png

You can see error logs and review the details of the encountered errors.

show-logs.png

Migration fails

migration_error.png

In the event of failure or a partial success situation requiring another migration attempt, users must initiate the migration process once more from the beginning. Click the Re-run migration button to navigate back to the initial page. The system will verify if any other migration is in progress.

Warning

When the migration is run again, the migrated data will be overwritten and the migration will start from beginning.

Which data can't be migrated?

The migration engine does not support migrating BDD data. Once the migration process begins, the delta data cannot be migrated at a later time. We therefore advise that you only initiate the migration process if the migration of BDD data is not crucial for your requirements. Furthermore, Zephyr Squad new experience does not have the execution history feature, so it will not be migrated.

Using the product during the migration

You can use the product during a test migration, unless you need to verify the newly generated data in Zephyr Squad. Any data generated during the test migration may be overlooked and will not be transferred to the new experience. However, during a production migration, you should refrain from using the product to prevent potential data inconsistencies. Any data generated during the production migration will not be transferred. There is no provision to migrate them later, as we do not support the migration of delta data.

Migration completion

Once the migration is finished, you can assess your data in the Zephyr Squad app. Click on Open new experience.

new_exp_or_switch_back.png

You can also switch back to the old experience before finalising the migration.

You're all set!

new_exp.png

Data that will not be migrated

  • BDD data

  • Test execution history

  • Test execution saved filters

  • JQL saved filters

  • Test steps custom fields change history

  • Custom field of type Select list (cascading)

  • Custom field of type Label

  • Advanced custom fields for test cases

Publication date: