Lewati ke isi

GenieACS untuk Modem CPE

GenieACS adalah server TR-069 (CWMP) — protokol industri standar yang memungkinkan Anda kelola modem pelanggan dari jauh tanpa harus datang ke lokasi.

Dengan GenieACS yang sudah ter-integrasi di TB Radius, Anda bisa:

  • 📡 Lihat status modem real-time (online/offline, sinyal optik, uptime)
  • 🔧 Auto-config modem baru saat pertama kali nyala
  • 📶 Ganti WiFi SSID/password pelanggan dari dashboard (atau pelanggan via portal)
  • 🔄 Reboot modem remote kalau ada issue
  • 📊 Monitoring optical power, MAC client, traffic
  • 🚨 Alert otomatis kalau modem offline > 5 menit

Kapan Pakai GenieACS?

Skenario Pakai GenieACS?
ISP fiber dengan modem ONU (Huawei, ZTE, Hwtc, Fiberhome) ✅ Wajib
ISP wireless (Mikrotik wAP, UBNT) ❌ Biasanya tidak — pakai API langsung
ISP yang share router pelanggan (modem-router combo) ✅ Sangat berguna
Pelanggan pakai modem sendiri (BYO) ❌ Skip — Anda tidak punya akses TR-069

Modem yang Didukung

GenieACS support semua modem yang implement protokol TR-069 (CWMP). Brand & vendor populer di Indonesia:

Vendor Model Umum Support
Huawei HG8245H, HG8546M, EG8141A5, EG8145V5 ✅ Full
ZTE F660, F670L, F601, F612W ✅ Full
Hwtc HG6243C, HG6543C5, HG6145D ✅ Full
Fiberhome HG6243F, HG6145D5 ✅ Sebagian
Nokia G-140W, G-140W-MD ✅ Full
Mercusys / TP-Link (modem ONU) XC220-G3v ✅ Sebagian

Vendor lain (Routerboard, generic OEM) bisa juga selama support CWMP/TR-069.

Persyaratan

  • ✅ Modem pelanggan support TR-069/CWMP
  • ✅ Modem bisa akses ACS URL TB Radius dari internet (port 7547 outbound dari sisi pelanggan)
  • ✅ Konfigurasi ACS URL di modem (manual saat instalasi pertama, atau via DHCP option 43)

Arsitektur

[Modem pelanggan] 
   ↓ kirim Inform (TR-069) tiap 5-30 menit
[GenieACS Server TB Radius] 
   ↓ rekam status, sinyal, dll
[TB Radius Dashboard] 
   ↑ admin/pelanggan akses via UI

Setup di Modem (Manual saat Instalasi)

Saat install fiber baru ke pelanggan, set ACS URL di modem mereka:

Cara Manual (Huawei sebagai contoh)

  1. Akses modem via browser: http://192.168.100.1 (default admin)
  2. Login dengan user/password root (cek dari ISP atau default vendor)
  3. Menu: WAN / Manage → TR-069
  4. Isi:
  5. ACS URL: http://acs.tbradius.com:7547/ (atau IP server GenieACS)
  6. ACS Username: (kosong atau sesuai dokumentasi)
  7. ACS Password: (kosong)
  8. Connection Request URL: auto
  9. Connection Request Username: genieacs
  10. Connection Request Password: genieacs
  11. Periodic Inform Enable: ✅
  12. Periodic Inform Interval: 300 (detik)
  13. Save & Apply
  14. Reboot modem → harusnya muncul di GenieACS dalam < 5 menit

Auto-Provisioning (Bulk Setup)

Kalau Anda punya ratusan modem yang sama vendor, bikin DHCP option 43 di MikroTik:

/ip dhcp-server option add code=43 name=tr069-acs value='"http://acs.tbradius.com:7547/"'
/ip dhcp-server network set [find] dhcp-option=tr069-acs

Modem yang reboot/start akan auto-pickup ACS URL → register sendiri ke GenieACS.

Aktifkan di TB Radius

GenieACS sudah pre-configured di TB Radius — Anda tidak perlu install/setup server ACS sendiri.

Untuk integrasikan ke tenant Anda:

  1. Buka Settings → ACS / Modem Management
  2. Toggle Active
  3. Pilih vendor default (Huawei/ZTE/Hwtc) — fallback kalau auto-detect gagal
  4. Klik Save
  5. Mulai daftar modem (lihat section berikutnya)

Pair Modem ke Pelanggan

Setelah modem muncul di GenieACS (status online), link ke pelanggan PPPoE:

  1. Buka pelanggan PPPoE → tab "Modem"
  2. Klik "Pair Modem"
  3. Pilih dari list modem yang sudah register (filter by serial number atau MAC)
  4. Save

Sekarang modem tersebut link ke akun pelanggan ini. Pelanggan bisa kelola modem mereka via portal client.

Fitur Setelah Pair

Setelah modem ter-pair:

