SanzSkuy: Created page with "'''Proxmox Hello World''' adalah panduan bertahap untuk memahami Proxmox VE dari dasar — bukan sekadar menghafal tombol, melainkan mengerti cara kerja mesinnya. Panduan disusun ''CLI-first'': setiap kali sebuah tugas bisa dilakukan lewat antarmuka web, sebaiknya dicoba juga lewat command line, karena pada lingkungan cluster/HPC nyata antarmuka grafis biasanya tidak tersedia. Target versi: '''Proxmox VE 9.x''' (basis Debian 13 "Trixie"). {| class="wikitable" |- !..."

2026-06-26T03:28:45Z

Created page with "'''Proxmox Hello World''' adalah panduan bertahap untuk memahami Proxmox VE dari dasar — bukan sekadar menghafal tombol, melainkan mengerti cara kerja mesinnya. Panduan disusun ''CLI-first'': setiap kali sebuah tugas bisa dilakukan lewat antarmuka web, sebaiknya dicoba juga lewat command line, karena pada lingkungan cluster/HPC nyata antarmuka grafis biasanya tidak tersedia. Target versi: '''Proxmox VE 9.x''' (basis Debian 13 "Trixie"). {| class="wikitable" |- !..."

New page

'''Proxmox Hello World''' adalah panduan bertahap untuk memahami [[Proxmox VE]] dari dasar — bukan sekadar menghafal tombol, melainkan mengerti cara kerja mesinnya. Panduan disusun ''CLI-first'': setiap kali sebuah tugas bisa dilakukan lewat antarmuka web, sebaiknya dicoba juga lewat command line, karena pada lingkungan cluster/HPC nyata antarmuka grafis biasanya tidak tersedia.

Target versi: '''Proxmox VE 9.x''' (basis Debian 13 "Trixie").

{| class="wikitable"
|-
! Prinsip !! Keterangan
|-
| CLI-first || Biasakan tangan mengetik, bukan mengklik
|-
| Pahami ''kenapa'' || Tiap langkah disertai alasan, bukan instruksi buta
|-
| Snapshot dulu || Selalu amankan sebelum bereksperimen
|}

== Fase 0 — Pondasi: sistem yang sehat ==

Wajib dilakukan sekali di awal. Instalasi baru Proxmox mengarah ke ''enterprise repository'' yang memerlukan ''subscription'', sehingga <code>apt update</code> akan menghasilkan error '''401 Unauthorized'''. Ini harus diperbaiki lebih dahulu.

=== 0.1 Membuka shell ===

Pada web UI: klik '''node''' (panel kiri) → tombol '''<code>>_ Shell</code>''' (pojok kanan atas). Sebuah shell <code>root</code> terbuka langsung di browser, tanpa perlu SSH terpisah.

=== 0.2 Menonaktifkan repo enterprise ===

Proxmox VE 9 memakai format repositori baru (''deb822'', file <code>.sources</code>), berbeda dari versi 8 yang berformat baris tunggal. Cara menonaktifkan sebuah repo deb822 adalah menambahkan baris <code>Enabled: false</code>.

<syntaxhighlight lang="bash">
echo 'Enabled: false' >> /etc/apt/sources.list.d/pve-enterprise.sources
echo 'Enabled: false' >> /etc/apt/sources.list.d/ceph.sources
</syntaxhighlight>

{{Catatan|Repo Ceph ikut dimatikan karena Ceph adalah ''distributed storage'' untuk cluster produksi. Pada lab single-node tidak diperlukan, dan repo enterprise-nya hanya menambah error 401.}}

=== 0.3 Menambahkan repo no-subscription ===

<syntaxhighlight lang="text">
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
</syntaxhighlight>

Buat file tersebut dengan perintah:

<syntaxhighlight lang="bash">
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
</syntaxhighlight>

Anatomi file deb822:

