2024년 소스 튜토리얼은 ZimaCube가 아닌 하드웨어에서 발생하는 표시/매핑 호환성 문제를 다루었습니다. SATA 또는 NVMe 장치가 이미 lsblk나 lspci 같은 Linux 도구에서 인식되고 있지만, ZimaOS의 스토리지 선반이 타사 컨트롤러 레이아웃을 올바르게 매핑하지 못한다고 가정했습니다.
이러한 구분은 오늘날 중요합니다. 현재 ZimaOS에는 이후 여러 타사 스토리지 수정 사항이 적용되었기 때문입니다. ZimaOS 1.4.4에서는 스토리지에 타사 NVMe 디스크가 누락된 것으로 표시되는 문제가 명시적으로 수정되었고, 1.6.1에서는 디스크가 많은 타사 시스템의 디스크 선반 표시 로직이 최적화되었습니다. 기존 구성 파일을 편집하기 전에 먼저 업데이트하세요.
기존 SATA 수정 사항은 SataStartNumber를 사용했습니다
공식 소스는 SATA 사용자가 다음 명령으로 컨트롤러 주소를 확인하도록 안내했습니다.
lsblk -o hctl그런 다음 다음을 편집합니다. /etc/casaos/local-storage.conf 따라서 SataStartNumber 컴퓨터에서 예상되는 HCTL 번호와 일치했습니다.
기존 NVMe 수정 사항은 PCI 주소를 사용했습니다
NVMe 장치의 경우 소스에서는 다음을 사용했습니다. lspci PCI 주소를 식별하여 NVME 다시 시작하기 전에 동일한 구성 파일의 zimaos-local-storage.
이 스레드에는 실제 구분자 불일치가 있습니다
공식 2024년 문서에는 여러 NVMe 주소를 쉼표로 구분해야 한다고 나와 있습니다. 2025년 10월에는 한 커뮤니티 사용자가 자신의 시스템에서 쉼표가 작동하지 않고 공백은 작동한다고 보고했습니다.
이 모순은 그대로 드러나 있어야 합니다. 이는 수동 파일 형식이나 파서 동작이 버전마다 변경되었거나 달랐다는 증거이지, 현재 ZimaOS에서 특정 구분자가 보편적으로 올바르다고 단정할 근거가 아닙니다.
ZimaOS 1.4.4, 제품 수준의 타사 NVMe 수정 사항 추가
IceWhale의 1.4.4 릴리스 노트에는 타사 장치의 NVMe 디스크가 스토리지에 누락된 것으로 표시되는 문제가 수정되었다고 명시되어 있습니다.
공식 타사 NVMe 표시 수정 사항을 참조하세요.
ZimaOS 1.6.1, 대규모 타사 디스크 선반을 추가로 최적화
IceWhale은 이후 타사 장치에 디스크가 너무 많을 때 디스크 선반 표시 로직을 최적화했습니다. 이는 기존 UI 매핑 문제와 직접적으로 관련되며, 현재 사용자가 2024년 구성 파일을 편집하는 것부터 시작해서는 안 되는 또 다른 이유입니다.
먼저 디스크가 Linux에서 누락된 것인지, UI에서만 누락된 것인지 확인하세요
- If
lspci/lsblk장치를 볼 수 없다면 하드웨어, 컨트롤러 모드, 전원, 장착 상태 및 드라이버 지원을 조사하세요. - Linux에서는 장치가 보이지만 Storage에서는 보이지 않는다면 현재 ZimaOS 버전과 UI/스토리지 서비스 관련 증거를 수집하세요.
local-storage.conf 편집은 과거 방식 또는 고급 작업으로 취급
ZimaOS는 이제 많은 일반 Linux 배포판보다 더 불변적인 어플라이언스 OS에 가깝습니다. 수동 편집 /etc 버전에 따라 동작이 달라질 수 있으며 이후 업데이트로 대체될 수 있습니다. 원본 파일의 사본을 보관하고, 최신 UI에서 여전히 디스크를 잘못 식별한다면 현재 지원 안내를 따르세요.
디스크 타일 누락은 디스크 자체의 누락과 다릅니다
원본 튜토리얼은 주로 타사 디스크가 ZimaOS Storage UI에서 어떻게 배열되고 표시되는지를 다뤘습니다. 만약 lsblk 커널 로그에서는 드라이브가 보이지만 Storage 페이지에 올바르게 표시되지 않는다면, 이는 컨트롤러/드라이버가 디스크 자체를 전혀 감지하지 못하는 경우와는 다른 문제입니다.
편집하기 전에 local-storage.conf 백업
기존 방식은 ZimaOS의 기본 구성 파일을 수정합니다. 먼저 원본 파일을 저장하고 현재 ZimaOS 버전을 기록하여, 변경 후 디스크 선반 상태가 악화되면 되돌릴 수 있도록 하세요.
OTA 릴리스 이후 타사 디스크 처리 방식이 변경되었으므로, 오래전에 수동 편집한 값은 업데이트 후 더 이상 유효하지 않을 수 있습니다.
하드웨어 토폴로지가 변경되면 PCI 주소가 바뀔 수 있음
NVMe 카드를 다른 슬롯으로 옮기거나, PCIe 바이퍼케이션 설정을 변경하거나, 플랫폼 펌웨어를 업데이트하면 장치 열거 방식이 바뀔 수 있습니다. 따라서 하드코딩된 주소 목록은 SSD 모델 자체가 아니라 해당 하드웨어 토폴로지에 종속됩니다.
소스의 구분 기호 불일치 유지
공식 2024년 지침에서는 쉼표로 구분된 NVMe 주소를 설명하지만, 이후 한 커뮤니티 사용자는 자신의 시스템에서 공백은 작동하고 쉼표는 작동하지 않았다고 말했습니다. 커뮤니티 방식으로 공식 구문을 보편적으로 대체할 만큼 충분한 근거는 없습니다.
현재 릴리스에서는 먼저 업데이트하고 필드를 편집하기 전에 현재 파서의 정확한 동작을 사용하세요.
대형 타사 디스크 선반에 이후 제품 수준의 개선 사항 적용
ZimaOS 1.6.1에서는 디스크 수가 많은 타사 장치의 표시 동작이 특별히 개선되었습니다. 따라서 HBA 카드, 다중 베이 인클로저 또는 6개를 초과하는 드라이브를 사용하는 사용자는 기존 선반 번호 설정을 변경하기 전에 현재 릴리스에서 문제를 재현해야 합니다.
타사 디스크 표시 FAQ
ZimaOS 선반에서 디스크가 누락되었다고 해서 Linux에서도 해당 디스크를 인식하지 못한다는 의미인가요?
아니요. 원래 튜토리얼은 하드웨어는 존재하지만 UI 매핑이 잘못된 경우를 구체적으로 다뤘습니다.
ZimaOS에 이후 공식 수정 사항이 추가되었나요?
예. 1.4.4에서는 타사 NVMe 디스크가 누락된 것으로 표시되는 문제가 해결되었고, 1.6.1에서는 타사 디스크 선반 표시가 최적화되었습니다.
현재 사용자는 SataStartNumber 또는 NVME를 무작정 편집해야 하나요?
아니요. 먼저 현재 실패 계층을 업데이트하고 확인하세요.
