# MemHound：稼働中の NAS のための RAM テスト

一つの静的プログラムが、SSH 経由で QNAP NAS の空きメモリをテストします。LiveCD は PC または x86 NAS のメモリのほぼすべてをテストします。

MemHound は空きメモリを 128 MB ずつのブロックに分けて取ります。各ブロックを RAM にロックし、テストパターンを書き込んで読み戻します。誤りのあるワードごとに、その物理アドレスを表示します。

テスト中も NAS はファイルの提供を続けます。MemHound は 256 MB のメモリを空けたままにし、最も低い優先度で動作します。メモリが足りなくなると、システムはほかのどのプログラムよりも先に MemHound を停止します。

バージョン 0.6.10 · x86_64、aarch64、armhf · QTS と QuTS hero · freeware. https://www.qnaputilities.com/memhound-ja.html

## テストの流れ

オプションなしで実行すると、MemHound は RAM テスト全体を四つのステップで実行します。ステップ 3 は `q` を押すまで繰り返されます。

1. **メモリを空ける.** MemHound はキャッシュをディスクに書き出してから破棄します。QuTS hero では ZFS ARC も空にします。これでテストはより多くのメモリを使えます。 (`sync, drop_caches, zinject -a`)
2. **Quick パス.** 各ブロックに三つのテストを実行します。アドレステスト、チェッカーボード、ランダム値によるムービングインバージョンです。 (`128 MB のブロック一つにつき 86 ms`)
3. **Extended パス.** 各ブロックに 21 のテストを実行します。各パスの前に、MemHound はメモリを再び空けます。パスは、`q` を押すか MemHound がエラーを見つけるまで繰り返されます。 (`128 MB のブロック一つにつき 5.3 秒`)
4. **結果.** 大きな文字の単語が結果を示します。その下の二行に、MemHound が見つけたことと次にすべきことが表示されます。続いて完全なサマリーが表示されます。 (`Tested X MB of Y MB (Z%)`)

## パスの内部：一度に一つのブロック

パスは空きメモリ全体を同時に確保しません。一つのブロックをテストしてから解放します。

1. MemHound は 128 MB の空きメモリを取り、`mlock` でロックします。これでシステムはそのメモリをスワップに移せません。
2. 最初にアドレステストを実行します。このテストが失敗すると、MemHound はほかのすべての結果を不確実としてマークします。
3. パターンテストを実行します。各テストはブロック全体を書き込み、CPU キャッシュから追い出してから読み戻します。
4. ブロックを解放し、次のブロックを取ります。各ブロックの前に、256 MB が空いたままであることを確認します。

ワードの読み戻し値が誤っていると、MemHound はそのワードを最大 8 回読み直し、物理アドレスを記録します。同じアドレスで繰り返すエラーはハードエラーです。繰り返さないエラーは一時的なエラーです。

## Extended パスの 21 のテスト

128 MB のブロック一つでの各テストの時間です。 MemHound 0.6.10 を使い、Intel Core i5-1235U と 16 GB の RAM を搭載した QNAP NAS で測定しました。

| テスト | グループ | ms | 内容 |
|---|---|--:|---|
| `stuck-addr` | アドレステスト（すべてのパスで最初に実行） | 14 | 各ワードにそのワードのアドレスを書き込み、すべてのワードを読み戻します。 |
| `solid0` | 標準テスト | 13 | すべてのビットに 0 を書き込み、読み戻します。 |
| `solid1` | 標準テスト | 14 | すべてのビットに 1 を書き込み、読み戻します。 |
| `checker` | Quick パスにも含まれる | 24 | 0 と 1 のビットを交互に書き込み、次に反転したパターンを書き込みます。 |
| `movinv0` | 標準テスト | 28 | ムービングインバージョン：0 で埋めてから、各ワードを読んで反転します。最初は上方向、次に下方向に進みます。 |
| `movinv1` | 標準テスト | 26 | 同じムービングインバージョンを、すべてのビットが 1 の状態から始めます。 |
| `movinv-rand` | Quick パスにも含まれる | 31 | シードで再現できるランダム値によるムービングインバージョン。 |
| `modulo20` | 標準テスト | 250 | 20 ワードごとに一つのワードへ値を書き込み、ほかのすべてのワードにその反転値を書き込みます。これを 20 回繰り返します。 |
| `walk` | 標準テスト | 1590 | 一つの 1 ビットをワードの各位置に移動させ、次に一つの 0 ビットを移動させます。 |
| `movinv8` | 標準テスト | 206 | 8 種類のバイトパターンによるムービングインバージョン。各パターンでは一つのビットが立っています。 |
| `blockseq` | 標準テスト | 209 | ブロックを 16 種類のバイト値（00、55、AA、FF など）で埋め、それぞれを読み戻します。 |
| `bitflip` | 標準テスト | 1626 | 64 ビットのそれぞれについて、そのビットだけが立ったワードと、そのビットだけがクリアされたワードを交互に書き込みます。 |
| `bitspread` | 標準テスト | 805 | 同じことを隣り合う二つのビットで行います。64 ビットの隣り合うすべての組が対象です。 |
| `rand-dual` | 標準テスト | 71 | ブロックの両半分に同じランダム値を書き込み、両半分を比較します。 |
| `cmp-xor` | 比較テスト | 58 | 両半分に、一つの数値と XOR で組み合わせたランダム値を書き込み、MemHound が両半分を比較します。 |
| `cmp-sub` | 比較テスト | 58 | 同じ比較を減算で行います。 |
| `cmp-mul` | 比較テスト | 58 | 同じ比較を乗算で行います。 |
| `cmp-div` | 比較テスト | 66 | 同じ比較を除算で行います。 |
| `cmp-or` | 比較テスト | 58 | 同じ比較を OR で行います。 |
| `cmp-and` | 比較テスト | 57 | 同じ比較を AND で行います。 |
| `seqinc` | 比較テスト | 75 | 同じ比較を、ワードごとに増加する値で行います。 |

