If you and your team are moving from Jira Server/ Data Center to Jira Cloud, be sure - your checklists will be safely migrated as well.
There’re two methods of Jira Server to Cloud migration:
Note |
---|
Make sure you are aware of recommendations from Atlassian on Server → Cloud migration and plan it properly |
Tip |
---|
For the features difference - check theServer & Data Center vs Cloud Comparison for Smart Checklist |
Jira Site Import
Check how to use Jira Site Import to migrate from server to cloud
Your checklists will be migrated automatically.
Jira Cloud Migration Assistant (JCMA)
Check how to use the Jira Cloud Migration Assistant to migrate from server to cloud.
Anchor | ||||
---|---|---|---|---|
|
Preconditions
Server/Data center
update the Smart Checklist for Jira. Pro addon to the latest version
update Jira Cloud Migration Assistant (JCMA) to the latest version
Cloud
install the latest version of the Smart Checklist for Jira. Pro addon on your Cloud instance
activate your Smart Checklist for Jira. Pro addon license/trial
do not create custom fields `Checklists` and `Smart Checklist Progress` in advance
JCMA flow
Step 1: Assess your apps.
Select Smart Checklist as an app that is `Needed in cloud`:
Step 2: Prepare your apps.
Connect to your cloud instance.
Check that you have Smart Checklist for Jira. Pro addon installed.
Agree to migrate addon data.
Step 3: Create and run new migration.
Enter the name of the migration.
Select Cloud instance.
Select Projects, Users and Groups, and Customers to migrate.
Review migration settings and fix errors if needed.
Run migration.
Post actions
Wait until your migration finishes and check its status for Smart Checklist for Jira. Pro addon:
If the migration status of the Smart Checklist for Jira. Pro addon data is “Completed” - the server part of the migration is successfully finished, you can wait for a few minutes and check your data on the Cloud instance:
In case during migration of the data some issues occur with data exporting from Server or connection to Cloud - migration status will be failed with error message available in the details:
You can check detailed logs for Smart Checklist migration by opening the page: /plugins/servlet/railsware/migrationlog
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Smart Checklist content is migrated together with your project data. |
FAQ about Smart Checklist add-on migration in versions 5.7.0 and higher
Anchor | ||||
---|---|---|---|---|
|
We did our best to migrate all the data, but unfortunately, due to differences in Server and Cloud versions - there are some data types that will be available on Cloud in a different way or not available at all. Please see details information in the table below:
Data type | Migration support | Visibility on Server | Visibility on Cloud | ||||||
---|---|---|---|---|---|---|---|---|---|
Checklist items | |||||||||
Checklist items with different markup:
|
| ||||||||
Checklist items with dates |
| * all dates are visible in same color | * dates in the past, current and future visible in different colors | ||||||
Checklist items with real assignees |
| * id (username/login) is visible | * user full name is visible | ||||||
Checklist items with not-existed assignees |
| ||||||||
Statuses | |||||||||
Default statuses |
| ||||||||
Custom statuses |
| * after migration it is needed to return needed order manually | |||||||
Templates | |||||||||
Manual global / project templates (with trigger = none) |
| global project | global project | ||||||
Global / project template with trigger “Issue created” without additional conditions |
| * template is applied to all issues types | * template can be applied only manually | ||||||
Global / project template with trigger “Issue created” with “Issue Type” condition (is one of / equals) |
| ||||||||
Global / project template with trigger “Issue created” with “Issue Type” condition (all issue types) |
| ||||||||
Global / project template with trigger “Issue created” with “Issue Type” condition (is not one of / does not equal) |
| * template applied based on conditions | * template migrated without triggers (can be applied only manually) | ||||||
Global / project template with trigger “Issue created” with any conditions different from “Issue Type” |
| * template applied based on conditions | * template migrated without triggers (can be applied only manually) | ||||||
Global / project template with triggers “Issue updated”, “Issue transitioned” with any extended conditions |
| * template applied based on conditions | * template migrated without triggers (can be applied only manually) | ||||||
Global template with “Multiple projects” selected |
| * template is visible on “Global templates” tab | Template will be saved as “project template” in migrated projects | ||||||
Other | |||||||||
“Modify Smart Checklist” post function |
| not migrated, as feature not available in Cloud | |||||||
“Smart Checklist Completed” validator |
| not migrated, as Cloud has different implementation | |||||||
Smart Checklist history |
| not migrated |
Anchor | ||||
---|---|---|---|---|
|
In this case, after migration you will have duplicated custom fields:
Smart Checklist Addon on Cloud is using “Checklists” and “Smart Checklist Progress” custom fields to sync data in, so after migration to have migrated data saved to the addon database (and visible in the addon) - you need to synchronize data from custom field to addon database.
Note: this process runs in the background and may take some time before all the data finishes synchronizing.
Anchor | ||||
---|---|---|---|---|
|
Smart Checklist addon has the next settings based on versions:
Server / Data center
SC Addon visibility per Project
Display statuses for checklist items
Strikethrough checked items
Show on the customer portal
Notify assignees
Cloud
SC Addon visibility per Project
Display statuses for checklist itemsStrikethrough checked itemsShow on the customer portalNotify assignees
Settings that are available only in Server - cannot be set up on the Cloud version.
Settings that are available in both versions are set up separately on different instances and are not migrated during JCMA migration.
Anchor | ||||
---|---|---|---|---|
|
In the Server version - access to Smart Checklist is managed by Jira permissions, so permissions are migrated together with users and groups via the JCMA tool to Cloud.
On the Cloud instance, you can proceed with using default Jira permissions or configure custom permissions for the Smart Checklist add-on.
Anchor | ||||
---|---|---|---|---|
|
Pre-condition
"Checklists" custom field (mandatory) and "Smart Checklist Progress" custom field (optional) must be added to your Jira Server instance and must keep checklists' values.
Check the instructions on adding Checklists and Smart Checklist Progress custom fields to Jira Server (actual only for versions lower than v.5.0.0).
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
Please check if you use Custom Fields (
If you would like to migrate Jira Server / Data Center to Jira Cloud instance with pre-created Custom Fields it will cause additional migratedCustom Fields creation which will not be available for Smart Checklist. These additional fields will store all the data from Jira Server / Data Center: In this case you would need to copy all information from At the same time, |
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
Please note: If you add the |
Migration
Run your migration with Jira Cloud Migration Assistant tool
custom fields “Checklists” and “Smart Checklist Progress“ will be created on the target instance (learn more about the Custom Fields) with checklists content
Then go to Apps → Manage Apps → Smart Checklist → Global Settings → Synchronize checklist storages
Click “Synchronize” button
The data from “Checklists” custom field would be transferred to a database and checklists per Jira issues will be created.
NOTE: the process may take a while. Make sure to run it out of working ours of your organization/
Templates Migration
Templates won’t be migrated automatically at this moment. You have to re-create them manually on the target Cloud instance one by one.
Follow the steps below
Expand | ||
---|---|---|
| ||
|
Can I Migrate my Smart Checklist for Jira Server/ Data Center License to Jira Cloud?
Unfortunately, no. Smart Checklist for Jira Server/ Data Center license is a one-time purchase with optional maintenance, whereas Cloud purchases are recurring subscriptions. As such, existing Server/ Data Center app licenses cannot be transferred or credited to Cloud. These are independent licenses that need to be paid for separately.
Info |
---|
If you already purchased your Jira Server/ Data Center license via the Atlassian Marketplace, you may contact Atlassian Support to see if you are eligible for a refund. |
Info |
---|
For any questions or feature requests contact us: smartchecklist@railsware.com |