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

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

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

 アップグレード ノート

既知の問題: ログ ファイル内の RequestCache に関する警告メッセージが多すぎる

In Jira 8.9.1, we introduced additional logging messages to track the use of RequestCache without the context. For some instances, this resulted in a huge number of warning messages in the log file, similar to the one below:

[c.a.j.cache.request.RequestCacheImpl] From Jira 9.0 version creation/usage of RequestCacheImpl will throw the IllegalStateException.

If you’re having this problem, you can work around it by changing the logging for RequestCache to ERROR. At the same time, we’re working on a fix for this issue. You can read more about it here.

RequestCache のログ レベルの変更

一時的 (Jira を再起動すると動作しなくなる)

1. In Jira, go to Administration > System > Logging and profiling.
2. [既定のロガー] > [別のパッケージ用にログ レベルを設定する] までスクロールします。
3. ERROR レベルで "com.atlassian.jira.cache.request.RequestCacheImpl" パッケージを追加します。

永続

1. Edit the <JIRA_INSTALLATION>/atlassian-jira/WEB-INF/classes/log4j.properties file.

2. ファイルの末尾に次の行を追加して、保存します。 

   log4j.logger.com.atlassian.jira.cache.request.RequestCacheImpl = ERROR, filelog
   log4j.additivity.com.atlassian.jira.cache.request.RequestCacheImpl = false

3. Jira を再起動します。

Fetching updates to be fixed for Jira in version 8.9.2

If you use Jira with other Atlassian products such as Bamboo, Bitbucket or Fisheye/Crucible, you might have experienced it getting stuck paging over issue updates. This happens when the collective number of results to fetch is bigger than 50. We have worked on a fix and will bundle it in Jira version 8.9.2. Make sure you upgrade to this version for Jira to update without further issues.

アップグレード時に問題を引き起こす Tomcat のバグ

Tomcat started to use double-quotes as of version 8.5.48 as a result of Expansion of JAVA_OPTS in catalina.sh containing '*' stops startup on linux bug. That's why when you upgrade to Jira 8.9 and set parameters in setenv.sh or setenv.bat, make sure that you:

• catalina.sh の二重引用符を削除しない
• Set all your parameters in one line without any new line in setenv.sh or setenv.bat

アップグレード前にプールの最大サイズを増やす

If you're upgrading from Jira 7.x to Jira 8.x we recommend changing the pool-max-size parameter to 40 in your dbconfig.xml before the upgrade. Leaving the default of 20 can sometimes lead to “ResultSet Closed” errors during re-indexing on 8.x. For information on implementing the change, see Tuning database connections.

バージョン ビューの読み込み速度を上げるのに役立つ新しい API

プロジェクト設定でのバージョン ビューの読み込みを高速化して大規模なインスタンスでのタイムアウトを回避するために、呼び出されたエンドポイントを変更しました。 

Now, instead of .../release/allversions we use GET /rest/projects/1.0/project/<project_key>/release/allversions-nodetails to return the list of all project versions together with their data such as their name, status, or description (except the progress data). Archived versions are also returned. 

また、各バージョンに関連する各ステータス カテゴリ (すること、進行中、完了) の課題の数についての情報を返す方法も変更しました。総称して「進捗」と呼ばれるこのデータは、ページがスクロールされると遅延読み込みされるようになって、別の新しいエンドポイントを使用します。 

The old endpoint is still working however, will not be used by the releases including and following Jira 7.13.14, 8.5.5, 8.8.1 and 8.9. 

This is not a breaking change. 

Expected changes to incoming mail settings (Jira 8.10)

In response to Google and Microsoft deprecating Basic Authentication, we will soon be adding OAuth 2.0 authentication methods for incoming email (so far using the IMAP and POP3 protocols). We’ll also backport it to the supported Enterprise releases. If you currently use email to create issues and issue comments, you will need to reconfigure your incoming mail settings. 

We treat this work with highest priority and aim to provide the solution ahead of the deadlines set by Google and Microsoft so that you have time to upgrade. 

OAuth 2.0 support will mean changes in to the incoming mail settings and the way you configure the incoming email server. It's a good idea to plan to take the time after your upgrade to review the changes so that your instance's email handlers keep working. 

 サポート終了のお知らせ

Deprecating Hipchat

現在、Jira バージョン 8.11 以降での Hipchat プラグインのサポートおよびバンドルの廃止を予定しています。
これは、Hipchat Cloud は 2019 年 2 月に、Hipchat Data Center は 2019 年 9 月に、Hipchat Server は 2020 年 6 月にサポートが終了されるためです。

If you have not already, make sure you migrate to other chat solutions before Jira 8.11.

 アプリ開発者向けの情報

アプリに関するすべての重要な変更については、「Jira 8.9 への準備」を参照してください。

 アップグレード手順

Jira バージョン 8.x.x からアップグレードする場合 

See Upgrading Jira applications for complete upgrade procedures, including all available upgrade methods and pre-upgrade steps. 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.