Unofficial

Co zkontrolovat nejdřív, když fond úložiště nebo svazek na QNAP NAS není aktivní

Kontroly přes SSH v režimu pouze pro čtení ukážou, která vrstva zastavila fond. Závada může být v discích a RAID, v LVM, v metadatech tenkého fondu nebo v souborovém systému svazku.

Úložiště na QNAP NAS se systémem QTS má několik vrstev. Disky tvoří pole RAID. LVM umisťuje na pole tenký fond. Fond obsahuje svazky. Když některá z těchto vrstev selže, fond nebo svazek přestane fungovat.

Zkontrolujte vrstvy v níže uvedeném pořadí, od disků směrem nahoru. Každý krok uvádí příkazy, význam jejich výstupu a vrstvu, na kterou výstup odkazuje. Žádný z příkazů nemění RAID, LVM ani fond.

QTS s tenkým fondem LVM · příkazy přes SSH pod účtem admin · ověřeno s LVM Pool Repair 1.8

Svazek a souborový systém ext4ext4ext4 Metadata tenkého fondu tp1_tmetatp1 LVM vg1 · PV Disky a RAID md1
Čtyři vrstvy od disků směrem nahoru

Než cokoli změníte

  • Nic neměňte, dokud nezjistíte, ve které vrstvě je závada. Disky nevyjímejte ani nevyměňujte. Než spustíte opravu v QTS nebo přes SSH, přečtěte si následující kontroly.
  • Oprava úložiště může být nevratná. Před jakýmkoli zápisem do fondu si ověřte, že máte zálohu důležitých dat.
  • Protokoly a kopie ukládejte mimo kontrolovaný fond, na externí disk nebo na svazek v jiném fondu.
  • Žádná kontrola ani oprava nezaručuje obnovu vašich dat. Oprava poškozených rozsahů mapování neobnoví data, která v nich byla.
  • Tato stránka platí pro QTS s tenkým fondem LVM. QuTS hero používá ZFS. Tyto kontroly ani LVM Pool Repair pro tento systém neplatí.

Čtyři vrstvy od disků směrem nahoru

Každá vrstva funguje, jen když funguje vrstva pod ní. Kontroly proto začněte u disků. LVM Pool Repair také opravuje úložiště odspodu a zastaví se, pokud je závada v nižší vrstvě.

  1. Disky a RAID

    QTS spojuje diskové oddíly do polí RAID typu md. Datový fond využívá takové pole, například md1.

    cat /proc/mdstat
  2. LVM

    LVM používá každé pole, nebo zařízení DRBD na něm, jako fyzický svazek (PV). Fyzické svazky (PV) fondu tvoří skupinu svazků (VG), například vg1.

    pvs · vgs
  3. Metadata tenkého fondu

    Tenký fond, například tp1, ukládá metadata na vlastní zařízení tp1_tmeta. Metadata obsahují mapování každého bloku každého svazku ve fondu.

    lvs -a
  4. Svazek a souborový systém

    Každý svazek ve fondu je tenký svazek se souborovým systémem ext4. QTS svazek připojuje. Svazek obsahuje sdílené složky.

    dmesg

Kontrolujte v tomto pořadí

Přihlaste se k NAS přes SSH pod účtem admin. Spusťte příkazy pro daný krok a přečtěte si výstup. Pokračujte, jen pokud vrstva podle výstupu funguje správně.

  1. Přečtěte si protokol jádra

    Protokol jádra zobrazuje chyby disků a zprávy zařízení device-mapper daného fondu.

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

    Chyby vstupu a výstupu na discích pod fondem ukazují na problém s diskem. Než začnete zkoumat vyšší vrstvy, otestujte příslušný disk.

  2. Zkontrolujte RAID

    /proc/mdstat vypisuje všechna pole md, jejich stav a členy. md_checker vypisuje datová pole a stav každého disku.

    cat /proc/mdstat
    md_checker

    Pole označené jako inactive znamená problém s RAID. Při stavu [4/3] chybí jeden ze 4 členů a pole běží v degradovaném režimu. Stav recovery, resync, reshape nebo check znamená, že na poli probíhá operace.

  3. Zkontrolujte LVM

    pvs vypisuje fyzické svazky, vgs skupiny svazků a lvs -a fond a jeho svazky.

    pvs
    vgs
    lvs -a

    Pokud je ve výstupu pvs na třetí pozici pole Attr znak m (a-m), LVM označuje fyzický svazek jako chybějící. Fyzický svazek (PV) označený jako unknown device v systému neexistuje. Pokud lvs -a nezobrazuje žádný tenký fond, závada je pod metadaty, v RAID nebo v LVM.

  4. Přečtěte si řádek fondu ve výstupu lvs -a

    Pole Attr fondu začíná znakem t. Devátý znak udává stav fondu podle LVM.

    M
    metadata jsou jen pro čtení
    F
    fond selhal
    D
    ve fondu došlo místo pro data
    p
    částečný stav, chybí fyzický svazek fondu

    Pole Attr svazku začíná znakem V. Znak a na páté pozici znamená, že je svazek aktivní.

    Pokud se ve výstupu LVM nebo v protokolu jádra objeví některá z těchto zpráv, zpráva označuje příslušnou vrstvu.

    Refusing activation of partial LV
    chybí fyzický svazek, problém je ve vrstvě LVM
    transaction_id
    záznam o fondu v LVM neodpovídá metadatům fondu, problém je v konfiguraci LVM
    Check of thin pool … failed
    metadata fondu
    too small for target
    pole RAID je menší než svazky na něm, problém je ve vrstvě RAID
  5. Diagnostikujte metadata, když je fond offline

    Diagnózu metadat poskytuje pouze thin_check spuštěný na fondu v režimu offline. Přepnutí fondu do režimu offline mění jeho stav, a proto patří mezi kroky nástroje LVM Pool Repair. Krok 2 přepne fond do režimu offline a krok 1 spustí kontrolu. Pokud je fond stále aktivní, krok 1 nabízí předběžnou kontrolu v režimu pouze pro čtení.

    $ 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)
    Podívejte se na skutečné opravy →
  6. Zkontrolujte souborový systém svazku, který se nepřipojuje

    Pokud lvs -a ukazuje, že fond a jeho svazky jsou aktivní, ale některý svazek se stále nepřipojuje, zkontrolujte jeho souborový systém.

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

    Chyby EXT4-fs ukazují na souborový systém svazku. V QTS jej kontroluje a opravuje funkce Check File System. Spusťte ji až po přečtení předchozích kontrol.

