Proxmox VE 9 Complete Guide

Panduan komprehensif dari konsep dasar hypervisor (Type-1 KVM/QEMU) hingga server produksi: arsitektur Proxmox VE 9 di atas Debian 13 Trixie, instalasi bare metal, manajemen storage LVM-thin/ZFS, jaringan VLAN terisolasi, upgrade path bertahap, optimasi VM Windows & Linux, migrasi VMware ESXi, dan backup terdistribusi 3-2-1.

9.x
Proxmox VE
Trixie
Debian 13
VLAN
Access + Trunk
3-2-1
Backup Safe
KVM
Type-1 HV
v2.7.8 DOC-PROXMOX-VE9-ALSYUNDAWY-2026-08
16 Agustus 2026 • Production Ready
Penulis & Maintainer: Harry Dertin Sutisna Alsyundawy
Target: Proxmox VE 9.2 (Debian 13 Trixie, Kernel 7.0, QEMU 11 / LXC 7 / ZFS 2.4)
v2.7.8 (16 Agustus 2026 - 07:30:00) — User Management, Rufus, LXC, VLAN sebelum Storage, Mobile Nav & Responsive Fix Current
  • Manajemen User (Bab baru setelah Post-Install Repo): ditambahkan panduan ringkas pveum berdasarkan dokumentasi resmi — realm (pam/pve), user@realm, group, role bawaan (Administrator, PVEAdmin, PVEVMAdmin, PVEAuditor), ACL path, API token, 2FA TOTP; contoh CLI praktis untuk produksi lab/enterprise tanpa materi yang tidak relevan.
  • Media Bootable USB: penambahan Rufus (mode DD Image) lengkap langkah Windows di samping BalenaEtcher dan dd Linux/macOS.
  • Urutan Bab: Konfigurasi Jaringan VLAN dipindah sebelum Manajemen Storage agar alur produksi (jaringan dulu, storage kemudian) lebih logis; penomoran section & navigasi disesuaikan.
  • Dasar Hypervisor & Ringkasan Arsitektur: diperkaya sesuai data 2026 (KVM Type-1 + QEMU VMM, LXC shared-kernel, multi-master pmxcfs, HCI Ceph/ZFS, SDN/EVPN, Arm64 official PVE 9.2) mengacu official admin guide — hanya poin relevan guide ini.
  • Mobile Nav & UX: perbaikan offcanvas agar klik link men-scroll ke section (scroll setelah dismiss), font link menu diperkecil agar tidak menutupi halaman, back-to-top dipastikan visible + z-index, matrix 9.1 & tabel lebar responsive (overflow-x, font lebih kecil 480–768px).
  • SEO & Responsive 480–2K: penyesuaian CSS mobile/tablet (iPhone, Xiaomi, Samsung, MacBook) — text, table, code block tidak terpotong; meta description diperbarui (user management, LXC, Rufus).
  • Bug fix: pastikan copy-btn, IntersectionObserver, dan struktur DOM section tetap utuh; tidak mengubah bagian yang sudah benar.
  • Content refresh (2.7.8-UPDATE): selaraskan versi komponen ke data resmi PVE 9.2 (Kernel 7.0 default, QEMU 11.0, LXC 7.0, ZFS 2.4, Ceph Tentacle 20.2 default / Squid 19.2 tetap didukung); catatan Dynamic Load Balancer, HA arm/disarm, SDN WireGuard fabric, OCI image LXC, Arm64 resmi; koreksi komentar HTML & tabel Ringkasan Konten; tanpa mengubah alur tutorial yang sudah benar.
v2.7.7 (16 Agustus 2026 - 04:13:18) — Penambahan Upgrade Path 3→4, 4→5, 5→6 & Pengayaan 8→9 (Bab 10)
  • Penambahan Jalur Upgrade PVE 3→4, 4→5, 5→6 (Bab 10): Sisipkan tiga tahap mayor baru berdasarkan wiki resmi Upgrade_from_3.x_to_4.0, Upgrade_from_4.x_to_5.0, dan Upgrade_from_5.x_to_6.0 — mencakup prasyarat khusus (OpenVZ→LXC, rebuild Corosync 1→2, purge SysVinit, upgrade Corosync 2→3 duluan, password root wajib), code block in-place APT (apt-get/apt), daftar breaking changes & known issues, serta langkah pasca-upgrade.
  • Perluasan Matriks Evolusi (9.1): tambah baris PVE 3.4 / 4.x / 5.4 (Debian Wheezy/Jessie/Stretch, Kernel, Ceph bawaan, QEMU, checklist CLI, breaking changes kritis) sehingga matriks mencakup 3→9 utuh.
  • Renumerasi Sub-Bab Upgrade: 9.2 (3→4), 9.3 (4→5), 9.4 (5→6), 9.5 (6→7), 9.6 (7→8), 9.7 (8→9), 9.8 (Pasca Upgrade), 9.9 (Troubleshooting) — urutan runtut tanpa merusak struktur DOM.
  • Pengayaan 8→9 (9.7): repo Ceph Squid deb822 lengkap (enterprise & no-subscription), penanganan error 401 via pvesubscription update --force, verifikasi apt policy, serta tambahan breaking changes (network interface pinning pve-network-interface-pinning, VM memory display >100%, NVIDIA vGPU minimal 18.3 / 570.158.02). Ref link disesuaikan ke http://pve.proxmox.com/wiki/Upgrade_from_8_to_9.
  • Matriks Evolusi 9.1 — Kolom Status & EOL: rapihkan tabel dengan menambahkan kolom Status & Akhir Dukungan (EOL) per baris (badge EOL/LTS/Current + keterangan: tidak didukung & repo archive, LTS masih didukung EOL est. Jul 2026, Target rilis aktif), serta padatkan breaking changes agar lebih informatif dan mudah dibaca.
  • Koreksi 8→9: Nonaktifkan pve-enterprise.list: tahap 8→9 sebelumnya hanya mengubah pve-enterprise.list bookworm→trixie tanpa menonaktifkannya, sehingga apt update berpotensi error 401 bagi pengguna no-subscription. Ditambahkan LANGKAH 6 yang meng-comment repo enterprise (sed -i 's/^deb/#deb/') + catatan lewati langkah bagi pengguna Enterprise berlangganan, serta penjelasan prasyarat terkait.
  • Koreksi Tanggal EOL PVE 8.4: perbaiki sel Status & EOL baris PVE 8.4 dari "EOL est. Jul 2026" menjadi EOL 31 Agustus 2026 (didaftar sebagai LTS, masih didukung hingga tanggal tersebut).
  • Responsif & SEO (480–2K): penyesuaian ukuran font & teks untuk mobile/tablet (iPhone, Xiaomi, Samsung, MacBook) agar tidak terpotong, tanpa mengubah struktur kode yang sudah benar.
  • Konsistensi Navigasi & Meta SEO: label navigasi (sidebar, offcanvas mobile, daftar isi/TOC, footer) diperbarui dari Upgrade Path 6→9 → Upgrade Path 3→9 dan meta description upgrade aman 6→7→8→9 → upgrade aman 3→4→5→6→7→8→9 agar selaras dengan jalur upgrade utuh 3→9.
v2.7.6 (16 Agustus 2026 - 01:19:42) — Rebuild: Validasi HTML & Pengayaan Upgrade Path PVE 6→9 (Bab 10)
  • Validasi HTML & Code Block Upgrade (Bab 10 — Upgrade Path 6→7→8→9): encode karakter khusus mentah pada perintah shell di dalam <pre><code> agar lulus html-validate (aturan no-raw-characters & parser-error). Karakter diubah: & → &amp; dan < → &lt;.
  • Perintah yang diperbaiki: apt update && apt dist-upgrade -y (Tahap 1 upgrade PVE 6→7, 7→8, 8→9) serta heredoc pembuatan repo deb822 PVE 9 / Ceph cat > /etc/apt/sources.list.d/proxmox.sources << 'EOF'. Hasil render & salin (innerText) tetap menampilkan && dan << secara benar.
  • Perbaikan Struktur DOM: tutup </div> yang hilang pada header entry changelog v2.7.5 sehingga card DocNote & container main-content tidak lagi terbuka hingga </body> (memperbaiki close-order / no-implicit-close untuk <html>, <body>, dan <div>).
  • Pengayaan Upgrade Path PVE 6→7→8→9 (Bab 10): perkuat panduan upgrade mayor — tambah 9.6 Troubleshooting Upgrade (matriks gejala / penyebab / solusi: grub failure, LXC cgroup v2, LVM thin lvconvert --repair, hang ntpsec, error 401 apt, audit kernel journald), modernisasi repo ke deb822 (.sources) + apt modernize-sources, matriks evolusi versi lebih kaya (kolom QEMU, badge EOL/LTS/Target, breaking changes per rilis), checklist pra-upgrade detail (tested restore, backup konfigurasi host, kapasitas root >5 GB, akses konsol independen tmux/screen, rolling cluster multi-node, known issues), serta metode in-place APT vs fresh install + restore.
v2.7.5 (15 Agustus 2026 - 08:44:38) — Bug Fix Changelog, Konsistensi Nav & SEO
  • Normalisasi Changelog & HTML Structure: samakan struktur wrapper v2.4.0–v2.7.4 (mb-3 pt-2 border-top, text-primary), perbaiki v2.7.2 yang hilang outer div, dan v2.7.4 yang missing </div> flex row.
  • Timestamps: tambah HH:MM:SS ke semua entry v2.7.0–v2.7.5 (kecuali v2.0.0).
  • Navigasi Konsisten: tambah Bab 0 ke Mobile TOC, update sidebar label ke "17 Bab", hapus section Repository Debian 13 (Bab 14) terpisah dan gabungkan ke dalam Post-Install Repository (Bab 4) sebagai subsection 4.5.
  • SEO Title Fix: perbaiki <title> dari 77 chars ke 61 chars (under 70 limit): "Proxmox VE 9: Instalasi, VLAN, Storage, Upgrade & Migrasi vSphere".
  • Konten Upgrade Justification: tambah subsection "Mengapa Upgrade ke Proxmox VE 9? (vs PVE 7/8)" di Bab 1 Ringkasan Arsitektur, mencakup kekurangan PVE 7/8 dan fitur baru PVE 9 (Kernel 6.14/7.0, QEMU 10, LXC 7, Ceph Squid 19.2, ZFS RAIDZ Expansion, deb822 repo, ESXi Import Wizard).
  • Ringkasan & Best Practices Komprehensif: ekspansi Bab 17 Ringkasan menjadi 7 area best practices (Instalasi/Storage, Jaringan/VLAN, Virtualisasi VM/CT, Backup 3-2-1, Storage ZFS/Ceph, HA/Recovery, Repository/Sistem, Migrasi/VM Tamu) + checklist 10 item.
  • Keamanan & Aksesibilitas: verifikasi tidak ada raw & di JSON-LD/code blocks, semua tombol salin memiliki aria-label, semua anchor target ter-cover, dan skip-to-content link aktif.
v2.7.4 (15 Agustus 2026 - 08:40:58) — Audit Komprehensif, Bug Fix & Best Practices
  • Audit Komprehensif & Bug Fix: perbaikan typo, verifikasi SRI CDN, validasi anchor/ID, cleanup entitas HTML, perbaikan struktur navigasi.
  • Aksesibilitas & SEO: tambah skip-to-content link, pastikan semua tombol salin memiliki aria-label, semua target anchor ter-cover, dan landmark ARIA tetap konsisten.
  • Keamanan: verifikasi tidak ada eval/document.write/inline handler, semua target=_blank memiliki rel=noopener, dan tidak ada mixed-content.
  • Stabilitas: pastikan 18 section seimbang, tanpa ID duplikat, JSON-LD valid, dan badge changelog hanya ada satu Current.
v2.7.3 (15 Agustus 2026 - 08:25:00) — Penambahan Bab Dasar Hypervisor & Pembaruan Hero/Ringkasan
  • Bab 0 (Prasyarat) Dasar Hypervisor & Virtualisasi: ditambahkan di paling awal berdasarkan materi HYPERVISOR.pptx — definisi hypervisor, perbedaan Type 1 (Bare-Metal: ESXi, Hyper-V, Xen, KVM/QEMU) vs Type 2 (Hosted: Workstation, VirtualBox, Parallels, UTM, Fusion), tabel perbandingan, keunggulan (isolasi, efisiensi, migrasi, manajemen, multi-OS, reliability), serta kaitan Proxmox VE 9 sebagai hypervisor Type-1 (KVM/QEMU + LXC di atas Debian 13).
  • Hero "Proxmox VE 9 Complete Guide": lead diperkaya (fondasi hypervisor Type-1 KVM/QEMU), ditambah stat KVM / Type-1 HV.
  • Ringkasan Arsitektur Proxmox VE 9 (Bab 1): intro diperbarui ke versi mutakhir (KVM/QEMU 10.x, LXC 7.x, ZFS 2.3.3, Ceph Squid 19.2), ditambah tabel Lapisan Arsitektur Proxmox VE 9, serta poin SDN/PCI Passthrough & LUKS/TLS.
v2.7.2 (15 Agustus 2026 - 08:10:00) — Pembaruan 6 Bab: Storage, Cluster/HA, Ceph, LXC, Backup & Best Practices
  • Storage (Bab 7): Tambah 5.11 — RAIDZ Expansion (ZFS 2.3/PVE 9), monitoring ZFS (zpool scrub/iostat/arcstat, SLOG/L2ARC), monitoring Hardware RAID via storcli/perccli, dan matriks pemilihan storage.
  • Cluster & HA (Bab 8): Tambah 7.8 — HA Rules/Location Constraints (ha-manager ruleadd location, HA tags), ha-manager crm, dan pemulihan quorum darurat (pvecm expected).
  • Ceph (Bab 9): Tambah 8.8 — PG autoscaling, balancer (upmap), failure domain, MGR dashboard, dan tuning osd_memory_target.
  • LXC (Bab 14): Perbaiki kesesuaian judul → konten — kini menyertakan penggantian port SSH (drop-in + mask ssh.socket), hardening key-based (ed25519), dan verifikasi sshd -T.
  • Backup (Bab 16): Tambah 15.5 — retensi/prune PBS (namespaces, prune simulator), verify & GC, dan opsi vzdump modern (--fleecing, incremental bitmap, --notes-template, --protected).
  • Ringkasan (Bab 17): Kartu best-practice modern (Storage ZFS/Ceph, HA & Recovery) dan checklist pra-instalasi diperluas.
v2.7.1 (15 Agustus 2026 - 07:50:00) — Penyempurnaan Migrasi VMware → Proxmox VE (Bab 15)
  • Modernisasi & Perkaya Migrasi VMware (Bab 15): Pembaruan menyeluruh panduan migrasi VMware ESXi/vCenter → Proxmox VE 9 menurut data 2026: prasyarat & batasan wizard (SSH TSM-SSH, versi ESXi diuji 6.5-8.0, pengecualian vSAN/disk terenkripsi, wajib konsolidasi snapshot), fitur Live Import, impor manual OVA/OVF & VMDK via qm importovf/qm importdisk + qemu-img, konversi V2V (virt-v2v, StarWind, Veeam), tabel mapping VMware→Proxmox (PVSCSI→VirtIO SCSI, VMXNET3→VirtIO Net, BIOS→SeaBIOS, EFI→OVMF, vTPM), penyesuaian qm set, trik bcdedit safeboot anti-BSOD Windows, serta matriks troubleshooting & rencana cutover/rollback.
v2.7.0 (15 Agustus 2026 - 07:35:00) — Edisi Lengkap: Hardware RAID & ZFS 4-8 Disk, Multi-Node Datacenter, Ceph Squid & Upgrade Path 6→9
  • Penyempurnaan Additional Storage (Bab 7): Integrasi komprehensif Hardware RAID 5/10 (PERC/MegaRAID) vs OpenZFS (RAIDZ1, RAIDZ2, RAIDZ3, Striped Mirrors/RAID 10) untuk 4 hingga 8 storage disk (misal 900 GB SAS/SATA/NVMe x4/x8), kalkulasi kapasitas/parity/IOPS, klarifikasi teknis ZFS Copy-on-Write vs RAID 4, serta tuning ARC Cache (zfs_arc_max).
  • Penyempurnaan Multi-Node Datacenter Cluster & HA (Bab 8): Penjelasan mendalam arsitektur terdistribusi pmxcfs, aturan Quorum ganjil matematis, integrasi Corosync QDevice untuk cluster 2-node, dual-link corosync, tutorial join CLI & GUI, safe node decommissioning (pvecm delnode), serta watchdog fencing (softdog).
  • Penyempurnaan Ceph Distributed Storage (Bab 9): Panduan menyeluruh implementasi Ceph Squid di PVE 9, arsitektur RADOS/MON/MGR/OSD/MDS, keuntungan eliminasi SAN eksternal, persyaratan hardware enterprise (PLP SSD, HBA IT-mode, dedicated 10GbE/25GbE+ public & cluster network), pembuatan pool RBD, dan prosedur maintenance (noout).
  • Penyempurnaan Upgrade Path 6→7→8→9 (Bab 10): Matriks evolusi Debian Buster→Bullseye→Bookworm→Trixie, prosedur cluster safety node-by-node, panduan pra-upgrade pve6to7, pve7to8, pve8to9, migrasi deb822, ZFS upgrade, dan cleanup sistem.
v2.6.0 (15 Agustus 2026 - 07:20:00) — Rilis Multi-Node Cluster, Ceph Squid & Upgrade Path
  • Dasar cluster Proxmox VE, inisialisasi Ceph, dan matriks upgrade versi.
v2.5.0 (15 Agustus 2026 - 07:05:00) — Rilis Arsitektur Jaringan VLAN
  • Penegasan arsitektur 2 interface (Access IP Management Host + Trunk multi-VLAN Guest Data).
  • Diversifikasi dan randomisasi VLAN ID berbeda di tiap skenario (VLAN 105, 220, 340, 515; VLAN 630, 770; VLAN 99).
v2.4.0 (15 Agustus 2026 - 06:50:00) — Standardisasi Penomoran & Script Creation
  • Standardisasi penomoran runtut dan penghapusan link download .sh dengan pembuatan script server.
  • Keamanan repositori HTTPS dan perluasan bypass instalasi Windows 11.
v2.0.0 (10 Agustus 2026) — Rilis Dasar Proxmox VE 9
  • Arsitektur dasar Debian 13 Trixie, instalasi bare metal, VLAN bridging, dan virtualisasi KVM/LXC.
Navigasi Cepat Bab
Install Repo PVE9 User VLAN Storage (RAID/ZFS) Cluster & HA Ceph Storage Upgrade 3→9 VM Windows VMware Backup
0

Dasar Hypervisor & Virtualisasi (Prasyarat)

Hypervisor adalah perangkat lunak (atau perangkat keras) yang memungkinkan beberapa sistem operasi berjalan secara bersamaan di atas satu server fisik (host). Fungsi utamanya adalah mengelola, mengalokasikan, dan memisahkan mesin-mesin virtual (VM) beserta sumber daya CPU, memori, storage, dan jaringannya secara terisolasi. Memahami konsep ini adalah fondasi wajib sebelum membangun infrastruktur Proxmox VE 9.

Pada praktik 2025–2026, istilah Type-1 untuk KVM tetap dipakai luas: KVM adalah modul kernel (akses hardware langsung via VT-x/AMD-V), sementara QEMU berperan sebagai VMM userspace (emulasi perangkat, disk, jaringan). Bersama-sama mereka membentuk tumpukan Type-1 untuk produksi. LXC bukan hypervisor penuh, melainkan virtualisasi level OS (namespace + cgroup) yang berbagi kernel host — boot cepat, overhead memori sangat rendah, cocok untuk layanan Linux; Isolasi penuh multi-OS (Windows, BSD, dll.) tetap memakai KVM/QEMU. Proxmox VE 9 menyatukan keduanya di satu platform manajemen (GUI :8006, API, cluster).

Type 1 (Bare-Metal)

Berjalan langsung di atas perangkat keras fisik tanpa sistem operasi antara, sehingga memiliki akses langsung ke CPU/RAM dan memberikan performa serta efisiensi tertinggi.

Contoh: VMware vSphere/ESXi, Microsoft Hyper-V, Xen, dan KVM/QEMU (mesin virtualisasi Proxmox VE).

Type 2 (Hosted)

Berjalan di atas sistem operasi host (Windows/Linux/macOS). Lebih mudah dipasang dan digunakan, cocok untuk pengembangan, lab, dan pengujian.

Contoh: VMware Workstation, Oracle VirtualBox, Parallels Desktop, UTM, dan VMware Fusion.

Aspek Type 1 (Bare-Metal) Type 2 (Hosted)
Lapisan Eksekusi Langsung di atas hardware Di atas OS host
Performa & Overhead Sangat tinggi (akses hardware langsung) Menengah (overhead OS host)
Penggunaan Umum Server produksi / data center Dev, testing, lab pribadi
Contoh Platform ESXi, Hyper-V, Xen, KVM/QEMU Workstation, VirtualBox, Parallels
Keunggulan Menggunakan Hypervisor
  • Isolasi yang Lebih Baik: setiap VM terpisah; kegagalan satu guest tidak merembet ke guest lain.
  • Penggunaan Sumber Daya Efisien: konsolidasi banyak server fisik menjadi satu host (optimalisasi CAPEX/OPEX).
  • Migrasi VM: Live Migration memindahkan VM antar host tanpa downtime.
  • Manajemen Lebih Mudah: provisioning, snapshot, dan kloning terpusat via GUI/API.
  • Dukungan Beragam OS: menjalankan Linux, Windows, BSD dalam satu host.
  • Keandalan & Pemulihan: HA, replica, dan backup terintegrasi mempercepat disaster recovery.
