Cara instal dan konfigurasi qemu-agent di proxmox

QEMU Guest Agent adalah software kecil yang diinstal di dalam virtual machine (VM), yang memungkinkan komunikasi antara Proxmox host dan guest VM melalui QEMU protocol.

APA ITU QEMU Guest Agent?

QEMU Guest Agent adalah service yang berjalan di dalam VM, digunakan oleh Proxmox untuk:

• Menampilkan IP address guest di dashboard Proxmox
• Shutdown VM secara benar (bukan force)
• Freeze filesystem saat backup (snapshot)
• Copy file dari/ke guest
• Resize disk dengan clea

QEMU Guest Agent sangat direkomendasikan untuk:

• Backup snapshot tanpa korupsi
• Shutdown aman via web Proxmox
• Monitoring IP secara otomatis

Fungsi utama qemu-agent proxmox :

Fitur	Penjelasan
📡 Deteksi IP Address VM	Menampilkan IP guest VM langsung di UI Proxmox
🔌 Shutdown / Reboot Halus (Graceful)	Shutdown VM dari Proxmox akan dilakukan dengan benar, bukan forced
📸 Backup Snapshot Aman (Freeze FS)	File system dibekukan (freeze) dulu saat snapshot, mencegah data korup
🪄 Resize Disk Dinamis	Resize disk bisa dilakukan secara online (tanpa reboot)
📂 Copy File Guest ↔ Host	Dapat saling transfer file antara host Proxmox dan VM
📊 Monitoring Resource Guest	Bisa membaca info OS guest seperti uptime, hostname, waktu, dll

A. Cara Install QEMU Agent di Linux (Ubuntu/Debian/CentOS)

Untuk Ubuntu/Debian:

sudo apt update
sudo apt install qemu-guest-agent -y

Untuk CentOS/RHEL:

sudo yum install qemu-guest-agent -y

3. Aktifkan & jalankan agent

sudo systemctl enable qemu-guest-agent
sudo systemctl start qemu-guest-agent

3. Jangan lupa untuk aktif aktifkan Qemu Guest Agent

---

B. Cara Install QEMU Guest Agent di Windows

1. Download QEMU Guest Agent (versi VirtIO)

• Kunjungi: https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/latest-virtio/
• Download installer: virtio-win-guest-tools.exe (isi QEMU Guest Agent + driver)

2. Install di dalam Windows VM

• Jalankan installer sebagai Administrator
• Centang QEMU Guest Agent
• Ikuti wizard hingga selesai
• Reboot VM setelah instalasi

---

C. Konfigurasi Proxmox Agar Menggunakan QEMU Agent

1. Masuk ke Proxmox Web UI

Pilih VM > klik “Options”

2. Aktifkan QEMU Agent

• Cari opsi QEMU Agent
• Klik dua kali → ubah ke Yes

3. Restart VM

Agar Proxmox bisa membaca informasi (IP, dll) dari agent

---

Cek Status Agent dari Proxmox

qm agent <vmid> ping

Contoh:

qm agent 101 ping

Jika balas "return": {}, artinya agent aktif.

{
"return": {}
}

---

Fitur QEMU Agent yang Aktif Jika Berhasil:

Fitur	Keterangan
Shutdown VM via Proxmox (tanpa ACPI)	✅ Graceful shutdown
Tampil IP guest di summary	✅ Langsung terlihat IP VM dari Proxmox
Snapshot dengan fs-freeze	✅ File system dibekukan saat backup
Resize disk (online)	✅ Resize disk otomatis tanpa reboot

Troubleshooting

Masalah	Solusi
IP VM tidak muncul di Proxmox	Pastikan agent jalan (systemctl status)
Agent tidak bisa start	Cek log journalctl -xe
Agent tidak terinstall	Reinstall atau update VM