View source for Mikrotik 1: Install GNS3 Arch Linux

Halaman ini mencatat setup lab MikroTik virtual pakai '''GNS3''' di '''Arch Linux''', dari install sampai router pertama bisa nge-ping internet. Semua error yang muncul selama setup juga dicatat, lengkap dengan penyebab dan solusinya.

__TOC__

== Tujuan ==
* Punya lab MikroTik tanpa beli hardware.
* Router virtual bisa diakses dari host (WebFig) dan bisa keluar ke internet.
* Paham istilah dasar: CHR, appliance, template, libvirt, <code>virbr0</code>.

== Konsep dan istilah ==

=== RouterOS dan CHR ===
'''RouterOS''' adalah sistem operasi router MikroTik. '''CHR (Cloud Hosted Router)''' adalah RouterOS versi x86 yang dijalankan sebagai VM.

* Fiturnya sama dengan RouterOS di router fisik: bridge, NAT, firewall, VLAN, OSPF, BGP, VPN.
* Ringan: cukup RAM beberapa ratus MB per router, jadi bisa jalan banyak router sekaligus.
* Lisensi gratis dibatasi upload '''1 Mbps per interface''', tapi semua fitur tetap jalan. Cukup buat belajar.

=== Tools konfigurasi ===
{| class="wikitable"
! Tool !! Keterangan
|-
| '''WebFig''' || Antarmuka web bawaan RouterOS. Tanpa install, cukup buka IP router di browser. Hanya bisa konek lewat IP.
|-
| '''Winbox 4''' || Aplikasi native (Windows, macOS, Linux). Bisa konek lewat '''MAC address''', berguna kalau router belum punya IP.
|-
| '''CLI''' || Lewat console/telnet/SSH. Paling lengkap, dan yang dipakai di halaman ini.
|}

=== GNS3: appliance vs template ===
* '''Template''': perangkat yang siap di-drag ke canvas.
* '''Appliance''': file resep (<code>.gns3a</code>) yang otomatis membuat template, lengkap dengan setting RAM, adapter, console, serta nama file dan checksum image yang dibutuhkan.
* GNS3 '''tidak membawa image''' vendor. Image CHR tetap diambil dari mikrotik.com.

Di katalog appliance ada banyak model MikroTik (CCR, RB, CRS, dll). Buat belajar, cukup pakai '''MikroTik CHR'''.

=== libvirt dan virbr0 ===
* '''libvirt''': lapisan manajemen virtualisasi di Linux (daemon <code>libvirtd</code>, tool <code>virsh</code>). Mengatur VM, storage, dan network virtual.
* '''virbr0''' (''virtual bridge''): switch virtual di host yang dibuat oleh network <code>default</code> libvirt. Fungsinya:
** gateway lab (<code>192.168.122.1</code>),
** DHCP via dnsmasq (range <code>192.168.122.x</code>),
** NAT supaya lab bisa keluar lewat internet host.

Node '''NAT''' di GNS3 memakai <code>virbr0</code> ini.

<pre>
CHR (GNS3) ── NAT node ── virbr0 (host) ── internet
                             │
                     Browser/Winbox di host
</pre>

'''Efek ke host''': koneksi internet asli tidak berubah. libvirt hanya menambah aturan NAT untuk <code>192.168.122.0/24</code>, menyalakan <code>ip_forward</code>, dan menjalankan dnsmasq khusus <code>virbr0</code>. Pastikan subnet ini tidak bentrok dengan jaringan asli.

== Instalasi ==