Proxmox VE 9 = Hypervisor Type-1 + Container: dibangun di atas Debian 13 Trixie (kernel 6.14+/7.0) dengan KVM + QEMU untuk VM penuh dan LXC 7.x untuk container Linux (termasuk dukungan OCI image di jalur 9.x). Lapisan manajemen (Web GUI :8006, pmxcfs multi-master, Corosync, ZFS/Ceph, PBS, SDN) menjadikan PVE alternatif enterprise pengganti VMware ESXi — termasuk edisi Arm64 resmi (Grace Hopper/Vera, PVE 9.2). Lanjut ke Ringkasan Arsitektur Proxmox VE 9 →.
1

Ringkasan Arsitektur Proxmox VE 9

Proxmox VE 9 berbasis Debian 13 “Trixie” dengan Linux Kernel modern 6.14+/7.0, mesin virtualisasi KVM/QEMU 11.x (PVE 9.2), container LXC 7.x (termasuk OCI image sejak 9.1), ZFS 2.4, dan Ceph Tentacle 20.2 (default instalasi baru; Squid 19.2 tetap didukung pada cluster existing). Menurut Proxmox VE Administration Guide, PVE menyediakan dua teknologi virtualisasi pada host yang sama (KVM untuk VM penuh, LXC untuk container), manajemen terpusat multi-master tanpa single point of failure, pmxcfs (config cluster ter-replika real-time), REST API, role-based ACL, serta jalur storage lokal/bersama (LVM, ZFS, NFS/CIFS, Ceph RBD/CephFS, PBS). Panduan ini dimulai dari fondasi konsep dasar hypervisor, lalu menyusun arsitektur produksi berdasarkan dokumentasi resmi Proxmox dan praktik ISP/enterprise ALSYUNDAWY IT Solution.

Komponen Utama Sistem
  • Hypervisor KVM (Type-1) & Container LXC berkinerja tinggi
  • Web Management Dashboard HTTPS pada port :8006
  • Penyimpanan multi-backend: Local, LVM-thin, ZFS, Ceph, & NFS/SMB
  • Arsitektur Jaringan: Linux Bridge & VLAN-aware bridging
  • Cluster High Availability (HA) & Live Migration tanpa downtime
  • Software-Defined Networking (SDN) & PCI Passthrough (IOMMU/VT-d) untuk GPU/NAS
Prinsip Keamanan & Produksi
  • IP Management statis terpisah dalam dedicated Management VLAN
  • Isolasi jaringan VLAN untagged (access) vs tagged (trunk)
  • Strategi cadangan data 3-2-1 sebelum melakukan upgrade major
  • Aktivasi repository no-subscription untuk lingkungan lab/mandiri
  • Standarisasi Timezone Asia/Jakarta serta locale en_US.UTF-8
  • Enkripsi disk (LUKS) & sertifikat TLS untuk Web GUI :8006
Lapisan Arsitektur Proxmox VE 9
Lapisan / Komponen Teknologi Proxmox VE 9
Virtualisasi KVM (kernel module Type-1) + QEMU 11.x untuk VM; LXC 7.x untuk container (termasuk pull OCI registry)
Sistem Operasi Dasar Debian 13.5+ “Trixie”, Linux Kernel 7.0 (stable default PVE 9.2), systemd
Manajemen Web GUI HTTPS :8006, CLI pvesh / REST API, pmxcfs (config terdistribusi)
Storage Backend Local, LVM-thin, ZFS, Ceph (RADOS/RBD/CephFS), NFS/SMB, iSCSI
Jaringan Linux Bridge, VLAN-aware bridging, SDN (VNet/EVPN), Bonding LACP
HA & Cluster Corosync 3 + pmxcfs + HA Manager (watchdog / fencing)
Backup & Recovery vzdump + Proxmox Backup Server (dedup, prune, verify)
Ringkasan Konten Panduan (Bab 0–17)
Bab Topik Isi Utama
0 Dasar Hypervisor Type 1 vs Type 2, KVM/QEMU, LXC, tabel perbandingan, keunggulan virtualisasi
1 Ringkasan Arsitektur Komponen PVE 9, layer arsitektur, mengapa upgrade dari PVE 7/8, fitur baru hardware & software
2 Persyaratan Sistem Spesifikasi minimum & rekomendasi produksi, BIOS/UEFI, VT-x/AMD-V, IOMMU
3 Instalasi Bare Metal USB bootable, graphical installer, alokasi disk (maxroot 175 GB), answer.toml auto-install
4 Post-Install Repository Nonaktifkan Enterprise repo, aktifkan pve-no-subscription & Ceph Squid, script otomatis setup-pve9-repos.sh, verifikasi apt update
5 Manajemen User pveum: realm pam/pve, user@realm, group, role (Administrator/PVEAdmin/PVEVMAdmin/PVEAuditor), ACL path, API token, 2FA
6 Jaringan VLAN 2-NIC access+trunk, hybrid 1-NIC, modern VLAN-aware bridge, bridge-vlan-aware yes, vmbr0.99 management
7 Manajemen Storage LVM thin pool resize (lvresize -r), Hardware RAID 5/10 vs OpenZFS, RAIDZ1–3/Striped Mirrors, ZFS ARC limit, RAIDZ Expansion, monitoring
8 Cluster & HA pmxcfs, Corosync 3, quorum mathematics, QDevice 2-node, dual-link corosync, HA groups, fencing, pvecm expected
9 Ceph Storage RADOS/MON/MGR/OSD/MDS, instalasi Ceph Squid 19.2, public/cluster network, BlueStore, pool RBD, monitoring, PG autoscaling
10 Upgrade PVE 3 Ke 9 Matriks evolusi Debian, pve6to7/pve7to8/pve8to9, rolling upgrade cluster, deb822 migration, ZFS upgrade
11 ISO & Template CT Upload ISO via GUI, pveam download template Debian 12/13
12 VM & CT Debian qm create VM (VirtIO SCSI, QEMU Agent), pct create CT (unprivileged, nesting)
13 VM Windows & Guest Tools UEFI + vTPM 2.0, VirtIO driver ISO, QEMU Guest Agent, bypass Windows 11 hardware check
14 LXC SSH & Locale SSH port change (mask ssh.socket), hardening key-based ed25519, locale en_US.UTF-8
15 Migrasi VMware ESXi Import Wizard (SSH TSM-SSH, ESXi 6.5–8.0), OVA/OVF manual, virt-v2v, mapping hardware, troubleshooting BSOD
16 Backup Offsite rclone cloud sync, NFS/CIFS NAS, Proxmox Backup Server (dedup, prune, verify), opsi vzdump modern (--fleecing, --protected)
17 Ringkasan & Best Practices Checklist pra-instalasi, storage ZFS/Ceph, HA & recovery, proteksi 3-2-1
Mengapa Upgrade ke Proxmox VE 9? (vs PVE 7/8)
Keterbatasan PVE 7 & PVE 8 yang Menjadi Alasan Upgrade:
  • PVE 7 (Debian 11 Bullseye): Kernel 5.15 legacy, QEMU 6.x tanpa fitur modern IOThread/blockdev-cache, ZFS 2.1.x tanpa RAIDZ Expansion, Ceph Pacific/Quincy dengan batasan PG autoscaling, dan repository Enterprise-only yang memaksa subscription.
  • PVE 8 (Debian 12 Bookworm): Kernel 6.8 bagus namun masih ada masalah kompatibilitas NIC lama, QEMU 8.x kurang optimal untuk Windows 11/Server 2025, LXC 5.x belum stabil untuk container modern, dan transisi GPG keyring yang rumit.
  • Kedua versi: Belum mendukung hardware terbaru (CPU generasi ke-14+, PCIe 5.0, NVMe 2.0), throttling performa pada VM I/O berat, dan downtime lebih lama saat maintenance cluster.
Fitur Baru PVE 9 — Hardware & Kernel
  • Linux Kernel 7.0 (default PVE 9.2): dukungan CPU generasi terbaru (Intel/AMD), PCIe 5.0, NVMe 2.0; jalur 9.0/9.1 masih memakai 6.14/6.17 hingga di-upgrade.
  • IOMMU & PCI Passthrough: Konfigurasi AMD-Vi/Intel VT-d yang lebih stabil untuk GPU virtualization (SR-IOV, vGPU).
  • Network: Dukungan driver NIC terbaru (Intel E800, AMD Pensando), bonding mode 802.3ad (LACP) dengan balanced-rr.
  • Storage: ZFS 2.4 dengan RAIDZ Expansion (online vdev expansion), ARC adaptif, SLOG/L2ARC; thick-LVM snapshots pada jalur storage modern.
Fitur Baru PVE 9 — Software & Aplikasi
  • KVM/QEMU 11.x (PVE 9.2): dirty-bitmap incremental backup, blockdev-cache writeback, IOThread tuning, custom CPU models dari GUI, serta dukungan hardware CPU generasi terbaru.
  • LXC 7.x: systemd-native, cgroup v2 penuh, nesting stabil, rootless, serta pembuatan CT dari OCI image (registry) sejak PVE 9.1.
  • Ceph Tentacle 20.2 (default PVE 9.2) / Squid 19.2: PG autoscaling, balancer upmap, BlueStore; Tentacle menambah FastEC & opsi migrasi RBD antar-cluster. Cluster existing tidak diganti otomatis.
  • Repository Modern deb822: Format .sources menggantikan .list, signed-by GPG keyring terpusat, dan no-subscription repo stabil.
  • ESXi Import Wizard: Tool native Rust untuk migrasi langsung dari VMware ESXi 6.5–8.0 tanpa OVA manual.
Kesimpulan: PVE 9 (hingga 9.2) adalah lompatan besar dari PVE 7/8 — kernel 7.0, hardware support lebih luas, toolchain modern (deb822, QEMU 11, LXC 7, Ceph Tentacle/Squid), Dynamic Load Balancer, SDN WireGuard fabric, dan HA arm/disarm. Untuk produksi baru atau upgrade dari PVE 7/8, PVE 9 adalah pilihan yang tepat.
Referensi Resmi: Dokumentasi resmi Proxmox (pve.proxmox.com), Server World (server-world.info), serta panduan integrasi jaringan ALSYUNDAWY IT Solution.
2

Persyaratan Sistem Hardware & BIOS

Sebelum memulai instalasi, pastikan infrastruktur perangkat keras Anda memenuhi spesifikasi minimum dan rekomendasi untuk beban kerja produksi:

Komponen Kebutuhan Minimum Rekomendasi Produksi
CPU 64-bit x86-64 dengan Intel VT-x atau AMD-V Multi-core Server CPU (Xeon / EPYC / Core i7+) + Intel VT-d / AMD IOMMU
RAM 2 GB (khusus host Proxmox saja) 16 GB – 128 GB+ (Host + Alokasi VM & ZFS ARC Cache)
Storage 32 GB SSD / HDD SATA Enterprise NVMe / SAS SSD dengan ZFS RAID1 (Mirror) atau LVM-thin
Network NIC 1× 1 GbE Ethernet 2–4× 10 GbE / 25 GbE (Bonding LACP, VLAN Management & Trunk)
BIOS / Firmware Legacy BIOS / UEFI standar UEFI Native, Virtualization (VT-x/AMD-V) Enabled, IOMMU Enabled
Catatan BIOS: Masuk ke pengaturan BIOS/UEFI motherboard Anda sebelum instalasi. Pastikan Hardware Virtualization (Intel VT-x / AMD-V) dan IOMMU (Intel VT-d / AMD-Vi) dalam status Enabled agar fitur PCI Passthrough dan virtualisasi KVM berfungsi maksimal.
3

Instalasi Proxmox VE 9 (Bare Metal)

Unduh citra ISO installer resmi dari portal https://www.proxmox.com/en/downloads (pilih file proxmox-ve_9.x-*.iso).

3.1 Menyiapkan Media Bootable USB

Gunakan media USB ≥ 8 GB. Pada Linux/macOS gunakan dd; pada Windows gunakan Rufus (mode DD Image) atau BalenaEtcher agar struktur ISO Proxmox tidak rusak.

Linux / macOS (dd) & Windows (Rufus / BalenaEtcher) 
# 1. Identifikasi nama disk USB Anda (HATI-HATI: Jangan salah memilih disk!)
lsblk

# 2. Tulis file ISO ke USB drive (ganti /dev/sdX sesuai disk target USB)
sudo dd bs=4M conv=fdatasync status=progress if=proxmox-ve_9.x-1.iso of=/dev/sdX

# Pada Windows — opsi 1: BalenaEtcher (pilih ISO → pilih USB → Flash)
# Pada Windows — opsi 2: Rufus (disarankan mode DD Image agar bootloader PVE utuh)
#   1. Unduh Rufus dari https://rufus.ie (versi portable OK)
#   2. Device: pilih USB target (HATI-HATI disk salah)
#   3. Boot selection: SELECT → pilih proxmox-ve_9.x-*.iso
#   4. Partition scheme: GPT (UEFI) atau MBR (Legacy BIOS) sesuai server
#   5. Jika Rufus menawarkan mode ISO vs DD: pilih DD Image mode
#   6. START → tunggu selesai → eject USB dengan aman
3.2 Langkah-Langkah Graphical Installer & Alokasi Disk
  1. Boot server dari USB Drive → Pilih menu Install Proxmox VE (Graphical).
  2. Persetujuan Lisensi: Baca EULA → Klik tombol I agree.
  3. Pemilihan Target Disk: Klik tombol Target Harddisk Options untuk kustomisasi alokasi partisi:
    • Filesystem: Pilih ext4 (standar LVM fleksibel) atau ZFS RAID1 (untuk dual disk mirroring).
    • hdsize: Total kapasitas disk yang digunakan installer (misal: 500 GB).
    • maxroot: Kapasitas partisi root /. Sangat direkomendasikan diset 175 GB pada server produksi agar tidak cepat penuh oleh file log, ISO, dan dump cadangan.
    • swapsize: Alokasi memori swap (disarankan 8 GB untuk RAM ≥ 32 GB).
    • minfree: Ruang kosong cadangan pada LVM Volume Group (default 16 GB).
    • maxvz: Kosongkan agar sisa ruang penyimpanan otomatis dialokasikan ke thin pool local-lvm.
  4. Lokasi & Waktu: Pilih Country Indonesia, Timezone Asia/Jakarta, Keyboard Layout U.S. English.
  5. Kredensial Keamanan: Masukkan password root yang kuat (≥ 12 karakter) serta alamat email administrator untuk pelaporan sistem.
  6. Konfigurasi Jaringan Management: Pilih interface fisik (misal nic0/eno1), isi Hostname FQDN (contoh: pve01.lab.internal), IP statis (misal: 192.168.24.210/30), Gateway, dan DNS Server.
  7. Layar Ringkasan: Periksa kembali seluruh parameter → Klik Install → Server akan otomatis reboot setelah selesai.
3.3 Skrip Otomasi Unattended / Auto-Install (answer.toml)

Bagi instalasi skala besar secara headless/otomatis (didukung sejak Proxmox VE 8.1/9.x), gunakan berkas jawaban konfigurasi answer.toml:

answer.toml — Auto-Install Spec 
[global]
keyboard = "en-us"
country = "id"
fqdn = "pve01.lab.internal"
mailto = "[email protected]"
timezone = "Asia/Jakarta"
root_password = "YourSecurePassw0rd!"

[network]
source = "from-dhcp"

[disk-setup]
filesystem = "ext4"
disk_list = ["sda"]
hdsize = 500
maxroot = 175
swapsize = 8
minfree = 16
# maxvz dikosongkan agar sisa space otomatis dialokasikan ke thin pool local-lvm
Akses Pasca Instalasi: Setelah reboot selesai, buka browser Anda dan akses Proxmox Web GUI melalui URL: https://<IP-Server-PVE>:8006. Login menggunakan user root dan password yang telah Anda tetapkan.
4

Post-Install: Konfigurasi Repository Proxmox VE 9

Secara default setelah instalasi, Proxmox VE mengaktifkan Enterprise Repository yang mewajibkan subscription key berbayar. Tanpa langganan aktif, perintah apt update akan memunculkan error 401 Unauthorized. Untuk kebutuhan lab, testing, maupun self-support, nonaktifkan Enterprise repo dan aktifkan pve-no-subscription serta Ceph Squid no-subscription.

4.1 Konfigurasi Melalui Web GUI
  1. Pilih nama node server Anda di panel kiri → Menu Repositories.
  2. Pilih baris enterprise.proxmox.com/debian/pve → Klik tombol Disable.
  3. Pilih baris enterprise.proxmox.com/debian/ceph-squid → Klik tombol Disable.
  4. Klik tombol Add → Pilih opsi No-Subscription → Klik Add.
  5. Klik tombol Add → Pilih opsi Ceph Squid No-Subscription → Klik Add.
4.2 Tutorial Pembuatan Script Setup Repository Langsung di Server (CLI)

Ikuti langkah berikut untuk membuat file script bash langsung pada server Proxmox VE Anda tanpa perlu mengunduh file eksternal:

1 Masuk ke Console Server sebagai Root

Buka SSH terminal atau Web Console noVNC pada server Proxmox VE Anda.

2 Tulis File Script setup-pve9-repos.sh Menggunakan Perintah Cat

Jalankan blok perintah berikut secara utuh untuk membuat file script otomatis di direktori root:

Buat File /root/setup-pve9-repos.sh 
cat << 'EOF' > /root/setup-pve9-repos.sh
#!/usr/bin/env bash
# =============================================================================
# setup-pve9-repos.sh — Proxmox VE 9 Repository Setup Automation
# Target  : Proxmox VE 9.x (Debian 13 Trixie)
# Author  : ALSYUNDAWY IT Solution
# =============================================================================
set -euo pipefail

if [[ ${EUID:-$(id -u)} -ne 0 ]]; then
  echo "ERROR: Jalankan skrip ini sebagai root!" >&2
  exit 1
fi

WITH_TEST=0
[[ "${1:-}" == "--with-test" ]] && WITH_TEST=1

echo "=============================================="
echo " Proxmox VE 9 — Repository Setup Automation"
echo "=============================================="
echo ""

echo "==> [1/5] Menonaktifkan Enterprise Repository"
# Format klasik (.list)
for f in /etc/apt/sources.list.d/pve-enterprise.list \
         /etc/apt/sources.list.d/ceph.list; do
  if [[ -f "$f" ]]; then
    sed -i 's/^deb/#deb/' "$f" || true
    echo "    Nonaktif (.list): $f"
  fi
done

# Format modern deb822 (.sources)
for f in /etc/apt/sources.list.d/pve-enterprise.sources \
         /etc/apt/sources.list.d/ceph.sources; do
  if [[ -f "$f" ]]; then
    if grep -q '^Enabled:' "$f"; then
      sed -i 's/^Enabled:.*/Enabled: no/' "$f"
    else
      if grep -q '^Types:' "$f"; then
        sed -i '/^Types:/a Enabled: no' "$f"
      else
        echo "Enabled: no" >> "$f"
      fi
    fi
    echo "    Nonaktif (.sources): $f"
  fi
done

echo "==> [2/5] Mengaktifkan Proxmox VE No-Subscription (deb822)"
cat > /etc/apt/sources.list.d/proxmox.sources << 'PVE_EOF'
Types: deb
URIs: https://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
PVE_EOF
echo "    Ditulis: /etc/apt/sources.list.d/proxmox.sources"

echo "==> [3/5] Mengaktifkan Ceph Squid No-Subscription"
cat > /etc/apt/sources.list.d/ceph.sources << 'CEPH_EOF'
Types: deb
URIs: https://download.proxmox.com/debian/ceph-squid
Suites: trixie
Components: no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
CEPH_EOF
echo "    Ditulis: /etc/apt/sources.list.d/ceph.sources"

if [[ "$WITH_TEST" -eq 1 ]]; then
  echo "==> [4/5] Mengaktifkan pve-test (khusus lab testing)"
  cat > /etc/apt/sources.list.d/pve-test.sources << 'TEST_EOF'
Types: deb
URIs: https://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-test
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
TEST_EOF
  echo "    Ditulis: /etc/apt/sources.list.d/pve-test.sources"
else
  echo "==> [4/5] Melewati pve-test (gunakan flag --with-test bila diperlukan)"
  rm -f /etc/apt/sources.list.d/pve-test.sources 2>/dev/null || true
fi

echo "==> [5/5] Menjalankan Update & Upgrade Paket Sistem"
export DEBIAN_FRONTEND=noninteractive
apt-get update
apt-get full-upgrade -y

echo ""
echo "=== Ringkasan Repository Aktif ==="
apt-cache policy 2>/dev/null | grep -E 'proxmox|ceph' || true
echo ""
echo "Setup repository selesai dengan sukses!"
echo "Disarankan untuk me-reboot server: reboot"
echo "=============================================="
EOF
3 Beri Izin Eksekusi & Jalankan Script

Jalankan script untuk mengonfigurasi repository secara instan:

Eksekusi Script 
# 1. Tambahkan izin eksekusi pada script
chmod +x /root/setup-pve9-repos.sh

# 2. Jalankan untuk repositori No-Subscription standar (Rekomendasi)
sudo bash /root/setup-pve9-repos.sh

