m Protected "Mikrotik : Scripting Dasar RouterOS": Proteksi editorial: edit/move sysop ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))
Perbaiki format: konversi Markdown ke wikitext (bold, code, tabel)
 
Line 5: Line 5:
* menjelaskan apa itu script RouterOS dan kapan sebaiknya dipakai;
* menjelaskan apa itu script RouterOS dan kapan sebaiknya dipakai;
* membedakan variabel lokal dan global beserta batas wilayahnya;
* membedakan variabel lokal dan global beserta batas wilayahnya;
* memakai percabangan (`:if`) dan perulangan (`:foreach`, `:for`);
* memakai percabangan (<code>:if</code>) dan perulangan (<code>:foreach</code>, <code>:for</code>);
* menyimpan script ke menu `/system/script` lalu menjalankannya;
* menyimpan script ke menu <code>/system/script</code> lalu menjalankannya;
* memasang jadwal otomatis lewat `/system/scheduler`;
* memasang jadwal otomatis lewat <code>/system/scheduler</code>;
* membaca log untuk membuktikan script benar-benar bekerja.
* membaca log untuk membuktikan script benar-benar bekerja.


Line 20: Line 20:
* '''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.
* '''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.
🔥 '''Kasus nyata:''' Di sebuah SMK, pool DHCP lab 2 diisi 60 alamat untuk tiga kelas bergantian. Saat ujian CBT dimulai, 12 laptop mendapat alamat <code>169.254.x.x</code> — 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.
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.
Line 38: Line 38:
Prefix menentukan jenis kata pertama:
Prefix menentukan jenis kata pertama:


| Prefix | Arti | Contoh |
{| class="wikitable"
|---|---|---|
! Prefix !! Arti !! Contoh
| `:` | perintah global bawaan scripting | `:put "halo"` |
|-
| `/` | pindah ke menu konfigurasi | `/ip address print` |
| <code>:</code> || perintah global bawaan scripting || <code>:put "halo"</code>
| tanpa prefix | perintah di menu yang sedang aktif | `print` |
|-
| <code>/</code> || pindah ke menu konfigurasi || <code>/ip address print</code>
|-
| tanpa prefix || perintah di menu yang sedang aktif || <code>print</code>
|}


Akhir baris perintah ditandai `;` atau baris baru. Tapi perintah di dalam `()`, `[]`, atau `{}` tidak perlu penutup — kurungnya sudah menandai batas.
Akhir baris perintah ditandai <code>;</code> atau baris baru. Tapi perintah di dalam <code>()</code>, <code>[]</code>, atau <code>{}</code> 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).
💡 '''Tips:''' kalau bingung membedakan, ingat saja: <code>:</code> untuk bahasa script (variabel, if, loop), <code>/</code> untuk menu router (ip, interface, system).


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


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


Tanpa tiga bahan ini, script hanya daftar perintah yang sama kakunya dengan mengetik manual.
Tanpa tiga bahan ini, script hanya daftar perintah yang sama kakunya dengan mengetik manual.
Line 60: Line 64:
Variabel hanya terlihat di wilayah tempat ia dideklarasikan. Ada dua jenis:
Variabel hanya terlihat di wilayah tempat ia dideklarasikan. Ada dua jenis:


* `:local` — hanya hidup di dalam blok `{}` tempat ia dibuat.
* <code>:local</code> — hanya hidup di dalam blok <code>{}</code> tempat ia dibuat.
* `:global` — bisa dibaca script lain milik user yang sama.
* <code>:global</code> — 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.
⚠️ '''Hati-hati:''' setiap baris yang kamu ketik di terminal dianggap satu scope sendiri. Jadi <code>:local nama "lab"</code> di satu baris akan hilang di baris berikutnya dan memunculkan <code>syntax error</code>. Di dalam file script, satu blok <code>{}</code> adalah satu scope.


== 🧩 Istilah penting ==
== 🧩 Istilah penting ==


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


== 🔧 Praktik: Scripting Dasar RouterOS ==
== 🔧 Praktik: Scripting Dasar RouterOS ==
Line 87: Line 102:


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


