Category: Proxmox

  • Penggunaan Proxmox dan Ceph untuk Production

    Penggunaan Proxmox dan Ceph untuk Production

    Hari ini saya melanjutkan membaca artikel dari Mr.PlanB tentang penggunaan Proxmox di lingkungan production. Artikel ini membahas pengalaman beberapa system admin yang menggunakan Proxmox untuk menjalankan ratusan hingga lebih dari 10.000 VM.

    Dari beberapa pembahasan tersebut, ada pembahasan yang menarik pada bagian penggunaan Ceph sebagai storage Proxmox, terutama mengenai risiko penggunaan Ceph dengan jumlah node yang sedikit.

    Dalam artikel tersebut, seorang system admin yang menggunakan Ceph pada cluster dengan jumlah node cukup banyak. Namun, ada juga yang merasa bahwa penggunaan Ceph dengan tiga node masih berisiko ketika salah satu node mengalami kegagalan. Untuk kebutuhan production yang kritis, salah satu administrator lebih memilih minimal lima node. Tentunya, ini berdasarkan pengalaman dan pertimbangannya, bukan ketentuan wajib dari Ceph.

    Pembahasan tersebut mengingatkan saya pada pengujian yang pernah saya lakukan menggunakan dua node Proxmox VE dengan Ceph Squid 19.2. Saat itu, saya menggunakan enam OSD dengan konfigurasi pool size 2 dan min_size 1.

    Saya juga sempat melakukan pengujian dengan mematikan salah satu node untuk melihat dampaknya terhadap cluster. Hasilnya, VM yang sudah berjalan masih dapat beroperasi, tetapi pembuatan VM baru mengalami kendala karena cluster Proxmox kehilangan quorum.

    Perlu dibedakan bahwa kendala tersebut berasal dari quorum Proxmox (Corosync), bukan langsung dari Ceph. Keduanya memiliki mekanisme quorum yang berbeda. Saya kemudian mencoba menambahkan Ceph MON eksternal dan mempelajari penggunaan QDevice untuk membantu quorum Proxmox.

    Dari pengujian tersebut dan artikel yang saya baca, saya memahami bahwa penggunaan cluster dengan jumlah node sedikit memang perlu diperhatikan, terutama ketika salah satu node down dan mengalami kegagalan.

    Pengujian saya sebelumnya masih sebatas lab untuk memahami mekanisme Proxmox dan Ceph. Namun, pengalaman tersebut cukup membantu saya memahami pembahasan dalam artikel bahwa cluster yang berhasil berjalan belum tentu langsung siap digunakan untuk production, terutama jika belum diuji bagaimana kondisinya ketika terjadi kegagalan node atau storage.

    Bacaan:

    https://www.mrplanb.com/blog/proxmox-production-workloads-real-world-scale

  • Mengintegrasikan Proxmox VE dengan Apache CloudStack 4.22.1.1

    Mengintegrasikan Proxmox VE dengan Apache CloudStack 4.22.1.1

    Apache CloudStack dapat mengelola VM di Proxmox VE melalui Proxmox Orchestrator Extension. Setelah terintegrasi, proses deploy, start, stop, reboot, delete, snapshot, konfigurasi VLAN, dan akses console dapat dilakukan dari CloudStack.

    Panduan ini menggunakan konfigurasi lab yang sudah berhasil menjalankan Ubuntu 24.04 dari template Proxmox.

    Topologi dan kondisi awal

    KomponenKonfigurasi
    CloudStack Management Servercsmgmt-kvm.lab.local — 192.168.14.135
    Versi CloudStack4.22.1.1
    Proxmox nodepvecs1.lab.local — 192.168.14.136
    Proxmox APIhttps://192.168.14.136:8006
    Proxmox node namepvecs1
    Storage Proxmoxlocal-lvm
    Guest bridgevmbr1
    Template ProxmoxUbuntu Server 24.04, VMID 9000
    Disk template20 GiB
    Guest networkguest-isolated-01
    Guest CIDR10.1.1.0/24
    Guest gateway10.1.1.1
    Guest VLAN319

    Sebelum integrasi dilakukan, kondisi berikut sudah tersedia:

    • CloudStack Management Server dan zone sudah aktif.
    • Proxmox VE dapat diakses dari Management Server melalui TCP 8006.
    • Proxmox dan host tempat CloudStack Virtual Router berjalan terhubung ke jaringan VLAN trunk yang sama.
    • Bridge vmbr1 sudah VLAN-aware dan terhubung ke uplink guest network.
    • Template Ubuntu 24.04 VMID 9000 sudah dibuat di Proxmox.
    • API token khusus CloudStack sudah tersedia.

    Dokumentasi resmi menjelaskan bahwa extension Proxmox berkomunikasi dengan Proxmox VE API melalui HTTPS. CloudStack kemudian meneruskan MAC address dan VLAN ID VM ke Proxmox saat deployment. Lihat Proxmox Orchestrator Extension.

    1. Menyiapkan template Proxmox

    Template pada lab menggunakan Ubuntu 24.04 cloud image dengan VMID 9000. Seluruh pengaturan pada bagian ini dilakukan melalui Proxmox GUI.

    Buka:

    pvecs1 > VM 9000 > Hardware

    Atur hardware template sebagai berikut:

    HardwareNilai
    Processors2 cores
    Memory2048 MiB
    SCSI ControllerVirtIO SCSI single
    Hard Diskscsi0, storage local-lvm, size 20 GiB
    CloudInit DriveStorage local-lvm
    Network DeviceModel VirtIO, Bridge vmbr1
    DisplayStandard VGA
    Serial Portsocket — opsional

    Pastikan VirtIO SCSI single dipilih pada bagian SCSI Controller, bukan Display. Display menggunakan Standard VGA agar console VM dapat ditampilkan melalui CloudStack.

    Jika disk masih mengikuti ukuran awal Ubuntu cloud image, pilih:

    VM 9000 > Hardware > Hard Disk (scsi0) > Disk Action > Resize

    Tambahkan kapasitas sampai total disk menjadi 20 GiB. Proxmox menggunakan nilai penambahan saat melakukan resize, sehingga periksa ukuran saat ini sebelum mengisi kolom Size Increment.

    Selanjutnya buka:

    VM 9000 > Options

    Atur:

    OptionNilai
    Boot OrderAktifkan scsi0 sebagai urutan pertama
    QEMU Guest AgentEnabled

    Kemudian buka:

    VM 9000 > Cloud-Init

    Isi konfigurasi berikut:

    Cloud-InitNilai
    Userubuntu
    PasswordPassword sementara khusus lab
    SSH Public KeyPublic key administrator
    IP ConfigDHCP

    Gunakan SSH key untuk produksi dan hindari password tetap yang sama pada seluruh hasil clone.

    Setelah konfigurasi selesai, matikan VM kemudian klik kanan VM 9000 dan pilih Convert to template. VMID 9000 selanjutnya digunakan sebagai template_id di CloudStack.

    2. Memastikan jaringan guest siap

    Bridge vmbr1 harus membawa VLAN guest dari Proxmox menuju jaringan CloudStack. Buka:

    pvecs1 > System > Network

    Jika vmbr1 belum tersedia, pilih Create > Linux Bridge, kemudian isi:

    FieldNilai
    Namevmbr1
    IPv4/CIDRKosong
    Gateway (IPv4)Kosong
    Bridge portsInterface atau bond untuk trunk guest
    VLAN awareAktif
    AutostartAktif

    Klik Create, lalu Apply Configuration. Jika vmbr1 sudah tersedia, pilih bridge tersebut dan klik Edit untuk memastikan VLAN aware sudah aktif.

    VLAN 319 harus diizinkan pada switch fisik, uplink Proxmox, dan host CloudStack yang menjalankan Virtual Router. Pastikan perubahan bridge dilakukan melalui interface management yang berbeda agar akses ke Proxmox tidak terputus.

    3. Membuat API token Proxmox

    Buka Proxmox UI, lalu masuk ke:

    Datacenter > Permissions > API Tokens

    Buat token khusus untuk CloudStack. Simpan tiga informasi berikut:

    FieldContoh
    Usercloudstack@pve
    Token IDcloudstack
    Secret<PROXMOX_API_SECRET>

    Untuk lab, Privilege Separation dapat dinonaktifkan. Untuk produksi, aktifkan pemisahan privilege dan berikan role yang diperlukan pada path /vms, /storage, dan /sdn.

    Uji token dari CloudStack Management Server:

    export PVE_TOKEN='cloudstack@pve!cloudstack=<PROXMOX_API_SECRET>'
    
    curl -sk \
      -H "Authorization: PVEAPIToken=$PVE_TOKEN" \
      https://192.168.14.136:8006/api2/json/version | jq
    
    unset PVE_TOKEN

    Respons yang benar berisi informasi versi Proxmox pada objek data.

    4. Menyiapkan Proxmox Extension di Management Server

    Extension bawaan berada pada direktori berikut:

    script=/usr/share/cloudstack-management/extensions/Proxmox/proxmox.sh
    
    test -x "$script"
    bash -n "$script"

    Penyesuaian kompatibilitas pada instalasi lab

    Skrip yang digunakan pada lab dinormalisasi agar dapat membaca detail resource dari payload CloudStack 4.22.1.1 dan menggunakan URL Proxmox dalam format lengkap.

    Backup skrip terlebih dahulu:

    cp -a "$script" "${script}.before-integration"

    Pada fungsi parse_json(), detail host dibuat menerima nilai dari host maupun resourcemap, termasuk variasi nama objek externaldetails dan externalDetails. Pola hasil akhirnya sebagai berikut:

    "host_url": (
      .externaldetails.host.url //
      .externaldetails.resourcemap.url //
      .externalDetails.host.url //
      .externalDetails.resourcemap.url // ""
    ),
    "host_user": (
      .externaldetails.host.user //
      .externaldetails.resourcemap.user //
      .externalDetails.host.user //
      .externalDetails.resourcemap.user // ""
    ),
    "host_token": (
      .externaldetails.host.token //
      .externaldetails.resourcemap.token //
      .externalDetails.host.token //
      .externalDetails.resourcemap.token // ""
    ),
    "host_secret": (
      .externaldetails.host.secret //
      .externaldetails.resourcemap.secret //
      .externalDetails.host.secret //
      .externalDetails.resourcemap.secret // ""
    ),
    "node": (
      .externaldetails.host.node //
      .externaldetails.resourcemap.node //
      .externalDetails.host.node //
      .externalDetails.resourcemap.node // ""
    ),
    "network_bridge": (
      .externaldetails.host.network_bridge //
      .externaldetails.resourcemap.network_bridge //
      .externalDetails.host.network_bridge //
      .externalDetails.resourcemap.network_bridge // ""
    ),
    "verify_tls_certificate": (
      .externaldetails.host.verify_tls_certificate //
      .externaldetails.resourcemap.verify_tls_certificate //
      .externalDetails.host.verify_tls_certificate //
      .externalDetails.resourcemap.verify_tls_certificate // "true"
    ),

    Pada fungsi call_proxmox_api(), URL API menggunakan nilai url secara langsung:

    response=$(curl "${curl_opts[@]}" "${url%/}/api2/json${path}")

    Dengan format tersebut, nilai url yang dimasukkan ke CloudStack harus lengkap:

    https://192.168.14.136:8006

    Validasi skrip setelah disesuaikan:

    chmod 0755 "$script"
    bash -n "$script"

    Jika terdapat beberapa Management Server, gunakan file yang sama pada seluruh node agar status extension tetap Ready. CloudStack memang memeriksa keberadaan dan konsistensi file extension pada Management Server.

    5. Mengaktifkan Proxmox Extension

    Masuk ke CloudStack UI sebagai administrator:

    Extensions > Proxmox > Enable

    Pastikan status extension menjadi:

    Enabled / Ready

    CloudStack 4.22 menyediakan extension Proxmox sebagai orchestrator berbasis shell script. File extension ditempatkan di bawah /usr/share/cloudstack-management/extensions/ dan dipanggil menggunakan payload JSON untuk setiap operasi VM. Lihat mekanisme Extensions CloudStack.

    6. Membuat cluster External untuk Proxmox

    Buka:

    Infrastructure > Zones > <ZONE> > Pods > <POD> > Clusters > Add Cluster

    Isi parameter berikut:

    FieldNilai
    HypervisorExternal
    ExtensionProxmox
    Cluster Nameproxmox-cluster-01

    Simpan cluster, kemudian lanjutkan dengan menambahkan host Proxmox.

    7. Menambahkan Proxmox sebagai host CloudStack

    Tambahkan host pada cluster External yang baru dibuat. Gunakan detail berikut:

    DetailNilai
    Host namepvecs1.lab.local
    urlhttps://192.168.14.136:8006
    usercloudstack@pve
    tokencloudstack
    secret<PROXMOX_API_SECRET>
    nodepvecs1
    network_bridgevmbr1
    verify_tls_certificatefalse untuk sertifikat self-signed pada lab

    node harus sama dengan nama node yang digunakan oleh Proxmox API, bukan sekadar nama tampilan di CloudStack. Nama tersebut dapat dilihat pada panel kiri Proxmox GUI, tepat di bawah Datacenter. Pada lab ini nilainya adalah pvecs1.

    Setelah host ditambahkan, pastikan statusnya:

    State: Up
    Resource State: Enabled

    Untuk produksi, gunakan sertifikat TLS yang dipercaya dan set verify_tls_certificate=true.

    8. Mendaftarkan template Proxmox di CloudStack

    Buka:

    Images > Templates > Register Template

    Isi data dasar:

    FieldNilai
    Nameubuntu-2404-cloudstack
    URLhttps://example.invalid/ubuntu-2404-cloudstack.qcow2
    HypervisorExternal
    ExtensionProxmox
    ZoneZone tempat cluster Proxmox berada
    OS TypeUbuntu 24.04 (64-bit) atau yang paling sesuai

    URL hanya menjadi metadata karena image yang digunakan sudah berada di Proxmox.

    Tambahkan External Details berikut:

    KeyValue
    template_typetemplate
    template_id9000

    CloudStack mendukung pemetaan template CloudStack ke template atau ISO Proxmox. Untuk deployment dari template, gunakan template_type=template dan isi template_id dengan VMID template Proxmox.

    Menyamakan metadata ukuran template

    Template pada lab memiliki root disk 20 GiB. Nilai byte-nya adalah:

    20 × 1024 × 1024 × 1024 = 21474836480 byte

    Backup metadata sebelum penyesuaian:

    mysqldump -u root -p cloud vm_template vm_template_details \
      > /root/cloudstack-template-before-integration.sql

    Cari ID template yang baru didaftarkan:

    SELECT id, name, size, hypervisor_type
    FROM vm_template
    WHERE name = 'ubuntu-2404-cloudstack'
      AND removed IS NULL;

    Set ukuran sesuai disk template Proxmox:

    UPDATE vm_template
    SET size = 21474836480
    WHERE id = <ID_TEMPLATE>
      AND hypervisor_type = 'External'
      AND removed IS NULL;

    Verifikasi:

    SELECT id, name, size,
           ROUND(size / 1073741824, 2) AS size_gib
    FROM vm_template
    WHERE id = <ID_TEMPLATE>;

    Nilai size_gib harus menunjukkan 20.00.

    9. Menyiapkan Compute Offering

    Buat Compute Offering untuk VM Proxmox, misalnya:

    FieldNilai
    Nameproxmox-small
    CPU2
    CPU speed1000 MHz
    Memory2048 MB
    Root Disk Size20 GB

    CPU dan memory dari offering akan diterapkan pada hasil clone. Root Disk Size dibuat sama dengan root disk template agar metadata dan kapasitas instance konsisten.

    10. Menyiapkan isolated guest network

    Buat atau gunakan network berikut:

    FieldNilai
    Nameguest-isolated-01
    Network modeNATTED
    CIDR10.1.1.0/24
    Gateway10.1.1.1
    VLAN319

    Pada isolated network mode NATTED, CloudStack Virtual Router menyediakan DHCP, DNS, gateway, dan Source NAT. Dokumentasi CloudStack menjelaskan bahwa VR memberikan alamat IP guest dan meneruskan trafik keluar melalui Source NAT. Lihat CloudStack Guest Traffic.

    Jika Network Offering menggunakan Default Egress Policy: Deny, tambahkan Egress Rule agar VM dapat mengakses internet. Untuk lab:

    ProtocolCIDRPort
    All0.0.0.0/0Semua

    Untuk produksi, batasi sesuai kebutuhan, misalnya DNS, HTTP, HTTPS, NTP, dan repository sistem operasi.

    11. Melakukan deployment VM

    Buka:

    Compute > Instances > Add Instance

    Pilih:

    1. Zone tempat cluster Proxmox berada.
    2. Template ubuntu-2404-cloudstack.
    3. Compute Offering proxmox-small.
    4. Network guest-isolated-01.

    External Details yang dapat ditambahkan saat deployment:

    KeyValueFungsi
    storagelocal-lvmMenentukan storage disk hasil clone
    is_full_clonefalseMenggunakan linked clone
    vm_nameOpsionalNama VM di Proxmox

    disk_size_gb tidak digunakan untuk deployment dari template. Parameter tersebut digunakan ketika sumber deployment berupa ISO.

    CloudStack akan mengambil VMID yang tersedia dari Proxmox, melakukan clone template 9000, menerapkan CPU dan RAM, memasang MAC address CloudStack, menambahkan tag VLAN 319, lalu menyalakan VM.

    12. Verifikasi deployment

    Dari CloudStack

    Pastikan:

    Instance State: Running
    Host: pvecs1.lab.local
    IP Address: 10.1.1.x

    Uji operasi berikut dari CloudStack UI:

    • Console
    • Stop
    • Start
    • Reboot
    • Delete

    Dari Proxmox GUI

    Buka node pvecs1, lalu cari VM baru pada panel kiri. Nama VM mengikuti internal name CloudStack, misalnya i-2-13-VM.

    Pilih VM tersebut dan periksa:

    MenuVerifikasi
    SummaryVM berstatus running
    Hardware > ProcessorsJumlah core mengikuti Compute Offering
    Hardware > MemoryKapasitas RAM mengikuti Compute Offering
    Hardware > Hard DiskDisk hasil clone berada di local-lvm
    Hardware > Network DeviceBridge vmbr1 dan VLAN Tag 319
    ConsoleTampilan boot Ubuntu dapat dibuka

    Dari dalam VM

    Login melalui console menggunakan user ubuntu. Pada lab, gunakan password Cloud-Init yang telah ditentukan pada template. Setelah login, jalankan:

    ip -br address
    ip route
    ping -c 3 10.1.1.1
    ping -c 3 8.8.8.8
    getent ahostsv4 google.com
    curl -I https://example.com

    Contoh alamat yang diterima VM:

    eth0 UP 10.1.1.53/24
    default via 10.1.1.1 dev eth0

    Hasil tersebut menunjukkan bahwa DHCP, gateway, VLAN trunk, Egress Rule, DNS, dan Source NAT CloudStack sudah bekerja.

    Hasil akhir

    Setelah seluruh konfigurasi diterapkan:

    • Host Proxmox tampil Up/Enabled di CloudStack.
    • Template Proxmox VMID 9000 dapat dipilih dari CloudStack.
    • VM dibuat otomatis di Proxmox menggunakan VMID baru.
    • CPU dan memory mengikuti Compute Offering.
    • NIC VM menggunakan MAC address dan VLAN dari CloudStack.
    • VM memperoleh IP dari CloudStack Virtual Router.
    • Console dapat dibuka dari CloudStack UI.
    • VM dapat mengakses internet setelah Egress Rule diizinkan.
    • Lifecycle VM dapat dikelola dari CloudStack.

    Catatan keamanan untuk produksi

    • Gunakan API token khusus CloudStack dengan hak minimum yang diperlukan.
    • Gunakan sertifikat TLS valid dan aktifkan verifikasi sertifikat.
    • Jangan menaruh token secret di dokumentasi, shell history, atau log publik.
    • Gunakan SSH key sebagai akses utama VM.
    • Hindari password default yang sama pada semua VM.
    • Rotasi API token secara berkala.
    • Gunakan shared storage jika template harus tersedia pada beberapa node Proxmox.
    • Backup skrip extension sebelum upgrade CloudStack dan validasi kembali setelah upgrade.

    Referensi

  • Mengatasi Error SSH Key CloudStack saat Menambahkan Host KVM

    Mengatasi Error SSH Key CloudStack saat Menambahkan Host KVM

    Saat menambahkan host KVM ke Apache CloudStack menggunakan opsi System SSH Key, proses penambahan host gagal karena Management Server tidak dapat melakukan autentikasi SSH.

    Error yang Muncul

    Pada log CloudStack, error yang muncul mengarah ke kegagalan autentikasi SSH key:

    Failed to authenticate with ssh key
    Failed to authenticate with ssh key, retrying with password

    Pada CloudStack UI, error dapat ditampilkan dalam bentuk:

    Could not add host at [http://192.168.14.135] ...
    due to: [Authentication error with ssh private key]

    Ketika koneksi diuji secara manual, autentikasi SSH juga gagal:

    root@192.168.14.135: Permission denied (publickey).

    Error tersebut menunjukkan bahwa private key milik CloudStack belum dikenali oleh user root pada host KVM.

    Kondisi Lab

    Server yang digunakan pada lab ini adalah:

    • Hostname: csmgmt-kvm.lab.local
    • IP address: 192.168.14.135
    • Fungsi: CloudStack Management Server sekaligus host KVM
    • Autentikasi host: System SSH Key

    Walaupun Management Server dan host KVM berada pada server yang sama, CloudStack tetap melakukan koneksi SSH ke:

    root@192.168.14.135

    Proses CloudStack berjalan menggunakan user sistem cloud. Oleh karena itu, private key yang digunakan harus dapat dibaca oleh user cloud, sedangkan public key-nya harus terdaftar pada /root/.ssh/authorized_keys.

    Memeriksa Home Directory User cloud

    Jangan langsung menggunakan /var/cloudstack/management karena lokasi home directory user cloud dapat berbeda berdasarkan sistem operasi dan paket CloudStack yang digunakan.

    Periksa lokasi sebenarnya dengan:

    getent passwd cloud

    Ambil home directory user cloud:

    CLOUD_USER_HOME=$(getent passwd cloud | cut -d: -f6)
    printf 'Home user cloud: %s\n' "$CLOUD_USER_HOME"

    Pada Ubuntu atau Debian, lokasinya umumnya:

    /var/lib/cloudstack/management

    Sementara pada distribusi berbasis RHEL dapat menggunakan:

    /var/cloudstack/management

    Karena itu, seluruh perintah berikut menggunakan variabel $CLOUD_USER_HOME.

    Memeriksa System SSH Key CloudStack

    Periksa apakah key CloudStack sudah tersedia:

    ls -la "$CLOUD_USER_HOME/.ssh"

    Seharusnya tersedia dua file berikut:

    id_rsa
    id_rsa.pub

    Private key id_rsa digunakan oleh Management Server, sedangkan id_rsa.pub perlu didaftarkan pada host KVM.

    Jika kedua file sudah tersedia, jangan membuat key baru. Cukup perbaiki ownership dan permission-nya:

    chown -R cloud:cloud "$CLOUD_USER_HOME/.ssh"
    chmod 700 "$CLOUD_USER_HOME/.ssh"
    chmod 600 "$CLOUD_USER_HOME/.ssh/id_rsa"
    chmod 644 "$CLOUD_USER_HOME/.ssh/id_rsa.pub"

    Pastikan private key dapat dibaca oleh user cloud:

    sudo -u cloud -H test -r "$CLOUD_USER_HOME/.ssh/id_rsa" \
      && echo "Private key dapat dibaca oleh user cloud"

    Membuat SSH Key Jika Belum Tersedia

    Langkah ini hanya dilakukan jika id_rsa dan id_rsa.pub benar-benar belum tersedia.

    Buat directory SSH:

    install -d -m 700 -o cloud -g cloud "$CLOUD_USER_HOME/.ssh"

    Kemudian buat SSH key sebagai user cloud:

    sudo -u cloud -H ssh-keygen \
      -t rsa \
      -b 4096 \
      -f "$CLOUD_USER_HOME/.ssh/id_rsa" \
      -N ""

    Periksa kembali hasilnya:

    ls -l "$CLOUD_USER_HOME/.ssh/id_rsa"*

    Menambahkan Public Key ke Host KVM

    Pada kasus ini, host KVM berada pada server yang sama, yaitu 192.168.14.135. Tambahkan public key CloudStack ke authorized_keys milik user root:

    install -d -m 700 -o root -g root /root/.ssh
    touch /root/.ssh/authorized_keys

    Tambahkan key hanya jika belum terdaftar:

    grep -qxF "$(cat "$CLOUD_USER_HOME/.ssh/id_rsa.pub")" \
      /root/.ssh/authorized_keys || \
      cat "$CLOUD_USER_HOME/.ssh/id_rsa.pub" \
      >> /root/.ssh/authorized_keys

    Sesuaikan ownership dan permission:

    chown root:root /root/.ssh/authorized_keys
    chmod 600 /root/.ssh/authorized_keys

    CloudStack memang menyediakan opsi penambahan host KVM menggunakan System SSH Key dengan menempatkan public key Management Server pada /root/.ssh/authorized_keys host KVM. Prosedur tersebut juga dijelaskan dalam dokumentasi konfigurasi Apache CloudStack.

    Memeriksa Konfigurasi SSH Server

    Periksa konfigurasi SSH yang sedang aktif:

    sshd -T | grep -E '^(permitrootlogin|pubkeyauthentication)'

    Konfigurasi yang dibutuhkan adalah:

    permitrootlogin prohibit-password
    pubkeyauthentication yes

    PermitRootLogin prohibit-password mengizinkan login root menggunakan public key, tetapi tetap menolak login root menggunakan password.

    Jika hasilnya belum sesuai, buat konfigurasi tambahan:

    nano /etc/ssh/sshd_config.d/99-cloudstack.conf

    Isi dengan:

    PermitRootLogin prohibit-password
    PubkeyAuthentication yes

    Validasi syntax:

    sshd -t

    Apabila tidak terdapat output, restart SSH:

    systemctl restart ssh

    Menguji SSH sebagai User cloud

    Pengujian harus dilakukan sebagai user cloud, bukan sebagai root, karena proses CloudStack Management Server berjalan menggunakan user tersebut.

    Jalankan:

    sudo -u cloud -H ssh \
      -o BatchMode=yes \
      -o IdentitiesOnly=yes \
      -o StrictHostKeyChecking=accept-new \
      -i "$CLOUD_USER_HOME/.ssh/id_rsa" \
      root@192.168.14.135 \
      'whoami && hostname -f'

    Jika berhasil, hasilnya kurang lebih:

    root
    csmgmt-kvm.lab.local

    Opsi BatchMode=yes memastikan SSH tidak meminta password. Dengan demikian, keberhasilan perintah tersebut membuktikan bahwa autentikasi benar-benar menggunakan SSH key.

    Jika masih gagal, jalankan pengujian verbose:

    sudo -u cloud -H ssh -vvv \
      -o BatchMode=yes \
      -o IdentitiesOnly=yes \
      -i "$CLOUD_USER_HOME/.ssh/id_rsa" \
      root@192.168.14.135

    Perhatikan bagian yang menunjukkan apakah private key ditawarkan, diterima, atau ditolak oleh SSH server.

    Mengulangi Penambahan Host

    Setelah pengujian SSH berhasil, ulangi penambahan host KVM pada CloudStack dengan parameter:

    Host Name     : 192.168.14.135
    Username      : root
    Authentication: System SSH Key

    Konfigurasi berikut tidak diperlukan pada kasus ini:

    Defaults:cloud !requiretty

    Pengaturan tersebut berkaitan dengan penggunaan sudo oleh user non-root pada host tujuan. Pada kasus ini CloudStack melakukan koneksi langsung sebagai root, sehingga masalahnya murni pada autentikasi SSH key.

    Kesimpulan

    Penyebab error bukan berasal dari status cloudstack-management, libvirtd, ataupun socket libvirt. Masalahnya adalah System SSH Key CloudStack belum dapat digunakan untuk login sebagai root ke host KVM.

    Alur autentikasi yang harus dipastikan adalah:

    Proses CloudStack sebagai user cloud
            ↓
    Membaca private key dari home user cloud
            ↓
    SSH ke root@192.168.14.135
            ↓
    Public key ditemukan di /root/.ssh/authorized_keys
            ↓
    Login berhasil tanpa password
    

    Setelah koneksi SSH sebagai user cloud berhasil dan menghasilkan output root, proses penambahan host KVM dapat diulangi menggunakan opsi System SSH Key.

    https://docs.cloudstack.apache.org/en/4.21.0.0/installguide/configuration.html#adding-a-kvm-host

  • Menambahkan Ceph MON Eksternal dan QDevice pada Proxmox Cluster 2 Node

    Menambahkan Ceph MON Eksternal dan QDevice pada Proxmox Cluster 2 Node

    Saya memiliki Proxmox cluster yang terdiri dari pveceph1 dan pveceph2, dengan tiga OSD Ceph pada setiap node. Agar cluster tetap dapat dikelola dan storage Ceph tetap melayani I/O ketika salah satu node mati, saya menambahkan server Debian eksternal bernama cephmon3.

    Server tersebut menjalankan dua layanan berbeda:

    • Ceph MON ketiga untuk menjaga quorum Ceph.
    • Corosync qnetd untuk memberikan vote QDevice kepada cluster PVE.

    Ceph MON tidak menggantikan QDevice karena keduanya menangani quorum yang berbeda.

    Topologi

    HostLayanan
    pveceph1PVE, MON, MGR, 3 OSD
    pveceph2PVE, MON, MGR, 3 OSD
    cephmon3Debian, MON, qnetd, tanpa OSD

    cephmon3 harus berada pada server atau hypervisor independen. Jangan menyimpannya pada pveceph1, pveceph2, atau pool Ceph yang sama.

    1. Memastikan MON dan MGR pada kedua node

    Dari GUI Proxmox, buka node > Ceph > Monitor. Pastikan layanan berikut sudah terdaftar:

    • MON pada pveceph1 dan pveceph2.
    • MGR pada pveceph1 dan pveceph2, dengan satu active dan satu standby.

    Jika ada yang belum tersedia, pilih node terkait lalu klik Create pada bagian Monitor atau Manager.

    Lanjutkan ketika kedua MON PVE sudah berada dalam quorum.

    2. Menyiapkan server cephmon3

    Saya menggunakan Debian 13 minimal dengan 2 vCPU, RAM 4 GB, disk lokal 32 GB, IP statis, SSH server, dan tanpa desktop environment.

    Pastikan hostname konsisten:

    hostnamectl set-hostname cephmon3
    hostnamectl

    Tambahkan resolusi hostname ketiga server melalui DNS internal atau /etc/hosts. Pastikan waktu tersinkronisasi:

    apt update
    apt install -y chrony
    systemctl enable --now chrony

    Jika Debian dipasang menggunakan ISO DVD, nonaktifkan sumber deb cdrom: dan pastikan repository online Debian Trixie sudah aktif sebelum menjalankan apt update.

    3. Mengatur firewall (untuk production)

    Untuk lingkungan produksi, firewall sebaiknya tetap aktif dan hanya membuka koneksi yang diperlukan:

    PortArahFungsi
    TCP 3300 dan 6789Antara ketiga host MONKomunikasi Ceph MON
    TCP 5403pveceph1/pveceph2 ke cephmon3Corosync qnetd
    TCP 22Jaringan administrator ke cephmon3SSH administrasi

    Jika menggunakan Proxmox Firewall, tambahkan rule Ceph pada kedua node PVE dan izinkan IP cephmon3. Pada server Debian, izinkan IP kedua node PVE menuju port MON dan qnetd.

    Untuk lab lokal yang terisolasi, firewall dapat dinonaktifkan sementara agar pengujian lebih mudah. Namun, jangan menggunakan cara tersebut pada lingkungan produksi dan aktifkan kembali firewall setelah pengujian selesai.

    4. Menginstal Ceph dan qnetd

    Jalankan pada cephmon3:

    apt update
    apt install -y wget ca-certificates corosync-qnetd
    wget https://enterprise.proxmox.com/debian/proxmox-archive-keyring-trixie.gpg \
      -O /usr/share/keyrings/proxmox-archive-keyring.gpg

    Buat /etc/apt/sources.list.d/ceph.sources:

    Types: deb
    URIs: http://download.proxmox.com/debian/ceph-squid
    Suites: trixie
    Components: no-subscription
    Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg

    Kemudian instal paket Ceph:

    apt update
    apt install -y ceph-common ceph-mon
    systemctl enable --now corosync-qnetd
    ceph --version

    Pastikan versi major Ceph sama dengan kedua node PVE, yaitu Squid 19.2.x.

    5. Melakukan bootstrap MON eksternal

    Buat direktori transfer pada cephmon3:

    install -d -m 700 /root/cephmon3-bootstrap
    install -d -m 755 /etc/ceph

    Kemudian jalankan pada pveceph1:

    install -d -m 700 /root/cephmon3-bootstrap
    cp /etc/pve/ceph.conf /root/cephmon3-bootstrap/ceph.conf
    ceph auth get mon. -o /root/cephmon3-bootstrap/ceph.mon.keyring
    ceph mon getmap -o /root/cephmon3-bootstrap/monmap
    scp /root/cephmon3-bootstrap/* root@<IP-CEPHMON3>:/root/cephmon3-bootstrap/

    Kembali ke cephmon3:

    install -m 644 /root/cephmon3-bootstrap/ceph.conf /etc/ceph/ceph.conf
    nano /etc/ceph/ceph.conf

    Tambahkan konfigurasi berikut:

    [mon.cephmon3]
        public_addr = <IP-CEPHMON3>

    ID MON harus konsisten. Karena service bernama ceph-mon@cephmon3, direktori datanya harus bernama ceph-cephmon3 dan konfigurasi menggunakan [mon.cephmon3].

    Inisialisasi data MON:

    install -d -o ceph -g ceph -m 0750 /var/lib/ceph/mon/ceph-cephmon3
    ceph-mon -i cephmon3 --mkfs \
      --monmap /root/cephmon3-bootstrap/monmap \
      --keyring /root/cephmon3-bootstrap/ceph.mon.keyring
    chown -R ceph:ceph /var/lib/ceph/mon/ceph-cephmon3
    systemctl enable --now ceph-mon@cephmon3
    systemctl status ceph-mon@cephmon3 --no-pager

    6. Memperbarui konfigurasi Ceph pada PVE

    Setelah MON eksternal berhasil menyala, edit /etc/pve/ceph.conf dari salah satu node PVE:

    nano /etc/pve/ceph.conf

    Tambahkan IP cephmon3 pada baris mon_host yang sudah ada:

    mon_host = <IP-PVECEPH1> <IP-PVECEPH2> <IP-CEPHMON3>

    Tambahkan juga:

    [mon.cephmon3]
        public_addr = <IP-CEPHMON3>

    Salin konfigurasi final ke server MON eksternal:

    scp /etc/pve/ceph.conf root@<IP-CEPHMON3>:/etc/ceph/ceph.conf

    Verifikasi dari node PVE:

    ceph -s
    ceph mon stat
    ceph quorum_status --format json-pretty

    Targetnya adalah tiga MON berada dalam quorum:

    pveceph1, pveceph2, cephmon3

    7. Menambahkan QDevice

    Instal package QDevice pada kedua node PVE:

    apt update
    apt install -y corosync-qdevice

    Pastikan corosync-qnetd aktif pada cephmon3:

    systemctl status corosync-qnetd --no-pager

    Kemudian jalankan satu kali dari pveceph1:

    pvecm qdevice setup <IP-CEPHMON3>
    pvecm status

    Hasil yang diharapkan:

    Expected votes: 3
    Total votes:    3
    Quorum:         2
    Flags:          Quorate Qdevice

    Dengan QDevice, pvecm expected 1 tidak perlu digunakan sebagai konfigurasi permanen.

    8. Memeriksa konfigurasi pool

    Untuk cluster dengan OSD hanya pada dua host, pool dibuat terlebih dahulu dengan size 3/min_size 2, kemudian diedit menjadi size 2/min_size 1 pada pvecephpool dan .mgr.

    ceph osd pool get pvecephpool size
    ceph osd pool get pvecephpool min_size
    ceph osd pool get .mgr size
    ceph osd pool get .mgr min_size

    Nilai min_size 1 membuat storage tetap menerima I/O dari satu replika ketika satu node OSD mati, tetapi Ceph akan berada dalam kondisi degraded dan risiko kehilangan data meningkat.

    9. Melakukan pengujian

    Matikan salah satu node PVE melalui GUI, kemudian periksa dari node yang masih hidup:

    pvecm status
    ceph -s
    ceph mon stat

    Hasil yang diharapkan:

    • PVE tetap quorate menggunakan satu node dan QDevice.
    • Ceph tetap memiliki quorum melalui satu MON PVE dan cephmon3.
    • VM pada node yang masih hidup tetap berjalan.
    • Storage tetap dapat menerima I/O, tetapi berstatus degraded sampai node kedua kembali.

    VM pada node yang mati hanya dapat otomatis menyala di node lainnya jika telah dikonfigurasi sebagai resource HA dan kapasitas node yang tersisa mencukupi.

    Kesimpulan

    Penambahan cephmon3 menyelesaikan dua kebutuhan pada cluster dua node: Ceph memperoleh MON ketiga, sedangkan Proxmox memperoleh vote tambahan dari QDevice. Solusi ini dapat menggunakan Debian ringan tanpa menambah node PVE ketiga, tetapi tetap merupakan desain kompromi karena data OSD hanya tersimpan pada dua host.

    Referensi:

  • Membangun dan Menguji Proxmox Cluster 2 Node dengan Ceph Storage

    Membangun dan Menguji Proxmox Cluster 2 Node dengan Ceph Storage

    Saya ditugaskan untuk membuat cluster Proxmox VE yang terdiri dari dua node dan menggunakan Ceph sebagai shared storage. Setelah konfigurasi selesai, kemudian saya ditugaskan untuk melakukan pengujian dengan mematikan salah satu node untuk mengetahui kondisi VM, quorum Proxmox, dan quorum Ceph.

    Eksperimen ini juga menguji solusi sementara berupa penghapusan Ceph Monitor pada pveceph2 dan penggunaan pvecm expected 1. Hasilnya menunjukkan bahwa quorum Proxmox/Corosync, quorum Ceph Monitor, dan redundansi data Ceph merupakan tiga hal berbeda yang harus ditangani secara terpisah.

    Catatan: Konfigurasi dua node, satu Ceph Monitor, serta pool size 2/min_size 1 pada artikel ini digunakan untuk eksperimen. Konfigurasi tersebut bukan rekomendasi untuk lingkungan produksi.

    Lingkungan Pengujian

    KomponenKonfigurasi
    Proxmox VE9.2.10
    Kernel7.0.14-12-pve
    CephSquid 19.2.5
    Node 1pveceph1
    Node 2pveceph2
    OSD3 OSD pada setiap node, total 6 OSD
    Poolpvecephpool
    Replikasi poolsize 2, min_size 1
    VM pengujianAlpine Linux pada pveceph1 dengan disk di pvecephpool

    Pada konfigurasi ini, size 2 membuat Ceph menyimpan dua salinan data. Sementara itu, min_size 1 mengizinkan I/O tetap berjalan ketika hanya tersedia satu salinan. Konfigurasi ini membantu pengujian dua node, tetapi meningkatkan risiko kehilangan data ketika penulisan berlangsung tanpa redundansi. Dokumentasi Proxmox Ceph juga memperingatkan bahwa replicated pool dengan min_size 1 dapat menyebabkan kehilangan data atau PG menjadi tidak lengkap jika salinan terakhir bermasalah.

    1. Membuat Cluster Proxmox Dua Node

    Pembuatan cluster dapat dilakukan melalui GUI Proxmox.

    Membuat cluster pada pveceph1

    1. Login ke GUI pveceph1.
    2. Buka Datacenter → Cluster.
    3. Klik Create Cluster.
    4. Masukkan nama cluster.
    5. Pilih jaringan Corosync yang akan digunakan pada bagian Cluster Network.
    6. Klik Create.
    7. Setelah cluster terbentuk, klik Join Information, lalu salin informasi yang ditampilkan.

    Menggabungkan pveceph2

    1. Login ke GUI pveceph2.
    2. Buka Datacenter → Cluster.
    3. Klik Join Cluster.
    4. Tempel informasi dari pveceph1.
    5. Masukkan password root milik pveceph1.
    6. Pastikan alamat jaringan Corosync sudah sesuai.
    7. Klik Join.

    Node yang akan bergabung sebaiknya belum memiliki VM atau konfigurasi penting karena konfigurasi cluster pada node tersebut akan disesuaikan dengan cluster tujuan. Langkah GUI ini sesuai dengan panduan Proxmox VE Cluster Manager.

    Periksa halaman Datacenter → Cluster setelah proses selesai. Pastikan pveceph1 dan pveceph2 terlihat berstatus online.

    2. Menginstal dan Mengonfigurasi Ceph

    Menginstal Ceph pada kedua node

    Lakukan langkah berikut pada pveceph1 dan pveceph2:

    1. Pilih nama node pada panel kiri.
    2. Buka menu Ceph.
    3. Klik Install Ceph atau ikuti wizard instalasi yang muncul.
    4. Pilih Ceph Squid dan repository yang sesuai.
    5. Selesaikan instalasi paket.

    Pada node pertama, lanjutkan dengan inisialisasi konfigurasi Ceph. Tentukan Public Network dan Cluster Network sesuai jaringan yang sudah disiapkan. Node kedua menggunakan konfigurasi Ceph yang sudah tersimpan pada cluster, sehingga tidak perlu membuat cluster Ceph baru.

    Periksa halaman konfigurasi Ceph.

    Membuat Ceph Monitor

    Pada konfigurasi awal eksperimen, MON dibuat pada kedua node:

    1. Buka Ceph → Monitor.
    2. Klik Create.
    3. Pilih pveceph1, kemudian buat MON.
    4. Ulangi untuk pveceph2.

    Jika wizard konfigurasi sudah otomatis membuat MON pada pveceph1, cukup buat MON tambahan pada pveceph2.

    Dengan dua MON, quorum membutuhkan keduanya aktif atau 2 dari 2 MON. Artinya, konfigurasi ini belum dapat menoleransi kegagalan satu MON. Ceph merekomendasikan sedikitnya tiga MON untuk produksi dan jumlah MON ganjil agar mayoritas tetap dapat terbentuk ketika satu MON gagal.

    Periksa halaman Ceph → Monitor yang menampilkan MON pveceph1 dan pveceph2 dalam kondisi aktif serta berada dalam quorum.

    Membuat enam OSD (Sesuaikan dengan kebutuhan)

    Setiap node pada lab ini memiliki tiga disk khusus OSD.

    1. Pilih node yang akan dikonfigurasi.
    2. Buka Ceph → OSD.
    3. Klik Create: OSD.
    4. Pilih disk kosong yang akan digunakan.
    5. Pastikan disk yang dipilih tidak berisi data penting.
    6. Klik Create.
    7. Ulangi hingga tersedia tiga OSD pada setiap node.

    Peringatan: Pembuatan OSD akan menghapus isi disk yang dipilih. Periksa nama dan kapasitas disk sebelum menekan Create.

    Periksa halaman Ceph → OSD atau tampilan CRUSH yang menunjukkan enam OSD berstatus up dan in, masing-masing tiga OSD di bawah pveceph1 dan pveceph2.

    Membuat pool Ceph

    1. Buka Ceph → Pools.
    2. Klik Create.
    3. Isi nama pool dengan pvecephpool.
    4. Buat pool terlebih dahulu dengan Size 3 dan Min. Size 2.
    5. Pilih CRUSH rule yang menempatkan replika pada host berbeda.
    6. Aktifkan opsi penambahan storage jika tersedia, lalu klik Create.

    Setelah pvecephpool berhasil dibuat, ubah konfigurasinya menjadi size 2/min_size 1:

    1. Pilih pool pvecephpool, lalu klik Edit.
    2. Ubah Size dari 3 menjadi 2.
    3. Ubah Min. Size dari 2 menjadi 1.
    4. Simpan perubahan.
    5. Pilih pool internal .mgr, lalu klik Edit.
    6. Ubah Size dan Min. Size pada .mgr menjadi 2 dan 1.
    7. Simpan perubahan dan tunggu proses penyesuaian PG selesai.

    Catatan: Pada eksperimen ini, konfigurasi 2/1 tidak langsung diterapkan ketika membuat pool. Pool dibuat lebih dahulu dengan nilai 3/2, kemudian pvecephpool dan pool internal .mgr diedit menjadi 2/1. Jika hanya pvecephpool yang diubah, .mgr masih menggunakan 3/2 dan Ceph dapat tetap menampilkan peringatan karena cluster hanya memiliki dua host OSD. Pool .mgr tidak perlu dihapus; cukup sesuaikan nilai replikasinya.

    Jika pool belum muncul sebagai storage Proxmox, buka Datacenter → Storage → Add → RBD, lalu pilih pvecephpool sebagai pool. Aktifkan jenis konten Disk image sesuai kebutuhan.

    3. Membuat VM Pengujian pada Ceph

    1. Klik Create VM.
    2. Tempatkan VM pada pveceph1.
    3. Gunakan ISO Alpine Linux atau sistem operasi ringan lainnya.
    4. Pada bagian disk, pilih pvecephpool sebagai storage.
    5. Selesaikan instalasi, kemudian jalankan VM.
    6. Pastikan status VM Running sebelum pengujian dimulai.

    Sebelum mematikan node, pastikan status Ceph normal, kedua MON berada dalam quorum, dan seluruh OSD berstatus up serta in.

    Periksa halaman Hardware VM yang menunjukkan disk berada di pvecephpool dan pastikan VM berstatus Running.

    4. Pengujian Pertama: Mematikan pveceph2

    Node kedua dimatikan langsung melalui GUI:

    1. Pilih pveceph2 pada panel kiri.
    2. Klik Shutdown.
    3. Konfirmasi proses shutdown.
    4. Tunggu hingga pveceph2 benar-benar tidak aktif.

    Setelah itu, pemeriksaan dilakukan melalui GUI pveceph1.

    Hasil pengujian

    • VM Alpine pada pveceph1 tetap berstatus Running.
    • MON pveceph2 tidak aktif sehingga dua MON tidak dapat membentuk mayoritas.
    • Tiga OSD milik pveceph2 menjadi down dan PG kehilangan satu salinan data.
    • Cluster Proxmox kehilangan quorum karena hanya tersedia satu dari dua vote Corosync.
    • Pembuatan VM baru tidak dapat dilakukan karena pmxcfs menjadi read-only ketika cluster Proxmox tidak quorate.

    VM yang sudah berjalan dapat tetap aktif karena proses QEMU masih berjalan dan jalur data Ceph tidak selalu langsung berhenti ketika MON tidak memiliki quorum. Namun, kondisi tersebut tidak boleh dianggap sebagai jaminan ketersediaan. Perubahan peta cluster, koneksi baru, atau gangguan tambahan tetap dapat menyebabkan I/O berhenti.

    VM tetap running (dapat di ping) namun tidak dapat diakses.

    5. Menghapus MON pveceph2

    Pengujian berikutnya bertujuan memastikan MON pada node yang mati tidak lagi menjadi bagian dari quorum Ceph. Sebelum menghapus MON, pveceph2 dinyalakan kembali dan ditunggu hingga cluster Proxmox serta Ceph kembali normal.

    Menghapus MON melalui GUI

    1. Buka Ceph → Monitor dari node yang aktif.
    2. Pilih MON pveceph2.
    3. Klik Destroy.
    4. Periksa kembali nama MON pada dialog konfirmasi.
    5. Konfirmasi penghapusan.

    Prosedur GUI tersebut juga dijelaskan pada dokumentasi Deploy Hyper-Converged Ceph Cluster.

    Alternatif melalui CLI

    Jika GUI tidak dapat digunakan, perintah berikut dapat dijalankan melalui menu Shell pada pveceph2 ketika node masih aktif dan quorum tersedia:

    pveceph mon destroy pveceph2

    Pada eksperimen ini yang dihapus hanya service MON. OSD pada pveceph2 tetap dipertahankan sebagai bagian dari pool.

    Mengulangi pengujian shutdown

    Setelah MON pveceph2 berhasil dihapus, node tersebut kembali dimatikan melalui GUI. Hasilnya:

    • VM pada pveceph1 tetap Running.
    • MON tunggal pveceph1 dapat membentuk quorum 1 dari 1.
    • Error quorum MON yang sebelumnya terjadi tidak lagi menjadi penghambat.
    • Ceph tetap menampilkan kondisi degraded atau undersized karena tiga OSD pada pveceph2 tidak tersedia.
    • Cluster Proxmox tetap tidak quorate karena Corosync masih hanya memiliki satu dari dua vote.
    • Pembuatan VM atau perubahan konfigurasi tetap terblokir pada sisi Proxmox.

    Penghapusan MON kedua hanya mengubah quorum Ceph. Langkah ini tidak memperbaiki quorum Proxmox dan tidak mengembalikan redundansi data Ceph.

    Pengujian pembuatan VM gagal

    6. Menggunakan pvecm expected 1 untuk Pengujian

    Dalam pengujian ini, perintah berikut dijalankan melalui pveceph1 → Shell setelah dipastikan bahwa pveceph2 benar-benar mati:

    pvecm expected 1

    Perintah tersebut mengubah jumlah vote yang diharapkan menjadi satu sehingga pveceph1 kembali quorate. Setelah itu, pmxcfs dapat ditulis kembali dan pengujian melalui GUI dapat dilanjutkan. Pada lab ini, pembuatan VM baru digunakan hanya untuk membuktikan bahwa hambatan sebelumnya berasal dari quorum Proxmox.

    Peringatan: pvecm expected 1 merupakan tindakan pemulihan sementara, bukan konfigurasi permanen untuk cluster dua node. Jalankan hanya setelah node lain dipastikan benar-benar mati atau sudah di-fence. Jangan menjalankannya pada dua sisi yang terpisah karena dapat menyebabkan split-brain dan perubahan konfigurasi yang saling bertentangan. Dokumentasi Proxmox menempatkan perintah ini sebagai workaround ketika quorum hilang dan memperingatkan agar perubahan yang memengaruhi cluster tidak dilakukan dalam kondisi vote dipaksa. Untuk produksi, QDevice direkomendasikan sebagai vote ketiga pada cluster dua node.

    Ringkasan Hasil Pengujian

    KondisiQuorum ProxmoxQuorum Ceph MONKondisi data CephVM yang sudah berjalanPerubahan konfigurasi/VM baru
    Kedua node aktif, dua MONAda2/2NormalBerjalanBisa
    pveceph2 mati, dua MON masih terdaftarTidak adaTidak ada, hanya 1/2Degraded, satu replika tersisaTetap berjalan pada pengujianTidak bisa
    pveceph2 mati, MON-nya sudah dihapusTidak adaAda, 1/1Degraded, satu replika tersisaTetap berjalan pada pengujianTidak bisa
    Kondisi sebelumnya + pvecm expected 1Ada secara paksaAda, 1/1Tetap degradedTetap berjalan pada pengujianDapat diuji melalui GUI

    Tabel tersebut menunjukkan bahwa MON Ceph dan quorum Corosync bekerja secara independen. Memperbaiki salah satunya tidak otomatis memperbaiki komponen lain.

    Solusi Implementasi Dua Node

    Menggunakan satu MON memang membuat Ceph memiliki quorum 1/1, tetapi seluruh cluster bergantung pada pveceph1. Jika MON tersebut mati, Ceph tidak memiliki MON lain untuk mengambil alih. Karena itu, konfigurasi ini hanya sesuai untuk membuktikan perilaku sistem dalam lab.

    Untuk implementasi dua node yang mempertimbangkan biaya subscription Proxmox, rencana pengujian berikutnya adalah menambahkan satu VM atau server Linux independen. Perannya mirip witness, tetapi komponen yang digunakan berbeda untuk Proxmox dan Ceph.

    1. QDevice untuk quorum Proxmox

    Pada sisi Proxmox/Corosync, server independen menjalankan corosync-qnetd. Kedua node PVE kemudian menggunakan QDevice untuk memperoleh vote ketiga. Dengan demikian, satu node PVE yang masih aktif bersama QDevice dapat mempertahankan quorum. Proxmox secara resmi merekomendasikan QDevice untuk cluster dua node yang membutuhkan ketersediaan lebih baik pada panduan Proxmox VE Cluster Manager.

    2. MON ketiga untuk quorum Ceph

    Pada sisi Ceph tidak terdapat QDevice yang sama seperti Corosync. Solusinya adalah menjalankan Ceph Monitor ketiga pada server atau VM independen. Sebelum pengujian ini dilakukan, MON pveceph2 perlu dibuat kembali sehingga susunannya menjadi:

    • MON pveceph1;
    • MON pveceph2;
    • MON ketiga pada host independen.

    Dengan tiga MON, Ceph dapat mempertahankan quorum ketika satu MON mati karena masih tersedia dua dari tiga MON. MON ketiga adalah MON penuh yang menyimpan cluster map dan ikut melakukan voting, bukan sekadar QDevice. Prinsip mayoritas dan rekomendasi minimal tiga MON dijelaskan pada dokumentasi Adding/Removing Monitors.

    Jika MON ketiga ditempatkan pada VM, disk dan proses boot VM tersebut tidak boleh bergantung pada pvecephpool yang sedang dilindungi. VM harus berjalan pada host, storage, dan jalur daya yang independen agar tidak terjadi ketergantungan melingkar.

    Untuk lab atau lingkungan dengan sumber daya terbatas, satu server independen dapat diuji untuk menjalankan corosync-qnetd dan Ceph MON ketiga. Keduanya tetap merupakan service berbeda dan harus diuji secara terpisah. Kompatibilitas versi Ceph, prosedur pemeliharaan, serta dukungan vendor perlu dipastikan sebelum digunakan pada produksi.

    3. MON ketiga tidak menambah replika data

    Penambahan MON ketiga hanya mempertahankan quorum monitor. Ketika pveceph2 mati, tiga OSD di node tersebut tetap hilang dan pool size 2/min_size 1 hanya dapat melanjutkan I/O dengan satu salinan data jika PG masih aktif. Ceph tetap dapat menampilkan HEALTH_WARN, degraded, atau undersized.

    Jika dibutuhkan redundansi storage yang benar-benar dapat menoleransi kegagalan satu host tanpa berjalan pada satu salinan, diperlukan host OSD ketiga atau desain storage lain yang sesuai. Backup eksternal juga tetap wajib karena replikasi Ceph bukan pengganti backup.

    Pertimbangan Biaya Subscription

    Jika pada lingkungan produksi menggunakan subscription Proxmox, setiap server fisik Proxmox VE harus dicakup sesuai jumlah CPU socket yang digunakan, dan seluruh node dalam satu cluster menggunakan tingkat subscription yang sama. Karena itu, menambahkan node PVE ketiga dapat meningkatkan biaya subscription. Ketentuan ini dapat dilihat pada Proxmox Subscription FAQ.

    Alternatif berupa server Linux independen yang hanya menjalankan QDevice dan Ceph MON dapat menghindari penambahan node PVE ketiga. Namun, desain ini menggunakan MON eksternal yang dikelola secara manual.

    Rencana Pengujian Berikutnya

    Sesuai arahan yang ditugaskan pada saya, pengujian selanjutnya berfokus pada penambahan Ceph MON di luar cluster PVE agar jumlah MON menjadi 3 dan min_size menjadi 2 dan quorum Ceph tetap tersedia ketika salah satu node PVE mati. Host eksternal akan berperan mirip QDevice, tetapi menjalankan Ceph MON penuh.

    Topologi yang akan diuji:

    HostCluster PVEService Ceph
    pveceph1Cluster pvecephMON dan 3 OSD
    pveceph2Cluster pvecephMON dan 3 OSD
    PVE standalone atau Linux lainDi luar clusterMON eksternal tanpa OSD

    Tahapan pengujiannya adalah sebagai berikut:

    1. Menyiapkan PVE standalone atau server/VM Linux pada infrastruktur dan storage yang independen dari pvecephpool.
    2. Memasang paket Ceph yang kompatibel dengan Ceph Squid 19.2.5 pada host eksternal.
    3. Menyalakan pveceph2 dan membuat kembali MON pada node tersebut.
    4. Menambahkan Ceph MON ketiga pada host eksternal.
    5. Memastikan ketiga MON berstatus aktif dan membentuk quorum 3/2.

    Kesimpulan

    Pada eksperimen ini, VM di pveceph1 tetap berjalan ketika pveceph2 dimatikan, tetapi pembuatan VM baru terblokir karena cluster Proxmox kehilangan quorum. Menghapus MON pveceph2 membuat MON tunggal pveceph1 memiliki quorum 1/1, sedangkan pvecm expected 1 memungkinkan pengujian lanjutan pada sisi Proxmox.

    Kedua tindakan tersebut hanya solusi sementara untuk lab. Desain dua node yang lebih tepat membutuhkan QDevice untuk quorum Proxmox dan MON ketiga pada host independen untuk quorum Ceph. Jika targetnya juga mempertahankan redundansi data ketika satu node mati, MON ketiga saja tidak cukup—dibutuhkan OSD pada host ketiga atau arsitektur storage lain yang sesuai.

  • Pengujian Proxmox 2 Node dengan Satu Ceph Monitor

    Pengujian Proxmox 2 Node dengan Satu Ceph Monitor

    Pendahuluan

    Ceph umumnya menggunakan minimal tiga Monitor untuk menyediakan quorum dan redundansi. Namun, pada pengujian ini saya mencoba menjalankan cluster Proxmox VE dua node dengan hanya satu Ceph Monitor.

    Tujuan pengujian ini adalah mengetahui kondisi VM dan storage Ceph ketika node kedua dimatikan, serta memastikan apakah VM baru masih dapat dibuat pada node yang tetap aktif.

    Konfigurasi Homelab

    Pengujian dilakukan menggunakan konfigurasi berikut:

    KomponenKonfigurasi
    Proxmox VE9.2.10
    Ceph19.2.5 Squid
    Node pertamapveceph1 – 192.168.14.57
    Node keduapveceph2 – 192.168.14.58
    Jumlah OSD6 OSD
    OSD pveceph1osd.3, osd.4, dan osd.5
    OSD pveceph2osd.0, osd.1, dan osd.2
    Storage VMpvecephpool
    Pool replicasize=2
    Minimum replicamin_size=1
    Ceph MonitorHanya di pveceph1
    VM pengujianAlpine Linux di pveceph1

    Pada kondisi awal, kedua node aktif, enam OSD berstatus up/in, seluruh Placement Group berstatus active+clean, dan Ceph menunjukkan status HEALTH_OK.

    Mengubah Ceph Menjadi Satu Monitor

    Awalnya Ceph memiliki dua Monitor, yaitu:

    • pveceph1
    • pveceph2

    Sebelum Monitor kedua dihapus, dilakukan pemeriksaan untuk memastikan bahwa mon.pveceph2 aman dikeluarkan dari monmap. Hasil pemeriksaan menunjukkan:

    root@pveceph1:~# ceph mon ok-to-rm pveceph2
    safe to remove mon.pveceph2

    Monitor pveceph2 kemudian dihapus melalui Proxmox Web GUI dengan langkah berikut:

    1. Pilih node pveceph2.
    2. Buka menu Ceph → Monitor.
    3. Pilih Monitor pveceph2.
    4. Klik Destroy.
    5. Konfirmasi penghapusan dan tunggu sampai proses selesai.

    Alternatifnya, penghapusan Monitor dapat dilakukan melalui CLI pada node pveceph2:

    pveceph mon destroy pveceph2

    Proses tersebut hanya menghapus fungsi Ceph Monitor pada pveceph2. Node Proxmox, tiga OSD, dan layanan Ceph lainnya pada node tersebut tetap dipertahankan.

    Setelah proses selesai, Ceph hanya memiliki satu Monitor aktif, yaitu pveceph1, dengan quorum 1/1.

    Dokumentasi Ceph menjelaskan:

    “A cluster will run fine with a single Monitor; however, a single Monitor is a single-point-of-failure.”

    Artinya, satu Monitor tetap dapat melayani cluster Ceph. Namun, jika Monitor tersebut gagal, tidak ada Monitor lain yang dapat mengambil alih. Ceph Monitor Configuration Reference.

    Membuat VM Pengujian

    Selanjutnya, dibuat satu VM Alpine Linux dengan ketentuan berikut:

    • VM ditempatkan di node pveceph1.
    • Disk VM menggunakan storage pvecephpool.
    • VM tidak dimasukkan ke dalam konfigurasi Proxmox HA.
    • VM dinyalakan sebelum proses pengujian dimulai.

    Melalui Web GUI, VM dipastikan telah berstatus Running dan disk-nya menggunakan storage Ceph.

    Mematikan pveceph2

    Setelah VM Alpine berjalan, node pveceph2 dimatikan melalui Proxmox Web GUI:

    1. Pilih node pveceph2.
    2. Klik tombol Shutdown.
    3. Konfirmasi proses shutdown.
    4. Tunggu sampai node benar-benar berstatus offline.

    Setelah pveceph2 mati, pemeriksaan dilakukan melalui Web GUI pada pveceph1, meliputi:

    • Status VM Alpine pada halaman Summary.
    • Status node pada halaman Datacenter.
    • Status Ceph pada menu Ceph.
    • Status Monitor pada menu Ceph → Monitor.
    • Status OSD pada menu Ceph → OSD.
    • Status storage pvecephpool.
    • Percobaan membuat VM baru di pveceph1.

    Hasil Pengujian

    VM yang sudah berjalan tetap running

    Setelah pveceph2 dimatikan, VM Alpine di pveceph1 tetap berstatus Running.

    Hal ini terjadi karena:

    • Ceph Monitor pveceph1 tetap memiliki quorum 1/1.
    • Tiga OSD di pveceph1 masih aktif.
    • Pool menggunakan min_size=1.
    • Proses VM telah berjalan di pveceph1.

    Meskipun VM tetap berjalan, Ceph berada dalam kondisi degraded karena tiga OSD pada pveceph2 sudah tidak tersedia.

    Dengan size=2 dan min_size=1, Ceph masih dapat melayani I/O menggunakan satu replica yang tersedia. Namun, data pada kondisi tersebut hanya memiliki satu salinan aktif.

    Dokumentasi Ceph memperingatkan bahwa penggunaan size=2 atau min_size=1 memiliki risiko kehilangan data dan tidak direkomendasikan sebagai konfigurasi normal untuk production. Dokumentasi Ceph Pool.

    VM baru tidak dapat dibuat

    Ketika dilakukan percobaan membuat VM baru di pveceph1, proses tersebut gagal walaupun storage Ceph masih dapat diakses.

    Kegagalan ini bukan disebabkan oleh single Ceph Monitor, melainkan karena cluster Proxmox kehilangan quorum.

    Cluster Proxmox masih mengharapkan dua vote, sedangkan setelah pveceph2 dimatikan hanya tersedia satu vote dari pveceph1. Akibatnya, Proxmox Cluster File System atau pmxcfs berubah menjadi read-only.

    Dokumentasi Proxmox menjelaskan salah satu karakteristik pmxcfs sebagai berikut:

    “Read-only when a node loses quorum.”

    Karena konfigurasi VM disimpan di dalam /etc/pve, Proxmox tidak dapat menulis konfigurasi VM baru ketika cluster tidak memiliki quorum. Dokumentasi Proxmox pmxcfs.

    Ringkasan Hasil

    PengujianHasil
    Ceph Monitor pveceph2 dihapusBerhasil
    Ceph berjalan dengan satu MonitorBerhasil, quorum 1/1
    pveceph2 dimatikanBerhasil
    VM Alpine di pveceph1Tetap running
    Storage CephTetap tersedia, tetapi degraded
    OSD pada pveceph2Down
    Membuat VM baru di pveceph1Gagal
    Penyebab kegagalanPVE/Corosync kehilangan quorum

    Pengujian Lanjutan

    Untuk kebutuhan lab, jumlah expected vote dapat diubah sementara menjadi satu:

    pvecm expected 1

    Perintah tersebut dapat membuat pveceph1 kembali memiliki quorum sehingga pengujian pembuatan VM baru dapat dilanjutkan.

    Namun, perintah ini hanya boleh digunakan setelah memastikan pveceph2 benar-benar mati, bukan sekadar terputus dari jaringan. Penggunaannya dalam kondisi node lain masih aktif dapat menimbulkan risiko split-brain.

    Untuk cluster Proxmox dua node yang digunakan secara permanen, Proxmox merekomendasikan QDevice sebagai vote ketiga. Dokumentasi Proxmox Cluster Manager.

    Kesimpulan

    Pengujian menunjukkan bahwa satu Ceph Monitor di pveceph1 tetap dapat melayani storage ketika pveceph2 dimatikan. VM Alpine yang sudah berjalan tetap berstatus Running karena Ceph masih memiliki MON quorum 1/1 dan pool memperbolehkan I/O dengan satu replica.

    Namun, VM baru tidak dapat dibuat karena cluster Proxmox kehilangan quorum dan pmxcfs berubah menjadi read-only. Dengan demikian, kegagalan pembuatan VM baru berasal dari quorum PVE/Corosync, bukan dari quorum Ceph.

    Konfigurasi satu Ceph Monitor dan pool size=2/min_size=1 dapat digunakan untuk eksperimen, tetapi tidak direkomendasikan untuk production karena tidak memiliki redundansi Monitor dan hanya menyisakan satu salinan data ketika salah satu node mati.

  • Tips Menginstal Windows di Proxmox agar Stabil dan Optimal

    Tips Menginstal Windows di Proxmox agar Stabil dan Optimal

    Windows dapat berjalan dengan baik di Proxmox, tetapi ada beberapa konfigurasi yang sebaiknya disiapkan sebelum instalasi. Kesalahan yang paling umum adalah disk tidak terdeteksi, network adapter tidak muncul, atau Windows 11 gagal karena TPM dan Secure Boot belum tersedia.

    Berikut beberapa tips agar proses instalasi lebih lancar dan performa VM tetap optimal.

    Persiapan

    Siapkan dua file ISO berikut:

    1. ISO Windows dari sumber resmi Microsoft.
    2. ISO driver VirtIO versi stable.

    ISO Windows digunakan untuk instalasi sistem operasi, sedangkan ISO VirtIO berisi driver disk, network adapter, ballooning, dan QEMU Guest Agent. Proxmox juga merekomendasikan VirtIO karena memberikan performa lebih baik dibandingkan perangkat yang diemulasikan.

    Sebagai titik awal, resource VM dapat disesuaikan seperti berikut:

    KebutuhanCPURAMDisk
    Testing ringan2–4 vCPU4–8 GB64 GB
    Penggunaan harian4 vCPU8–16 GB80 GB atau lebih
    Windows ServerSesuai aplikasiMinimal 8 GBSesuai kebutuhan data

    Angka tersebut merupakan rekomendasi praktis, bukan batas tetap. Sesuaikan kembali dengan aplikasi yang akan dijalankan dan kapasitas host Proxmox.

    1. Gunakan UEFI dan TPM untuk Windows 11

    Saat membuat VM Windows 11, gunakan konfigurasi berikut pada bagian System:

    • Machine: q35
    • BIOS: OVMF (UEFI)
    • Tambahkan EFI Disk
    • Aktifkan Pre-Enroll Keys untuk Secure Boot
    • Tambahkan TPM State versi 2.0

    Microsoft mensyaratkan UEFI dan TPM 2.0 untuk Windows 11. Menyiapkan keduanya sejak awal juga lebih aman daripada melakukan bypass pemeriksaan hardware ketika instalasi.

    2. Pasang Dua ISO Sejak Awal

    Pada hardware VM, pasang:

    • ISO Windows sebagai CD/DVD pertama.
    • ISO VirtIO sebagai CD/DVD kedua.

    Jangan menunggu sampai Windows selesai dipasang. Driver storage dari ISO VirtIO diperlukan ketika Windows Installer belum dapat melihat virtual disk.

    3. Gunakan VirtIO SCSI untuk Disk

    Gunakan VirtIO SCSI single sebagai SCSI Controller, kemudian pasang disk utama menggunakan bus SCSI. Jika storage mendukungnya, aktifkan juga:

    • Discard untuk membantu pengembalian ruang kosong melalui TRIM.
    • IO Thread untuk meningkatkan performa I/O.

    Ketika halaman pemilihan disk Windows tidak menampilkan storage, klik Load driver, lalu buka ISO VirtIO dan pilih:

    vioscsi\w11\amd64

    Untuk Windows Server, pilih folder sesuai versinya, misalnya vioscsi\2k22\amd64. Setelah driver dimuat, disk SCSI akan muncul dan instalasi dapat dilanjutkan.

    4. Gunakan Network Adapter VirtIO

    Pilih model network adapter VirtIO (paravirtualized) agar throughput lebih baik dan penggunaan CPU lebih rendah. Jika network adapter belum terdeteksi di Windows, instal driver dari folder berikut:

    NetKVM\w11\amd64

    Setelah berhasil masuk ke desktop, jalankan installer guest tools dari ISO VirtIO. Installer tersebut membantu memasang driver VirtIO lain yang masih dibutuhkan. Periksa Device Manager dan pastikan tidak ada perangkat dengan tanda peringatan.

    5. Instal dan Aktifkan QEMU Guest Agent

    Aktifkan opsi QEMU Guest Agent pada konfigurasi VM Proxmox, kemudian instal servicenya di Windows melalui ISO VirtIO. Pastikan service QEMU Guest Agent berstatus running.

    Guest Agent membantu Proxmox membaca informasi VM, menjalankan shutdown dengan lebih baik, serta melakukan freeze dan thaw filesystem ketika proses backup. Hal ini membantu meningkatkan konsistensi backup Windows.

    6. Sesuaikan CPU dengan Environment

    Untuk homelab atau VM yang hanya berjalan pada satu host, CPU type host dapat digunakan agar fitur CPU fisik diteruskan ke VM dan performanya lebih optimal.

    Jika VM akan dipindahkan melalui live migration dalam cluster, gunakan CPU model yang kompatibel dengan seluruh node. CPU type host dapat menyulitkan migrasi apabila spesifikasi prosesor antarnode berbeda.

    Kesimpulan

    Kunci instalasi Windows di Proxmox adalah menyiapkan virtual hardware dan driver sebelum proses instalasi dimulai. Gunakan OVMF, EFI Disk, dan TPM 2.0 untuk Windows 11, lalu gunakan VirtIO SCSI, VirtIO Network, serta QEMU Guest Agent agar VM dapat berjalan lebih stabil dan efisien.

    Dengan konfigurasi tersebut, masalah seperti disk tidak terdeteksi, network adapter hilang, atau status guest agent tidak terbaca dapat dihindari sejak awal.

    Referensi

  • Replikasi NAKIVO Kembali Full Setelah VM Proxmox dengan Storage CEPH di Reboot

    Replikasi NAKIVO Kembali Full Setelah VM Proxmox dengan Storage CEPH di Reboot

    Dalam pengujian NAKIVO Backup & Replication, saya menemukan bahwa replikasi VM Proxmox kembali menjadi full setelah VM sempat reboot. Kondisi ini berkaitan dengan Change Block Tracking (CBT) dan format disk yang digunakan.

    Homelab yang Digunakan

    Pengujian menggunakan dua node Proxmox:

    • pve-nakivo sebagai source
    • pve-nakivo2 sebagai destination
    • Ceph RBD sebagai backend storage
    • VM test1 sebagai objek replikasi

    Replikasi dijalankan dari pve-nakivo menuju pve-nakivo2 melalui schedule NAKIVO.

    Hasil Pengujian

    Pengujian dilakukan dengan urutan berikut:

    1. Replikasi pertama dijalankan saat VM menyala.
    2. NAKIVO menjalankan full replication.
    3. VM kemudian di-reboot.
    4. Schedule replikasi berikutnya kembali berjalan.
    5. Replikasi kedua juga dijalankan secara full.

    Pada job kedua, muncul warning:

    Proxmox VE CBT data was not provided for the “test1” VM.

    Kemudian NAKIVO menampilkan informasi:

    Cannot perform incremental replication of the “test1” VM.

    Artinya, schedule replikasi tetap berjalan. Namun, NAKIVO tidak dapat melanjutkan incremental replication karena informasi perubahan disk sebelumnya tidak tersedia.

    Penyebabnya

    CBT digunakan untuk mencatat blok disk yang berubah sejak replikasi terakhir. Dengan informasi tersebut, NAKIVO hanya perlu mengirimkan data yang berubah.

    Menurut dokumentasi NAKIVO:

    • Disk format QEMU/QCOW2 memiliki dirty bitmap yang persistent.
    • Disk format RAW atau VMDK menggunakan dirty bitmap non-persistent.
    • Reboot VM dengan disk RAW akan me-reset dirty bitmap.

    Pada homelab ini, disk VM disimpan pada Ceph RBD. Ceph RBD merupakan block-level storage dan VM disk menggunakan format RAW. Ketika VM reboot, data CBT di-reset sehingga NAKIVO tidak mendapatkan informasi perubahan blok yang valid.

    NAKIVO kemudian mencoba menggunakan proprietary change tracking. Namun, karena informasi increment sebelumnya tidak ditemukan, NAKIVO menjalankan full replication kembali.

    Pengujian Lanjutan

    Untuk memastikan incremental replication berjalan normal, pengujian dapat dilanjutkan dengan skenario berikut:

    1. Jalankan full replication.
    2. Tambahkan data pada VM tanpa melakukan reboot.
    3. Tunggu schedule berikutnya.
    4. Pastikan job berjalan secara incremental.
    5. Reboot VM dan tunggu schedule selanjutnya.
    6. Bandingkan hasil replikasi setelah reboot.

    Untuk VM yang sering reboot, opsi Use proprietary method dapat digunakan pada pengaturan Change Tracking. Metode ini tidak bergantung sepenuhnya pada native CBT Proxmox, tetapi prosesnya lebih lama karena NAKIVO perlu membaca seluruh disk untuk mencari blok yang berubah.

    QEMU Guest Agent tetap perlu dipasang untuk proses snapshot dan quiescing guest OS, tetapi tidak dapat mencegah CBT ter-reset setelah VM reboot.

    Kesimpulan

    Schedule replikasi tetap berjalan meskipun VM sempat reboot. Namun, pada VM yang menggunakan Ceph RBD dengan format RAW, reboot dapat me-reset CBT sehingga incremental replication tidak dapat dilanjutkan dan NAKIVO kembali menjalankan full replication.

    Kondisi ini merupakan limitasi native CBT pada disk RAW, bukan kegagalan schedule replikasi.

    Referensi

  • Menghindari Error dan Warning saat Replikasi NAKIVO di Proxmox

    Menghindari Error dan Warning saat Replikasi NAKIVO di Proxmox

    NAKIVO dapat digunakan untuk membuat replica VM dari satu Proxmox ke Proxmox lainnya. Replica tersebut dapat dinyalakan ketika VM utama mengalami gangguan atau saat melakukan pengujian recovery.

    Pada pengujian homelab ini, replication sempat gagal dan menghasilkan beberapa warning. Berikut konfigurasi yang saya lakukan agar prosesnya dapat berjalan dengan lancar.

    Homelab yang Digunakan

    Saya menggunakan dua server Proxmox dengan backend storage Ceph.

    KomponenFungsi
    pve-nakivoHost VM sumber
    pve-nakivo2Host VM replica
    Ceph RBDStorage disk VM sumber dan replica
    NAKIVOMengatur dan menjalankan proses replication

    Alur replication-nya sebagai berikut:

        VM sumber
    pve-nakivo + Ceph
            ↓
          NAKIVO
            ↓
        VM replica
    pve-nakivo2 + Ceph

    NAKIVO berperan memproses dan memindahkan data. Hasil akhirnya tetap berupa VM replica pada pve-nakivo2, bukan disimpan di server NAKIVO.

    Sebelum menjalankan replication, ada empat hal yang perlu diperiksa.

    1. Ubah Lokasi Temporary Overlay

    Untuk VM yang berada pada block storage seperti Ceph RBD, NAKIVO membuat temporary overlay pada host Proxmox. Secara default, file tersebut disimpan di /tmp.

    Pada pengujian pertama, replication gagal dengan error:

    Host has no free space for overlay files
    Not enough space for creation of temporary overlay file in "/tmp" location.

    Periksa kapasitas /tmp pada pve-nakivo:

    df -hT /tmp
    findmnt -T /tmp

    Pada homelab saya, /tmp menggunakan tmpfs dengan kapasitas 2 GB. Karena tidak cukup, saya membuat lokasi temporary baru pada filesystem root yang sudah memiliki ruang lebih besar:

    mkdir -p /var/lib/nakivo-temp
    chown root:root /var/lib/nakivo-temp
    chmod 700 /var/lib/nakivo-temp
    df -hT /var/lib/nakivo-temp

    Kemudian ubah lokasinya pada NAKIVO:

    • Settings → Inventory → pve-nakivo → Edit
      → Options → Temporary file location
      → /var/lib/nakivo-temp

    Simpan konfigurasi lalu lakukan Refresh Inventory.

    Untuk homelab, direktori tersebut cukup digunakan selama kapasitas root dipantau. Pada production, sebaiknya gunakan filesystem terpisah agar temporary overlay tidak memenuhi root Proxmox.

    2. Pastikan VM Sumber Menyala

    Pada pengujian berikutnya, replication VM yang sedang off dapat diproses oleh NAKIVO, tetapi menghasilkan warning karena VM dijalankan dalam temporary prelaunch state.

    Untuk mendapatkan hasil job yang bersih, saya memastikan VM sumber sudah menyala sebelum replication dimulai:

    qm list
    qm start <VMID>

    Pastikan status VM pada pve-nakivo menunjukkan running.

    3. Pasang dan Aktifkan QEMU Guest Agent

    QEMU Guest Agent membantu Proxmox berkomunikasi dengan guest OS. NAKIVO membutuhkannya untuk melakukan guest OS quiescing agar filesystem berada dalam kondisi konsisten saat snapshot dibuat.

    Tanpa agent, job dapat tetap berjalan tergantung konfigurasinya. Namun, dapat muncul warning karena quiesced snapshot tidak berhasil dibuat.

    Untuk VM Debian atau Ubuntu, jalankan:

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

    Setelah itu, aktifkan pada Proxmox:

    VM → Options → QEMU Guest Agent → Enabled

    Jika agent baru diaktifkan tetapi belum terdeteksi, lakukan shutdown lalu start kembali VM. Uji komunikasinya dari host Proxmox:

    qm agent <VMID> ping

    Jika perintah tidak menghasilkan error, QEMU Guest Agent sudah terhubung.

    4. Pisahkan Jadwal Backup dan Replication

    Backup dan replication sebaiknya tidak dijalankan pada waktu yang sama. Keduanya menggunakan VM sumber, storage Ceph, jaringan, dan NAKIVO Transporter.

    Pada homelab ini, jadwalnya dipisahkan seperti berikut:

    JobContoh Jadwal
    Backup21.00 WIB
    Replication23.00 WIB

    Berikan jeda sesuai durasi backup ditambah buffer. Pilihan yang lebih aman adalah menggunakan Run after another job, sehingga replication baru berjalan setelah backup selesai.

    Periksa juga menu Calendar pada NAKIVO untuk memastikan tidak ada jadwal yang saling tumpang tindih.

    Verifikasi Hasil Replication

    Setelah konfigurasi diperbaiki, jalankan kembali job dan pastikan:

    • Job replication berstatus Successful tanpa error atau warning.
    • VM replica muncul pada pve-nakivo2.
    • Disk replica berada pada storage Ceph tujuan.
    • Temporary overlay dibersihkan setelah job selesai.

    Penggunaan temporary storage dapat dipantau selama job berjalan:

    watch -n 5 'df -h /var/lib/nakivo-temp; du -sh /var/lib/nakivo-temp 2>/dev/null'

    Penutup

    Replication NAKIVO pada Proxmox dapat berjalan lancar setelah lokasi temporary overlay memiliki ruang yang cukup, VM sumber dalam kondisi menyala, QEMU Guest Agent aktif, dan jadwal job tidak saling bertabrakan.

    Empat pemeriksaan tersebut cukup sederhana, tetapi penting dilakukan sebelum replication diterapkan pada VM lainnya.

    Referensi

  • Cara Mengatasi NAKIVO Replication Gagal karena Temporary Overlay di Proxmox

    Cara Mengatasi NAKIVO Replication Gagal karena Temporary Overlay di Proxmox

    Saat melakukan pengujian replication NAKIVO pada Proxmox dengan backend storage Ceph, job gagal karena NAKIVO tidak memiliki ruang yang cukup untuk membuat temporary overlay. Masalah ini terjadi walaupun kapasitas Ceph masih tersedia.

    Artikel ini membahas penyebabnya, proses pemeriksaan, dan solusi yang digunakan pada lab.

    Kondisi Lab

    KomponenKonfigurasi
    Proxmoxpve-nakivo.local
    IP Proxmox192.168.14.45
    Disk OS awal30 GB, ext4 dan LVM
    Backend storage VMCeph
    Ceph OSD3 × 50 GB
    VM pengujiantest1

    VM sumber berada di Ceph, sedangkan replication dijalankan melalui NAKIVO.

    Pesan Error

    Pada replication pertama, NAKIVO menampilkan error berikut:

    ReplicationDataCopy: Host has no free space for overlay files
    
    Not enough space for creation of temporary overlay file in "/tmp" location.
    Please make sure there is sufficient free space in the specified location.

    Error tersebut menunjukkan bahwa masalah berada pada temporary file location di host Proxmox, bukan pada kapasitas Ceph.

    Memahami Alur Replication NAKIVO

    Pada storage berbasis block seperti Ceph RBD, NAKIVO membutuhkan overlay sementara selama pemrosesan VM.

    VM test1 di Ceph
    → temporary overlay di host Proxmox
    → data diproses oleh NAKIVO
    → VM replica dibuat pada storage tujuan
    → temporary overlay dibersihkan

    Jadi, /tmp bukan lokasi akhir replica. Hasil replication tetap berupa VM pada Proxmox dan storage tujuan yang dipilih dalam job.

    Penyebab

    Pada Proxmox VE 9, /tmp menggunakan tmpfs. Artinya, kapasitas /tmp berasal dari memory dan swap, bukan dari filesystem root.

    Karena itu, memperbesar disk OS dan pve-root tidak otomatis menambah kapasitas /tmp. Root sudah memiliki ruang kosong 97 GB, tetapi NAKIVO masih menggunakan /tmp yang hanya 2 GB.

    Memperbesar tmpfs juga bukan pilihan yang digunakan pada pengujian ini karena akan menambah batas penggunaan memory atau swap. Solusinya adalah membuat direktori temporary NAKIVO pada filesystem ext4 yang sudah diperbesar.

    Membuat Lokasi Temporary Baru

    Buat direktori khusus pada filesystem root:

    mkdir -p /var/lib/nakivo-temp
    chown root:root /var/lib/nakivo-temp
    chmod 700 /var/lib/nakivo-temp

    Periksa filesystem yang digunakan:

    df -hT /var/lib/nakivo-temp

    Hasilnya harus mengarah ke filesystem root, bukan tmpfs:

    /dev/mapper/pve-root  ext4  112G  11G  97G  10%  /

    Uji akses tulis:

    touch /var/lib/nakivo-temp/test-write
    rm /var/lib/nakivo-temp/test-write

    Mengubah Temporary File Location di NAKIVO

    Buka konfigurasi inventory Proxmox pada NAKIVO:

    Settings
    → Inventory
    → pve-nakivo.local
    → Edit
    → Options
    → Temporary file location

    Ubah lokasi dari:

    /tmp

    menjadi:

    /var/lib/nakivo-temp

    Simpan perubahan, kemudian lakukan Refresh Inventory.

    Menjalankan Ulang Replication

    Jalankan kembali replication job melalui NAKIVO. Selama proses berlangsung, kapasitas dan penggunaan direktori temporary dapat dipantau dengan:

    watch -n 5 'df -h /var/lib/nakivo-temp; du -sh /var/lib/nakivo-temp 2>/dev/null'

    Hasil yang diharapkan:

    • Job replication berstatus Successful.
    • VM replica muncul pada Proxmox.
    • Disk replica berada pada storage tujuan yang dipilih.
    • Temporary overlay dibersihkan setelah job selesai.
    • VM sumber tetap berjalan normal.

    Catatan Penting

    Penggunaan /var/lib/nakivo-temp sesuai untuk pengujian lab karena root sudah memiliki ruang yang cukup. Namun, direktori tersebut masih berada pada root volume Proxmox.

    Untuk production atau VM dengan perubahan data tinggi, gunakan disk atau filesystem terpisah sebagai temporary file location. Tujuannya agar pertumbuhan overlay tidak memenuhi root dan mengganggu service Proxmox.

    Selain itu, replication ke node dan Ceph yang sama hanya membuktikan fungsi replication. Skenario tersebut belum memberikan perlindungan disaster recovery karena VM sumber dan replica tetap bergantung pada host yang sama.

    Kesimpulan

    Replication gagal bukan karena Ceph kehabisan ruang, tetapi karena /tmp pada Proxmox hanya berupa tmpfs 2 GB. Memperbesar disk OS tidak menambah kapasitas /tmp secara otomatis.

    Solusi pada lab ini adalah membuat /var/lib/nakivo-temp, kemudian mengarahkannya sebagai Temporary file location pada inventory NAKIVO. Dengan begitu, overlay dapat memakai ruang kosong filesystem ext4 tanpa bergantung pada tmpfs.

    Referensi