Unofficial

LVM Pool Repair: ett skript för att reparera metadata i en tunn lagringspool från QNAP

Ett menybaserat skalskript reparerar metadata i en tunn lagringspool från QNAP på QTS via SSH.

Reparationen sker i fem steg. Skriptet ställer diagnos, förbereder poolen, säkerhetskopierar, reparerar metadata och tar poolen och volymerna i drift igen.

Tryck på Enter i menyn för att köra nästa steg som skriptet rekommenderar. Om SSH-sessionen bryts eller NAS-enheten startar om fortsätter du samma reparationssession.

Version 1.8 · på NAS-enheten, via SSH, som admin · QTS med en tunn LVM-pool · gratisprogram

  • 5steg i menyn, i reparationsordning
  • 3typer av metadataskador, var och en med ett eget reparationsförfarande
  • YESordet du skriver innan reparationen skriver över poolens metadata

Inspelningar av skriptet

Varje inspelning visar en verklig SSH-session med version 1.7 av skriptet på en QNAP NAS, i en terminal med 80 gånger 25 tecken. Version 1.8 lägger till ett avsnitt på de här skärmarna för kontroll av RAID och diskarna med enbart läsåtkomst, före menyn och i början av steg 1. Vi skadade avsiktligt poolens metadata på kända ställen och sparade de ursprungliga blocken. Vi skrev skadade metadata till poolen efter steg 2, medan den var offline. Inspelningarna hoppar över den pausen. Efter steg 2 fortsätter skriptet med diagnosen i samma session. Långa väntetider är förkortade i inspelningarna. Den faktiska väntetiden beror på poolens storlek och dess ögonblicksbilder.

sh qnap-pool-repair-1.7.sh80×25
  ░░░   ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░      ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░      ▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀▀▀▀▀       ▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀                                                                                     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.                                              
Inspelningen börjar med kommandona för nedladdning, från och med cd /mnt/HDA_ROOT. Steg 2 tar poolen offline. Medan skriptet väntar i menyn ger vi en post i utrymmeskartan för metadata ett felaktigt värde. Sedan startar a den automatiska körningen. Skriptet kör en diagnos, sparar en avbild av metadata, reparerar poolen och tar poolen, volymerna och apparna i drift igen. Skriptet pausar en gång. Innan det skriver till poolen väntar det på att operatören skriver YES.En post i utrymmeskartan för metadata har ett felaktigt värde. Skriptet stoppar tjänsterna, sparar en verifierad avbild av metadata, skapar en reparerad kopia och kontrollerar den. När operatören skriver YES skriver skriptet kopian till poolen. Steg 5 tar poolen, volymerna och apparna i drift igen.Det primära superblocket är skadat och dess säkerhetskopior är giltiga. Skriptet läser metadata via den senaste kopian. När operatören skriver YES återställer skriptet superblocket från den kopian, kontrollerar metadata och tar poolen i drift igen.Två löv i en testvolyms mappningsträd är skadade. Poolen använder den reparerade kopian under en testmontering med enbart läsåtkomst. Filerna läses under testmonteringen. När operatören har bekräftat data och skrivit YES skriver skriptet kopian till poolen. Det kontrollerar testvolymens filsystem innan QTS monterar volymen. Den avslutande kontrollen av kontrollsummorna för de 600 testfilerna visar att 534 är intakta och att 66 har ändrats.Skadan är densamma. NAS-enheten startar om under testmonteringen med enbart läsåtkomst. Efter omstarten förblir poolen offline eftersom skriptet satte flaggan skip-activation före testet. Efter en ny inloggning via SSH startar vi skriptet igen. Det hittar den oavslutade sessionen och slutför reparationen.

Ladda ner skriptet

Du behöver en PIN-kod för att ladda ner skriptet. Ange PIN-koden för att visa nedladdningslänken.

Starta skriptet

Skriptet körs på själva NAS-enheten. Det behöver kontot admin eftersom QTS saknar sudo.

  1. Logga in på NAS-enheten via SSH som admin.
  2. Gå till mappen som innehåller skriptet. Mappen måste ligga utanför poolen som du reparerar.
  3. Starta skriptet med det första kommandot nedan.
  4. Välj en arbetskatalog utanför poolen. Utan arbetskatalog kan skriptet ställa diagnos, men steg 3 kan inte spara metadataavbilden.
# starta skriptet och dess meny
sh qnap-pool-repair.sh
# återgå till sessionen efter ett anslutningsavbrott
screen -r qnap-pool-repair

En reparation av lagringen kan vara omöjlig att ångra. Innan skriptet skriver något, kontrollera att dina viktiga data är säkerhetskopierade och att diagnosen stämmer för din NAS-enhet.

Alternativ

