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

Skip to end of metadata
Go to start of metadata

If your JIRA home directory becomes locked, your JIRA instance will be prevented from running.

Your JIRA home directory can become locked if:

  • You accidentally configure two JIRA instances to use the same directory
  • Your JIRA instance terminates abnormally and fails to unlock the JIRA home directory
  • You receive a JIRALockedError.

To unlock your JIRA home directory, follow the instructions below:

  1. Verify that no running JIRA instances are configured to use the specified JIRA home. If there are running JIRA instances that are configured to use the specified JIRA home, shut them down and change the JIRA home directory to a different location.
  2. Remove the file .jira-home.lock. This file is located in your JIRA home directory. To enable the viewing of Hidden files follow these steps:
  • Windows XP, Windows 2003, other Windows pre-7:
    1. Minimize all programs so that you are at your desktop.
    2. Double-click on the My Computer icon.
    3. Select the 'Tools' menu and click 'Folder Options'.
    4. After the new window appears select the 'View' tab.
    5. Put a checkmark in the checkbox labelled 'Display the contents of system folders'.
    6. Under the 'Hidden files and folders' section select the radio button labelled 'Show hidden files and folders'.
    7. Remove the checkmark from the checkbox labelled 'Hide protected operating system files'.
    8. Press the 'Apply' button and then the 'OK' button and shutdown My Computer.
    9. Now your computer is configured to show all hidden files.
  • Windows 7:
    1. Close all programs so that you are at your desktop.
    2. Select 'Control Panel' >> 'Appearance and Personalization' >> 'Folder Options' >> 'Show Hidden Files and Folders'.
    3. Press the 'Apply' button and then the 'OK' button.
    4. Now your computer is configured to show all hidden files.
  • Linux:
    1. CD to the JIRA Home directory
    2. Run ls -al
    3. Run rm .jira-home.lock
  • Mac:
    1. Open a Terminal window. The Terminal application can be found an Applications >> Utilities.
    2. CD to the JIRA Home directory.
    3. Run rm .jira-home.lock

When you're finished, restart JIRA.

  • No labels