The JMWE app has an automated migration path and can be migrated from Jira Server/Data Center (JMWE version 7.2.0 and later) using Jira Cloud Migration Assistant (JCMA). Be aware that JMWE’s Cloud migration using JCMA is currently in beta, so you may wish to test the JMWE migration in a trial/test Cloud instance.
| Note |
|---|
BEFORE YOU BEGIN
|
| Info |
|---|
Note: If you have already migrated to the Cloud and need information regarding how to fix errors, see the Post Migration page. |
Start the Migration
Before preparing your Data Center/Server instance for, verify that Jira Cloud Migration Assistant is installed!
The migration process starts on your Jira Data Center/Server instance, where you must prepare your data for migration.
To being the migration, follow these steps:
Log into your Jira instance as an Administrator.
From the Administration menu ( ⚙️ ) click System.
In the left-hand panel, scroll down to IMPORT AND EXPORTand click Migrate to cloud. The Migration Assistant home page will open (Figure 1, right).
The following sections will detail any special considerations for JMWE in each of the major steps of the migration process.
Assess you apps
During the Assess your apps step, make sure that you have marked Jira Misc Workflow Extensions status as Needed in cloud (Figure 2, right). If a green check does not appear, you will need to upgrade to version 7.2.0 or later of JMWE Server or Data Center to migrate using JCMA.
You can check the compatibility of your extensions using the View differences link, or you can see the feature comparison between Data Center/Server and Cloud here.
When you have determined the migration status of all of your installed apps, click Done.
Prepare your apps
During thePrepare your apps step, the migration process will verify that JMWE for Jira Cloud is installed on the destination Jira Cloud instance. You must be an Administrator on both the source Data Center/Server instance and the destination Cloud instance. Selecting your destination cloud instance will require that you input the base URL of your Data Center/Server instance, found under System → System info.
Once you have verified that all required apps are installed on your destination Cloud instance, you can continue to prepare your migration by completing the Assess and prepare your users step and the Review all email domains step. When you are fully prepared to complete the migration, move to the next step.
Create a migration
After completing all of the pre-migration steps, you create a migration and then execute that migration. JCMA will walk you through the steps necessary to complete the migration. You will need to name your migration, choose a migration stage (Production vs Testing), and verify the destination Cloud instance. During the setup of your migration, you will be prompted to choose what to migrate - be sure to select Choose what to migrate so that JMWE can be added to the migration.
During the pre-migration checks, the Apps section will likely display a warning. click View app vendor checks to open a list of potential issues. These issues can include:
Groovy scripts - Jira Cloud does not support Groovy; instead, it utilizes Jira expressions or Nunjucks for scripting purposes.
Known incompatibilities - Known issues such as extensions that do not exist in Jira Cloud, or other incompatible configurations.
You can download CSV reports for each of the issues; it is highly recommended that you download and review these reports. They will provide guidance on any extensions, actions, or configurations that may not migrate completely.
When the JMWE migration is finished, you will see the status as Complete in the Apps section.
| Info |
|---|
A message will display telling you whether the migration was successful, along with information about the total number of workflow extensions, how many were fully migrated, how many could not be migrated, and how many need attention. |
Check the completed migration
When the JMWE app migration is shown as complete in JCMA on your Jira Data Center/Server instance, open your Jira Cloud instance. Navigate to the JMWE app pages. If there are any migration issues requiring your attention, you are notified on the JMWE Overview page.
Click the Take action link in the notification box to proceed directly to the Post Migration page. Alternatively, you can select Post Migration at the bottom of the left navigation. This page and page link only display if you have migrated JMWE data from Jira Server or Data Center to Jira Cloud.
| Info |
|---|
You are viewing the documentation for Jira Data Center/Server. |
On This Page
| Table of Contents | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
