Install & Deploy PNETLab v8 Unofficial

PNETLab v8 Unofficial adalah platform emulasi jaringan self-hosted modern yang dirancang khusus untuk Ubuntu 26.04 LTS “27H1 Resolute” (arsitektur amd64 dengan akselerasi wajib /dev/kvm). Seluruh landing download, release manifest, dan repositori APT dikelola secara resmi di Codeberg pada organisasi netkillui. Versi pada README landing adalah PNetLab v8 6.8.79, sedangkan channel pointer resmi aktif (pnetlab-latest.json) mengarah ke 6.8.81resolute1 (sequence 81, timestamp 18 September 2026). Rilis yang sedang aktif ditangani di lapangan karena kegagalan fatal instalasi bare-metal adalah 6.8.78resolute1.

• Empat artefak resmi upstream & mirror ALSYUNDAWY: (1) Network Install Script, (2) OVA Autoinstaller / Netinstall OVA, (3) Full Standalone ISO v8.12 & Turn-key OVA v8.12, dan (4) Offline Update Tarball Bundle 6.8.62 yang di-mirror berkecepatan tinggi di repo.alsyundawy.com/?berkas=PnetLab.
• Paket deb manifest-pinned resmi: pnetlab, pnetlab-docker, pnetlab-guacd, pnetlab-qemu, pnetlab-schema, pnetlab-vpcs, serta modul kernel best-effort pnetlab-bridge-dkms.
• Daemon & unit yang diverifikasi installer: Broker unix socket (pnetlab-brokerd.service), HTTP bridge (127.0.0.1:8025), Console mux telnet (:8022) & VNC (:6080), Shell bridge (:8023), serta HTML5 console (pnet-guac-lite.service :8081).
• Trust Anchors: Offline manifest signer fingerprint 158D99DF8D57040AA8E0EDA58F353DF9007A2BB4 dan APT repository signing key fingerprint EA21DC771565BC84C57A610861756807AC7005EC.
• Jalur upgrade host v8: Built-in sudo pnetlab-update untuk update otomatis in-place, Network Installer dengan flag --no-cloud-uplink, serta Manual Upgrade dpkg -i + apt-get -f install sebagai fallback resmi upstream.

Pisahkan build/install host dari eksperimen lab jika memungkinkan. Untuk lab produksi internal, satu host dedicated (bare-metal atau VM nested-virt) lebih aman daripada menumpuk di hypervisor yang sudah padat.

                 PNETLab v8 UNOFFICIAL
                           │
         ┌─────────────────┼─────────────────┐
         │                 │                 │
   Fresh Ubuntu 26.04   Existing host     OVA / ISO / Bundle
   (network install)    6.8.62 → latest   repo.alsyundawy.com
         │                 │                 │
         ▼                 ▼                 ▼
   ethX → pnet0 (mgmt)   --no-cloud-uplink  DHCP / static
   pnet1..pnet9 + nat0   preserve ifaces    web UI HTTPS
         │                 │                 │
         └─────────────────┴─────────────────┘
                           │
              GUI https://<host-ip>/  + nested virt

Spesifikasi Host

• Hanya Ubuntu 26.04 Resolute amd64 untuk metode network install resmi.
• Hardware virtualization aktif (cek grep -E 'vmx|svm' /proc/cpuinfo).
• Akses root / sudo, koneksi ke Codeberg + Docker Hub (atau mirror).
• Jangan campur repo resmi lama repo.pnetlab.com dengan channel v8 Codeberg.
• Backup dulu: lab XML, startup-config, image di /opt/unetlab/addons, dump MySQL jika ada data Store/user.
• Jika host remote via SSH: simpan aturan firewall sebelum transaksi APT (UFW bisa dihapus installer).

4.1 Siapkan OS

Install Ubuntu Server 26.04 LTS amd64. Pilih OpenSSH. Setelah boot:

sudo hostnamectl set-hostname pnetlab-v8
sudo apt update
sudo apt full-upgrade -y

hostnamectl
uname -m
cat /etc/os-release
grep -E 'vmx|svm' /proc/cpuinfo | head
# Harus: x86_64 + Ubuntu 26.04 + flag virt

4.2 Network Installer (host bersih)

Pada host baru tanpa /etc/network/interfaces custom, perintah resmi README:

curl -fsSL \
  https://codeberg.org/api/packages/netkillui/generic/pnetlab-core-assets/0.channel/pnetlab-network-install-latest.sh \
  | sudo bash -s -- \
    --yes \
    --release latest

Installer bersifat manifest-driven: resolve channel pointer bertanda tangan → unduh manifest rilis → enroll APT source Codeberg → simulasi transaksi → mutasi paket. Contoh log sukses resolve:

channel pointer resolved: release=6.8.78resolute1 sequence=78
=== fetching release manifest ===
channel pointer/manifest identity matches
=== preflight: exact transaction simulation ===

