View source for Mikrotik : Scripting Dasar RouterOS

== 🎯 Tujuan ==

Setelah membaca dan mempraktikkan artikel ini, kamu bisa:

* menjelaskan apa itu script RouterOS dan kapan sebaiknya dipakai;
* membedakan variabel lokal dan global beserta batas wilayahnya;
* memakai percabangan (`:if`) dan perulangan (`:foreach`, `:for`);
* menyimpan script ke menu `/system/script` lalu menjalankannya;
* memasang jadwal otomatis lewat `/system/scheduler`;
* membaca log untuk membuktikan script benar-benar bekerja.

Ini pintu masuk otomasi di RouterOS. Setelah bisa menulis script sendiri, pekerjaan berulang seperti cek kapasitas IP atau laporan interface mati tidak perlu diketik ulang tiap pagi.

== 📍 Konteks nyata ==

Bayangkan kamu admin lab di SMK. Setiap Senin pagi ada tiga tugas yang sama: mengecek sisa alamat IP untuk tiga lab, mencari interface mana yang mati, dan memastikan SSID tamu menyala lagi setelah listrik padam akhir pekan.

Dikerjakan manual, urutannya panjang dan mudah terlewat begitu bel masuk berbunyi. Apalagi kalau kamu sedang memperbaiki komputer lain di ruang sebelah.

* '''Analogi:''' perintah CLI itu instruksi lisan, script itu SOP tertulis di dinding. Yang lisan hilang saat orangnya pergi, yang tertulis tetap ada dan bisa diwariskan ke siswa PKL.

🔥 '''Kasus nyata:''' Di sebuah SMK, pool DHCP lab 2 diisi 60 alamat untuk tiga kelas bergantian. Saat ujian CBT dimulai, 12 laptop mendapat alamat `169.254.x.x` — tanda tidak dapat IP.

Penyebabnya bukan router rusak: pool penuh karena perangkat lama belum dilepas, dan tidak ada yang sadar sampai siswa mulai login. Setelah dibuat script yang mencatat jumlah lease dan menulis peringatan saat pemakaian lewat 80 persen, kondisi itu ketahuan dua hari sebelum ujian berikutnya.

== 🧠 Konsep singkat ==

Script RouterOS adalah kumpulan baris perintah yang disimpan sebagai teks di dalam router, lalu dijalankan berurutan dari atas ke bawah. Tidak ada compiler dan tidak ada file Python — semuanya hidup di dalam RouterOS.

=== 🔹 Dari perintah manual ke perintah tersimpan ===

Setiap baris perintah di RouterOS punya bentuk:

<syntaxhighlight lang="text">
[prefix] [path] command [uparam] [param=value] ...
</syntaxhighlight>

Prefix menentukan jenis kata pertama:

| Prefix | Arti | Contoh |
|---|---|---|
| `:` | perintah global bawaan scripting | `:put "halo"` |
| `/` | pindah ke menu konfigurasi | `/ip address print` |
| tanpa prefix | perintah di menu yang sedang aktif | `print` |

Akhir baris perintah ditandai `;` atau baris baru. Tapi perintah di dalam `()`, `[]`, atau `{}` tidak perlu penutup — kurungnya sudah menandai batas.

💡 '''Tips:''' kalau bingung membedakan, ingat saja: `:` untuk bahasa script (variabel, if, loop), `/` untuk menu router (ip, interface, system).

=== 🔹 Tiga bahan yang membuat script hidup ===

* **Variabel** — tempat menyimpan nilai sementara, misalnya nama router atau jumlah lease.
* **Kendali alur** — `:if` untuk memilih, `:foreach` dan `:for` untuk mengulang.
* **Pengambilan data** — tanda `[]` menjalankan perintah lain dan mengambil hasilnya, misalnya `[/system identity get name]`.

Tanpa tiga bahan ini, script hanya daftar perintah yang sama kakunya dengan mengetik manual.

=== 🔹 Scope: kenapa variabel bisa hilang ===

Variabel hanya terlihat di wilayah tempat ia dideklarasikan. Ada dua jenis:

