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.
- 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.
░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ░░░ ▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀ ▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀ 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. 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.
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.shStarta skriptet
Skriptet körs på själva NAS-enheten. Det behöver kontot admin eftersom QTS saknar sudo.
- Logga in på NAS-enheten via SSH som admin.
- Gå till mappen som innehåller skriptet. Mappen måste ligga utanför poolen som du reparerar.
- Starta skriptet med det första kommandot nedan.
- 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-BACKUPoch sedan poolens namn så som skriptet visar det, till exempelvg1/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.
Status and diagnosis
Skriptet kontrollerar RAID och maskinvaran. När poolen är offline kör det
enbart läsåtkomstthin_checkpå poolens metadata. Om poolen fortfarande är aktiv erbjuder det en preliminär kontroll med enbart läsåtkomst.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 offlineBackup
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 avbildRepair the metadata
Skriptet erbjuder det reparationsförfarande som passar diagnosen. Innan reparationen skriver över ursprungliga metadata skriver du
inmatning av YESYES.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
YESskriver 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
YESskriver 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_collectfrå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äljae2fsck -fpeller körae2fsck -fyefter att du har skrivitFSCK. 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
screenoch 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 skriverYES. Nödalternativet--allow-no-backuptar 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 skrivitREBUILD. 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.
Relaterade sidor
- Lagringspool eller volym på en QNAP NAS är inte aktiv. Vad kontrollerar du först? →
- StorageDiag: diagnostik som körs på NAS-enheten →
- DriveTime: ett test av diskytan på en QNAP NAS →
- MemHound: ett RAM-test för en NAS i drift →
- Guider →
Den här sidan i Markdown-format pool-repair.md.