Hot-Plug CPU & Memori

Tambah atau tingkatkan CPU dan memori mesin virtual tanpa reboot. Aktifkan vCPU tambahan atau tambah RAM saat VM sedang berjalan.

---

Cara Kerja

Saat Anda membuat VM melalui wizard Vapor, VM secara otomatis dikonfigurasi untuk hot-plug CPU. Hot-plug memori harus diaktifkan secara eksplisit saat pembuatan.

Pengaturan	Perilaku Default	Siap Hot-Plug?
Max vCPUs	Dihitung otomatis: min(max(vcpus × 2, 8), core host)	Selalu
Max Memory	Sama dengan Memory	Hanya jika Max Memory > Memory

Headroom CPU (Otomatis)

Saat Anda membiarkan Max vCPUs kosong di wizard, Vapor akan menghitung batas atas yang wajar. Misalnya, membuat VM 2-vCPU pada host 16-core akan menghasilkan max_vcpus = 8 — headroom instan untuk hot-plug.

• Rumus: max_vcpus = min(max(vcpus × 2, 8), core_host)
• Topologi CPU (sockets, dies, cores, threads) VM disesuaikan secara otomatis agar cocok.
• VM Anda langsung dapat menerima penambahan vCPU secara live hingga batas max_vcpus.

Headroom Memori (Harus Diaktifkan)

Untuk menambah memori melebihi alokasi awal saat VM berjalan, atur Max Memory lebih besar dari Memory saat membuat VM. Anda akan menemukannya di panel Compute Options (klik More Options di wizard pembuatan).

Pengaturan Max Memory	Perilaku Live
Sama dengan Memory (default)	Memori hanya bisa menyusut/mengembang dalam alokasi saat ini melalui balloon driver
Lebih besar dari Memory	Balloon + DIMM hot-add — Anda dapat menambah memori hingga batas Max Memory tanpa restart

---

Cara Melakukan Hot-Plug (Wizard Edit)

1. Buka drawer detail VM dengan mengklik nama VM di daftar.
2. Klik tombol Edit di bagian atas.
3. Wizard edit akan terbuka. Sesuaikan nilai:
   • vCPUs — tambah sesuai kebutuhan, hingga batas Max vCPUs.
   • Memory — tambah atau kurangi sesuai kebutuhan.
4. Klik Save. Perubahan berlaku segera jika VM mendukung live hot-plug.

Jika Anda menyesuaikan nilai yang memerlukan restart (seperti menaikkan batas vCPU atau batas memori), perubahan disimpan ke konfigurasi persisten dan berlaku pada boot VM berikutnya.

Yang Dapat Anda Ubah pada VM Berjalan

Perubahan	Efek
Tambah vCPU (dalam Max vCPUs)	Live — berlaku segera
Tambah memori (dalam Max Memory)	Live — balloon atau DIMM hot-add
Kurangi memori	Live — balloon driver
Naikkan Max vCPUs atau Max Memory	Disimpan ke konfigurasi, berlaku setelah restart
Ubah firmware (UEFI, Secure Boot, TPM)	Dinonaktifkan — VM harus dimatikan terlebih dahulu
Ubah topologi CPU (sockets, cores)	Konfigurasi saja — berlaku setelah restart

---

Pesan Error Umum

Pesan ini muncul sebagai toast alert di sudut kanan atas UI, atau sebagai peringatan inline di formulir.

Pesan	Penyebab & Solusi
This operation requires the VM to be stopped.	Anda mencoba mengubah firmware, tipe mesin, atau PCI passthrough pada VM yang sedang berjalan. Matikan VM terlebih dahulu.
Failed to add CPU.	Hot-plug vCPU gagal. VM mungkin tidak memiliki headroom — saat mengedit, pastikan Max vCPUs lebih besar dari vCPUs. Periksa juga apakah guest mendukung CPU hot-plug.
Failed to add memory.	Hot-plug memori gagal. Balloon driver mungkin tidak terpasang di guest, atau slot DIMM hot-add sudah habis.
Hotplug operation failed.	Error hot-plug umum. Periksa log server untuk detail.
Hotplug is not supported for this resource.	Konfigurasi VM tidak mendukung operasi hot-plug yang diminta.

Peringatan Inline (Formulir Wizard)

Pesan	Lokasi	Arti
⚠ Mismatch with max_vcpus (X). max_vcpus akan diperbarui ke Y.	Modal Compute Options	Hasil kali topologi tidak cocok dengan Max vCPUs. Nilai dikoreksi otomatis saat disimpan.
Firmware, machine type, and PCI passthrough edits are disabled until the VM is stopped.	Header wizard edit	Anda membuka wizard edit pada VM berjalan. Field yang memerlukan penghentian VM dikunci.

---

Pemecahan Masalah

"DIMM hot-add unavailable" di log server

Penyebab: VM dibuat tanpa Max Memory > Memory. Solusi: Matikan VM, buka wizard Edit, atur Max Memory lebih besar dari Memory, nyalakan VM.

Guest tidak melihat CPU baru setelah hot-plug

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

Guest tidak melihat memori baru setelah hot-plug

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