Instalasi¶

Instalasi mengubah Debian 12 biasa menjadi CID Router. Installer memasang VPP, FRR, CLI, dan service boot.

1. Ambil kode¶

git clone https://github.com/computingid/router.git

cd router

2. Lihat NIC yang ada¶

sudo ./install.sh

Tanpa opsi --ports, installer memasang semua paket lalu menampilkan daftar NIC beserta perannya:

Kernel       PCI            Driver         MAC                Role
enp0s3       0000:00:03.0   virtio-pci     52:54:00:00:01:03  management (has default route)
enp0s4       0000:00:04.0   virtio-pci     52:54:00:00:01:04
enp0s5       0000:00:05.0   virtio-pci     52:54:00:00:01:05

3. Serahkan NIC dataplane ke VPP¶

Nama kernelPilih nama sendiriAlamat PCI

sudo ./install.sh --ports enp0s4,enp0s5

enp0s4 menjadi eth1 dan enp0s5 menjadi eth2.

sudo ./install.sh --ports enp0s4=eth1,enp0s5=eth2

sudo ./install.sh --ports 0000:00:04.0=eth1,0000:00:05.0=eth2

Alamat PCI tetap valid walaupun NIC sudah dipegang VPP, jadi cocok untuk install ulang.

Lalu reboot, supaya hugepages dicadangkan dengan bersih:

sudo reboot

Tanpa reboot

Tambahkan --now untuk langsung menyalakan semua service.

Apa yang dilakukan installer¶

Memasang paket dasar (python3, iproute2, frr, frr-pythontools, dan lainnya) serta repository fd.io, lalu memasang vpp, vpp-plugin-core, dan vpp-plugin-dpdk. VPP sengaja tidak dijalankan saat paketnya dipasang, karena konfigurasi bawaannya akan mengambil semua NIC yang sedang down.
Menyalin program ke /usr/lib/cidr dan /usr/sbin, service systemd, dan konfigurasi default /config/config.boot.
Mengatur kernel: hugepages (default 512 × 2 MB), buffer netlink besar untuk FRR dan VPP, serta modul vfio-pci, uio_pci_generic, vhost_net, dan tun.
Menyiapkan grup cidr-users, aturan sudo untuk CLI, folder SSH key /etc/cidr/ssh-keys, dan perintah cli.
Pada instalasi pertama saja, mengatur password root ke default pabrik (kosong). Lihat Login pertama.
Membuat /etc/cidr/dataplane.conf dari --ports. Core dan buffer diset auto.

Opsi installer¶

Opsi	Default	Fungsi
`--ports LIST`		NIC untuk VPP: nama kernel atau alamat PCI, bisa diberi nama (`ens4=eth1`)
`--driver NAME`	`dpdk`	`dpdk` (cepat) atau `af-packet` (jalan di mana saja)
`--workers LIST`	`auto`	Core worker VPP, misalnya `2-5`, atau `none`
`--main-core N`	`auto`	Core thread utama VPP
`--hugepages N`	`512`	Jumlah hugepage 2 MB
`--main-heap SIZE`	`1G`	Heap utama VPP
`--keep-root-password`		Instalasi pertama: jangan reset password root
`--now`		Nyalakan service sekarang, tanpa reboot
`--skip-packages`		Tidak menyentuh apt (untuk upgrade kode saja)

Upgrade¶

Ambil kode terbaru, lalu jalankan installer lagi:

git pull

sudo ./install.sh --skip-packages --now

Menjalankan installer lagi tidak mengubah password root, user, konfigurasi, atau port dataplane. File dataplane.conf dari versi lama otomatis dibaca sebagai auto untuk core dan buffer.

Langkah berikutnya¶

Login