Apps' Data and Global Configuration

On this page:

Migration of global configuration is available since Configuration Manager for Jira (CMJ) version 6.5.0
Migration of app data is available since CMJ version 6.11.0

Introduction

As part of the App Integrations functionality, you can export and import the "global" configuration and apps' data of the apps on your system, integrating with Configuration Manager for Jira.

“Global configuration” means app data that is not related to projects, custom fields, or any other object (configuration element) in Jira.

“Apps' data” refers to any custom functionality of an app that extends standard Jira functions. For example, the “listeners” and “behaviors” in the ScriptRunner app are such functions. You can export and import app data between Jira instances with your snapshots, if:

This feature extends the CMJ’s snapshot creation wizard.

How to migrate global configuration and app data?

System Snapshots

When creating system snapshots, you can only choose whether to include the available global configuration and apps' data of all integrated apps on your Jira system or not to include any apps' data at all.

To export global configuration and app data of all integrated apps:

  1. Log in as a user with the Jira System Administrators global permission.

  2. Choose the cog icon at the top right of the screen, then from the menu, choose Configuration Manager.

     

  3. From the menu on the left, choose the Create Snapshot option.

  4. Select the System Configuration button in the wizard and enter a name for the Snapshot. Optionally enter a description.

  5. Enable the Include Global App Data checkbox.
    The snapshot will include apps' global configuration and app data of all installed apps integrating with CMJ.

Project Snapshots

When creating a project snapshot, you can select the apps you want to export. Additionally, you can exclude any integrated app’s global configuration and app data.

To export global configuration and app data of integrated apps:

  1. Log in as a user with the Jira System Administrators global permission.

  2. Choose the cog icon at the top right of the screen, then from the menu, choose Configuration Manager.

     

  3. From the menu on the left, choose the Create Snapshot option.

  4. Select the Project Configuration button and enter a name for the snapshot.

  5. Select as many projects as you need to include in the snapshot. Optionally enter a description.

  6. Click Next until you reach the Select Apps page in the wizard.

  7. Check the box next to an app, and this will include its global configuration and app data in the snapshot.

  8. To make a more precise selection, you can expand each app and check the boxes individually next to the global configuration and app data you want to include in the snapshot.

  9. Click the Create button.

Why do you see a different organization of the app data for different apps?

The organization of the app data depends entirely on the app vendor’s approach during the integration with CMJ. For some apps, you may be able to drill down a comprehensive list of data categories containing another level of data objects. For other apps, you may find only a flat list of data objects or categories.

Importing global configuration and apps' data

To import global configuration and apps' data:

  1. From the menu on the left, choose the Deploy option.

  2. Choose the snapshot that includes global configuration and app data. Read the documentation to learn more about configuration snapshot deployment.

  3. On the Analyze phase, navigate to the Apps tab.

  4. You will see messages informing you about the specific event - whether Configuration Manager for Jira adds, changes, or deletes global configuration and app data.

  5. Click Next and finish the deployment.

Prerequisites for Snapshot Import
Before importing a snapshot, make sure you have all necessary apps installed on your target Jira instance. The deployment will stop if an app’s data is included in the snapshot but the app is not present on the target instance.