Unofficial

Pula lub wolumin QNAP nieaktywne: co sprawdzić najpierw

Polecenia przez SSH, które tylko czytają, pokazują, która warstwa zatrzymała pulę: dyski i macierz RAID, LVM, metadane puli thin albo system plików woluminu.

W NAS-ie QNAP z systemem QTS pamięć masowa składa się z warstw. Dyski tworzą macierz RAID, LVM zakłada na niej pulę thin, a woluminy są w puli. Pula albo wolumin przestaje działać, gdy zawiedzie jedna z tych warstw.

Sprawdzaj warstwy od dysków w górę, w kolejności poniżej. Każdy krok podaje polecenia, znaczenie ich wyniku i warstwę, na którą wskazuje. Żadne z tych poleceń nie zmienia macierzy RAID, LVM ani puli.

QTS z pulą LVM thin · polecenia przez SSH, jako admin · sprawdzone ze skryptem LVM Pool Repair 1.8

Wolumin i system plików ext4ext4ext4 Metadane puli thin tp1_tmetatp1 LVM vg1 · PV Dyski i RAID md1
Cztery warstwy, od dysków w górę

Zanim cokolwiek zmienisz

  • Nie zmieniaj niczego, dopóki nie wiesz, która warstwa zawiodła. Nie wyjmuj i nie zamieniaj dysków. Nie uruchamiaj naprawy w QTS ani przez SSH, zanim nie przeczytasz wyników sprawdzeń poniżej.
  • Naprawa pamięci masowej bywa nieodwracalna. Zanim cokolwiek zapisze coś w puli, upewnij się, że masz kopię ważnych danych.
  • Logi i kopie trzymaj poza sprawdzaną pulą: na dysku zewnętrznym albo na woluminie innej puli.
  • Żadne sprawdzenie ani żadna naprawa nie gwarantuje odzyskania danych. Naprawa uszkodzonych zakresów mapowań nie przywróci danych, które w nich były.
  • Ta strona dotyczy QTS z pulą LVM thin. QuTS hero używa ZFS, więc te sprawdzenia i LVM Pool Repair go nie dotyczą.

Cztery warstwy, od dysków w górę

Warstwa działa tylko wtedy, gdy działa warstwa pod nią. Dlatego sprawdzanie zaczyna się od dysków. LVM Pool Repair stosuje tę samą zasadę: naprawia pamięć masową od dołu i zatrzymuje się, gdy winna jest niższa warstwa.

  1. Dyski i RAID

    QTS łączy partycje dysków w macierze RAID md. Pula danych leży na takiej macierzy, na przykład md1.

    cat /proc/mdstat
  2. LVM

    LVM używa każdej macierzy albo urządzenia DRBD na niej jako woluminu fizycznego (PV). Woluminy fizyczne puli tworzą grupę woluminów (VG), na przykład vg1.

    pvs · vgs
  3. Metadane puli thin

    Pula thin, na przykład tp1, trzyma metadane na osobnym urządzeniu, tp1_tmeta. Metadane mapują każdy blok każdego woluminu w puli.

    lvs -a
  4. Wolumin i system plików

    Każdy wolumin to wolumin thin w puli z systemem plików ext4. QTS go montuje, a na nim są foldery udostępnione.

    dmesg

Sprawdź po kolei

Zaloguj się do NAS-a przez SSH jako admin. Uruchom polecenia kroku i przeczytaj wynik. Do następnego kroku przejdź dopiero wtedy, gdy warstwa wygląda dobrze.

  1. Przeczytaj log jądra

    Log jądra pokazuje błędy dysków i komunikaty urządzeń device-mapper puli.

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

    Błędy wejścia-wyjścia dysków pod pulą wskazują na dysk. Przetestuj dysk, zanim zajmiesz się wyższymi warstwami.

  2. Sprawdź RAID

    /proc/mdstat pokazuje każdą macierz md z jej stanem i członkami. md_checker pokazuje macierze danych ze stanem każdego dysku.

    cat /proc/mdstat
    md_checker

    Macierz oznaczona inactive to problem z RAID. Zapis [4/3] znaczy, że brakuje jednego z 4 członków i macierz działa zdegradowana. recovery, resync, reshape albo check znaczy, że macierz jest zajęta.

  3. Sprawdź LVM

    pvs pokazuje woluminy fizyczne, vgs grupy woluminów, a lvs -a pulę i jej woluminy.

    pvs
    vgs
    lvs -a

    Litera m na trzecim miejscu kolumny Attr w pvs (a-m) znaczy, że LVM oznaczył wolumin fizyczny jako brakujący. Wolumin fizyczny widoczny jako unknown device nie istnieje w systemie. Gdy lvs -a nie pokazuje żadnej puli thin, usterka jest poniżej metadanych: w RAID albo w LVM.

  4. Przeczytaj wiersz puli w lvs -a

    Kolumna Attr puli zaczyna się od t. Jej dziewiąty znak to stan, który zgłasza LVM:

    M
    metadane są tylko do odczytu
    F
    pula uległa awarii
    D
    w puli skończyło się miejsce na dane
    p
    pula niepełna: brakuje jednego z jej woluminów fizycznych

    Kolumna Attr woluminu zaczyna się od V. Litera a na piątym miejscu znaczy, że wolumin jest aktywny.

    Gdy LVM albo log jądra pokazał jeden z tych komunikatów, komunikat wskazuje warstwę:

    Refusing activation of partial LV
    brakuje woluminu fizycznego: warstwa LVM
    transaction_id
    zapis puli w LVM nie zgadza się z metadanymi puli: konfiguracja LVM
    Check of thin pool … failed
    metadane puli
    too small for target
    macierz RAID jest mniejsza niż woluminy na niej: warstwa RAID
  5. Zdiagnozuj metadane przy wyłączonej puli

    Diagnozę metadanych daje tylko thin_check na wyłączonej puli. Wyłączenie puli to już zmiana, więc robi to LVM Pool Repair: krok 2 wyłącza pulę, a krok 1 uruchamia sprawdzenie. Na puli, która jeszcze działa, krok 1 proponuje wstępne sprawdzenie tylko do odczytu.

    $ 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)
    Zobacz prawdziwe naprawy →
  6. Sprawdź system plików woluminu, który się nie montuje

    Gdy pula i jej woluminy są aktywne w lvs -a, a wolumin dalej się nie montuje, zajrzyj do jego systemu plików.

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

    Błędy EXT4-fs wskazują na system plików woluminu. Check File System w QTS sprawdza go i naprawia. Uruchom to dopiero po przeczytaniu wyników sprawdzeń powyżej.