Distribusi berkas instalasi PNETLab v8 Unofficial untuk platform Ubuntu 26.04 LTS Resolute / 27H1 tersedia melalui tiga saluran utama: Dedicated Mirror Resmi ALSYUNDAWY IT SOLUTION (repo.alsyundawy.com) yang berkecepatan tinggi dan bebas batas kuota, Saluran Rilis Resmi Upstream (Codeberg & Mega), serta Mirror Publik Komunitas Global (Telegram, Buzzheavier, wdfiles, & Google Drive).

5.1 Dedicated Mirror Resmi ALSYUNDAWY IT SOLUTION (repo.alsyundawy.com) — [Direkomendasikan]

Seluruh berkas fisik berikut di-hosting langsung pada infrastruktur cloud repository berkecepatan tinggi ALSYUNDAWY IT SOLUTION dan dapat diunduh langsung via direct download link (tanpa login, bebas batasan transfer, resumable via curl -C - atau wget -c). Untuk menelusuri daftar direktori berkas repositori secara visual, akses portal skrip di repo.alsyundawy.com/?berkas=PnetLab (proteksi indeks Nginx aktif):

# Unduh OVA Netinstall (bootstrapping cepat via jaringan):
wget -c https://repo.alsyundawy.com/PnetLab/PNetLab-27H1-v8-netinstall.ova

# Unduh Full Bootable ISO v8.12 (bare-metal server / VM):
wget -c https://repo.alsyundawy.com/PnetLab/PNetLab-27H1-v8.12.iso

# Unduh Full Pre-built OVA v8.12 (turn-key siap pakai di hypervisor):
wget -c https://repo.alsyundawy.com/PnetLab/PNetLab-27H1-v8.12.ova

# Unduh Offline Update Tarball Bundle 6.8.62 (air-gapped / in-place upgrade):
wget -c https://repo.alsyundawy.com/PnetLab/pnetlab-27H1-v8.62-6.8.62-resolute-bundle.tgz

5.2 Artefak Rilis Resmi Upstream (Codeberg & Mega)

5.3 Repositori Publik Komunitas, Mirror ISO / OVA & Saluran Distribusi

Bagi pengguna yang membutuhkan file image utuh (ISO) untuk instalasi bare-metal mandiri tanpa koneksi internet penuh saat instalasi atau terkendala batas bandwidth, komunitas jaringan global menyediakan beberapa saluran mirror publik:

5.4 Verifikasi Integritas Berkas (SHA256 Checksum)

# Verifikasi checksum berkas unduhan dari repo.alsyundawy.com:
sha256sum PNetLab-27H1-v8-netinstall.ova
sha256sum PNetLab-27H1-v8.12.iso
sha256sum PNetLab-27H1-v8.12.ova
sha256sum pnetlab-27H1-v8.62-6.8.62-resolute-bundle.tgz

# Verifikasi checksum berkas rilis upstream Codeberg / Mega:
sha256sum pnetlab-v8-resolute-*.ova
sha256sum pnetlab-v8-resolute-*.iso

# Cocokkan output hash dengan catatan resmi rilis pada repositori Codeberg / kanal Telegram

5.5 Langkah Cepat Deploy OVA (Netinstall vs Full Turn-Key OVA)

Tersedia dua varian OVA pada repositori mirror ALSYUNDAWY:

1. Varian Netinstall (PNetLab-27H1-v8-netinstall.ova): Appliance VM berukuran minimal. Saat pertama kali dihidupkan, VM akan meminta parameter IP (DHCP/Static) dan menjalankan autoinstaller unattended yang menarik paket rilis terbaru secara online.
2. Varian Full Turn-Key (PNetLab-27H1-v8.12.ova): Appliance VM lengkap dengan seluruh paket PNETLab v8.12 yang telah terpasang di disk. Sangat cocok jika Anda menginginkan VM langsung siap digunakan dalam hitungan menit tanpa bergantung pada koneksi internet cepat.
3. Persyaratan Hardware Virtualization: Pastikan opsi Hardware Virtualization (VT-x / AMD-V) dan Nested Virtualization dicentang aktif di konfigurasi prosesor VM pada VMware / ESXi / Proxmox VE.
4. Setelah VM menyala dan menyelesaikan inisialisasi, akses Web GUI PNETLab melalui browser di https://<host-ip>/.

5.6 Panduan Instalasi Server Fisik / VM via Full ISO (PNetLab-27H1-v8.12.iso)