* `:local` — hanya hidup di dalam blok `{}` tempat ia dibuat.
* `:global` — bisa dibaca script lain milik user yang sama.

⚠️ '''Hati-hati:''' setiap baris yang kamu ketik di terminal dianggap satu scope sendiri. Jadi `:local nama "lab"` di satu baris akan hilang di baris berikutnya dan memunculkan `syntax error`. Di dalam file script, satu blok `{}` adalah satu scope.

== 🧩 Istilah penting ==

| Istilah | Arti sederhana |
|---|---|
| Command global | Perintah berawalan `:`, misalnya `:put`, `:local`, `:if`. |
| Scope | Wilayah berlakunya variabel; ditentukan oleh `{}`. |
| Variabel lokal | Variabel yang hanya hidup di blok tempat ia dibuat. |
| Variabel global | Variabel yang bisa dipakai script lain oleh user yang sama. |
| `/system/script` | Gudang penyimpanan script di router. |
| `/system/scheduler` | Penjadwal yang menjalankan script pada waktu tertentu. |
| `on-event` | Isi jadwal: nama script atau perintah langsung. |
| Policy | Daftar izin yang menentukan apa yang boleh dilakukan script. |
| `:put` | Menampilkan nilai ke terminal (hanya berguna saat interaktif). |
| `:log` | Menulis pesan ke log router; ini yang dipakai script terjadwal. |

== 🔧 Praktik: Scripting Dasar RouterOS ==

Lab ini memakai satu router uji. Jangan kerjakan di router produksi yang sedang melayani ujian.

=== 🔹 Persiapan lab ===

# Siapkan router uji (boleh CHR di Proxmox atau perangkat lab).
# Pastikan `/system identity` dan jam router sudah benar.
# Catat konfigurasi awal dengan `/export file=sebelum-scripting`.
# Buka terminal Winbox atau SSH.

=== 🔹 Langkah 1: coba perintah global ===

<syntaxhighlight lang="text">
:put "Halo TKJ"
:put (3 + 4)
:put [:typeof 4]
</syntaxhighlight>

Baris pertama menampilkan teks, baris kedua hasil hitungan, baris ketiga jenis data (`num`). Kalau salah satu baris menghasilkan `syntax error`, cek apakah prefix `:` sudah ikut ditulis.

=== 🔹 Langkah 2: variabel dan teks ===

<syntaxhighlight lang="text">
:local nama "Lab TKJ"
:local versi [/system resource get version]
:put "Router $nama pakai RouterOS $versi"
</syntaxhighlight>

Tanda `$` menyisipkan nilai variabel ke dalam teks. Kamu juga bisa menyambung dengan operator titik:

<syntaxhighlight lang="text">
:put ("Router " . $nama)
</syntaxhighlight>

Nama variabel hanya boleh huruf dan angka. Kalau perlu tanda hubung, bungkus dengan tanda kutip: `:global "nama-router"`.

=== 🔹 Langkah 3: ambil data dari menu RouterOS ===

Tanda `[]` menjalankan perintah dan mengembalikan hasilnya. Ini kunci script yang sadar situasi.

<syntaxhighlight lang="text">
:put [/system identity get name]
:put [/ip dhcp-server lease print count-only]
:foreach i in=[/interface find where running=no] do={
    :local nm [/interface get $i name]
    :put "Interface $nm sedang down"
}
</syntaxhighlight>

Baris terakhir memperkenalkan `:foreach`: untuk setiap interface yang tidak `running`, ambil namanya dan tampilkan. Di lab biasanya interface yang tidak dipakai akan muncul di sini.

📊 '''Angka penting:''' `print count-only` mengembalikan angka, bukan tabel. Ini jauh lebih ringan daripada mengambil seluruh daftar lalu menghitung sendiri.

=== 🔹 Langkah 4: percabangan dengan :if ===

<syntaxhighlight lang="text">
:local total [/ip dhcp-server lease print count-only]
:local batas 50
:if ($total >= $batas) do={
    :put "Pool hampir penuh: $total dari $batas"
} else={
    :put "Masih aman: $total dari $batas"
}
</syntaxhighlight>