{| class="wikitable"
|-
! Kunci !! Arti
|-
| <code>Types: deb</code> || Repo paket binary (bukan source code)
|-
| <code>URIs:</code> || Server tempat mengambil paket
|-
| <code>Suites: trixie</code> || Codename Debian basis. Proxmox 9 = Debian 13 = <code>trixie</code>. Salah isi → "Release not found"
|-
| <code>Components:</code> || Channel; <code>pve-no-subscription</code> tidak butuh lisensi
|-
| <code>Signed-By:</code> || Keyring untuk verifikasi tanda tangan paket (anti-tampering)
|}

=== 0.4 Update dan upgrade ===

<syntaxhighlight lang="bash">
apt update && apt full-upgrade -y
</syntaxhighlight>

{{Catatan|Gunakan <code>full-upgrade</code>, bukan <code>upgrade</code> biasa. <code>full-upgrade</code> boleh menambah/menghapus paket bila dependency berubah — penting untuk update kernel Proxmox. <code>upgrade</code> saja kadang menahan paket dan macet.}}

=== 0.5 (Opsional) Menghilangkan popup "No valid subscription" ===

Murni kosmetik dan tidak memengaruhi fungsi apa pun. Bila ingin dihilangkan:

<syntaxhighlight lang="bash">
sed -i "s/data.status.toLowerCase() !== 'active'/false/g" \
/usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js
systemctl restart pveproxy
</syntaxhighlight>

{{Catatan|Modifikasi ini akan tertimpa setiap kali paket <code>proxmox-widget-toolkit</code> diperbarui. Jalankan ulang bila perlu.}}

=== 0.6 Reboot dan verifikasi ===

<syntaxhighlight lang="bash">
reboot
# setelah menyala kembali:
pveversion # ringkas
pveversion -v # detail semua komponen
</syntaxhighlight>

== Fase 1 — Peta mental: anatomi Proxmox ==

=== Hierarki ===

<pre>
Datacenter ← level paling atas (semua node + setting global)
└── Node (pve) ← satu mesin fisik/host
├── VM (KVM) ← virtual machine penuh, punya kernel sendiri
└── CT (LXC) ← container, berbagi kernel host
</pre>

=== VM (KVM) vs Container (LXC) ===

{| class="wikitable"
|-
! Aspek !! VM / KVM !! Container / LXC
|-
| Isolasi || Penuh (hardware virtual) || Proses (berbagi kernel host)
|-
| Kernel || Sendiri || Ikut host
|-
| Overhead || Lebih berat || Sangat ringan
|-
| Boot || Hitungan detik || Instan
|-
| OS || Apa saja (Windows, BSD, dll) || Linux saja
|-
| Use case || Butuh isolasi / OS berbeda || Banyak service Linux ringan
|}

{{Catatan|Relevansi HPC: container padat dan murah sehingga bisa ditumpuk banyak di satu host. Namun workload yang butuh kontrol kernel/driver (mis. GPU passthrough, kernel module khusus) lebih cocok di VM.}}

=== Lokasi file penting ===

{| class="wikitable"
|-
! Path !! Isi
|-
| <code>/etc/pve/</code> || Config cluster — filesystem khusus (lihat di bawah)
|-
| <code>/etc/pve/qemu-server/<VMID>.conf</code> || Config tiap VM
|-
| <code>/etc/pve/lxc/<CTID>.conf</code> || Config tiap container
|-
| <code>/etc/network/interfaces</code> || Config jaringan host
|-
| <code>/var/lib/vz/</code> || Storage <code>local</code> (ISO, template, backup)
|}

{{Catatan|<code>/etc/pve</code> bukan folder biasa, melainkan '''pmxcfs''' (Proxmox Cluster File System) — sebuah FUSE filesystem yang di-backing database SQLite dan otomatis ter-sinkronisasi ke seluruh node cluster. Inilah alasan config VM yang diubah di satu node langsung terlihat di node lain, dan alasan <code>/etc/pve</code> menjadi read-only saat cluster kehilangan quorum.}}

