Setting Properties and Options on Startup
On this page:
Linux
To Configure System Properties in Linux Installations,
- From
<jira-install>/bin
(or<Tomcat-home>/bin
for JIRA WAR installations), open setenv.sh. - Find the section JVM_SUPPORT_RECOMMENDED_ARGS=
- Refer to the list of parameters below.
Add all parameters in a space-separated list, inside the quotations.
Windows (starting from .bat file)
To Configure System Properties in Windows Installations When Starting from the .bat File,
- From
<jira-install>/bin
(or<Tomcat-home>/bin
for JIRA WAR installations), open setenv.bat. - Find the section set JVM_SUPPORT_RECOMMENDED_ARGS=
- Refer to the list of parameters below.
Add all parameters in a space-separated list, inside the quotations.
Windows Service
There are two ways to configure system properties when starting Running JIRA as a Service, either via command line or in the Windows Registry
Setting Properties for Windows Services via Command Line
Setting Properties for Windows Services via Command Line
- Identify the name of the service that JIRA is installed as in Windows (
Control Panel > Administrative Tools > Services
):
In the above example, the SERVICENAME is:JIRA231112155942
- Open the command window from
Start >> Run >> type in 'cmd' >> Enter
cd
to thebin
directory of your JIRA Installation Directory (or thebin
directory of your Tomcat installation if your are running JIRA WAR).Run:
tomcat7w //ES//%SERVICENAME%
In the above example, it would be
tomcat7w //ES//JIRA231112155942
- Click on the
Java
tab to see the list of current start-up options: - Append any new option on its own new line by adding to the end of the existing Java Options. Refer to the list of parameters below.
Setting Properties for Windows Services via the Windows Registry
In some versions of Windows, there is no option to add Java variables to the service. In these cases, you must add the properties by viewing the option list in the registry.
To Set Properties for Windows Services via the Windows Registry,
- Go to
Start >> Run
, and run "regedit32.exe".
- Find the Services entry:
32-bit:HKEY_LOCAL_MACHINE >> SOFTWARE >> Apache Software Foundation >> Procrun 2.0 >> JIRA
64-bit:HKEY_LOCAL_MACHINE >> SOFTWARE >> Wow6432Node >> Apache Software Foundation >> Procrun 2.0 >> JIRA
- To change existing properties, especially increasing Xmx memory, double-click the appropriate value.
- To change additional properties, double-click options.
- Refer to the list of parameters below. Enter each on a separate line.
Verifying Your Settings
To verify what settings are in place, check the <jira-home>/logs/atlassian-jira.log
or catalina.out
file. A section in the startup appears like this:
JVM Input Arguments : -Djava.util.logging.config.file=/usr/local/jira/conf/logging.properties -XX:MaxPermSize=256m -Xms256m -Xmx384m -Djava.awt.headless=true -Datlassian.standalone=JIRA -Dorg.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER=true -Dmail.mime.decodeparameters=true -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Djava.endorsed.dirs=/usr/local/jira/endorsed -Dcatalina.base=/usr/local/jira -Dcatalina.home=/usr/local/jira -Djava.io.tmpdir=/usr/local/jira/temp
This display is also available by Viewing your System Information.
List of Startup Parameters
Memory Property | Notes | Related Pages |
---|---|---|
-Xmx | These properties are pre-existing. See related pages for instructions. | |
-XX:+PrintGCTimeStamps -verbose:gc -Xloggc:gc.log -XX:+HeapDumpOnOutOfMemoryError | Set these for Garbage Collection tuning. | Troubleshoot Jira Server performance with GC logs |
-agentlib:yjpagent=onexit=memory,dir=/path/to/write/snapshots |
| |
Mail Property | Notes | Related Pages |
-Datlassian.mail.senddisabled | Set to 'true' to disable mail. In Linux setenv.sh, there is a pre-existing flag to uncomment. | Migrating JIRA to Another Server |
-Dmail.debug | If set to "true", logs statements related to mail | Configuring JIRA's SMTP Mail Server to Send Notifications |
-Dmail.mime.decodetext.strict |
| Unable to Decode Mail Subject or Body when Creating Issue From Email |
-Dmail.imap.auth.plain.disable |
| IMAP setup fails with AUTHENTICATE Failed error in logs in Jira server when using OAuth |
-Dmail.imap.starttls.enable |
| 'javax.mail.MessagingException No login methods supported' Due to IMAP over SSL |
-Dmail.mime.decodeparameters | Sets mail handler to work correctly with emails from RFC 2231-compliant mail clients. | |
-Dmail.smtp.localhost |
| Problems Sending Email from JIRA - EHLO requires domain address |
Encoding Property | Notes | Related Pages |
-Dfile.encoding | Set to utf-8 for encoding consistency | Integrating JIRA with CVS and ViewCVS |
Other Properties | Notes | Related Pages |
-Duser.timezone |
| |
-Dsvnkit.http.methods | Values include Basic,Digest,Negotiate,NTLM | JIRA Startup Fails Due to 'java.lang.SecurityException Unable to locate a login configuration' |
-Dorg.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER | true | |
-ea/-da | Enable/Disable assertions | |
-Djava.net.preferIPv4Stack |
| SocketException to Announce 'Invalid argument' for an Available Port |
-Djavax.net.ssl.trustStore |
| Connecting to SSL services |
-Djava.awt.headless | Ships with true by default. Allows thumbnail generation. |
|
-Dhttp.proxyHost -Dhttp.proxyPort -Dhttps.proxyHost -Dhttps.proxyPort | Outbound Proxy Server hostname and port | Configure an outbound proxy for use in Jira server |
-Dorg.apache.catalina.SESSION_COOKIE_NAME | Logging into another Atlassian application logs me out of Confluence | |
-Datlassian.plugins.enable.wait | Time JIRA waits for plugins to load. | Bundled plugin not available error thrown on Jira server login |