Table of Contents
Here is what you need to know about migrating your Jira Server instance with Chat for Jira Service Management to Jira Cloud.
Overview
| Info |
|---|
Automatic app data migration will be available as soon as Atlassian enables apps migrations in Jira Cloud Migration Assistant. As of 9 February 2021, migrating app data is not officially supported by the migration assistant. You can still use it, but this requires enabling the com.atlassian.jira.migration.app-migration.feature Dark Feature in your Jira Server instance (click the link to lear learn how to enable dark features in your Jira). After enabling the dark feature, you have to restart your Jira for the change to get applied to the system. |
When performing the migration, make sure that you have Chat verison version 1.8.0 or newer installed on your Jira Server. Then, verify that the app can be migrated:
...
Green tick in the Can be migrated column means that Chat's data will be migrated to cloud during your migration process.
What is Migrated
| Note |
|---|
At this time (as of 9 February 2021) Jira Cloud Migration Assistant does not support migrating Service projects. This means that direct migration of your conversation data is not yet possible using this tool. Therefore to retain the you will have to export your project data from the Server instance and import it into the Cloud instance manually - you can use this guide for instructions. Atlassian has promised to support Service projects for the Migration Assistant - watch this issue for more details.Chat conversations are stored as issues and comments. Therefore, the main part of conversation data migration will be done by Jira Cloud Migration Assistant. |
At this time, the set of Chat app data migrated from Server to Cloud includes:
...
What is NOT Migrated
At this time, the followings following are not migrated:
- Chat Settings inside the service project settings
- metadata inside Chat issues
- agents online/offline schedule
- Chat identity for anonymous user users to access Chat conversations from Widget without logging-in
...
After migrating from Server to Cloud, you will have to update your Chat Settings inside your service project. If you are using Chat Widget at the external website, you should update your Chat Widget JavaScript code at your external website according to the Chat Settings provided code - compare code snippets for Cloud and Server.
...