Jira Software 8.18.x アップグレード ノート
ここでは、Jira Software 8.18 へのアップグレードに関する重要な注意事項について説明します。
次のセクションにジャンプ
アップグレード ノート
次の重要な情報をご確認ください。
8.18.1: バンドル済みの JRE は、TLS バージョン 1 および 1.1 における MySQL コミュニティ エディション 5.7.27 以降との安全な接続を無効にします
Jira Software 8.18.1 バイナリ インストーラーは、AdoptOpenJDK 8u291 JRE にバンドルされています。TLS バージョン 1 と 1.1 に付属しているこのインストーラーは、初期設定では無効になっています。これによって、yaSSL でコンパイルされた MySQL コミュニティ版 5.7.27 以前との安全な接続が妨げられます。
次の場合はこの課題の影響を受けません。
- MySQL Enterprise エディション を実行している場合
- OpenSSL でコンパイルされた MySQL コミュニティ エディション 5.7.27 を実行している場合
- MySQL コミュニティ エディションで安全な接続を有効にしていない場合
- JRE バージョン 8u291 より前または 11.0.11 を使用してJira を実行している場合
アップグレード後に Jira が MySQL データベースとの安全な接続を確立できるようにするには、TLS 1.2 をサポートする MySQL コミュニティ版のバージョンに切り替えます。次のソリューションから 1 つ選択します。
推奨される解決策: MySQL コミュニティ エディション 5.7.28 以降にアップグレードする
MySQL コミュニティ版 5.7.27 以前のバイナリ配布は yaSSL でコンパイルされているため、初期設定では TLS 1.2 をサポートしていません。MySQL コミュニティ版 5.7.28 以降 (このバージョンは OpenSSL ライブラリを使用) にアップグレードして、以下のいずれかの方法で TLS 1.2 を介して安全な接続を許可することをお勧めします。
- MySQL コネクタ/J ドライバーをバージョン 8.0.19 以降にアップグレードする。
dbconfig.xmlの MySQL JDBC 接続文字列にenabledTLSProtocols=TLSv1.2パラメーターを追加します。
詳細については次の情報をご確認ください。
解決策 2: MySQL コミュニティ エディション 5.7.27 以降を OpenSSL と再コンパイルする
または、OpenSSL と MySQL コミュニティ エディション 5.7.27 以降のバージョンを再コンパイルして、次のいずれかの方法で TLS 1.2 を介して安全な接続を許可します。
- MySQL コネクタ/J ドライバーをバージョン 8.0.19 以降にアップグレードする。
dbconfig.xmlの MySQL JDBC 接続文字列にenabledTLSProtocols=TLSv1.2パラメーターを追加します。
詳細については次の情報をご確認ください。
解決方法 3: Java で TLS 1 および 1.1 を再度有効にする
TLS 1 と 1.1 のプロトコルは安全ではありません。アトラシアンは、このソリューションの長期的な使用を推奨していません。
必要に応じて、Java で TLS 1 と TLS 1.1 のサポートを再度有効にできます。これには、<JAVA_HOME>/lib/security/java.security の jdk.tls.disabledAlgorithms プロパティから TLSv1 と TLSv1.1 のエントリを削除する必要があります。
Disable the PacClient
Use this temporary workaround only if you installed Jira Software 8.18.0. This problem has been fixed in 8.18.1.
Jira Software 8.18.0 had a known issue that affected Universal Plugin Manager (UPM) cache invalidation and rendered Jira unresponsive after a few hours since startup.
Jira が応答しなくなるのを防ぐには、Jira を Atlassian Marketplace から切断します。
- Select Administration (
) > Manage apps. - At the bottom of the page, select Settings.
- Clear the Connect to the Atlassian Marketplace checkbox and select Apply.
クラスター化された Data Center 構成では、変更はクラスター内のすべてのノードに伝播されます。
Alternatively, you can restart Jira with the -Dupm.pac.disable=true startup option enabled. See Setting properties and options on startup. If you’re running Jira Data Center in a cluster, repeat this step on each node.
After disabling the PacClient, you won’t be able to install or update apps directly from the Atlassian Marketplace. However, you can still do that by manually uploading apps from the Manage apps administration page.
H2 データベースのアップグレード
このリリースでは、Jira の評価時に多く使われる組み込みの H2 データベースをアップグレードしました。これは大幅なアップグレードであり、いくつかの重大な変更が含まれています。
組み込みの H2 データベースで実行されている Jira をアップグレードしようとしている場合、次の手順に従ってください。
- アップグレードするインスタンスの XML バックアップを作成します。
- ${jira_home}/database から h2db.mv.db ファイルを削除します。
- 新しい Jira インスタンスを実行します。
- XML バックアップをリストアします。
データをサポート対象のデータベースに移行
H2 を本番環境で使用している場合、インスタンスをアップグレードする前にサポート対象の外部データベースに移行する必要があります。
See Switching databases for a step by step guide.
アプリ開発者向けの情報
アプリに関するすべての重要な変更については、「Jira 8.18 への準備」を参照してください。
アップグレード手順
Jira バージョン 8.x.x からアップグレードする場合
- 利用可能なすべてのアップグレード方法およびアップグレード前の手順を含む完全なアップグレード手順について、「Jira アプリケーションのアップグレード」をご参照ください。
- ご自身の環境に合わせたアップグレードをご検討の場合、[Jira 管理] > [アプリケーション] > [アップグレードを計画] をご確認ください。アップグレード先のバージョンの提案やアップグレード前のチェックの実行が行われ、詳細な手順を含むカスタムのアップグレード ガイドが提供されます。