今日のひとこと Challange IT For Future

Fess 15.10からの切り戻しで復元するインデックスを指定する

Fess 読了 3分
目次
  1. Fessに必要なインデックスだけを復元する
  2. 旧版が読み込む設定も戻す
  3. 関連PR

Fess 15.10向けのアップグレードガイドに、切り戻し時のOpenSearchスナップショットの復元範囲が追記されました。対象は、アップグレード前にガイドに沿ってクラスター全体のスナップショットを取得し、15.8.0または15.9.0へ戻す場合です。ガイドのPRはマージ済みで、確認時点のFessの最新正式版は15.9.0です。

Fessに必要なインデックスだけを復元する

クラスター全体のスナップショットには、OpenSearch MLプラグインの .plugins-ml-config も入ります。復元時にインデックスを指定しないと、クラスターで既に開いている同名のインデックスと衝突し、復元が拒否されることがあります。

切り戻しでは、旧版の設定をバックアップから戻し、ガイドに沿って復元対象の既存Fessインデックスを処理してから、取得済みのアップグレード前のスナップショットを指定します。以下はガイドと同じく、接続先をローカルの検証用OpenSearch、リポジトリーを fess_backup、スナップショットを snapshot_1 とした例です。

curl -X POST 'http://localhost:9200/_snapshot/fess_backup/snapshot_1/_restore?wait_for_completion=true' \
  -H 'Content-Type: application/json' \
  -d '{"indices":"fess*,.fess*,configsync,.configsync*","include_global_state":false}'

indices でFessと設定同期用のインデックスに絞り、include_global_state を false にしてクラスター全体の設定を復元対象から外します。実環境では接続先・認証方法・インデックス名を構成に合わせて確認します。PRの復元試験はOpenSearch 3.8.0と3.9.0で実施されています。

旧版が読み込む設定も戻す

crawler.failure.url.status.codes の15.10同梱値は 404,403,410,401,5xx です。15.9.0の初期値は 404,403,410,401、15.8.0は 404,403,410 でした。切り戻した旧版が読む設定に 5xx が残っている場合は削除します。15.9以前は設定項目を数値として読み取るためです。復元後は旧版で管理画面を開き、既存文書を検索できることも確認します。

関連PR