ほぼ満杯のホームサーバー向け Btrfs メタデータ復旧チェックリスト

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

安全に進めるには、書き込みの安定化、作業領域の回復、フィルターを適用したバランス調整のみの実行、通常のサービス再開前のデータ検証を、一つのコマンドではなく、結果を確認できる段階的なチェックポイントとして扱います。

容量がほぼいっぱいのBtrfsホームサーバーファイルシステムでは、メタデータ領域が枯渇してBtrfsがENOSPCを報告したり、読み取り専用になったりする実務上のリスクがあります。現在の状態と復旧ポイントを記録し、影響が最も少ない切り分けから始めてください。次の変数を変更する前に、成功・失敗の結果を判断し、ストレージが不安定になった場合や、唯一の復旧可能なコピーが危険にさらされる場合は中止してください。以下の手順は、元のワークロードが正常に動作するか、得られた証拠がエスカレーションの基準に達した場合にのみ終了します。

修復を試みる前にファイルシステムを安定させる

影響を受けているファイルシステムに書き込むコンテナ、ダウンロード、スナップショット、ログを大量に生成するジョブを停止してください。カーネルエラーとbtrfs device statsの出力を、別の場所に保存します。ファイルシステムが読み取り専用で再マウントされた場合、またはチェックサム、親トランザクションID、I/Oエラーが報告された場合は、復旧可能なコピーを確保するまで読み取り専用のままにしてください。

btrfs check --repair、全体のバランス調整、デフラグ、大量削除から始めてはいけません。まず確認すべきなのは、ファイルシステムの状態は正常なのに割り当て用の作業領域が不足しているのか、それともストレージエラーがメタデータを損傷させているのかという点です。先に修復すると、この違いを見極めにくくなり、残りの空き領域を消費するおそれがあります。

書き込みの多いサービスが停止しており、重要なデータの複製が別にあり、確認対象のブロックデバイスとマウントポイントが分かっている場合に、安全確認を通過できます。デバイスがリセットされたり、認識されなくなったり、読み取りエラーが増えたりした場合は、復旧用イメージの作成に切り替えてください。

見かけ上の空き容量ではなく、割り当て状況を確認する

btrfs filesystem usage -T /mount、btrfs filesystem df /mount、btrfs device usage /mountを実行し、最近のカーネルメッセージを確認します。割り当て済みと使用済みのメタデータ、および各デバイスで利用できる未割り当て領域を比較します。通常のdfだけでは、Btrfsがメタデータ用のチャンクをさらに割り当てられるかどうかは分かりません。

対象を絞ったバランス調整には、完全に未使用の作業領域が必要です。詳しいBtrfsの対象指定バランス調整ガイドでは、フィルターなしのバランス調整は対象となるすべてのブロックグループを書き換えること、そして大きなファイルを削除すればメタデータを拡張できると考えるのではなく、デバイス単位の未割り当て領域を確保することが目標だと説明しています。

メタデータの使用量が多くても未割り当て領域が残っている場合は、小規模なフィルター付きバランス処理で、空または使用率の低いチャンクを再利用できる可能性があります。どのデバイスにも作業領域がない場合は、安全に破棄できるデータやスナップショットを少量ずつ削除するか、ファイルシステムのプロファイルに適した一時デバイスを追加してください。完了できない再配置を開始しないでください。

影響を最小限に抑えて作業領域を確保する

まず、スナップショットに保持されていない、破棄可能なファイルを削除し、その後、本当に不要だと確認できたスナップショットだけを削除してください。小さな変更を加えるたびに同期し、使用量を再確認してください。バランス処理が妥当な場合は、btrfs balance start -dusage=0 -musage=0 /mount、または確認した割り当て状況に基づいて選んだ別の限定的なフィルターから始めてください。全体のバランス処理は避けてください。

Linuxのマニュアルにあるフィルター付きバランス処理の動作の説明によると、フィルターは再配置の範囲を限定します。また、バランス処理自体に作業領域が不足するとENOSPCが発生することがあります。btrfs balance statusとカーネルログを監視してください。再配置によってエラーが増える場合、デバイス障害を伴って停止する場合、または最後の安全余裕を使い切る場合は、処理をキャンセルして読み取り専用での復旧に戻してください。

各手順の間に測定せず、フィルター処理や削除を重ねて実行しないでください。メタデータに余裕があり、必要なデバイスに未割り当て領域があり、新たなENOSPCや強制的な読み取り専用への移行を起こさずに小規模な書き込みが完了すれば、復旧処理は成功です。

データを検証し、すぐに再発しないようにする

リスクの低いサービスを1つだけ再起動し、当初メタデータを使い果たしたワークロード(スナップショットの作成や、多数の小さなファイルの変更など)を再現してください。ワークロードの実行後と再起動後に、使用量とカーネルログを再確認してください。一度はマウントできても、通常の頻繁な変更で読み取り専用に戻るなら、復旧していません。

保持期間を変更する前に、ZimaSpaceの方法を使ってNASの容量がスナップショットとライブファイルのどちらに使われているかを切り分けてください。スナップショットが保持するエクステントがあると、削除しても効果がないように見えることがあります。一方、ライブ環境での小さなファイルの頻繁な変更はメタデータの負荷を高め続ける可能性があります。適切なポリシーは、測定で確認できた状態に応じて決まります。

ファイルシステムが書き込み可能な状態を保ち、デバイスの統計値の増加が止まり、代表的なファイルを復元できるかハッシュを正しく照合でき、同じ余裕が失われる前に監視アラートが発生することを確認してから、通常のサービスを再開してください。構造的なエラーが続く場合はBtrfsの復旧専門家にエスカレーションし、唯一のコピーに修復コマンドを繰り返し実行するのではなく、クローンを使って作業してください。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.