Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Backup Center is your loyal tool for your saving Jira cloud site historical snapshot automatically. Atlassian doesn't officially provide data rollback based on a customer request. Thus, it's essential to take your site backup regularly. For example, backup Backup Center will help you when any of site data was lost by a user operation. Backup Center allows you to automatically take periodic snapshots of your entire Jira cloud site data. You can save the backup files to our storage, or to your own to your own FTP networked storage, according to your schedule and preferences. The saved backup files can be used at any time to restore the information of past snapshot onto your Jira cloud site.

Table of Contents

Installing the Backup Center App

To install the app go to as an Admin to settings and click Apps (on the left menu) and then Manage Apps.

...

Search for Backup Center app and install it.

Once the installation is complete, or whenever you select the installed app from the list going forward, you can reach the app configuration menu on the left, under BACKUP CENTER.

...

Configure your backup

From the Apps menu, select Configuration to setup the connectivity and storage parameters.

Setting Atlassian credentials

In order to use the Backup for Jira Cloud app you need to enter an Atlassian API token - this token is required in order to enable the app access to backup functionality. To obtain a token, go to the Atlassian website page - HERE.

Click the button Create API token. In the popup that appears enter a name for your token.

...

When you click Create, you should have access to your token.

...

Click Copy to copy the token string to your clipboard. Then, paste it in the app configuration Atlassian API Token field. If at any point in the future you want to change the token, you can create a new one and use it. Always make sure you keep your key securely.

Essentially, you can now click the button Save and this is all that you need to you to get the app to start creating basic backup snapshots and keep the 10 most recent ones. The rest of the configuration steps allows you to tailor your backup in more details to your needs.

Atlassian credentials

...

In the Email address field, enter your Jira user email address.

Backup schedule

The Backup Center app supports two types of backup snapshots. The Basic type includes all the site projects and issue data, without images and attachments. The Extended type includes images and attachments. Naturally, the extended backup file size is significantly larger than the basic one. In addition Jira prevents creating an extended backup if any other backup was performed in the preceding 48 hours. The app supports saving basic, extended, or a combination of two, with a timing schema that supports the extended backup constraints.

If you choose the Basic backup, it will be triggered daily. Extended backup will be triggered three times a week. The Combined schema will create basic backups with a once a week extended one.

Backup time: You can choose the time of day in which the backup is running, with default value of midnight (the exact running times may vary slightly). The time zone of this field is taken as the setup in your Jira site.

Number of backup files to keep: this is the maximum number of files that will be saved in the storage. The default value is 10. Once this number is reached, files are being rotated, where the oldest file is removed whenever a new one is created.

Storage configuration

The default Managed storage space for the backup was created for you by the app. This cloud storage keeps your most recent backup snapshot files, up to the number of files that you configured, or up to the storage quota allocated for you. Currently the storage quota is 20GB. Note that this quota may be reached eventually if you specify a very large number of backup files to preserve. If you reached the quota you can reach Addon Experts Center for a paid increase of storage. Also note that you can download backup files from the storage and delete them as you wish.

Alternatively you can use your own, network connected, FTP storage server to store your backup files. We support the FTP, FTPS and SFTP protocols. To use such a configuration make sure you have a server ready, and get the following parameters that are necessary to define the secure access and communication method. Once you have the information about that storage, enter the information bellow.

  • Protocol Type: the backup can use FTP, FTPS or Secure FTP.

  • Storage target: the server to which the backup is delivered. You can use an IP address or a domain name.

  • Storage port: the network port that the backup is using. Default is the standard port 21 for FTP.

  • Storage username and password: your FTP server credentials.

Once you completed configuring your backup, snapshots should be created automatically and saved in storage.

Managing your backup files

To manage your backup files, on the left menu, under JIRA BACKUP CENTER, click Control panel.

To define a new scheme, click on the “+” button in your app page.

...

In the popup Schedule backup, you can set the following:

Backup name:

Backup type: You can select two type of backup: Basic and Extended. Basic backup includes the following: Extended backup includes the Basic and in addition attachments, avatar images and logos.

Days of the week: You can select the one or more day of the week, the time of the day the backup is trigger.

You can also select the number of backup files to keep

Storage link - this is the folder where your backup is kept. Typically, your IT will configure a folder for the FTP server storage. The best practice would be to specify a folder that will be relative to this “FTP root” folder, such as “my_backups". Note: is you use a folder starting with “/”, the system interprets is as a Unix root based folder, which may or may not be setup by your IT as accessible.

When you click Save, a confirmation popup is displayed.

...

Your scheme now appears as a line at the top of the page.

...

You can go ahead and create additional schemes. You can also edit each scheme by clicking the pencil icon.

(explain Status)

Note that If you want, instead of waiting to a scheduled backup, you an perform an immediate backup by clicking Backup now at the right of the scheme line. The actual backup may take several minutes. The latest successful backup date always appear in the scheme line.

...

Managing Backup Files

All backup files, from all the scheme are listed, with their name, extended with date and time, and size. You can delete a file by clicking the X button, and confirming the delete warning. Note that a deleted backup file is not recoverable. Remember as well that older backup file will be deleted automatically in a rolling fashion, based on your specifying how many old files to keep.

...

Image Removed

Restoring Backup Files

The backup restore is done through the existing Jira clout Import mechanisms, as described here. Once you decided on the backup file to be imported, follow those Atlassian instructions carefully.

NOTE THAT A RESTORE IS GOING TO OVERWRITE YOUR EXISTING SITE DATA. MAKE SURE YOU UNDERSTAND AND FOLLOW THE INSTRUCTION CAREFULLY.

A good practice before an import attempt it to backup your Jira cloud site information before the import. It is also best to import the information to a secondary cloud instance. Importing to this “staging” site first will help you ensure that the restore is working well, as well as verify that the data you imported includes what you expected.

When you restore a Basic Backup, you will need to click Import Data and select the file from your local storage.

The file will then upload into Jira (you should see a progress bar) and will get processed. If everything is correct you should be redirected to a new page, with a confirmation

We've checked your file for issues, and everything looks good.

A click on Run Import will open a Running Import screen. You should then see an import progress status step after step

...

When done, you should get an Import complete confirmation

Your data file was successfully imported to Jira Cloud.

Follow Atlassian's verification instructions in that page, to ensure the health of your updated site.

Add extended backup

Troubleshooting

Question -I got an ERROR indicator in my backup. What should I do?

Answer - Backups may fail due to one of the following:

...

Connection to storage failed

...

The app has the following features:

  • Periodical backup of your Jira site on storage ready for you

  • Set the properties and timing of the backup

  • Project are saved as well as Assets

  • Ability to use your on storage on FTP/S server, MS SharePoint or AWS S3

  • Download backup files to your on device

  • Restore specific projects and/or issues that you choose from any saved backup

  • Restore Assets.

How does Backup Center work?

  • In a configuration page you set the backup configuration, times, the number of files to keep, and which storage to use. You have free 20GB of free space, or if you prepare your own set S3 or SharePoint

  • Project information as well as assets are saved

  • Backup will now commence automatically

  • A control panel shows you your backup schedule, status and existing backup snapshots.

  • You can view your backup files, download them or select the one to restore.

...

Table of content of this guide:

Child pages (Children Display)