Kondisi ditulis di dalam `()`, aksi di dalam `{}`. Operator perbandingan yang tersedia: `=`, `!=`, `<`, `>`, `<=`, `>=`. Untuk logika pakai `&&` (dan), `||` (atau), `!` (bukan). Operator `in` dipakai untuk cek keanggotaan, misalnya `1.1.1.1/32 in 1.0.0.0/8`.

💡 '''Tips:''' tanda sama dengan untuk membandingkan hanya satu (`=`), bukan `==` seperti di bahasa lain. Ini kesalahan paling sering pemula.

=== 🔹 Langkah 5: perulangan :for dan :while ===

<syntaxhighlight lang="text">
:for i from=1 to=3 do={
    :put "Putaran ke-$i"
}

:local coba 0
:while ($coba < 3) do={
    :set coba ($coba + 1)
    :put "Percobaan $coba"
}
</syntaxhighlight>

`:for` cocok untuk jumlah putaran yang sudah pasti. `:while` cocok untuk ulangi sampai kondisi terpenuhi — misalnya menunggu interface naik.

⚠️ '''Hati-hati:''' `:while` tanpa perubahan kondisi akan berputar selamanya dan membuat terminal hang. Selalu ubah variabel penghitung di dalam blok, atau tambahkan batas percobaan.

=== 🔹 Langkah 6: simpan sebagai script ===

<syntaxhighlight lang="text">
/system script add name=cek-pool-dhcp policy=read,write,test source={
    :local nama [/system identity get name]
    :local total [/ip dhcp-server lease print count-only]
    :local batas 50
    :log info ("[$nama] lease terpakai: $total")
    :if ($total >= $batas) do={
        :log warning ("[$nama] pool DHCP hampir penuh: $total / $batas")
    }
}
</syntaxhighlight>

Setelah disimpan, jalankan manual untuk melihat hasilnya:

<syntaxhighlight lang="text">
/system script run cek-pool-dhcp
/log print where topics~"script"
</syntaxhighlight>

Perhatikan perubahan penting: `:put` diganti `:log`. Saat dijalankan scheduler, tidak ada orang yang melihat terminal, jadi satu-satunya bukti kerja script adalah log.

=== 🔹 Langkah 7: jadwalkan dengan scheduler ===

<syntaxhighlight lang="text">
/system scheduler add name=jadwal-cek-pool start-time=07:00:00 interval=1d \
    on-event=cek-pool-dhcp policy=read,write,test
</syntaxhighlight>

Beberapa sifat penting scheduler:

* `start-date` dan `start-time` default ke saat entri dibuat.
* `interval=0s` (default) berarti script jalan sekali saja.
* `interval=1d` berarti berulang tiap 24 jam, tetap mengikuti jam start.
* `start-time=startup` menjalankan script setiap router menyala, tetapi sebelum interface naik.

💡 '''Tips:''' untuk script yang butuh jaringan (ping, email, cek update), tambahkan penunggu di awal:

<syntaxhighlight lang="text">
:local n 0
:while (([:len [/ip route find where dst-address=0.0.0.0/0 active]] = 0) && ($n < 60)) do={
    :delay 5s
    :set n ($n + 1)
}
</syntaxhighlight>

=== 🔹 Langkah 8: bungkus dengan :onerror ===

Script yang error di tengah akan berhenti dan sisa perintah tidak dijalankan. Supaya aman, bungkus bagian berisiko:

<syntaxhighlight lang="text">
:onerror err in={
    :put [:resolve "contoh-domain-tidak-ada.invalid"]
} do={
    :log warning "Gagal resolve: $err"
}
</syntaxhighlight>

Urutan parameter penting: `in=` harus ditulis sebelum `do=`, kalau tidak variabel error tidak terbaca di blok `do`.

=== 🔹 Versi Winbox ===