1. Unduh file ISO PNetLab-27H1-v8.12.iso dari mirror ALSYUNDAWY.
2. Untuk server fisik bare-metal, buat USB bootable menggunakan Ventoy (cukup copy file ISO ke flashdisk) atau gunakan tool seperti Rufus (pilih mode DD Image) / perintah dd if=PNetLab-27H1-v8.12.iso of=/dev/sdX bs=4M status=progress pada Linux/macOS.
3. Pasang USB ke server atau mount ISO sebagai Virtual CD/DVD pada Proxmox / ESXi / Hyper-V.
4. Boot perangkat ke ISO installer, ikuti panduan partisi disk otomatis, tentukan username dan konfigurasi jaringan awal.
5. Reboot host, lepaskan media instalasi, dan akses dashboard web PNETLab.

Bab ini menyajikan panduan resmi dan standar operasional enterprise untuk mengimpor dan menjalankan citra PNETLab v8 Virtual Appliance (.ova) pada hypervisor Proxmox Virtual Environment (PVE) 8 ke atas (PVE 8.0, 8.1, 8.2, 8.3, dan 8.4 berbasis Debian 12 Bookworm dengan Linux Kernel 6.5 / 6.8+). Panduan ini mencakup akselerasi KVM nested, penonaktifan memory ballooning, tuning disk VirtIO SCSI single dengan TRIM/discard, isolasi bridge, dan QEMU Guest Agent.

6.1. Pra-Syarat Host PVE: Verifikasi KVM Nested Virtualization

Karena PNETLab v8 mengeksekusi mesin virtual (Cisco IOL, QEMU, Docker, Arista, Juniper) di dalam dirinya sendiri, host fisik Proxmox VE wajib mengaktifkan Nested Virtualization pada level modul kernel:

# --- [UNTUK PROSESOR INTEL] ---
# Periksa status nested (output wajib: Y atau 1)
cat /sys/module/kvm_intel/parameters/nested

# Jika output N, aktifkan secara permanen:
echo "options kvm-intel nested=Y" | sudo tee /etc/modprobe.d/kvm-intel.conf
sudo modprobe -r kvm_intel && sudo modprobe kvm_intel

# --- [UNTUK PROSESOR AMD] ---
# Periksa status nested (output wajib: 1)
cat /sys/module/kvm_amd/parameters/nested

# Jika output 0, aktifkan secara permanen:
echo "options kvm-amd nested=1" | sudo tee /etc/modprobe.d/kvm-amd.conf
sudo modprobe -r kvm_amd && sudo modprobe kvm_amd

6.2. Unduh Berkas OVA Langsung ke Storage Proxmox VE

Login ke shell host Proxmox VE via SSH atau Web Console, lalu unduh berkas appliance resmi dari dedicated mirror repo.alsyundawy.com langsung ke direktori sementara atau storage dump:

# Masuk ke direktori temporary atau dump storage
cd /var/lib/vz/dump || cd /tmp

# Unduh appliance PNetLab OVA dari dedicated mirror
wget -c https://repo.alsyundawy.com/PnetLab/PNetLab-27H1-v8.12.ova

# Validasi integritas hash SHA256 sebelum ekstraksi
sha256sum PNetLab-27H1-v8.12.ova

6.3. Metode A (Rekomendasi CLI Produksi): Ekstraksi OVA & qm importdisk

Metode ini merupakan standar paling stabil di seluruh versi PVE 8.x karena memberikan kontrol penuh atas arsitektur disk controller, jenis CPU, dan alokasi bus SCSI:

tar -xvf PNetLab-27H1-v8.12.ova
# Menghasilkan berkas: PNetLab-27H1-v8.12.ovf dan disk-001.vmdk
ls -lh *.vmdk *.ovf

qm create 800 --name "PNETLab-v8-Enterprise"   --ostype l26   --cpu host   --cores 8 --sockets 1 --numa 0   --memory 16384 --balloon 0   --scsihw virtio-scsi-single   --net0 virtio,bridge=vmbr0,firewall=0   --agent 1   --machine q35   --onboot 1

qm importdisk 800 *.vmdk local-lvm --format qcow2

qm set 800 --scsi0 local-lvm:vm-800-disk-0,discard=on,ssd=1,iothread=1
qm set 800 --boot order=scsi0

6.4. Metode B: CLI Otomatis qm importovf & Perbaikan Hardware Wajib

Jika Anda mengekstrak OVA dan ingin memanfaatkan berkas konfigurasi .ovf bawaan, jalankan perintah qm importovf secara otomatis:

# 1. Jalankan import OVF ke VM ID 800
qm importovf 800 *.ovf local-lvm --format qcow2

# 2. PERINGATAN KRITIS: qm importovf selalu me-reset CPU ke kvm64 dan controller ke IDE!
# Anda WAJIB memperbaiki hardware profile agar KVM nested dan performa disk optimal:
qm set 800 --cpu host   --scsihw virtio-scsi-single   --balloon 0   --agent 1   --net0 virtio,bridge=vmbr0,firewall=0

6.5. Metode C: Web GUI Import Wizard (Khusus Proxmox VE 8.3+)

Mulai rilis Proxmox VE 8.3, fitur native OVA/OVF Import telah disematkan langsung pada antarmuka Web GUI:

1. Buka Web GUI Proxmox VE: https://<IP-PVE>:8006/.
2. Pilih node PVE Anda → klik storage penyimpanan (contoh: local).
3. Pilih menu ISO Images / CT Templates / Import → klik tombol Import OVA/OVF.
4. Pilih file PNetLab-27H1-v8.12.ova yang telah diunggah → tentukan target storage pool (local-lvm).
5. Pada wizard konfigurasi: ubah CPU Type ke host, matikan Memory Ballooning, dan pastikan network bridge diarahkan ke vmbr0 dengan checkbox Firewall: Unchecked (Disabled).
6. Klik Import dan tunggu hingga progress bar mencapai 100%.

6.6. Checklist Hardening, RAM (Anti-Ballooning) & Virtual Networking PVE

# 1. Nyalakan VM dari shell host Proxmox
qm start 800

# 2. Login ke terminal PNetLab via SSH (user: root) dan jalankan verifikasi:
kvm-ok
# Output wajib yang muncul:
# INFO: /dev/kvm exists
# KVM acceleration can be used

# 3. Pastikan QEMU Guest Agent aktif di dalam PNetLab:
sudo apt update && sudo apt install -y qemu-guest-agent
sudo systemctl enable --now qemu-guest-agent

Skenario yang diuji: Ubuntu 26.04 Resolute amd64, PNETLab 6.8.62resolute1, target channel latest (saat itu 6.8.74resolute1). Jaringan manajemen sudah hidup:

• eth0 → pnet0 (DHCP via dhcpcd)
• bridge pnet1 … pnet9 dan nat0
• konfigurasi administrator di /etc/network/interfaces

6.1 Backup sebelum mutasi

sudo mkdir -p /root/pnetlab-preupgrade-$(date +%F)
sudo cp -a /etc/network/interfaces /etc/network/interfaces.d \
  /root/pnetlab-preupgrade-$(date +%F)/
sudo dpkg -l 'pnetlab*' > /root/pnetlab-preupgrade-$(date +%F)/dpkg-pnetlab.txt
sudo apt-mark showhold > /root/pnetlab-preupgrade-$(date +%F)/held.txt
sudo ufw status verbose > /root/pnetlab-preupgrade-$(date +%F)/ufw.txt || true
sudo iptables-save  > /root/pnetlab-preupgrade-$(date +%F)/iptables.rules
sudo ip6tables-save > /root/pnetlab-preupgrade-$(date +%F)/ip6tables.rules
# Image lab biasanya besar — rsync terpisah ke storage cadangan:
# sudo rsync -aH /opt/unetlab/ /backup/unetlab/

6.2 Metode 1: Built-in Updater (sudo pnetlab-update)

Paket PNetLab v8 menyediakan binary resmi pnetlab-update yang berfungsi memeriksa rilis terbaru dari channel yang dikonfigurasi, mengunduh paket APT baru, dan menerapkannya secara in-place:

sudo pnetlab-update

Perintah ini adalah jalur pembaruan standar yang direkomendasikan README resmi. Selalu periksa changelog rilis sebelum memperbarui host lab produksi.

6.3 Metode 2: Network Installer + --no-cloud-uplink

Jika binary pnetlab-update belum tersedia atau Anda ingin menyinkronkan seluruh generic asset manifest dari awal, gunakan network install script dengan menambahkan flag pelindung --no-cloud-uplink agar konfigurasi bridge manajemen tidak terhapus (lihat pembahasan mendalam di Bab 7):

curl -fsSL https://codeberg.org/api/packages/netkillui/generic/pnetlab-core-assets/0.channel/pnetlab-network-install-latest.sh   | sudo bash -s -- --yes --release latest --no-cloud-uplink

6.4 Metode 3: Manual Upgrade Fallback (dpkg -i + apt-get -f)

Jika mekanisme otomatis tidak dapat berjalan karena batasan jaringan atau kegagalan preflight script, dokumentasi resmi Codeberg menyediakan prosedur instalasi manual paket deb:

# 1. Pastikan backup lab & konfigurasi interfaces sudah aman
# 2. Unduh paket rilis target (.deb) dari repo Codeberg
# 3. Eksekusi install paket secara langsung:
sudo dpkg -i pnetlab_<version>_amd64.deb

# 4. Selesaikan dependensi paket APT yang dibutuhkan:
sudo apt-get -f install

# 5. Reboot dan verifikasi service:
sudo reboot

6.5 Metode 4: Offline Tarball Bundle Upgrade (pnetlab-*-bundle.tgz)

Bagi host PNETLab v8 yang beroperasi pada lingkungan jaringan air-gapped (tanpa akses internet langsung) atau saat koneksi ke repositori upstream Codeberg dibatasi firewall, Anda dapat memanfaatkan berkas arsip bundle offline pnetlab-27H1-v8.62-6.8.62-resolute-bundle.tgz dari mirror ALSYUNDAWY:

