Migration from Data Center to cloud
This page explains the migration support details for the Power BI Jira Connector app data from the Data Center to the cloud.
Pre-requisites
Data Center
Ensure you have the latest version of the Power BI Jira Connector app (Migration is supported from Power BI Jira Connector, version 4.2.10).
Install Jira Cloud Migration Assistant on the Data Center instance from which you intend to migrate the Power BI Jira Connector app configurations. For more information, refer to What is Jira Cloud Migration Assistant?
The Power BI Jira Connector Data Center app supports the integration of Assets (formerly known as Insight), Projectrak, and Tempo Timesheets. If you are using these integrations and want to migrate data to the cloud, ensure that these applications are installed on the cloud.
Cloud
Install (and configure) the Power BI Jira Connector app.
Use the supported integrations on the cloud after migration: If you are using any of the supported integrations in the Data Center and plan to use them on the cloud, then install the required applications on the cloud.
Assets (formerly known as Insight):
Assets is Jira Service Management’s native asset and configuration management tool. To use Assets for the Jira Cloud, install the Jira Service Management Cloud Premium or Enterprise. For more information, refer to Assets in Jira Service Management.
Create a new custom field with the name Assets. For more information, refer to Insight (now Assets) Integration.
Make sure the user who will use the Assets configuration on the Power BI Jira Connector has access to the Jira Service Management.
Projectrak Integration: To use project fields, install Projectrak ( project tracking solution for Jira) on your cloud instance. For more information, refer to Projectrak Integration.
Tempo Timesheets: To use Tempo Timesheets, install Tempo Timesheets on your cloud instance. For more information, refer to Tempo Timesheets.
Migration process
Before you begin, ensure you have all the required applications installed on the Data Center and cloud. Refer to Prerequisites.
Navigate to the Migration Assistant home screen: System > IMPORT AND EXPORT > Migrate to cloud. With the help of Migration Assistant, migrate the global app configurations, users, groups, permissions, and connectors as required. For more information, refer to this page.
The Jira Cloud Migration Assistant offers two migration options. We recommend selecting the Choose what to migrate option, as it provides you with the flexibility to select exactly what you want to migrate.
Post-migration review: The migration page allows you to view details, monitor the progress of the app migration, and view app migration progress logs.
You can monitor the progress of the app migration within the migration page.
The Migration dashboard lists the saved migrations.
To review your migration details, under Actions > select View details.
On the details page, you will find a summary of the migration and detailed progress for each project in the migration.
Under the App migration progress, click Actions (...) and select View logs to view details about the app migration progress logs.
The log file is a CSV file that is downloaded to your system and displays details about warning messages in the app migration progress.
If your migration is incomplete or has failed, you can download the error logs to understand the errors in detail. Refer to https://support.atlassian.com/migration/docs/troubleshoot-migration-with-jira-cloud-migration-assistant/#After-you-run-the-migration
If you are are stuck with the app migration or you encounter multiple warning messages in your app log file, refer to the App migration progress logs.
If you need further assistance, you can create a support request and share the log file and your cloud site URL.
Once the migration is complete, review your app on the cloud platform to validate that everything is functioning as expected.
Limitations
The below field configurations are not migrated for Connectors.
Entity | Field configurations not checked for Connectors after migration |
|---|---|
Dates |
|
Epic |
|
Portfolio | Parent Link |
Custom |
|
Tempo | Account |
Service Desk |
|
To configure the fields, edit the migrated Connector in the cloud, select the required fields, and Save the Connector.
Known Issues
The JQL queries are migrated as is for Connectors. To update the JQL query to be relevant to the cloud, edit the Connector in the cloud, input the JQL query, and Save the Connector.
Under Sprint Metrics, the Data Center Board configuration is not updated for Connectors in the cloud.
To update the Board relevant to the cloud, edit the migrated Connector in the cloud, select the Board, and Save the Connector.
AQL for Insight (Asset) Objects: The AQL defined for the Insight object in the Data Center is not migrated to the cloud.
To update the query, edit the Connector in the cloud, input the AQL for Insight (Asset) Objects, and Save the Connector.
Jira Importers custom field - ${field_Story_Points}: If any of the Data Center Connectors are configured with the custom field ${field_Story_Points}, then after migration, you will encounter an error for those specific Connectors data extraction.
Resolution (before migration): Before migrating to the cloud, edit the Connector that includes the custom field ${field_Story_Points} configuration in the Data Center, uncheck the custom field ${field_Story_Points}, and Save the Connector.
Migration use cases
Below are a few migration use cases that you may encounter during the migration process.
Use Case 1: Migration from the Data Center to a cloud instance is attempted single or multiple times.
Postmigration:
Single or multiple migration attempts are supported on the same cloud instance, and the Connector data is overwritten. The Connector data is extracted successfully and is functional in the cloud instance.
Use Case 2: Migration from the Data Center to different cloud instances.
Postmigration:
The Power BI Jira Connector app data supports migration to single or multiple cloud instances.
The Connector data is extracted successfully if migration is performed solely on one single Jira cloud instance.
However, when Power BI Jira Connector app data (the next migration or multiple migrations) is migrated from the Data Center to multiple cloud instances, the extraction of Connector data fails on all the Jira cloud instances.
To resolve this, you need to clean up all the cloud instances for Connector data and retain the data on only one single instance from which you intend to extract the Connector data.
Resolution: Postmigration, the Connector data extraction is supported on only one single Jira cloud instance. If you have migrated to multiple cloud instances, refer to the resolution options below.
Option 1 | Option 2 |
|---|---|
|
|
Post-migration Administration configurations
To know how the administration configurations are migrated from the Data Center to the cloud, refer to Post-migration Administration configurations.
Difference between Data Center and cloud version
To know the difference between the Power BI Jira Connector app’s Data Center and cloud version, refer to Power BI Jira Connector: Data Center and cloud feature comparison.
Problem reporting
If you experience any unexpected problems or behavior changes, create a support request. It helps us to identify and prioritize fixes and improvements.