Unofficial

QNAP のストレージプールまたはボリュームが非アクティブなとき、最初に確認すること

SSH 経由の読み取り専用チェックで、どの層が原因でプールが停止したかを確認できます。対象はディスクと RAID、LVM、シンプールのメタデータ、ボリュームのファイルシステムです。

QTS を搭載した QNAP NAS のストレージは、複数の層で構成されます。ディスクで RAID アレイを構成します。LVM はそのアレイ上にシンプールを配置します。プールにはボリュームが含まれます。いずれかの層に障害が発生すると、プールまたはボリュームが停止します。

ディスクから順に、以下の手順で各層を確認してください。各手順では、コマンド、出力の意味、出力が示す層を説明します。どのコマンドも RAID、LVM、プールを変更しません。

LVM シンプールを使用する QTS · admin として SSH 経由で実行するコマンド · LVM Pool Repair 1.8 で確認済み

ボリュームとファイルシステム ext4ext4ext4 シンプールのメタデータ tp1_tmetatp1 LVM vg1 · PV ディスクと RAID md1
ディスクを最下層とする四つの層

変更を加える前に

  • どの層に障害があるか分かるまでは、何も変更しないでください。ディスクを取り外したり交換したりしないでください。以下の確認手順を読むまでは、QTS や SSH 経由で修復を開始しないでください。
  • ストレージの修復は元に戻せないことがあります。プールに書き込む前に、重要なデータのバックアップがあることを確認してください。
  • ログとコピーは、確認対象のプールの外に保存してください。外付けディスクや別のプールのボリュームを使います。
  • どの確認や修復でも、データを取り戻せる保証はありません。破損したマッピング範囲を修復しても、その範囲にあったデータは復元できません。
  • このページは、LVM シンプールを使用する QTS が対象です。QuTS hero は ZFS を使用します。ここで説明する確認手順と LVM Pool Repair は適用できません。

ディスクを最下層とする四つの層

各層が動作するには、その下の層が動作している必要があります。そのため、ディスクから確認します。LVM Pool Repair も下位層からストレージを修復し、下位層に障害があると停止します。

  1. ディスクと RAID

    QTS はディスクのパーティションをまとめて md RAID アレイを構成します。データプールは、たとえば md1 のようなアレイ上にあります。

    cat /proc/mdstat
  2. LVM

    LVM は各アレイ、またはその上の DRBD デバイスを物理ボリューム(PV)として使用します。プールの PV は、たとえば vg1 のようなボリュームグループ(VG)を構成します。

    pvs · vgs
  3. シンプールのメタデータ

    tp1 などのシンプールは、専用のデバイス tp1_tmeta にメタデータを保存します。メタデータは、プール内の各ボリュームのすべてのブロックの対応関係を記録します。

    lvs -a
  4. ボリュームとファイルシステム

    プール内の各ボリュームは、ext4 ファイルシステムを備えたシンボリュームです。QTS がボリュームをマウントします。共有フォルダーはボリューム上にあります。

    dmesg

この順序で確認

