問題

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  > General Configuration > Cache Management.
  • [すべてフラッシュ] を選択します。  

10 秒後、Confluence はノード 2 へのスナップショットの伝播を試みます。  

Confluence のインデックス復元機能では、インデックスの再構築プロセスで作成されたスナップショットの自動復元は行われない点にご注意ください。インデックスの復元は、ノードがクラスタから数日間外れていた場合に使用できるよう設計されており、ジャーナルで最新状態を保つことはできません。影響を受けるノードで Confluence を再起動しても、新しく再構築されたインデックスが復元されるわけではありません。