Restoring information from a native backup
Before you begin
Make sure that you have the password to a login in the backup file that has the Jira System Administrator global permission. Once the restoring procedure begins, all the existing data in the Jira application database is deleted, including all user accounts. |
If you are restoring data from a Jira Cloud application site to a Jira Data Center application, please read Migrating from Jira Cloud to Jira Data Center applications. |
For all of the following procedures, you must be logged in with Jira Administrators global permission. |
1. Disable email sending/receiving
If you are restoring production data into a test Jira instance for experimentation purposes, you have to disable all Jira application's email features before you begin:
- Disable email notifications — if Jira is configured to send emails about changes to issues, and you want to make test modifications to the copy, you should start Jira with the
-Datlassian.mail.senddisabled=true
flag. - Disable POP/IMAP email polling — if Jira is configured to poll a mailbox (to create issues from mails), you will have to disable polling on your test installation by setting the
-Datlassian.mail.fetchdisabled=true
flag.
Exactly how to set these flags is dependent on your particular application server, but for Jira, this is done by setting the DISABLE_NOTIFICATIONS
environment variable before starting Jira (note, use startup.sh
instead of startup.bat
if you are not using Windows):
set DISABLE_NOTIFICATIONS= " -Datlassian.mail.senddisabled=true -Datlassian.mail.fetchdisabled=true -Datlassian.mail.popdisabled=true" cd bin startup.bat |
You could also try un-commenting the DISABLE_NOTIFICATIONS=" -Datlassian.mail.senddisabled=true -Datlassian.mail.fetchdisabled=true -Datlassian.mail.popdisabled=true"
line from your /bin/setenv.bat
file (/bin/setenv.sh
if you are not using Windows) and then running startup.
- Stop Jira
- Replace the Jira Home directory with the backed up files.
Re-apply any changes made in the Jira Install directory
Note
This step is required only if something has changed since the backup, it shouldn't contain any actual data.
- Restore the database using native database tools (again this depends on the specific database type)
- Start Jira