Cloud-to-Cloud Migrations: Tempo Products - Timesheets

This article is for Tempo for Cloud

Question	Can I migrate from one Cloud instance to another Cloud instance, or re-install a backup I have taken from my Cloud instance?
Answer	Tempo does not offer migrations between Tempo Cloud instances. Tempo stores its data in a database separate from Jira, so Tempo data does not follow when Jira is migrated. Atlassian's migration methods don't copy Marketplace app data either (see Atlassian's Cloud-to-Cloud migration guide). A backup and restore feature is on the roadmap, but there is no timeframe yet. Support can assist with specific issues that come up during a migration, but doesn't support the migration process itself. Options Tempo Platinum Partners: Some partners offer Cloud-to-Cloud migration services. See the Tempo Partner Directory. Adaptavist (ScriptRunner Connect): Adaptavist, a Tempo Partner, offers a tool that can migrate the data. Open a ticket on their Support Portal. Migrate manually with the APIs: Follow the steps below. Manual migration 1. Create entities on the destination first Create the following in this order, so worklogs can be linked to them on import: Teams Accounts Workload schemes Holiday schemes Work attributes Worklogs Plans 2. Handle user mapping If users have different email addresses on the destination, their Atlassian account IDs will differ. There is no automatic mapping. Replace the source account IDs with the destination account IDs in the exported data (worklog authors, team memberships, and so on) before importing. 3. Export, clean up and import worklogs Export Tempo worklogs from the source instance with the Tempo REST API. Tempo worklogs live in a separate database, and only limited, anonymized worklog data is synced back to Jira (Jira has no information about the worklog owner). The Tempo REST API is the only way to export worklogs with the real owner and description. Delete the migrated Jira worklogs on the destination with the Jira REST API. Jira worklogs are copied with the issues regardless of migration method, so skipping this step creates duplicates. Import the exported worklogs into the destination instance with the Tempo REST API, the Jira REST API, or Jira's native CSV import. Before you start Make sure Timesheets by Tempo is installed and has an active license on the destination site. Freezing time logging on the source during the move isn't required, but is recommended so the exported data stays consistent. Related links Tempo Cloud REST API Jira Cloud REST API Tempo Partner Directory

Question

Can I migrate from one Cloud instance to another Cloud instance, or re-install a backup I have taken from my Cloud instance?

Answer

Tempo does not offer migrations between Tempo Cloud instances. Tempo stores its data in a database separate from Jira, so Tempo data does not follow when Jira is migrated. Atlassian's migration methods don't copy Marketplace app data either (see Atlassian's Cloud-to-Cloud migration guide).

A backup and restore feature is on the roadmap, but there is no timeframe yet.

Support can assist with specific issues that come up during a migration, but doesn't support the migration process itself.

Options

Tempo Platinum Partners: Some partners offer Cloud-to-Cloud migration services. See the Tempo Partner Directory.
Adaptavist (ScriptRunner Connect): Adaptavist, a Tempo Partner, offers a tool that can migrate the data. Open a ticket on their Support Portal.
Migrate manually with the APIs: Follow the steps below.

Manual migration

1. Create entities on the destination first

Create the following in this order, so worklogs can be linked to them on import:

Teams
Accounts
Workload schemes
Holiday schemes
Work attributes
Worklogs
Plans

2. Handle user mapping

If users have different email addresses on the destination, their Atlassian account IDs will differ. There is no automatic mapping. Replace the source account IDs with the destination account IDs in the exported data (worklog authors, team memberships, and so on) before importing.

3. Export, clean up and import worklogs

Export Tempo worklogs from the source instance with the Tempo REST API. Tempo worklogs live in a separate database, and only limited, anonymized worklog data is synced back to Jira (Jira has no information about the worklog owner). The Tempo REST API is the only way to export worklogs with the real owner and description.
Delete the migrated Jira worklogs on the destination with the Jira REST API. Jira worklogs are copied with the issues regardless of migration method, so skipping this step creates duplicates.
Import the exported worklogs into the destination instance with the Tempo REST API, the Jira REST API, or Jira's native CSV import.

Before you start

Make sure Timesheets by Tempo is installed and has an active license on the destination site.
Freezing time logging on the source during the move isn't required, but is recommended so the exported data stays consistent.