LVM Pool Repair: skript pro opravu metadat tenkého fondu úložiště QNAP
Tento skript shellu s nabídkou opravuje přes SSH metadata tenkého fondu úložiště QNAP v systému QTS.
Oprava probíhá v pěti krocích. Skript provede diagnostiku, připraví fond, vytvoří zálohu, opraví metadata a znovu zprovozní fond a svazky.
Stisknutím klávesy Enter v nabídce spustíte další krok doporučený skriptem. Pokud se relace SSH přeruší nebo se NAS restartuje, můžete pokračovat ve stejné relaci opravy.
- 5kroků v nabídce v pořadí, v jakém probíhá oprava
- 3typy poškození metadat, každý s vlastním postupem opravy
- YESslovo, které zadáte, než oprava přepíše metadata fondu
Záznamy běhu skriptu
Každý záznam zachycuje skutečnou relaci SSH se skriptem verze 1.7 na NASu QNAP v terminálu o rozměrech 80 na 25 znaků. Verze 1.8 přidává na tyto obrazovky jednu část s kontrolou RAID a disků v režimu pouze pro čtení před zobrazením nabídky a na začátku kroku 1. Záměrně jsme poškodili metadata fondu na známých místech a uschovali původní bloky. Poškozená metadata jsme zapsali po kroku 2, když byl fond offline. Záznamy tuto přestávku vynechávají. Po kroku 2 skript pokračuje v diagnostice ve stejné relaci. Dlouhé prodlevy jsou v záznamech zkrácené. Jejich skutečná délka závisí na velikosti fondu a jeho snímcích.
░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀ Mounted: /share/CACHEDEV2_DATA /share/CACHEDEV1_DATA /mnt/pool1 (and 12 mounts of apps and containers on these volumes) [auto] Data reachable - finish the repair session? -> y [ OK ] Report: /share/external/DEV3302_1/pool-recovery-NAS-DEMO-vg1-tp1-20261121-010858/report.txt [ OK ] Log package: /share/external/DEV3302_1/pool-recovery-NAS-DEMO-vg1-tp1-20261121-010858/logs-20261121-012354.tgz Look through it before sending: it holds the host name, the device layout, directory listings of the test mount and, in debug mode, the shell trace. The metadata image is not in it. [ OK ] Session finished. Keep the copy of the original metadata: /share/external/DEV3302_1/pool-recovery-NAS-DEMO-vg1-tp1-20261121-010858/tmeta.raw Pool vg1/tp1 is back online with all its volumes mounted. Let's rock. [ OK ] Nothing left to do. Press Enter to return to the menu.
cd /mnt/HDA_ROOT. Krok 2 přepne fond do stavu offline. Zatímco skript čeká v nabídce, nastavíme u jedné položky mapy využití prostoru metadat chybnou hodnotu. Pak a spustí automatický režim. Skript provede diagnostiku, uloží obraz metadat, opraví fond a znovu zprovozní fond, svazky a aplikace. Zastaví se jen jednou. Před zápisem do fondu počká na zadání YES.Jedna položka mapy využití prostoru metadat má chybnou hodnotu. Skript zastaví služby, uloží ověřený obraz metadat, vytvoří opravenou kopii a zkontroluje ji. Po zadání YES kopii zapíše do fondu. Krok 5 znovu zprovozní fond, svazky a aplikace.Primární superblok je poškozený a jeho záložní kopie jsou platné. Skript čte metadata prostřednictvím nejnovější kopie. Po zadání YES skript obnoví superblok z této kopie, zkontroluje metadata a znovu zprovozní fond.Dva listy mapovacího stromu testovacího svazku jsou poškozené. Fond používá opravenou kopii pro zkušební připojení pouze pro čtení. Při zkušebním připojení se čtou soubory. Po potvrzení dat a zadání YES skript zapíše kopii do fondu. Zkontroluje souborový systém testovacího svazku, než ho QTS připojí. Závěrečné ověření kontrolních součtů 600 testovacích souborů ukázalo, že 534 souborů zůstalo neporušených a 66 se změnilo.Poškození je stejné. NAS se restartuje během zkušebního připojení pouze pro čtení. Po restartu zůstane fond offline, protože skript před zkouškou nastavil příznak skip-activation. Po novém přihlášení přes SSH skript spustíme znovu. Skript najde nedokončenou relaci a dokončí opravu.Stáhnout skript
Ke stažení skriptu potřebujete PIN. Zadejte PIN a zobrazí se odkaz ke stažení.
cd /
sudo -i
# quit console if displayed
cd /mnt/HDA_ROOT
wget --no-check-certificate https://pub.qnaputilities.com/pool-repair/qnap-pool-repair-1.8.sh
chmod +x qnap-pool-repair-1.8.sh
sh qnap-pool-repair-1.8.shSpuštění skriptu
Skript běží přímo na NASu. Vyžaduje účet admin, protože QTS nemá sudo.
- Přihlaste se k NASu přes SSH pod účtem admin.
- Přejděte do složky se skriptem. Složka musí být mimo fond, který opravujete.
- Spusťte skript prvním příkazem níže.
- Zvolte pracovní adresář mimo fond. Bez něj může skript provést diagnostiku, ale v kroku 3 nemůže uložit obraz metadat.
# spustit skript a zobrazit nabídku sh qnap-pool-repair.sh # vrátit se do relace po přerušení spojení screen -r qnap-pool-repair
Oprava úložiště může být nevratná. Než skript cokoli zapíše, ověřte, že máte zálohu důležitých dat a že výsledek diagnostiky odpovídá stavu vašeho NASu.
Volby
--auto- Spustí automatický běh po detekci fondu. Kroky 1 až 5 proběhnou po sobě. Automatický běh vyžaduje pracovní adresář.
--debug- Zobrazí trasování volání a každý příkaz orámuje. Zapíše úplný záznam trasování shellu do
trace.log. K tomu potřebuje pracovní adresář. --no-screen- Spustí skript bez relace
screen. --selftest- V režimu pouze pro čtení zkontroluje příkazy, které skript používá, a ukončí se.
--raid-check- V režimu pouze pro čtení zkontroluje pole RAID, jejich členy a podpisy QNAP na discích a ukončí se. Nepotřebuje žádný fond.
--allow-no-backup- Pouze pro nouzové případy. Umožní potvrdit rychlý nebo úplný postup bez obrazu metadat. Zadejte
NO-BACKUPa poté název fondu přesně tak, jak ho zobrazuje skript, napříkladvg1/tp1. Automatický běh tuto volbu nepoužívá. --help- Vypíše volby.
--version- Vypíše verzi.
Pět kroků
Před zobrazením nabídky skript zobrazí červené upozornění WARNING a ověří, že je na NASu dostupných všech 79 příkazů, které používá. V nové relaci pak v režimu pouze pro čtení zkontroluje pole RAID a jejich disky. Nabídka zobrazuje kroky v pořadí opravy a uvádí stav každého z nich. Klávesou Enter spustíte doporučený krok. Při automatickém běhu skript provede všechny zbývající kroky po sobě. U otázek s bezpečnou výchozí odpovědí použije tuto odpověď. Skript se vás i nadále ptá na používané svazky a na data při zkušebním připojení. Také vás vyzve k zadání YES.
Status and diagnosis
Skript zkontroluje pole RAID a hardware. Pokud je fond offline, spustí nad jeho metadaty
pouze pro čteníthin_check. Pokud je fond stále aktivní, nabídne předběžnou kontrolu pouze pro čtení.Prepare
Skript odpojí svazky fondu a deaktivuje skupinu svazků. V šetrném režimu odpojí jen to, co patří k tomuto fondu. Služby zastaví, jen pokud se některý prostředek stále používá.
fond je offlineBackup
Skript uloží konfiguraci LVM a zapíše obraz metadat do pracovního adresáře. Obraz přijme až po ověření, že odpovídá zařízení.
ověřený obrazRepair the metadata
Skript nabídne postup opravy odpovídající výsledku diagnostiky. Než oprava přepíše původní metadata, zadejte
zadání YESYES.Bring the pool and the volumes up
Skript aktivuje fond. QTS připojí svazky a skript každý z nich porovná s dříve uloženým seznamem. Nabídne spuštění služeb, které zastavil. Jakmile jsou všechny svazky znovu dostupné, zobrazí LOOKS GOOD, zapíše zprávu a zabalí protokoly.
zpráva a protokoly
Výsledky diagnostiky
Krok 1 zobrazí výsledek příkazu thin_check jako jedno z hlášení skriptu. Krok 4 poté nabídne postup opravy pro daný výsledek.
- space map counts only
Chyby jsou pouze v počítadlech mapy využití prostoru. Mapovací stromy jsou neporušené.
Rychlý postup. Skript vytvoří opravenou kopii na vyhrazeném svazku a zkontroluje ji. Po zadání
YESzapíše kopii do fondu. - damaged superblock
Primární superblok je poškozený. Skript v metadatech najde jeho platné záložní kopie.
Skript načte metadata pomocí nejnovější platné kopie. Po zadání
YESz této kopie obnoví superblok a zopakuje diagnostiku. - mapping tree errors
Části stromu, který mapuje bloky svazku, jsou poškozené. Oprava tyto rozsahy z mapování odstraní. Při následném čtení se jejich bloky jeví jako prázdné.
Úplný postup. Fond používá opravenou kopii pro zkušební připojení pouze pro čtení. Prohlédněte si data a potvrďte, že jsou v pořádku. Po zadání
YESskript zapíše kopii do fondu. - data NOT OK
Při zkušebním připojení uvedete, že data nejsou v pořádku. Skript obnoví původní konfiguraci LVM. Původní metadata zůstanou beze změny.
Obraťte se na podporu QNAP a přiložte balíček protokolů z nabídky 7 a balíček
tp_collectz nabídky Tools.
Nerozpoznaný výsledek skript vyhodnotí jako poškození mapování. Při poškození mapy využití prostoru nabídne i dva postupy, které zapisují přímo do původních metadat. Jsou to legacy (thin_dump a thin_restore) a rebuild (thin_rebuild od QNAP). Oba vyžadují ověřený obraz a zadání YES. Pokud fond nemá vyhrazený svazek pro kopii, lze poškozené mapování opravit pouze postupem legacy. Vyberete jej zadáním LEGACY.
Bezpečnostní pravidla
- Oprava zapisuje do původních metadat až poté, co krok 3 poskytne ověřený obraz. Surový obraz musí mít stejnou velikost jako zařízení a stejný výsledek kontroly
thin_check. Komprimovaný obraz skript porovná se zařízením bajt po bajtu. - Než oprava přepíše původní metadata, zadejte
YES. Jakákoli jiná odpověď zápis zruší. - Před zápisem skript prohledá protokol jádra a hledá hlášení o chybách paměti a chyby vstupu a výstupu na discích fondu. Pokud najde chybu, zeptá se, zda chcete pokračovat. Výchozí odpověď je „ne“.
- Skript nespustí opravu na neaktivním poli RAID. Pokud je pole v degradovaném stavu nebo probíhá rekonstrukce, opětovná synchronizace, změna rozložení nebo kontrola, skript se nejprve zeptá. Výchozí odpověď je „ne“.
- Po opravě poškozeného mapování nabídne krok 5 kontrolu souborového systému dotčených svazků v režimu pouze pro čtení (
e2fsck -fn), než svazky připojí. Pokud kontrola najde chyby, zvoltee2fsck -fpneboe2fsck -fy, který se spustí po zadáníFSCK. Můžete také později použít Check File System v QTS. - Pracovní adresář s protokoly a obrazem metadat musí být mimo fond, na externím disku nebo na svazku jiného fondu. Skript nepřijme složku na opravovaném fondu.
- Skript běží v
screena pokračuje i po přerušení relace SSH. Do relace se vrátíte opětovným spuštěním skriptu. - Stav relace je uložený mimo fond na systémovém oddílu NASu (md9). Po restartu skript najde nedokončenou relaci a zeptá se, zda v ní chcete pokračovat.
- Při zkušebním připojení nasměruje LVM fond na opravenou kopii. Skupina svazků má po tuto dobu nastavený příznak skip-activation. Po restartu NASu proto fond zůstane offline.
- Tato pravidla mají dvě výjimky. Pokud jsou metadata konzistentní a je nastavený pouze příznak
needs_check, skript tento příznak odstraní bez obrazu, bez kontroly hardwaru a pole RAID a bez zadáníYES. Nouzová volba--allow-no-backupruší pouze požadavek na obraz. Najdete ji v přehledu voleb. - Pokud některý svazek není znovu dostupný, QTS může obnovit jeho konfiguraci úložiště pomocí
init_lvm.sh. Skript tento příkaz spustí až po zadáníREBUILD. Před spuštěním uloží soubory a poté vypíše všechna nastavení, která se při obnově konfigurace změnila.
Omezení
- Oprava nedokáže obnovit data z poškozených rozsahů mapování. V záznamu opravy mapování byly poškozené dva listy mapovacího stromu testovacího svazku s 600 soubory o velikosti 4 MiB. Po opravě se kontrolní součty 534 souborů shodovaly s uloženými hodnotami. Změnilo se 66 souborů, které měly data ve dvou vyřazených rozsazích.
- Skript opravuje pouze metadata fondu. Neopravuje disky, pole RAID ani chybějící fyzický svazek LVM.
- Skript funguje v systému QTS s tenkým fondem LVM. V systému QuTS hero, který používá ZFS, se hned po spuštění ukončí.
- Pokud mezipaměť SSD slouží ke čtení i zápisu nebo pouze k zápisu nebo pokud jsou data ve dvou nebo více vrstvách Qtier, skript se zastaví před krokem 2 a před zahájením opravy a odkáže vás na podporu QNAP. U mezipaměti SSD pouze pro čtení se skript nejprve zeptá, zda byla odebrána nebo vypnuta pro tento fond.
- Fond během opravy přejde do stavu offline. V šetrném režimu skript zastaví správce snímků, pokud jsou připojené snímky fondu. Pokud se některý svazek stále používá, zvolíte, jak daleko skript zajde. Může zastavit správce snímků nebo všechny služby QTS, ukončit procesy, které používají svazek, nebo označit skupinu svazků příznakem, aby fond po restartu NASu zůstal offline. V úplném režimu skript ihned zastaví všechny služby QTS. V kroku 5 nabídne jejich opětovné spuštění.
- Skript nekontroluje souborový systém šifrovaného svazku. Pokud je na NASu svazek mezipaměti SSD, skript kontrolu souborového systému přeskočí.
- Kontrola hardwaru bez chyb nedokazuje, že paměť RAM funguje správně. K testování paměti slouží MemHound.
- Skript zobrazuje zprávy v angličtině. Na každou výzvu odpovězte písmenem, číslicí nebo slovem a stiskněte Enter. Klávesy se šipkami v nabídce nefungují. Ctrl+C skript nepřeruší.
Související stránky
- Co zkontrolovat nejdřív, když fond úložiště nebo svazek na QNAP NAS není aktivní →
- StorageDiag: diagnostika přímo na NASu →
- DriveTime: test povrchu disku pro NAS QNAP →
- MemHound: test paměti RAM na běžícím NASu →
- Návody →
Tato stránka ve formátu Markdown pool-repair.md.