SSH 経由で admin として NAS にログインします。各手順のコマンドを実行し、出力を読みます。その層に問題が見当たらない場合にだけ、次の手順に進みます。

  1. カーネルログを読む

    カーネルログには、ディスクエラーやプールの device-mapper デバイスからのメッセージが表示されます。

    dmesg | grep -iE 'device-mapper|thin|I/O error' | tail -n 12

    プールを構成するディスクの I/O エラーは、ディスクの問題を示します。上位層を調べる前に、そのディスクをテストします。

  2. RAID を確認する

    /proc/mdstat は各 md アレイと、その状態およびメンバーを一覧表示します。md_checker はデータ用のアレイと、各ディスクの状態を一覧表示します。

    cat /proc/mdstat
    md_checker

    アレイに inactive と表示される場合は、RAID に問題があります。[4/3] は、4 台のうち一台が欠落し、アレイが縮退状態で動作していることを示します。recovery、resync、reshape、check のいずれかが表示される場合、アレイは処理中です。

  3. LVM を確認する

    pvs は物理ボリュームを、vgs はボリュームグループを、lvs -a はプールとそのボリュームを一覧表示します。

    pvs
    vgs
    lvs -a

    pvs の Attr の三文字目に m がある場合(a-m)、LVM はその物理ボリュームを欠落として扱います。unknown device と表示される PV は、システム上に存在しません。lvs -a にシンプールがまったく表示されない場合、問題はメタデータより下の RAID または LVM にあります。

  4. lvs -a でプールの行を読む

    プールの Attr は t で始まります。九文字目は、LVM が報告する正常性の状態を示します。

    M
    メタデータは読み取り専用です
    F
    プールに障害が発生しています
    D
    プールのデータ領域に空きがありません
    p
    部分状態です。プールの物理ボリュームが欠落しています

    ボリュームの Attr は V で始まります。五文字目が a なら、ボリュームはアクティブです。

    LVM の出力やカーネルログに次のメッセージがある場合、そのメッセージが問題のある層を示します。

    Refusing activation of partial LV
    物理ボリュームが欠落しています。問題は LVM 層にあります
    transaction_id
    LVM が保持するプールの情報がプールのメタデータと一致しません。問題は LVM の構成にあります
    Check of thin pool … failed
    プールのメタデータ
    too small for target
    RAID アレイの容量が、その上にあるボリュームより小さい状態です。問題は RAID 層にあります
  5. プールがオフラインの状態でメタデータを診断する

    オフラインのプールで thin_check を実行した場合に限り、メタデータを診断できます。プールをオフラインにすると状態が変わるため、この操作は LVM Pool Repair の手順に含まれます。手順 2 でプールをオフラインにし、手順 1 でチェックを実行します。プールがまだアクティブな場合、手順 1 で読み取り専用の事前チェックを実行できます。

    $ pdata_tools_8192 thin_check /dev/mapper/vg1-tp1_tmeta
    examining superblock
    examining superblock backups
      99 valid superblock backups, last backup_id=98 blocknr=8388509
    examining devices tree
    examining mapping tree
      thin device 9 is missing mappings [1470, 1725]
        bad checksum in btree node (block 21996)
      thin device 9 is missing mappings [3285, 3540]
        bad checksum in btree node (block 22007)
      thin device 9 has unexpected number of mapped blocks
        expected 5730 != actual 5220
    examining clone tree
    examining tiering tree
    examining tiering space maps
        -> exit code 1   (in: do_diag > thin_check_run)
    実際の修復を見る →
  6. マウントできないボリュームのファイルシステムを確認する

    lvs -a でプールと各ボリュームがアクティブと表示されても、マウントできないボリュームがある場合は、そのファイルシステムを調べます。

    dmesg | grep -iE 'EXT4-fs (error|warning)'

    EXT4-fs のエラーは、ボリュームのファイルシステムに問題があることを示します。QTS の Check File System は、ファイルシステムをチェックして修復します。上記の確認手順を読んでから実行してください。

確認結果の意味

各カードには、確認結果、その結果が示す層、その場合の LVM Pool Repair 1.8 の動作を記載しています。

ディスクと RAID

  • inactive

    プールの下にある md アレイが非アクティブです。RAID に問題があります。

    スクリプトは修復を開始しません。先に RAID を修復するよう表示します。

  • [4/3] [UUU_]

    アレイは動作していますが、メンバーが欠落しているか、再構築、再同期、構成変更、チェックのいずれかが進行中です。

    スクリプトはプールに書き込む前に確認を求めます。既定の回答は「いいえ」です。再構築が進行中の場合は先に完了を待ちます。

  • I/O error

    カーネルログに、プールを構成するディスクの I/O エラーやメモリーエラーが記録されています。

    スクリプトは書き込む前に確認を求めます。既定の回答は「いいえ」です。先に DriveTime でディスクを、MemHound で RAM をテストします。

