🛫Server to Cloud - Automatic Migration tool

General information

The automatic migration path for Email This Issue is available since version 9.3.0 in On-prem versions (the Cloud version is released at the same time of this version). It can be used to plan and execute migrations in test and production environments alike.

Current limitations of the migration:

• No filtering for project data is available. If you set it in the Jira Cloud Migration Assistant to only migrate certain projects, it will not be applicable to the Email This Issue configuration.

• Email This Issue migration tool supports only full migration. All old data on Email this Issue Cloud side will be lost once the migration is done.

• The migration of Mail Handlers is limited in its functionality. For more details see the Finalize Migration in Cloud section.

• The Default event type will not be migrated, therefore this event type will be removed from the Notification events' Event Types list. If the Notification event was listening only on the Default event, the notification event will not be migrated at all.

• Workflow post-function settings are not migrated at all.

The process of moving Email This Issue data from On-prem to Cloud instances can be divided to three main sections:

• Preparing Email This Issue for migration

• Using the Cloud Migration Assistant, affectively doing the migration

• Post-migration configurations

On-prem to Cloud Migration support

The below tables attempt to list the migration modes of Email This Issue features.

✅ FULL means that all data is automatically migrated during the process and needs only a check-up from the user when it's done.

🔧 CORRECTION REQUIRED means that the user should manually check and carry out additional configurations after the migration is done.

⛔ NOT SUPPORTED means that the features are not migrated at all. This is either due to them not being applicable to the Cloud platform or it is due to technological limitations.

Configuration data

On-prem configuration	Cloud configuration	Migration mode
OAuth2 Credentials	OAuth2 Credentials	✅ FULL
Outgoing Mail Connection	Outgoing Mail Connection	🔧 CORRECTION REQUIRED
Incoming Mail Connection	Incoming Mail Connection	🔧 CORRECTION REQUIRED
Next-Gen Mail Handler	Mail Handler	🔧 CORRECTION REQUIRED
Template	Email Template	🔧 CORRECTION REQUIRED
Webhook	Webhook	✅ FULL
Notifications	Email Notification Schemes	✅ FULL
Context	Manual Email Configuration	🔧 CORRECTION REQUIRED
Context	Advanced Email Configuration	🔧 CORRECTION REQUIRED
Manual Email Defaults	Manual Email Configuration	🔧 CORRECTION REQUIRED
Canned Responses	Responses	🔧 CORRECTION REQUIRED
Distribution Lists	❌ NO SUCH CONFIGURATION	⛔ NOT SUPPORTED
Attachment Filters	❌ NO SUCH CONFIGURATION	⛔ NOT SUPPORTED
General Configuration	Advanced Email Configuration	🔧 CORRECTION REQUIRED
General Configuration	Manual Email Configuration	🔧 CORRECTION REQUIRED
General Configuration	Permission Schemes	✅ FULL
Workflow post-function	Workflow post-function	⛔ NOT SUPPORTED

Operational data

Server configuration	Cloud configuration	Migration mode
Email log	Email Audit Log	✅ FULL (See ℹ️)
Outgoing Mail Queue (Mail Generation Queue)	Outgoing Mail Queue	⛔ NOT SUPPORTED
Incoming Mail Queue	Incoming Mail Queue	⛔ NOT SUPPORTED
Incoming Mail Log	Incoming Log	⛔ NOT SUPPORTED

Migrated email logs will ONLY be available in the main Administration section under the Email Audit Log. The Emails tab of individual issues will only show emails sent and received after the migration.