Atlassian doesn't officially provide data rollback based on a customer requests. Thus, it's essential to take site-backup regularly. For example, the backup will help you when any of site data was lost by a user's operation. Backup for Jira allows you to take a snapshot of your entire Jira cloud site data to your own defined networked storage, according to your schedule and preferences, and restore the information a past backup onto your Jira cloud .
Prerequisites
In order to use the Backup for Jira Cloud app you need to prepare the following:
An Atlassian API token - this token is required in order to enable access to backup information.
A network connected FTP server that will be used to store that backup. The app support any of the protocols FTP, FTPS or Secure FTP. We recommend using a secure one. When you configure the app, you will also need to have the following information to tell the app where the storage is located.
URL
Port
Username
Password
Make sure that the storage folder your IT created for the backup is initially empty.
Installing the Backup 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 for Jira 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 JIRA BACKUP CENTER.
Select Configuration to setup the connectivity and storage parameters.
Backup Networking and Storage
In order to configure the backup network you need to set the following:
Atlassian Credentials
Atlassian API token - This token identifies your instance and allows the app to work securely. In order to get a token you can go to this Atlassian page. Make sure to keep your token stored securely.
Email address
Storage Service
You will need to ask your environment administrator to set a networked accessible FTP storage for you in order to store your backup files. Your application will need to have access to that storage with username and password. 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 serve to which the backup is delivered. You can use IP address of domain.
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 defined all parameters click Save. When the setup is successful, you should see a confirmation popup.
Creating Backup Schemes
Once the networking and storage is set, you can configure actual backups. On the left menu, under JIRA BACKUP CENTER, click Backup Schedules.
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.
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
Not enough storage existed for saving the backup file
48 hour limitation between Extended backups.
Question - when I define a link I get an error response starting with Failed to create directories for path.
Answer - the folder you are trying to use for the link cannot be created, possibly due to permission setup. Check with the IT person that installed your FTP server.