== Fase 2 — Storage ==

<syntaxhighlight lang="bash">
pvesm status # lihat semua storage + kapasitas
</syntaxhighlight>

Instalasi baru umumnya memiliki dua storage:

{| class="wikitable"
|-
! Storage !! Tipe !! Fungsi
|-
| <code>local</code> || Directory || ISO, template container, backup
|-
| <code>local-lvm</code> || LVM-thin || Disk virtual VM & container
|}

{{Catatan|'''LVM-thin''' memakai ''thin provisioning'': sebuah VM bisa "dijanjikan" 32 GB walau fisik baru terpakai 2 GB — alokasi tumbuh sesuai pemakaian. Hemat ruang, tetapi waspadai over-provisioning.}}

Mengunggah ISO lewat CLI:

<syntaxhighlight lang="bash">
cd /var/lib/vz/template/iso/
wget https://...../debian-13-netinst.iso
</syntaxhighlight>

== Fase 3 — VM pertama (KVM) ==

Cara antarmuka: tombol '''Create VM''' lalu ikuti wizard. Cara command line:

<syntaxhighlight lang="bash">
# 1. Buat shell VM (ID 100)
qm create 100 --name testvm --memory 2048 --cores 2 \
--net0 virtio,bridge=vmbr0

# 2. Tambah disk 32GB di local-lvm dengan controller virtio-scsi (tercepat)
qm set 100 --scsihw virtio-scsi-pci --scsi0 local-lvm:32

# 3. Pasang ISO sebagai CD-ROM
qm set 100 --ide2 local:iso/debian-13-netinst.iso,media=cdrom

# 4. Atur urutan boot: CD dulu, lalu disk
qm set 100 --boot order=ide2;scsi0

# 5. Nyalakan
qm start 100
</syntaxhighlight>

=== Lifecycle command ===

<syntaxhighlight lang="bash">
qm list # semua VM
qm start 100
qm shutdown 100 # shutdown sopan (ACPI)
qm stop 100 # paksa mati
qm reboot 100
qm clone 100 101 --name clone-test # gandakan VM
qm config 100 # lihat semua setting
qm destroy 100 # hapus permanen
</syntaxhighlight>

== Fase 4 — Container (LXC) ==

<syntaxhighlight lang="bash">
# 1. Update daftar template
pveam update

# 2. Lihat template tersedia
pveam available --section system

# 3. Download (nama persis dari output di atas)
pveam download local debian-13-standard_13.x_amd64.tar.zst

# 4. Buat container ID 200
pct create 200 local:vztmpl/debian-13-standard_13.x_amd64.tar.zst \
--hostname ct1 \
--memory 1024 \
--cores 2 \
--net0 name=eth0,bridge=vmbr0,ip=dhcp \
--storage local-lvm \
--password

# 5. Nyalakan & masuk
pct start 200
pct enter 200
</syntaxhighlight>

{{Catatan|Container menyala instan dan ringan karena tidak mem-boot kernel sendiri. Perintahnya mirip <code>qm</code> tetapi berawalan <code>pct</code>.}}

== Fase 5 — Networking ==

<syntaxhighlight lang="bash">
cat /etc/network/interfaces
</syntaxhighlight>

Di sana terdapat <code>vmbr0</code>, sebuah '''Linux bridge''' yang berfungsi sebagai ''virtual switch''. Semua VM/container "dicolokkan" ke bridge ini, lalu bridge tersambung ke NIC fisik host, sehingga guest memperoleh IP pada jaringan yang sama dengan host (mode bridged).

* <code>vmbr0</code> — switch virtual default, ter-bridge ke NIC fisik
* Untuk jaringan terisolasi, buat <code>vmbr1</code> tanpa <code>bridge-ports</code> fisik
* Terapkan perubahan tanpa reboot: <code>ifreload -a</code>

