We’re renaming ‘products’ to ‘apps’

Atlassian 'products’ are now ‘apps’. You may see both terms used across our documentation as we roll out this terminology change. Here’s why we’re making this change

Manage backup and restore with sharding

We’re rolling out a new backup and restore experience for a limited number of customers on the Enterprise plan through a beta program.

Backup and restore isn’t available in the Atlassian Government environment.

 

When you provision an Atlassian app, we distribute the product’s data across a set of partitions or shards. This results in improved performance because we split the data into smaller, easier-to-manage pieces and store them in multiple shards. Each shard has only a part of the data, so when you look for something, you only have to search through a smaller amount of information, making it quicker to find what you need.

How do we back up and restore with shards

When you backup an app, we store the backup file in a shard within a region. We can restore the backup to a product instance that is stored in the same shard within the same region. We don’t support cross-shard backup and restore.

If the backup file and the app instance to which you’re restoring are in two different shards, you need to move the product instance to the same shard as the backup file. Moving this data may take up to 30 minutes, but it won’t affect your data or compliance.

To restore data to an app instance on the same shard as the backup:

  1. Go to admin.atlassian.com. Select your organization if you have more than one.

  2. Select Settings > Backup and restore.

  3. From the Restore tab, select the app you want to restore, then select Next.

  4. Select the specific backup you want to restore from the list of available backups for the app. If no backups are available, create a backup policy and run a backup.

  5. Review your backup. If the backup includes attachments, select whether you want to restore them, then select Next.

  6. Select where to restore the app data. If you don’t see any products, it’s because of two reasons:

    • You can only restore a backup into an app that doesn’t contain any data. Select the Contain data filter and select No.

    • We can restore data to a product that’s on the same shard as the backed-up app. This means that if the backup file and the product to which you’re restoring your data are in different shards, we’ll move the product to the shard where the backup exists. This is an additional step and the data move may take around 30 minutes. You can select and unselect the Show apps in the backup’s shard checkbox to see apps that are in the same or different shards.

  7. If there are no apps in the same shard as the backup but you still want to restore, select Next to proceed to the next step.

  8. Validate data by checking if there could be potential problems before and after you restore. Resolve any problems.

  9. Review the data to restore, then select Restore. Once the restore starts running, it’s added to the Restore table.

Still need help?

The Atlassian Community is here for you.