起動時のプロパティとオプションの設定
Linux
Linux インストールでシステム プロパティを設定する方法
<jira-install>/bin
から、setenv.sh を開きます。- JVM_SUPPORT_RECOMMENDED_ARGS= セクションを探します。
- 以下のパラメータ一覧を参照してください。
引用内部では、各パラメーターをスペース区切りのリスト形式で追加します。
Windows (.batファイルから起動)
Windowsインストールで .bat ファイルから起動する際にシステム プロパティを設定する方法
<jira-install>/bin
から、setenv.bat を開きます。- set JVM_SUPPORT_RECOMMENDED_ARGS= セクションを探します。
- 以下のパラメータ一覧を参照してください。
引用内部では、各パラメーターをスペース区切りのリスト形式で追加します。
Windows サービス
Jira を Windows サービスとして起動している状態でシステム プロパティを設定するには、コマンド ラインで変更する方法と Windows レジストリで変更する方法の 2 つがあります。
Windows サービスのプロパティをコマンド ラインから設定
Windows サービスのプロパティをコマンド ラインから設定する
- 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
でコマンド ウィンドウを開きます。- Jira アプリケーションのインストール ディレクトリの
bin
ディレクトリに移動 (cd
) します。 次のコマンドを実行します。
tomcat8w //ES//%SERVICENAME%
In the above example, it would be
tomcat8w //ES//JIRA231112155942
Java
タブをクリックして、現在の起動オプションの一覧を表示します。- 新しいオプションを追加する場合は、既存の Java オプションの最後に新しい行として追加します。下記のパラメーター一覧を参照してください。
Windows サービスのプロパティを Windows レジストリで設定
Windows の一部のバージョンには、Java 変数をサービスに追加するオプションがありません。この場合、レジストリ内のオプション一覧を表示してプロパティを追加する必要があります。
Windows サービスのプロパティを Windows レジストリで設定する方法
Start >> Run
に移動し、"regedit32.exe" を実行します。
- サービス エントリを見つけます:
32 ビット:HKEY_LOCAL_MACHINE >> SOFTWARE >> Apache Software Foundation >> Procrun 2.0 >> JIRA
64 ビット:HKEY_LOCAL_MACHINE >> SOFTWARE >> Wow6432Node >> Apache Software Foundation >> Procrun 2.0 >> JIRA
- 既存のプロパティを変更する (特に Xmx メモリを増やす) には、適切な値をダブルクリックします。
- 追加のプロパティを変更するには、オプションをダブルクリックします。
- 下記のパラメーター一覧を参照してください。 1 行に 1 つずつ入力します。
設定を確認する
設定した内容を確認するには、<jira-home>/logs/atlassian-jira.log
または catalina.out
ファイルを確認します。起動部分のセクションは次のようになっています。
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
これは、システム情報を表示することでも確認できます。
起動パラメーターの一覧
メモリ プロパティ | 注意 | 関連ページ |
---|---|---|
-Xmx | これらのプロパティはすでに存在します。詳しくは関連ページを参照してください。 | |
-XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+PrintGCCause -Xloggc:C:\Program Files\Atlassian\Application Data\JIRA\log\atlassian-jira-gc-%t.log -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=20M | これらのプロパティはすでに存在し、ガベージ コレクションのチューニングで使用されます。 | ガベージ コレクションのログを使用して Jira アプリケーションのパフォーマンスを分析する |
-agentlib:yjpagent=onexit=memory,dir=/path/to/write/snapshots | ||
-XX:InitialCodeCacheSize=32m -XX:ReservedCodeCacheSize=512m | これらのプロパティはすでに存在し、JVM コード キャッシュのサイズを設定するのに使用されます。予約サイズの値を大きくすると、Jira はインストール済みアプリをさらに多く読み込むことができます。 ほとんどの Jira インスタンスでは既定設定が最適な構成になっており、コード キャッシュがフル状態になることに起因する問題は解決されます。 | KB 記事: CodeCache による Jira クラッシュ |
メール プロパティ | 注意 | 関連ページ |
-Datlassian.mail.senddisabled | メールを無効にするには "true" に設定します。Linux の setenv.sh には、コメントを解除するためのフラグが存在します。 | Jira を別のサーバーに移行すると |
-Dmail.debug | "true" に設定すると、メールに関する情報がログに記述されます。 | |
-Dmail.mime.decodetext.strict | ||
-Dmail.imap.auth.plain.disable | OAuth を使用する際に、Jira Server のログで IMAP セットアップが AUTHENTICATE Failed エラーで失敗する | |
-Dmail.imap.starttls.enable | "No login methods supported error" により、Jira サーバーで IMAP サーバーからメッセージを取得できない | |
-Dmail.mime.decodeparameters | RFC 2231 準拠のメール クライアントからのメールに対して適切に動作するようにメール ハンドラを設定します。 | |
-Dmail.smtp.localhost | ||
エンコーディング プロパティ | 注意 | 関連ページ |
-Dfile.encoding -Dsun.jnu.encoding | エンコーディングの一貫性のため、utf-8 に設定します。 | ASCII サポート外の文字がクエスチョン マークで表示される |
その他のプロパティ | 注意 | 関連ページ |
-Duser.timezone | ||
-Dsvnkit.http.methods | 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 | アサーションを有効化 / 無効化 | |
-Djava.net.preferIPv4Stack | ||
-Djavax.net.ssl.trustStore | SSL 経由の SMTP サーバーで "javax.net.ssl.SSLException" によりメールを送信できない | |
-Djava.awt.headless | デフォルトで true。サムネイルの生成を許可します | |
-Dhttp.proxyHost -Dhttp.proxyPort -Dhttps.proxyHost -Dhttps.proxyPort | アウトバウンド プロキシ サーバ のホスト名とポート | Jira アプリケーションにアウトバウンド HTTP / HTTPS プロキシを構成する方法 |
-Dorg.apache.catalina.SESSION_COOKIE_NAME | 別のアトラシアン アプリケーションにログインすると Confluence からログアウトされる | |
-Datlassian.plugins.enable.wait | Jira がアプリのロードを待機する時間です。 | プラグインの有効化の待機中に Jira システム プラグインのタイムアウトが発生 |
-Datlassian.plugins.startup.options="--disable-all-addons--disable-addons=com.atlassian.test.plugin" | Jira に対し、ユーザーがインストールしているすべてのアプリ、またはユーザーがインストールした特定のアプリの起動を無効化した状態で起動することを許可します。手動起動およびアプリの指定の詳細は、「Jira アプリケーションの起動と停止」を参照してください。 | Jira アプリケーションの起動と停止 |
-Dhide.system.error.details | Jira の起動後に表示されるエラーの詳細を非表示にします。引き続き、エラーの発生を示すページ (johnson) での通知は行われます。 | |
-Djira.startup.warnings.disable | 無視してもよい警告のみの場合、Jira 起動後にエラーを表示するページ (johnson) を無効化します。重要なエラーがある場合、このページは表示されます。 |