You need to have Jira Administrator rights in order to perform the migration.

1. Install - Jira Cloud Migration Assistant

Make sure you have the latest version of the Jira Cloud Migration Assistant installed on your Jira server. If not, update it.

UpdateJira Cloud Migration Asistant.png

2. Go to “Migrate to cloud” page

Navigate to Jira Administration (1) → System (2)

then on the left side in section IMPORT AND EXPORT, please go to Migrate to cloud (1)

Then you should see Migration Assistant home screen similar to this one:

migration assistan home screen.png

For a successful migration, you need to prepare your instance to migration. You can also choose if you want to create your migration plan - test and migrate to a cloud-hosted site (2.1) or create a proper migration (3).

A migration plan is a checklist of the steps you need to take to migrate properly. It is designed to prepare you and your data for migration and to identify potential sources of problems. This checklist will help you avoid making mistakes during a proper migration.

Note that it ends with user migration, without the application being migrated, as it is only a preparation for the final migration. After that, there will be no a server project on the cloud site.

2.1 Migration plan

a) asses your apps - assess and select the apps you need to migrate (1). When you ready click button Done and connect to your cloud site (2).

asses apps.png

b) prepare your apps - at first choose your cloud side (3). After clicking Continue (4) you should be redirecting to next step.

Fill in base URL of your instance (5) → choose a cloud site (6) and tick the box to complete this step (7). After confirming the information you have entered ( 8 ), you will return to the Connect stage. To continue process, click Continue (9).

continue button.png
choosing cloud site.png

Next step is installing app on cloud site. If everything is as you expected, select the Continue button (9) .

app install 9.png

Read the privacy policy (10) and proceed with the application migration by giving your consent (11).
If you do not agree to the terms, you can cancel the migration.

view policy.png
confirm policy.png

Return to main screen by clicking Done button.

c) assess and prepare users (12)

prepear users12.png

You will be redirected to a page where you can verify the email addresses of the migrated users (13).
Depending on the results, you will be able to move on to the next stage or correct errors. To do this, click on Done (14).

blank page results.png

results of mail adress.png

d) review all emails domains - this is where you decide whether all domains specified on your server instance are reliable and can be migrated with all the data (15). When verifying domains, you can choose between 3 actions (16). Classifying the data will allow you to proceed to the next step (17).

On this screen you can see all your email domains with the number of users in each domain. If you trust the email domains, you need to mark all your domains as trusted.

emails domains.png
decision about domains.png

e) migrate your users in advance in advance

At first connect to cloud: name your migration (18). Choose between production stage or testing stage (19) - you can select any option. Specifying this will help you identify migration plans on your dashboard. To go on next step (21) you need also selected once again your destination cloud site (20).

An equally important action is to choose how to migrate users and groups (22). Only then can you start the pre-migration checks (23).

migrate your users(2).png
migrate users and group.png

After creating a migration plan, the Jira Cloud Migration Assistant runs a set of pre-migration checks to make sure your data can be migrated to cloud.

3. Create new migration

Please proceed to Create new migration (1)

create a migration.png

then click on Connect to cloud (2)

conncect to cloud_docu_NEW'.png

next you need to define migration name (3), it will help you later to identify your migration in migration panel. Then you need to choose to which Jira Cloud you want to migrate (4) (if you don’t see your Jira cloud in dropdown then please proceed to Chose cloud site (5) and add it). Once you set your name and choose your Jira cloud then go next to Choose migration options (6)

connect to cloud-docu_NEW.png

Here you can define migration options (7) of your choice to make migration fits your needs. You have two possibilities to do it: Choose what to migrate or Migrate all date at once. The more recommended option is to Choose what to migrate (8), as this gives you more flexibility and control over the selection of data to migrate. If you select the recommended option, you will be taken to the section Choose your migration options (9):

migrations option_7.png

choose your migration options_9.png

You need to go step by step to get to the next stage.

First decide what you want to do with Advanced Roadmaps, then Select Projects (10). You can decide which projects to migrate, which issue to migrate and what to do with the attachments. Simply mark your choices (11) and click Add to migration (12) button. Next you will need to select users and groups (13) to be migrated and continue by clicking Add to Migration (14). The following step will be the selection of the application (15) and apply changes (16).

select project_10.png

select users and groups _13.png

select_app15-16.png

Once you set everything up proceed to Pre-migration checks (17) section. Here you can see if there is any obstacle to migrate, once you will get error/warning you will get notified about that fact and possible solution (18). When you fix all your errors and/or warnings (warnings don’t need to be fixed to migrate but keep in mind possible unwanted effects of it), you can Continue (19) and proceed to Review migration (20) section.

pre-migrationn checks18.1.png

pre-migrationn checks18.2.png
pre-migrationn checks18.3.png

Review migration button20.png

Depending on what you have selected, the following messages may appear and you can choose:

a) Continue without resolving warnings or Resolve warnings

b) Continue or View all app vendor checks

message1.png

message2.png

4. Review migration

Next double check if everything you selected before is on that summary, then you are ready to Run (1) migration

review migration_run_button.png

You have the option to perform the migration later, simply select the Save button instead of Run.
You can also use this option, if you want to fix the errors first and return to the migration later.

5. Migration run

You will be moved to Migrations dashboard where you can track your migration status.

Migration dashboard(1).png

then if it’s finish it will change status to complete (if loader spin all the time and it do not end then please refresh page or you can go to View details (1) in action menu - then you will see updated status). You can also go directly to the instance by Go to cloud site (2) option.

As a convenience, multiple migrations can be performed on a single Data Centre instance, with the settings and defaults stored in the instance's memory after the first migration. They can be refreshed and changed at any time.

migration dashboard view details_action.png

Selecting View details will take you to a page with a summary and details of your migration.
The Go to cloud site action will take you to your cloud instance.

after migration_details.png

Now your data has been migrated! You can go to Cloud instance.