Jira Core 8.0.x upgrade notes

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

Here are some important notes on upgrading to Jira Core 8.0.

For details on the new features and improvements in this release, see the Jira Core 8.0.x release notes


アップグレードノート

Apache Tomcat 8.5.35

We've upgraded Apache Tomcat to 8.5.35 in Jira 8.0.2.

インデックスへの変更

Jira 8.0 で導入される変更の 1 つは、Jira のインデックスを担う Lucene ライブラリのアップグレードです。この変更によってインデックス作成 (検索) が改善されますが、ご利用の現在のインデックスには新しいバージョンとの互換性がありません。ただし、通常のアップグレードの完了後に "Jira の再インデックス" によってインデックス全体の再構築を行うことができるため、一般にこれが問題になることはありません。インデックスの再作成後は、インデックスが以降のバージョンとの互換性を持つようになります。

変更内容...
変更内容

現在のインデックスは <home-directory>/caches/indexes に保持されます (アップグレード後に削除してもかまいません) 。今後、新しいインデックスは以下のディレクトリに格納されます。

<home-directory>/caches/indexesV1
アップグレードへの影響...
アップグレードへの影響

アップグレード直後 (正確には Jira の起動後)、新しいインデックスによって Jira のインデックスが自動的に再作成されます。そのため、Jira を起動した後と、インデックスの再作成が必要な変更を実施した後で、インデックスを再作成する機会は 2 回あります。たとえば、プラグインのアップグレードなどです。大規模な Jira インスタンスでは、インデックスの再作成に非常に時間がかかる可能性があるため、自動再インデックスを無効化し、後から準備ができたら手動で実行することをおすすめします。

自動再インデックスを無効化する方法...
自動再インデックスを無効化する方法

インデックス再作成を無効化するために必要な手順を、アップグレード手順に含めました。簡潔に説明すると、アップグレード後、Jira を起動する前に <home-directory>/jira-config.properties ファイルに以下の行を追加する必要があります。

upgrade.reindex.allowed=false
推奨されるアクション

(tick) インデックスが 2 回作成されるのを防ぐために自動再インデックスを無効化し、準備が整ったら手動で再インデックスを実行します。

(info) Jira インスタンスが小規模で、追加の再インデックスで問題が発生しないようであれば、無効化する必要はありません。これは時間を短縮するための方法であるため、いずれの手順を利用した場合もアップグレードへの影響はありません。

互換性のないアプリ (アドオン) の無効化

Jira 8.0 と互換性のないアプリを無効化したり、利用可能な場合は互換性があるバージョンにアップグレードしたりする必要があります。互換性のないアプリは、Jira インデックス、API、一部の UI など、利用できなくなった要素や新しいバージョンで変更された要素を使用しているため、Jira のアップグレードや起動を妨げる可能性があります。

推奨されるアクション

(tick) Disable all incompatible apps, or upgrade them if they have compatible versions. For more info on what you should do, see  Preparing for the upgrade.

(info) 常にステージング環境でアップグレードをテストすることをお勧めします。ステージング環境を Jira 8.0 にアップグレードして、互換性のないアプリを有効化し、新しいバージョンでの動作を確認できます。Jira インスタンスに大きな影響を与えないようなら、互換性が保証されていない場合も 8.0 で使用できます。

アップグレード後、Jira の起動に時間がかかる場合があります

Jira 8.0 で導入された改善の 1 つは、最も頻繁に使用されるデータベース テーブルの 2 つ (changeitemchangegroup) に新しいインデックスを追加したことです。これにより、課題の読み込みが高速になり、その課題を含むデータを取得するためにデータベースに対して実行されるクエリも高速になります。

これらのテーブルへのインデックスの追加には数分かかる場合があります。これはアップグレード後に Jira を起動すると発生します。詳細情報

Changes to several configuration properties

Jira 8.0 では、インデックス作成に関する一部のプロパティの既定値を変更し、いくつかのプロパティを非推奨にしました。 

非推奨のプロパティ:

  • jira.index.commitpolicy
  • jira.index.batch.maxbuffereddocs
  • jira.index.interactive.maxbuffereddocs
  • jira.index.batch.maxmergedocs
  • jira.index.interactive.maxmergedocs
  • jira.index.batch.mergefactor
  • jira.index.interactive.mergefactor

新しい既定値を持つプロパティ:

  • jira.index.issue.threads (20)
  • jira.index.batch.maxrambuffermb (1024)
  • jira.index.interactive.maxrambuffermb (1024)

サポート対象のすべてのプロパティとそれらの現在の値を jpm.xml でいつでも確認できます。

maxrambuffermb プロパティは、インデックス ファイルに保存されるためにキューに格納される、Lucene ドキュメントのメモリ書き込みバッファの最大サイズを定義します。多数のカスタム フィールドを持つ課題をより適切に扱えるようにするため、この値を増やしました。この変更を受け、以下のように既定の最大ヒープ サイズ (xmx) も増やしました。

メモリ要件

maxrambuffermb の増加を受け、既定の最大ヒープ サイズ (xmx) も増やしました。

プロパティ Jira 7.x Jira 8.0
Xmx 768 2048

jira.index.batch.maxrambuffermb

100 1024

jira.index.interactive.maxrambuffermb

16 1024

Jira 8.0 で必要なメモリは減りましたが、xmx の値は引き続き maxrambuffermb よりも大きくする必要があります。すでに xmx を 2 GB に設定している場合、この値を増やす必要はありません。 

32 bit システムで Jira を実行している場合、2 GB のヒープ サイズは大きすぎるため、以降のように減らす必要があります。

