This page last changed on May 28, 2009 by alui.

On this page:

JIRA Installation Directory

The 'JIRA installation directory' is the directory into which the JIRA application files and libraries have been unpacked (unzipped) when JIRA was installed. JIRA does not modify or store any data in this directory.

Important Files and Directories

atlassian-jira/WEB-INF/classes/jira-application.properties

This file tells JIRA where to find the JIRA Home Directory, as well as storing many other configuration settings . This file is modified by the administrator when Installing JIRA Standalone (not using Windows installer) or Installing JIRA WAR-EAR.

atlassian-jira/WEB-INF/classes/osuser.xml

This file is modified when connecting JIRA to an external user management system such as an LDAP server or Atlassian's Crowd. For more information, refer to User and Group Management.

atlassian-jira/WEB-INF/lib/

This is the directory where plugins built on Atlassian's Plugin Framework 1 (i.e. 'Plugins 1' plugins) are stored. If you are installing a new 'Plugins 1' plugin, you will need to deploy it into this directory.
'Plugins 2' plugins should be stored in the JIRA Home Directory.

atlassian-jira/WEB-INF/classes/log4j.properties

JIRA's logging configuration file. See Logging and Profiling.

The actual log files generated by JIRA can be found in the following locations:

  • JIRA application logbin/atlassian-jira.log
  • Application server log — generally the application server log file can be found under the logs directory. However, this can vary depending on the application server you are running. Please see Where are the JIRA logs? for further details.

conf/server.xml

This file is used for JIRA SSL configuration. See Running JIRA over SSL or HTTPS.

Memory Settings

The file used to edit JAVA_OPTS memory settings will depend on the method used to install JIRA, as well as the operating system used for your installation.

For example, if you are running JIRA on Tomcat in Windows (manual startup), you would update the following file:
bin\setenv.bat
whereas for JIRA on Tomcat in Unix, you would update this file:
bin/setenv.sh

See Increasing JIRA Memory for further details.

JIRA Home Directory

The 'JIRA home directory' contains key data that help define how JIRA works. This document outlines the purpose of the various files and directories in the JIRA home directory. (For information on specifying the location of the JIRA home directory, please see Setting your JIRA Home Directory .)

Tip: Another term for 'home directory' would be 'data directory'.

Important Directories

data

This directory contains application data for your JIRA instance, including:

export

JIRA will place its automated backup archives in this directory. Note, your JIRA administrator can define a custom backups directory.

This does not affect manually generated backups, i.e. you must specify the target location for a manually generated backup.

plugins

This is the directory where plugins built on Atlassian's Plugin Framework 2 (i.e. 'Plugins 2' plugins) are stored. If you are installing a new 'Plugins 2' plugin, you will need to deploy it into this directory under the installed-plugins sub-directory.

'Plugins 1' plugins should be stored in the JIRA Installation Directory.

This directory is created on JIRA startup, if it does not exist already.

caches

This is where JIRA stores caches including:

These files are vital for JIRA performance and should not be modified or removed externally while JIRA is running.

Note: If you are running a high load JIRA instance, you may wish to consider moving your indexes from the default directory under JIRA home to another machine. The directory which holds your indexes is heavily accessed while JIRA is running. Hence, your JIRA instance may run more efficiently by hosting the indexes on the fastest disk available and reducing the number of other applications using the same disk to reduce access contention.

See Search Indexing for further details.

tmp

Any temporary content created for various runtime functions such as exporting, importing, file upload and indexing is stored under this directory.

You can remove files from this directory while JIRA is running, but we recommend that you shut down JIRA first before altering the contents of this directory.

Document generated by Confluence on Oct 06, 2009 00:26