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 which attempts to reset the data to a stable state.

Using the Integrity Checker

  1. Log in as a user with the 'JIRA System Administrators' global permission.
  2. Select 'Administration' > 'System' > 'Troubleshooting and Support' > 'Integrity Checker' (tab) to open the 'Integrity Checker' page.
    (tick) Keyboard shortcut: 'g' + 'g' + type 'integ'
    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.