Co znaczy wynik

Każda karta podaje, co widzisz, na którą warstwę to wskazuje i co wtedy robi LVM Pool Repair 1.8.

Dyski i RAID

  • inactive

    Macierz md pod pulą jest nieaktywna. To problem z RAID.

    Skrypt nie zaczyna naprawy. Każe najpierw naprawić RAID.

  • [4/3] [UUU_]

    Macierz działa, ale brakuje członka albo trwa odbudowa, synchronizacja, zmiana układu lub sprawdzanie.

    Skrypt pyta, zanim coś zapisze w puli, a domyślna odpowiedź to „nie”. Gdy trwa odbudowa, najpierw poczekaj, aż się skończy.

  • I/O error

    Log jądra zgłasza błędy wejścia-wyjścia dysków pod pulą albo błędy pamięci.

    Skrypt pyta, zanim coś zapisze, a domyślna odpowiedź to „nie”. Najpierw przetestuj dyski DriveTime, a pamięć RAM MemHoundem.

LVM

  • a-m

    LVM oznaczył wolumin fizyczny puli jako brakujący albo pokazuje go jako unknown device. Włączenie puli kończy się komunikatem Refusing activation of partial LV.

    Skrypt się zatrzymuje: to warstwa LVM, nie metadane puli. Przy unknown device odsyła z powrotem do warstwy RAID.

  • No thin pool found

    lvs -a nie pokazuje żadnej puli thin. Usterka jest poniżej metadanych puli.

    Skrypt się zatrzymuje i podaje polecenia, które tylko czytają stan RAID i LVM: cat /proc/mdstat, md_checker, mdadm -E /dev/sdX3, pvs, vgs, lvs -a.

Metadane puli thin

  • SSD cache

    Pula ma pamięć podręczną SSD w trybie odczytu i zapisu albo tylko zapisu, albo Qtier trzyma dane w dwóch lub więcej warstwach.

    Skrypt zatrzymuje się, zanim cokolwiek zmieni, i odsyła do pomocy technicznej QNAP. Przy pamięci podręcznej SSD tylko do odczytu najpierw pyta, czy jest usunięta albo wyłączona dla tej puli.

  • thin_check

    LVM zgłasza Check of thin pool … failed albo thin_check znajduje błędy w metadanych puli.

    Do tego przypadku służy LVM Pool Repair. Następna sekcja podaje trzy typy uszkodzeń.

  • metadata consistent

    thin_check nie znajduje błędów w metadanych.

    Gdy ustawiona jest tylko flaga needs_check, skrypt ją kasuje: z tą flagą pula startuje z metadanymi tylko do odczytu. W innym przypadku usterka jest nad pulą, w systemie plików, albo pod nią, w RAID lub LVM.

Gdy przyczyną są metadane puli thin

LVM Pool Repair to skrypt powłoki z menu. Przez SSH naprawia metadane puli thin w NAS-ie QNAP z systemem QTS. Diagnoza dzieli uszkodzenia na trzy typy, a każdy ma własną ścieżkę naprawy.

  • space map counts only

    Błędy są tylko w licznikach mapy przestrzeni, a drzewa mapowań są całe. Skrypt buduje naprawioną kopię, sprawdza ją i po wpisaniu YES zapisuje ją do puli.

  • damaged superblock

    Główny superblok jest uszkodzony, a jego poprawne kopie zapasowe istnieją. Po wpisaniu YES skrypt odtwarza superblok z najnowszej poprawnej kopii.

  • mapping tree errors

    Uszkodzone są części drzewa, które mapuje bloki woluminu. Pula działa na naprawionej kopii do testowego montowania tylko do odczytu, a Ty sprawdzasz dane, zanim skrypt zapisze kopię. Bloki z usuniętych zakresów są potem puste przy odczycie.

Zanim naprawa zapisze coś w oryginalnych metadanych, skrypt zapisuje ich obraz i sprawdza go z urządzeniem. W teście z 600 plikami po 4 MiB na woluminie z uszkodzonymi mapowaniami po naprawie 534 pliki były całe. 66 plików miało dane w usuniętych zakresach i się zmieniło.

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