# ATAU jalankan dengan opsi testing repository (Lab Only):
# sudo bash /root/setup-pve9-repos.sh --with-test
4.3 Ringkasan File Konfigurasi Repository PVE 9
Nama Berkas Status Operasional Peruntukan & Komponen
pve-enterprise.sources Disabled Repository komersial resmi (membutuhkan subscription key aktif)
proxmox.sources Enabled pve-no-subscription (Debian 13 Trixie)
ceph.sources Enabled Ceph Squid no-subscription untuk cluster storage
pve-test.sources Opsional (Lab) Paket pengujian mutakhir (--with-test)
4.4 Verifikasi Hasil Konfigurasi
Pemeriksaan Status 
# Periksa bahwa 'apt update' berjalan mulus tanpa peringatan 401 Unauthorized
apt update

# Cek versi Proxmox VE yang terpasang
pveversion -v

# Tinjau isi berkas deb822
grep -rE 'Enabled|Components|Suites' /etc/apt/sources.list.d/*.sources 2>/dev/null || true
4.5 Set Repository Debian 13 (Trixie) pada Host PVE 9

Pastikan repository dasar sistem Debian 13 Trixie mencakup komponen main contrib non-free non-free-firmware agar paket microcode CPU dan firmware hardware dapat terpasang dengan lengkap.

4.5.1 Format Modern deb822 (/etc/apt/sources.list.d/debian.sources)
/etc/apt/sources.list.d/debian.sources 
# Debian 13 Trixie Primary & Updates
Types: deb deb-src
URIs: https://deb.debian.org/debian/
Suites: trixie trixie-updates
Components: main contrib non-free non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

# Debian 13 Trixie Security Updates
Types: deb deb-src
URIs: https://security.debian.org/debian-security/
Suites: trixie-security
Components: main contrib non-free non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

# Debian 13 Trixie Backports (Opsional)
Types: deb deb-src
URIs: https://deb.debian.org/debian/
Suites: trixie-backports
Components: main contrib non-free non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
4.5.2 Format Klasik (/etc/apt/sources.list)
/etc/apt/sources.list 
deb http://deb.debian.org/debian trixie main contrib non-free non-free-firmware
deb http://deb.debian.org/debian-security trixie-security main contrib non-free non-free-firmware
deb http://deb.debian.org/debian trixie-updates main contrib non-free non-free-firmware
deb http://deb.debian.org/debian trixie-backports main contrib non-free non-free-firmware
4.5.3 Update & Instalasi Paket Microcode Processor
Update & Pasang Microcode 
apt update && apt full-upgrade -y

# Pasang microcode sesuai arsitektur CPU server Anda:
apt install -y intel-microcode   # Untuk Processor Intel
# apt install -y amd64-microcode # Untuk Processor AMD
5

Manajemen User, Group, Role & ACL (pveum)

Proxmox VE memakai model role-based access control: setiap izin mengikat subjek (user/group/token) ke role (kumpulan privilege) pada path objek (mis. /, /vms/100, /storage/local). Identitas disimpan di /etc/pve/user.cfg; password tidak disimpan di sana — autentikasi mengikuti realm. Format ID: nama@realm (contoh admin@pve, root@pam).

Realm Autentikasi yang Relevan
Realm Kegunaan Catatan Produksi
pam Linux PAM (user sistem host) root@pam default; cocok admin host
pve Proxmox VE authentication server User khusus GUI/API tanpa akun shell; disarankan operator
LDAP / AD / OIDC Direktori enterprise Opsional; sync group via pveum realm sync
Role Bawaan (yang sering dipakai)
  • Administrator — akses penuh (setara root pada objek yang di-ACL).
  • PVEAdmin — admin cluster tanpa hak ubah privilege sistem ekstrem.
  • PVEVMAdmin — kelola VM/CT (create/start/stop/config) tanpa ubah storage/node global.
  • PVEAuditor — read-only audit (cocok monitoring/NOC).
  • PVEVMUser — konsol & power management terbatas pada VM yang diizinkan.
Contoh CLI Praktis (pveum)
User, Group, ACL & API Token 
# Buat user di realm pve + set password
pveum user add operator@pve --firstname Ops --lastname Team --email [email protected]
pveum passwd operator@pve

# Group + membership
pveum group add vm-admins -comment "Operator VM produksi"
pveum user modify operator@pve --groups vm-admins

# ACL: group vm-admins = PVEVMAdmin pada seluruh path (propagate)
pveum acl modify / --groups vm-admins --roles PVEVMAdmin

# ACL lebih sempit: hanya VMID 100–110
pveum acl modify /vms/100 --users operator@pve --roles PVEVMAdmin

# API token (otomasi script; simpan secret sekali tampil)
pveum user token add operator@pve backup-bot --privsep 1
# Gunakan Authorization: PVEAPIToken=operator@pve!backup-bot=SECRET

# Nonaktifkan user tanpa hapus
pveum user modify operator@pve --enable 0

# Audit efektif
pveum user permissions operator@pve
pveum user list --full
Praktik aman: jangan bagikan root@pam ke banyak orang; buat user @pve + group + role minimum. Aktifkan 2FA TOTP dari GUI (Datacenter → Permissions → Two Factor) untuk akun admin. Token API dengan --privsep 1 membatasi privilege token agar tidak melebihi user induk.
Referensi: User Management (Admin Guide) & man pveum. Setelah repo & user siap, lanjut konfigurasi jaringan VLAN lalu storage.
6

Konfigurasi Jaringan VLAN (Production Standards)

Seluruh konfigurasi jaringan Proxmox VE didefinisikan pada berkas /etc/network/interfaces. Terapkan perubahan dengan perintah ifreload -a. Pastikan nama interface fisik disesuaikan dengan penamaan pada server Anda (contoh: nic0, eno1, eth0, dll.).

Catatan PVE 9.2 SDN: selain bridge VLAN klasik di bawah, stack SDN mendukung fabric WireGuard serta penyaringan BGP/EVPN (route maps / prefix lists) untuk multi-site. Untuk produksi standar access+trunk, konfigurasi /etc/network/interfaces berikut tetap fondasi yang disarankan.
Segregasi & Akses: Pastikan switch upstream telah dikonfigurasi port access/trunk yang sesuai. Kesalahan penulisan VLAN ID dapat memutus koneksi remote management. Selalu siapkan akses konsol fisik atau IPMI/iDRAC/iLO.
6.1 Topologi 2 Interface: VLAN Access (Management) + VLAN Access (Guest Data)

Konfigurasi menggunakan 2 interface fisik di mana interface nic0 bertindak sebagai Port Access khusus IP Management Host, sedangkan nic1 bertindak sebagai Port Access khusus traffic Data Guest VM:

/etc/network/interfaces — 2 NIC Access (Management & Guest Data) 
auto lo
iface lo inet loopback

# -----------------------------------------------------------------------------
# INTERFACE 1 (nic0): PORT ACCESS KHUSUS MANAGEMENT HOST PROXMOX VE
# -----------------------------------------------------------------------------
iface nic0 inet manual

# Bridge Management Host (IP Statis Proxmox VE)
auto vmbr0
iface vmbr0 inet static
    address 192.168.24.210/30
    gateway 192.168.24.209
    bridge-ports nic0
    bridge-stp off
    bridge-fd 0
# Catatan: vmbr0 murni untuk akses Web GUI (:8006), SSH (:22), & Cluster API

# -----------------------------------------------------------------------------
# INTERFACE 2 (nic1): PORT ACCESS KHUSUS TRAFFIC GUEST VM / CONTAINER
# -----------------------------------------------------------------------------
iface nic1 inet manual

# Bridge Guest VM (Tanpa IP pada Host Proxmox)
auto vmbr1
iface vmbr1 inet manual
    bridge-ports nic1
    bridge-stp off
    bridge-fd 0

source /etc/network/interfaces.d/*
6.2 Topologi 2 Interface: VLAN Access (Management) + Multi-VLAN Trunk (Guest Data)

Arsitektur standar enterprise 2 interface: Interface 1 (nic0) adalah PORT ACCESS khusus IP Management Host Proxmox, sedangkan Interface 2 (nic1) adalah PORT TRUNK yang membawa multi-VLAN berbeda (VLAN 105, 220, 340, 515) untuk segmentasi Guest VM:

Interface Fisik Tipe Port Switch Fungsi & Peran Bridge Proxmox Alokasi IP Host
nic0 VLAN Access Dedicated IP Management Host PVE (Web GUI, SSH) vmbr0 192.168.24.210/30
nic1 VLAN Trunk Multi-VLAN Guest Data (VID 105, 220, 340, 515) vmbr105, vmbr220, vmbr340, vmbr515 None (Manual Bridge)
/etc/network/interfaces — Access (Management) + Trunk (Guest Data) 
auto lo
iface lo inet loopback

# =============================================================================
# INTERFACE 1 (nic0): PORT ACCESS -> DEDICATED MANAGEMENT HOST PVE
# Switch Port: Mode ACCESS (Untagged Native Management VLAN)
# =============================================================================
iface nic0 inet manual

auto vmbr0
iface vmbr0 inet static
    address 192.168.24.210/30
    gateway 192.168.24.209
    bridge-ports nic0
    bridge-stp off
    bridge-fd 0
# vmbr0 menampung IP Management Proxmox VE (Web GUI :8006, SSH, API)

# =============================================================================
# INTERFACE 2 (nic1): PORT TRUNK -> DEDICATED GUEST TRAFFIC (4 VLAN)
# Switch Port: Mode TRUNK (Tagged VLAN 105, 220, 340, 515)
# =============================================================================
iface nic1 inet manual

# Sub-interface VLAN pada Interface Trunk (nic1)
auto nic1.105
iface nic1.105 inet manual

auto nic1.220
iface nic1.220 inet manual

auto nic1.340
iface nic1.340 inet manual

auto nic1.515
iface nic1.515 inet manual

# Dedicated Bridge per VLAN untuk Alokasi Kartu Jaringan Guest VM
auto vmbr105
iface vmbr105 inet manual
    bridge-ports nic1.105
    bridge-stp off
    bridge-fd 0
# VLAN 105: Web Frontend & API Gateway

auto vmbr220
iface vmbr220 inet manual
    bridge-ports nic1.220
    bridge-stp off
    bridge-fd 0
# VLAN 220: Application Core Backend

auto vmbr340
iface vmbr340 inet manual
    bridge-ports nic1.340
    bridge-stp off
    bridge-fd 0
# VLAN 340: Database Cluster & Analytics

auto vmbr515
iface vmbr515 inet manual
    bridge-ports nic1.515
    bridge-stp off
    bridge-fd 0
# VLAN 515: Storage & Replication Traffic

source /etc/network/interfaces.d/*
6.3 Topologi 1 NIC Hybrid (Untagged Management + Tagged Trunk)

Satu port fisik: traffic untagged untuk IP management, traffic tagged untuk sub-interface VLAN:

/etc/network/interfaces — Hybrid 1 NIC 
auto lo
iface lo inet loopback

iface nic0 inet manual

# Bridge Management (Untagged Native VLAN)
auto vmbr0
iface vmbr0 inet static
    address 192.168.24.210/30
    gateway 192.168.24.209
    bridge-ports nic0
    bridge-stp off
    bridge-fd 0
    bridge-vlan-aware yes
    bridge-vids 2-4094

# Sub-interface Tagged VLAN
auto nic0.630
iface nic0.630 inet manual

auto nic0.770
iface nic0.770 inet manual

auto vmbr630
iface vmbr630 inet manual
    bridge-ports nic0.630
    bridge-stp off
    bridge-fd 0
# VLAN 630: Corporate ERP & Internal Service

auto vmbr770
iface vmbr770 inet manual
    bridge-ports nic0.770
    bridge-stp off
    bridge-fd 0
# VLAN 770: Centralized Monitoring & Syslog

source /etc/network/interfaces.d/*
6.4 Rekomendasi Modern: 1 NIC VLAN-Aware Bridge

Standar modern Proxmox VE: satu bridge utama dengan bridge-vlan-aware yes, IP management diletakkan pada sub-interface vmbr0.99 (VLAN 99), sedangkan penandaan VLAN untuk VM/CT ditentukan langsung pada opsi kartu jaringan VM di GUI:

/etc/network/interfaces — VLAN-Aware Bridge Modern 
auto lo
iface lo inet loopback

iface nic4 inet manual

# Bridge Utama Trunk VLAN-Aware
auto vmbr0
iface vmbr0 inet manual
    bridge-ports nic4
    bridge-stp off
    bridge-fd 0
    bridge-vlan-aware yes
    bridge-vids 99 150 425 860 1020

# IP Management Host pada Dedicated Management VLAN 99
auto vmbr0.99
iface vmbr0.99 inet static
    address 192.168.24.210/30
    gateway 192.168.24.209

source /etc/network/interfaces.d/*
7

Manajemen Storage: LVM Resize, Hardware RAID (5/10) & OpenZFS (RAIDZ1–RAIDZ3 / Striped Mirrors)

Pada instalasi standar Proxmox VE, penyimpanan disk lokal dibagi menjadi dua pool utama: local (ext4 pada /dev/pve/root untuk OS, ISO, template, dan backup) dan local-lvm (LVM thin pool pada /dev/pve/data untuk virtual disk VM & CT). Selain itu, untuk server dengan multi-disk tambahan (4 hingga 8 storage, misal 900 GB SAS/SATA/NVMe), Anda dapat mengimplementasikan Hardware RAID 5/10 atau Software OpenZFS dengan kinerja dan ketahanan enterprise.

Prinsip Keamanan Storage: Lakukan backup seluruh data VM/CT sebelum melakukan operasi partisi atau manipulasi pool. Operasi ekspansi (lvresize / zpool add) bersifat non-destructive, namun pastikan tidak ada proses backup atau I/O intensif yang sedang berlangsung.
7.1 Meninjau Layout Volume Group & Logical Volume Saat Ini
Cek Status LVM & Disk Usage 
# 1. Cek sisa ruang bebas (Free Space) pada Volume Group 'pve'
vgdisplay pve | grep -E 'VG Size|Free  PE / Size'

# 2. Cek status Logical Volume root (local) dan data (local-lvm)
lvs -a -o +devices,pool_lv pve

# 3. Cek penggunaan filesystem root saat ini
df -hT /
7.2 Memperbesar Partisi local (ext4 Root — /dev/pve/root)

Gunakan opsi -r pada lvresize untuk otomatis me-resize filesystem ext4 secara live tanpa perlu unmount atau reboot:

Expand Partisi Root Secara Online 
# Tambahkan kapasitas sebesar 50 GB ke partisi root sekaligus me-resize filesystem ext4 (-r)
lvresize -r -L +50G /dev/pve/root

# Verifikasi kapasitas baru pada partisi /
df -hT /
7.3 Memperbesar Thin Pool local-lvm (/dev/pve/data)

Jika thin pool untuk disk VM/CT hampir habis, tambahkan kapasitas dari sisa free space Volume Group:

Expand Thin Pool local-lvm 
# Tambahkan 100 GB ke thin pool local-lvm (thin pool tidak memerlukan resize2fs)
lvresize -L +100G /dev/pve/data

# Verifikasi kapasitas baru
lvs pve/data
7.4 Catatan Teknis Pengurangan (Shrink) Thin Pool
PENTING: LVM Thin Pool (/dev/pve/data) secara arsitektur TIDAK mendukung pengurangan ukuran (shrink/reduce) secara online. Menjalankan perintah lvreduce pada active thin pool dapat merusak metadata dan mengakibatkan hilangnya data virtual disk VM/CT. Jika Anda perlu memindahkan alokasi storage dari local-lvm ke local:
  • 1. Backup seluruh VM dan CT ke media eksternal/PBS.
  • 2. Hapus thin pool data: lvremove /dev/pve/data.
  • 3. Perbesar partisi root: lvresize -r -l +100%FREE /dev/pve/root (atau sisakan sebagian untuk membuat ulang thin pool baru dengan ukuran yang diinginkan).
  • 4. Restore kembali VM/CT dari backup.
7.5 Menambahkan Disk Fisik Baru ke Volume Group pve

Jika disk pertama sudah penuh, pasang disk baru (misal /dev/sdb) lalu gabungkan ke dalam VG pve untuk menambah kapasitas secara ekspansif:

Tambah Physical Volume (PV) & Extend VG 
# 1. Inisialisasi disk fisik baru sebagai LVM Physical Volume
pvcreate /dev/sdb

# 2. Perluas Volume Group 'pve' dengan disk baru tersebut
vgextend pve /dev/sdb

# 3. Periksa Free Space baru yang tersedia
vgdisplay pve | grep "Free"

# 4. Alokasikan space baru ke root atau local-lvm sesuai kebutuhan:
# lvresize -r -L +200G /dev/pve/root
# lvresize -L +500G /dev/pve/data
7.6 Arsitektur Komparasi: Hardware RAID vs Software OpenZFS

Saat server Anda memiliki array disk tambahan (misalnya 4 hingga 8 unit SAS/SATA/NVMe 900 GB), Anda memiliki dua pilihan arsitektur penyimpanan enterprise:

Hardware RAID Controller (PERC / MegaRAID)
  • Offload CPU: Perhitungan parity ditangani penuh oleh ASIC chip pada RAID Controller (Dell PERC H730/H740P/H755, HPE Smart Array, Broadcom MegaRAID).
  • Cache & Battery: Dilengkapi modul DRAM Cache dengan proteksi baterai/flash (BBWC/FBWC) untuk write-caching aman.
  • Abstraksi OS: Seluruh susunan disk disajikan ke kernel Linux Proxmox sebagai satu Virtual Disk tunggal (misal /dev/sdb).
  • Integrasi PVE: Sangat ideal dikonfigurasi sebagai LVM-Thin atau Directory (ext4/XFS).
Software Defined Storage OpenZFS
  • Integritas Data End-to-End: Checksumming otomatis pada setiap blok data untuk mendeteksi & memperbaiki *silent data corruption (bit rot)*.
  • Prasyarat Wajib HBA: Wajib menggunakan controller mode HBA IT-Mode murni (Non-RAID / JBOD) agar ZFS memiliki akses langsung ke disk fisik.
  • Snapshots & Replikasi Instan: Mekanisme Copy-on-Write (CoW) memungkinkan snapshot dalam hitungan milidetik dan replikasi jarak jauh via zfs send/recv.
  • Fitur Enterprise: Kompresi realtime bawaan (ZSTD/LZ4), RAM ARC Cache cerdas, dan enkripsi native.
Klarifikasi Teknis Parity ZFS vs Istilah "RAID 4":
Pada arsitektur storage klasik, RAID 4 menggunakan 1 disk khusus yang didedikasikan hanya untuk menyimpan bit parity. Hal ini menciptakan bottleneck I/O yang sangat parah pada disk parity tersebut serta rentan terhadap *write-hole*. Oleh karena itu, OpenZFS TIDAK menggunakan arsitektur RAID 4 tradisional, melainkan menggunakan RAIDZ (Dynamic Stripe Width):
  • RAIDZ1 (Setara RAID 5): Parity didistribusikan secara merata ke seluruh disk dalam vdev dengan toleransi kehilangan 1 disk.
  • RAIDZ2 (Setara RAID 6): Parity ganda terdistribusi dengan toleransi kehilangan 2 disk sekaligus.
  • RAIDZ3 (Setara Triple Parity): Parity tiga lapis dengan toleransi kehilangan hingga 3 disk sekaligus.
  • Striped Mirrors (Setara RAID 10): Penggabungan mirror pairs (stripe of mirrors) dengan kinerja Random IOPS tertinggi dan waktu *resilver* tercepat.
7.7 Matriks Kalkulasi Kapasitas & Workload: 4 vs 8 Disk (Contoh: 900 GB SAS/SSD)

Berikut adalah perbandingan kapasitas efektif, toleransi kegagalan, dan rekomendasi beban kerja jika Anda memasang 4 unit atau 8 unit disk 900 GB (Total Raw: 3.6 TB untuk 4-disk / 7.2 TB untuk 8-disk):

Topologi Storage Kapasitas Efektif (4x 900 GB) Kapasitas Efektif (8x 900 GB) Toleransi Kerusakan Disk Karakteristik IOPS & Rekomendasi Workload
Hardware RAID 5 ~2.7 TB (N - 1) ~6.3 TB (N - 1) 1 Disk Write penalty 4x IOPS. Cocok untuk backup, template ISO, & sequential files. Risiko rebuild tinggi pada 8-disk
Hardware RAID 6 ~1.8 TB (N - 2) ~5.4 TB (N - 2) 2 Disk Write penalty 6x IOPS. Jauh lebih aman dibanding RAID 5 untuk 8-disk array dalam beban general VM.
Hardware RAID 10 ~1.8 TB (N / 2) ~3.6 TB (N / 2) 1 s/d 4 Disk (1 per mirror group) Performa Tertinggi Read/Write IOPS maksimal tanpa parity calculation. Sangat direkomendasikan untuk Database & VM I/O berat.
ZFS RAIDZ1 (1 Parity) ~2.7 TB ~6.3 TB 1 Disk Kapasitas besar, parity checksumming. Ideal untuk 4-disk lab/backup. Tidak disarankan untuk 8-disk produksi
ZFS RAIDZ2 (2 Parity) ~1.8 TB ~5.4 TB 2 Disk Sekaligus Paling Seimbang Proteksi ganda sangat aman saat proses resilvering disk besar. Standar terbaik untuk 8-disk file/storage pool.
ZFS RAIDZ3 (3 Parity) Kurang Efisien ~4.5 TB 3 Disk Sekaligus Ketahanan ekstrim terhadap kerusakan hardware ganda pada data kritikal / archival pool.
ZFS Striped Mirrors (ZFS RAID 10) ~1.8 TB (2x2 Mirrors) ~3.6 TB (4x2 Mirrors) 1 Disk per Mirror Pair (Maks 4 disk) Gold Standard Enterprise VM Random IOPS tertinggi, waktu pemulihan (resilver) super cepat tanpa degradasi performa VM.
7.8 Implementasi Praktis: Menambahkan Storage Hardware RAID 5/10

Setelah Anda membuat Virtual Disk (RAID 5 atau RAID 10) di BIOS/iDRAC RAID Controller, perangkat akan terbaca di Linux sebagai disk baru (misalnya /dev/sdb):

Opsi A: Jadikan LVM-Thin untuk Virtual Disk VM/CT

Mendukung fitur snapshot instan dan alokasi thin-provisioning hemat disk:

Setup LVM-Thin pada /dev/sdb 
# 1. Inisialisasi Physical Volume & Volume Group baru
pvcreate /dev/sdb
vgcreate vg_data_raid /dev/sdb

# 2. Buat Thin Pool LVM menggunakan 100% sisa kapasitas
lvcreate -l 100%FREE --type thin-pool -n thin_data_raid vg_data_raid

# 3. Daftarkan ke storage Proxmox VE (Datacenter -> Storage)
pvesm add lvmthin raid-vm-storage \
  --vgname vg_data_raid \
  --thinpool thin_data_raid \
  --content images,rootdir
Opsi B: Jadikan Directory Storage (ext4) untuk Backup & ISO

Mendukung penyimpanan file backup vzdump (.vma.zst), ISO installer, dan template container:

Setup Directory Storage ext4 
# 1. Format disk RAID dengan filesystem ext4 berkinerja tinggi
mkfs.ext4 -F -E lazy_itable_init=0,lazy_journal_init=0 /dev/sdb

# 2. Buat direktori mount point permanen
mkdir -p /mnt/pve/raid-storage

# 3. Daftarkan UUID disk ke /etc/fstab agar otomatis ter-mount saat boot
UUID=$(blkid -s UUID -o value /dev/sdb)
echo "UUID=${UUID} /mnt/pve/raid-storage ext4 defaults,noatime,nofail 0 2" >> /etc/fstab
mount -a

# 4. Daftarkan ke Proxmox VE
pvesm add dir raid-backup-storage \
  --path /mnt/pve/raid-storage \
  --content backup,iso,vztmpl,images,rootdir \
  --prune-backups keep-daily=7,keep-weekly=4,keep-monthly=3
7.9 Implementasi Praktis: Menambahkan Storage Software OpenZFS

Pastikan server Anda menggunakan controller HBA IT-Mode murni. Wajib menggunakan ID persisten disk (/dev/disk/by-id/) alih-alih nama drive devfs (/dev/sdX) agar pool tidak rusak saat urutan disk berubah setelah restart:

Cek ID Disk Fisik yang Tersedia 
# Tampilkan daftar seluruh disk fisik beserta serial number / disk-by-id
ls -la /dev/disk/by-id/ | grep -E 'sd[a-z]|nvme'
Pembuatan ZFS Pool Produksi (Pilih Sesuai Skenario Disk Anda) 
# -------------------------------------------------------------------------
# SKENARIO 1: 4 Disk (4x 900 GB) — Topologi Striped Mirrors / ZFS RAID 10 (Rekomendasi VM)
# -------------------------------------------------------------------------
zpool create -f -o ashift=12 \
  -O compression=zstd \
  -O atime=off \
  -O xattr=sa \
  -O autotrim=on \
  zpool-fast \
  mirror /dev/disk/by-id/scsi-3600...disk1 /dev/disk/by-id/scsi-3600...disk2 \
  mirror /dev/disk/by-id/scsi-3600...disk3 /dev/disk/by-id/scsi-3600...disk4

# -------------------------------------------------------------------------
# SKENARIO 2: 4 Disk (4x 900 GB) — Topologi RAIDZ1 (1 Parity - Kapasitas ~2.7 TB)
# -------------------------------------------------------------------------
# zpool create -f -o ashift=12 -O compression=zstd -O atime=off -O xattr=sa zpool-data \
#   raidz1 /dev/disk/by-id/disk1 /dev/disk/by-id/disk2 /dev/disk/by-id/disk3 /dev/disk/by-id/disk4

# -------------------------------------------------------------------------
# SKENARIO 3: 8 Disk (8x 900 GB) — Topologi RAIDZ2 (2 Parity - Kapasitas ~5.4 TB)
# -------------------------------------------------------------------------
# zpool create -f -o ashift=12 -O compression=zstd -O atime=off -O xattr=sa zpool-data \
#   raidz2 /dev/disk/by-id/disk1 /dev/disk/by-id/disk2 /dev/disk/by-id/disk3 /dev/disk/by-id/disk4 \
#          /dev/disk/by-id/disk5 /dev/disk/by-id/disk6 /dev/disk/by-id/disk7 /dev/disk/by-id/disk8

# -------------------------------------------------------------------------
# SKENARIO 4: 8 Disk (8x 900 GB) — Topologi Striped Mirrors / ZFS RAID 10 (4x2 Mirrors - IOPS Maksimal)
# -------------------------------------------------------------------------
# zpool create -f -o ashift=12 -O compression=zstd -O atime=off -O xattr=sa zpool-fast \
#   mirror /dev/disk/by-id/disk1 /dev/disk/by-id/disk2 \
#   mirror /dev/disk/by-id/disk3 /dev/disk/by-id/disk4 \
#   mirror /dev/disk/by-id/disk5 /dev/disk/by-id/disk6 \
#   mirror /dev/disk/by-id/disk7 /dev/disk/by-id/disk8

# -------------------------------------------------------------------------
# REGISTRASI ZFS POOL KE PROXMOX VE STORAGE
# -------------------------------------------------------------------------
pvesm add zfspool zfs-vm-storage \
  --pool zpool-fast \
  --sparse 1 \
  --content images,rootdir

# Verifikasi status ZFS pool
zpool status -v zpool-fast
7.10 Optimasi & Limitasi RAM ZFS ARC Cache

Secara bawaan di Linux, ZFS ARC (Adaptive Replacement Cache) dapat menggunakan hingga 50% kapasitas RAM server Anda. Untuk mencegah ZFS menghabiskan RAM yang dibutuhkan oleh Virtual Machine KVM, batasi penggunaan ARC (contoh: batasi maksimal 8 GB atau 16 GB):

Konfigurasi /etc/modprobe.d/zfs.conf 
# Hitung batas RAM ARC dalam satuan Bytes (Contoh 8 GB = 8 * 1024 * 1024 * 1024 = 8589934592)
cat > /etc/modprobe.d/zfs.conf << 'EOF'
# Batasi ZFS ARC Cache: Min 2 GB, Max 8 GB
options zfs zfs_arc_min=2147483648
options zfs zfs_arc_max=8589934592
EOF

# Perbarui initramfs untuk menerapkan konfigurasi
update-initramfs -u -k all

# Terapkan secara langsung ke modul kernel yang sedang berjalan tanpa reboot
echo 8589934592 > /sys/module/zfs/parameters/zfs_arc_max

# Verifikasi penggunaan ARC saat ini
arcstat
7.11 Pemeliharaan, Monitoring & Pemilihan Storage (ZFS Scrub, RAIDZ Expansion & Decision Matrix)
RAIDZ Expansion (Baru di PVE 9 / ZFS 2.3): Mulai Proxmox VE 9 (ZFS 2.3.3), Anda dapat memperlebar vdev RAIDZ yang sudah ada dengan menambahkan disk secara online (minimal downtime) tanpa rebuild pool dari nol: zpool attach <pool> <raidzN-M> <device>. Setelah ekspansi, jalankan zpool scrub untuk memvalidasi integritas.
Monitoring & Perawatan ZFS
  • Scrub berkala cegah silent corruption: zpool scrub zpool-fast (jadwalkan tiap 2–4 minggu).
  • Pantau I/O real-time: zpool iostat -v 1 dan arcstat 1 untuk hit ARC.
  • Cek snapshot & kapasitas: zfs list -t snapshot, zfs get compressratio zpool-fast.
  • SLOG (ZIL) & L2ARC: zpool add <pool> log <nvme> untuk write-log, cache <nvme> untuk read-cache.
Monitoring Hardware RAID (PERC/MegaRAID)
  • Pasang CLI vendor: apt install -y storcli (Broadcom) atau perccli (Dell).
  • Status array: storcli /c0 /vall show dan storcli /c0 /eall /sall show.
  • Cek BBU/flash-cache & rebuild: pastikan State: Optl dan BBU: Ready.
  • Notifikasi via smartmontools + mdadm (bila pakai Linux RAID).
Skenario / Workload Rekomendasi Utama Catatan Singkat
VM I/O berat, Database, latency-kritis ZFS Striped Mirrors / HW RAID 10 IOPS tertinggi, resilver tercepat; trade-off kapasitas.
File/Storage pool umum, 8-disk ZFS RAIDZ2 Parity ganda; paling seimbang & aman saat resilver.
Simplicity & kompatibilitas maksimal LVM-Thin (HW RAID di bawahnya) Tanpa overhead RAM ARC; snapshot thin siap pakai.
Shared storage antar-node (HA/Live Mig) Ceph RBD atau NFS/iSCSI shared Distribusi tanpa SPOF; butuh jaringan 10/25 GbE.
8

Penggabungan Multi-Node Host Menjadi Satu Datacenter & High Availability (HA)

Fitur Proxmox VE Cluster memungkinkan Anda menggabungkan beberapa server fisik independen (node) menjadi satu kesatuan Datacenter Terpusat yang dikelola secara terpadu melalui satu URL Web GUI. Seluruh konfigurasi cluster disinkronkan secara realtime ke semua node melalui sistem file terdistribusi pmxcfs (Proxmox Cluster Filesystem berbasis basis data SQLite in-memory pada /etc/pve) yang dikomunikasikan secara aman menggunakan protokol Corosync 3.

PVE 9.2 — Cluster refinement: Dynamic Load Balancer (CRS mode dinamis) dapat memigrasi guest HA secara otomatis berdasarkan metrik beban node. Fitur HA arm/disarm memudahkan maintenance terencana tanpa fencing tak sengaja. Konfigurasi tetap melalui GUI Datacenter/HA atau CLI ha-manager.
Keuntungan Utama Arsitektur Datacenter
  • Single Management Interface (Single Pane of Glass): Kelola seluruh server fisik, VM, CT, storage pool, firewall, dan user permission dari dashboard web node mana pun.
  • Live Migration Tanpa Downtime: Pindahkan VM yang sedang beroperasi antar host secara instan saat maintenance hardware tanpa memutus koneksi aplikasi.
  • Cluster Resource Scheduling (CRS): Penyeimbangan beban kerja (load balancing) CPU dan RAM otomatis antar node.
  • Integrasi Shared Storage: Dukungan penuh penyimpanan bersama seperti Ceph RBD/CephFS, NFS, iSCSI, dan ZFS-over-iSCSI.
  • Centralized Firewall & SDN: Manajemen aturan firewall kluster dan Software-Defined Network (VNet/EVPN) di level Datacenter.
Mekanisme High Availability (HA)
  • HA Manager & CRM (Cluster Resource Manager): Memantau *heartbeat* kesehatan node dan status guest VM secara kontinu setiap beberapa detik.
  • Automatic Failover: Jika 1 server fisik mengalami crash/mati listrik mendadak, VM penting otomatis dihidupkan kembali di server lain yang sehat.
  • Watchdog & Fencing Protection: Mengisolasi node yang mengalami kegagalan menggunakan modul kernel Linux (softdog) atau IPMI/iDRAC fencing untuk mencegah kondisi berbahaya Split-Brain.
  • HA Groups & Recovery Rules: Penentuan prioritas node failover dan batas maksimal percobaan restart.
8.1 Prinsip Quorum, Split-Brain & Solusi Kluster 2-Node (QDevice)

Dalam sistem terdistribusi, Quorum adalah konsensus mayoritas suara dari node-node yang aktif untuk memastikan bahwa keputusan cluster sah dan mencegah data corrupt akibat Split-Brain (situasi ketika jaringan terputus dan kedua kelompok server mengira server lawan telah mati sehingga keduanya menulis data yang sama secara bersamaan).

Aturan Matematis Quorum:
  • Formula Quorum: Suara mayoritas mutlak dibutuhkan: Quorum_Votes = floor(Total_Nodes / 2) + 1.
  • Rekomendasi Jumlah Node Ganjil (3, 5, 7): Pada kluster 3-node, jika 1 node mati, 2 node yang tersisa (66.6%) tetap memenuhi quorum sehingga cluster tetap beroperasi normal.
  • Dilema Kluster 2-Node: Pada 2-node, total suara = 2. Dibutuhkan 2 suara untuk quorum. Jika 1 node mati, sisa 1 node (50%) akan KEHILANGAN QUORUM, menyebabkan Web GUI menjadi read-only dan VM tidak dapat di-start!
  • Solusi 2-Node (Corosync QDevice): Tambahkan perangkat pihak ketiga ringan (misal: Raspberry Pi, VPS kecil, atau mini PC di luar cluster) yang menjalankan layanan QNetD untuk memberikan 1 suara penentu (Tie-Breaker).
Setup Corosync QDevice untuk Kluster 2-Node (Opsional) 
# 1. Pada perangkat eksternal (misal Raspberry Pi / VM Debian IP: 192.168.24.250):
apt update && apt install -y corosync-qnetd

# 2. Pada kedua node Proxmox VE (pve01 & pve02):
apt update && apt install -y corosync-qdevice

# 3. Eksekusi inisialisasi QDevice dari node pve01:
pvecm qdevice setup 192.168.24.250

# 4. Verifikasi status quorum (QDevice akan memberikan 1 vote tambahan):
pvecm status
8.2 Perancangan Jaringan Corosync (Redundant Link0 & Link1)

Corosync sangat sensitif terhadap latensi jaringan dan jitter. Sangat disarankan untuk memisahkan traffic Corosync pada VLAN Management terisolasi atau dedicated link fisik, serta menggunakan konfigurasi Dual-Link Redundan (Link0 & Link1):

Link Corosync Interface Jaringan Subnet & Alokasi IP Fungsi Jaringan
Link 0 (Primary) vmbr0.99 (VLAN Management) 192.168.24.210/30 (pve01), .211 (pve02), .212 (pve03) Komunikasi utama cluster heartbeat, sync pmxcfs, dan API Web GUI.
Link 1 (Secondary Fallback) eno2 / eth1 (Dedicated Subnet) 10.10.10.210/24 (pve01), .211 (pve02), .212 (pve03) Jalur cadangan otomatis jika kabel atau switch Link 0 mengalami gangguan fisik.
8.3 Langkah Pembuatan Cluster pada Node Pertama (Inisiator)
1 Inisialisasi Cluster Baru pada Node 1 (pve01)

Pastikan hostname dan IP seluruh node sudah terdaftar pada /etc/hosts di semua server, lalu jalankan pada console pve01:

pve01 — Inisialisasi Cluster (CLI) 
# 1. Daftarkan mapping FQDN & IP seluruh node di file /etc/hosts pada SEMUA server:
cat << 'EOF' >> /etc/hosts
192.168.24.210 pve01.lab.internal pve01
192.168.24.211 pve02.lab.internal pve02
192.168.24.212 pve03.lab.internal pve03
EOF

# 2. Buat cluster baru bernama 'cluster-alsyundawy' dengan link0 (dan link1 redundan jika ada):
pvecm create cluster-alsyundawy --link0 192.168.24.210

# Opsi jika menggunakan Dual-Link Corosync:
# pvecm create cluster-alsyundawy --link0 192.168.24.210 --link1 10.10.10.210

# 3. Verifikasi status cluster awal
pvecm status
8.4 Menggabungkan Node Tambahan (pve02, pve03) ke Datacenter
Metode A: Bergabung Melalui Terminal CLI

Jalankan perintah pvecm add langsung dari console node yang ingin digabungkan:

CLI Join Command 
# Eksekusi pada server pve02:
pvecm add 192.168.24.210 --link0 192.168.24.211

# Eksekusi pada server pve03:
pvecm add 192.168.24.210 --link0 192.168.24.212

# Masukkan password root pve01 saat diminta konfirmasi SSH.
Metode B: Bergabung Melalui Web GUI

Sangat mudah dan cepat menggunakan token join terenkripsi:

  1. Buka Web GUI pve01 → Klik Datacenter → Tab Cluster.
  2. Klik tombol Join Information → Klik Copy Information.
  3. Buka Web GUI pve02 (atau pve03) → Datacenter → Cluster → Klik Join Cluster.
  4. Tempel (Paste) informasi token → Masukkan password root pve01 → Klik Join 'cluster-alsyundawy'.
  5. Browser akan otomatis me-refresh dan menampilkan seluruh node dalam 1 Datacenter tree!
8.5 Verifikasi Status Quorum & Komunikasi Cluster
Diagnostik Kesehatan Cluster 
# 1. Cek ringkasan cluster, total votes, dan status Quorum (Wajib: Quorate: Yes)
pvecm status

# 2. Cek daftar node fisik dan status koneksinya (1 = Online, 0 = Offline)
pvecm nodes

# 3. Cek kualitas link komunikasi Corosync antar host (Status: Connected / No Drops)
corosync-cfgtool -s

# 4. Cek status sinkronisasi sistem file pmxcfs
systemctl status pve-cluster
8.6 Prosedur Penghapusan Node dari Datacenter Secara Aman (Safe Decommissioning)
PERINGATAN SAAT MENGHAPUS NODE: Jangan pernah menghapus node saat node tersebut masih menyala dan terhubung ke jaringan cluster! Ikuti prosedur aman berikut:
  • 1. Migrasikan seluruh VM dan CT dari node yang akan dihapus ke node lain.
  • 2. Matikan server fisik yang akan dikeluarkan dari cluster (poweroff).
  • 3. Pada salah satu node yang tersisa (misal pve01), jalankan perintah penghapusan: pvecm delnode <node-name>.
  • 4. Jika node yang dihapus akan digunakan kembali sebagai server independen, lakukan instalasi ulang OS Proxmox agar tidak ada sisa sertifikat Corosync lama.
8.7 Konfigurasi High Availability (HA) & Fencing Protection

High Availability menjamin bahwa jika salah satu server fisik mengalami crash atau mati total, VM penting otomatis dihidupkan kembali di host yang masih sehat:

Setup HA Group & Failover via CLI 
# 1. Pastikan watchdog kernel Linux aktif pada SETIAP node server
modprobe softdog
grep -q "^softdog" /etc/modules || echo "softdog" >> /etc/modules
systemctl status watchdog-mux

# 2. Buat grup HA bernama 'prod-group' dengan prioritas node (pve01: priority 3, pve02: priority 2, pve03: priority 1):
ha-manager groupadd prod-group --nodes "pve01:3,pve02:2,pve03:1" --nofailback 0

# 3. Daftarkan VMID 100 ke dalam pengawasan HA dengan proteksi restart otomatis:
ha-manager add vm:100 --group prod-group --max_restart 3 --max_relocate 2 --state started

# 4. Pantau status operasional HA Cluster secara berkala
ha-manager status
8.8 HA Rules, Location Constraints & Pemulihan Cepat (ha-manager crm)
HA Groups & Location Rules
  • HA Group: kelompok node + prioritas failover (--nofailback 0/1).
  • HA Rule (location): paksa VM/CT hanya berjalan di node tertentu (mis. node bergPU/lisensi).
  • HA Tags: batasi resource ke subset node secara dinamis tanpa mengubah grup.
  • Inspeksi interaktif: ha-manager crm → status / show <sid>.
Quorum Emergency & Recovery
  • Jika quorum terkunci (node mati > mayoritas): set ekspektasi sementara pvecm expected 1 HANYA di node sehat yang tersisa.
  • Pasca recovery, kembalikan: pvecm expected 3.
  • Cegah split-brain: jangan nyalakan kembali node lama sebelum bergabung via corosync.
  • Layanan HA: pve-ha-lrm (per-node) & pve-ha-crm (cluster resource manager).
HA Rule & Status Cepat 
# Buat HA rule "location" agar VMID 200 hanya boleh di pve01/pve02:
ha-manager ruleadd location --sid vm:200 --nodes "pve01,pve02" --restricted 0

# Lihat ringkasan resource, grup, dan status failover:
ha-manager crm status
ha-manager crm show vm:100

# Darurat: turunkan ekspektasi quorum ke 1 (HANYA saat node lain benar-benar mati)
pvecm expected 1
9

Ceph Distributed Storage: Arsitektur RADOS, Konfigurasi Ceph Squid & Best Practices di PVE 9

Ceph adalah sistem penyimpanan terdistribusi berbasis perangkat lunak (Software-Defined Storage / SDS) kelas enterprise yang terintegrasi secara *native* dan mendalam di dalam Proxmox VE 9 (menggunakan rilis mutakhir Ceph Squid 19.2). Ceph menyatukan disk lokal berkecepatan tinggi dari beberapa host server menjadi satu Shared Storage Cluster tanpa titik kegagalan tunggal (No Single Point of Failure / SPOF).

PVE 9.2: instalasi Ceph baru default ke Tentacle 20.2; Squid 19.2 tetap tersedia. Cluster yang sudah berjalan tidak diganti otomatis — node baru mengikuti rilis Ceph cluster existing. Upgrade Squid→Tentacle ikuti panduan resmi Proxmox secara terpisah dari upgrade PVE.
Arsitektur & Komponen Inti Ceph
  • RADOS (Reliable Autonomic Distributed Object Store): Jantung komputasi penyimpanan Ceph yang mengelola objek data, replikasi otomatis, dan deteksi kegagalan secara otonom.
  • MON (Ceph Monitor): Menyimpan master map cluster (OSD Map, Mon Map, CRUSH Map) dan menjaga konsistensi Quorum cluster (wajib berjumlah ganjil, minimal 3 MON).
  • MGR (Ceph Manager): Mengelola metrik performa, pemantauan kapasitas, dashboard visual, dan modul optimasi balancer.
  • OSD (Object Storage Daemon): Daemon BlueStore yang mengontrol 1 disk fisik (NVMe/SSD) untuk penyimpanan blok data aktual.
  • MDS (Metadata Server): Daemon pengelola hirarki metadata direktori khusus untuk CephFS (Shared POSIX Filesystem).
  • CRUSH Map: Algoritma deterministik penentu lokasi replikasi data ke disk/host tanpa memerlukan server metadata pusat yang lambat.
Mengapa Menggunakan Ceph? (Kelebihan Utama)
  • 100% Software-Defined (Hemat Biaya SAN): Mengeliminasi ketergantungan pada hardware SAN/NAS eksternal proprietary (seperti Dell EMC, NetApp, HPE 3PAR) yang berlisensi mahal.
  • Instant Live Migration Tanpa Downtime: Virtual disk VM berada pada pool terdistribusi Ceph, sehingga migrasi VM antar server selesai dalam 1–3 detik tanpa perlu memindahkan file disk!
  • Self-Healing & Auto-Rebalancing Otomatis: Jika 1 disk atau 1 host mati, Ceph otomatis merekonstruksi salinan data yang hilang ke disk lain yang sehat secara otomatis di latar belakang.
  • Skalabilitas Tanpa Batas (Scale-Out): Menambah node atau disk baru secara langsung mendongkrak kapasitas penyimpanan dan performa IOPS secara linier.
  • Replikasi Kokoh (3x Replicas): Menggunakan aturan size=3, min_size=2 sehingga integritas data terjamin meski 1 server fisik offline.
9.1 Persyaratan Sistem Hardware & Jaringan Ceph Produksi (2026 Standards)
Komponen Sistem Kebutuhan Minimum (Lab / Testing) Standar Rekomendasi Enterprise (Produksi)
Jumlah Node Host 3 Node Proxmox VE aktif 3 s/d 5+ Node Server dalam 1 Datacenter (toleransi kehilangan 1–2 server fisik).
Jaringan Storage Dedicated 1 GbE (Sangat lambat) Dual 10 GbE / 25 GbE / 40 GbE+ (LACP Bonding, MTU 9000 Jumbo Frames).
Pemisahan Network Single Subnet Wajib Pisah: Ceph Public Network (VM ke Storage) & Ceph Cluster Network (Replikasi antar OSD).
Disk Storage (OSD) SATA SSD Standard Enterprise NVMe / SAS SSD dengan Power Loss Protection (PLP) & High TBW Endurance.
Controller Disk Direct SATA On-board HBA IT-Mode Murni (Non-RAID / JBOD) — DILARANG KERAS Menggunakan Hardware RAID!
Alokasi RAM Host RAM Host + 1 GB per OSD RAM Host + 2 s/d 4 GB per OSD Daemon (untuk BlueStore DB/WAL memory cache).
PERINGATAN JARINGAN & DISK CEPH:
  • Ceph melakukan sinkronisasi data antar node secara intensif. Jangan pernah menggunakan Consumer QLC/TLC SSD tanpa DRAM & PLP karena latensi write-flush dapat melonjak hingga ribuan milidetik dan menyebabkan OSD timeout!
  • Pastikan switch jaringan mendukung MTU 9000 (Jumbo Frames) dan tidak ada packet loss pada interkoneksi antar node.
9.2 Langkah 1: Instalasi Paket Ceph Squid di Seluruh Node

Pastikan repository Ceph Squid no-subscription telah diaktifkan pada seluruh host (lihat Bab 4), lalu jalankan instalasi paket pada setiap node cluster (pve01, pve02, pve03):

Eksekusi pada pve01, pve02, pve03 
# 1. Jalankan instalasi paket Ceph Squid secara otomatis di setiap node
pveceph install --version squid

# 2. Verifikasi versi Ceph yang berhasil terpasang
ceph --version
# Output harus menunjukkan: ceph version 19.2.x (squid)
9.3 Langkah 2: Inisialisasi Jaringan Ceph Cluster

Jalankan inisialisasi jaringan Ceph HANYA SEKALI pada node inisiator (pve01). Tentukan subnet Public Network (misal 10.10.10.0/24) dan Cluster Network terpisah (misal 10.10.20.0/24):

Eksekusi HANYA pada pve01 
# Inisialisasi Ceph dengan memisahkan Public Network dan Cluster Network
pveceph init --network 10.10.10.0/24 --cluster-network 10.10.20.0/24

# Catatan: Jika hanya memiliki 1 jaringan storage bersama, gunakan satu CIDR:
# pveceph init --network 192.168.24.0/24
9.4 Langkah 3: Membuat Monitor (MON) & Manager (MGR)

Untuk mencapai Quorum konsensus yang aman dari kegagalan 1 node, buat minimal 3 Monitor dan 3 Manager pada masing-masing host:

Setup MON & MGR pada Seluruh Node 
# 1. Eksekusi pada pve01:
pveceph mon create
pveceph mgr create

# 2. Eksekusi pada pve02:
pveceph mon create
pveceph mgr create

# 3. Eksekusi pada pve03:
pveceph mon create
pveceph mgr create

# (Opsi Web GUI): Buka Node -> Ceph -> Monitor -> Klik 'Create' pada pve01, pve02, dan pve03.
9.5 Langkah 4: Membuat Object Storage Daemon (OSD) pada Disk Fisik

OSD adalah daemon yang mengontrol disk penyimpanan aktual. Setiap disk SSD/NVMe kosong akan diinisialisasi menggunakan format BlueStore:

Inisialisasi Disk OSD per Node 
# 1. Periksa nama disk fisik kosong yang terpasang pada masing-masing server
lsblk -d -o NAME,SIZE,TYPE,MODEL

# 2. Buat OSD pada disk target (misal: /dev/nvme0n1 atau /dev/sdb) di setiap node:
# Pada server pve01:
pveceph osd create /dev/nvme0n1

# Pada server pve02:
pveceph osd create /dev/nvme0n1

# Pada server pve03:
pveceph osd create /dev/nvme0n1

# (Opsi Lanjutan): Jika menggunakan HDD SAS lambat dengan dedicated NVMe untuk DB/WAL:
# pveceph osd create /dev/sdb --db_dev /dev/nvme0n1
9.6 Langkah 5: Membuat Ceph Storage Pool (RBD) & CephFS

Buat pool penyimpanan blok (RADOS Block Device / RBD) dengan replikasi 3x dan daftarkan langsung ke Proxmox Storage:

Pembuatan RBD Pool & CephFS 
# 1. Buat pool RBD bernama 'ceph-vm-pool' dengan 3x replikasi data (--add_storages 1 otomatis mendaftarkan ke GUI Storage)
pveceph pool create ceph-vm-pool --add_storages 1 --size 3 --min_size 2 --pg_num 128 --application rbd

# 2. (Opsional) Buat CephFS untuk Shared Filesystem Folder bagi Container LXC dan File ISO:
# pveceph fs create --pg_num 64 --add_storages 1

# Rincian Parameter Utama:
# --size 3       : Setiap data disimpan dalam 3 salinan di 3 server fisik berbeda.
# --min_size 2   : Operasi I/O tetap berjalan lancar jika 1 server sedang offline / maintenance.
# --add_storages : Otomatis menambahkan pool ini ke Web GUI Datacenter -> Storage sebagai 'ceph-vm-pool'.
9.7 Langkah 6: Monitoring, Kesehatan & Maintenance Mode Ceph
Perintah Diagnostik & Pemeliharaan Ceph 
# 1. Cek kesehatan umum cluster Ceph (Status ideal: HEALTH_OK)
ceph status
# Atau ringkas: ceph -s

# 2. Tampilkan rincian detail peringatan (jika status HEALTH_WARN)
ceph health detail

# 3. Tampilkan struktur pohon topologi OSD, node host, status UP/IN, dan bobot disk
ceph osd tree

# 4. Cek kapasitas penggunaan storage pool dan alokasi PG
ceph df

# -------------------------------------------------------------------------
# PROSEDUR REBOOT / MAINTENANCE NODE PADA CLUSTER CEPH
# -------------------------------------------------------------------------
# Sebelum me-reboot server node Ceph, aktifkan flag 'noout' agar Ceph tidak melakukan
# rebalancing masif yang membebani I/O saat server offline sementara:
ceph osd set noout

# Lakukan maintenance / reboot node...
# Setelah node menyala kembali dan seluruh OSD dalam status 'up', nonaktifkan flag:
ceph osd unset noout
9.8 Operasional Lanjutan: PG Autoscaling, Balancer & Failure Domain
Penyeimbangan Beban & PG
  • PG Autoscaling: biarkan Ceph menghitung jumlah Placement Group otomatis per pool (ceph osd pool autoscale-status).
  • Balancer Module: distribusikan data merata antar OSD: ceph balancer on & ceph balancer mode upmap.
  • Failure Domain: default host (tahan kehilangan 1 server). Untuk rack-awareness, gunakan CRUSH rule custom.
  • CephFS (POSIX): shared filesystem untuk ISO/template/LXC: pveceph fs create --add_storages 1.
Dashboard MGR & Tuning OSD
  • Aktifkan dashboard: ceph mgr module enable dashboard (setelah pveceph mgr create).
  • Batasi memori OSD agar tak memakan RAM VM: ceph config set osd osd_memory_target 4294967296 (4 GB).
  • Saat ganti disk/upgrade: ceph osd set noout → ceph osd unset noout.
  • Gunakan norebalance saat maintenance masif untuk menunda rebalancing.
Ceph Operasional Harian 
# Cek autoscaling PG dan aktifkan (mode auto per pool)
ceph osd pool autoscale-status
ceph osd pool set ceph-vm-pool pg_autoscale_mode on

# Nyalakan balancer agar data merata antar OSD
ceph balancer on
ceph balancer mode upmap

# Batasi memori per OSD (4 GB) agar RAM host tersisa untuk VM
ceph config set osd osd_memory_target 4294967296

# Status ringkas & kesehatan (harus HEALTH_OK)
ceph -s
ceph osd tree
Ceph Storage Siap Digunakan: Sekarang saat membuat Virtual Machine atau Container baru, pilih target storage ceph-vm-pool. Virtual disk Anda akan terdistribusi secara redundan dan mendukung fitur Live Migration instan antar node tanpa jeda waktu!
10

Upgrade Path Komprehensif: Proxmox VE 3 → 4 → 5 → 6 → 7 → 8 → 9 (Data & Standar Mutakhir 2026)

Melakukan upgrade versi major Proxmox VE wajib dilakukan secara bertahap rilis per rilis (3.x → 4.x → 5.x → 6.4 → 7.4 → 8.4 → 9.x). Dilarang keras melompati versi major secara langsung (misal: 3 langsung ke 6, atau 7 ke 9) karena akan memicu inkompatibilitas fatal pada database paket Debian, struktur Quorum Corosync, format virtual disk, dan driver kernel. Tersedia dua metode: in-place upgrade via APT (direkomendasikan) atau fresh install baru lalu restore VM/CT dari backup. Setiap rilis mayor membawa perubahan breaking (OpenVZ→LXC, Corosync 2→3, cgroup v1→v2, deb822 repo, penghapusan cgroup v1) yang wajib dipahami sebelum mengeksekusi upgrade.

Prosedur Wajib Pra-Upgrade & Cluster Safety Checklist (Semua Versi):
  • 1. Backup Penuh & Teruji: Cadangkan seluruh VM/CT ke media eksternal/PBS. Pastikan backup dapat dipulihkan (tested restore) sebelum memulai upgrade.
  • 2. Backup Konfigurasi Host: Salin: /etc/pve, /etc/network/interfaces, /etc/corosync/, /etc/passwd, /etc/resolv.conf, /etc/vzdump.conf.
  • 3. Kapasitas Root Partition: Minimal 5 GB free space di / (idealnya >10 GB) — cek: df -h /.
  • 4. Akses Konsol Independen: Gunakan iKVM/IPMI atau akses fisik. Jika hanya SSH, gunakan tmux atau screen. JANGAN upgrade melalui noVNC Web Console GUI.
  • 5. Rolling Upgrade Cluster Multi-Node: Upgrade node satu per satu — jangan sekaligus. Pastikan Quorum Quorate: Yes sebelum dan sesudah tiap node. Migrasikan VM/CT ke node lain sebelum upgrade. Untuk Ceph: set ceph osd set noout sebelum reboot, unset setelah node aktif kembali.
  • 6. Periksa Known Issues: Baca daftar known upgrade issues di setiap sub-tahap sebelum memulai proses upgrade.
10.1 Matriks Evolusi Sistem & Komponen Proxmox VE
Versi PVE Base OS Debian Kernel Linux Ceph Bawaan QEMU Status & Akhir Dukungan (EOL) Checklist CLI Breaking Changes Kritis
PVE 3.4 Debian 7 Wheezy 2.6.32 / 3.10 / 4.4 Firefly 0.80 / Hammer 0.94 QEMU 2.x EOL
Tidak didukung — repo di archive.proxmox.com		 Manual OpenVZ dihapus (wajib konversi backup/restore → LXC); Corosync 1.x → 2.x (cluster dibangun ulang); HA manager baru gantikan RGmanager; DRBD9 tidak kompatibel DRBD8.
PVE 4.x Debian 8 Jessie 4.4 Hammer 0.94 / Jewel 10.2 QEMU 2.3 / 2.6 EOL
Tidak didukung — repo di archive.proxmox.com		 Manual SysVinit dihapus (pindah ke systemd penuh); default display cirrus → std; Ceph Luminous wajib sebelum upgrade; repo beralih ke archive.proxmox.com.
PVE 5.4 Debian 9 Stretch 4.15 Luminous 12.2 / Mimic 13.2 QEMU 2.9 / 3.x EOL
Tidak didukung — repo di archive.proxmox.com		 pve5to6 --full Corosync 2.x → 3.x (kronosnet — upgrade Corosync duluan); OVMF/EFI disk mapping fix; OpenSSL security level naik; semantik su berubah.
PVE 6.4 Debian 10 Buster 5.4 Nautilus 14.2 / Octopus 15.2 QEMU 5.x EOL
Tidak didukung — repo di archive.debian.org		 pve6to7 --full cgroup v1 klasik; repo EOL di archive.debian.org; Ceph wajib upgrade ke Octopus sebelum PVE upgrade; password root wajib diset.
PVE 7.4 Debian 11 Bullseye 5.15 Pacific 16.2 / Quincy 17.2 QEMU 7.x EOL
Tidak didukung		 pve7to8 --full Default beralih ke cgroup v2; perubahan MAC address Linux bridge; kernel 5.15 tdp_mmu issue di hardware lama (>8 tahun); NVIDIA vGPU butuh GRID 16.0+.
PVE 8.4 Debian 12 Bookworm 6.8 (opt: 6.2) Quincy 17.2 / Reef 18.2 QEMU 8.x LTS
EOL 31 Agustus 2026		 pve8to9 --full Repo non-free-firmware dipisah; transisi GPG keyrings; GRUB LVM UEFI bug; NTPsec network hang; KSM regresi NUMA; cgroup v1 dihapus di PVE 9.
PVE 9.x Debian 13 Trixie 6.14+ / 7.0 Squid 19.2 QEMU 10.x Current
Target rilis aktif		 Versi Saat Ini Format repo modern deb822 (.sources); cgroup v1 dihapus penuh; LXC 7.x (+OCI 9.1+); ZFS 2.4 (RAIDZ expansion); Ceph Tentacle default 9.2; /tmp tmpfs; LVM autoactivation nonaktif; HA groups → HA rules.
10.2 Tahap 1: Upgrade PVE 3.4 → 4.x (Debian 7 Wheezy → Debian 8 Jessie)
Prasyarat Khusus PVE 3 → 4:
  • Update ke PVE 3.4 rilis minor terbaru (jalankan apt-get update && apt-get dist-upgrade terlebih dahulu).
  • Konversi OpenVZ → LXC wajib: OpenVZ dihapus di PVE 4. Cadangkan semua container OpenVZ; setelah upgrade lakukan konversi via backup/restore ke LXC (panduan Convert OpenVZ to LXC).
  • Cluster dibangun ulang: Corosync 1.x → 2.x tidak kompatibel on-the-wire. PVE 3 dan 4 tidak bisa dicampur dalam satu cluster; setelah upgrade buat cluster baru dengan pvecm create <nama> dan gabungkan node dengan pvecm add <ip-node-pertama> -force.
  • HA manager baru menggantikan RGmanager — konfigurasi failover/fencing direkonfigurasi manual via GUI pasca upgrade.
  • Minimal 1 GB free disk space di /; akses console/IPMI (jangan via noVNC GUI); jika SSH gunakan tmux/screen.
  • Repo sudah EOL: gunakan archive.debian.org dan archive.proxmox.com. Jika apt-get update gagal sertifikat, gunakan HTTP (bukan HTTPS) untuk repo EOL.
In-Place Upgrade: PVE 3.4 → 4.x (Debian Wheezy → Jessie) 
# ================================================================
# UPGRADE PROXMOX VE 3.4 → 4.x
# Ref: http://pve.proxmox.com/wiki/Upgrade_from_3.x_to_4.0
# Jalankan dari console/SSH (gunakan tmux/screen jika via SSH)
# ================================================================

# LANGKAH 1: Pastikan PVE 3.4 bersih & di versi minor terbaru
apt-get update && apt-get dist-upgrade

# LANGKAH 2: Hapus paket PVE 3.x lama agar tidak bentrok dependensi
apt-get remove proxmox-ve-2.6.32 pve-manager corosync-pve openais-pve \
  redhat-cluster-pve pve-cluster pve-firmware

# LANGKAH 3: Arahkan semua repo ke Jessie (PVE & Debian EOL → archive)
sed -i 's/wheezy/jessie/g' /etc/apt/sources.list
sed -i 's/wheezy/jessie/g' /etc/apt/sources.list.d/pve-enterprise.list
# Hapus baris backports jika ada (konflik dependensi jessie-backports)
sed -i '/backports/d' /etc/apt/sources.list /etc/apt/sources.list.d/*.list 2>/dev/null || true
apt-get update

# LANGKAH 4: (Ceph only) Gunakan repo Ceph Hammer untuk Jessie
# echo "deb http://download.ceph.com/debian-hammer jessie main" \
#   > /etc/apt/sources.list.d/ceph.list

# LANGKAH 5: Tambahkan repo PVE 4 Jessie (EOL → archive.proxmox.com)
echo "deb http://archive.proxmox.com/debian/pve jessie pve-no-subscription" \
  > /etc/apt/sources.list.d/pve-install-repo.list
apt-get update

# LANGKAH 6: Pasang kernel PVE 4 baru (cek versi terbaru dulu)
apt-cache search pve-kernel | sort -V
apt-get install pve-kernel-4.4.19-1-pve pve-firmware

# LANGKAH 7: Upgrade sistem dasar ke Debian Jessie
apt-get upgrade
apt-get dist-upgrade   # Proses bisa 15-60 menit (5 menit di SSD)

# LANGKAH 8: Reboot ke kernel PVE 4 (Linux 4.4)
reboot

# LANGKAH 9: Pasang paket Proxmox VE 4.x & bersihkan sisa PVE 3
apt-get install proxmox-ve
dpkg --purge vzctl redhat-cluster-pve   # Hapus OpenVZ & RGmanager lama
apt-get remove pve-kernel-2.6.*         # Hapus kernel 2.6 lama
reboot
apt-get install proxmox-ve              # Jalankan lagi pasca reboot

# LANGKAH 10: Verifikasi — target: PVE 4.x, kernel 4.4.x-pve
pveversion -v
uname -r
Breaking Changes & Known Issues Upgrade PVE 3 → 4:
  • OpenVZ Dihapus: Container OpenVZ tidak bisa langsung di-upgrade. Lakukan backup, lalu konversi ke LXC pasca upgrade.
  • Corosync 1.x → 2.x (Cluster Rebuild): Format on-the-wire tidak kompatibel; PVE 3 dan 4 tidak dapat berada dalam satu cluster. Bangun ulang cluster: pvecm create di node pertama, pvecm add <ip> -force di node lain. Hapus sisa data cluster lama: rm /etc/pve/cluster.conf.
  • HA Manager Baru: RGmanager digantikan HA manager baru — konfigurasi failover domain & fencing direkonfigurasi manual via Web GUI.
  • DRBD9 Preview: PVE 4 mendukung DRBD9 yang tidak kompatibel dengan DRBD 8.x (technology preview).
  • Grub Failure saat boot: Lihat Recover From Grub Failure.
Pasca Upgrade PVE 3 → 4: Kosongkan cache browser & force-reload Web UI (Ctrl+Shift+R). Konversi container OpenVZ → LXC, lalu rebuild cluster & restore VM/CT dari backup. Data VM tetap utuh di /var/lib/vz/images/ dan /etc/pve/qemu-server/*.conf.
10.3 Tahap 2: Upgrade PVE 4.x → 5.4 (Debian 8 Jessie → Debian 9 Stretch)
Prasyarat Khusus PVE 4 → 5:
  • Update ke PVE 4.4 rilis minor terbaru (jalankan apt-get update && apt-get dist-upgrade).
  • Ceph: upgrade ke Luminous (12.2) SEBELUM PVE upgrade — ikuti panduan Ceph Jewel to Luminous.
  • Pastikan partisi /boot punya ruang untuk kernel baru (min 60 MB) — bersihkan kernel lama via pveversion -v.
  • Minimal 1 GB free disk space di /; akses console/IPMI; jika SSH gunakan tmux/screen.
  • Repo sudah EOL: gunakan archive.proxmox.com; jika gagal sertifikat, gunakan HTTP.
In-Place Upgrade: PVE 4.x → 5.4 (Debian Jessie → Stretch) 
# ================================================================
# UPGRADE PROXMOX VE 4.x → 5.4
# Ref: http://pve.proxmox.com/wiki/Upgrade_from_4.x_to_5.0
# ================================================================

# LANGKAH 1: Pastikan PVE 4.4 di versi minor terbaru
apt-get update && apt-get dist-upgrade

# LANGKAH 2: Update Debian repo Wheezy/Jessie → Stretch
sed -i 's/jessie/stretch/g' /etc/apt/sources.list
sed -i 's/jessie/stretch/g' /etc/apt/sources.list.d/pve-enterprise.list

# LANGKAH 3: Tambahkan PVE release key (Stretch)
wget http://archive.proxmox.com/debian/proxmox-ve-release-5.x.gpg \
  -O /etc/apt/trusted.gpg.d/proxmox-ve-release-5.x.gpg

# LANGKAH 4: (Ceph only) Ganti repo ceph.com → Proxmox Ceph Luminous
echo "deb http://archive.proxmox.com/debian/ceph-luminous stretch main" \
  > /etc/apt/sources.list.d/ceph.list

# LANGKAH 5: Hapus baris backports (tidak diuji untuk upgrade ini)
sed -i '/backports/d' /etc/apt/sources.list /etc/apt/sources.list.d/*.list 2>/dev/null || true

# LANGKAH 6: Update index & pasang repo PVE 5
apt-get update

# LANGKAH 7: Hapus SysVinit (wajib — PVE 5 murni systemd)
apt purge insserv sysv-rc initscripts openrc

# LANGKAH 8: Eksekusi dist-upgrade ke PVE 5 (15-60 menit)
apt-get dist-upgrade

# LANGKAH 9: Reboot ke kernel PVE 5 (Linux 4.15)
reboot

# LANGKAH 10: Verifikasi — target: PVE 5.4-x, kernel 4.15.x-pve
pveversion -v
uname -r
Breaking Changes & Known Issues Upgrade PVE 4 → 5:
  • SysVinit Dihapus: PVE 5 beralih penuh ke systemd. Jalankan apt purge insserv sysv-rc initscripts openrc sebelum dist-upgrade, atau upgrade akan gagal.
  • Default Display cirrus → std: Untuk live migration tanpa downtime ke host PVE 4, pastikan node PVE 4 sudah apt update && apt full-upgrade (qemu-server ≥ 4.0-111).
  • Live Migration Antar Versi: Migrasi VM/CT dari PVE versi lama → baru selalu berhasil; sebaliknya (baru → lama) umumnya tidak didukung.
  • Ceph Luminous Wajib: Cluster Ceph harus sudah Luminous sebelum upgrade PVE 4 → 5.
  • Grub Failure saat boot: Lihat Recover From Grub Failure.
Pasca Upgrade PVE 4 → 5: PVE 5 node dapat ditambahkan ke cluster PVE 4 yang ada dan guest dimigrasikan (diuji & didukung). Kosongkan cache browser & force-reload Web UI.
10.4 Tahap 3: Upgrade PVE 5.4 → 6.0 (Debian 9 Stretch → Debian 10 Buster)
Prasyarat Khusus PVE 5 → 6:
  • Update ke PVE 5.4 rilis minor terbaru (jalankan apt update && apt dist-upgrade).
  • Upgrade Corosync 2.x → 3.x DIKUTAMAKAN: Format on-the-wire berubah (kronosnet). Stop semua layanan HA dulu, upgrade Corosync di semua node, lalu jalankan dist-upgrade PVE.
  • Ceph: upgrade ke Nautilus SETELAH PVE di-upgrade — ikuti Ceph Luminous to Nautilus.
  • Minimal 1 GB free disk space di /; akses console/IPMI; jika SSH gunakan tmux/screen.
  • Password root wajib diset — jika tidak, paket sudo dihapus saat upgrade dan login root gagal.
  • Repo sudah EOL: gunakan archive.proxmox.com; jika gagal sertifikat, gunakan HTTP.
In-Place Upgrade: PVE 5.4 → 6.0 (Debian Stretch → Buster + Corosync 3 duluan) 
# ================================================================
# UPGRADE PROXMOX VE 5.4 → 6.0
# Ref: http://pve.proxmox.com/wiki/Upgrade_from_5.x_to_6.0
# ================================================================

# LANGKAH 1: Pastikan PVE 5.4 di versi minor terbaru & jalankan checklist
apt update && apt dist-upgrade
pve5to6 --full   # Perbaiki semua WARNING sebelum lanjut

# ---- KHUSUS CLUSTER: Upgrade Corosync 2.x → 3.x LEBIH DULU ----
# Stop layanan HA di SETIAP node (urutan penting):
systemctl stop pve-ha-lrm
systemctl stop pve-ha-crm
# Tambahkan repo Corosync 3 (stretch backport):
echo "deb http://archive.proxmox.com/debian/corosync-3/ stretch main" \
  > /etc/apt/sources.list.d/corosync3.list
apt update
# Pre-download lalu upgrade Corosync di semua node:
apt dist-upgrade --download-only
apt dist-upgrade
# Verifikasi quorum tiap node: pvecm status
# Setelah semua node Corosync 3, nyalakan kembali HA:
systemctl start pve-ha-lrm
systemctl start pve-ha-crm

# LANGKAH 2: Pindahkan VM/CT penting ke node lain (rolling upgrade)
# (Migrasi dari versi lama → baru selalu didukung)

# LANGKAH 3: Update repo Debian Stretch → Buster
sed -i 's/stretch/buster/g' /etc/apt/sources.list
# Nonaktifkan repo PVE 5 lama (tambah # di awal baris):
sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list 2>/dev/null || true

# LANGKAH 4: Tambahkan repo PVE 6 Buster
echo "deb http://archive.proxmox.com/debian/pve buster pve-no-subscription" \
  > /etc/apt/sources.list.d/pve-install-repo.list

# LANGKAH 5: (Ceph only) Ganti repo ceph.com → Proxmox Ceph Luminous Buster
echo "deb http://archive.proxmox.com/debian/ceph-luminous buster main" \
  > /etc/apt/sources.list.d/ceph.list

# LANGKAH 6: Hapus baris backports & update index
sed -i '/backports/d' /etc/apt/sources.list /etc/apt/sources.list.d/*.list 2>/dev/null || true
apt update

# LANGKAH 7: Eksekusi dist-upgrade ke PVE 6 (15-60 menit)
apt dist-upgrade

# LANGKAH 8: Reboot ke kernel PVE 6 (Linux 5.4)
reboot

# LANGKAH 9: Verifikasi — target: PVE 6.0+ / 6.4-x, kernel 5.4.x-pve
pveversion -v
uname -r
Breaking Changes & Known Issues Upgrade PVE 5 → 6:
  • Corosync 3 Dikutmakan: Stop HA (pve-ha-lrm lalu pve-ha-crm) di semua node sebelum upgrade Corosync. Setelah selesai, hapus /etc/apt/sources.list.d/corosync3.list.
  • proxmox-ve terlalu lama / mau dihapus: Jika PVE diinstal di atas Debian murni, paket linux-image-amd64 konflik — hapus dulu: apt remove linux-image-amd64 sebelum dist-upgrade.
  • Root Password Wajib: Tanpa password root, sudo dihapus saat upgrade & login root tidak bisa dilakukan.
  • OVMF/EFI Disk: Pastikan boot binary ada di \EFI\BOOT\BOOTX64.EFI sebelum upgrade (qemu-server 6.1-12 fix). Jika sudah upgrade & tidak boot, lihat OVMF/UEFI Boot Entries.
  • OpenSSL Security Level Naik & su environment: Baca Debian Buster upgrade notes.
  • OVH server blocked: Jika pasca upgrade tidak bisa diakses (no GUI/SSH), baca tutorial OVH.
Pasca Upgrade PVE 5 → 6 (Cluster & Ceph): Hapus /etc/apt/sources.list.d/corosync3.list. Untuk Ceph hyper-converged, upgrade ke Nautilus (Luminous → Nautilus) setelah seluruh cluster ter-upgrade. Kosongkan cache browser & force-reload Web UI.
10.5 Tahap 4: Upgrade PVE 6.4 → 7.4 (Debian 10 Buster → Debian 11 Bullseye)
Prasyarat Khusus PVE 6 → 7:
  • Update ke PVE 6.4 rilis minor terbaru (jalankan apt update && apt dist-upgrade -y terlebih dahulu).
  • Ceph hyper-converged: upgrade Ceph Nautilus → Octopus (15.2) sebelum upgrade PVE — ikuti panduan Ceph Nautilus to Octopus.
  • Co-installed PBS: upgrade PBS ke versi 2.x sebelum upgrade PVE.
  • Repo Buster sudah EOL: gunakan archive.debian.org dan archive.proxmox.com jika apt gagal sebelum proses upgrade.
  • Password root wajib diset — jika tidak ada, paket sudo akan dihapus saat upgrade dan login root tidak bisa dilakukan.
In-Place Upgrade: PVE 6.4 → 7.4 (Debian Buster → Bullseye) 
# ================================================================
# UPGRADE PROXMOX VE 6.4 → 7.4
# Ref: https://pve.proxmox.com/wiki/Upgrade_from_6.x_to_7.0
# Jalankan dari console/SSH (gunakan tmux/screen jika via SSH)
# ================================================================

# LANGKAH 1: Update PVE 6.4 ke versi rilis minor terbaru
apt update && apt dist-upgrade -y

# LANGKAH 2: Jalankan checklist validasi pra-upgrade (pastikan 0 ERROR/FAIL)
pve6to7 --full

# LANGKAH 3: Periksa MAC address Linux bridge sebelum upgrade
# (Penting untuk setup hosted/datacenter dengan pembatasan MAC)
ip -c link  # Catat MAC address bridge saat ini (vmbr0, dll.)
# Jika perlu, tambahkan 'hwaddress XX:XX:XX:XX:XX:XX' ke /etc/network/interfaces
# atau pastikan ifupdown2 versi 3.1.0-1+pmx1 atau lebih baru terinstall.

# LANGKAH 4: Ganti semua repo Buster ke Bullseye
# Catatan: security repo berubah dari 'buster/updates' menjadi 'bullseye-security'
sed -i 's/buster\/updates/bullseye-security/g;s/buster/bullseye/g' /etc/apt/sources.list

# LANGKAH 5: Nonaktifkan semua repository PVE 6.x lama
sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list 2>/dev/null || true

# LANGKAH 6: Tambahkan repository PVE 7 Bullseye No-Subscription
echo "deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription" \
  > /etc/apt/sources.list.d/pve-no-subscription.list

# (Ceph only) Ganti repo Ceph ke Proxmox CDN untuk Octopus:
# echo "deb http://download.proxmox.com/debian/ceph-octopus bullseye main" \
#   > /etc/apt/sources.list.d/ceph.list

# LANGKAH 7: Update index repo
apt update

# LANGKAH 8: Eksekusi dist-upgrade ke PVE 7 (proses 15-60 menit)
apt dist-upgrade -y

# LANGKAH 9: Reboot untuk memuat kernel PVE 7 (Linux 5.15)
reboot

# LANGKAH 10: Verifikasi pasca reboot — target: kernel 5.15.x-pve, PVE 7.4-x
pveversion -v
uname -r
Breaking Changes & Known Issues Upgrade PVE 6 → 7:
  • cgroup v2 Default: LXC container dengan systemd <231 (CentOS 7, Ubuntu 16.04) tidak bisa start. Solusi sementara (PVE 7 only): tambahkan systemd.unified_cgroup_hierarchy=0 ke GRUB_CMDLINE_LINUX_DEFAULT di /etc/default/grub, lalu update-grub. Solusi permanen: migrasi OS container ke versi lebih baru.
  • MAC Address Bridge Berubah: systemd Bullseye mengubah kalkulasi MAC address bridge (berdasarkan nama bridge + machine-id). Untuk hosted setups, tambahkan hwaddress XX:XX:XX:XX:XX:XX ke konfigurasi bridge di /etc/network/interfaces, atau gunakan ifupdown2 3.1.0+ yang menangani ini otomatis.
  • maxfiles deprecated: Parameter maxfiles di backup storage digantikan prune retention settings. Edit via Web UI: Storage → Backup Retention → keep-last.
  • Pool.Allocate Permission: Setelah semua node cluster ter-upgrade ke PVE 7, jalankan: pveum role modify CustomRoleID --append --privs Pool.Audit
  • Kernel 5.15 KVM Error (hardware >8 tahun): Error KVM: entry failed, hardware error 0x80000021 — update ke kernel pve-kernel-5.15.39-3-pve atau lebih baru. Update firmware BIOS/microcode terlebih dahulu.
  • LXC cgroup2 config key: lxc.cgroup.devices.allow → lxc.cgroup2.devices.allow untuk hardware passthrough di LXC.
  • Third-party Storage Plugins: Plugin pihak ketiga yang tidak kompatibel PVE 7 tidak akan dimuat. Tunggu update dari developer.
Pasca Upgrade PVE 6 → 7 (Cluster): Periksa semua node berjalan pada versi paket terbaru. Jika menggunakan Ceph Octopus, Anda dapat meng-upgrade ke Ceph Pacific setelah seluruh cluster ter-upgrade ke PVE 7 — ikuti panduan Ceph Octopus to Pacific. Kosongkan cache browser dan force-reload Web UI (Ctrl+Shift+R).
10.6 Tahap 5: Upgrade PVE 7.4 → 8.4 (Debian 11 Bullseye → Debian 12 Bookworm)
Prasyarat Khusus PVE 7 → 8:
  • Update ke PVE 7.4 rilis minor terbaru — verifikasi dengan pveversion, target minimal 7.4-15+.
  • Ceph hyper-converged: upgrade Ceph Octopus/Pacific → Quincy (17.2) sebelum upgrade PVE — ikuti panduan Ceph Pacific to Quincy.
  • Co-installed PBS: upgrade PBS 2.x ke 3.x sebelum upgrade PVE.
  • Minimal 5 GB free disk space di partisi root.
  • NVIDIA vGPU/GRID: pastikan driver minimum GRID 16.0 (535.54.06) — versi lama tidak kompatibel kernel 6.2+.
In-Place Upgrade: PVE 7.4 → 8.4 (Debian Bullseye → Bookworm) 
# ================================================================
# UPGRADE PROXMOX VE 7.4 → 8.4
# Ref: https://pve.proxmox.com/wiki/Upgrade_from_7_to_8
# ================================================================

# LANGKAH 1: Pastikan PVE 7.4 di versi terbaru (minimal 7.4-15)
apt update && apt dist-upgrade -y
pveversion  # Harus minimal 7.4-15

# LANGKAH 2: Jalankan checklist validasi pra-upgrade (pastikan 0 FAIL)
pve7to8 --full

# LANGKAH 3: Ubah repo Debian dari Bullseye ke Bookworm
sed -i 's/bullseye/bookworm/g' /etc/apt/sources.list
# Pastikan tidak ada sisa repo Bullseye di file .list lainnya:
grep -r 'bullseye' /etc/apt/sources.list.d/ || echo "Bersih — tidak ada sisa Bullseye"

# LANGKAH 4: Update repo PVE ke Bookworm No-Subscription
echo "deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription" \
  > /etc/apt/sources.list.d/pve-no-subscription.list

# (Ceph only) Update repo Ceph ke Quincy Bookworm (wajib Quincy 17.2 sebelum ini):
# echo "deb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription" \
#   > /etc/apt/sources.list.d/ceph.list

# LANGKAH 5: Update index repository
apt update

# LANGKAH 6: Eksekusi dist-upgrade ke PVE 8
# Selama proses, konfirmasi file konfigurasi yang diminta:
# /etc/issue           → No (keep current)
# /etc/lvm/lvm.conf    → Yes (install maintainer version)
# /etc/ssh/sshd_config → Yes (pindah ke KbdInteractiveAuthentication)
# /etc/default/grub    → No (keep current, kecuali tidak ada perubahan kustom)
apt dist-upgrade -y

# LANGKAH 7: Periksa hasil upgrade dengan script checker
pve7to8

# LANGKAH 8: Reboot untuk memuat kernel PVE 8 (Linux 6.x)
# PENTING: Reboot WAJIB dilakukan meskipun sebelumnya menggunakan kernel 6.2 opt-in
reboot

# LANGKAH 9: Verifikasi pasca reboot — target: kernel 6.x-pve, PVE 8.4-x
pveversion -v
uname -r
Breaking Changes & Known Issues Upgrade PVE 7 → 8:
  • GRUB LVM UEFI Boot Failure: Sistem UEFI dengan root di LVM rentan bug grub (disk lvmid/... not found). Perbaiki dengan: [ -d /sys/firmware/efi ] && apt install grub-efi-amd64
  • NTPsec Network Hang saat Boot: Jika ntpsec + ntpsec-ntpdate keduanya terinstall, network bisa hang saat boot (bug sudah diperbaiki di ifupdown2 3.2.0-1+pmx8). Solusi: apt install chrony atau apt remove ntpsec-ntpdate.
  • KSM Performance Degradation (multi-socket NUMA): Kernel 6.2 mengalami regresi KSM pada sistem multi-socket NUMA. Pertahankan PVE 7 (kernel 5.15) untuk sistem tersebut hingga tersedia kernel 6.5+.
  • cgroup v1 Terakhir Didukung (PVE 8): PVE 8 adalah rilis terakhir yang mendukung mode "hybrid" cgroup. Container dengan systemd ≤230 (CentOS 7, Ubuntu 16.04) harus dimigrasikan sebelum upgrade ke PVE 9.
  • VM Live Migration Intel Skylake+: VM CPU type qemu64 dari source host Intel Skylake+ + kernel 5.15 bisa hang setelah migrasi ke target kernel 6.2. Pastikan target sudah kernel pve-kernel-6.2.16-5-pve atau lebih baru.
  • Systemd-boot (ZFS on root + UEFI): Paket systemd-boot dipecah dari paket systemd di Bookworm. Install manual jika diperlukan sesuai peringatan dari pve7to8.
  • non-free-firmware (Debian 12): Komponen non-free-firmware dipisah di Bookworm. Tambahkan ke sources.list agar driver firmware NIC dan hardware tersedia: sed -i 's/non-free$/non-free non-free-firmware/' /etc/apt/sources.list
Pasca Upgrade PVE 7 → 8 (Cluster): Kosongkan cache browser (Ctrl+Shift+R / Cmd+Alt+R di macOS). Lanjutkan upgrade ke node berikutnya dari langkah Prerequisites. Jika menggunakan Ceph Quincy, Anda dapat upgrade ke Ceph Reef setelah semua node ter-upgrade ke PVE 8.
10.7 Tahap 6: Upgrade PVE 8.4 → 9.x (Debian 12 Bookworm → Debian 13 Trixie + Format Modern deb822)
Prasyarat Khusus PVE 8 → 9:
  • Update ke PVE 8.4 rilis minor terbaru (minimal pve-manager 8.4.1).
  • Ceph hyper-converged: upgrade Ceph Quincy/Reef → Squid (19.2) sebelum upgrade PVE — ikuti panduan Ceph Reef to Squid. Verifikasi: ceph --version (harus 19.x).
  • Co-installed PBS: upgrade PBS 3.x ke 4.x sebelum upgrade PVE.
  • Minimal 5 GB free disk space (idealnya >10 GB) di partisi root.
  • Container LXC dengan systemd ≤230 (CentOS 7, Ubuntu 16.04) tidak akan berjalan di PVE 9 — cgroup v1 telah dihapus. Migrasikan terlebih dahulu.
  • Jika hanya SSH tersedia: gunakan tmux atau screen untuk menghindari disconnect.
  • Repo Enterprise dinonaktifkan: Panduan ini menggunakan no-subscription. Pastikan pve-enterprise.list dinonaktifkan (di-comment) sebelum apt update agar tidak muncul error 401 Unauthorized (lihat LANGKAH 6 di bawah). Pengguna Enterprise berlangganan harus memakai pve-enterprise.sources deb822, bukan mengaktifkan ulang file .list lama.
In-Place Upgrade: PVE 8.4 → 9.x (Debian Bookworm → Trixie + deb822 Modern) 
# ================================================================
# UPGRADE PROXMOX VE 8.4 → 9.x (FORMAT deb822 MODERN)
# Ref: http://pve.proxmox.com/wiki/Upgrade_from_8_to_9
# Gunakan tmux/screen jika via SSH untuk menghindari disconnect
# ================================================================

# LANGKAH 1: Pastikan PVE 8.4 di versi terbaru (minimal 8.4.1)
apt update && apt dist-upgrade -y
pveversion  # Harus minimal 8.4.1

# LANGKAH 2: (Ceph only) Verifikasi Ceph Squid sudah terpasang SEBELUM melanjutkan
ceph --version  # Harus menampilkan 19.x (Squid)

# LANGKAH 3: (Opsional) Nonaktifkan kernel audit socket untuk mengurangi log berlebihan
systemctl disable --now systemd-journald-audit.socket

# LANGKAH 4: Jalankan checklist validasi pra-upgrade (pastikan 0 FAIL)
pve8to9 --full

# LANGKAH 5: Ubah repo Debian dari Bookworm ke Trixie
sed -i 's/bookworm/trixie/g' /etc/apt/sources.list
# CATATAN: pve-enterprise.list TIDAK diubah ke trixie di sini — repo enterprise
# dinonaktifkan di bawah (panduan ini menggunakan no-subscription).

# LANGKAH 6: Nonaktifkan repo Enterprise (cegah error 401 saat apt update)
# Jika Anda berlangganan Enterprise resmi, LEWATI baris ini dan gunakan
# pve-enterprise.sources (deb822) seperti contoh Ceph enterprise di atas.
sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list 2>/dev/null || true

# Verifikasi tidak ada sisa Bookworm & tidak ada repo enterprise aktif:
grep -r 'bookworm' /etc/apt/sources.list /etc/apt/sources.list.d/ || echo "Bersih (Bookworm)"

# LANGKAH 7: Buat repo PVE 9 dalam format deb822 modern (.sources)
# Format deb822 adalah standar resmi Proxmox VE 9 dan Debian Trixie

# 7a. No-Subscription Repository (tanpa langganan berbayar):
cat > /etc/apt/sources.list.d/proxmox.sources << 'EOF'
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

# 7b. Hapus file .list lama PVE 8 agar tidak duplikat:
rm -f /etc/apt/sources.list.d/pve-no-subscription.list \
      /etc/apt/sources.list.d/pve-install-repo.list 2>/dev/null || true

# LANGKAH 8: (Ceph only) Update repo Ceph ke Squid Trixie (format deb822):
# Pastikan Ceph Squid 19.2 SUDAH terpasang sebelum langkah ini!
#   Enterprise (produksi):
#   cat > /etc/apt/sources.list.d/ceph.sources << 'EOF'
#   Types: deb
#   URIs: https://enterprise.proxmox.com/debian/ceph-squid
#   Suites: trixie
#   Components: enterprise
#   Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
#   EOF
#   No-Subscription (lab/self-support):
#   cat > /etc/apt/sources.list.d/ceph.sources << 'EOF'
#   Types: deb
#   URIs: http://download.proxmox.com/debian/ceph-squid
#   Suites: trixie
#   Components: no-subscription
#   Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
#   EOF
# Hapus repo ceph lama agar tidak duplikat; refresh subscription jika 401:
# rm -f /etc/apt/sources.list.d/ceph.list 2>/dev/null || true
# pvesubscription update --force   # jika update ceph gagal error 401

# LANGKAH 9: Update index repo dan verifikasi
apt update
apt policy  # Pastikan tidak ada error; hanya repo yang diinginkan yang muncul

# LANGKAH 10: Eksekusi dist-upgrade ke PVE 9
# Konfirmasi file konfigurasi yang diminta selama proses:
# /etc/issue           → No (keep current)
# /etc/lvm/lvm.conf    → Yes (install maintainer version)
# /etc/ssh/sshd_config → Yes (disarankan untuk KbdInteractiveAuthentication)
# /etc/default/grub    → No (keep current, kecuali tidak ada perubahan kustom)
# /etc/chrony/chrony.conf → Yes (jika tidak ada perubahan kustom)
# Pertanyaan restart service → gunakan default (reboot akan restart semua service)
apt dist-upgrade -y

# LANGKAH 11: Jalankan kembali checker script untuk verifikasi pasca upgrade
pve8to9

# LANGKAH 12: Reboot untuk memuat Kernel Debian 13 Trixie (Linux 6.14+/7.0)
# WAJIB: Reboot harus dilakukan meskipun sebelumnya menggunakan kernel 6.14 opt-in PVE 8
reboot

# LANGKAH 13: Verifikasi hasil akhir — target: kernel 6.14+-pve atau 7.0-pve, PVE 9.x
pveversion -v
uname -r
Breaking Changes & Known Issues Upgrade PVE 8 → 9:
  • cgroup v1 Dihapus Penuh: PVE 9 tidak mendukung cgroup v1 sama sekali. Container systemd ≤230 tidak bisa berjalan. Migrasi OS container ke versi yang lebih baru sebelum upgrade.
  • /tmp Kini tmpfs: Debian Trixie menjadikan /tmp sebagai tmpfs (hingga 50% RAM) dan membersihkan /tmp + /var/tmp secara berkala. Sesuaikan script yang menyimpan file besar di /tmp.
  • LVM Autoactivation Disabled: LV baru dibuat dengan autoactivation nonaktif. Untuk LV lama di shared LVM storage, jalankan migration script: /usr/share/pve-manager/migrations/pve-lvm-disable-autoactivation
  • LVM Thin Pool Perlu Repair: Beberapa sistem perlu perbaikan manual: lvconvert --repair pve/data
  • systemd-boot Meta-Package: Hapus paket systemd-boot (meta-package) jika disarankan oleh pve8to9. Pertahankan systemd-boot-efi dan systemd-boot-tools jika diperlukan.
  • GRUB LVM UEFI: Sama seperti PVE 8: [ -d /sys/firmware/efi ] && apt install grub-efi-amd64
  • HA Groups Deprecated: HA groups otomatis dimigrasikan ke HA rules setelah semua node ter-upgrade ke PVE 9. Cek log: journalctl -eu pve-ha-crm
  • Veeam Backup: Rusak untuk VM dengan QEMU machine version ≥ 10.0. Gunakan machine version lama atau tunggu update Veeam.
  • Host PCI Passthrough (kernel 6.14): Passthrough PCI host untuk beberapa VM kadang bermasalah — pantau update kernel terbaru.
  • systemd-sysctl & /etc/sysctl.conf: systemd-sysctl tidak lagi membaca /etc/sysctl.conf. Pindahkan konfigurasi sysctl custom ke /etc/sysctl.d/99-custom.conf.
  • Ceph Full Mesh Setups: Setup Ceph full mesh network tertentu bisa gagal boot. Periksa konfigurasi jaringan Ceph setelah upgrade.
  • FRR/OpenFabric/OSPF: Konfigurasi FRR kustom mungkin rusak akibat perubahan format konfigurasi FRR di Trixie. Verifikasi dan sesuaikan konfigurasi SDN/FRR.
  • Kernel Audit Messages: Pesan audit kernel akan muncul di log selama upgrade. Nonaktifkan sebelum upgrade: systemctl disable --now systemd-journald-audit.socket
  • Network Interface Name Change: Kernel baru dapat mengubah nama NIC (mis. VF terdeteksi). Gunakan pve-network-interface-pinning agar interface dipatok ke nama nicX. Pastikan ada akses konsol independen (IPMI/iKVM) bila jaringan tidak naik.
  • VM Memory Consumption Lebih Tinggi: PVE 9 menghitung overhead memori VM ke Host memory usage; persentase bisa melebihi 100% jika guest tidak melaporkan detail memori (pfSense/OPNsense, balloon device nonaktif, atau BalloonService Windows mati).
  • NVIDIA vGPU Compatibility: Driver minimal GRID 18.3 (570.158.02) — versi lama (15.x) tidak kompatibel kernel ≥6.0 / PVE 9.
Pasca Upgrade PVE 8 → 9 (Cluster): Setelah semua node ter-upgrade, HA groups otomatis dimigrasikan ke HA rules. Untuk Ceph: tetap di Squid hingga cluster stabil; upgrade ke Tentacle hanya setelah mengikuti panduan resmi Squid→Tentacle secara terpisah. Modernisasi format sumber repo dengan: apt modernize-sources (jawab "n" untuk preview dahulu, lalu "Y" untuk menerapkan — file .list.bak dipertahankan). Kosongkan cache browser (Ctrl+Shift+R atau Cmd+Alt+R di macOS).
10.8 Langkah Pasca Upgrade & Pembersihan Sistem (Semua Versi)
Post-Upgrade Cleanup, Verifikasi & ZFS Feature Upgrade 
# ================================================================
# POST-UPGRADE CLEANUP (Berlaku untuk semua tahap upgrade)
# ================================================================

# 1. Bersihkan paket obsolete, kernel lama, dan cache APT
apt autoremove --purge -y
apt clean

# 2. Verifikasi versi Proxmox VE yang aktif saat ini
pveversion -v

# 3. Verifikasi kernel yang sedang berjalan
uname -r

# 4. Verifikasi kesehatan Quorum Corosync cluster (jika multi-node)
pvecm status

# 5. (PVE 9 only - Opsional) Modernisasi format repo ke deb822
# Jawab "n" untuk preview, lalu "Y" untuk menerapkan
# apt modernize-sources

# 6. (ZFS only) Upgrade feature flags ZFS pool ke versi terbaru
# PERINGATAN: Jalankan HANYA SETELAH SELURUH NODE CLUSTER selesai di-upgrade!
# Setelah diupgrade, pool tidak dapat di-downgrade ke ZFS versi lebih lama.
# zpool upgrade -a

# 7. Verifikasi status Ceph (jika hyper-converged)
# ceph -s
# ceph osd unset noout  # Jika sebelumnya di-set saat rolling upgrade cluster

# 8. Cek ulang semua VM dan Container berjalan normal
qm list
pct list

# 9. Kosongkan cache browser dan reload Web UI
# Windows/Linux: Ctrl + Shift + R
# macOS:         Cmd + Alt + R
10.9 Troubleshooting Upgrade — Matriks Masalah Umum
Gejala / Error Penyebab Solusi
W: ...attempting to remove the meta-package 'proxmox-ve'! Repo target belum dikonfigurasi dengan benar, atau ada paket linux-image-amd64 yang konflik Verifikasi konfigurasi repo sudah ke versi target. Jika ada konflik: apt remove linux-image-amd64 sebelum dist-upgrade.
Upgrade gagal di tengah jalan (koneksi SSH terputus) SSH disconnect saat proses upgrade berlangsung Jalankan apt -f install untuk memperbaiki instalasi parsial. Gunakan tmux/screen untuk sesi upgrade berikutnya.
Sistem tidak bisa boot pasca upgrade (grub failure / boot loop) Inkompatibilitas ZFS legacy boot dengan grub versi baru, atau GRUB LVM UEFI bug Boot dari live CD/rescue. Ikuti panduan Recover From Grub Failure. Untuk LVM UEFI: apt install grub-efi-amd64.
Container LXC gagal start pasca upgrade ke PVE 7/9 OS container tidak mendukung cgroup v2 (systemd <231) PVE 7: tambahkan systemd.unified_cgroup_hierarchy=0 ke GRUB (workaround sementara). PVE 9: tidak ada solusi — harus migrasi OS container ke versi yang mendukung cgroup v2.
Check of pool pve/data failed (status:64) LVM Thin Pool butuh repair setelah upgrade PVE 8 → 9 lvconvert --repair pve/data
Network tidak naik setelah reboot (hang saat boot) Konflik ntpsec + ntpsec-ntpdate dengan ifupdown2 (PVE 7 → 8) apt install chrony atau apt remove ntpsec-ntpdate. Jika sudah hang: boot recovery mode, jalankan chmod -x /etc/network/if-up.d/ntpsec-ntpdate, reboot.
Error 401 Unauthorized saat apt update Repo enterprise aktif tanpa subscription key valid Nonaktifkan repo enterprise: sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list dan gunakan no-subscription. Atau perbarui subscription: pvesubscription update --force
Pesan audit kernel berlebihan di log saat upgrade PVE 8 → 9 Perubahan default systemd antara Bookworm dan Trixie (journald-audit) Jalankan sebelum upgrade: systemctl disable --now systemd-journald-audit.socket. Pesan berhenti setelah reboot pasca upgrade.
11

Download ISO OS & Template Container (LXC)

11.1 Upload ISO Melalui Web GUI
  1. Pilih storage local pada node Anda → Menu ISO Images.
  2. Klik tombol Upload untuk mengunggah file ISO dari komputer Anda, atau klik Download from URL dan masukkan URL unduhan langsung file ISO.
11.2 Mengunduh Template LXC Debian via CLI
Manajemen Template Appliance (pveam) 
# 1. Update katalog appliance Proxmox
pveam update

# 2. Cari template Debian yang tersedia
pveam available | grep debian

# 3. Unduh template Debian 12 / 13 ke storage local
pveam download local debian-12-standard_12.x-1_amd64.tar.zst
pveam download local debian-13-standard_13.x-1_amd64.tar.zst

# 4. Cek daftar template yang sudah terunduh
pveam list local
12

Membuat VM & CT Debian (Spesifikasi 2 Core / 4 GB / 20 GB)

12.1 Pembuatan Virtual Machine (VM) Debian via CLI
qm create — Debian VM 
# Buat VM ID 100 dengan 2 Core, 4 GB RAM, 20 GB Disk VirtIO SCSI + QEMU Agent
qm create 100 \
  --name debian-vm \
  --memory 4096 \
  --cores 2 \
  --cpu host \
  --net0 virtio,bridge=vmbr0 \
  --scsihw virtio-scsi-single \
  --scsi0 local-lvm:20,discard=on,ssd=1 \
  --ide2 local:iso/debian-12.x.x-amd64-netinst.iso,media=cdrom \
  --boot order="ide2;scsi0" \
  --ostype l26 \
  --agent enabled=1

# Nyalakan VM dan buka Web Console noVNC untuk instalasi OS
qm start 100
12.2 Pembuatan Container (LXC) Debian via CLI
pct create — Debian CT 
# Buat Container ID 101: 2 Core, 4 GB RAM, 20 GB Rootfs, Unprivileged + Nesting
pct create 101 local:vztmpl/debian-12-standard_12.x-1_amd64.tar.zst \
  --hostname debian-ct \
  --memory 4096 \
  --cores 2 \
  --rootfs local-lvm:20 \
  --net0 name=eth0,bridge=vmbr0,ip=dhcp \
  --features nesting=1 \
  --unprivileged 1 \
  --start 1

# Masuk ke terminal Container
pct enter 101
13

Instalasi VM Windows (VirtIO Driver ISO) & QEMU Guest Tools

Sistem operasi Windows tidak membawa driver controller storage VirtIO SCSI secara bawaan. Anda wajib me-mount ISO driver virtio-win.iso saat instalasi dan memasang QEMU Guest Agent untuk sinkronisasi IP address, graceful shutdown, dan backup live fsfreeze.

13.1 Link Download ISO Resmi Microsoft & Fedora VirtIO
Sistem Operasi / Asset Edisi / Tipe Tautan Unduhan Resmi
Windows 11 64-bit Multi-edition ISO (UEFI + vTPM 2.0) Portal Windows 11
Windows 10 64-bit ISO (Home / Pro 22H2) Portal Windows 10
Windows Server 2022 LTSC Evaluation 64-bit ISO Portal Server 2022
Windows Server 2025 LTSC Evaluation 64-bit ISO (Terbaru) Portal Server 2025
VirtIO Driver ISO Stable VirtIO Drivers (virtio-win.iso) Direct Link virtio-win.iso
Unduh virtio-win.iso Langsung ke Server PVE 
# Unduh berkas virtio-win.iso langsung ke direktori template ISO Proxmox
wget https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso \
  -O /var/lib/vz/template/iso/virtio-win.iso

# Verifikasi berkas terunduh
ls -lh /var/lib/vz/template/iso/virtio-win.iso
13.2 Konfigurasi VM Windows: UEFI + vTPM 2.0 (Windows 11 & Server 2022/2025)
qm create — Windows 11 / Server (UEFI + vTPM 2.0 + q35) 
# VMID 102: 4 Core, 8 GB RAM, 64 GB Disk VirtIO SCSI SSD, UEFI OVMF + vTPM 2.0
qm create 102 \
  --name win-server-uefi \
  --memory 8192 \
  --cores 4 \
  --cpu host \
  --machine q35 \
  --bios ovmf \
  --efidisk0 local-lvm:1,efitype=4m,pre-enrolled-keys=1 \
  --tpmstate0 local-lvm:4,version=v2.0 \
  --net0 virtio,bridge=vmbr0 \
  --scsihw virtio-scsi-single \
  --scsi0 local-lvm:64,discard=on,ssd=1 \
  --ide0 local:iso/virtio-win.iso,media=cdrom \
  --ide2 local:iso/windows-server-2022.iso,media=cdrom \
  --boot order="ide2;scsi0;ide0" \
  --ostype win2k22 \
  --agent enabled=1

qm start 102
13.3 Langkah Memuat Driver VirtIO SCSI Saat Setup Windows
  1. Buka konsol VM melalui Proxmox Web GUI (noVNC) → Masuk ke installer Windows.
  2. Saat tiba pada tahap "Where do you want to install Windows?", daftar disk akan kosong karena controller VirtIO SCSI membutuhkan driver.
  3. Klik tombol Load Driver → Klik Browse.
  4. Buka drive CD-ROM virtio-win:
    • Masuk ke folder: \vioscsi\w11\amd64 (atau \vioscsi\2k22\amd64 untuk Server 2022).
    • Pilih item Red Hat VirtIO SCSI pass-through controller → Klik Next.
  5. Disk virtual akan langsung terdeteksi. Lanjutkan partisi dan instalasi Windows seperti biasa.
13.4 Instalasi Guest Tools & Service QEMU Agent pada Windows
  1. Setelah masuk ke desktop Windows, buka File Explorer → Masuk ke drive CD-ROM virtio-win.
  2. Jalankan file installer: virtio-win-gt-x86_64.exe.
  3. Selesaikan wisaya instalasi untuk memasang driver Network (NetKVM), Ballooning memory, serta layanan sistem QEMU Guest Agent.
  4. Buka services.msc dan pastikan service QEMU Guest Agent dalam status Running (Automatic).
13.5 Instalasi QEMU Guest Agent pada Linux (Debian/Ubuntu/RHEL)
Guest OS Linux — Install Guest Agent 
# Pada Debian / Ubuntu:
apt update && apt install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

# Pada RHEL / Rocky / AlmaLinux:
# dnf install -y qemu-guest-agent && systemctl enable --now qemu-guest-agent

# Verifikasi status
systemctl status qemu-guest-agent --no-pager
13.6 Konfigurasi Windows UEFI Tanpa Modul TPM (Bypass Workaround)

Bagi VM Windows 11 di lingkungan lab tanpa vTPM, lewati pemeriksaan hardware pada installer:

Bypass Hardware Check Windows 11 via CMD Setup 
# 1. Pada layar pertama instalasi Windows, tekan  Shift + F10  untuk membuka Command Prompt
# 2. Masukkan perintah bypass registry berikut lalu tekan Enter:
reg add HKLM\SYSTEM\Setup\LabConfig /v BypassTPMCheck /t REG_DWORD /d 1 /f
reg add HKLM\SYSTEM\Setup\LabConfig /v BypassSecureBootCheck /t REG_DWORD /d 1 /f
reg add HKLM\SYSTEM\Setup\LabConfig /v BypassRAMCheck /t REG_DWORD /d 1 /f
reg add HKLM\SYSTEM\Setup\LabConfig /v BypassCPUCheck /t REG_DWORD /d 1 /f

# 3. Tutup jendela CMD (ketik 'exit') lalu lanjutkan proses instalasi Windows 11.
14

Proxmox LXC: SSH Port Change & Locale Fix

Container LXC minimal Debian sering mengalami dua kendala: (1) socket activation systemd (ssh.socket) yang mengabaikan pengaturan port di sshd_config, dan (2) peringatan perl locale. Terapkan perbaikan & penguatan (hardening) berikut di dalam container (pct enter <CTID>):

PVE 9.1+: selain template pveam, Anda dapat membuat CT dari OCI image (format registry/Docker) melalui UI/API. Pastikan image Linux userspace kompatibel cgroup v2 (wajib di PVE 9).
Post-Create Fix & Hardening LXC Debian 
# 1. Timezone Asia/Jakarta
timedatectl set-timezone Asia/Jakarta

# 2. Nonaktifkan socket activation agar sshd membaca /etc/ssh/sshd_config (termasuk Port)
systemctl mask ssh.socket sshd.socket 2>/dev/null || true
systemctl enable ssh
systemctl restart ssh

# 3. Ganti port SSH (contoh 2222) via drop-in terpisah
echo "Port 2222" > /etc/ssh/sshd_config.d/10-port.conf
# Atau edit langsung: sed -i 's/^#\?Port 22/Port 2222/' /etc/ssh/sshd_config

# 4. Hardening: hanya key-based (ed25519), root hanya dengan key
sed -i 's/^#\?PermitRootLogin.*/PermitRootLogin prohibit-password/' /etc/ssh/sshd_config
sed -i 's/^#\?PasswordAuthentication.*/PasswordAuthentication no/' /etc/ssh/sshd_config
[ -f /root/.ssh/id_ed25519 ] || ssh-keygen -t ed25519 -N "" -f /root/.ssh/id_ed25519

