| Info |
|---|
This information correct as of October November 2021 |
The JSU team is pleased to announce that JSU will be compatible with Atlassian’s Jira Cloud Migration Assistant (JCMA) for performing app-migrations. This means that for the first time ever, you’ll be able to automatically migrate most of your JSU workflow automations from your Server instance to your Cloud instance.
...
| Info |
|---|
Hint: You can click “View details” to see more information on the migration activity if desired. |
...
The app-migration stage is the last step of the migration activity. When this stage has completed you can expand to see more information, including a link to the “JSU Cloud Post-Migration Report”.
...
| Note |
|---|
Note: The post-migration report will show a summary of “INCOMPLETE” if any errors were found during the migration. JSU relies on the JCMA tool to move across any workflows, schemes, resolutions, transitions etc in order to configure your workflow rules correctly on your Cloud site. |
...
Post Migration Report and Cleanup
Clicking the link in the expanded section will open up a new tab showing you your post-migration report for this specific migration. You can view any of your post-migration reports on your Cloud site by going to
Settings/Cog Icon>>Apps>>JSU Automation Suite for Jira Workflows (side panel) - Reporting
...
Looking at the post-migration report, we can see there are 2 warnings reported - one “Missing resolution” and one “Missing transition”.
These are because JSU couldn’t find a specific resolution and transition it needed to configure some features correctly on the Cloud side. This specific scenario is likely to be caused by one of 3 scenarios:
The JCMA tool didn’t migrate those specific resolution and transitions for unknown reasons
The JCMA tool didn’t migrate those specific resolution and transitions because they already exist on the Cloud site but with different IDs
The JCMA tool migrated those specific resolution and transitions but in doing so gave them new IDs which don’t match the Server configuration
| Info |
|---|
At this stage we can say that JSU has successfully performed an app-migration to the Cloud 🎉 All that remains is the specific clean up of workflow rules relating to any warnings identified |
...
Let’s look now at the workflows rules side-by-side on both platforms - how they are originally on our Server instance, and how they look after being migrated to the Cloud site.
Server:
...
Our server workflow contains 3 JSU post-functions, one of each for Linked Transition, one Clear Field Value and Update Any issue Field
Cloud:
...
All 3 have been successfully migrated to the Cloud, but the Linked Transition has a visible error
In the above images, you can see that all of our JSU post-functions have been successfully migrated to our Cloud site, but we can see the Linked Transition has a visible error. To deduce why that is we can have a look at the specific configuration of this on our Server site vis Cloud site.
Server:
...
Cloud:
...
As you might be able to see from the above images, our Cloud post-function is missing a value for the “All other sibling issues (for example linking to the target with the same link type) must have one of the following statuses” field, whereas the Server field contains the “Done” transition that has an ID of “31”.
If you remember our “Missing transition” warning from the post-migration report, it also told us that a transition with ID “31” couldn’t be found. Now that we’ve found the misconfiguration, let’s fix it.
On your Cloud side, edit the misconfigured post-function and add the correct transition to the empty field value (in our case we need to add “Done”) and then save your changes by clicking “Update”.
...
After you’ve resolved all issues on a workflow, don’t forget to Publish your workflow using the options at the top of your workflow screen.
...
…and that’s it! You’ve now successfully migrated to Cloud with all of your JSU workflow rules included! 🎉
...
| Tip |
|---|
Feedback wanted! How did your migration go? Was this guide helpful? Still have questions? Please feel free to contact us through our usual support channels and we’ll be happy to assist. |