# Buka **System → Scripts → +**.
# Isi **Name** `cek-pool-dhcp`, lalu tulis isi script di kotak **Source**.
# Buka tab **Policy**, centang hanya yang dibutuhkan (`read`, `write`).
# Klik **Apply**, lalu tombol **Run** untuk uji manual.
# Buka **System → Scheduler → +**, isi **On Event** dengan nama script, atur **Start Time** dan **Interval**.

=== 🔹 Bersih-bersih lab ===

<syntaxhighlight lang="text">
/system scheduler remove [find name=jadwal-cek-pool]
/system script remove [find name=cek-pool-dhcp]
</syntaxhighlight>

Selalu hapus script uji dari router produksi. Script yang lupa dihapus bisa terus menulis log dan mengaburkan masalah asli.

== 🏭 Dipakai di dunia kerja ==

* **Sekolah:** script menjadwalkan SSID tamu menyala pukul 07:00 dan mati pukul 16:00, sekaligus mencatat sisa lease DHCP. Admin tidak perlu mengingat dua hal itu setiap hari, dan guru tidak lagi mengeluh WiFi tamu mati saat rapat.
* **Kantor cabang:** script mengecek default route tiap 10 menit; kalau jalur utama hilang, ia menulis peringatan ke log dan mengirim email ke IT. Tim bisa bertindak sebelum pengguna melapor.
* **ISP/warnet:** script membaca jumlah user aktif hotspot tiap jam dan menulis statistik ke syslog. Dari data itu pemilik melihat jam ramai dan menyiapkan kapasitas, tanpa harus duduk memantau layar.
* **Industri:** script mengekspor konfigurasi tiap malam ke file bertanggal, lalu memangkas file lama. Saat perangkat harus diganti, konfigurasi terbaru sudah tersedia dan waktu henti produksi lebih pendek.
* **Laboratorium virtual:** script memakai `:deserialize` untuk membaca data JSON dari controller dan menyiapkan konfigurasi awal router baru — pola yang sama dipakai untuk provisioning massal.

== ✅ Verifikasi ==

Jalankan pemeriksaan ini setelah lab:

<syntaxhighlight lang="text">
/system script print detail where name=cek-pool-dhcp
/system script run cek-pool-dhcp
/log print where topics~"script"
/system scheduler print detail where name=jadwal-cek-pool
</syntaxhighlight>

Yang harus terlihat:

* script muncul dengan `policy=read,write,test` sesuai yang kamu beri;
* setelah `run`, ada baris log berisi nama router dan jumlah lease;
* scheduler menampilkan `run-count` bertambah dan `next-run` terisi;
* tidak ada pesan `not enough permissions` di log.

🧪 '''Uji cepat:''' ubah sementara `batas` menjadi `1`, jalankan script, dan pastikan log `warning` muncul. Kalau peringatan tidak muncul, masalahnya ada di kondisi `:if`, bukan di scheduler.

== ⚠️ Kesalahan umum & troubleshooting ==

| Gejala | Penyebab | Perbaikan |
|---|---|---|
| `syntax error` di baris kedua | `:local` dideklarasikan di baris terminal sebelumnya | Tulis dalam satu blok `{}` atau pakai `:global` |
| `bad command name` | Prefix `:` atau `/` lupa ditulis | Periksa kata pertama baris |
| Script jalan, log kosong | Memakai `:put` di script terjadwal | Ganti dengan `:log info` atau `:log warning` |
| `not enough permissions (9)` | Policy script atau scheduler kurang | Tambah policy yang dibutuhkan (`read`, `write`, `test`) |
| Script jalan dua kali bersamaan | Interval lebih pendek dari durasi script | Perpanjang interval atau pasang penjaga `:jobname` |
| Perintah setelah satu baris tidak jalan | Satu baris error menghentikan seluruh script | Bungkus bagian rawan dengan `:onerror` |
| Ping atau email gagal hanya saat startup | Interface belum naik | Tambahkan loop tunggu seperti di Langkah 7 |
| Variabel error kosong di `:onerror` | Urutan `in=` dan `do=` tertukar | Tulis `in=` lebih dulu |
| Script tidak bisa disimpan | Isi melebihi batas editor sekitar 30 ribu karakter | Pecah jadi beberapa script |
| `no such item` | Nama script salah atau belum dibuat | Cek `/system script print` |

