حلّ المجتمع

إصلاح مشكلة فقدان أقراص SATA أو NVMe على أجهزة ZimaOS من جهات خارجية: مقارنة ملف local-storage.conf التاريخي بالإصدارات الحالية

An October 2024 IceWhale tutorial for third-party x86 systems where disks existed in Linux but appeared incorrectly or were missing from ZimaOS storage UI. It used local-storage.conf to map SATA starting numbers and NVMe PCI addresses. Later releases added direct third-party NVMe and disk-shelf fixes, and a community reply found spaces worked better than the original comma-separated NVMe example.

عالج الدليل التعليمي الأصلي من عام 2024 مشكلة توافق في العرض/التعيين على الأجهزة غير التابعة لـ ZimaCube. وافترض أن أدوات Linux مثل lsblk أو lspci تستطيع رؤية جهاز SATA أو NVMe بالفعل، لكن رف التخزين في ZimaOS لم يكن يعيّن تخطيط وحدة تحكم الجهة الخارجية بشكل صحيح.

يهم هذا التمييز اليوم لأن ZimaOS الحالي تلقّى منذ ذلك الحين عدة إصلاحات للتخزين التابع لجهات خارجية. فقد أصلح ZimaOS 1.4.4 صراحةً مشكلة ظهور أقراص NVMe التابعة لجهات خارجية على أنها مفقودة في التخزين، كما حسّن الإصدار 1.6.1 منطق عرض رفوف الأقراص للأجهزة التابعة لجهات خارجية التي تحتوي على عدد كبير من الأقراص. حدّث النظام أولًا قبل تعديل ملف الإعدادات التاريخي.

استخدم إصلاح SATA التاريخي SataStartNumber

طلب المصدر الرسمي من مستخدمي SATA فحص عنونة وحدة التحكم باستخدام:

lsblk -o hctl

ثم عدّل /etc/casaos/local-storage.conf لذلك SataStartNumber تطابق ترقيم HCTL المتوقع من الجهاز.

طرفية ZimaOS تعرض ناتج HCTL للأمر lsblk بجانب local-storage.conf مع إبراز SataStartNumber
غيّر الحل البديل الوارد في المصدر منطق تعيين واجهة ZimaOS بعد التأكد من ترقيم وحدة تحكم SATA.

استخدم إصلاح NVMe التاريخي عناوين PCI

بالنسبة إلى أجهزة NVMe، استخدم المصدر lspci لتحديد عناوين PCI ووضعها في NVME حقل من ملف الإعدادات نفسه قبل إعادة التشغيل zimaos-local-storage.

طرفية ZimaOS تعرض عناوين PCI متعددة لأقراص NVMe وسطر NVME في local-storage.conf
استخدم الدليل الأصلي عناوين PCI لإخبار واجهة التخزين بمكان أجهزة NVMe التابعة لجهات خارجية.

يتضمن الموضوع خلافًا حقيقيًا حول الفاصل

يذكر النص الرسمي لعام 2024 أنه ينبغي فصل عناوين NVMe المتعددة بفواصل. وفي أكتوبر 2025، أفاد أحد أفراد المجتمع بأن الفواصل لم تعمل على نظامه، وأن المسافات هي التي نجحت.

ينبغي أن يظل هذا التناقض ظاهرًا. فهو دليل على أن تنسيق الملف اليدوي أو سلوك المحلل قد تغيّر أو اختلف بين الإصدارات؛ وليس سببًا للإعلان عن أن أحد الفواصل صحيح عالميًا لإصدارات ZimaOS الحالية.

أضاف ZimaOS 1.4.4 إصلاحًا على مستوى المنتج لأقراص NVMe التابعة لجهات خارجية

تذكر ملاحظات إصدار IceWhale 1.4.4 صراحةً أنه تم إصلاح مشكلة ظهور أقراص NVMe من أجهزة الجهات الخارجية على أنها مفقودة في التخزين.

راجع إصلاح عرض أقراص NVMe التابعة لجهات خارجية الرسمي.

حسّن ZimaOS 1.6.1 عرض رفوف الأقراص الكبيرة التابعة لجهات خارجية بشكل أكبر

حسّنت IceWhale لاحقًا منطق عرض رفوف الأقراص عندما تحتوي أجهزة الجهات الخارجية على عدد كبير من الأقراص. ويتداخل ذلك مباشرةً مع مشكلة تعيين الواجهة القديمة، وهو سبب آخر لعدم شروع المستخدمين الحاليين في تعديل إعدادات عام 2024.

