Versions Compared

Key

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

...

  1. Your Jira instance runs on version 8.14 or above.
  2. Your version of the Surveys for Jira Server plugin is 4.0.8-jira8 or above.
  3. You've looked through Atlassian's documentation about a Jira Cloud Migration Assistant. 
  4. You are a Jira admin.



Before migration

Note

When you migrate data from Server/DC to Cloud using Jira Cloud Migration Assistant, there is no option to select which 3rd party plugins to move. Data will be migrated for all supported apps. Therefore, we highly recommend disabling plugins (on Server or Cloud site) that you have already migrated or not sure want to migrate.

  1. Install Surveys for Jira plugin or re-install it if you already have it on your Jira Cloud site. You have to re-install the app only once, before your first Surveys data migration. 

  2. Before starting a migration, enable feature flags for app migration in the server instance of Jira. Use the following link <Jira_URL>/secure/SiteDarkFeatures!default.jspa and add com.atlassian.jira.migration.app-migration.feature to Site Wide Dark Features if it is absent.



  3. Add additional plugin log packages so that to be able to check logs after migration. Go to System → Logging and profiling → in the Default Loggers section click Configure logging level for another package and add necessary packages with Track level:

    • com.cprime.jira.plugin.survey.services.CloudMigrationServiceImpl
    • com.cprime.jira.plugin.survey.listener.CloudMigrationProcessListener

...

Steps to follow to migrate from Jira Server or Data Center to Jira Cloud:

  1. To migrate data, go to to Jira Administration settings  settings in Jira Server System→ System  Import and Export section→ Migrate to cloud.
    Select Migrate to cloud in Import and Export section →
    Image Added


  2. Select Assess and Install apps and mark the Surveys for Jira app as Needed in cloud.

    Image Added


  3. Perform steps according to Assessment wizard.

    Image Added


  4. Go to Manage your migration and click Create new migration button.

    Image Modified

  5. On the next page, you may find a short Atlassian explanation about the migration steps. Click Connect to cloud to continue.



  6. Specify the name of migration and your cloud site, so that to connect your Server and Cloud instances.


    Info

    You need to be an admin in both your server and the destination cloud sites. If you have already connected a cloud site, you should see it in the dropdown. 

    If your Jira Server site is behind a firewall, you'll need to allow access to the domain: atlassian.com. You also might need to allow access to other Atlassian domains



  7. Depending on whether the appropriate projects already exist in the cloud, choose which data to migrate. You can transfer Surveys for Jira plugin data during or after the project migration



    Note

    If you have already moved your project to the cloud before, click 'I don't intent to migrate projects' and select Users and groups only. In this case, configured surveys, permissions, and survey results regarding tickets that are existed in cloud will be migrated.

    Note if you migrate plugin data after project migration and configuring a new survey in this project in cloud, survey results will be lost and overwritten by server data.



  8. You can choose to migrate all or some of your projects. You won’t be able to migrate projects with project keys that already exist in your Jira Cloud destination site.




  9. Choose how you want to migrate users and groups. Learn more about user and group migration.




  10. Make sure you marked the Surveys for Jira app as Needed in cloud to migrate the application data.

    Image Added

  11. In the next step, Jira Cloud Migration Assistant will perform checking and notify you if there are any warnings or blockers for migration data from Server to Cloud.




  12. Carefully read and evaluate all the warnings, if any, before starting the migration. If you decide to Continue and fix later, you can come back to view the errors once you have saved your migration.




  13. After you click Run, the process will start and you will be able to see progress and migration status on the Migration dashboard. It takes some time, depending on your data size.



  14. Once your migration is complete, you can go to your project on Jira cloud site and find migrated surveys

    Note, depending on the size of migrated projects and other data, it may take some time to start displaying Surveys for Jira data in the project.


    Note

    Currently, Atlassian's logs migration reports do not include information about plugins data. We recommend downloading and checking Jira logs manually. 


  15. To check Jira logs, go to Jira Administration → System →  Troubleshooting and support tools.




  16. On Create support zip tab, click Customize zip and select from the list Jira application logs.




  17. In the downloaded file, you can find information about the migration result.



...