🔥 '''Kasus nyata:''' Sebuah lab sekolah memasang script notifikasi dengan `:put` lalu bingung karena tidak ada hasil. Script sebenarnya berjalan sempurna — hanya saja output `:put` masuk ke terminal yang tidak ada saat dijalankan scheduler. Setelah diganti `:log warning`, pesan langsung muncul di menu Log dan bisa dibaca dari Winbox.

== 🔐 Catatan keamanan & etika ==

* **Beri policy seperlunya.** Script yang hanya membaca cukup `read`; jangan langsung memberi `sensitive` atau `reboot`.
* **Jangan simpan password di dalam script.** Isi script ikut terbaca di `/export`, Winbox, dan backup. Kalau perlu rahasia, gunakan mekanisme terpisah dan batasi akses user.
* **Batasi siapa yang boleh menulis script.** User dengan policy `write` dan `policy` bisa mengubah perilaku router secara permanen.
* **Review sebelum menempel.** Jangan menyalin script dari internet lalu menjalankannya di router produksi tanpa membaca isinya.
* **Uji di lab, bukan saat ujian.** Script yang salah bisa mematikan interface atau menghapus aturan firewall di tengah jam layanan.
* **Jaga log tetap berguna.** Script yang menulis log tiap detik akan menutupi pesan penting. Pilih interval yang wajar.

== 📌 Kesimpulan ==

Script RouterOS adalah cara mengubah perintah manual menjadi prosedur yang bisa dijalankan siapa saja, kapan saja. Kuncinya hanya tiga: variabel untuk menyimpan nilai, kendali alur untuk mengambil keputusan, dan `[]` untuk membaca keadaan router.

Mulai dari script kecil yang menulis satu baris log. Setelah itu tambahkan penjadwalan, penanganan error, dan policy yang tepat. Jangan mulai dari script panjang yang belum kamu pahami.

Langkah berikutnya: pelajari cara mengukur throughput dengan **Bandwidth Test**, supaya script yang kamu buat bisa dipakai memantau kualitas jalur, bukan hanya mencatat kejadian.

== 🔗 Materi terkait ==

* [[Mikrotik : Backup dan Export Konfigurasi]] — memahami isi file `.rsc` yang juga menyimpan script.
* [[Mikrotik : Praktikum Backup Otomatis dengan System Scheduler]] — penerapan scheduler untuk backup terjadwal.
* [[Mikrotik : Monitoring Dasar dengan Torch Traffic Log dan Resource]] — membaca log dan resource yang jadi bahan script.
* [[Mikrotik : Failover Koneksi dengan Netwatch dan Recursive Route]] — contoh script yang dipicu kondisi jaringan.
* [[Mikrotik : Praktikum Membuat User dan Group di RouterOS]] — mengatur policy user yang membatasi script.
* [[Mikrotik : Hotspot Dasar]] — objek yang sering diotomasi dengan script (voucher, profil, jadwal).

== 📚 Referensi ==

* MikroTik, [Scripting](https://manual.mikrotik.com/docs/developer-guides/scripting/) — manual resmi bahasa scripting RouterOS.
* MikroTik, [Scripting Tips and Tricks](https://manual.mikrotik.com/docs/developer-guides/scripting/scripting-tips-and-tricks).
* MikroTik, [Scheduler](https://manual.mikrotik.com/docs/system-information-and-utilities/scheduler/) — perilaku `start-time`, `interval`, dan policy.
* MikroTik, [CLI Reference: /system/scheduler](https://manual.mikrotik.com/docs/cli-reference/system/scheduler).
* MikroTik, [Log](https://manual.mikrotik.com/docs/diagnostics-monitoring-and-troubleshooting/log/).

[[Category:TKJ]]
[[Category:Jaringan]]
[[Category:Mikrotik]]