حدّد أولًا ما إذا كان القرص مفقودًا من Linux أم من واجهة المستخدم فقط

  • إذا lspci/lsblk إذا تعذر عليه رؤية الجهاز، فتحقق من الأجهزة ووضع وحدة التحكم والطاقة وإحكام التوصيل ودعم برامج التشغيل.
  • إذا كان Linux يرى الجهاز، لكن التخزين لا يراه، فاجمع إصدار ZimaOS الحالي والأدلة من واجهة المستخدم وخدمة التخزين.

تعامل مع تعديلات local-storage.conf باعتبارها تاريخية/متقدمة

أصبح ZimaOS الآن نظام تشغيل جهاز أكثر ثباتًا وغير قابل للتغيير مقارنةً بالعديد من توزيعات Linux العامة. التعديلات اليدوية ضمن /etc قد يعتمد ذلك على الإصدار وقد تستبدله تحديثات لاحقة. احتفظ بنسخة من الملف الأصلي واستعن بإرشادات الدعم الحالية إذا استمرت الواجهة الحديثة في التعرف على الأقراص بشكل خاطئ.

بلاطة قرص مفقودة لا تعني أن القرص مفقود

كان البرنامج التعليمي المصدر يتناول أساسًا كيفية ترتيب الأقراص التابعة لجهات خارجية وإظهارها في واجهة تخزين ZimaOS. إذا lsblk وعندما تعرض سجلات النواة محركًا، لكن لا تعرضه صفحة التخزين بشكل صحيح، فإن المشكلة تختلف عن مشكلة وحدة تحكم أو برنامج تشغيل لا يستطيع اكتشاف القرص أصلًا.

أنشئ نسخة احتياطية من local-storage.conf قبل تعديله

تعديل ملف إعدادات ZimaOS الأصلي هو الأسلوب التاريخي. احفظ الملف الأصلي أولًا وسجّل إصدار ZimaOS الحالي حتى تتمكن من التراجع إذا ساء عرض رف الأقراص بعد التغيير.

نظرًا لأن إصدارات التحديث عبر الهواء غيّرت منذ ذلك الحين طريقة تعامل النظام مع الأقراص التابعة لجهات خارجية، فقد تصبح القيمة القديمة المعدّلة يدويًا غير صالحة بعد التحديث أيضًا.

يمكن أن تتغير عناوين PCI عند تغيير بنية الأجهزة

يمكن أن يؤدي نقل بطاقة NVMe إلى فتحة أخرى أو تغيير إعداد تقسيم PCIe أو تحديث البرنامج الثابت للمنصة إلى تغيير طريقة تعداد الأجهزة. لذلك فإن قائمة العناوين المرمّزة ثابتًا تخص بنية الأجهزة تلك، لا طراز SSD نفسه.

الحفاظ على اختلاف الفواصل في المصدر

تصف التعليمات الرسمية لعام 2024 عناوين NVMe المفصولة بفواصل، بينما ذكر مستخدم من المجتمع لاحقًا أن المسافات نجحت على نظامه وأن الفواصل لم تنجح. لا توجد أدلة مصدرية كافية لاستبدال الصيغة الرسمية بمتغير المجتمع على نحو شامل.

في الإصدار الحالي، حدّث النظام أولًا واستخدم سلوك المحلل الحالي الدقيق قبل تعديل الحقل.

حصلت أرفف الأقراص الكبيرة التابعة لجهات خارجية على تحسينات لاحقة على مستوى المنتج

حسّن ZimaOS 1.6.1 تحديدًا سلوك العرض للأجهزة التابعة لجهات خارجية التي تحتوي على عدد أكبر من الأقراص. لذلك ينبغي للمستخدمين الذين لديهم بطاقات HBA أو حاويات متعددة الفتحات أو أكثر من ستة أقراص إعادة إنتاج المشكلة على الإصدار الحالي قبل تغيير إعدادات أرقام الرفوف القديمة.

الأسئلة الشائعة حول عرض الأقراص التابعة لجهات خارجية

هل يعني عدم ظهور قرص في رف ZimaOS أن Linux لا يستطيع رؤيته؟

لا. كان البرنامج التعليمي الأصلي يتناول تحديدًا الحالات التي تكون فيها الأجهزة موجودة، لكن تعيينها في واجهة المستخدم غير صحيح.

هل أضاف ZimaOS لاحقًا إصلاحات رسمية؟

نعم. أصلح الإصدار 1.4.4 مشكلة ظهور أقراص NVMe التابعة لجهات خارجية على أنها مفقودة، كما حسّن الإصدار 1.6.1 عرض أرفف الأقراص التابعة لجهات خارجية.

هل ينبغي للمستخدمين الحاليين تعديل SataStartNumber أو NVME بشكل عشوائي؟

لا. حدّث طبقة العطل الحالية وأكّدها أولًا.