名前を変更したデータセットと安定したファイルハンドルのためのNFS移行チェックリスト

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

安全に進めるには、クライアントから見える名前空間を可能な限り維持し、ハンドルIDが変わる場合は意図的にクライアントを再マウントする、停止状態でのエクスポート移行を、一つのコマンドではなく、結果を確認できる複数の段階として扱います。

ホームサーバークライアントが使用するNASデータセットをLinux NFSサーバーで移行する際に現実的なリスクとなるのは、エクスポートされたデータセットの名前変更や移動によって、クライアントで古いNFSファイルハンドルが発生したり、再マウントに失敗したりすることです。現在のIDと復旧ポイントを記録し、最も影響の少ない判別方法から始め、別の変数を変更する前に合否の結果を解釈し、ストレージが不安定になった場合や、復旧可能な唯一のコピーが危険にさらされる場合は中止してください。以下の手順は、元のワークロードが正常に動作するか、証拠がエスカレーションの判断基準に達した時点でのみ完了とします。

エクスポートとファイルハンドルの依存関係を調査する

移行を計画する前に、移行元のファイルシステムまたはデータセットのID、サーバー側のパス、NFSv4の疑似ルート、エクスポートオプション、明示的に指定したfsid値、クライアントのマウントパス、autofsまたはsystemdのユニット、マウントを使用するすべてのコンテナやアプリケーションを記録します。ダウンタイムを計画する前に、アクティブなマウントと開いているファイルを記録してください。

NFSのファイルハンドルには、サーバーが選択したオブジェクトIDが含まれるため、パス文字列が変わらなくても、ファイルシステムの移動後にハンドルが維持されるとは限りません。独立したNFSの「stale file handle」が発生する仕組みでは、ディレクトリが見えていても、エクスポートの削除、再作成、再マッピングによって古いハンドルが発生する仕組みを説明しています。

目標が名前空間の安定性か、稼働中のハンドルの継続性かを決めます。クライアントから見えるパスを維持すれば設定変更を減らせますが、データを別のファイルシステムに移す場合は、すべてのクライアントでアンマウントして新しいハンドルを取得する必要があることもあります。

クライアントが移行元を使用している間に移行先を準備する

移行先のデータセットを作成し、ACL、所有者、拡張属性、ハードリンク、スパースファイル、タイムスタンプを保持したままデータをコピーして、件数と代表的なハッシュ値を比較します。移行先を本番クライアントに公開する前に、エクスポートのセキュリティ設定とIDマッピングを一致させてください。

Linuxサーバー間でNFSv4のIDを一致させるには、ZimaSpaceガイドのNFSv4 IDマッピングガイドを参照してください。安定したファイルハンドルだけでは、数値による所有権や名前ドメインの不一致は解決しません。ファイルID層とユーザーID層をそれぞれ個別に検証してください。

コピー方法が対応している場合に限り、ソースが稼働中に初回同期を行い、その後、停止して差分を最終同期する計画を立てます。同じクライアント名前空間で両方のコピーを読み書き可能な状態でエクスポートしないでください。明らかなエラーがないまま書き込み内容が分岐するおそれがあります。

クライアントの処理を停止してエクスポートを切り替える

すべてのクライアントでアプリケーションの書き込み処理、コンテナ、スケジュール済みジョブを停止し、マウント配下のファイルを重要なプロセスが開いていないことを確認します。クライアントを正常にアンマウントします。最後の同期後、ソースのエクスポートを解除するか読み取り専用にし、サーバー側のマウントまたはエクスポートをターゲットに切り替えて、エクスポートを再読み込みします。

GitLabのエンジニアリングに関するNFSの名前変更と古い状態の事例では、名前変更と委譲の動作によって、クライアント側で古い情報や一貫性のない情報が観測されることがあると示されています。安全な運用対応は、アプリケーションが書き込みを続ける中でキャッシュクリアコマンドを繰り返すことではなく、計画的に処理を停止して再マウントすることです。

ターゲットのファイルシステム識別情報が変わる場合は、新しいハンドルが生成されるため、クライアントを改めてマウントしてください。元のエクスポートは、本番環境以外の復旧用の名前で利用できる状態にしておきます。ただし、古いツリーと新しいツリーの両方で書き込みを受け付けないでください。

すべてのクライアントを再マウントし、新しい識別情報を確認する

まずカナリアクライアントを1台再マウントし、一覧表示、読み取り、作成、名前変更、削除、ファイルロック、所有権をテストします。依存するアプリケーションを再起動し、元のワークロードを確認します。その後、残りのクライアントを順次切り替え、マウント元、NFSバージョン、stale handleエラーがないことを記録します。

カナリアクライアントを再起動するか、オートマウントを再起動し、永続的な設定がクライアント向けの安定した名前空間を参照していることを確認します。サーバーログ、クライアントのカーネル、バックアップジョブ、コンテナを調べ、隠れた古いパスがないか確認してください。手動マウントに成功しても、起動順序やサービスの依存関係が正しいとは限りません。

すべてのクライアントの再マウント、通常ジョブの成功、バックアップの成功、復元テストの完了を確認してから、ソースを廃止します。カナリアテストに失敗した場合は、新しい書き込みを受け付ける前にロールバックしてください。ターゲットへの書き込みを開始した後は、エクスポートを何度も切り替えず、停止して慎重に整合性を取り直してください。

サポートとヒント

続きを読む

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.