Set up your Data Center and Cloud instances
This page provides instructions on how to set up both Jira Data Center and Atlassian cloud instances in preparation for migration using the Cloud-hosted migration assistant. What is Cloud-hosted migration assistant?
Follow these steps to complete all the necessary configurations to ensure a smooth and secure migration to the cloud.
The Cloud-hosted migration assistant is available to a limited number of customers on an early access program. Contact your Cloud Migration Manager if you’d like to adopt it for your cloud migration.
1. Install required Marketplace apps
Before you begin, you’ll need to install two Marketplace apps on your Data Center instance:
Migration Connector for Jira
Download the latest version of the app.
Use the Jira Plugin Manager to install the file.
Cloud Companion
Install the latest version of the app.
This app will help in discovering your Data Center instance and complete the DC-Cloud connectivity.
2. Allowlist service URLs
During a migration, your Jira Data Center instance needs to securely communicate with various Atlassian Cloud services to copy data, perform assessments, and execute migration steps.
Allowlisting the specified service URLs ensures that outbound network traffic from your Data Center instance to Atlassian Cloud endpoints is permitted by your firewall or proxy.
Make sure to allowlist the following URLs in your network/firewall configuration:
3. Set up the database
Based on your database type, follow the instructions to setup your database:
4. Configure your authentication methods
By configuring authentication methods such as basic authentication or personal access tokens (PAT), you protect sensitive data and prevent unauthorized access during migration operations. This step is critical for maintaining the security and integrity of your migration data.
For all Data Center API invocations, we recommend using basic authentication or personal access tokens.
Configure basic authentication
Configure personal access token
Once this is complete, run the following API in any console.
curl --location 'http://<DC_BASE_URL>/rest/replicator/latest/configure/database/config' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic <base64-credentials>' \
--data '{
"dbUser": "<db_user>",
"dbPass": "<db_password>"
}'5. Connect to Atlassian Administration
You will need to connect your Data Center instance to Atlassian Administration. This will enable you to copy data into the migration environment hosted in Atlassian cloud. Read about the process
The connection setup ensures that all necessary authentication and configuration steps are complete, reducing the risk of connectivity issues during migration.
Further reading
Set up database for Cloud-hosted migration assistant
FAQs about Cloud-hosted migration assistant