# 1. Unduh berkas bundle atau transfer via SCP / WinSCP ke server lab:
wget -c https://repo.alsyundawy.com/PnetLab/pnetlab-27H1-v8.62-6.8.62-resolute-bundle.tgz

# 2. Buat direktori staging sementara dan ekstrak tarball bundle:
mkdir -p /root/pnetlab-bundle-staging
sudo tar -xzvf pnetlab-27H1-v8.62-6.8.62-resolute-bundle.tgz -C /root/pnetlab-bundle-staging

# 3. Masuk ke direktori hasil ekstraksi:
cd /root/pnetlab-bundle-staging

# 4. Jalankan script instalasi bundle jika ada, atau pasang deb in-place:
if [ -f "./install.sh" ]; then
    sudo bash ./install.sh
elif [ -f "./update.sh" ]; then
    sudo bash ./update.sh
else
    sudo dpkg -i *.deb || sudo apt-get -f install -y
fi

# 5. Lakukan perbaikan hak akses file unetlab dan restart service utama:
sudo /opt/unetlab/wrappers/unl_wrapper -a fixpermissions
sudo systemctl restart apache2
sudo systemctl restart mysql 2>/dev/null || sudo systemctl restart mariadb 2>/dev/null
sudo systemctl restart docker 2>/dev/null || true

# 6. Verifikasi paket PNETLab yang terpasang:
dpkg -l | grep -i pnetlab

Percobaan pertama tanpa flag tambahan:

curl -fsSL \
  https://codeberg.org/api/packages/netkillui/generic/pnetlab-core-assets/0.channel/pnetlab-network-install-latest.sh \
  | sudo bash -s -- \
    --yes \
    --release latest

Preflight berhenti:

ERROR: preflight Check A refuses administrator content in /etc/network/interfaces; use --no-cloud-uplink

Artinya installer menolak menimpa desain jaringan yang sudah dikelola admin. Solusi yang benar untuk kasus ini bukan menghapus interfaces, melainkan melewati discovery/handoff uplink:

curl -fsSL \
  https://codeberg.org/api/packages/netkillui/generic/pnetlab-core-assets/0.channel/pnetlab-network-install-latest.sh \
  | sudo bash -s -- \
    --yes \
    --release latest \
    --no-cloud-uplink

Installer akan menyatakan:

Pass 2: --no-cloud-uplink explicitly selected; discovery and handoff are skipped

Setelah Check A lolos, installer resolve rilis (contoh RETEX: release=6.8.74resolute1 sequence=74), verifikasi pointer/manifest, lalu masuk:

=== preflight: exact transaction simulation (last gate before mutation) ===
ERROR: exact apt transaction simulation failed; no package mutation was attempted

Installer tidak menampilkan error APT mentah. Replay simulasi yang sama secara manual. Penyebabnya:

The following held packages will be changed:
  pnetlab-docker
  pnetlab-guacd
  pnetlab-qemu
  pnetlab-schema

E: Held packages were changed and -y was used without --allow-change-held-packages.

