Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The JSU team is pleased to announce that JSU will be is compatible with Atlassian’s Jira Cloud Migration Assistant (JCMA) for app migrations. This means that for the first time, you’ll be able to you can automatically migrate most of your JSU workflow automations from your Server instance to your Cloud instance.

Note

It is highly recommended to test your migration on a different Cloud instance so that you may become familiar with the results, before proceeding to migrate your Server app data to your production Cloud instance.

...

How to navigate to the Jira Cloud Migration Assistant add-on

Info

It is recommended to always use the latest available version of the Jira Cloud Migration Assistant (JCMA) add-on by Atlassian. As of writing the latest version is 1.6.3. You can track updates to JCMA through Atlassian’s app migration https://developer.atlassian.com/platform/app-migration/changelog/.

...

  1. Select Administration (blue star) > System.

  2. Under IMPORT AND EXPORT in the left sidebar, select Migrate to cloud. The Migration Assistant home page is displayed.

...

Note

Before you can commence a migration, you need to complete the steps outlined in the JCMA tool to assess and prepare your apps. This guide will give a brief overview of how to do this with JSU. It is highly recommended to become familiar with Atlassian’s https://support.atlassian.com/migration/docs/jira-cloud-migration-assistant/ while preparing your instance and other apps for a Cloud migration.

...

How to include JSU in your app-assessment

  1. Assess your apps - you will need to select which apps you want to include in your migration. All apps must have a decision status selected before you can proceed to the next step.

    1. Select View app assessment.

    2. Find JSU in the list of apps and select Needed in Cloud from the Status dropdown.

    3. When you’re happy to proceed, select Done.

      Asses your apps page in Jira with JSU set to Needed in Cloud.Image Modified

  2. Prepare your apps - next, you need to link your Jira Cloud instance to the JCMA tool via the prompts.

    1. Select Begin preparing on the Prepare your apps panel on the Migration Assistant home page.

    2. Select the required destination Cloud site then select Choose cloud site to link your chosen cloud instance

    and
    1. .

    2. Select Continue to navigate through the remaining preparatory steps, then click Done.

      The Choose your destination cloud site prompt for JCMA.Image Modified

  3. Migrate your data - when

    1. When you are ready, on the Migrations

    dashboard,
    1. Assistant home page, go to the Migrate your data paneland select Create

    new
    1. a migration to begin your migration activity.

    Proceed through the corresponding prompts until you are ready to commence the migration.
    The Migrations dashboard in Jira.Image RemovedOverview of the migration steps for JCMA as described on this page.Image Removed
    1. On the step “Would you like to migrate your Apps?” - Select If you have already performed a migration, you can select Create a migration on the Migrations dashboard page.

    2. Select Connect to cloud.

      Overview of the migration steps for JCMA as described on this page.Image Added

    3. Select the Choose what to migrate option.

    4. Edit the options as required. For the Apps option, select All to ensure JSU is included in your migration activity.

      Image Added
    5. Select Run pre-migration checks.Review any possible errors relating to your migration before proceeding. Click

    6. The migration assistant displays the results of all the pre-migration checks. Review any possible issues by expanding the relevant check.

      Image Added
    7. Status
      colourPurple
      titlenew
      Under Apps, select View app vendor checks.
      JSU has implemented two app vendor checks to help your JSU data migrations run smoothly. See https://support.atlassian.com/migration/docs/app-vendor-checks/ to learn more about app vendor checks.

      Image Added
    8. Follow the steps to resolve any issues before proceeding, or download a report to help with post-migration cleanup as described in the next sections.

      Image Added

    9. Select Continue to move to the Review stage of your migration, then when you are ready, select Runto commence your Cloud migration which includes your JSU app data.

...

Reviewing the status of your migration

After starting the migration, you can review it as it progresses by returning to the Migrations dashboard in step 3. Your Jira data will be migrated first, followed by your app data.

...

Info

The post-migration report will show a summary of INCOMPLETE if any warnings or errors were found during the migration. JSU relies on the JCMA tool to move across any workflows, resolutions, transitions etc. to configure your workflow rules correctly on your cloud site.

...

Post-migration report and cleanup

Click the link in the expanded section to open a new tab with your post-migration report for this specific migration. To view any of your post-migration reports on your cloud instance go to Settings (blue star) Apps > JSU Automation Suite for Jira Workflows > Reporting.

...