Using the database integrity checker

Searching for common data inconsistencies, the Database Integrity Checker attempts to ensure that all Jira data is in a consistent state.

This is useful in a number of situations, e.g.

  • Before migrating a project to a new workflow
  • An external program is modifying Jira's database
  • Troubleshooting a server crash

If an error is encountered, most of the integrity checks provide a 'repair' option that attempts to reset the data to a stable state.

For all of the following procedures, you must be logged in as a user with the Jira System Administrators global permission.

Running the Integrity Checker over Load Balancer or Proxy URL can cause HTTP 504 Gateway Timeout error as it's a long-running process. To avoid timeout errors, we recommend you run the Integrity Checker over one of the Jira servers' IP and Port and select the options below one by one.

Using the Integrity Checker

  1. Choose > System
  2. Select System support > Integrity checker to open the Integrity Checker page.
    The integrity checker has a number of 'integrity checks' that look for common inconsistencies in Jira's stored data.
  3. Select one or more items whose data you would like to check the integrity of and click the 'Check' button.
  4. After the selected checks run, the preview screen will be shown.
    The screen provides details about the existing data inconsistencies. If any inconsistencies were found, the 'Fix' button will also appear on the page. The messages in red describe inconsistencies that the check will correct if it is chosen and the 'Fix' button is clicked. Messages that appear in yellow are warnings that the check will not correct; Jira will auto-recover from these inconsistencies when an action is taken on an issue.
    Select any inconsistencies that you would like to correct, then click the 'Fix' button.
    (info) Please Note: We strongly recommend taking a backup of your data before correcting any data inconsistencies.
  5. If any inconsistencies were found and you chose to correct them, you will be presented with a summary screen describing all the corrective actions that have taken place.
Last modified on Jul 14, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.