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だけの問題なのかを確認する
- もし
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 を無条件に編集すべきですか？
いいえ。まず現在の障害箇所を更新して確認してください。
