Troubleshooting

Langkah pertama

admin@r1> show log                     # log service router
admin@r1> show dataplane               # port, CPU, buffer, peringatan
admin@r1> show interfaces
admin@r1> show vpp errors              # counter drop/error di VPP

Dari shell root:

journalctl -u cidr-dataplane -u vpp -u cidr-config -u frr -b

systemctl status vpp cidr-config

Dataplane

show interfaces menampilkan missing

VPP tidak berhasil mengambil NIC, atau cermin linux-cp belum terbentuk.

1. systemctl status vpp: apakah VPP berjalan, atau crash-loop?
2. journalctl -u vpp -b: cari baris dpdk: atau invalid.
3. vppctl show pci: kalau NIC tampil dengan driver <NONE>, berarti NIC sudah dilepas dari kernel tetapi DPDK gagal memakainya. Cek baris uio-driver di journalctl -u cidr-dataplane.
4. cidr-dataplane show --startup: periksa blok dpdk { dev ... }.

lcp create ... failed (-11)

Modul vhost_net tidak tersedia, padahal linux-cp memakai tap berbasis vhost.

modprobe vhost_net && ls -l /dev/vhost-net

VPP crash saat NAT diaktifkan

Main heap terlalu kecil untuk tabel sesi NAT. Pastikan main-heap = 1G (atau lebih) di /etc/cidr/dataplane.conf, lalu restart dataplane.

Peringatan: packet buffers tidak muat di hugepages

Port dan worker banyak, tetapi hugepages sedikit. Pesannya menyebutkan jumlah hugepages yang dibutuhkan:

sudo ./install.sh --skip-packages --hugepages 2048

lalu reboot.

Worker tidak terbagi rata (show dataplane load)

• Uji dengan banyak koneksi (32 atau lebih). Sedikit koneksi memang bisa timpang.
• Uji melewati router, bukan dari router.
• show dataplane queues: setiap port harus rss atau handoff l4, bukan off atau single worker.
• show dataplane: apakah worker-nya memang lebih dari satu?

Konektivitas

Ping antar router gagal

admin@r1> show vpp interface          # link up? counter rx/tx bertambah?
admin@r1> show vpp ip neighbors       # ARP terjawab?
admin@r1> show vpp lcp                # pasangan linux-cp ada?
admin@r1> show vpp errors

VLAN tidak jalan

• Kedua sisi memakai VLAN ID yang sama.
• show vpp interface features eth1: port induk harus promiscuous. Router mengaturnya otomatis selama port itu punya VLAN.
• Di Proxmox/QEMU, NIC virtio membuang frame ber-tag kecuali port promiscuous. Router sudah menangani ini.

Route ada di show ip route tapi tidak di show ip fib

• Next-hop harus bisa dijangkau lewat interface dataplane. Route lewat port management tidak disalin ke VPP.
• journalctl -u frr -b dan show log.

Ping dari router mendapat balasan aneh (wrong data byte, DUP!)

Tujuan tersebut tidak punya route di dataplane, sehingga paket dari router keluar lewat default route management. Trafik pelanggan tidak terpengaruh. Tambahkan route yang benar. Isolasi penuh (VRF management) direncanakan di v0.2.

Konfigurasi

commit ditolak: running configuration was changed by another session

Ada admin lain yang commit setelah Anda masuk configure. Jalankan show | compare untuk melihat bedanya, discard, lalu ulangi perubahan Anda.

commit failed, lalu konfigurasi kembali

Itu rollback otomatis. Pesan di bawahnya menunjukkan aksi yang gagal. Perbaiki penyebabnya, lalu commit lagi.

Perubahan hilang setelah reboot

Anda lupa save. commit hanya mengubah sistem yang berjalan.

Login

Tidak bisa SSH sebagai root

Root dengan password kosong hanya bisa login di console. Set password root (set system root-authentication ...) atau pakai SSH key. Cek juga service ssh root-login.

permission denied untuk configure

Kelas user Anda bukan super-user. Lihat User & akses.

Lab

lab.sh start sangat lambat

Tanpa KVM, QEMU memakai emulasi. Pastikan /dev/kvm ada dan user ada di grup kvm.

Jendela VM tidak muncul

Cek $DISPLAY. Paksa VNC dengan VM_DISPLAY=vnc, lalu lab.sh view r1. Log QEMU ada di ~/cidr-lab/r1.log.

DPDK tidak bisa memakai NIC di VM

Coba driver af-packet: DRIVER=af-packet tests/qemu/lab.sh install r1.