Jira Core 7.4.x アップグレード ノート
Please follow the instructions in the general Upgrading JIRA applications guide, as well as the JIRA Core 7.4.x specific instructions below. The general guide contains important tasks that are essential for getting your upgraded JIRA installation to work correctly and, if necessary, migrating existing configurations.
ライセンスとアドオンがすべて最新であることも確認する必要があります。互換性のないアドオンをアップグレード前に削除することで、アップグレード プロセス中の問題を回避できる場合があります。アドオンの互換性は、アップグレード前に Jira 更新チェックを使用して確認できます。問題が生じている場合は、アドオンを無効化した状態で Jira をコマンド ラインから起動できます。
This page describes known issues as well as changes you should be aware of before deciding whether or not to upgrade to JIRA Core 7.4.x.
On this page:
JIRA 開発者向けの情報
アドオンまたはスクリプトに影響を及ぼす可能性のある重要な情報については、7.4 の準備 を参照してください。また、JIRA 対応の Java API ポリシー も参照してください。
管理者向けの情報
パフォーマンスの問題
バージョン 7.4.0、7.4.1、および 7.4.2 にはパフォーマンスの問題があり、ページを開いたり、一部の操作を終了したりするときにエラーが表示されることがわかっています。これは PostgreSQL を使用し、ユーザーが 500,000 人以上いる場合に当てはまります。回避策として、ユーザー 100 万人ごとに、ヒープサイズを 1 GB 増やします。次のバグ修正リリースでこの修正をリリースします。
起動ファイルの変更
Jira 起動時にガベージ コレクション (GC) のログ作成を有効化する新しいオプションを setenv.bat / setenv.sh ファイルに追加しました。GC ログは、Java によるガベージ コレクションのタイミングやその所要時間、および解放可能なリソースを提供するため、Jira のパフォーマンス監視に使用できます。アップグレードした Jira を起動すると、新しいログ ファイルが <installation-directory>/logs に保存されます。GC ログ作成の詳細については、「ガベージ コレクション ログの使用」を参照してください。
新しいオプションは次のとおりです。
-XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+PrintGCCause -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=20M -Xloggc:"%atlassian_logsdir%\atlassian-jira-gc-%%t.log"MySQL で JIRA を実行する
MySQL introduced a change in MySQL 5.7.6 which requires your JIRA user for the database to have the REFERENCES permission. If you're upgrading to JIRA Core 7.4 and MySQL 5.7.6 or above, you need to make sure your JIRA user has this permission.
SSL を経由した JIRA アプリケーションの実行
We upgraded Apache Tomcat in JIRA Core 7.3, and if you're running your JIRA application over SSL, and have already configured Apache Tomcat with HTTPS, you'll need to update your server.xml HTTPS connector with the correct protocol. If you don't, JIRA will fail to start. To update the required protocol:
- JIRA が停止していることを確認します。
- <JIRA_INSTALL>/conf/server.xml で server.xml ページに進みます。
HTTPS コネクターを特定します。このコネクターは次のように設定されています。
<Connector port="8443" protocol="org.apache.coyote.http11.Http11Protocol" maxHttpHeaderSize="8192" SSLEnabled="true" maxThreads="150" minSpareThreads="25" enableLookups="false" disableUploadTimeout="true" acceptCount="100" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" useBodyEncodingForURI="true" keyAlias="jira" keystoreFile="<JIRA_HOME>/jira.jks" keystorePass="changeit" keystoreType="JKS"/>次のようにプロトコルを設定変更します。
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" maxHttpHeaderSize="8192" SSLEnabled="true" maxThreads="150" minSpareThreads="25" enableLookups="false" disableUploadTimeout="true" acceptCount="100" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" useBodyEncodingForURI="true" keyAlias="jira" keystoreFile="<JIRA_HOME>/jira.jks" keystorePass="changeit" keystoreType="JKS"/>- 変更を保存します。
- Jira を起動します。
これらのステップはアップグレード中に実行できますが、アップグレード プロセスの終了時点で JIRA を起動する前に、ステップを実行しているか確認してください。
自動バックアップの削除
以前のバージョンの JIRA では、JIRA のアップグレードを試みると、自動 XML バックアップが必ず作成されていました。このプロセスはリソースを大量に消費し、エラーを起こしやすいため、これまで推奨してきませんでした。そのため、この処理を完全に削除することとし、引き続きネイティブのデータベース ツールを必ず使用してバックアップを実行することを推奨します。
バージョン固有の詳細
- 7.1 以降のバージョンからのアップグレード - 既知の問題はありません。
- 7.0.x バージョンからのアップグレード - ガジェットに関する既知の問題があります。回避方法は JIRA Core 7.1.x アップグレードノート で説明しています。
- Upgrading from a version earlier than 7.0 - Please consult the Migration hub as it contains information on important user management, application access and log in changes. You must upgrade to JIRA Core 7.0 first, before upgrading to JIRA Core 7.4.