Preparing for the migration

There are two parts of preparing for the migration:

It is essential that you follow the process carefully and not miss any of the steps. If at any time you run into problems, reach out to our support team and send us as much information as possible, including screenshots and an explanation of what happened.

On-premise prepare steps

1. Download and install the latest version of Email This Issue.

2. Remove any configuration that you don’t want to migrate to the cloud.

3. Disable every Incoming Mail Connection.

Disabling Incoming Mail Connections created with Email This Issue on the On-Prem version

If you have Incoming Mail Connection created with Jira it should be disabled as well.

4. Clean up your Incoming Mail Queue

Check if there are any important emails in the Filtered out or Failed incoming mail queues. If you need those emails, make sure to requeue them before the migration.

After this, wait for the New and Being processed queues to become empty. These steps assure that these emails will be migrated as well.

Incoming mail queue before cleanup

5. Prepare incoming mail accounts

All emails that you do not want to be processed later in Cloud should be moved out or removed from the mail account folder that is used by Email This Issue for incoming emails. By default, this folder is called “INBOX”. To check if your Incoming Mail Connections are using custom folder settings you should look for the Folder option:

Incoming mail connection - Folder option

6. Set email audit log migration period

Optionally, you can set the time frame from when the audit log items should be migrated. The default time frame is to migrate from the last 1 month.

  1. Navigate to the Email Log in the Email This Issue administration settings

  2. Click on Migration then select the time frame that fits your needs from the Migrate from the last select list.

  3. Click on Save settings

Cloud-side preparation

1. Make sure Email This Issue is installed and has a valid license on your target Cloud instance.

2. Disable every Incoming Email Connection

Disabling incoming mail connections in the Cloud version

3. Clean up your Incoming Mail Queue

Check if there are any important emails in the Skipped or Error incoming mail queues. If you need those emails, make sure to requeue them before the migration.

After this, wait for the Active and Processing queues to become empty. These steps assure that these emails will be migrated as well.

Incoming mail queue before cleanup

4. Prepare incoming mail accounts

All emails that you do not want to be processed in Cloud should be moved out or removed from the mail account folder that is used by Email This Issue for incoming emails. By default, this folder is called “INBOX”. To check if your Incoming Mail Connections are using custom folder settings you should look for the Folder option:

Incoming mail connection - Folder option

5. Enable data migration to your Cloud instance in Email This Issue

This process can take a few minutes to complete, and there is no confirmation of its success.

To enable data migration, navigate to Email This Issue Administration - Migration Options:

Enabling data migration setting in Cloud

Last updated

Was this helpful?