Configuring the JIRA HOME over an UNC path

Still need help?

The Atlassian Community is here for you.

Ask the community

Scenario 1

Sometimes there is a need to set up the JIRA Home directory over a remote server. This KB addresses this configuration on a Windows Server environment. This same configuration does not apply to set up JIRA Home directory on a UNIX (or Linux) operational system.

This configuration may cause you performance problems (please check this page for any further information).

Scenario 2

If you are seeing the following exception in JIRA log when trying to configure shared home directory for JIRA Data Center, please proceed to resolution 2:

JIRA has no permission to either create or write to subdirectory 'data' of jira.home 'x:\path\to\sharedhome'.

Resolution 1

  1. Open the jira-application.properties file on a text editor (such as notepad);
  2. Set the path for the home directory as the following example:

    jira.home = \\\\<your-servername>\\<your-share>\\<jira-home> 

    (info) You may also set the same parameter on the config.bat script.
    (info) Hence, you must have access and write permissions on the target Windows share.

Resolution 2

  1. Open the cluster.properties file on a text editor.
  2. Set the path for the home directory as the following example:

    jira.shared.home = \\\\133\\jira

    (info) Must have access and write permissions on the target Windows share.

Last modified on Nov 2, 2018

Was this helpful?

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