Documentation for JIRA 5.2. Documentation for other versions of JIRA is available too.

For production use, it is strongly recommended that for regular backups, you use native database backup tools instead of JIRA's XML backup service.

When JIRA is in use, XML backups are not guaranteed to be consistent as the database may be updated during the backup process. JIRA does not report any warnings or error messages when an XML backup is generated with inconsistencies and such XML backups will fail during the restore process. Native database backup tools offer a much more consistent and reliable means of storing (and restoring) data.

If you perform an XML backup (e.g. when upgrading JIRA via a test environment or migrating JIRA to another server), you can follow one of these methods to prevent users from accessing JIRA and minimise inconsistencies in the backup file:

  • 推奨方法
    • If you have an Apache or other web/proxy server sitting in front of JIRA, then you can stop Apache from proxying to JIRA, and serve a static HTML page with a nice message along the lines of "JIRA is undergoing maintenance". Note:
      • The administrator must be able to access JIRA directly (not through Apache) to perform the XML backup.
      • This method does not require JIRA to be restarted.
  • 代替方法 1 ：

    1. Shut down JIRA, configure it to listen on a different port and restart. Do this by editing the server.xml file (or the jira.xml file in your Apache Tomcat installation running JIRA WAR). Change the following section:

            <Connector port="8080"
maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" useBodyEncodingForURI="true"
enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" />
      • 注意: HTTPS を有効にしている場合、HTTPS Connector セクションも同じように編集する必要があります。
    2. Restart JIRA and do the XML backup.
    3. Shut down JIRA, change all the settings back, then re-start JIRA.
  • 代替方法 2 ：
    • If you have a firewall in front of JIRA, you could stop requests from getting through or change the port number that it uses. Note:
      • The administrator will need to log in to JIRA on the temporary port number (or access it from behind the firewall), to perform the XML backup.
      • This method does not require JIRA to be restarted.

はじめる前に：

Whichever method you choose, we recommend setting an Announcement Banner to warn your users that JIRA will be unavailable for a period of time.

1 Comment

  1. Demetri Mouratis

    Mar 21, 2013

    Provide more details around Alternative method 3.  For example, with a Postgres DB:

     

     sudo su - postgres

     psql jiradb

     REVOKE INSERT, DELETE, UPDATE on project,jiraaction,jiraissue from jira;



See our Getting Help page for details.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.