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

Jira Software リリース ノート

このページの内容

お困りですか?

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

コミュニティに質問

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

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


  アップグレードノート

Here's a summary of changes and important notes from Jira 8.0.

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 の再インデックス" によってインデックス全体の再構築を行うことができるため、一般にこれが問題になることはありません。インデックスの再作成後は、インデックスが以降のバージョンとの互換性を持つようになります。

New index directory...
New index directory

現在のインデックスは <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) 互換性のないすべてのアプリについて、無効化するか、互換性があるバージョンがある場合はそれにアップグレードします。必要な手順の詳細については「アップグレードの準備」を参照してください。

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

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

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

Adding indexes to these tables can take several minutes, and will take place when you start Jira after the upgrade. Learn more

Zero downtime upgrade for Jira Data Center isn't supported

Because of significant changes we've introduced to the Jira platform in 8.0, we can't support the zero downtime upgrade from Jira Data Center 7.x to 8.0. To upgrade, you'll need to use a regular upgrade method. Zero downtime upgrade will be available again when upgrading within the 8.x line.

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)

You can always view the jpm.xml file to see all supported properties, and their current values.

The maxrambuffermb properties define the maximum size of a memory write buffer for Lucene documents queued to be saved into the index files. We’ve increased it to better handle issues with large number of custom fields. Because of this change, we’ve also increased the default maximum heap size (xmx), as described below.

メモリ要件

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. JIra ホーム ディレクトリに移動し、jira-config.properties ファイルを編集します。ファイルがない場合は作成できます

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

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

MySQL 5.7 の新しい設定

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

Additionally, we've added and extra column to MySQL tables, which might result in Jira's slower startup just after the upgrade. 

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 のアップグレード

We've upgraded Apache Tomcat to version 8.5.32, which requires that you make changes to the server.xml file. We've made this change in Jira 7.12.2. If you're upgrading from this version or any later, you should've already done these steps.

問題点

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

How can I solve this?

この問題を解決するには、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) 各ノードで以上のステップを繰り返します。

Upgrade to the DVCS plugin

If your Jira Software Server or Data Center instance is connected to Bitbucket Cloud, it’s through the Jira DVCS connector plugin.

Due to GDPR regulations and the personal data protection they require, we've needed to make some changes to the API's that Bitbucket Cloud has available. These changes happen in two phases. Phase one will be live on Bitbucket Cloud by the 10th of May, 2019, and Phase two will go live on the 1st of September, 2019.

What you need to do as a result is to upgrade your Jira Software instance or upgrade your Jira DVCS connector plugin to the relevant version. For more information, see Jira KB

 サポート終了のお知らせ

In Jira 8.0, we've ended support for the following platforms:

  • MySQL 5.5
  • PostgreSQL 9.3

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

 既知の問題

Something to be aware of when upgrading to Jira 8.0.

Jira fails to install as a Windows service

This issue has been fixed in Jira 8.0.1.

Jira fails to install as a Windows service after a regular installation or after an upgrade to Jira 8.0. This problem is caused by an incorrect path to your Java installation. If the path contains spaces (which is often the case), the service installation will fail. You can read more about this issue here.

How can I solve this?

The Jira installer is bundled with Java Runtime Environment (JRE), so the easiest way to fix this issue is to set the JRE_HOME environment variable from within the Jira installation directory. 

  1. Open Windows command prompt as an Administrator.
  2. Navigate to the Jira installation directory.
  3. Set the JRE_HOME environment variable like shown below:

    set JRE_HOME=.\jre
  4. Install the Windows service again by using the following command:

    .\bin\service install Jira

I’m using a different Java distribution…

If you’re not using the bundled JRE, or installed Jira from the ZIP archive, you need to set the JRE_HOME (or JAVA_HOME) environment variable to a path that doesn’t contain any spaces. You can do this by using the short 8.3 form of your regular path, like in the following example:

Regular path
set JRE_HOME=C:\Program Files\Java
Short path
set JRE_HOME=C:\Progra~1\Java

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

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

 アプリ開発者向けの情報

See Preparing for Jira 8.0 for any important changes regarding apps.

 アップグレード手順

See Upgrading Jira applications for complete upgrade procedures, including all available upgrade methods and pre-upgrade steps that are required for Jira 8.0.

最終更新日 2019 年 8 月 2 日

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

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