Migration from Data Center to Cloud

This page describes the procedure of ActivityTimeline’s data migration from Jira Data Center to Jira Cloud.

1. Prerequisites

• Active Jira Data Center instance with ActivityTimeline installed v13.2+ (migration source)

• Active Jira Cloud instance (migration target)

2. Preparation (Jira DC side)

1. Make sure that each Jira DC user has an email address specified.

2. Perform the standard Jira Data Center to Jira Cloud migration to migrate Jira’s data.

3. Open Jira Data Center → ActivityTimeline app → Configuration → Advanced Settings page:

   1. enter “IMPORT_EXPORT“ into the Custom Functionality field (separate by comma if you already have some values there)

   2. click “Update” button

4. Open the new “Data Export/Import“ item on the left of the Configuration page.

5. Click “Export All Data“ button

   1. select both “Issues & Events“ and “Worklogs“ checkboxes

   2. select a date range period that you would like to migrate to Jira Cloud

      1. the shorter the period - the faster the migration

      2. you may perform multiple migrations so we recommend to start with the smallest possible date period like a few months

   3. click “Start Export“ button

   4. activitytimeline_export_<date>.zip data file should be downloaded in a web browser

   5. save it.

3. Preparation (Jira Cloud side)

1. Make sure that each Jira Cloud user has an email address specified (user’s will be mapped based on email address because Jira Cloud uses accountId instead of username).

2. Open Jira Cloud -> Configuration -> User Management -> click on '...' button in the top/right corner -> select 'Export users' action.

   1. select “All users“, “All users“ statuses and no “Additional data”

   2. the users data CSV file will be mailed to your email address.

   3. open that email and click “Download CSV file“ button in the email to download the file

   4. Save that instance-export-users.csv file on your computer.

4. Migration Procedure (Jira Cloud)

1. Install ActivityTimeline app in your Jira Cloud instance

2. Open ActivityTimeline app and open the Setup Wizard screen:

   1. select all migrated Jira DC Projects that should be managed in Jira Cloud instance

   2. click Proceed button to finish the Setup Wizard process (it could take some time)

   3. this will initialize a new ActivityTimeline Cloud app with the basic Jira’s migrated data

3. Open Jira Cloud → ActivityTimeline app → Configuration page

   1. click on the “Jira Integration” page and make sure all the necessary fields are mapped to the new Jira issue fields in Jira Cloud

   2. click “Update” button at the bottom

4. Open Jira Cloud → ActivityTimeline app → Configuration → Advanced Settings page:

   1. enter “IMPORT_EXPORT“ into the Custom Functionality field (separate by comma if you already have some values there)

   2. click “Update” button

5. Open the new “Data Export/Import“ item on the left of the Configuration page.

6. Click “Choose CSV File“ button and select instance-export-users.csv file that was obtained above (step 2. b. of 3. Preparation (Jira Cloud side) section above)

   1. click the “Validate & Preview” button

   2. if everything is OK then click the “Apply Mapping“ button

   3. this should associate Jira Cloud users to Jira DC users through the email address

7. Click “Choose ZIP File“ button and select the previously saved activitytimeline_export_<date>.zip file from Jira Data Center that was obtained above (section 2. Preparation (Jira DC side))

   1. click the “Validate File” button

   2. if everything is OK then click the “Import Data“ button

   3. the system should start the import process asynchronously,

   4. the page itself make time-out while continuing to import the data