=== 1. Upgrade sistem ===
<syntaxhighlight lang="bash">
sudo pacman -Syu
</syntaxhighlight>
Wajib, untuk menghindari partial upgrade (lihat [[#Masalah 1: partial upgrade QEMU|Masalah 1]]).

=== 2. Dependensi ===
<syntaxhighlight lang="bash">
paru -S --needed qemu docker vpcs dynamips libvirt ubridge inetutils
</syntaxhighlight>
* <code>--needed</code> melewati paket yang sudah terinstall.
* Kalau <code>qemu-full</code> sudah ada, <code>qemu</code> tidak perlu dipasang lagi.
* <code>vpcs</code>, <code>dynamips</code>, <code>ubridge</code> dari AUR.
* <code>inetutils</code> menyediakan <code>telnet</code> untuk console.

=== 3. GNS3 ===
<syntaxhighlight lang="bash">
paru -S gns3-server gns3-gui
</syntaxhighlight>

=== 4. Group user dan service ===
<syntaxhighlight lang="bash">
for g in ubridge libvirt kvm docker wireshark; do
  getent group $g >/dev/null && sudo gpasswd -a $USER $g || echo "group $g belum ada"
done

sudo systemctl enable --now libvirtd docker
reboot
</syntaxhighlight>
Group <code>wireshark</code> baru ada setelah <code>sudo pacman -S wireshark-qt</code>. Setelah reboot, cek dengan <code>groups</code>.

=== 5. Network default libvirt ===
<syntaxhighlight lang="bash">
sudo virsh net-list --all
# kalau "default" belum ada:
sudo virsh net-define /usr/share/libvirt/networks/default.xml
sudo virsh net-start default
sudo virsh net-autostart default
ip a show virbr0
</syntaxhighlight>
Pakai <code>sudo</code> supaya <code>virsh</code> konek ke koneksi ''system'', bukan ''session''.

=== 6. Console terminal ===
GNS3 default memakai <code>xterm</code>. Pilih salah satu:
* <code>sudo pacman -S xterm</code>, atau
* ganti di '''Edit → Preferences → General → Console applications''', contoh:
<syntaxhighlight lang="text">
kitty --title "%d" telnet %h %p
alacritty -t "%d" -e telnet %h %p
konsole -p tabtitle=%d -e telnet %h %p
</syntaxhighlight>
(<code>%h</code> = host, <code>%p</code> = port, <code>%d</code> = nama node)

=== 7. Template MikroTik CHR ===
# Jalankan <code>gns3</code>, pilih '''Run appliances on my local computer'''.
# '''File → New template → Install an appliance from the GNS3 server'''.
# Cari '''MikroTik CHR''', klik '''Install'''.
# Lihat '''nama file dan versi''' yang diminta wizard (contoh: <code>chr-7.22.1.img</code>).
# Download '''Raw disk image''' versi yang sama dari mikrotik.com, lalu unzip:
<syntaxhighlight lang="bash">
unzip chr-7.22.1.img.zip
md5sum chr-7.22.1.img   # harus sama dengan checksum di wizard
</syntaxhighlight>
# '''Import''' file <code>.img</code> (bukan <code>.zip</code>), lalu Finish.

Template muncul di panel '''Routers'''.

== Hello World ==

=== Router pertama ===
# Drag '''MikroTik CHR''' ke canvas, klik kanan → '''Start'''.
# Double-click node untuk membuka console.
# Login <code>admin</code>, password kosong. Jawab <code>n</code> untuk lisensi, lalu set password baru.

<syntaxhighlight lang="text">
/system identity set name=hello-world
/system resource print
/interface print
</syntaxhighlight>
Prompt berubah jadi <code>[admin@hello-world] ></code>. Hello world selesai.

=== Sambung ke internet ===
# Drag node '''NAT''' ke canvas, sambungkan ke <code>ether1</code> CHR.
# Di console CHR:
<syntaxhighlight lang="text">
/ip dhcp-client print
/ip address print
/ip route print
/ping 192.168.122.1
/ping 8.8.8.8
</syntaxhighlight>
Appliance CHR sudah membawa DHCP client di <code>ether1</code>, jadi menambah lagi akan memunculkan <code>failure: dhcp-client on that interface already exists</code>. Itu normal. (Kalau perlu menambah manual, parameternya <code>disabled=no</code>, bukan <code>disable=no</code>.)

=== Buka WebFig ===
<syntaxhighlight lang="bash">
ping -c 3 192.168.122.212   # ganti dengan IP CHR
</syntaxhighlight>
Lalu buka <code>http://192.168.122.212</code> di browser host. Kalau tidak terbuka, cek <code>/ip service print</code> dan pastikan <code>www</code> tidak disabled.

== Masalah yang ditemui ==

=== Masalah 1: partial upgrade QEMU ===
'''Gejala'''
<pre>
error: failed to prepare transaction (could not satisfy dependencies)
:: installing qemu-common (11.1.2-1) breaks dependency 'qemu-common=11.1.1-1' required by qemu-audio-alsa
...
</pre>
'''Penyebab''': repo sudah punya QEMU 11.1.2, sistem masih 11.1.1. Menginstall <code>qemu</code> menarik <code>qemu-common</code> baru, sedangkan puluhan paket QEMU lain masih mengunci versi lama. Arch tidak mendukung partial upgrade.

'''Solusi''': <code>sudo pacman -Syu</code>, lalu ulangi install dependensi tanpa <code>qemu</code> (sudah ada lewat <code>qemu-full</code>).

=== Masalah 2: gns3server crash, <code>No module named 'langchain'</code> ===
'''Gejala'''
<pre>
CRITICAL gns3server.server:331 Critical error while running the server: No module named 'langchain'
  File ".../gns3server/agent/gns3_copilot/gns3_client/gns3_project_info.py", line 39, in <module>
    from langchain.tools import BaseTool
ModuleNotFoundError: No module named 'langchain'
</pre>
'''Penyebab''': GNS3 versi baru (3.x alpha di AUR) meng-import modul fitur AI copilot/MCP tanpa pengaman, padahal dependensinya opsional dan tidak ikut terinstall. Pola serupa dilaporkan untuk modul <code>mcp</code> di [https://github.com/GNS3/gns3-server/issues/2794 GNS3 issue #2794].

'''Solusi''':
* Install dependensi yang kurang (<code>python-langchain</code>, <code>python-langchain-core</code>, <code>python-mcp</code>, dari repo atau AUR), lalu jalankan <code>gns3server</code> dan ulangi sampai tidak ada <code>ModuleNotFoundError</code> lagi.
* Alternatif: bungkus import tersebut dengan <code>try/except ModuleNotFoundError</code> (hilang saat update), atau pakai versi stabil.

=== Masalah 3: import image CHR gagal ===
'''Gejala'''
<pre>
Cannot install MikroTik CHR version 7.22.1: File chr-7.22.1.img with checksum a67290634f489071eae2fd99dcadba86 not found
The file is compressed with 'zip', it must be uncompressed first
Could not upload image chr-7.22.1.img: File '/home/haidhi/GNS3/images/QEMU/chr-7.22.1.img' already exists
</pre>
'''Penyebab''':
* Yang di-import file <code>.zip</code>, bukan <code>.img</code> hasil unzip.
* Sudah ada file dengan nama sama dari percobaan sebelumnya, sehingga GNS3 menolak menimpa.
* Wizard appliance mencocokkan '''nama file dan checksum''' secara persis.

'''Solusi'''
<syntaxhighlight lang="bash">
file ~/GNS3/images/QEMU/chr-7.22.1.img
md5sum ~/GNS3/images/QEMU/chr-7.22.1.img
# kalau salah:
rm ~/GNS3/images/QEMU/chr-7.22.1.img*
unzip chr-7.22.1.img.zip && md5sum chr-7.22.1.img
</syntaxhighlight>
Lalu ulangi wizard dan import file <code>.img</code>. Kalau versi yang diminta sudah tidak tersedia, buat template QEMU manual (lihat [[#Catatan: template manual|catatan]]).

=== Masalah 4: console tidak terbuka, <code>xterm</code> tidak ada ===
'''Gejala'''
<pre>
Could not start Telnet console with command 'xterm -T "MikroTikCHR-1" -e "telnet localhost 5000"': [Errno 2] No such file or directory: 'xterm'
</pre>
'''Penyebab''': GNS3 default memakai <code>xterm</code>, yang tidak terinstall di Arch.

'''Solusi''': install <code>xterm</code> atau ganti console command (lihat [[#6. Console terminal|langkah 6]]).

=== Masalah 5: <code>NAT interface virbr0 is missing</code> ===
'''Gejala'''
<pre>
Error while creating node from template: NAT interface virbr0 is missing, please install libvirt
</pre>
'''Penyebab''': <code>libvirtd</code> sudah jalan, tapi network <code>default</code> belum dinyalakan, sehingga <code>virbr0</code> belum ada. Daemon hidup ≠ network hidup.

'''Solusi''': [[#5. Network default libvirt|langkah 5]]. Kalau <code>net-start</code> gagal, cek apakah <code>dnsmasq</code> dan <code>iptables-nft</code>/nftables sudah terpasang.

Catatan: baris log <code>Libvirt doesn't support VirtualBox API version ...</code> tidak berbahaya.

'''Kenapa <code>virbr0</code> statusnya DOWN?'''
<pre>
virbr0: <NO-CARRIER,BROADCAST,MULTICAST,UP> ... state DOWN
</pre>
<code>NO-CARRIER</code> berarti belum ada perangkat yang tersambung ke bridge. Begitu node NAT di GNS3 aktif, statusnya berubah jadi UP. Normal.

=== Masalah 6: CHR dapat IP, tapi ping internet timeout ===
'''Gejala'''
<pre>
0 D 192.168.122.212/24  192.168.122.0  ether1  main
/ping 8.8.8.8
  sent=9 received=0 packet-loss=100%
</pre>
DHCP jalan (IP didapat), tapi traffic keluar tidak tembus.

'''Penyebab''': Docker mengatur policy chain <code>FORWARD</code> menjadi <code>DROP</code>, sehingga traffic dari <code>virbr0</code> dibuang sebelum di-NAT keluar.

'''Diagnosis'''
<syntaxhighlight lang="bash">
sysctl net.ipv4.ip_forward          # harus 1
sudo iptables -S FORWARD | head     # cari: -P FORWARD DROP
</syntaxhighlight>

'''Solusi''': izinkan traffic <code>virbr0</code> di chain <code>DOCKER-USER</code> (chain yang memang disediakan Docker untuk aturan user):
<syntaxhighlight lang="bash">
sudo iptables -I DOCKER-USER -i virbr0 -j ACCEPT
sudo iptables -I DOCKER-USER -o virbr0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
</syntaxhighlight>
* Aturan pertama: izinkan traffic yang masuk dari lab.
* Aturan kedua: izinkan balasan yang kembali ke lab.

Aturan ini '''hilang setelah reboot''' atau restart Docker. Jalankan ulang sebelum nge-lab, atau buat permanen nanti.

== Catatan: template manual ==
Kalau tidak memakai appliance:
<syntaxhighlight lang="bash">
qemu-img convert -f raw -O qcow2 chr-*.img chr.qcow2
</syntaxhighlight>
'''Edit → Preferences → QEMU → QEMU VMs → New''':
* Binary: <code>qemu-system-x86_64</code>, RAM: 256 MB, disk: <code>chr.qcow2</code>
* Console: <code>telnet</code>
* Adapter: 4+, tipe <code>virtio-net-pci</code> (ganti <code>e1000</code> kalau interface tidak muncul)
* Advanced: centang '''Use as a linked base VM'''

== Ringkasan ==
{| class="wikitable"
! Masalah !! Penyebab !! Solusi
|-
| Dependency QEMU rusak || Partial upgrade || <code>pacman -Syu</code>
|-
| <code>No module named 'langchain'</code> || Dependensi opsional GNS3 alpha tidak terinstall || Install modul yang kurang
|-
| Image CHR tidak ditemukan || Import <code>.zip</code> / file lama tertinggal / checksum beda || Hapus file lama, unzip, import <code>.img</code>
|-
| <code>xterm</code> tidak ada || Console default GNS3 || Install xterm / ganti console command
|-
| <code>virbr0 is missing</code> || Network <code>default</code> belum start || <code>virsh net-start default</code>
|-
| Ping internet timeout || Docker <code>FORWARD DROP</code> || Aturan <code>DOCKER-USER</code> untuk <code>virbr0</code>
|}