# 5. Terapkan perubahan & verifikasi konfigurasi efektif
systemctl restart ssh
sshd -T 2>/dev/null | grep -Ei 'port|permitrootlogin|passwordauthentication'

# 6. Locale en_US.UTF-8 (atau id_ID.UTF-8 bila diinginkan)
apt update && apt install -y locales
grep -q "^en_US.UTF-8 UTF-8" /etc/locale.gen || echo "en_US.UTF-8 UTF-8" >> /etc/locale.gen
locale-gen
update-locale LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8

# 7. Verifikasi akhir
locale
ss -tlnp | grep -E ':2222|ssh' || ss -tlnp
Catatan Firewall & Koneksi: Bila mengganti port (misal 2222), izinkan port tersebut pada Proxmox Firewall (node → Firewall → Rules) maupun firewall dalam container. Uji koneksi dari luar sebelum menutup akses port 22. Pada Debian 13, sshd_config membaca Include /etc/ssh/sshd_config.d/*.conf sehingga drop-in di atas diprioritaskan.
15

Migrasi Virtual Machine dari VMware (ESXi / vCenter) ke Proxmox VE

Proxmox VE menyediakan Official VMware ESXi Import Wizard bawaan (paket pve-esxi-import-tools, ditulis dalam Rust) yang terhubung langsung ke API host ESXi untuk membaca konfigurasi VMX dan menyalin disk VMDK ke storage Proxmox - memetakan CPU, memori, layout disk, NIC, hingga firmware (BIOS/UEFI) secara otomatis tanpa ekspor OVA manual. Fitur ini hadir sejak PVE 8.1/8.2 dan terus disempurnakan di PVE 9. Seiring berakhirnya lisensi free ESXi serta perubahan harga pasca-akuisisi Broadcom, migrasi VMware → Proxmox VE menjadi arus utama pada 2025-2026.

15.1 Metode 1: Native ESXi Import Wizard (GUI & API)
Prasyarat & Batasan Wizard:
  • Aktifkan layanan SSH (TSM-SSH) pada host ESXi (Host → Actions → Services → Enable Secure Shell). Wizard membaca datastore lewat API/SSH host.
  • Versi ESXi yang diuji resmi: 6.5 hingga 8.0. Versi di luar rentang bersifat best-effort.
  • Hubungkan langsung ke host ESXi (bukan vCenter) untuk kecepatan maksimal; kredensial root ESXi.
  • Tidak didukung: disk di vSAN, disk terenkripsi VMware Storage Policy, dan datastore bernama dengan karakter +.
  • Konsolidasikan & hapus semua snapshot di vSphere/ESXi terlebih dahulu - snapshot yang belum digabung adalah penyebab #1 kegagalan/lambatnya impor.
  1. Buka Proxmox Web GUI → Datacenter → Storage → Add → ESXi.
  2. Isi parameter koneksi:
    • ID: esxi-cluster-01 (huruf, bukan hanya angka).
    • Server: IP/FQDN host ESXi (contoh: 192.168.10.50).
    • Username & Password: akun root pada host ESXi.
    • Skip Certificate Verification: centang bila ESXi memakai sertifikat self-signed.
  3. Klik Add → pilih storage esxi-cluster-01 di panel kiri → buka tab Import.
  4. Pilih VM → klik Import → tentukan target storage (local-lvm / ZFS / Ceph), bridge jaringan (vmbr0), dan opsi Prepare for VirtIO bila tersedia → jalankan.
  5. Live Import (opsional): VM dapat langsung dinyalakan sambil block disk diambil di latar belakang untuk memangkas downtime. Uji pada VM coba-coba dulu, karena bila koneksi terputus di tengah jalan, perubahan sejak impor dimulai akan hilang.
15.2 Metode 2: Impor Manual OVA/OVF & VMDK via CLI

Gunakan saat wizard GUI tidak dapat digunakan (versi ESXi terlalu lama, batasan jaringan, atau butuh kendali penuh atas konversi disk).

qm importovf & qm importdisk 
# 1. Ekstrak arsip OVA ke direktori dump
tar -xvf ubuntu-server.ova -C /var/lib/vz/dump/

# 2. Impor VM utuh dari file OVF (membuat VMID 201)
qm importovf 201 /var/lib/vz/dump/ubuntu-server.ovf local-lvm --format qcow2

# 3. Atau konversi VMDK dulu lalu impor ke VMID yang sudah ada:
# qemu-img convert -f vmdk -O qcow2 ubuntu-server-disk1.vmdk ubuntu-server-disk1.qcow2
# qm importdisk 201 ubuntu-server-disk1.qcow2 local-lvm --format qcow2

# 4. Hubungkan disk sebagai VirtIO SCSI + SSD + Discard:
qm set 201 --scsihw virtio-scsi-single --scsi0 local-lvm:vm-201-disk-0,discard=on,ssd=1
qm set 201 --boot order=scsi0
Catatan Format Disk: Storage local-lvm (LVM-thin) selalu menyimpan disk sebagai raw - opsi --format qcow2 akan diabaikan. Gunakan format qcow2 hanya pada storage bertipe Directory (ext4/NFS) atau ZFS bila benar-benar dibutuhkan.
15.3 Persiapan & Penyesuaian Guest OS Pasca Migrasi
Guest OS Windows
  1. Pasang driver VirtIO SCSI & NetKVM dari ISO virtio-win sebelum mematikan VM di ESXi (cara paling aman agar langsung boot di VirtIO).
  2. Uninstall VMware Tools via Control Panel / vmware-uninstall-tools.pl.
  3. Pasang QEMU Guest Agent dari ISO virtio-win (file virtio-win-gt-x64.msi).
  4. Bila BSOD INACCESSIBLE_BOOT_DEVICE (0x7B) saat pindah ke VirtIO SCSI: boot lewat SATA/IDE, jalankan bcdedit /set "{current}" safeboot minimal, ganti controller ke VirtIO SCSI, boot (Safe Mode memuat driver), lalu bcdedit /deletevalue "{current}" safeboot.
  5. Aktivasi Windows mungkin meminta reactivation (perubahan virtual hardware) - volume/KMS biasanya otomatis.
Guest OS Linux
  1. Kernel Linux sudah membawa driver VirtIO → umumnya langsung boot.
  2. Perbarui initramfs: update-initramfs -u -k all.
  3. Hapus paket VMware: apt purge -y open-vm-tools.
  4. Perbaiki nama interface (VMware ens192 → Proxmox ens18/ens19) & hapus rule udev MAC lama di /etc/udev/rules.d/.
  5. Instal QEMU Agent: apt install -y qemu-guest-agent.
15.4 Metode 3: Konversi V2V (virt-v2v & StarWind) - Alternatif Lanjutan

Selain wizard bawaan, gunakan tools konversi pihak ketiga yang menyuntikkan driver VirtIO secara otomatis:

virt-v2v - Konversi + Injeksi Driver Otomatis 
# Pasang libguestfs / virt-v2v pada host Proxmox VE (Debian)
apt update && apt install -y virt-v2v

# Konversi OVA VMware -> format KVM Proxmox (driver VirtIO disuntikkan otomatis)
virt-v2v -i ova /path/to/ubuntu-server.ova -o local -of qcow2 -os /var/lib/vz/images/201/
StarWind V2V Converter: Tool GUI gratis (Windows) yang mengonversi VMDK → qcow2 atau menyalin langsung ke Proxmox. Cocok bila lebih suka antarmuka grafis. Veeam Backup & Replication 12+ juga dapat merestorasi backup VMware langsung ke Proxmox VE.
15.5 Penyesuaian Konfigurasi VM (Mapping VMware → Proxmox)

Setelah disk diimpor, sesuaikan hardware VM agar cocok dengan KVM. Perubahan paling kritis: controller disk, NIC, firmware, dan vTPM.

Komponen VMware Padanan Proxmox VE (KVM) Catatan
PVSCSI / LSI Logic SAS VirtIO SCSI single Performa tertinggi; butuh driver VirtIO di guest.
VMXNET3 / E1000 VirtIO Net MAC address baru → perbarui IP statis/DHCP & lisensi.
BIOS (SeaBIOS) SeaBIOS Wizard mempertahankan mode boot otomatis.
EFI / UEFI OVMF (--bios ovmf) Wajib pasang efidisk bila VM source EFI.
vTPM 2.0 --tpmstate0 (q35 + OVMF) Buat ulang vTPM di Proxmox bila source memakainya.
qm set - Sesuaikan Controller, NIC & vTPM 
# Ganti controller disk ke VirtIO SCSI single & pasang NIC VirtIO (pertahankan MAC lama agar IP tetap):
qm set 201 --scsihw virtio-scsi-single --scsi0 local-lvm:vm-201-disk-0,discard=on,ssd=1
qm set 201 --net0 virtio=AA:BB:CC:DD:EE:FF,bridge=vmbr0

# Bila VM source berbasis UEFI + vTPM (Windows 11 / Server 2022+):
qm set 201 --machine q35 --bios ovmf
qm set 201 --efidisk0 local-lvm:1,efitype=4m,pre-enrolled-keys=1
qm set 201 --tpmstate0 local-lvm:4,version=v2.0
JANGAN ganti machine type ke Q35 untuk VM Windows yang sudah ada bila EFI NVRAM masih menyimpan path PCI lama dari hardware VMware - hal ini memicu gagal boot. Pertahankan pc-i440fx kecuali VM dibuat ulang bersih dengan OVMF.
15.6 Matriks Dukungan & Troubleshooting Umum
Gejala / Skenario Penyebab Umum Solusi
Impor gagal / sangat lambat Snapshot belum digabung; vSAN / disk terenkripsi Hapus semua snapshot; pindahkan disk ke VMFS biasa; lepas encryption policy.
503 Service Unavailable (API ESXi) Batas sesi ESXi terlampaui (terlalu banyak impor paralel) Kurangi impor bersamaan (1-2); tunggu sesi timeout lalu ulangi.
Windows BSOD 0x7B setelah pindah VirtIO Driver VirtIO belum "boot-critical" Boot lewat SATA/IDE → install driver → bcdedit safeboot → ganti VirtIO → hapus safeboot.
Linux tidak mendapat IP / NIC hilang Ubah nama interface & MAC baru Perbaiki /etc/network/interfaces / NetworkManager & hapus rule udev lama.
15.7 Rencana Cutover & Rollback
Best Practice Cutover:
  • Migrasikan VM kecil/non-kritikal lebih dulu untuk memvalidasi proses VirtIO & jaringan.
  • Jangan decommission host ESXi & biarkan VM sumber powered off namun utuh minimal beberapa hari hingga VM migrasi terbukti stabil di beban nyata.
  • Pastikan ada backup terpisah (PBS / Veeam) sebelum cutover final.
  • Catat IP, MAC, VLAN, dan dependency layanan (monitoring/agent terikat MAC lama) agar tidak ada kejutan hari ke-3.
16

Backup Offsite & Eksternal: rclone, NAS (NFS/CIFS), & Proxmox Backup Server (PBS)

Terapkan kaidah Strategi Cadangan 3-2-1: 3 salinan data, 2 jenis media penyimpanan berbeda, dan 1 salinan tersimpan secara offsite di luar lokasi server fisik.

16.1 Replikasi Cloud Backup ke OneDrive & Google Drive via rclone
Konfigurasi & Sinkronisasi Cloud rclone 
# 1. Pasang rclone pada host Proxmox VE
apt update && apt install -y rclone

# 2. Konfigurasi remote storage (OneDrive / Google Drive)
rclone config

# 3. Sinkronkan folder dump cadangan lokal ke Cloud Drive
rclone sync /var/lib/vz/dump onedrive:PVE-Backup/dump --exclude '*.log' --delete-excluded --progress

# 4. Tambahkan pada Crontab root untuk eksekusi otomatis harian pada pukul 02:30 WIB:
# 30 2 * * * vzdump all --compress zstd --mode snapshot --storage local && rclone sync /var/lib/vz/dump onedrive:PVE-Backup/dump --exclude '*.log' --delete-excluded
16.2 Integrasi Network Attached Storage (NAS NFS / SMB-CIFS)
Mount Storage NAS via CLI 
# 1. Pasang package client NFS
apt install -y nfs-common

# 2. Daftarkan storage NFS ke Proxmox VE via CLI (atau lewat GUI Datacenter -> Storage -> Add -> NFS)
pvesm add nfs nas-backup \
  --server 192.168.10.20 \
  --export /volume1/PVE-Backup \
  --content backup \
  --prune-backups keep-daily=7,keep-weekly=4,keep-monthly=3

# 3. Jalankan job backup langsung ke NAS
vzdump all --compress zstd --mode snapshot --storage nas-backup
16.3 Proxmox Backup Server (PBS) Dedicated Solution
Integrasi Proxmox Backup Server 
# 1. Hubungkan PVE ke server PBS (Dukungan Deduplikasi Blok & Client-Side Encryption)
pvesm add pbs pbs01 \
  --server 192.168.10.30:8007 \
  --datastore pve-datastore \
  --username backup@pbs \
  --password 'YourSecurePassword' \
  --fingerprint SHA256_FINGERPRINT_PBS

# 2. Jalankan snapshot backup terdeduplikasi ke PBS
vzdump 100 101 --storage pbs01 --mode snapshot
16.4 Matriks Perbandingan Metode Backup
Metode Solusi Deduplikasi Data Enkripsi Cadangan Prune / Retensi Otomatis Rekomendasi Implementasi
rclone → Cloud Tidak Ya (rclone crypt) Via Cron Script Disaster Recovery Offsite Cadangan Jarak Jauh
NAS (NFS/CIFS) Tidak Tergantung Share Ya (PVE Storage Prune) Backup Lokal Sekunder Cepat & Murah di LAN
Proxmox Backup Server Ya (Block-level) Ya (AES-GCM-256) Ya (Prune & GC) Standar Utama Enterprise & Produksi
16.5 Strategi Retensi, Prune & Verifikasi (PBS) + Opsi vzdump Modern
Retensi & Prune PBS
  • Keep-* rules: keep-last, keep-daily/weekly/monthly/yearly dievaluasi berurutan.
  • Namespaces: pisahkan retention per tenant/lingkungan (prod vs dev) dalam satu datastore.
  • Prune Simulator di GUI: simulasikan sebelum menerapkan kebijakan.
  • Verifikasi & GC: jadwalkan verify (cek checksum) & garbage collection mingguan.
Opsi vzdump Modern (PVE 9)
  • Fleecing: --fleecing 1 untuk snapshot ber-downtime minimal pada disk sibuk.
  • Incremental bitmap: backup ke-2+ otomatis inkremental via QEMU dirty-bitmap.
  • Notes & Protection: --notes-template & --protected 1 (cegah ter-prune).
  • Mode: --mode snapshot (default) / stop / suspend.
Backup Terjadwal + Retensi PBS 
# Backup VM 100 dengan fleecing (downtime ~0), notes otomatis, lalu proteksi dari prune:
vzdump 100 --storage pbs01 --mode snapshot --fleecing 1 \
  --notes-template '{{guestname}} - {{nodename}} - {{time}}' --protected 1

# Prune job di sisi PBS (CLI) - simpan 14 harian, 8 mingguan, 12 bulanan:
proxmox-backup-manager prune-job create prod-prune \
  --store pve-datastore --schedule "daily 21:30" \
  --keep-last 14 --keep-weekly 8 --keep-monthly 12

# Verifikasi & GC mingguan agar chunk usang ter-reklaim:
proxmox-backup-manager verify-job create prod-verify --store pve-datastore --schedule "sun 02:00"
proxmox-backup-manager gc-job create prod-gc --store pve-datastore --schedule "sun 03:00"
17

Ringkasan & Best Practices Operasional

Dengan menerapkan konfigurasi yang tersusun dalam panduan ini, infrastruktur Proxmox VE 9 Anda telah siap melayani beban kerja produksi dengan stabilitas tinggi, isolasi jaringan yang aman, efisiensi storage LVM-thin, serta proteksi bencana yang teruji. Berikut adalah ringkasan komprehensif dan best practices untuk setiap area yang telah dibahas:

Instalasi & Storage
  • Tetapkan FQDN & IP statis, Timezone Asia/Jakarta.
  • Set maxroot ≥ 175 GB pada saat instalasi awal.
  • Manfaatkan lvresize -r untuk ekspansi partisi root secara online tanpa downtime.
  • Pilih storage sesuai workload: ZFS Striped Mirrors untuk VM I/O berat, RAIDZ2 untuk 8-disk file pool, LVM-Thin untuk simplicity.
  • Batas ARC ZFS: zfs_arc_max=8G agar RAM tersisa untuk VM.
  • Scrub ZFS setiap 2–4 minggu, monitor dengan zpool iostat dan arcstat.
Jaringan & VLAN
  • Pisahkan traffic management host pada dedicated VLAN terisolasi.
  • Gunakan arsitektur VLAN-Aware Bridge (bridge-vlan-aware yes).
  • Verifikasi status interface dengan ip -br a & bridge vlan show.
  • Konfigurasi 2-NIC: Management (access) + Guest Data (trunk multi-VLAN).
  • Jangan pernah ubah VLAN ID di tengah koneksi aktif — siapkan konsol fisik/IPMI.
Virtualisasi VM & CT
  • VM: Gunakan VirtIO SCSI Single + discard=on,ssd=1.
  • Windows: Pasang driver VirtIO saat instalasi & aktifkan QEMU Guest Agent.
  • CT: Gunakan mode unprivileged dengan masking pada socket SSH.
  • VM Windows 11/Server 2022+: UEFI OVMF + vTPM 2.0 + q35 machine type.
  • Hindari BSOD Windows pasca migrasi: bcdedit safeboot trick saat ganti controller ke VirtIO.
  • Hapus VMware Tools sebelum install QEMU Agent pada VM yang dimigrasi.
Proteksi & Backup 3-2-1
  • Simpan cadangan rutin ke Proxmox Backup Server (deduplikasi & snapshot cepat).
  • Replikasi arsip cadangan ke Cloud Storage (OneDrive/GDrive) via rclone.
  • Uji pemulihan (restore drill) secara berkala untuk memvalidasi integritas data.
  • Gunakan --fleecing 1 pada vzdump untuk near-zero downtime.
  • Jadwalkan verify & GC mingguan pada PBS untuk menjaga kesehatan datastore.
Storage Modern (ZFS & Ceph)
  • ZFS: ashift=12, compression=zstd, scrub berkala, batasi ARC.
  • Manfaatkan RAIDZ Expansion (PVE 9) untuk besarkan vdev tanpa rebuild.
  • Ceph: pisahkan public & cluster network 10/25 GbE, noout saat maintenance.
  • Gunakan disk Enterprise NVMe/SAS SSD dengan PLP untuk OSD Ceph — jangan gunakan QLC/TLC consumer.
  • SLOG (ZIL) untuk write-intensive workload, L2ARC untuk read cache jika diperlukan.
HA & Recovery Modern
  • HA Group + Location Rule untuk penempatan & failover terkendali.
  • PBS: deduplikasi, namespaces, sync offsite, & prune/verify berkala.
  • Gunakan --fleecing pada vzdump untuk near-zero downtime.
  • Cluster 2-node: gunakan QDevice untuk quorum tie-breaker.
  • Dual-link Corosync untuk redundansi komunikasi cluster.
  • Pemulihan darurat: pvecm expected hanya saat node lain benar-benar mati.
Repository & Sistem
  • Gunakan script setup-pve9-repos.sh untuk konfigurasi otomatis repo no-subscription.
  • Format deb822 (.sources) menggantikan .list — lebih aman dan modern.
  • Debian 13 Trixie: pastikan komponen main contrib non-free non-free-firmware aktif.
  • Pasang microcode CPU (intel-microcode / amd64-microcode).
  • Jangan pernah lakukan dist-upgrade tanpa backup 3-2-1 yang teruji.
Migrasi & VM Tamu
  • Konsolidasikan semua snapshot VMware sebelum migrasi — penyebab #1 kegagalan import.
  • Gunakan ESXi Import Wizard untuk ESXi 6.5–8.0; konsolidasikan snapshot terlebih dahulu.
  • Pasang VirtIO driver pada Windows sebelum migrasi untuk menghindari BSOD.
  • Hapus VMware Tools, install QEMU Guest Agent pada semua tamu.
  • Perbarui nama interface & MAC address pada Linux guest pasca migrasi.
  • Uji VM migrasi selama beberapa hari sebelum decommission host ESXi asal.
Pre-Flight Checklist Pasca Instalasi
Checklist Operasional Harian 
# 1. BIOS Server: Aktifkan Hardware Virtualization (VT-x/AMD-V) & IOMMU
# 2. Buat script /root/setup-pve9-repos.sh & eksekusi untuk setup repo No-Subscription
# 3. Konfigurasi /etc/network/interfaces dengan VLAN-Aware Bridge
# 4. Verifikasi status paket: pveversion -v
# 5. Pasang QEMU Guest Agent pada seluruh Virtual Machine
# 6. Daftarkan target backup eksternal (PBS / NAS / Cloud rclone)
# 6b. Atur PBS namespaces + sync offsite & jadwalkan prune/verify
# 6c. Konfigurasi HA Group + Location Rule untuk VM kritikal
# 7. Jalankan uji backup (--fleecing) & restore pertama
# 8. Cek cluster quorum: pvecm status (jika multi-node)
# 9. Monitor ZFS: zpool scrub, zpool iostat, arcstat
# 10. Dokumentasi: catat IP, VLAN, MAC, dan dependency layanan
Kesimpulan: Server Proxmox VE 9 Anda kini telah terkonfigurasi dengan standar enterprise: rapi, aman, performa maksimal, dan memiliki proteksi data yang handal. Panduan ini mencakup seluruh aspek — dari konsep dasar hypervisor, instalasi bare metal, konfigurasi jaringan VLAN, manajemen storage LVM/ZFS/Ceph, cluster HA, upgrade path bertahap, migrasi VMware, hingga strategi backup 3-2-1. Terapkan best practices di atas untuk memastikan ketersediaan layanan (uptime) dan integritas data yang handal.
Dokumentasi teknis mutakhir Proxmox VE 9 (Debian 13 Trixie) — Riset & Pengujian oleh ALSYUNDAWY IT SOLUTION