Co znamená výsledek kontroly

Každá karta uvádí výsledek kontroly, vrstvu, na kterou výsledek ukazuje, a postup nástroje LVM Pool Repair 1.8 v daném případě.

Disky a RAID

  • inactive

    Pole md pod fondem je neaktivní. Problém je v RAID.

    Skript opravu nespustí. Vyzve vás, abyste nejprve opravili RAID.

  • [4/3] [UUU_]

    Pole funguje, ale chybí člen nebo probíhá obnova pole, opětovná synchronizace, změna uspořádání či kontrola.

    Skript před zápisem do fondu požádá o potvrzení. Výchozí odpověď je ne. Pokud probíhá obnova pole, počkejte, až skončí.

  • I/O error

    Protokol jádra hlásí chyby vstupu a výstupu na discích pod fondem nebo chyby paměti.

    Skript před zápisem požádá o potvrzení. Výchozí odpověď je ne. Nejprve otestujte disky pomocí DriveTime a paměť RAM pomocí MemHound.

LVM

  • a-m

    LVM označuje fyzický svazek fondu jako chybějící nebo jej zobrazuje jako unknown device. Aktivace se zastaví se zprávou Refusing activation of partial LV.

    Skript se zastaví. Problém je ve vrstvě LVM. Metadata fondu nejsou příčinou. U hlášení unknown device vás skript odkáže zpět na vrstvu RAID.

  • No thin pool found

    lvs -a nezobrazuje žádný tenký fond. Závada je pod metadaty fondu.

    Skript se zastaví a uvede příkazy pro kontrolu RAID a LVM v režimu pouze pro čtení. Jde o cat /proc/mdstat, md_checker, mdadm -E /dev/sdX3, pvs, vgs, lvs -a.

Metadata tenkého fondu

  • SSD cache

    Fond používá mezipaměť SSD pro čtení a zápis nebo jen pro zápis, případně Qtier ukládá data na dvou nebo více úrovních úložiště.

    Skript se zastaví před provedením jakékoli změny a odkáže vás na podporu QNAP. Pokud je mezipaměť SSD jen pro čtení, nejdřív se zeptá, zda je odebraná nebo vypnutá pro tento fond.

  • thin_check

    LVM hlásí Check of thin pool … failed nebo thin_check najde chyby v metadatech fondu.

    LVM Pool Repair je určený pro tento případ. Následující část uvádí tři typy poškození.

  • metadata consistent

    thin_check nenajde v metadatech žádné chyby.

    Pokud je nastavený jen příznak needs_check, skript ho zruší. S tímto příznakem se fond spouští s metadaty jen pro čtení. Jinak je závada nad fondem v souborovém systému nebo pod fondem v RAID či LVM.

Když jsou příčinou metadata tenkého fondu

LVM Pool Repair je shellový skript s nabídkou. Přes SSH opravuje metadata tenkého fondu QNAP v systému QTS. Diagnostika rozlišuje tři typy poškození. Pro každý používá vlastní postup opravy.

  • space map counts only

    Chyby jsou pouze v čítačích mapy prostoru. Mapovací stromy jsou neporušené. Skript vytvoří opravenou kopii, zkontroluje ji a po zadání YES ji zapíše do fondu.

  • damaged superblock

    Primární superblok je poškozený a existují jeho platné záložní kopie. Po zadání YES skript obnoví superblok z nejnovější platné kopie.

  • mapping tree errors

    Části stromu, který mapuje bloky svazku, jsou poškozené. Fond používá opravenou kopii ke zkušebnímu připojení v režimu pouze pro čtení. Zkontrolujte svá data dřív, než skript kopii zapíše. Po zápisu se bloky z vyřazených rozsahů čtou jako prázdné.

Než oprava zapíše změny do původních metadat, skript uloží jejich obraz a ověří ho porovnáním se zařízením. Test používá 600 souborů o velikosti 4 MiB na svazku s poškozeným mapováním. Po opravě zůstává 534 souborů neporušených. Zbývajících 66 souborů má data ve vyřazených rozsazích a při opravě se mění.

=== 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)