For any applications running in a production environment, it is critical that their data is backed up regularly, so that they can be restored in case of a disaster.
The first thing you will need is to have a disaster recovery plan in place. This plan should outline the details of the strategy in place to back up JIRA's data and where the backups should be stored, and the recovery process of restoring the data. In context of JIRA, there are typically two items you will need to backup:
mysqldump
for MySQL).JIRA also comes with an XML
backup/restore feature, which will back up the data from the database into an XML file. This utility, however, is not designed to be used for large JIRA instances (for example, with 200,000 issues or more). It is important to note that data kept in JIRA_HOME
is not backed up.
JIRA comes with a simple backup utility that lets you backup your data into an XML file, which can be later imported back in to restore JIRA. However, you must keep in mind that you should not rely on this utility as your sole backup strategy, as this option has several limitations:
Nonetheless, this can still be very handy when you need a quick way to perform a one-off backup before you make some system-wide changes such as an upgrade, or you need to copy data from one JIRA to another. Perform the following steps to create an XML backup:
Depending upon the size of your JIRA, the backup process will take some time to complete. Once the backup process completes, JIRA will display the confirmation page with the full path to the exported XML file. If your JIRA has too much data, the backup will fail with an error. If this occurs, you will have to back up your data using your database backup tools.
Once you have generated an XML backup, you can use that to restore your JIRA by importing it back in. Please note that when you perform a restore, the existing data will be completely wiped, including your JIRA license information, which will also be restored from the XML backup:
JIRA_HOME/import
directory.Since attachments are not a part of the XML backup, the restore process will not restore the attachments, however, if you are restoring a backup from the same instance, attachments will be automatically located. While JIRA is in the process of restoring from a backup, users will not be able to access JIRA.
You can only restore an export from the same or an older version of JIRA. For example, you cannot restore an export from JIRA 5.2 into JIRA 5.1.