The migration environment is a secure temporary space to host your data from the Data Center until it is migrated to your cloud instance. Copying your data into the migration environment will help you prepare for migration using the Cloud-hosted migration assistant. What is the Cloud-hosted migration assistant?

This page provides instructions on how to copy data, such as projects, assets, users, as well as Marketplace apps and their data, from your Data Center instance to the migration environment in Atlassian cloud.

Before you begin

Make sure to complete the following tasks before you initiate data copy:

1. Set up your Data Center and Cloud instances for migration.

2. Set up a database for the Cloud-hosted migration assistant.

Initiate data copy

To copy data from your Data Center instance:

1. Go to Atlassian Administration. Select Data management and then Delta migration.

2. Select Define initiative.

3. Select your Data Center instance as the source. If you don’t see your Data Center instance in the list, you’ll need to connect your Data Center instance to Atlassian Administration. How to connect your Data Center instance

4. Select your Cloud instance as the destination, and select Connect.

5. Once the source and destination are connected, select Start copying under Copy your data. This will initiate data copy of your database and attachment data.

A checkmark will appear on the Copy your data card to confirm the copy was successful.

Copy Marketplace app data

Currently, app data can’t be copied automatically. You will need to trigger it manually using APIs. Once this is done, you will require assistance from a support engineer to install Marketplace apps.

Make sure your basic authentication and personal access token are configured before you begin.

• Configure basic authentication

• Configure personal access token

To begin copying Marketplace app data from your Data Center instance:

1. In the Migration Connector app, run the following API to copy app attachments.

   curl -X POST --location \
   '<JIRA_URL>/rest/replicator/latest/replicate/jirahome/{cloudId}' \
   -u "{admin_user}:{admin_password}"

   
   

2. Run the following command with the sessionId from the previous step to track the progress of the attachment copy.

   curl -X GET --location \
   '<JIRA_URL>/rest/replicator/latest/replicate/jirahome/rerun/{sessionId}' \
       -u "{admin_user}:{admin_password}

   
   

3. Check the status.

   1. If the status is SUCCESS, Marketplace app data copy is successful. Once this is done, contact support. The team will help you install Marketplace apps on your migration environment.

   2. If the status is FAILED, INCOMPLETE, or STOPPED, re-run the following command. If the status remains the same, contact support.

curl -X GET --location \
'<JIRA_URL>/rest/replicator/latest/replicate/jirahome/rerun/{sessionId}' \
    -u "{admin_user}:{admin_password}

Prepare copied data

Once all the data from your Data Center instance is copied, it will be stored in a safe and secure format with strict access controls. To set up the migration environment:

1. Go to Atlassian Administration. Select Data management and then Delta migration.

2. Select View initialization details against your initiative.

3. Select Start setup on the Start your data setup card.

4. The setup will take some time to complete. A checkmark will appear on the card to confirm that the set up is complete.

In the meantime, you can continue with other tasks and track the status of the setup on the Delta migration dashboard.

Once the set up is complete, your data is ready to be migrated into your cloud instance.

If the setup fails, select Retry setup to try again. If it continues to fail, contact support.

Next steps

After your data is copied, you are ready to initiate your first migration. Read how to create a migration plan

Further reading

Cloud-hosted migration assistant FAQs