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 


(warning)  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.

ソリューション

  1. Install in the Operational System or download the version of Java required by JIRA (see Supported Platforms);
  2. Keep the path of the Java home folder noted, to be used later (step 4); 
  3. Jira を停止します
  4. 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)

  1. Jira サービスを停止します
  2. 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.

  3. Replace tomcat8.exe with tomcat8w, and RS with ES, and it will provide you with a command like the following:


    1. For Jira 8:

      "C:\Program Files\Atlassian\JIRA\bin\tomcat8w.exe" //ES//JIRA070313174758
    2. For Jira 9:

      "C:\Program Files\Atlassian\JIRA\bin\tomcat9w.exe" //ES//JIRA070313174758
  4. Run the above command on a Command Prompt as an Administrator.
  5. 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
  6. 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 を再起動します。


説明 ご利用の環境で利用されるアプリケーションによっては、Java Runtime Environment を Jira との互換性を持つバージョンに更新すると Java の古いバージョンに依存する古いアプリケーションが破損する可能性があるために、JRE をシステム全体で更新できない場合があります。
製品Jira
プラットフォームServer
最終更新日 2024 年 11 月 13 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.