How to renew authentication token for the Cloud Migration Assistant apps (CCMA/JCMA)

Summary

When trying to run the Jira Cloud Migration Assistant (JCMA) or the Confluence Cloud Migration Assistant (CCMA) to migrate from Server to Cloud, the migration plan fails and you need to renew the authentication token so the Server can connect to the Cloud site.

Solution

Overview

Atlassian Security has recently updated the guidelines for reducing the container token expiry, a change that has been embraced by all platform teams. To mitigate any potential Migration failures resulting from this shortened expiry period, a TTL check has been implemented to verify the token longevity of 19 days. For both JCMA and CCMA, authentication tokens are set to expire in 21 days.

Let's consider a scenario where the token is refreshed today. After 16 days, the Migration Assistant will show a warning message about the container token expiring in 5 days, and on the 21st day, the preflight check will block, saying the container token has expired.

In order to avoid any precheck blockers associated with token expiration, it is advisable to renew the token prior to its expiry by following the steps below:

Environment

This message applies to the Cloud Migration Assistant apps (JCMA and CCMA).

Renew Token in Jira Cloud Migration Assistant(JCMA)

1. In Jira Server or Data Center, go to Settings > System.

2. In the left panel, locate the Import and Export category, and select Migrate to cloud. The Migration Assistant home screen appears.

3. Click on the Create a Migration button located in the Migrate your data section of the Migration Assistant home screen.

   Create a Migration Screen

   1. If this is the first Migration Plan, the Screen looks below

      

   2. If there are previously created migration plans, then the screen looks below

   

4. The next screen presented will read "How It Works". Click Connect to cloud in the action bar at the bottom.

   Connect to Cloud screen

   

5. Click Choose cloud site located below the Choose your destination cloud site* dropdown menu

   Choose cloud Site screen

   

6. On the Choose your Cloud Destination pop-up, click Continue.

   Choose your destination screen

   

7. If you want to log in with a different user, for example, a user with different site/org administrative privileges:

   1. click Change account

   2. Re-enter the login credentials and proceed to select cloud site

      Connect to Cloud Site Screen

      

8. If you want to continue with the same user and renew the authentication token:

   1. Choose a cloud site (right below the Migrate to dropdown menu)

9. Check the Allow Atlassian to access migrations data* box

10. Click the Confirm button.

Renew Token in Confluence Cloud Migration Assistant(CCMA)

1. In Confluence Server or Data Center, go to Confluence Administration > General Configuration

2. Look for the Atlassian Cloud category > select Migration Assistant

3. Click on the Migrate your data section of the Migration Assistant home screen.

4. Click on the Create New Migration button from the next screen.

   Create a Migration Screen

   

5. The next screen presented will read "How It Works". Click Connect to cloud in the action bar at the bottom.

   Connect to Cloud screen

   

6. Click Choose cloud site located below the Choose your destination cloud site* dropdown menu

   Choose cloud Site screen

   

7. On the Choose your cloud destination pop-up, click Continue.

   Choose your destination screen

   

8. If you want to log in with a different user, for example, a user with different site/org administrative privileges:

   1. click Change account

   2. Re-enter the login credentials and proceed to select the cloud site

      Connect to Cloud Site Screen

      

9. If you want to continue with the same user and renew the authentication token:

   1. Choose a cloud site (right below the Migrate to dropdown menu)

10. Check the Allow Atlassian to access migrations data* box

11. Click the Confirm button.