↓ Skip to main content
BisaCloud Docs

Mengaktifkan QEMU Guest Agent di Proxmox VE

·2 mins
Proxmox Kvm Proxmox
Table of Contents

QEMU Guest Agent memungkinkan host Proxmox berkomunikasi dengan sistem operasi di dalam virtual machine (VM). Fitur ini digunakan untuk mendapatkan informasi jaringan, melakukan shutdown yang lebih aman, sinkronisasi waktu, serta berbagai operasi manajemen lainnya.

Untuk menggunakannya, Anda perlu:

  1. Menginstal dan menjalankan QEMU Guest Agent di dalam guest OS.
  2. Mengaktifkan fitur Guest Agent pada konfigurasi VM di Proxmox.

Instalasi QEMU Guest Agent di Guest OS
#

Debian / Ubuntu
# 

apt update
apt install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

RHEL / CentOS / AlmaLinux / Rocky Linux
# 

dnf install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

Mengaktifkan QEMU Guest Agent pada VM
#

Jalankan perintah berikut di node Proxmox. Ganti <VMID> dengan ID VM yang sesuai.

# Mengaktifkan Guest Agent
qm set <VMID> --agent enabled=1

# Rekomendasi: aktifkan TRIM otomatis untuk disk hasil cloning
qm set <VMID> --agent enabled=1,fstrim_cloned_disks=1

Verifikasi konfigurasi:

qm config <VMID> | grep ^agent
Perintah qm set hanya mengubah konfigurasi VM di Proxmox. Perubahan tersebut belum tentu langsung diterapkan pada VM yang sedang berjalan.

Apakah VM Perlu Direstart?
#

Tergantung pada kondisi VM saat fitur Guest Agent diaktifkan.

Tidak Perlu Restart
#

Jika opsi Guest Agent sudah aktif pada konfigurasi VM sebelumnya, kemudian Anda hanya menginstal dan menjalankan service qemu-guest-agent di dalam guest OS, maka restart VM biasanya tidak diperlukan.

Perlu Power Cycle
#

Jika VM sudah berjalan dan opsi Guest Agent baru saja diaktifkan melalui qm set, sebaiknya lakukan shutdown penuh lalu nyalakan kembali VM agar perangkat Guest Agent terdeteksi dengan benar oleh sistem operasi guest.

qm shutdown <VMID>
qm start <VMID>
Reboot dari dalam sistem operasi guest tidak selalu cukup. Dalam beberapa kasus, diperlukan proses shutdown dan start kembali dari sisi Proxmox agar perangkat Guest Agent tersedia di VM.

Verifikasi QEMU Guest Agent
#

Setelah VM kembali berjalan, lakukan pengujian dari host Proxmox:

qm agent <VMID> ping

Jika berhasil, output yang muncul adalah:

{}

Untuk melihat informasi jaringan dari guest OS:

qm agent <VMID> network-get-interfaces

Anda juga dapat memeriksa status agent melalui antarmuka web Proxmox pada menu VM → Summary, yang akan menampilkan status QEMU Guest Agent apabila komunikasi telah berjalan dengan baik.

Related