Quick パス: 86 ms. Extended パス: 5337 ms. ほとんどのテストは 0.1 秒未満で終わります。walk と bitflip は、64 ビットのワードのすべての位置に一つのビットを移動させるため、それぞれ 1.6 秒かかります。

## アドレステスト

メモリモジュールは、アドレスによってワードを見つけます。アドレス線が壊れていると、二つのアドレスが同じセルにつながります。するとパターンテストは同じ誤ったセルに書き込んで読み出し、エラーを検出できません。

そのため、アドレステストは各ブロックで最初に実行されます。各ワードにそのワードのアドレスを書き込みます。次に、すべてのワードを読み戻します。別のワードのアドレスを持つワードは、壊れたアドレス線を示します。

アドレステストが失敗すると、結果は CRITICAL になります。その実行のほかのテストでは何も証明できないためです。

線 5 が固着していると、1020 から 1038 への書き込みは 1000 から 1018 のセルに入ります。その結果、最初の四つのワードは誤ったアドレスを読み戻します。

## 各結果の意味

自分で開始したテストの終わりに、MemHound は六つの単語のいずれかを大きな文字で表示します。StorageDiag アプリ、USB イメージ、LiveCD のカウントダウンから始まったテストでは、この画面は表示されません。

- **PASSED**: エラーはありません。テスト全体で、MemHound は RAM の 80% 以上にも到達しました。 メモリは正常です。
- **BAD RAM**: ハードエラー：同じアドレスでエラーが繰り返されます。 メモリモジュールが疑われます。アドレスはサマリーに一覧表示されます。
- **CRITICAL**: アドレステストが失敗しました：一部のアドレスがデータを失います。 メモリモジュールまたはメモリコントローラーが疑われます。
- **FAILED**: 一時的なエラーのみ：同じアドレスでは繰り返されませんでした。 電源、熱、メモリタイミングが原因になることがあります。テストをもう一度実行してください。
- **PARTIAL**: エラーはありませんが、MemHound がテストしたのは RAM の 80% 未満でした。またはテストが途中で終了しました。 サービスを停止してテストをもう一度実行するか、LiveCD を使ってください。
- **STOPPED**: プロファイルを選んで開始したテストを、終了前に停止しました。 結果を得るには、テストを最後まで実行してください。

テスト全体の終了コード（スクリプト用）：0 PASSED、1 ハードエラー、2 一時的なエラーのみ、3 CRITICAL または PARTIAL。

## 二つのテスト実行の記録

80 × 25 文字の端末で、QNAP NAS 上の MemHound 0.6.10 を二回実行した記録です。最初の実行は PASSED で終わります。二つ目の実行では `--demo fault` が意図的に一つのビットを反転させ、実行は BAD RAM で終わります。

## SSH で実行する

管理者として SSH で NAS にログインし、次のコマンドを実行します。アーカイブには三種類のプロセッサー向けのプログラムが入っています。コマンドがお使いの NAS に合うものを選びます。

