Migration from server/DC to cloud

Description

This page explains:

  • Migration support details for the app content from server/DC to cloud
  • Differences between the server/DC and cloud version of the app

Pre-requisites

Ensure to:

  • Install Clone Plus for Jira, version 6.8 or newer, and Jira Cloud Migration Assistant (once JCMA supports migration) on the server/DC instance.
  • Comment out any custom clone operation(s) from the clone properties file in server/DC, if you do not intend to migrate the respective clone operation(s) to cloud.
  • If you intend to migrate only users and groups from server/DC to cloud, do not select the Clone Plus for Jira app in the migration screen while using JCMA. Keep in mind that not all the mappings are available when the Clone Plus properties file is migrated. This can result in unusable mappings in app data. For example, project data and configurations are not migrated.
  • When you migrate clone customizations from:
    • The same server instance to that of cloud more than once, the app data is overwritten in the cloud instance after the latest migration.
    • Multiple server instances to the same cloud instance, multiple default clone operations (or multiple clone operations with the same name) are shown on cloud. Note that each of such configurations can be unique though the name and description are the same.

Migration process

  1. Install (and configure) Clone Plus for Jira on your cloud instance.
  2. Install Jira Cloud Migration Assistant on the server/DC instance from which you intend to migrate the Clone Plus for Jira app configurations. (This step is applicable once JCMA supports migration.)
  3. Use System > IMPORT AND EXPORT > Migrate to cloud to navigate to the migration screen where you can migrate global app configurations, Clone Properties file configurations, and/or users and groups, as required. For more information, refer to this page.
  • It is recommended to retain the clone operations (do not edit or delete) on the cloud instance as-is while the migration process in progress. Once the migration is complete, verify if the custom clone operations from the server/DC instance are migrated as expected to the cloud instance before editing or deleting any migrated clone operation on cloud.
  • Global configuration settings such as analytical data settings from server/DC override the respective settings on cloud.
  • The Bulk Clone feature is turned ON for all the clone operations once they are migrated to cloud from server.

Limitations

The following fields is not supported during migration:

  • username or user ID for user fields such as Assignee, Reporter etc...
  • specific components
  • Versions 
  • Issue security levels

  • Status

  • Labels

  • specific values in custom fields

  • entry substitution variable
  • Epic issue type includes
  • All the above mentioned fields for subtask cloning

Differences between server/ DC and cloud versions of the app

The following table lists the differences between server and cloud versions of the app:

FeatureServer/DCCloudNotes
Clone behavior configurationSupports a property file based configurationProvides easy to use configuration screen to define clone operations that control the clone behavior
Custom clone operationsSupports a maximum of 16Supports any number of clone operations

Clone options

  • copy attachments
  • copy watchers
  • copy worklogs
  • copy comments
  • copy subtasks
  • copy subtask estimates
  • copy parent reporter
  • copy parent versions
  • copy links
  • copy epic issues
  • copy epic issue subtasks
  • copy epic issue subtask estimates

Supports all the clone options

Supports all the clone options

Images or any form of media added to rich text editor issue fields are copied to the cloned issue only if Copy attachments is selected. If not, a broken image is displayed in the respective field of the cloned issue.

Refer to  JCPP-1332 - Getting issue details... STATUS

Mapping fields from original issue to a new value in the target issue conditioned on original issue field values

  • Set target project
  • Set target type
  • Set target component
  • Set target version
  • Set link type
  • Set link direction

Supports mapping all issue fields

For more information, refer to the mapping keys section in Clone properties

Supports only:

  • Set target project
  • Set target type 
  • Set target component
  • Set target version

For supporting set link type and set link direction, refer to:  JCPP-1210 - Getting issue details... STATUS

Setting standard and custom fields for subtasksSupportedNot supportedRefer to  JCPP-1041 - Getting issue details... STATUS

Clone conditions

  • Projects
  • Issue types
  • Status
  • Roles
Supports all clone conditionsSupports all clone conditions except RolesRefer to  JCPP-1295 - Getting issue details... STATUS

Clone properties

  • fieldExcludes
  • fieldIncludes
  • ignoreFields
  • projectIncludes
  • issueTypeIncludes
  • retainCommentsOriginalDate
  • retainWorklogsOriginalDate
  • epicIssueTypesIncludes

Supports all clone properties

Supports only:

  • Ignore fields (Not applicable to subtasks)
  • Field excludes
  • Project includes
  • Issue type includes

For missing clone properties in Cloud, refer to:

JCPP-1214 - Getting issue details... STATUS

JCPP-1212 - Getting issue details... STATUS

JCPP-1211 - Getting issue details... STATUS

JCPP-1213 - Getting issue details... STATUS

Post cloning processingFunctions as expected

Functions as expected with an exception:

When the administrator modifies the default link type name in issue linking settings from Cloners to any other name, no link is created between the source and target issues during cloning.

JCPP-1308 - Getting issue details... STATUS
Bulk CloneSupported for Data Center onlyNot supported JCPP-1249 - Getting issue details... STATUS
LocalizationNot supportedSupported in Spanish, French, German, and Italian. JCPP-1980 - Getting issue details... STATUS

Problem reporting

If you experience any problems or behavior changes that are unexpected, refer to Help and open a ticket with us. This helps us identify and prioritize fixes and improvements.