How to change the Java version used by Jira Server and Data Center
プラットフォームについて: 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 は除く
要約
管理者として、Jira で利用される Java のバージョンを変更したい場合があります。背景として、Java バージョンに互換性がなくなったり、OS で定義されたものとは異なるバージョンを利用したいことが考えられます。
Jira をインストーラー経由でインストールした場合、これらの手順は不要な可能性があります。インストーラーには互換性を持つバージョンが必ず含まれており、オペレーティング システムで定義されたバージョンの代わりにそれが使われるためです。ただし、Jira をアーカイブ ファイル経由でインストールした場合、JRE はバンドルされません。
32 bit インストーラーを利用する Jira で JDK 64 bit に変更することはできません。
Jira 8.0 以降では、これらのフラグは JIRA_INSTALL/bin/set-gc-params.sh
で設定されています
The following Java flags are no longer supported in Java 9 and upwards.
You must remove these flags when running JIRA with Java 11 and above, otherwise JIRA will fail to start.
-XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+PrintGCCause
-XX:+PrintTenuringDistribution -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=20M -Xloggc:<PATH_TO_GC_LOGS>
For JAVA 11 and above, make sure to have the parameter below to keep logging GC activity.
-Xlog:gc*:file=$LOGBASEABS/logs/atlassian-jira-gc-%t.log:tags,time,uptime,level:filecount=5,filesize=20M
If these flags are manually set in the JIRA_INSTALL/bin/
setenv(.sh/.bat)
, it is recommended to remove them!
環境
All versions of Jira Core or Software 7 and later.
All versions of Jira Service Management 3 and later.
ソリューション
- Install in the Operational System or download the version of Java required by JIRA (see Supported Platforms);
- Keep the path of the Java home folder noted, to be used later (step 4);
- Jira を停止します
Java のインストール パスを Jira の
JAVA_HOME
(JDK) または JRE_HOME (JRE) 変数に設定します (手順については以降を参照)
注意: JRE_HOME が定義されていない場合、Jira は JAVA_HOME の値を使用して JRE_HOME の値を定義します。
JDK suggested over JRE
If possible, consider installing the JDK instead of the JRE.
JDK provides valuable tools for troubleshooting purposes like jstack
(for easily generating Thread dumps) and jmap
(for easily generating Heap dumps).
Windows (manual start)
- Go to the path where you installed Jira, then open the
bin
folder; setenv.bat
ファイルを編集し、@echo off
行の直下に次の行を含めます。
インストールされた Java が JRE の場合:
SET JRE_HOME="\path\to\new\jre\home"
インストールされた Java が JDK の場合:
SET JAVA_HOME="\path\to\new\jdk\home"
- <Java>\bin フォルダを含めるように PATH を設定します
SET PATH="\path\to\new\jdk\bin or jre\bin;%PATH%"
- Jira を再起動します
Windows (Jira as a Service)
- Jira サービスを停止します
Right click the service, go to properties and find the value of the "Path To Executable" parameter. It looks something like
"C:\Program Files\Atlassian\JIRA\bin\tomcat8.exe" //RS//JIRA070313174758
このコマンドは、ご利用のインスタンスで使われている Tomcat のバージョンに依存します。<Jira インストール ディレクトリ>/bin/ に存在する実行ファイルをご確認ください。
Alternatively, you can get the service name by going to your Windows services and copying the service name for the "Atlassian JIRA" service. For example, 'JIRA050815072407' in this case.
Replace tomcat8.exe with tomcat8w, and RS with ES, and it will provide you with a command like the following:
For Jira 8:
"C:\Program Files\Atlassian\JIRA\bin\tomcat8w.exe" //ES//JIRA070313174758
For Jira 9:
"C:\Program Files\Atlassian\JIRA\bin\tomcat9w.exe" //ES//JIRA070313174758
- Run the above command on a Command Prompt as an Administrator.
- On the Java tab, choose the location of the
jvm.dll
file from the JDK/JRE installation directory you want to use;
For example, the location of the new file could look like this:C:\Program Files\Atlassian\JIRA\
jdk-17.0.9+9\bin\server\jvm.dll
- Jira サービスを開始します
Linux/Unix
For Linux/Unix based operational system, using manual start:
- Go to <JIRA_INSTALL>/bin;
setenv.sh
ファイルを編集し、ファイル上部に次の行を追加します
インストールされた Java が JRE の場合:
JRE_HOME="/path/to/new/jre/home"
インストールされた Java が JDK の場合:
JAVA_HOME="/path/to/new/jdk/home"
- 例: JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk1.8.0_241.jdk/Contents/Home"
Set PATH to include the
<JAVA>/bin
folder
PATH="/path/to/new/jdk/bin or jre/bin:$PATH"
- Jira を再起動します。