App migration

RECOMMENDED - Automated Migration (using JCMA)

We now support the Jira Cloud Migration Assistant to offer fully automated server to cloud migrations.

This is the recommended way.

Please make sure you use the latest version of Capacity Tracker Server before starting your automated migration process.

ALTERNATIVE - Manual Migration

This is experimental and should only be used by advanced users.

For any other need, we provide a manual way to export/import data through the CT admin configuration page.

Unfortunately, we have no way of knowing how your internal Jira IDs have been updated (or not) so this could require significant manual labor on your part to move from one Jira platform to another.

Export

  • Go to your Jira Administration > Manage apps > Capacity Tracker Configuration

  • Click on “Export my data”

This will export everything stored by Capacity Tracker in a zip archive, broken down by data type:

File name

Description

File name

Description

global-config.json

High level app configuration, such as the “Jira Permissions” flag.

global-addon-properties.json

User days off.

board-properties-<boardId>.json (one file per board)

Board configuration.

Import

Before importing the zip file, you need to make sure all your internal Jira IDs have been updated in the files:

Prepare your Data

global-config

Nothing to do here.

global-addon-properties

Open the JSON file and replace every old user ID with the updated ones.

board-properties-<boardId>

  • <boardId> needs to be replaced by the updated ID.

  • Open the JSON file and replace sprint/version & user IDs

{ ... "sprintSettings": { "1": { // This need to be replaced by the updated sprint/version ID "userCapacitySettings": { "JIRAUSER10000": { // This need to be replaced by the updated user ID ... } } }, "2": { // This need to be replaced by the updated sprint/version ID "userCapacitySettings": { "JIRAUSER10000": { // This need to be replaced by the updated user ID ... } } } }, ... }

Manual Import

Once all the files have been updated, you can proceed to the import step.

  • Go to your Jira Administration > Manage apps > Capacity Tracker Configuration

  • Click on “Import my data”

  • Select the ZIP archive containing all the JSON files (they should be at the root of the archive, not in folders).