```sh
# NAS 上で、SSH 経由
arch=$(uname -m)
# uname は armv7l と表示しますが、プログラム名は 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 は何もインストールしません。削除するには、ファイルを削除します。

### よく使うコマンド

- `./memhound-$arch`: テスト全体：Quick を実行し、`q` を押すまで Extended パスを繰り返します。
- `./memhound-$arch --passes 2`: 同じ内容ですが、Extended パスを 2 回実行するとテストが自動で止まります。
- `./memhound-$arch --quick`: Quick パスを一回実行します。
- `./memhound-$arch --full`: 空きメモリのほぼすべてを一度の実行でテストします。NAS がアイドル状態のときに使ってください。
- `./memhound-$arch --report /tmp/memhound.txt`: サマリーをテキストファイルにも書き込みます。
- `./memhound-$arch --bench --ui2`: メモリの速度とレイテンシを測定します。エラーのテストは行いません。
- `./memhound-$arch --demo pass --ui2`: PASSED で終わる 10 秒間のデモ実行です。`--demo fault` は BAD RAM で終わります。
- `./memhound-$arch --help`: すべてのオプションを表示します。

## ダウンロード

x86_64、aarch64、armhf 用のプログラムと、PC および x86 NAS モデル用の LiveCD です。

- [memhound.tar.gz](https://www.qnaputilities.com/pub/memhound/bin/memhound.tar.gz): 3 種類のプロセッサー向けプログラムを一つのアーカイブにまとめたもの
- [pub/memhound/bin/](https://www.qnaputilities.com/pub/memhound/bin/): 個別のプログラムファイル
- [memhound-livecd-0.6.10.iso](https://www.qnaputilities.com/pub/memhound/livecd/memhound-livecd-0.6.10.iso): LiveCD 0.6.10、ISO イメージ、57 MB
- [memhound-livecd-0.6.10.iso.sha256](https://www.qnaputilities.com/pub/memhound/livecd/memhound-livecd-0.6.10.iso.sha256): LiveCD イメージの SHA-256
- [pub/memhound/livecd/source/](https://www.qnaputilities.com/pub/memhound/livecd/source/): LiveCD の GPL 部分のソースコード

### メモリのほぼすべてをテストする：LiveCD

稼働中の NAS では QTS とそのアプリがメモリの一部を使っており、MemHound はその部分をテストできません。LiveCD は MemHound だけが入った小さな Linux システムを起動するので、テストは RAM のほぼすべてに届きます。

HDMI ポートを持つ PC と x86 NAS モデルで起動します。ARM の NAS では起動できません。Secure Boot が有効な場合は、先に無効にしてください。

1. balenaEtcher、Rufus、または `dd` で ISO イメージを USB フラッシュドライブに書き込むか、CD に焼きます。
2. モニターと USB キーボードを接続し、USB フラッシュドライブからコンピューターを起動します。
3. テストを開始するには `1` を押します。どのキーも押さないと、テストは 15 秒後に自動で始まり、エラーのない結果なら 60 秒後にコンピューターが再起動します。
4. レポートは USB フラッシュドライブの `memhound` フォルダーにあります。ドライブ全体に書き込んだ場合は、MHDATA パーティションにあります。メモリに不良があると、結果は画面に表示されたままになり、コンピューターは停止します。

## 制限

- 稼働中の NAS では、MemHound は空きメモリだけをテストします。RAM の 80% 未満にしか届かない場合、結果は PARTIAL です。LiveCD は RAM のほぼすべてに届きます。
- MemHound は通常のプログラムとして動くため、テストではプロセッサー、そのキャッシュ、メモリコントローラーも使われます。エラーは、この経路のどこかで不具合が起きたことを示します。固定された物理アドレスでのハードエラーは、メモリモジュールを示します。
- 物理アドレスには root アカウントが必要です。root でない場合、MemHound は論理マップを表示します。
- MemHound がエラーのスロットを示せるのは、システムにモジュールの EDAC ラベルがある場合だけです。
- `--demo fault` は意図的にビットを反転させます。その BAD RAM はテスト結果ではありません。

## 関連ページ

- [ガイド：MemHound で QNAP NAS の RAM をテストする](https://www.qnaputilities.com/howto-memhound-ram-ja.html)
- [ガイド：NAS のメモリ速度を測定する](https://www.qnaputilities.com/howto-ram-benchmark-ja.html)
- [StorageDiag：MemHound をウィンドウで実行するアプリ](https://www.qnaputilities.com/storagediag-ja.html)
- [App Center の MemHound](https://www.qnaputilities.com/appcenter.html#memhound)
- [サイトのソースコードとライセンス](https://www.qnaputilities.com/sources.html)
