upgrade_Backup
2.1 Stop users from updating JIRA data
During the upgrade process, you'll export JIRA's database from your existing JIRA installation (via an XML backup) and then restore this backup into a new JIRA installation. To ensure that the data in the XML backup is consistent with the latest data in the system, you must temporarily restrict access to JIRA so users can't update the data. Refer to the Preventing user access during XML database backups page for more information.
Be aware! Inconsistent XML backups cannot be restored!
2.2 Back up your database
Perform an XML backup of your existing JIRA installation's external database. For large JIRA installations, this process may require several hours to complete.
The 'embedded database' is the H2 database supplied with JIRA for evaluation purposes only. If you accidentally use the H2 database in a production system, perform an XML backup of this database and continue on with this procedure.
2.3 Back up your JIRA home directory
- Shut down JIRA.
- Locate the JIRA home directory. You can find information about the location of the directory by navigating to the
<jira-application-dir>/WEB-INF/classes/jira-application.propertiesfile in your Jira application installation directory. Alternatively, you can open the JIRA configuration tool to see the directory that is set as your JIRA Home. - Navigate to the directory specified in the configuration file and create a backup of it in another directory.
Delete the file <jira-home>/dbconfig.xml from the original folder as soon as the backup is complete.
2.4 Back up your attachments and index directories if located outside your JIRA home directory
If the attachments and index directories are located outside of your JIRA home directory, you must back them up separately. These pages describe how to find out where these directories are located in your implementation:
- Your attachments directory — Refer to Configuring file attachments page in the documentation for your version of JIRA.
- Your index directory — Refer to Search indexing page in the documentation for your version of JIRA.
Also refer to Backing up data for more information about backing up attachments in JIRA.
2.5 Back up your JIRA installation directory
The 'JIRA Installation Directory' is the directory into which the JIRA application files and libraries were extracted when JIRA was installed.