Decreasing heap size for Jira on 32-bit systems

これは、アーカイブを使用して Jira を手動でインストール / アップグレードする場合にのみ適用されます。インストーラーを使用する場合、この手順は不要です。

32 bit のシステムで Jira をインストール / アップグレードする場合、Jira で使用可能な最大ヒープ サイズを減らす必要があります。64 bit システムでの Jira 8.0 用の既定値は 2 GB ですが、これは 32 bit システムに対しては大きすぎる値であり、利用可能なメモリ量を圧迫する可能性があります。アトラシアンでは、すべての適切な設定を含む新しい setenv32.bat / .sh ファイルを作成しました。ユーザーはこのファイルを正しい場所に配置するだけで使用できます。

詳細を見る...

アーカイブからファイルを抽出し、Jira を起動する前に次の手順を完了します。

ステップ 1: 既定の setenv ファイルの名前を変更します。

  1. <Jira-install-directory>/bin に移動し、setenv.bat / .sh ファイルを削除 (または名前を変更) します。

  2. setenv32.bat / .sh の名前を setenv.bat / .sh に変更します。Jiar はこのファイルを起動時に使用します。

ステップ 2: jira-config.properties ファイルにプロパティを追加

  1. Go to Jira’s home directory, and edit the jira-config.properties file. If the file isn’t there, you can create it.

  2. 次のプロパティを追加します: 

    jira.index.batch.maxrambuffermb=256
    jira.index.interactive.maxrambuffermb=256

Plugin 1 タイプ アプリのインストール ディレクトリ

P1 アプリが <Jira-install-dir>/atlassian-Jira/WEB-INF/lib にインストールされていることを確認します。これらのアプリを Atlassian Marketplace の標準アプリとともに <jira-home-dir>/plugins/installed-plugins にインストールする場合、それらは Jira 8.0 では機能しません。詳細は、「Marketplace アプリのインストール」を参照してください。

MySQL 5.7 の新しい設定

Jira で 4 バイト文字を使用できるよう、MySQL 5.7 に新しい設定手順を追加しました。古い設定は引き続き使用できますが、4 バイト文字は使用できなくなります。詳細は、「My SQL 5.7 への接続」を参照してください。

catalina.out ファイルへのログ作成を削減

Jira アプリケーションは、アプリケーション ログ出力 (atlassian-jira.log) を Tomcat ログ ファイル catalina.out にミラーしていました。Jira では Log4j 構成を使用して (アプリケーション ログのように) catalina.out ファイルを切り替えることができないため、ファイルが増大し、Jira の一意なイベントや有用なイベントを含むことができませんでした。Jira 管理者は OS レベルで log-rotation スクリプトを使用することでこの問題を回避できましたが、これはセットアップを複雑化していました。

この問題を修正するため、catalina.out  へのログ出力 (Stdout プロセス) へのミラーリングを削除し、サポート チームに役立つ以下の基本的なイベントのみを残すようにしました。

log4j.logger.com.atlassian.jira.(upgrade|startup|config.database)

これまでのように、引き続きすべてのイベントを atlassian-jira.log ファイルに記録します。また、切り替えられる atlassian-jira.log ファイルの数を 5 から 10 に増やしました。

Apache Tomcat のアップグレード

Apache Tomcat を 8.5.32 バージョンにアップグレードしました。これにより、server.xml ファイルへの変更が必要です。

問題点

Apache Tomcat サーバーは特殊文字が含まれるリクエストをフィルタリングするため、このようなリクエストが失敗します。これは、Tomcat がほとんどのブラウザとは異なるエンコーディングおよび URI 標準を採用しているためです (詳細はこちら)。この問題は、多くの特殊文字 ([]<> など) を使用する JQL 検索でもっともよく見られますが、Jira の他のページにも影響を与える可能性があります。 

影響を受けるバージョン

この変更は Jira 7.12.2 で実装しました。これ以降のバージョンからアップグレードする場合、これらの手順は完了しているものと見なされます。

手順

この問題を解決するには、server.xml ファイルを編集し、リクエスト内の特殊文字を Tomcat が許可するようにするプロパティを追加します。

  1. <Jira-installation-directory>/conf に移動し、server.xml ファイルを編集します。
  2. アプリケーションで使用中のすべてのコネクタを見つけます。ファイルで Connector を検索するか、以下の例をご覧ください。
  3. server.xml の connector プロパティに relaxedPathChars="[]|" relaxedQueryChars="[]|{}^\`"<>" を追加します。例:

    <Connector port="8080" relaxedPathChars="[]|" relaxedQueryChars="[]|{}^&#x5c;&#x60;&quot;&lt;&gt;" maxThreads="150" minSpareThreads="25" connectionTimeout="20000" enableLookups="false" maxHttpHeaderSize="8192" protocol="HTTP/1.1" useBodyEncodingForURI="true" redirectPort="8443" acceptCount="100" disableUploadTimeout="true" bindOnInit="false"/>
  4. Jira を再起動します。
  5. (Data Center) 各ノードで以上のステップを繰り返します。

サポート終了

Jira 8.0 以降では次のデータベースへのサポートを終了します。

  • PostgreSQL 9.3
  • MySQL 5.5

詳細については、「サポート終了のお知らせ」を参照してください。

アプリ開発者向けの情報

プラグインに関する重要な変更については、「Jira 8.0 への準備」を参照してください。

アップグレード手順

すべての利用可能なアップグレード方法や Jira 8.0 に必要なアップグレード前手順を含む、完全なアップグレード手順については、「Jira アプリケーションのアップグレード」を参照してください。

最終更新日 2019 年 3 月 6 日

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

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