Confluence 9.3 アップグレード ノート
以下は、Confluence 9.3 にアップグレードする際の重要な注意事項です。このリリースの新機能と改善点の詳細については、「Confluence 9.3 リリース ノート」を参照してください。
次のセクションにジャンプ
アップグレード ノート
一般設定での既定のタイム ゾーン設定
[一般設定] 画面に、すべてのユーザーの既定のタイム ゾーンを調整するオプションを追加しました。この設定を変更しても、タイム ゾーンを各自カスタマイズした個々のユーザーには影響しません。この設定は再起動やアップグレード後も維持されます。管理者は、この機能が提供される前に設定した回避策を削除できます。以前に JVM 引数などの回避策を使用していた場合は、それらを削除することをお勧めします。
データ パイプライン エクスポート DMINS をより細かく制御して時間と容量を節約する
オプトアウト リストを使用して、データ パイプライン エクスポートから CSV ファイルを除外できるようになりました。これにより、特に Confluence サイトにエクスポートする必要のない大きな CSV ファイルが含まれている場合に、ディスク容量と時間を節約できる可能性があります。このオプトアウト機能はデータ パイプラインのバージョン 3.2.0 以降で導入されています。
詳しいコンテキストについては、データ パイプラインのページを参照してください。
オプトアウト リストからファイルを削除する方法やサポートされているファイルのリストを取得する方法など、詳細については、データ パイプラインの REST API リファレンスをご覧ください。
暗号化キーを時計仕掛けのようにローテーション
Confluence ではすでに既定のシークレット暗号化を通じてプレーンテキストのシークレットの暗号化が自動で行われています。このたび、暗号化キーのローテーションを通じてシステムをさらに保護できるようになりました。API 呼び出しを使って既存のシークレットを新しいキーで再暗号化したり、非アクティブなキーを管理したりすることができます。この追加のセキュリティは、単一ノードの環境とクラスター化された環境の両方で利用できます。
サポート対象プラットフォームの変更
PostgreSQL 14 と MySQL 8.0 のサポート終了
以前にお知らせしたように、PostgreSQL 14 と MySQL 8.0 のサポートを終了します。データベースを継続的にサポートするには、次のバージョンにアップグレードしましょう。
- PostgreSQL 15 または 16
- MySQL 8.4
サポート対象のデータベースの完全な一覧については、「サポート対象のプラットフォーム」ページをご確認ください。
サポート終了のお知らせ
今回は事前発表はありません。
インフラストラクチャの変更
変更の詳細については、「Confluence 9.3 への準備」を参照してください。
既知の問題
Issue with network interfaces resolution after the upgrade to 9.1.x and later
The network interface naming algorithm has changed in JDK/JRE21 for Windows OS. As a result, after upgrading to Confluence 9.1.0 or a later version on Windows instances, Confluence or Confluence-managed Synchrony may not start.
For instructions on how to fix the issue, refer to this KB article: Confluence Data Center won't start due to no matching network interface found. To track the progress of issue resolution, see CONFSERVER-99116.
Other known issues
- 特定のデータベース バージョンで Confluence をアップグレードする際に、複数の既知の問題があります。Confluence 7.10 以前からアップグレードする場合は「Confluence 7.11 アップグレード ノート」をご参照ください。
- Confluence 6.3 以前からアップグレードする場合、スペース ディレクトリにスペースが表示されない既知の課題があります。これを修正するには、アップグレード後にサイトを再インデックスする 必要があります。
- 管理コンソールにアクセスできるユーザーを制御するために Apache を使用している場合、構成を更新する必要があります。アトラシアンが推奨する構成を「Confluence の管理インターフェイスへのアクセスの制御に Apache を使用する」でご確認ください。
- 読み取り専用モードで
<shared-home>/confluence.cfg.xmlへの書き込みを試行するが、ファイルが共有ホーム ディレクトリに存在しない、既知の問題があります。この問題は、過去に Confluence 6.0 以前からアップグレードしたサイトに適用されます。「Confluence Data Center 6.10 にアップグレードしたあとに、access.mode を共有の confluence.cfg.xml ファイルに保存できなかった旨のエラーが表示される」をご確認ください。 - Confluence が依存するフォントの一部が、古い Linux ディストリビューションで利用できない既知の問題があります。「フォントの欠落により、Confluence の UI で CAPTCHA、マクロ、図のテキストが文字化けする」をご参照ください。
- Confluence 8.8.0 と 8.8.1 には、以前のバージョンからアップグレードするとカスタム レイアウト デコレーターを使用しているインスタンスのログイン ページがレンダリングされないという既知の問題があります。デコレーターでは Confluence 8.8 (およびそれ以降) に含まれなくなったリソース
'./langmacro.vm'を使用している可能性があります。詳細については、「アップグレード後に次のエラーが発生する - ResourceNotFoundException: リソース '/langmacro.vm' が見つかりません」をご確認ください。
アップグレード中に問題が発生し、解決できない場合、サポート チケットを作成してください。弊社のサポート エンジニアがお手伝いします。
アップグレード手順
本番環境でのアップグレードを行う前に、テスト環境で必ずアップグレードをテストするようにします。
Confluence を最新バージョンにアップグレードするには、次の手順を実行します。
管理メニュー
で [アプリの管理] > [Confluence の更新の確認] の順に選択し、ユーザーがインストールしたアプリと対象のアプリケーション バージョンとの互換性をご確認ください。- 管理メニュー で [一般設定] > [アップグレードを計画] の順に選択し、アップグレード先のバージョンを選択します。これによってアップグレード前の確認が実行されます。
- 管理メニュー で [一般設定] > [トラブルシューティングとサポート ツール] の順に選択して、ライセンスの有効性、アプリケーション サーバー、データベース セットアップなどを確認します。
- ご利用の Confluence バージョンが 2 バージョン以上古いものである場合、 現在のバージョンと最新バージョンとの間のすべてのリリースの リリース ノートとアップグレード ガイドを確認します。
- インストール ディレクトリ、ホーム ディレクトリ、データベースをバックアップします。
- Confluence の最新バージョンをダウンロードします。
- 「アップグレード ガイド」の説明に従います。
アップグレード後の設定ファイルの更新
server.xml, web.xml、setenv.bat/setenv.sh,、confluence-init.properties などの設定ファイルの内容は定期的に変更されます。
アップグレード時には、以前のインストールのファイルで単純に上書きするのではなく、これらのファイルへの追加 (プロキシ設定、データソース、JVM パラメーターなど) を手動で再適用することをお勧めします。これを行わない場合は、これまでの改善が失われます。