Confluence Data Center 7.7 以降でインデックスの伝播に失敗する
プラットフォームについて: Data Center のみ - この記事は、Data Center プラットフォームのアトラシアン製品にのみ適用されます。
この KB は Data Center バージョンの製品用に作成されています。Data Center 固有ではない機能の Data Center KB は、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。サーバー*製品のサポートは 2024 年 2 月 15 日に終了しました。サーバー製品を利用している場合は、アトラシアンのサーバー製品のサポート終了のお知らせページにて移行オプションをご確認ください。
*Fisheye および Crucible は除く
問題
Confluence Data Center 7.7 以降で検索インデックスを再構築するときに、Confluence がクラスタ内の他のノードにインデックスを伝播しようとしたタイミングで次のエラーのいずれかが表示される。
ディスク領域が不足しています (ローカル ホーム)
ディスク領域が不足しています (共有ホーム)
共有ホームにアクセスできません
ローカル ホームに書き込めません
スクリーンショット: コンテンツのインデックス画面に表示されている伝播エラー
原因
クラスタ内で検索インデックスを再構築すると、Confluence は新しく構築されたインデックスのスナップショットを (再構築をトリガーしたノードから) 共有ホーム ディレクトリに保管し、そのスナップショットを、クラスタ内の他のノードに新しいインデックスを 1 つずつ伝播するために使います。既存のインデックス ファイルは、伝播が完了するまでは削除されません。
これは、Confluence の実行に使われているユーザー アカウントがローカル ホーム ディレクトリに書き込めなかったり、共有ホーム ディレクトリにアクセスできなかったり、インデックスの 2 つの完全なコピーに対応するための十分なディスク領域がなかったりする場合に失敗します。
ソリューション
まず、問題の根本原因を解決する必要があります。
- Confluence を実行するために使っているユーザー (専用の Confluence ユーザー) に、共有ホームとローカル ホーム ディレクトリにアクセスして書き込むための適切な権限があることを確認します。
- 共有ホームと各ローカル ホーム ディレクトリに、十分なディスク領域があることを確認します。インデックスの完全なコピーの少なくとも 2 つ分に対応できる、十分な領域が必要です。
次に、伝播を再試行します。以降の手順は、2 ノードのクラスタを利用していると見なしています。ノード 1 ではインデックスを正常に再構築できたが、ノード 2 への伝播に失敗しています。
伝播を再試行するには、次の手順を実行します。
- ノード 2 で、
<local-home>/journal
に移動してsystem-maintenance
ファイルを削除します。 - ノード 2 でConfluence を再起動するか、次の手順を実行します。
- ノード 2 で Confluence にアクセスします。
- Go to Administration menu , then General Configuration. > Cache Management.
- [すべてフラッシュ] を選択します。
10 秒後、Confluence はノード 2 へのスナップショットの伝播を試みます。
Confluence のインデックス復元機能では、インデックスの再構築プロセスで作成されたスナップショットの自動復元は行われない点にご注意ください。インデックスの復元は、ノードがクラスタから数日間外れていた場合に使用できるよう設計されており、ジャーナルで最新状態を保つことはできません。影響を受けるノードで Confluence を再起動しても、新しく再構築されたインデックスが復元されるわけではありません。