Admin (Anda di Dashboard)

  • Lihat status koneksi real-time
  • Monitor optical power (TX/RX) — penting untuk troubleshoot fiber
  • Lihat client terhubung di WiFi (host list)
  • Reboot modem remote (1 klik)
  • Reset to factory default
  • Update firmware (kalau supported vendor)

Pelanggan (Portal Client)

  • Ganti nama WiFi (SSID)
  • Ganti password WiFi
  • Reboot modem
  • Lihat client terhubung

Best Practices

Set ACS URL saat instalasi

Sebelum modem di-tinggal di rumah pelanggan, wajib set ACS URL. Kalau pakai bulk DHCP option 43, pastikan teknisi reboot modem setelah connect ke OLT/MikroTik supaya pickup option.

Periodic Inform 5-15 menit

Default 300 detik (5 menit) cukup. Lebih sering = bandwidth ACS server boros. Lebih jarang = data status delay.

  • 5 menit = balance ideal untuk ISP umumnya
  • 30 menit = hemat resource, tapi delay info
  • 1 menit = real-time monitoring, butuh resource lebih

Bulk operations via tag

GenieACS support tag grouping. Tag modem berdasarkan area (mis. area-makassar-utara) → bisa bulk reboot, bulk firmware update, dll.

ACS URL tidak terjangkau dari sisi pelanggan

Modem di NAT/private network biasanya tidak bisa di-poke ACS server. ACS yang kontak modem, bukan sebaliknya.

Set: - Periodic Inform: ON (modem inisiatif kontak ACS) - Connection Request: dipakai untuk wake-up modem dari sisi ACS (butuh modem reachable)

Kalau Anda perlu wake-up modem (mis. force reboot real-time), pakai fitur Remote Modem Access TB Radius via CHR tunnel.

Hati-hati ganti SSID/password sembarangan

Kalau ganti SSID/password WiFi modem pelanggan via dashboard, pelanggan akan terputus sampai mereka reconnect dengan kredensial baru. Selalu inform pelanggan via WA dulu sebelum ganti.

Troubleshooting

Modem tidak muncul di GenieACS setelah set ACS URL

Cek satu per satu:

  1. ACS URL benar? Test dari modem: ping ke domain ACS (kalau modem ada CLI)
  2. Periodic Inform enabled? Cek setting modem
  3. Reboot modem setelah save setting — wajib supaya ACS URL aktif
  4. Firewall block port 7547? Pastikan outbound 7547 allow di MikroTik/router pelanggan
  5. Tunggu 5-10 menit — Inform pertama kadang lambat
  6. Cek log GenieACS (kalau ada akses) untuk lihat ada error
Modem online tapi optical power "N/A"

Tidak semua modem expose optical power via TR-069. Tergantung firmware. Solusi:

  • Update firmware modem ke versi terbaru
  • Pakai SNMP sebagai fallback (kalau modem support)
  • Atau cek manual via SSH ke OLT (kalau pelanggan di OLT Anda sendiri)
WiFi SSID ganti dari dashboard tapi tidak berubah di modem
  • Modem belum receive perintah — tunggu Periodic Inform berikutnya (max 5-10 menit)
  • Atau klik tombol "Force Connection Request" di dashboard (kalau ada) untuk push immediate
  • Modem firmware bermasalah — reboot manual
  • Set tidak compatible dengan vendor model (mis. SSID terlalu panjang) — TB Radius normally validate dulu
Banyak modem offline tiba-tiba

Kalau >10 modem offline bareng:

  • Cek OLT / backbone Anda — kemungkinan masalah jaringan
  • Cek GenieACS server (status di TB Radius dashboard)
  • Cek route ke server ACS dari sisi MikroTik Anda
Bisa pakai GenieACS sendiri (self-hosted)?

TB Radius default pakai GenieACS managed kami. Kalau Anda mau self-host (untuk compliance / performance), bisa diatur via paket khusus. Hubungi support.

FAQ

Q: Berapa banyak modem yang bisa di-manage? A: Tergantung paket Anda. Trial limit ~50 modem, paket berbayar 200-unlimited.

Q: GenieACS support modem 2 sebelumnya tahun lalu (legacy)? A: Kebanyakan modem produksi 2015+ support TR-069. Cek vendor docs untuk model spesifik.

Q: Ada delay set WiFi ke modem? A: Ya, sekitar 1-5 menit (sampai modem next Periodic Inform). Untuk instant, butuh Connection Request yang bekerja (modem reachable dari ACS).

Q: Bisa firmware update remote? A: Bisa, kalau vendor support. TR-069 punya method Download untuk push firmware. Tapi RISIKO: kalau firmware salah/corrupt, modem bisa brick. Test dulu di 1-2 modem sebelum bulk update.

Q: Data optical power buat troubleshoot apa? A: Indikator kesehatan fiber:

  • TX Power: -3 sampai +3 dBm (normal)
  • RX Power: -8 sampai -25 dBm (normal). Di bawah -27 dBm = sinyal lemah, pelanggan suka putus
  • Temp: < 70°C (normal)

Anomali = teknisi datang cek fiber/splicing/connector.