LVM

  • a-m

    LVM がプールの物理ボリュームを欠落として扱うか、unknown device と表示します。Refusing activation of partial LV が表示され、アクティブ化が停止します。

    スクリプトは停止します。問題は LVM 層にあり、プールのメタデータに起因するものではありません。unknown device の場合は、RAID 層を確認するよう表示します。

  • No thin pool found

    lvs -a にシンプールが表示されません。問題はプールのメタデータより下の層にあります。

    スクリプトは停止し、RAID と LVM の読み取り専用チェックを示します。cat /proc/mdstat、md_checker、mdadm -E /dev/sdX3、pvs、vgs、lvs -a です。

シンプールのメタデータ

  • SSD cache

    プールが読み書き用または書き込み専用の SSD キャッシュを使用しているか、Qtier が二つ以上のストレージ階層にデータを保存しています。

    スクリプトは変更を加える前に停止し、QNAP サポートを案内します。読み取り専用の SSD キャッシュを使用している場合は、キャッシュを取り外したか、このプールで無効にしたかを先に尋ねます。

  • thin_check

    LVM が Check of thin pool … failed を報告するか、thin_check がプールのメタデータのエラーを検出します。

    LVM Pool Repair はこの場合に使用します。次のセクションで三種類の破損を説明します。

  • metadata consistent

    thin_check はメタデータのエラーを検出しません。

    needs_check フラグだけが設定されている場合、スクリプトはそのフラグを解除します。このフラグが設定されていると、メタデータが読み取り専用の状態でプールが起動します。それ以外の場合、問題はプールより上のファイルシステムか、下の RAID または LVM にあります。

シンプールのメタデータが原因の場合

LVM Pool Repair は、メニューを備えたシェルスクリプトです。SSH 経由で、QTS 上の QNAP シンプールのメタデータを修復します。診断では破損を三種類に分類し、それぞれに応じた手順で修復します。

  • space map counts only

    エラーはスペースマップのカウント値だけにあり、マッピングツリーは破損していません。スクリプトは修復済みのコピーを作成してチェックし、YES と入力するとプールに書き込みます。

  • damaged superblock

    プライマリスーパーブロックが破損していますが、有効なバックアップコピーがあります。YES と入力すると、スクリプトは最新の有効なコピーからスーパーブロックを復元します。

  • mapping tree errors

    ボリュームのブロックを対応付けるツリーの一部が破損しています。プールは修復済みのコピーを使い、読み取り専用でテストマウントします。スクリプトがコピーを書き込む前に、データを確認します。書き込み後は、削除された範囲のブロックを読み取ると空のデータが返ります。

修復で元のメタデータに書き込む前に、スクリプトはメタデータのイメージを保存し、デバイスと照合します。マッピングが破損したボリュームで 4 MiB のファイル 600 個を使ったテストでは、修復後も 534 個のファイルに変更はありません。削除された範囲にデータを持つ 66 個のファイルは変化します。

=== QNAP pool repair 1.7 | TBS-h574TX | kernel 6.6.129-qnap | NAS-DEMO =======
 Pool: vg1/tp1   metadata: tp1_tmeta (65536 MiB)   scratch LV: lv544
 RAID: md1 raid1 [2/2] OK
 Work directory: /share/external/DEV3302_1/pool-recovery-..-tp1-20261120-132957
 Diagnosis: -   Tool: (detected at diagnosis)
 Stage: start   Path: -
 Steps: 1 Diag -- | 2 Offline next | 3 Backup -- | 4 Repair -- | 5 Start --
------------------------------------------------------------------------------
 [Enter] recommended step: 2) Offline
  a) Automatic run: the remaining steps; stops for decisions and before a write
  1) Status and diagnosis (thin_check, read-only)
  2) Prepare: stop the services, unmount, deactivate the VG
  3) Backup: LVM configuration + metadata image
  4) Repair the metadata
  5) Bring the pool and the volumes up
  6) Tools (tp_collect, undo the LVM swap, restore the backup...)
  7) Logs and history (command history, pager, before/after diff, report)