--auto
Startar den automatiska körningen när skriptet har hittat poolen. Steg 1 till 5 körs i följd. Den automatiska körningen behöver en arbetskatalog.
--debug
Visar anropsspåret och varje kommando i en ram. Skriver skalets fullständiga körspår till trace.log. Det kräver en arbetskatalog.
--no-screen
Kör skriptet utan en screen-session.
--selftest
Kontrollerar med enbart läsåtkomst de kommandon som skriptet använder och avslutar sedan.
--raid-check
Kontrollerar med enbart läsåtkomst RAID-uppsättningarna, deras medlemmar och QNAP-signaturerna på diskarna och avslutar sedan. Ingen pool behövs.
--allow-no-backup
Endast för nödfall. Du kan då bekräfta det snabba eller fullständiga förfarandet utan en metadataavbild. Skriv NO-BACKUP och sedan poolens namn så som skriptet visar det, till exempel vg1/tp1. Den automatiska körningen använder inte det här alternativet.
--help
Visar alternativen.
--version
Visar versionen.

De fem stegen

Före menyn visar skriptet texten WARNING i rött och kontrollerar att de 79 kommandon det använder finns på NAS-enheten. I en ny session kontrollerar skriptet sedan RAID-uppsättningarna och deras diskar med enbart läsåtkomst. Menyn visar stegen i reparationsordning och status för varje steg. Enter kör det rekommenderade steget. Den automatiska körningen utför alla återstående steg i följd och använder standardsvaret när det är säkert. Skriptet frågar fortfarande om volymer som används och om data vid testmonteringen. Du måste dessutom skriva YES.

  1. Status and diagnosis

    Skriptet kontrollerar RAID och maskinvaran. När poolen är offline kör det thin_check på poolens metadata. Om poolen fortfarande är aktiv erbjuder det en preliminär kontroll med enbart läsåtkomst.

    enbart läsåtkomst
  2. Prepare

    Skriptet avmonterar poolens volymer och inaktiverar volymgruppen. I det försiktiga läget avmonterar det bara det som hör till poolen. Det stoppar bara tjänster om något fortfarande är upptaget.

    poolen är offline
  3. Backup

    Skriptet sparar LVM-konfigurationen och skriver en avbild av metadata i arbetskatalogen. Det godtar avbilden först efter att ha kontrollerat den mot enheten.

    verifierad avbild
  4. Repair the metadata

    Skriptet erbjuder det reparationsförfarande som passar diagnosen. Innan reparationen skriver över ursprungliga metadata skriver du YES.

    inmatning av YES
  5. Bring the pool and the volumes up

    Skriptet aktiverar poolen. QTS monterar volymerna, och skriptet jämför varje volym med den sparade listan. Det erbjuder sig att starta tjänsterna som det stoppade. När alla volymer är tillgängliga igen visar skriptet LOOKS GOOD, skriver en rapport och packar loggarna.

    rapport och loggar

Diagnosresultat

Steg 1 visar resultatet av thin_check med ett av skriptets egna meddelanden. Steg 4 erbjuder sedan det reparationsförfarande som passar resultatet.

  • space map counts only

    Bara räknarna i utrymmeskartan innehåller fel. Mappningsträden är intakta.

    Snabbt förfarande. Skriptet skapar en reparerad kopia på en reserverad volym och kontrollerar den. När du skriver YES skriver det kopian till poolen.

  • damaged superblock

    Det primära superblocket är skadat. Skriptet hittar giltiga säkerhetskopior av superblocket i metadata.

    Skriptet läser metadata med hjälp av den senaste giltiga kopian. När du skriver YES återställer det superblocket från kopian och kör diagnosen igen.

  • mapping tree errors

    Delar av trädet som mappar volymens block är skadade. Reparationen tar bort de berörda intervallen ur mappningen. Blocken i dessa intervall framstår sedan som tomma vid läsning.

    Fullständigt förfarande. Poolen använder den reparerade kopian under en testmontering med enbart läsåtkomst. Granska data och bekräfta att de stämmer. När du skriver YES skriver skriptet kopian till poolen.

  • data NOT OK

    Under testmonteringen anger du att data är felaktiga. Skriptet återställer den ursprungliga LVM-konfigurationen. Ursprungliga metadata förblir oförändrade.

    Skicka ärendet till QNAP:s support tillsammans med loggpaketet från meny 7 och paketet tp_collect från menyn Tools.

Skriptet behandlar okända resultat som mappningsskador. Om utrymmeskartan är skadad erbjuder skriptet också två förfaranden som skriver direkt till ursprungliga metadata. De heter legacy (thin_dump och thin_restore) och rebuild (QNAP:s thin_rebuild). Båda kräver en verifierad avbild och att du skriver YES. Om poolen saknar en reserverad volym för kopian är legacy det enda förfarandet för mappningsskador. Skriv LEGACY för att välja det.

