1. Add Label Manager Addon in Jira Cloud Instance
We do support migration licenses for our apps. Please reach out to our support if this applies to you.
Note: Our app trial period comes without functional limitations so you can start already.
2. Add the Label Manager Custom Fields
Use the Jira native custom field interface to create the lable manager custom fields used in onPrem on the cloud instance.
3. Copy the global configuration for all Label Manager Custom fields
Label Manager on Jira Cloud supports bulk adding of label options using comma separated syntax.
Option 1:
Copy paste existing labels from the UI in onPrem into CSV
Migrate the Labels into comma separated list
Add comma separated list in bulk in Jira Cloud to the specific field in Label Manager Global Settings
Option 2:
Get the existing labels form onPrem via API
Migrate the Labels into comma separated list
Add comma separated list in bulk in Jira Cloud to the specific field in Label Manager Global Settings
4. Add Project specific configuration if used
If any project is using specific configuration, go into project settings and update the configuration accordingly.
Just like step 3.
5. Export the Issues from OnPrem in CSV
After issues are migrated to cloud.
Export issues in onPrem to CSV. (Only export current fields “Key”, “Label Manager Field”)
Google sheets formula
=CONCATENATE("{";CHAR(34);"labels";CHAR(34);":[";CHAR(34);$C2;CHAR(34);",";CHAR(34);$D2;CHAR(34);","; CHAR(34);$E2;CHAR(34);"],";CHAR(34);"colors";CHAR(34);":[";CHAR(34);"grey-light";CHAR(34);",";CHAR(34);"grey-light";CHAR(34);",";CHAR(34);"grey-light";CHAR(34);"],";CHAR(34);"labelSource";CHAR(34);":";CHAR(34);"global";CHAR(34);"}")
6. Update the field values in csv using provided excel script
Label Manager fields in OnPrem are using a different field value object structure than in cloud.
Therefore it is necessary to update the field values in the exported csv before importing to cloud.
TODO: Migration script in csv
7. Import the updated csv into Jira Cloud
TODO: normal user csv import ODER admin csv import.
TODO: How to map the field values to the existing Jira Issues without creating new ones. (Issue Id will be different in cloud than it was in onPrem.)