التوصيل الساخن للمعالج والذاكرة (CPU & Memory Hot-Plug)

قم بتوسيع المعالج (vCPU) والذاكرة للجهاز الافتراضي الخاص بك دون إعادة الإقلاع. أضف vCPUs أو زد الذاكرة العشوائية (RAM) أثناء تشغيل الضيف.

---

كيف يعمل؟

عند إنشاء جهاز VM عبر معالج Vapor، يتم تلقائيًا تهيئة جهاز VM مسبقًا للتوصيل الساخن للمعالج. يتطلب التوصيل الساخن للذاكرة تمكينه صراحةً أثناء الإنشاء.

الإعداد	السلوك الافتراضي	جاهز للتوصيل الساخن؟
Max vCPUs	يُحسب تلقائيًا كـ min(max(vcpus × 2, 8), host cores)	دائمًا
Max Memory	نفس الذاكرة	فقط إذا كان Max Memory > Memory

هامش المعالج (تلقائي)

عندما تترك Max vCPUs فارغًا في المعالج، يحسب Vapor حدًا أقصى معقولاً. على سبيل المثال، إنشاء VM بـ 2-vCPU على مضيف بـ 16 نواة يعطيك max_vcpus = 8 — هامش فوري للتوصيل الساخن.

• الصيغة: max_vcpus = min(max(vcpus × 2, 8), host_cores)
• يتم ضبط بنية المعالج للجهاز الافتراضي (المآخذ، القوالب، الأنوية، الخيوط) تلقائيًا لتتوافق.
• يمكن لجهاز VM قبول إضافات vCPU الحية فورًا حتى حد max_vcpus.

هامش الذاكرة (يجب تمكينه)

لزيادة الذاكرة لتتجاوز التخصيص الأولي أثناء تشغيل جهاز VM، اضبط Max Memory بأعلى من Memory عند إنشاء جهاز VM. ستجد هذا في لوحة Compute Options (انقر على More Options في معالج الإنشاء).

إعداد Max Memory	السلوك الحي
نفس الذاكرة (الافتراضي)	يمكن للذاكرة الانكماش/التمدد فقط داخل التخصيص الحالي عبر مبرمج البالون (balloon driver)
أعلى من الذاكرة	البالون + إضافة DIMM الساخنة — يمكنك زيادة الذاكرة حتى حد Max Memory دون إعادة التشغيل

---

كيفية التوصيل الساخن (معالج التعديل)

1. افتح درج تفاصيل VM بالنقر على اسم VM في القائمة.
2. انقر على زر Edit في الأعلى.
3. يفتح معالج التعديل. اضبط القيم:
   • vCPUs — زيادة حسب الحاجة، حتى سقف Max vCPUs.
   • Memory — زيادة أو تقليل حسب الحاجة.
4. انقر على Save. تُطبق التغييرات فورًا إذا كان جهاز VM يدعم التوصيل الساخن الحي.

إذا قمت بضبط قيم تتطلب إعادة تشغيل (مثل تغيير سقف vCPU أو سقف الذاكرة)، يتم حفظ التغييرات في التهيئة الدائمة وتدخل حيز التنفيذ في الإقلاع القادم لـ VM.

ما يمكنك تغييره على VM شغال

التغيير	التأثير
زيادة vCPUs (ضمن Max vCPUs)	حي — يُطبق فورًا
زيادة الذاكرة (ضمن Max Memory)	حي — بالون أو إضافة DIMM الساخنة
تقليل الذاكرة	حي — مبرمج البالون
رفع Max vCPUs أو Max Memory	مَحفوظ في التهيئة، يُطبق بعد إعادة التشغيل
تغيير البرنامج الثابت (UEFI, Secure Boot, TPM)	معطل — يجب إيقاف VM أولاً
تغيير بنية CPU (المآخذ، الأنوية)	للتهيئة فقط — يُطبق بعد إعادة التشغيل

---

رسائل الأخطاء الشائعة

تظهر هذه الرسائل كتنبيهات مدمجة في الزاوية العلوية اليمنى من واجهة المستخدم، أو كتحذيرات داخلية في النموذج.

الرسالة	السبب والحل
This operation requires the VM to be stopped.	حاولت تغيير البرنامج الثابت، أو نوع الجهاز، أو تمرير PCI على VM شغال. أوقف VM أولاً.
Failed to add CPU.	فشل التوصيل الساخن لـ vCPU. قد لا يكون لـ VM هامش — عند التعديل، تأكد من أن Max vCPUs أكبر من vCPUs. تحقق أيضًا من دعم الضيف للتوصيل الساخن لـ CPU.
Failed to add memory.	فشل التوصيل الساخن للذاكرة. قد يكون مبرمج البالون مفقودًا في الضيف، أو استُنفدت فتحات إضافة DIMM الساخنة.
Hotplug operation failed.	خطأ توصيل ساخن عام. تحقق من سجلات الخادم للحصول على التفاصيل.
Hotplug is not supported for this resource.	تهيئة VM لا تدعم عملية التوصيل الساخن المطلوبة.

التحذيرات الداخلية (نموذج المعالج)

الرسالة	أين تظهر	المعنى
⚠ Mismatch with max_vcpus (X). max_vcpus will be updated to Y.	نافذة Compute Options	حاصل ضرب البنية (المآخذ × القوالب × الأنوية × الخيوط) لا يطابق Max vCPUs. تُصحح القيمة تلقائيًا عند الحفظ.
Firmware, machine type, and PCI passthrough edits are disabled until the VM is stopped.	ترويسة معالج التعديل	فتحت معالج التعديل على VM شغال. تم قفل الحقول التي تتطلب الإيقاف.

---

استكشاف المشكلات وإصلاحها

"DIMM hot-add unavailable" في سجلات الخادم

السبب: تم إنشاء VM بدون Max Memory > Memory. الحل: أوقف VM، وافتح معالج التعديل، واضبط Max Memory بأعلى من Memory، ثم شغل VM.

عدم رؤية الضيف لمعالجات CPU الجديدة بعد التوصيل الساخن

echo 1 | tee /sys/devices/system/cpu/cpu*/online

عدم رؤية الضيف للذاكرة الجديدة بعد التوصيل الساخن

grep -l offline /sys/devices/system/memory/memory*/state | while read f; do echo online > "$f"; done