Ini bukan konflik dependensi. Transaksi bisa di-resolve; APT hanya menolak mengubah paket hold karena simulasi memakai apt-get install --simulate -y tanpa --allow-change-held-packages. (Catatan: log issue #19 untuk rilis lebih baru sudah menyertakan flag itu pada simulasi — perilaku bisa berubah per patch installer.)

8.1 Konfirmasi diagnosis

sudo apt-get install --simulate -y \
  --allow-change-held-packages \
  ca-certificates \
  curl \
  gnupg \
  iproute2 \
  mysql-server \
  openssl \
  php8.5-fpm \
  python3-pip \
  uml-utilities \
  inotify-tools \
  pnetlab=6.8.74resolute1 \
  pnetlab-docker=6.8.74resolute1 \
  pnetlab-guacd=6.8.74resolute1 \
  pnetlab-qemu=6.8.74resolute1 \
  pnetlab-schema=6.8.74resolute1 \
  pnetlab-vpcs=6.8.74resolute1 \
  docker-ce \
  docker-ce-cli \
  containerd.io \
  docker-buildx-plugin \
  docker-compose-plugin

Ganti pin versi 6.8.74resolute1 dengan rilis yang di-resolve installer Anda (6.8.79resolute1, dst.). Jika simulasi sukses, masalahnya hanya hold.

8.2 Workaround: unhold sementara

apt-mark showhold
sudo apt-mark unhold \
  pnetlab-docker \
  pnetlab-guacd \
  pnetlab-qemu \
  pnetlab-schema

Output yang diharapkan:

Canceled hold on pnetlab-docker.
Canceled hold on pnetlab-guacd.
Canceled hold on pnetlab-qemu.
Canceled hold on pnetlab-schema.

Setelah unhold, jalankan ulang installer dengan flag jaringan:

curl -fsSL \
  https://codeberg.org/api/packages/netkillui/generic/pnetlab-core-assets/0.channel/pnetlab-network-install-latest.sh \
  | sudo bash -s -- \
    --yes \
    --release latest \
    --no-cloud-uplink

Pada RETEX 6.8.74, preflight lolos dan mutasi berjalan. Installer mengklaim sukses untuk:

• Docker runtime verification + Docker-backed node smoke test
• PNETLab broker socket, HTTP bridge, console mux, shell bridge, guac-lite, labstated
• Kehadiran bridge pnet0–pnet9 dan nat0
• Schema verification, HTTPS login, API login

Akhir log:

=== network install completed ===

State paket setelah RETEX 6.8.74:

ii  pnetlab                 6.8.74resolute1
ii  pnetlab-bridge-dkms     6.8.74resolute1
ii  pnetlab-docker          6.8.74resolute1
ii  pnetlab-guacd           6.8.74resolute1
ii  pnetlab-qemu            6.8.74resolute1
ii  pnetlab-schema          6.8.74resolute1
ii  pnetlab-vpcs            6.8.74resolute1

Setelah instalasi:

systemctl --failed

Tiga unit PNETLab yang gagal:

Ketiganya merujuk pohon /opt/unetlab/html/store/ — komponen Store lama yang sudah pensiun. Ini bukan sisa paket pnetlab-store yang terlupakan:

dpkg -S \
  /etc/systemd/system/harddisk_limit.service \
  /etc/systemd/system/mysql_recovery.service \
  /etc/systemd/system/process_limit.service

# Hasil RETEX 6.8.74:
# pnetlab: /etc/systemd/system/harddisk_limit.service
# pnetlab: /etc/systemd/system/mysql_recovery.service
# pnetlab: /etc/systemd/system/process_limit.service

dpkg -L pnetlab | grep -E 'harddisk_limit|mysql_recovery|process_limit'

Isi unit (masih dikirim paket pnetlab)

[Unit]
Description=Update Hard disk status
After=mysql.service

[Service]
ExecStart=/opt/unetlab/html/store/app/Console/Commands/harddisk_limit
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target

[Unit]
Description=Check database
After=mysql.service

[Service]
ExecStart=/usr/bin/php /opt/unetlab/html/store/artisan mysql_recovery run
RemainAfterExit=false

[Install]
WantedBy=multi-user.target

[Unit]
Description=Update RAM CPU status
After=mysql.service

[Service]
ExecStart=/opt/unetlab/html/store/app/Console/Commands/process_limit
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target

Workaround sementara — jangan hapus file milik paket

sudo systemctl disable --now \
  harddisk_limit.service \
  mysql_recovery.service \
  process_limit.service

sudo systemctl reset-failed \
  harddisk_limit.service \
  mysql_recovery.service \
  process_limit.service

systemctl --failed

Pada instalasi bare-metal Ubuntu 26.04 rilis 6.8.78resolute1, proses bootstrap network installer terhenti fatal pada tahap akhir verifikasi service tingkat socket (socket-level verification gate). Laporan primer tercatat pada Codeberg Issue #19 (status: OPEN per 21 September 2026, 0 komentar maintainer upstream):

[2026-09-13 15:16:21+0000] === socket-level service verification (restart-loop proof) ===
[2026-09-13 15:16:21+0000] socket OK: broker unix socket (pnetlab-brokerd.service; NRestarts=0)
[2026-09-13 15:16:22+0000] socket OK: HTTP bridge 127.0.0.1:8025 (pnet-http-bridge.service; NRestarts=0)
[2026-09-13 15:16:22+0000] socket OK: console mux telnet :8022 and VNC :6080 (pnet-console-mux.service; NRestarts=0)
[2026-09-13 15:16:22+0000] socket OK: shell bridge :8023 (pnet-shell-bridge.service; NRestarts=0)
[2026-09-13 15:16:22+0000] ERROR: pnet-guac-lite.service restart-loop evidence: NRestarts=45
[2026-09-13 15:16:22+0000] === network install stopped with exit 1 ===

11.1 Analisis Akar Masalah (Root Cause & Race Condition)

Pemeriksaan kode sumber installer pnetlab-network-install-latest.sh mengungkap mekanisme pembuktian restart-loop:

• Fungsi assert_restart_clean(): Membaca systemctl show -p NRestarts --value "$unit". Jika nilai selain 0, installer langsung mengeksekusi die "$unit restart-loop evidence: NRestarts=...".
• Kondisi Balapan (Race Condition): Paket pnetlab-guacd / pnet-guac-lite di-unpack dan otomatis distart oleh systemd saat transaksi APT berlangsung. Namun berkas lingkungan kunci enkripsi /etc/pnet-webconsole/guac.env (GUAC_CRYPT_KEY) baru dibuat jauh belakangan di fungsi configure_guac_key().
• Akumulasi NRestarts: Selama installer mengunduh image container OCI dari Docker Hub (pnet-capture-web:1.0 yang memakan waktu ~42 detik), unit pnet-guac-lite.service gagal start secara berulang (Restart=always) dan menumpuk NRestarts=45. Bahkan setelah kunci di-generate dan port :8081 akhirnya berhasil listen, nilai counter systemd tetap 45 sehingga fungsi verifikasi menjatuhkan exit 1.

11.2 Perintah Diagnostik di Host Nyata

Jalankan perintah berikut pada terminal server Ubuntu 26.04 untuk memeriksa status rinci daemon HTML5 console:

# 1. Cek status aktif, substate, dan counter restart:
systemctl show -p NRestarts,ActiveState,SubState,Result pnet-guac-lite.service

# 2. Periksa log detail kegagalan start daemon:
sudo journalctl -u pnet-guac-lite.service -n 80 --no-pager

# 3. Cek apakah socket port 8081 sedang mendengarkan:
sudo ss -lntp '( sport = :8081 )'

# 4. Pastikan file kunci enkripsi console valid (panjang 32 karakter base64):
sudo cat /etc/pnet-webconsole/guac.env

11.3 Prosedur Workaround & Reset Counter Systemd

Untuk menormalkan host tanpa mengulang proses install dari nol, buat berkas environment secara manual, reset counter failed systemd, dan restart service:

# Langkah 1: Buat direktori dan kunci enkripsi 32-byte base64 jika belum ada
sudo install -d -m 0755 /etc/pnet-webconsole
if [ ! -s /etc/pnet-webconsole/guac.env ]; then
    GUAC_KEY=$(head -c 24 /dev/urandom | base64 | tr -d '
')
    printf 'GUAC_CRYPT_KEY=%s
' "$GUAC_KEY" | sudo tee /etc/pnet-webconsole/guac.env >/dev/null
    sudo chmod 0600 /etc/pnet-webconsole/guac.env
    sudo chown root:root /etc/pnet-webconsole/guac.env
fi

# Langkah 2: Sinkronisasi kunci ke file config PHP webconsole
if [ -f /etc/pnet-webconsole/console_config.php ]; then
    CURRENT_KEY=$(sed -n 's/^GUAC_CRYPT_KEY=//p' /etc/pnet-webconsole/guac.env | head -n1)
    sudo sed -i "s|define('GUAC_CRYPT_KEY', '[^']*');|define('GUAC_CRYPT_KEY', '$CURRENT_KEY');|"       /etc/pnet-webconsole/console_config.php
fi

# Langkah 3: Reset status failed dan restart service
sudo systemctl daemon-reload
sudo systemctl reset-failed pnet-guac-lite.service guacd.service
sudo systemctl restart guacd.service
sudo systemctl restart pnet-guac-lite.service

# Langkah 4: Validasi bahwa NRestarts telah kembali ke 0
systemctl show -p NRestarts,ActiveState pnet-guac-lite.service
sudo ss -ltnH 'sport = :8081'

Simulasi APT pada RETEX memuat:

The following packages will be REMOVED:
  ufw

# dan menginstal:
iptables-persistent
netfilter-persistent

Jika host PNETLab remote mengandalkan UFW, Anda bisa terkunci setelah transaksi. Simpan aturan sebelum upgrade:

sudo ufw status verbose
sudo iptables-save
sudo ip6tables-save

Port yang biasanya dibutuhkan lab (sesuaikan, jangan buka 1–65535/tcp):

• 22/tcp — SSH manajemen
• 80/tcp & 443/tcp — Web UI / HTTPS
• Console HTML5 / Guacamole sesuai binding installer
• Jangan expose VNC/SPICE/QEMU monitor ke WAN

Karena --no-cloud-uplink, installer sengaja melewati provisioning uplink/NAT:

cloud uplink/NAT : SKIPPED by --no-cloud-uplink.
net.ifnames=0 remains armed by the deb; confirm your own boot-time networking survives the rename.

Jika /etc/network/interfaces bergantung pada nama eth0, pastikan kernel cmdline masih menonaktifkan predictable names. Cek sebelum reboot remote:

cat /proc/cmdline
# cari net.ifnames=0

ip -br addr
ip route
ls /sys/class/net
systemctl is-enabled networking dhcpcd systemd-networkd NetworkManager 2>/dev/null

dpkg -l 'pnetlab*' | awk '/^ii/'
systemctl --failed
systemctl is-active mysql docker php8.5-fpm 2>/dev/null
ip -br link | grep -E 'pnet|nat0'
ss -lntp | egrep ':80|:443|:22'

# Nested virt masih hidup?
grep -E 'vmx|svm' /proc/cpuinfo | wc -l
lsmod | grep -E 'kvm|bridge|tun'

Jika binary update tersedia:

command -v pnetlab-update && sudo pnetlab-update
# Review changelog channel sebelum menerapkan ke host lab produksi

14.3 Daftar Bug Upstream Terverifikasi (Codeberg Issue #17 pada 6.8.77/6.8.78)

Berdasarkan pelacakan bug komunitas pada rilis 6.8.77 dan 6.8.78resolute1, beberapa anomali UI/runtime berikut telah diverifikasi dan perlu diantisipasi operator lab:

• Bug 10 (Canvas Edit Box): Dialog box pengeditan objek/link/teks terkunci di sisi kanan canvas lab dan tidak dapat digeser bebas ke tengah/kiri canvas.
• Bug 20 (Network Watcher Traffic Tooltip): Tooltip indikator tipe traffic jaringan tidak muncul saat cursor diarahkan ke link aktif ketika fitur Network Watcher berjalan.
• Bug 23 (Advanced WAN netem): Konfigurasi delay/jitter/loss WAN (netem) ter-reset otomatis ke nilai awal setiap kali panel pengaturan ditutup.
• Bug 28 (VPC Hostname DNS Resolution): Node VPCS tidak me-resolve hostname via DNS pada perintah ping default. Solusi: gunakan alamat IP langsung atau flag ping yang sesuai.
• Bug 41 / Issue #29 (Alert Badge Running Node): Node lab yang sudah di-stop terkadang masih menampilkan badge status "Running" pada panel Running Labs.

1. Buka https://<IP-manajemen>/ (terima sertifikat self-signed atau pasang cert sendiri).
2. Selesaikan wizard awal. Mode offline komunitas biasanya memakai akun default platform; ganti password segera.
3. Unggah image ke /opt/unetlab/addons/qemu/, iol/, atau lewat UI.
4. Setelah menambah image:

sudo /opt/unetlab/wrappers/unl_wrapper -a fixpermissions
# atau tombol Fix permissions di System settings UI

Uji lab minimal: 2 node (VPCS atau Docker) + satu cloud NAT. Pastikan console HTML5 dan packet capture berfungsi sebelum mengimpor topologi besar.

• Jangan expose UI ke internet tanpa TLS + VPN / allowlist sumber.
• Ganti semua default password; nonaktifkan akun yang tidak dipakai.
• Setelah UFW hilang, tulis aturan iptables-persistent yang setara — atau pasang lagi UFW secara sadar jika Anda tahu konfliknya dengan netfilter-persistent.
• Isolasi bridge lab (pnet1–pnet9) dari jaringan kampus kecuali memang diperlukan.
• Patch OS Resolute secara berkala, tetapi jangan apt full-upgrade membabi buta tanpa snapshot — kernel/DKMS bridge PNETLab sensitif.
• Snapshot VM / ZFS sebelum setiap lompatan channel (6.8.74 → 6.8.79).
• Audit PermitRootLogin: banyak tutorial lawas menyalakannya. Lebih aman key-only + user sudo.

PHASE 1 — Host Ubuntu 26.04

1. OS update, pastikan VT-x/AMD-V, nested virt, hostname, SSH key
2. Snapshot / backup image + interfaces + firewall

PHASE 2 — Fresh ATAU Upgrade (Pilihan Metode)

1. Fresh (Opsi A - Network Install): network installer resmi --yes --release latest pada Ubuntu 26.04 bersih.
2. Fresh (Opsi B - Turn-key OVA / Netinstall OVA): Deploy berkas PNetLab-27H1-v8.12.ova (siap pakai) atau PNetLab-27H1-v8-netinstall.ova dari mirror repo.alsyundawy.com/?berkas=PnetLab.
3. Fresh (Opsi C - Full Standalone ISO): Booting bare-metal server fisik atau VM menggunakan media instalasi PNetLab-27H1-v8.12.iso.
4. Existing Host (Opsi A - Built-in): Jalankan sudo pnetlab-update jika binary sudah tersedia.
5. Existing Host (Opsi B - Jaringan Custom): Gunakan network installer dengan wajib menambahkan flag --no-cloud-uplink.
6. Existing Host (Opsi C - Offline Air-gapped): Ekstraksi dan terapkan paket offline pnetlab-27H1-v8.62-6.8.62-resolute-bundle.tgz.
7. Jika preflight APT gagal: replay simulasi, unhold empat paket (pnetlab-docker/guacd/qemu/schema), lalu jalankan kembali instalasi.

PHASE 3 — Debts pasca-installer

1. Disable unit Store usang + reset-failed
2. Pulihkan/tulis ulang firewall setelah UFW hilang
3. Verifikasi cmdline & nama NIC sebelum reboot

PHASE 4 — Deploy lab

• HTTPS UI, ganti password, fixpermissions, uji 2-node
• Baru impor topologi besar / image vendor