# MemHound: test pamięci RAM w działającym NAS-ie

Jeden statyczny program testuje przez SSH wolną pamięć NAS-a QNAP. LiveCD testuje prawie całą pamięć komputera albo NAS-a x86.

MemHound bierze wolną pamięć blokami po 128 MB. Każdy blok blokuje w RAM, zapisuje w nim wzorce testowe i odczytuje je z powrotem. Dla każdego błędnego słowa pokazuje adres fizyczny.

W czasie testu NAS dalej udostępnia pliki. MemHound zostawia 256 MB wolnej pamięci i działa z najniższym priorytetem. Gdy zabraknie pamięci, system zatrzyma MemHounda przed każdym innym programem.

Wersja 0.6.10 · x86_64, aarch64 i armhf · QTS i QuTS hero · freeware. https://www.qnaputilities.com/memhound-pl.html

## Jak przebiega test

Uruchomiony bez opcji, MemHound wykonuje cały test pamięci w czterech krokach. Krok 3 powtarza się, aż naciśniesz `q`.

1. **Zwolnienie pamięci.** MemHound zapisuje pamięć podręczną na dysk i ją zwalnia. W QuTS hero opróżnia też ZFS ARC. Dzięki temu test obejmuje więcej pamięci. (`sync, drop_caches, zinject -a`)
2. **Przebieg Quick.** Trzy testy na każdym bloku: test adresów, szachownica i inwersje kroczące z losowymi wartościami. (`86 ms na każdy blok 128 MB`)
3. **Przebiegi Extended.** 21 testów na każdym bloku. Przed każdym przebiegiem MemHound znowu zwalnia pamięć. Przebiegi powtarzają się, aż naciśniesz `q` albo MemHound znajdzie błąd. (`5,3 s na każdy blok 128 MB`)
4. **Wynik.** Wynik pokazuje duży napis. Pod nim są dwa wiersze: co MemHound znalazł i co zrobić dalej. Potem pojawia się pełne podsumowanie. (`Tested X MB of Y MB (Z%)`)

## Wewnątrz przebiegu: jeden blok naraz

Przebieg testuje jeden blok naraz i oddaje go, zanim weźmie następny:

1. MemHound bierze 128 MB wolnej pamięci i blokuje je funkcją `mlock`. System nie może wtedy przenieść ich do pliku wymiany.
2. Najpierw wykonuje test adresów. Gdy ten test nie przejdzie, MemHound oznacza wszystkie inne wyniki jako niepewne.
3. Wykonuje testy wzorców. Każdy test zapisuje cały blok, wypycha go z pamięci podręcznej procesora i odczytuje z powrotem.
4. Oddaje blok i bierze następny. Przed każdym blokiem sprawdza, czy 256 MB zostaje wolne.

Gdy słowo odczyta się źle, MemHound czyta je ponownie, do 8 razy, i zapamiętuje jego adres fizyczny. Błąd, który powtarza się pod tym samym adresem, to błąd twardy. Błąd, który się nie powtarza, to błąd przejściowy.

## 21 testów przebiegu Extended

Czas każdego testu na jednym bloku 128 MB. Zmierzyliśmy go MemHoundem 0.6.10 na NAS-ie QNAP z procesorem Intel Core i5-1235U i 16 GB pamięci RAM.

| Test | Grupa | ms | Co robi |
|---|---|--:|---|
| `stuck-addr` | Test adresów, pierwszy w każdym przebiegu | 14 | Zapisuje w każdym słowie jego własny adres, potem odczytuje każde słowo. |
| `solid0` | Testy standardowe | 13 | Zapisuje same bity 0, potem je odczytuje. |
| `solid1` | Testy standardowe | 14 | Zapisuje same bity 1, potem je odczytuje. |
| `checker` | Także w przebiegu Quick | 24 | Zapisuje na przemian bity 0 i 1, potem wzór odwrotny. |
| `movinv0` | Testy standardowe | 28 | Inwersje kroczące: wypełnia bitami 0, potem odczytuje i odwraca każde słowo, najpierw w górę, potem w dół. |
| `movinv1` | Testy standardowe | 26 | Te same inwersje kroczące, zaczynając od samych bitów 1. |
| `movinv-rand` | Także w przebiegu Quick | 31 | Inwersje kroczące z losowymi wartościami, które można powtórzyć tym samym ziarnem. |
| `modulo20` | Testy standardowe | 250 | Zapisuje wartość w co 20. słowie i jej odwrotność we wszystkich pozostałych, 20 razy. |
| `walk` | Testy standardowe | 1590 | Przesuwa pojedynczy bit 1 przez każdą pozycję słowa, potem pojedynczy bit 0. |
| `movinv8` | Testy standardowe | 206 | Inwersje kroczące z 8 wzorami bajtu, w każdym jeden ustawiony bit. |
| `blockseq` | Testy standardowe | 209 | Wypełnia blok 16 wartościami bajtu (00, 55, AA, FF i innymi) i odczytuje każdą. |
| `bitflip` | Testy standardowe | 1626 | Na przemian słowo z jednym ustawionym bitem i słowo, w którym tylko ten bit jest wyzerowany, dla każdego z 64 bitów. |
| `bitspread` | Testy standardowe | 805 | To samo z dwoma sąsiednimi bitami, dla każdej sąsiedniej pary z 64 bitów. |
| `rand-dual` | Testy standardowe | 71 | Zapisuje te same losowe wartości w obu połówkach bloku i porównuje połówki. |
| `cmp-xor` | Testy porównujące | 58 | Obie połówki dostają losowe wartości połączone z jedną liczbą przez XOR, potem MemHound je porównuje. |
| `cmp-sub` | Testy porównujące | 58 | To samo porównanie z odejmowaniem. |
| `cmp-mul` | Testy porównujące | 58 | To samo porównanie z mnożeniem. |
| `cmp-div` | Testy porównujące | 66 | To samo porównanie z dzieleniem. |
| `cmp-or` | Testy porównujące | 58 | To samo porównanie z OR. |
| `cmp-and` | Testy porównujące | 57 | To samo porównanie z AND. |
| `seqinc` | Testy porównujące | 75 | To samo porównanie z wartościami, które rosną od słowa do słowa. |

