Startup check: Adding and removing JIRA system properties
プラットフォームについて: Server および Data Center のみ。この記事は、Server および Data Center プラットフォームのアトラシアン製品にのみ適用されます。
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Fisheye および Crucible は除く
This page describes how to set Java properties and options on startup for JIRA. This process should only be undertaken if you have a full understanding of the impact these system properties have on your JIRA instance. For this page, we'll use the hide.system.error.details
property as an example. When this property is set, it hides all details of configuration problems when you're attempting to start JIRA. If you're a JIRA administrator, you can still view more information on these configuration problems in the logs, but for anyone trying to access your instance, they'll simply see an error message. Removing the properties will expose the details of these configuration problems to anyone trying to access your instance.
We would like to encourage you to add the property XX:+IgnoreUnrecognizedVMOptions
on adding any properties to the startup. This will ensure that Jira won’t fail to start due to a bad parameter, as this allows to bypass any bad arguments being passed to Java.
Linux
<jira-install>/bin
から、setenv.sh を開きます。- JVM_SUPPORT_RECOMMENDED_ARGS= セクションを探します。
- Remove the
hide.system.error.details
property. - ファイルを保存します。
All parameters must be in a space-separated list, inside the quotations.
Windows (.batファイルから起動)
<jira-install>/bin
から、setenv.bat を開きます。- set JVM_SUPPORT_RECOMMENDED_ARGS= セクションを探します。
- Remove the
hide.system.error.details
property. - ファイルを保存します。
All parameters must be in a space-separated list, inside the quotations.
Windows サービス
There are two ways to configure system properties when running JIRA as a Windows service, either via command line or in the Windows registry.
Setting properties for Windows services via the 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
Start >> Run >> type in 'cmd' >> Enter
でコマンド ウィンドウを開きます。cd
to thebin
directory of your JIRA application installation directory.次のコマンドを実行します。
tomcat8w //ES//%SERVICENAME%
上記の例では、
tomcat8w //ES//JIRA231112155942
となります。Java
タブをクリックして、現在の起動オプションの一覧を表示します。- Remove or add options in the Java options section.
- [適用] をクリックします。
Windows サービスのプロパティを Windows レジストリで設定
Windows の一部のバージョンには、Java 変数をサービスに追加するオプションがありません。この場合、レジストリ内のオプション一覧を表示してプロパティを追加する必要があります。
Start >> 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
- 既存のプロパティを変更する (特に Xmx メモリを増やす) には、適切な値をダブルクリックします。
- 追加のプロパティを変更するには、オプションをダブルクリックします。
- Remove properties by deleting them, or enter properties on a separate line.
設定を確認する
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