{{Catatan|Untuk simulasi cluster HPC, sering dibuat bridge internal terpisah untuk traffic antar-node (mis. MPI) agar tidak bercampur dengan jaringan management.}}

== Fase 6 — Snapshot & Backup ==

'''Snapshot''' adalah potret kondisi VM pada satu waktu; cepat, tetapi menempel di disk yang sama dan bukan pengganti backup.

<syntaxhighlight lang="bash">
qm snapshot 100 sebelum-eksperimen
qm rollback 100 sebelum-eksperimen
qm delsnapshot 100 sebelum-eksperimen
</syntaxhighlight>

'''Backup''' adalah salinan utuh ke storage lain untuk ''disaster recovery''.

<syntaxhighlight lang="bash">
vzdump 100 --storage local --mode snapshot --compress zstd
</syntaxhighlight>

Backup terjadwal diatur lewat '''Datacenter → Backup → Add'''.

{{Catatan|Kebiasaan penting: lakukan snapshot SEBELUM tiap eksperimen berisiko. Ini jaring pengaman yang membuat berani mengulik.}}

== Fase 7 — Cheat sheet command ==

{| class="wikitable"
|-
! Tool !! Fungsi !! Contoh
|-
| <code>qm</code> || Manage VM (KVM) || <code>qm list</code>
|-
| <code>pct</code> || Manage container (LXC) || <code>pct enter 200</code>
|-
| <code>pvesm</code> || Manage storage || <code>pvesm status</code>
|-
| <code>pveam</code> || Manage template LXC || <code>pveam available</code>
|-
| <code>pvecm</code> || Manage cluster || <code>pvecm status</code>
|-
| <code>pvesh</code> || Akses REST API via CLI || <code>pvesh get /nodes</code>
|-
| <code>pveversion</code> || Cek versi || <code>pveversion -v</code>
|-
| <code>journalctl</code> || Baca log (troubleshooting) || <code>journalctl -xe</code>
|}

{{Catatan|<code>pvesh</code> adalah "senjata rahasia": semua aksi UI sebenarnya memanggil REST API yang sama. Menguasai <code>pvesh</code> berarti mampu mengotomasi apa pun.}}

== Fase 8 — Cluster ==

Cluster adalah beberapa node Proxmox yang config-nya ter-sinkron via pmxcfs. Manfaatnya: satu UI untuk semua node, ''live migration'' VM antar-node, serta High Availability.

<syntaxhighlight lang="bash">
# Di node pertama: buat cluster
pvecm create lab-cluster

# Di node lain: gabung (jalankan dari node yang akan bergabung)
pvecm add <IP-node-pertama>

# Cek status
pvecm status
pvecm nodes
</syntaxhighlight>

{{Catatan|Untuk uji coba di VirtualBox, kloning VM Proxmox menjadi 2–3 node (tiap node WAJIB beda hostname dan IP). Idealnya '''3 node''' agar ada ''quorum'': cluster butuh mayoritas node hidup untuk mengambil keputusan. Bila hanya 2 node dan satu mati, sisanya kehilangan quorum dan <code>/etc/pve</code> menjadi read-only.}}

== Mindset penutup ==

# '''Snapshot sebelum mengulik.''' Selalu.
# '''Pahami <code>/etc/pve</code>''' — kunci sinkronisasi cluster dan alasan quorum penting.
# '''Semua adalah API.''' UI hanya pembungkus REST API; kuasai <code>pvesh</code>.
# '''Paksa CLI walau ada tombol''' — siapkan tangan untuk lingkungan tanpa GUI.
# '''Baca log saat error''', jangan menebak: <code>journalctl -xe</code>, <code>qm help <command></code>.

== Lihat pula ==

* [[Hostname, Domain, dan FQDN]]
* [[Proxmox VE]]
* [[DNS]]
* [[Konfigurasi jaringan Linux]]

[[Category:Virtualisasi]]
[[Category:Administrasi Sistem]]
[[Category:Dokumentasi Internal]]

Proxmox Hello World - Revision history