Przebieg Quick: 86 ms. Przebieg Extended: 5337 ms. Większość testów trwa poniżej 0,1 s. walk i bitflip trwają po 1,6 s, bo przesuwają jeden bit przez każdą pozycję 64-bitowego słowa.

## Test adresów

Moduł pamięci znajduje słowo po jego adresie. Gdy linia adresowa jest uszkodzona, dwa adresy prowadzą do tej samej komórki. Test wzorca może wtedy zapisać i odczytać tę samą złą komórkę i nie zobaczyć błędu.

Dlatego test adresów idzie pierwszy, na każdym bloku. Zapisuje w każdym słowie jego własny adres. Potem odczytuje każde słowo. Słowo, w którym jest adres innego słowa, wskazuje uszkodzoną linię adresową.

Gdy test adresów nie przejdzie, wynik to CRITICAL: pozostałe testy tego przebiegu niczego nie dowodzą.

Przy zablokowanej linii 5 zapisy pod adresy od 1020 do 1038 trafiają do komórek adresów od 1000 do 1018. Pierwsze cztery słowa zwracają wtedy złe adresy.

## Co znaczy każdy wynik

Na końcu testu uruchomionego przez Ciebie MemHound pokazuje dużymi literami jeden z sześciu napisów. Test z aplikacji StorageDiag, z obrazu USB albo z odliczania LiveCD tego ekranu nie pokazuje.

- **PASSED**: Brak błędów. W całym teście MemHound sprawdził też co najmniej 80% pamięci RAM. Pamięć jest sprawna.
- **BAD RAM**: Błędy twarde: błąd powtarza się pod tym samym adresem. Podejrzany moduł pamięci. Adresy są w podsumowaniu.
- **CRITICAL**: Test adresów nie przeszedł: część adresów gubi dane. Podejrzany moduł pamięci albo kontroler pamięci.
- **FAILED**: Tylko błędy przejściowe: nie powtórzyły się pod tym samym adresem. Mogą je powodować zasilanie, temperatura lub taktowanie pamięci. Uruchom test ponownie.
- **PARTIAL**: Brak błędów, ale MemHound sprawdził mniej niż 80% pamięci RAM albo test skończył się wcześniej. Zatrzymaj usługi i uruchom test ponownie albo użyj LiveCD.
- **STOPPED**: Test z wybranym profilem przerwano przed końcem. Uruchom test do końca, aby dostać wynik.

Kody wyjścia całego testu, dla skryptów: 0 PASSED, 1 błędy twarde, 2 tylko błędy przejściowe, 3 CRITICAL albo PARTIAL.

## Dwa nagrane przebiegi testu

Dwa przebiegi MemHounda 0.6.10 na NAS-ie QNAP, w terminalu 80 na 25 znaków. Pierwszy kończy się napisem PASSED. W drugim `--demo fault` celowo odwraca jeden bit i przebieg kończy się napisem BAD RAM.

## Uruchom przez SSH

Zaloguj się do NAS-a przez SSH jako administrator i wpisz te polecenia. Archiwum zawiera program dla trzech typów procesora. Polecenia wybierają ten dla Twojego NAS-a.

```sh
# na NAS-ie, przez SSH
arch=$(uname -m)
# uname podaje armv7l; program nazywa się armhf
[ "$arch" = armv7l ] && arch=armhf
wget https://qnaputilities.com/pub/memhound/bin/memhound.tar.gz
tar zxvf memhound.tar.gz
chmod +x memhound*
./memhound-$arch
```

