Installer & tools¶

install.sh¶

sudo ./install.sh [opsi]

Opsi	Default	Fungsi
`--ports LIST`		NIC untuk VPP: `ens4,ens5`, `ens4=eth1`, atau `0000:00:04.0=eth1`
`--driver NAME`	`dpdk`	`dpdk` atau `af-packet`
`--workers LIST`	`auto`	CPU worker, atau `none`
`--main-core N`	`auto`	CPU thread utama VPP
`--hugepages N`	`512`	Hugepage 2 MB
`--main-heap SIZE`	`1G`	Heap utama VPP
`--keep-root-password`		Instalasi pertama: jangan reset password root ke kosong
`--now`		Langsung nyalakan service (tanpa reboot)
`--skip-packages`		Lewati apt (upgrade kode saja)

Installer aman dijalankan berulang. Password root hanya diubah pada instalasi pertama (penandanya /etc/cidr/installed), dan konfigurasi tidak disentuh.

cidr-dataplane¶

Perintah	Fungsi
`cidr-dataplane detect`	Daftar NIC beserta perannya (management, port VPP)
`cidr-dataplane init --ports LIST [--driver] [--workers] [--main-core] [--buffers] [--main-heap] [--force]`	Tulis `dataplane.conf`
`cidr-dataplane render`	Tulis ulang `startup.conf` dan bootstrap
`cidr-dataplane prepare`	Render + siapkan NIC (dijalankan systemd sebelum VPP)
`cidr-dataplane show [--startup]`	Tampilkan `dataplane.conf` (dan hasil render)
`cidr-dataplane load [--json] [--check]`	Beban per worker; `--check` keluar dengan kode 1 kalau koneksi tidak terbagi

--force mengizinkan NIC yang membawa default route ikut diambil. Hati-hati: akses SSH lewat NIC itu akan putus.

cidr-cli¶

cidr-cli                        # interaktif
cidr-cli -c "cmd1; cmd2"        # jalankan lalu keluar
cidr-cli -f file.txt            # dari file (dibaca dengan hak Anda, bukan root)
cli                             # alias untuk root

User router menjalankan CLI lewat sudo, dan CLI membatasi perintah sesuai kelasnya.

cidr-apply¶

cidr-apply --boot               # terapkan config.boot (dipakai systemd)
cidr-apply --dry-run            # tampilkan aksi tanpa menjalankannya
cidr-apply --file x.boot        # terapkan file lain

Mode dry-run (pengembangan)¶

CIDR_DRY_RUN=1 CIDR_CONFIG_DIR=/tmp/cidr CIDR_RUN_DIR=/tmp/cidr/run CIDR_ETC_DIR=/tmp/cidr/etc ./bin/cidr-cli

Semua aksi hanya dicetak, tidak dijalankan. Berguna untuk mencoba CLI tanpa VPP. Variabel CIDR_* lainnya ada di cidr/paths.py.