커뮤니티 솔루션

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 설치 환경에서 RAID 0/5 스토리지는 SMB를 통해 계속 읽고 쓸 수 있었지만 대시보드에는 NVMe 디스크가 누락되었거나 잘못된 여유 공간 정보가 표시되었습니다. 이는 Linux와 RAID 계층이 이미 장치를 인식하고 있다는 의미입니다. 문제가 있는 계층은 ZimaOS의 물리적 슬롯 매핑/UI입니다.

Beelink ME Mini에서 NVMe 디스크가 누락된 것으로 표시되는 RAID5 풀을 보여 주는 ZimaOS 스토리지
풀에는 계속 액세스할 수 있었지만, 기본 RAID는 정상적으로 작동하는데도 ZimaOS에서는 NVMe 슬롯 4개가 누락된 것으로 표시되었습니다.
시각적 슬롯 맵에서 NVMe 구성원이 누락된 것으로 표시되는 RAID0 풀을 보여 주는 ZimaOS 스토리지
두 번째 풀에서도 동일한 불일치가 나타났습니다. 실제로는 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용. 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 매핑을 수정하기 전 대시보드의 ZimaOS Storage에 6개의 NVMe 디스크가 누락된 것으로 표시된 화면
풀이 존재했음에도 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 도구를 제공합니다. 대시보드가 의심스럽지만 드라이브 상태를 입증할 근거가 여전히 필요한 경우 사용하세요.

슬롯 매핑을 편집하지 말아야 할 때

에서 누락된 경우 lspcilsblkNVMe 장치가 RAID 복구에 표시되지 않는다면, UI만의 문제가 아닙니다. 먼저 BIOS, 드라이브 장착 상태, 슬롯 프로토콜, 전원 및 하드웨어 호환성을 확인하세요. 슬롯 맵을 편집해도 물리적으로 감지되지 않는 드라이브가 나타나지는 않습니다.

ZimaCube 2 스토리지RAID 복구는 더 안전한 참조 아키텍처를 제공합니다.

FAQ

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가 아닌 하드웨어를 위한 과거의 우회 방법입니다. 먼저 현재 릴리스를 테스트하고 수동으로 편집하기 전에 구성 백업을 보관하세요.