MemHound niczego nie instaluje. Aby go usunąć, usuń pliki.

### Najczęstsze polecenia

- `./memhound-$arch`: Cały test: Quick, potem przebiegi Extended, aż naciśniesz `q`.
- `./memhound-$arch --passes 2`: To samo, a test sam kończy się po 2 przebiegach Extended.
- `./memhound-$arch --quick`: Jeden przebieg Quick.
- `./memhound-$arch --full`: Testuje prawie całą wolną pamięć w jednym przebiegu. Używaj, gdy NAS nic nie robi.
- `./memhound-$arch --report /tmp/memhound.txt`: Zapisuje też podsumowanie do pliku tekstowego.
- `./memhound-$arch --bench --ui2`: Mierzy szybkość i opóźnienie pamięci, bez testu błędów.
- `./memhound-$arch --demo pass --ui2`: Pokaz trwający 10 sekund, który kończy się napisem PASSED. `--demo fault` kończy się napisem BAD RAM.
- `./memhound-$arch --help`: Pokazuje wszystkie opcje.

## Pobierz

Program dla x86_64, aarch64 i armhf oraz LiveCD dla komputerów PC i NAS-ów x86.

- [memhound.tar.gz](https://www.qnaputilities.com/pub/memhound/bin/memhound.tar.gz): Program dla 3 typów procesora w jednym archiwum
- [pub/memhound/bin/](https://www.qnaputilities.com/pub/memhound/bin/): Każdy plik programu osobno
- [memhound-livecd-0.6.10.iso](https://www.qnaputilities.com/pub/memhound/livecd/memhound-livecd-0.6.10.iso): LiveCD 0.6.10, obraz ISO, 57 MB
- [memhound-livecd-0.6.10.iso.sha256](https://www.qnaputilities.com/pub/memhound/livecd/memhound-livecd-0.6.10.iso.sha256): SHA-256 obrazu LiveCD
- [pub/memhound/livecd/source/](https://www.qnaputilities.com/pub/memhound/livecd/source/): Kod źródłowy części LiveCD na licencji GPL

### Test prawie całej pamięci: LiveCD

W działającym NAS-ie QTS i jego aplikacje zajmują część pamięci, a MemHound nie może jej sprawdzić. LiveCD uruchamia mały system Linux, w którym działa tylko MemHound, więc test obejmuje prawie całą pamięć RAM.

Uruchamia się na komputerach PC i NAS-ach x86 ze złączem HDMI. NAS z procesorem ARM go nie uruchomi. Jeśli Secure Boot jest włączony, najpierw go wyłącz.

1. Zapisz obraz ISO na pendrivie programem balenaEtcher, Rufus albo `dd` albo nagraj go na płytę CD.
2. Podłącz monitor i klawiaturę USB, a potem uruchom komputer z pendrive'a.
3. Naciśnij `1`, aby zacząć test. Jeśli nie naciśniesz żadnego klawisza, test zacznie się sam po 15 sekundach, a czysty wynik uruchomi komputer ponownie po 60 sekundach.
4. Raport jest na pendrivie, w folderze `memhound`. Na pendrivie zapisanym w całości jest na partycji MHDATA. Gdy pamięć jest uszkodzona, wynik zostaje na ekranie, a komputer się zatrzymuje.

## Ograniczenia

- W działającym NAS-ie MemHound testuje tylko wolną pamięć. Gdy obejmie mniej niż 80% pamięci RAM, wynik to PARTIAL. LiveCD obejmuje prawie całą pamięć.
- MemHound działa jak zwykły program, więc test używa też procesora, jego pamięci podręcznej i kontrolera pamięci. Błąd pokazuje, że zawiódł ten łańcuch. Błędy twarde pod stałymi adresami fizycznymi wskazują moduł pamięci.
- Adresy fizyczne wymagają konta root. Bez niego MemHound pokazuje mapę logiczną.
- MemHound podaje slot z błędem tylko wtedy, gdy system ma etykiety EDAC dla swoich modułów.
- `--demo fault` celowo odwraca bit. Jego BAD RAM nie jest wynikiem testu.

## Powiązane strony

- [Poradnik: test pamięci RAM w NAS-ie QNAP z MemHoundem](https://www.qnaputilities.com/howto-memhound-ram-pl.html)
- [Poradnik: pomiar szybkości pamięci NAS-a](https://www.qnaputilities.com/howto-ram-benchmark-pl.html)
- [StorageDiag, aplikacja, która uruchamia MemHounda w oknie](https://www.qnaputilities.com/storagediag-pl.html)
- [MemHound w App Center](https://www.qnaputilities.com/appcenter-pl.html#memhound)
- [Źródła i licencje strony](https://www.qnaputilities.com/sources.html)
