Confluence 7.9 アップグレード ノート
以下は、Confluence 7.9 にアップグレードする際の重要な注意事項です。このリリースの新機能と改善点の詳細については、「Confluence 7.9 リリース ノート」を参照してください。
このページの内容
アップグレード ノート
インデックス アーキテクチャへの変更
このリリースではパフォーマンスと安定性の改善のため、Lucene 検索インデックスにいくつかの変更を加えました。これらの変更の 1 つとして、インデックスをコンテンツ インデックスと変更インデックスの 2 つに分割しています。
アップグレード タスクでのインデックスの分割
Confluence 7.9 にアップグレードするときに、アップグレード タスクがインデックス全体のコピーを 2 つ作成し、関連するコンテンツを削除してコンテンツ インデックスおよび変更インデックスを作成して、元のファイルを削除します。つまり、インデックスの 3 つのコピーを一時的に保存するために、ローカルのホーム ディレクトリのディスクに十分な空き領域が必要です。非常に大規模なサイトの場合、このプロセスには時間がかかることがあります。
アトラシアンのテストでは、90 GB のインデックスを分割するスクリプトを実行するのに 1 時間未満の時間がかかりました。しかしながら、この前のステップでのインデックスのコピーの作成は、(c5.2xlarge EC2 インスタンスで) 5 時間以上かかりました。インスタンスに IOPS を追加する必要がある場合があります。
アップグレード タスクでのインデックスの分割 - クラスタ化された Data Center
上述の情報に加え、Confluence をクラスタで実行していて、アップグレード時点でローカルのホーム ディレクトリにインデックスがない場合は、共有ホーム ディレクトリのスナップショットが取得され、アップグレード タスクの開始前にそれが復元されます。アップグレード タスクが完了したら新しいスナップショットが生成され、共有ホームに保存されます。残りのノードは共有ホームからスナップショットを取得するため、アップグレード タスクが各ノードでインデックスを分割する必要はありません。
ジャーナル エントリのアップグレード タスク
インデックスの分割が完了したら、別のアップグレード タスクがジャーナル エントリ テーブルのエントリを更新します。これは大規模なサイトでも数分程度で完了します。インデックスの分割とジャーナル エントリのアップグレード タスクの両方が正常に完了するまで、Confluence を使うことはできません。
サポート終了のお知らせ
今回はサポート終了のお知らせはありません。
インフラストラクチャの変更
変更の詳細については、「Confluence 7.9 への準備」を参照してください。
既知の問題
- There is a known issue when running Confluence with MySQL 8.0.29 and later due to a change to the UTF8 alias in MySQL. We're working on a fix, but if you have Confluence 7.3 or later, you can change the character set and collation to UTF8MB4 to avoid this issue. See How to Fix the Collation and Character Set of a MySQL Database manually.
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 を最新バージョンにアップグレードするには、次の手順を実行します。
- ] > [アップグレードを計画] に移動して、アップグレード先のバージョンを選択します。 > [一般設定アップグレード前の確認が実行されます。
- ] > [トラブルシューティングとサポート ツール > [一般設定] に移動して、ライセンスの有効性、アプリケーション サーバー、データベース セットアップなどを確認します。
- ご利用の Confluence バージョンが 2 バージョン以上古いものである場合、現在のバージョンと最新バージョンとの間のすべてのリリースのリリース ノートとアップグレード ガイドを確認します。
- インストール ディレクトリ、ホーム ディレクトリ、およびデータベースのバックアップを作成します。
- Confluence の最新バージョンをダウンロードします。
- 「アップグレード ガイド」の説明に従います。
アップグレード後の設定ファイルの更新
server.xml, web.xml
、setenv.bat
/setenv.sh
、confluenceinit.properties
などの設定ファイルの内容は定期的に変更されます。
アップグレード時には、以前のインストールのファイルで単純に上書きするのではなく、これらのファイルへの追加 (プロキシ設定、データソース、JVM パラメーターなど) を手動で再適用することをおすすめします。これを行わない場合、これまでの改善が失われてしまいます。