Lewati ke konten

TR-069 / CPE

TR-069 (CWMP) membuat indoradius bisa mem-provision dan memantau CPE (ONT/ONU, router) dari jarak jauh lewat ACS bawaan — tidak perlu GenieACS terpisah. Halaman ini menyiapkan satu CPE dari pengarahan ke ACS sampai terikat ke pelanggan dan bisa dioperasikan.

CPE mengirim Inform berkala ke URL ACS tenant Anda. ACS mengenali perangkat, dan begitu di-claim + diikat ke pelanggan, ia bisa di-provision (SSID, PPPoE, dll.) serta dioperasikan (reboot, re-provision, factory-reset). Setiap tenant punya endpoint ACS dengan slug acak sendiri.

Satu hal yang perlu ditegaskan: semua interaksi dipicu oleh CPE, bukan oleh ACS. ACS hanya bekerja saat CPE mengirim Inform — ia tidak bisa “menelepon” perangkat sewaktu-waktu (CPE umumnya di balik NAT/CGNAT, tak bisa dijangkau balik). Karena itu setiap perintah operator (reboot, re-provision, ubah profil) di-antre dan baru benar-benar diterapkan pada Inform berikutnya (default tiap ~5 menit).

Di app buka ACS Configuration. Kartu Endpoint menampilkan:

  • Public URL — alamat yang dikirim ke ONU (bentuknya seperti http://acs.indoradius.com:8888/t/<slug>). Salin dari sini; ini sumber kebenaran (lengkap dengan port-nya).
  • Username & Password — kredensial yang dimasukkan di ONU. Tombol Show menampilkan password, Rotate mengganti — rotate = mengunci semua perangkat sekaligus (mereka harus dapat kredensial baru).

Tujuannya satu: menanamkan ACS URL (plus username/password) ke CPE. Ada beberapa cara — pilih sesuai infrastruktur Anda. Apa pun metodenya, nilai yang ditanam harus persis sama dengan kartu Endpoint (Langkah 1), termasuk port :8888.

Kartu Mikrotik bootstrap di halaman ACS Configuration meng-generate skrip RouterOS yang menyetel DHCP Option 43 (URL ACS) + Option 60 (Vendor Class dslforum.org), VLAN manajemen, IP pool, dan firewall yang mengunci trafik CPE hanya ke ACS. ONU yang mengirim Option 60 dslforum.org otomatis menerima URL ACS lewat Option 43 — tanpa mengetik apa pun di ONU.

Isi field (parent interface, VLAN ID, subnet /24, ACS host) lalu tempel skrip ke terminal Mikrotik. Setiap perintah ditulis satu baris utuh, dan skrip aman ditempel ulang: konfigurasi irad:tr069 lama dihapus dulu lalu dibuat lagi. Intinya:

# DHCP options: Option 43 (ACS URL) + Option 60 (VCI dslforum.org)
/ip dhcp-server option add code=60 name=tr069-vci value=<hex>
/ip dhcp-server option add code=43 name=tr069-acs value=<hex>
/ip dhcp-server option sets add name=tr069 options=tr069-vci,tr069-acs

DHCP server lain (BNG, OLT, isc-dhcp) bisa menyajikan Option 43/60 yang sama — nilai hex dari skrip ini tinggal dipakai ulang.

Rule firewall CPE ada di chain sendiri, irad-tr069. Chain forward hanya mendapat dua rule jump yang dipasang di atas rule Anda (fasttrack, accept pelanggan, drop), jadi rule tenant tidak bisa melangkahi lockdown. Di dalam chain itu:

  • ONU hanya boleh menghubungi ACS (dan DNS bila ACS berupa domain); trafik lain dari ONU ditolak.
  • Koneksi baru ke ONU hanya diterima dari concentrator platform (172.16.0.1, address-list acs-cr-sources) — jalur Connection-Request dan remote access ONU.
  • Trafik lain yang menuju ONU (mis. dari kantor Anda) keluar dari chain dan diputuskan oleh rule forward Anda sendiri.

Kartu Behavior punya tiga sakelar:

  • Accept traffic — saat off, perangkat yang menuju URL tenant ini ditolak (URL & password tetap sama).
  • Auto-discover new ONUs — saat on, perangkat baru otomatis masuk ke daftar CPE setelah check-in pertama. Saat off, operator harus pre-claim serial dulu.
  • Anonymous discovery — saat on, ONU yang menyentuh URL ACS tanpa kredensial dicatat di CPE → Discovery supaya bisa di-claim tanpa mengetik serial. Inform-nya sendiri tetap ditolak — tidak ada yang masuk ke ACS sampai ada claim sungguhan. Bisa diatur TTL-nya.

Langkah 4 — Discovery → claim → binding

Section titled “Langkah 4 — Discovery → claim → binding”
  1. Muncul di Discovery. Perangkat yang belum dikenal muncul di CPE → Discovery saat mengirim Inform pertama (butuh Auto-discover atau Anonymous discovery aktif).

  2. Claim. Dari perangkat itu, klik claim dan pilih:

    • Customer (wajib) — pemilik perangkat.
    • Subscriber (opsional) — difilter ke customer yang dipilih.
    • CPE profile — profil provisioning yang diterapkan.
  3. Terikat. Setelah di-claim, CPE muncul di daftar CPE Devices dan di panel CPE pada sheet subscriber / halaman customer. Provisioning memakai data langganannya.

Dari menu aksi di halaman detail CPE:

  • Re-provision — terapkan ulang profil provisioning.
  • Reboot — restart perangkat.
  • Factory Reset — kembalikan ke setelan pabrik (lalu auto-provision ulang pada Inform berikutnya).

Selain itu, pada tampilan parameter per-bagian (mis. WAN / WLAN untuk device Huawei) ada tombol Refresh yang menarik nilai terbaru dari CPE lalu memuat ulang panelnya.

Gejala Penyebab umum Solusi
CPE tak muncul di Discovery Auto-discover & Anonymous discovery sama-sama off, atau URL/kredensial salah di ONU Aktifkan salah satu sakelar (Langkah 3); cocokkan URL + username/password dengan kartu Endpoint
ONU “mati” setelah lockdown firewall ACS pakai domain tapi rule DNS tidak ter-paste Pastikan rule allow DNS (UDP/TCP 53) dari subnet CPE ada — lihat catatan di Langkah 2
Inform tidak pernah sampai TCP/7547 difilter ISP, atau ONU dipin ke :7547 Pakai URL :8888 dari app, bukan :7547
Perintah “queued” tapi tak kunjung terjadi Wajar — perintah menunggu Inform berikutnya; CPE di balik NAT tidak bisa di-ConnectionRequest Tunggu Inform berkala (~5 menit); kalau perangkat memang reachable, pakai Summon. Pantau task timeline
Endpoint Public URL kosong Alamat publik ACS belum dikonfigurasi (operator) Hubungi operator platform