# Doing the migration

Email This Issue uses Atlassian’s **Jira Cloud Migration Assistant** for the migration. For information on how to use this tool, please refer to the [Atlassian Cloud migration guide](https://www.atlassian.com/migration/plan/cloud-guide#introduction).

#### 1. In the *Assess your apps* phase select the *Needed in cloud* option for Email This Issue.

<figure><img src="https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2FbeHvS50N0jJL8QSYFaAV%2Fassessyourapp.png?alt=media&#x26;token=54c60e60-0958-40e3-853e-1d7c183ddda8" alt=""><figcaption><p>Assess your apps phase</p></figcaption></figure>

#### 2. In the *Prepare your app* phase - *Install your apps* step make sure Email This Issue is installed on your Cloud site:

![Install your apps phase](https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2FVn91CVqyJuKm8ACPePdw%2Fimage.png?alt=media\&token=d21f5a87-a047-4374-8603-32bae5bbd394)

#### 3. Wait for the migration to complete

There are three stages of the migration progress:

* **0% - 49%** The migration has started and is in progress on the On-prem side or it is being transformed. This step might take from a couple of seconds to even a couple of hours depending on the amount of emails being moved from the On-Prem to the Cloud.

* **50% - 99%** The migration is in progress and data is being imported into the Cloud instance&#x20;

* **100%** - The migration is finished. The result of the migration could be either **Success** or **Failed**.

<figure><img src="https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2Fh8wblhOpFtJq358dfHV4%2Fprogress.png?alt=media&#x26;token=f5cd46f5-5955-44b4-9c40-fc8a5be4fe31" alt=""><figcaption><p>Apps page</p></figcaption></figure>

## Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

During the migration, it might be the case that you see the following message:&#x20;

{% code overflow="wrap" %}

```
Import finished, however there was an error during the import of manual email permissions. Please review 'Send Issues in Email' permissions in your Permissions Schemes.
```

{% endcode %}

This means that your configuration and operational data imports are finished successfully, but there was a problem when importing the permissions to send emails manually.

{% hint style="warning" %}
If you are using your Cloud instance with a free plan, the import of the permissions will always fail, because free Jira plans don't grant access to the permission schemes.&#x20;
{% endhint %}

You should check it in the Jira Permission Schemes that all manual email permissions that were created prior to the migration are removed and  you should add every permission that was configured in your On-prem installation to every active Permission Scheme in your Cloud instance.&#x20;

On the On-prem side, you can find these settings under the P**ermissions and Condition for Sending Emails Manually** section of the **General Configuration** settings.

If you need help on how to configure permissions on your Cloud instance, please refer to our [Permissions](https://docs.meta-inf.hu/email-this-issue/administration/email-this-issue-for-jira-cloud-permissions) documentation.

In case of any other error, please [contact our support team](https://metainf.atlassian.net/servicedesk/customer/portal/1) with the following information:

* The **transfer ID** of the migration (shown in the error message)
* The target Jira Cloud URL
* The date and time of the migration (including the timezone)