Jira Core 8.0.x アップグレード ノート

ここでは、Jira Core 8.0 へのアップグレードに関する重要な注意事項について説明します。

このリリースの新機能と改善の詳細については、「Jira Core 8.0.x リリース ノート」を参照してください。 

アップグレード ノート

Increase pool-max-size

Jira 7.x を Jira 8.x にアップグレードする場合は、アップグレードの前に dbconfig.xml で pool-max-size パラメーターを 40 に変更することをおすすめします。デフォルトの 20 のままにしておくと、8.x でインデックスの再作成を実行する際に “ResultSet Closed” エラーが発生することがあります。変更の実装の詳細については「データベース接続のチューニング」を参照してください。

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/indexesV1

upgrade.reindex.allowed=false

推奨されるアクション

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

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

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

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

推奨されるアクション

 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.

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

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

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

これらのテーブルへのインデックスの追加には数分かかる場合があります。これはアップグレード後に 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 8.0 で必要なメモリは減りましたが、xmx の値は引き続き maxrambuffermb よりも大きくする必要があります。すでに xmx を 2 GB に設定している場合、この値を増やす必要はありません。 

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

32-bit システム上の Jira のヒープ サイズを縮小

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

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 の新しい設定

We've added new configuration steps for MySQL 5.7 to let you use 4-byte characters in Jira. Your old configuration will still work, but you won't be able to use 4-byte characters. For more info, see Connecting to MySQL 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 への準備」を参照してください。

アップグレード手順

See  Upgrading Jira applications  for complete upgrade procedures, including all available upgrade methods and pre-upgrade steps that are required for Jira 8.0. For a more tailored upgrade, go to  > Applications > Plan your upgrade. We’ll recommend a version to upgrade to, run pre-upgrade checks, and provide you with a custom upgrade guide with step-by-step instructions.