About the JIRA Configuration ToolThe JIRA Configuration Tool is an application (included with all JIRA distributions except JIRA WAR) that offers server-level JIRA configuration through a convenient GUI. This tool allows you to conveniently configure: Whenever you configure or reconfigure JIRA's server-level settings using this tool, JIRA must be restarted so it can recognise these changes.
|
Starting the JIRA Configuration Tool
To start the JIRA Configuration Tool:
- On Windows:
Open a command prompt and runconfig.batin thebinsubdirectory of the JIRA Installation Directory. - On Linux/Unix
Open a console and executeconfig.shin thebinsubdirectory of the JIRA Installation Directory.
JAVA_HOME environment variable to run the JIRA Configuration Tool. See Installing Java for details.Configuring the JIRA Home Directory
Your JIRA Home Directory allows you to set the folder that JIRA uses to store its various data files.
To set your JIRA Home Directory using the JIRA Configuration Tool:
- Click the JIRA Home tab.
- In the JIRA Home Directory field, type the full file path into the text field, or click the Browse button to browse for the location of your JIRA Home Directory.

Upon clicking the 'Save' button, your changes are saved to the jira-application.propertiesfile located in the<jira-application-dir>subdirectory of your JIRA Installation Directory.
For more information, please see Setting your JIRA Home Directory.
Configuring the database connection
To configure JIRA's database connection using the JIRA Configuration Tool, follow the appropriate procedure for your database type:
- Connecting JIRA to PostgreSQL
- Connecting JIRA to MySQL
- Connecting JIRA to Oracle
- Connecting JIRA to SQL Server 2005
- Connecting JIRA to SQL Server 2008
- Connecting JIRA to HSQLDB

When clicking the Test Connection button, the following message box will appear:

(Connection successful will appear if JIRA connected to your database successfully.)
Configuring JIRA's TCP ports
JIRA runs on TCP listening (HTTP) port 8080 and shutdown (Control) port 8005 by default. However, you can change these ports if they are already being used by an existing service running on the same machine.
To change JIRA's TCP ports using the JIRA Configuration Tool:
- Click the Web Server tab.
- In the HTTP Port field, enter the new TCP listening port number.
- In the Control Port field, enter the new TCP shutdown port number.

Upon clicking the Save button, your changes are saved to the server.xmlfile located in theconfsubdirectory of your JIRA Installation Directory.
For more information, please see Changing JIRA's TCP Ports.
Tuning JIRA's database connections
For more information about the functionality of the Advanced tab, see Tuning Database Connections.
Saving your settings
Click the Save button when you are done. This saves all configuration changes made in all tabs of the JIRA Configuration Tool.
JIRA must be restarted for your new settings to take effect.