Resolve pre-flight errors with remediation
When you run pre-migration checks in the Jira Cloud Migration Assistant (JCMA), you may encounter errors that prevent your migration from proceeding. Without having to start over or making changes to your Data Center instance, the remediation feature lets you fix these errors directly from the migration assistant, so you can get your migration back on track faster.
What is remediation?
Before you migrate your data, the Jira Cloud Migration Assistant runs a set of pre-migration checks to make sure your data can be migrated to the cloud. Read about pre-migration checks
Pre-migration checks identify issues in your source Jira instance that could lead to data loss or a migration failure. Some of these errors are remediable. You can fix them from within the migration assistant rather than manually modifying your source data.
Remediations can be applied differently based on the phase of your migration.
Situation 1: As part of your first migration
During your first migration, data preparation errors can be resolved during the pre-migration checks.
Situation 2: As part of future migrations
After your first successful migration, you will be able to apply remediations from your previous migration.
To view remediation details from your previous migration:
アトラシアン管理に移動します。
Under Data management, select Remediations.
As more successful migrations occur, the Migration Assistant can apply remediations learned from past migrations. You can either apply remediations to a new migration or copy remediation files to a cloud site to resolve data errors.
If a remediation is already being processed for a migration plan, the Remediations page will be locked until the current remediation is completed. This prevents conflicts from parallel remediation submissions.
はじめる前に
Before you apply remediations, you will need to complete the following steps:
Check your permissions. To migrate, you need to be a system admin in the source instance and an organization admin in the destination cloud site.
Check if you have the latest version of Jira Cloud Migration Assistant. Update the assistant and allowlist required IPs and domains, if required.
Check what can be migrated with Jira Cloud Migration Assistant.
For production migration, make sure the JCMA version installed is the same as that used in the test migration.
Complete the pre-migration checklist to prepare your Data Center and Cloud environments.
Pre-migrate users, groups, and attachments before project data to reduce downtime.
Apply remediations as part of pre-migration checks
During your first migration, you can apply remediations in the following manner:
In your Jira Server/Data Center, open Jira Cloud Migration Assistant.
Create a new migration plan or open an existing one.
Go to Pre-migration checks and select Data preparation.
If there are errors, you will see a dropdown with details.
Select Fix remediable errors.
Provide the required information for each affected project and select Apply. See how to resolve specific data preparation errors
Select Rerun after you’ve applied all the changes.
Alternatively, you can also fix issues in bulk using a CSV file:
Select Fix remediable errors in the Data preparation section of the Pre-migration checks page.
Download the ZIP file.
Unzip the folder and open the CSV file.
In the Fix column of the CSV, fill in the valid information for each affected project. See how to resolve specific data preparation errors
Select Upload ZIP to upload the updated CSV.
Apply remediations while creating a new migration
In your Jira Server/Data Center, open the Jira Cloud Migration Assistant.
[新しい移行を作成] を選択します。
If there are existing remediations, you will see a modal with the header Remediations found.
Select Check remediations to view and modify existing remediation files.
Select Download ZIP to view the errors that can be resolved by applying remediations.
4. Use the toggle to apply remediations for your migration.
5. Select the data you want to migrate. Select Save and run pre-migration checks once you’re done.
Based on your choices, the remediations will be applied to errors discovered during pre-migration checks.
Copy remediations to a cloud site
アトラシアン管理に移動します。
Under Data management, select Remediations.
Select Actions (⋯), then Download ZIP to download and view the contents of the remediation file.
Select a previous migration to copy its remediation details, and select Copy remediation.
Select a previous migration to copy its remediation details.
Select the Cloud site where you’d like to apply the remediations.
Add the SEN ID and Migration Scope ID. Select Next.
After a few minutes, the remediations will be applied to the cloud site.
Troubleshoot remediation issues
The remediation screen is locked
A remediation or preflight check is already running for a migration plan. Wait for it to complete, then try again. If the lock persists, contact your administrator or contact Atlassian Support.
Pre-migration checks still show errors after I added remediations
Select Re-run checks to refresh the results. If errors persist, check the Remediations page in Atlassian Administration to confirm if your selected remediation file contains the values you require. Applying the remediation files doesn’t guarantee that all errors in the pre-migration are resolved. Your new migration may contain errors that were not present in previous migrations.
この内容はお役に立ちましたか?