The Migration Process

How to migrate?

  1. The migration beta user interface is now accessible to selected customers, allowing them to start the migration process. 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.

    You need to install the Zephyr Scale app first before proceeding with the migration.

  2. Once the Zephyr Scale app is installed, Click the Start Migration button and mark the checkbox to proceed.

    migration_scheduled.png
  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.

Start the migration

Click Start Migration to begin the process.

Notice

All of the projects will be migrated using the UI. We are planning to release the page where you can select the projects you want to migrate. Check our release notes to be notified.

start_migration.png

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.

migration_progress.png

Migration complete

migration_complete.png

You can now navigate to Zephyr Scale in Jira homepage to see your migrated projects.

Migration partially complete

migrarion_partially_complete.png

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

logs-incomplete.png
show-logs.png

Migration fails

migration_failed.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 Scale 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 Scale. Any data generated during the test migration may be overlooked and will not be transferred to Zephyr Scale. 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 Scale app. Click on Navigate to Home page .

You can also open Zephyr Scale from the Jira home page. Go the Apps tab and choose Zephyr Scale.

If you are satisfied with the migrated data, subscribe to Zephyr Scale and unsubscribe from Zephyr Squad. If you have any concerns, add new data, or identify migration issues, you can perform the migration again or contact our support team for assistance.

Publication date: