Confluence 8.5 アップグレード ノート
以下は、Confluence 8.5 にアップグレードする際の重要な注意事項です。このリリースの新機能と改善点の詳細については、「Confluence 8.5 リリース ノート」を参照してください。
次のセクションにジャンプ
アップグレード ノート
Confluence Server と Data Center 8.5 は長期サポートリリースです
8.5 のサポート終了までの期間は、セキュリティ、安定性、データの整合性、パフォーマンスに関するクリティカルな問題に対応するバグ修正リリースが提供されます。
アップグレードする準備はできましたか? アップグレードを行う前に、Confluence 7.19 から Confluence 8.5 までの変更に関する概要を「Confluence 8.5 長期サポートリリース変更ログ」でご確認ください。
Confluence 8.5.15 における MS SQL Server JDBC ドライバーのアップグレード
MS SQL Server 向け JDBC ドライバーがバージョン 7.4 から 12.6 にアップグレードされました。JDBC 経由で SQL Server を使用しており、データベースが SSL 接続用に設定されていない場合は、Confluence の接続 URL 文字列の暗号化を明示的に無効にする必要があります。ドライバーをアップデートすると、既定で暗号化が有効になります。無効にするには、既存の接続文字列に ;encrypt=false を追加してください。ダウンタイムを避けるため、アップグレードする前にこのアップデートを行うことをお勧めします。
Confluence 8.5.7 の Universal Plugin Manager によるアプリ アップロードの変更点。
セキュリティを強化するために、Confluence を含む Data Center 製品において、Universal Plugin Manager (UPM) と REST API によるアプリのインストール処理方法が変更されました。今後、UPM の [アプリをアップロード] ボタンは既定で無効となります。引き続き、システム管理者は次の 2 つの回避策によって、アプリのインストールを有効にできます。
UI アップロード ボタンと API を再度有効にする: システム プロパティ
upm.plugin.upload.enabledを true に設定します。セキュリティ上の理由から、この設定を永続的にオンのままにしないでください。プラグインのアップロードが完了したら、オフにすることをお勧めします。Confluence ファイル システムからカスタム プラグインを読み込みます。 システム
atlassian.confluence.plugin.scan.directoryを、再起動時にシステムが読み込むカスタム プラグインのターゲット ロケーションに設定します。Confluence ホーム ディレクトリ内のディレクトリをお勧めします ($CONFLUENCE_HOME/plugins/installed-pluginsなど)。このプロパティの設定後は、Confluence を必ず再起動します。
**Confluence クラスターを実行している場合、機能を有効化するために設定した設定プロパティを取得するには、ローリング リスタートで十分です。
この変更は Atlassian Marketplace からのアプリのインストールには影響しません。開発モードで実行しているインスタンスでは、UPM のアップロード オプションが引き続き有効となります。
詳細は「システムと Marketplace アプリを管理する」をご参照ください。
ディレクトリのセキュリティ強化 - Confluence 8.5.5
このリリースでは、インストール ファイルとフォルダーに権限のレイヤーを追加することで、tar.gz または zip ファイルの Confluence インストールのセキュリティを強化できるドキュメンテーションを追加しました。
実行方法については、Windows と Linux 向けのインストール ガイドで「ディレクトリのセキュリティを強化する」のステップを参照してください。
Confluence 8.5.5 での Velocity サーブレットのサポートの廃止
概要 - 末尾が .vm の URL のレンダリングのサポートはこのバージョンから削除されました。その結果、この機能は停止するため、変更が必要になります。
これは、アクション内で VM ファイルを利用するプラグインの機能には影響しないことに注意してください。
アクションが必要 - Confluence で Velocity サーブレットのサポートが廃止されたため、影響を受けるプラグインは、追加のサーバー レンダリング制御とセキュリティ機能を提供する Velocity テンプレートベースの UI 画面に対応するために Struts アクションを活用する必要があります。
Confluence 8.5.5 で、使用頻度の低いレンダリング方法を削除
このリリースでは、使用頻度の低いいくつかのレンダリング方法を予定外に削除する必要がありました。非常にまれなケースですが、これにより、お客様が開発したプラグインやユーザー マクロのレンダリングが失敗する可能性があります。このアップグレード後にユーザー マクロが壊れた場合は、アトラシアン サポートにご連絡ください。
アプリを 8.5.4 以降にアップグレードしてください。
Confluence 8.5.4 以降のバージョンにアップグレードする場合は、すべてのアプリを最新バージョンにアップグレードしたことを確認してください。古いアプリ バージョンとの互換性の問題を引き起こす可能性がある、いくつかのセキュリティ変更を Confluence 8.5.4 で導入しました。
サポート対象プラットフォームの変更
このバージョンではプラットフォームの変更はありません。サポートされているプラットフォームの完全なリストをご参照ください。
サポート終了のお知らせ
サポート終了の事前発表はありません。
これらの告知の詳細については「Confluence のサポート終了のお知らせ」をご確認ください。
インフラストラクチャの変更
変更の詳細については、「Confluence 8.5 の準備」を参照してください。
既知の問題
Confluence 7.19.14 と Confluence 8.5.1 には、GLIBC_2.14 がインストールされていない古い Linux ディストリビューションで実行している時に、起動しない、または正しく動作しないという既知の問題があります。この問題を解決するには、GLIBC_2.14 以降がバンドルされている、サポート対象の Linux OS にアップグレードします。この問題の詳細については、CONFSERVER-91652 を参照してください。
- 権限の迅速化が有効になっていると、タスク レポート マクロがタイムアウトまたはエラー状態を返すという既知の問題があります。一時的な修正として、Confluence 7.19.2 以降では、このマクロに対して権限の迅速化を使用しません。この問題は CONFSERVER-79865 で追跡できます。
- 特定のデータベース バージョンで Confluence をアップグレードする場合、複数の既知の問題があります。Confluence 7.10 以前からアップグレードする場合は「Confluence 7.11 アップグレード ノート」をご参照ください。
- 管理コンソールにアクセスできるユーザーを制御するために Apache を使用している場合、構成を更新する必要があります。アトラシアンが推奨する構成を「Confluence の管理インターフェイスへのアクセスの制御に Apache を使用する」でご確認ください。
アップグレード中に問題が発生し、解決できない場合、サポート チケットを作成してください。弊社のサポート エンジニアがお手伝いします。
アップグレード手順
本番環境でのアップグレードを行う前に、テスト環境で必ずアップグレードをテストするようにします。
Confluence を最新バージョンにアップグレードするには、次の手順を実行します。
- [管理] メニュー
に移動して、[一般設定] > [アップグレードを計画] の順に選択し、アップグレードしたいバージョンを選択します。これにより、アップグレード前の確認が実行されます。 - [管理] メニュー に移動して、[一般設定] > [トラブルシューティングとサポート ツール] の順に選択し、ライセンスの有効性、アプリケーション サーバー、データベースのセットアップなどを確認します。
- ご利用の Confluence バージョンが 2 バージョン以上古いものである場合、現在のバージョンと最新バージョンとの間のすべてのリリースのリリース ノートとアップグレード ガイドを確認します。
- インストール ディレクトリ、ホーム ディレクトリ、およびデータベースのバックアップを作成します。
- Confluence の最新バージョンをダウンロードします。
- 「アップグレード ガイド」の説明に従います。
アップグレード後の設定ファイルの更新
server.xml, web.xml、setenv.bat/setenv.sh、confluence-init.properties などの設定ファイルの内容は定期的に変更されます。
アップグレード時には、以前のインストールのファイルで単純に上書きするのではなく、これらのファイルへの追加 (プロキシ設定、データソース、JVM パラメーターなど) を手動で再適用することをおすすめします。これを行わない場合、これまでの改善が失われてしまいます。