コミュニティソリューション

ZimaOSのUIでBeelink ME MiniのNVMeが表示されない:原因を診断する

Beelink ME Mini users could read and write NVMe RAID pools while the ZimaOS dashboard misidentified drives or reported incorrect pool usage.

要点:RAIDが動作しているのにZimaOSでNVMeディスクが未接続と表示される場合は、ディスク故障より先にスロットマッピングを疑う

複数のBeelink ME Miniの環境では、ダッシュボードにNVMeディスクが未接続と表示されたり、空き容量の情報が誤っていたりする一方で、RAID 0/5ストレージはSMB経由で読み書き可能な状態を維持していました。このパターンは、LinuxとRAIDレイヤーではすでにデバイスを認識できていることを意味します。問題があるのは、ZimaOSの物理スロットマッピング/UIレイヤーです。

Beelink ME Mini上でNVMeディスクが未接続と報告されているRAID5プールを示すZimaOSストレージ
プールには引き続きアクセスできましたが、基盤のRAIDは正常に動作しているにもかかわらず、ZimaOSでは4つのNVMeスロットが未接続として表示されました。
NVMeメンバーが視覚的なスロットマップに表示されない、RAID0プールを示すZimaOSストレージ
2つ目のプールでも同じ不一致が確認されました。下層ではRAIDストレージが使用可能なのに、ダッシュボード上の物理ディスク表示が正しくありませんでした。

まずUIの下層でNVMeとRAIDが正常であることを確認する

lsblk -o NAME,SIZE,FSTYPE,MOUNTPOINTS
lspci | grep -i "Non-Volatile"
cat /proc/mdstat
df -h

RAIDがマウントされ、SMBが動作し、期待されるNVMeデバイスが次に表示される場合 lspci/lsblk、ダッシュボードを修正するためだけにアレイを再構築しないでください。現在のZimaOSストレージ画面は、マッピングが正しければディスクの健全性、容量、読み取り/書き込み情報を表示するよう設計されています。

ZimaOSストレージステータスには、期待される最終状態が表示されます。

NVMeのマッピングにはlsblk HCTLではなくPCIアドレスを使用

NVMeデバイスでlsblk -o hctlを実行するとHCTLヘッダーだけが返されるZimaOSターミナル
この診断の失敗例は、よくある間違いを示しています。HCTLはSCSI/SATA系デバイスには有用ですが、NVMeのマッピングにはPCIアドレスが必要です。

旧来のZima以外のハードウェア向け修正では lspci NVMeの場合。 NVMe向けのlsblk -o hctl これはSATA/SCSIブランチであり、NVMeに対しては有用な結果を返さないことがあります。この違いにより、スレッド内の混乱が解消されました。

従来のlocal-storage.conf修正

IceWhaleがZima以外のハードウェアで使用した回避策 /etc/casaos/local-storage.conf 更新された NVMe 公開されているPCIアドレスに合わせたマッピング lspci続いて:

systemctl restart zimaos-local-storage

その後、ユーザーは、自分のビルドで実際に動作するパーサーでは、当初公開されたカンマ区切りの例ではなく、スペースで区切ったアドレスが必要だと判明しました。これは古い低レベルの回避策であるため、手動で編集する前に設定をバックアップし、まずは現在のZimaOSの動作を優先してください。

Zima以外のディスクのマッピングには、従来の手順が残されています。

修正後のNVMe表示例

健康状態と温度が表示され、使用率が0%の3台のTEAMGROUP NVMe SSDを表示するZimaOS RAID5プール
後のBeelink構成では、意図した結果として、Storageインターフェースに個々のNVMeモデル、容量、温度が表示されました。
健康状態と温度情報を表示する3台のCrucial 2TB NVMe SSDのZimaOS RAID5プール
別の修正済み構成では、プレースホルダーの「ディスクが見つかりません」カードではなく、NVMeのモデル名、使用状況、温度が表示されました。
3台のCrucial 4TB NVMe SSDが正しく検出されたZimaOS RAID5ストレージ画面
4TBのNVMeドライブ3台で正常に動作するスロットマップにより、問題がRAID機能ではなくUIのマッピングにあることが示されました。
NVMeのPCIマッピングを修正する前の、ダッシュボードで6台のNVMeディスクが見つからない状態になっているZimaOS Storage
プール自体は存在していたにもかかわらず、6つすべてのNVMeスロットが見つからない状態で表示され、画面上のスロット設定が誤っていたことが改めて示されました。
PCIアドレスマッピングの更新後、6台のCrucial NVMe SSDが正しく表示されたZimaOS RAID5プール
NVMeのPCIアドレスマッピングを修正すると、6台すべてのSSDがモデル、容量、温度データ付きで表示されました。

マッピングが正しくなると、ダッシュボードにはプレースホルダーの「ディスクが見つかりません」カードではなく、各SSDのモデル、容量、温度、使用状況を表示できます。この修正は、ZimaOSが物理PCIデバイスを画面上のスロットに関連付ける方法を変更するもので、ファイルシステムのデータを修復するものではありません。

UIとは独立してNVMeの健全性を確認する方法

nvme list
nvme smart-log /dev/nvme0
smartctl -a /dev/nvme0

nvme-cliのヘルスチェックは、標準的なLinuxのNVMeツールを提供します。ダッシュボードが疑わしいものの、ドライブの健全性を示す証拠が必要な場合に使用してください。

スロットマッピングを編集すべきでない場合

NVMeデバイスが lspci および lsblk、UIだけの問題ではありません。まずBIOS、ドライブの装着状態、スロットのプロトコル、電源、ハードウェアの互換性を確認してください。スロットマップを編集しても、物理的に検出されていないドライブを表示させることはできません。

ZimaCube 2のストレージRAIDの復旧では、より安全なリファレンスアーキテクチャを紹介しています。

よくある質問

ZimaOSでディスクがないと表示されるのに、BeelinkのRAIDが動作するのはなぜですか?

ZimaOSの視覚的なスロットマップがBeelinkのPCIトポロジーと一致しなくても、LinuxはRAIDを組み立ててマウントできます。

認識されないNVMeカードを修正するために、RAIDを再作成すべきですか?

いいえ。データが読み取れ、アレイが正常なら、動作しているアレイを破棄するのではなく、UIのマッピングを修正するか報告してください。

lsblk -o hctlで何も表示されないのはなぜですか?

NVMeデバイスはPCIeデバイスであり、以前の回避策ではlspciのアドレスを使用していました。HCTLはSCSI/SATA形式のデバイスマッピングにより関係します。

ZimaOSのUIが正しくない場合でも、nvme-cliを使えますか?

はい。デバイスがLinuxから認識できる場合に限ります。nvme smart-logを使えば、ダッシュボードとは独立して、健康状態、温度、エラーカウンターを確認できます。

local-storage.confの編集は、今でも推奨される最初の手順ですか?

いいえ。これはZima以外のハードウェア向けの歴史的な回避策です。まず現在のリリースをテストし、手動編集の前に設定のバックアップを保管してください。