Line 99: Line 114:
</syntaxhighlight>
</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.
Baris pertama menampilkan teks, baris kedua hasil hitungan, baris ketiga jenis data (<code>num</code>). Kalau salah satu baris menghasilkan <code>syntax error</code>, cek apakah prefix <code>:</code> sudah ikut ditulis.


=== 🔹 Langkah 2: variabel dan teks ===
=== 🔹 Langkah 2: variabel dan teks ===
Line 109: Line 124:
</syntaxhighlight>
</syntaxhighlight>


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


<syntaxhighlight lang="text">
<syntaxhighlight lang="text">
Line 115: Line 130:
</syntaxhighlight>
</syntaxhighlight>


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


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


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


<syntaxhighlight lang="text">
<syntaxhighlight lang="text">
Line 130: Line 145:
</syntaxhighlight>
</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.
Baris terakhir memperkenalkan <code>:foreach</code>: untuk setiap interface yang tidak <code>running</code>, 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.
📊 '''Angka penting:''' <code>print count-only</code> mengembalikan angka, bukan tabel. Ini jauh lebih ringan daripada mengambil seluruh daftar lalu menghitung sendiri.


=== 🔹 Langkah 4: percabangan dengan :if ===
=== 🔹 Langkah 4: percabangan dengan :if ===
Line 146: Line 161:
</syntaxhighlight>
</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`.
Kondisi ditulis di dalam <code>()</code>, aksi di dalam <code>{}</code>. Operator perbandingan yang tersedia: <code>=</code>, <code>!=</code>, <code><</code>, <code>></code>, <code><=</code>, <code>>=</code>. Untuk logika pakai <code>&&</code> (dan), <code>&#124;&#124;</code> (atau), <code>!</code> (bukan). Operator <code>in</code> dipakai untuk cek keanggotaan, misalnya <code>1.1.1.1/32 in 1.0.0.0/8</code>.


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


=== 🔹 Langkah 5: perulangan :for dan :while ===
=== 🔹 Langkah 5: perulangan :for dan :while ===
Line 164: Line 179:
</syntaxhighlight>
</syntaxhighlight>


`:for` cocok untuk jumlah putaran yang sudah pasti. `:while` cocok untuk ulangi sampai kondisi terpenuhi — misalnya menunggu interface naik.
<code>:for</code> cocok untuk jumlah putaran yang sudah pasti. <code>:while</code> 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.
⚠️ '''Hati-hati:''' <code>:while</code> 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 ===
=== 🔹 Langkah 6: simpan sebagai script ===
Line 189: Line 204:
</syntaxhighlight>
</syntaxhighlight>


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


=== 🔹 Langkah 7: jadwalkan dengan scheduler ===
=== 🔹 Langkah 7: jadwalkan dengan scheduler ===
Line 200: Line 215:
Beberapa sifat penting scheduler:
Beberapa sifat penting scheduler:


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


💡 '''Tips:''' untuk script yang butuh jaringan (ping, email, cek update), tambahkan penunggu di awal:
💡 '''Tips:''' untuk script yang butuh jaringan (ping, email, cek update), tambahkan penunggu di awal:
Line 227: Line 242:
</syntaxhighlight>
</syntaxhighlight>


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


=== 🔹 Versi Winbox ===
=== 🔹 Versi Winbox ===


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


=== 🔹 Bersih-bersih lab ===
=== 🔹 Bersih-bersih lab ===
Line 248: Line 263:
== 🏭 Dipakai di dunia kerja ==
== 🏭 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.
* '''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.
* '''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.
* '''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.
* '''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.
* '''Laboratorium virtual:''' script memakai <code>:deserialize</code> untuk membaca data JSON dari controller dan menyiapkan konfigurasi awal router baru — pola yang sama dipakai untuk provisioning massal.


== ✅ Verifikasi ==
== ✅ Verifikasi ==
Line 267: Line 282:
Yang harus terlihat:
Yang harus terlihat:


* script muncul dengan `policy=read,write,test` sesuai yang kamu beri;
* script muncul dengan <code>policy=read,write,test</code> sesuai yang kamu beri;
* setelah `run`, ada baris log berisi nama router dan jumlah lease;
* setelah <code>run</code>, ada baris log berisi nama router dan jumlah lease;
* scheduler menampilkan `run-count` bertambah dan `next-run` terisi;
* scheduler menampilkan <code>run-count</code> bertambah dan <code>next-run</code> terisi;
* tidak ada pesan `not enough permissions` di log.
* tidak ada pesan <code>not enough permissions</code> 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.
🧪 '''Uji cepat:''' ubah sementara <code>batas</code> menjadi <code>1</code>, jalankan script, dan pastikan log <code>warning</code> muncul. Kalau peringatan tidak muncul, masalahnya ada di kondisi <code>:if</code>, bukan di scheduler.


== ⚠️ Kesalahan umum & troubleshooting ==
== ⚠️ Kesalahan umum & troubleshooting ==


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


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


== 🔐 Catatan keamanan & etika ==
== 🔐 Catatan keamanan & etika ==


* **Beri policy seperlunya.** Script yang hanya membaca cukup `read`; jangan langsung memberi `sensitive` atau `reboot`.
* '''Beri policy seperlunya.''' Script yang hanya membaca cukup <code>read</code>; jangan langsung memberi <code>sensitive</code> atau <code>reboot</code>.
* **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.
* '''Jangan simpan password di dalam script.''' Isi script ikut terbaca di <code>/export</code>, 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.
* '''Batasi siapa yang boleh menulis script.''' User dengan policy <code>write</code> dan <code>policy</code> bisa mengubah perilaku router secara permanen.
* **Review sebelum menempel.** Jangan menyalin script dari internet lalu menjalankannya di router produksi tanpa membaca isinya.
* '''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.
* '''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.
* '''Jaga log tetap berguna.''' Script yang menulis log tiap detik akan menutupi pesan penting. Pilih interval yang wajar.


== 📌 Kesimpulan ==
== 📌 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.
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 <code>[]</code> 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.
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.
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 ==
== 🔗 Materi terkait ==


* [[Mikrotik : Backup dan Export Konfigurasi]] — memahami isi file `.rsc` yang juga menyimpan script.
* [[Mikrotik : Backup dan Export Konfigurasi]] — memahami isi file <code>.rsc</code> yang juga menyimpan script.
* [[Mikrotik : Praktikum Backup Otomatis dengan System Scheduler]] — penerapan scheduler untuk backup terjadwal.
* [[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 : Monitoring Dasar dengan Torch Traffic Log dan Resource]] — membaca log dan resource yang jadi bahan script.
Line 321: Line 347:
* MikroTik, [Scripting](https://manual.mikrotik.com/docs/developer-guides/scripting/) — manual resmi bahasa scripting RouterOS.
* 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, [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, [Scheduler](https://manual.mikrotik.com/docs/system-information-and-utilities/scheduler/) — perilaku <code>start-time</code>, <code>interval</code>, dan policy.
* MikroTik, [CLI Reference: /system/scheduler](https://manual.mikrotik.com/docs/cli-reference/system/scheduler).
* 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/).
* MikroTik, [Log](https://manual.mikrotik.com/docs/diagnostics-monitoring-and-troubleshooting/log/).

Latest revision as of 08:48, 28 October 2026

🎯 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:

[prefix] [path] command [uparam] [param=value] ...

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

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

🔹 Langkah 1: coba perintah global

:put "Halo TKJ"
:put (3 + 4)
:put [:typeof 4]

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

:local nama "Lab TKJ"
:local versi [/system resource get version]
:put "Router $nama pakai RouterOS $versi"

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

:put ("Router " . $nama)

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.

: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"
}

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

: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"
}

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

: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"
}

: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

/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")
    }
}

Setelah disimpan, jalankan manual untuk melihat hasilnya:

/system script run cek-pool-dhcp
/log print where topics~"script"

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

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

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:

: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)
}

🔹 Langkah 8: bungkus dengan :onerror

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

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

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

🔹 Versi Winbox

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

🔹 Bersih-bersih lab

/system scheduler remove [find name=jadwal-cek-pool]
/system script remove [find name=cek-pool-dhcp]

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:

/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

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

📚 Referensi