Säkerhetsregler

  • En reparation skriver till ursprungliga metadata först när steg 3 har en verifierad avbild. En rå avbild måste ha samma storlek som enheten och ge samma resultat med thin_check. Skriptet jämför en komprimerad avbild med enheten byte för byte.
  • Innan reparationen skriver över ursprungliga metadata skriver du YES. Alla andra svar avbryter skrivningen.
  • Innan skriptet skriver söker det i kärnloggen efter rapporter om minnesfel och efter I/O-fel på diskarna som poolen ligger på. Om skriptet hittar ett fel frågar det om du vill fortsätta. Standardsvaret är nej.
  • Skriptet startar ingen reparation på ett inaktivt RAID. Om RAID är degraderat eller om en ombyggnad, omsynkronisering, ändring av RAID-layouten eller kontroll pågår frågar skriptet först. Standardsvaret är nej.
  • Efter reparation av mappningsskador erbjuder steg 5 en filsystemskontroll med enbart läsåtkomst (e2fsck -fn) av de berörda volymerna före montering. Om kontrollen hittar fel kan du välja e2fsck -fp eller köra e2fsck -fy efter att du har skrivit FSCK. Du kan också använda Check File System i QTS senare.
  • Arbetskatalogen med loggarna och metadataavbilden ligger utanför poolen, på en extern disk eller på en volym i en annan pool. Skriptet godtar ingen katalog i poolen du reparerar.
  • Skriptet körs i screen och fortsätter även om SSH-sessionen bryts. Kör skriptet igen för att återgå till sessionen.
  • Sessionens status finns utanför poolen på NAS-enhetens systempartition (md9). Efter en omstart hittar skriptet den oavslutade sessionen och frågar om du vill fortsätta.
  • Under testmonteringen låter LVM poolen använda den reparerade kopian. Under tiden har volymgruppen flaggan skip-activation. Det gör att poolen förblir offline om NAS-enheten startar om.
  • Det finns två undantag. Om metadata är konsekventa och bara flaggan needs_check är satt tar skriptet bort flaggan utan avbild, utan kontroll av maskinvaran och RAID och utan att du skriver YES. Nödalternativet --allow-no-backup tar bara bort kravet på en avbild. Se avsnittet om alternativ.
  • Om en volym inte blir tillgänglig igen kan QTS återskapa dess lagringskonfiguration med init_lvm.sh. Skriptet kör kommandot först när du har skrivit REBUILD. Det sparar filerna innan kommandot körs och listar sedan alla inställningar som ändrades när konfigurationen återskapades.

Begränsningar

  • Reparationen kan inte återställa data i skadade mappningsintervall. I inspelningen om mappning var två löv i mappningsträdet för en testvolym med 600 filer på 4 MiB vardera skadade. Efter reparationen stämde kontrollsummorna för 534 filer med de sparade värdena. De 66 filer som hade data i de två borttagna intervallen hade ändrats.
  • Skriptet reparerar bara poolens metadata. Det reparerar inga diskar, inget RAID och inga saknade fysiska LVM-volymer.
  • Skriptet fungerar i QTS med en tunn LVM-pool. I QuTS hero, som använder ZFS, avbryter det vid start.
  • Med en SSD-cache för både läsning och skrivning eller för enbart skrivning, eller med data i två eller fler Qtier-nivåer, stannar skriptet före steg 2 och före reparationen och hänvisar till QNAP-supporten. Med en SSD-cache för enbart läsning frågar skriptet först om cachen har tagits bort eller inaktiverats för den här poolen.
  • Poolen går offline inför reparationen. I det försiktiga läget stoppar skriptet hanteraren för ögonblicksbilder om ögonblicksbilder från poolen är monterade. Om en volym fortfarande är upptagen väljer du hur långt skriptet ska gå. Det kan stoppa hanteraren för ögonblicksbilder eller alla QTS-tjänster, avsluta processerna som använder volymen eller flagga volymgruppen så att poolen förblir offline efter en omstart av NAS-enheten. I det fullständiga läget stoppar skriptet alla QTS-tjänster direkt. Steg 5 erbjuder sig att starta dem igen.
  • Skriptet kontrollerar inte filsystemet på krypterade volymer. Om NAS-enheten har en SSD-cachevolym hoppar skriptet över filsystemskontrollen.
  • En felfri maskinvarukontroll visar inte att RAM-minnet är felfritt. MemHound testar minnet.
  • Skriptets meddelanden är på engelska. Svara på varje fråga med en bokstav, siffra eller ett ord och tryck på Enter. Piltangenterna fungerar inte i menyn. Ctrl+C avbryter inte skriptet.