/
Link two Jira DC instances

Link two Jira DC instances

Benefits of linking

Configuration Manager for Jira (CMJ) enables administrators to utilize linked Jira instances to direct deployments between them, eliminating the need for manual snapshot exports or file transfers.

You just select a linked instance from the drop-down menu, which will act as your Source Jira instance, and then choose any of the available snapshots from that instance to deploy to your current Jira instance, which acts as the Target instance. This way, admins can simplify change management between test, staging, and production environments.

On this page, you’ll find out how to link two Jira DC instances and how to utilize CMJ’s deploy from a linked instance option.

Prerequisites

To link and deploy between two Jira DC instances, you must:

  • Have the Jira System administrators global permission.

  • Have the same (or similar) Jira versions on both Jira DC instances.

  • Have Configuration Manager for Jira (CMJ) installed on both Jira DC instances.

Link two Jira DC instances

  1. Log into your Jira Data Center instance as a user with the Jira System Administrator global permission.

  2. Click the cog icon on the top bar and select Applications.

  3. From the left-hand side menu, click Application links.

  4. Then, on the far-right, click the Create link button.

    ApplicationLink.png

  5. The Application type is set to Atlassian product via OAuth 1.0 by default. Leave it like that and enter the application URL for the Jira DC instance you want to link.
    (Hint: You can get the instance link by going to Administration Settings → System and under General Settings, you’ll see your Base URL)

    image-20251111-093859.png

  6. If Jira detects your DC instance properly, you’ll get a quick summary and the option to check two boxes:

    • ‘The servers have the same set of users and usernames' - enable this box if you’re sure that both DC instances have the same set of users and usernames. Otherwise, leave unchecked if you’re unsure.

    • ‘I am an administrator on both instances' – this box is enabled by default and needs to be enabled if you’re going to be deploying from either DC instance using CMJ.

  7. Click Continue, and Jira will create the connection between the two Jira DC instances.

    image-20251111-094702.png

Deployment from a linked Jira instance

  1. On the Deploy Snapshot page, select From Linked Jira Instance.

  2. An option with a drop-down menu will appear on the page. From it, you can choose any Jira instance linked to the current one via an Application Link. This is particularly useful for applying changes to a production system from a linked staging system.

  3. From the Linked Jira Instances menu, select an instance from which you want to deploy a snapshot. This presents you with a list of all snapshots created on the linked Jira instance.

  4. Click the Deploy button of a snapshot to start the deployment process.

  1. From here, you’ll follow the standard deployment process based on the snapshot type - single-project deployment, multi-project deployment, or system deployment.