How do I unlock my JIRA home directory?

Your JIRA home directory can become locked if you accidentally configure two JIRA instances to use the same directory or your JIRA instance terminates abnormally and fails to unlock the JIRA home directory. This will prevent your JIRA instance from running.

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. Close 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.
• Mac/Linux:
  1. CD to the JIRA Home directory and run: ls -al

When you're finished, restart JIRA.