TR-069 CPE management
TR-069 lets you manage customer premises equipment (CPEs) such as ONUs/ONTs and home routers remotely. Each CPE checks in (“informs”) with an ACS (Auto Configuration Server). ISPMan connects to that ACS so you can see your whole CPE fleet and act on single devices from the dashboard.
Open Devices → TR-069 (/dashboard/devices/tr069). It’s available to
owners and devices admins. If you don’t use TR-069, you can hide it under
Services in the Dashboard settings drawer.
Connect your ACS
Section titled “Connect your ACS”Go to the Settings tab and click the TR069 Credentials button. You can connect in one of two ways:
- Request ACS credentials: click Get ACS Credentials and ISPMan creates a dedicated ACS account for your business. Every business gets its own username and password. Use Regenerate Credentials to replace them.
- Use existing credentials: if you already run an ACS, enter the ACS URL and/or NBI URL, plus the ACS Username and ACS Password. Click Test Connectivity before Save Config. Clear Config removes them.
The same window has Sync Devices, which refreshes the local copy now, and Delete Mirrored Data, which clears it.
Then configure the same ACS URL and credentials on your CPEs (usually in the ONT’s TR-069 or “remote management” settings, or by your supplier) so they inform to it.
Settings tab options
Section titled “Settings tab options”| Option | What it does |
|---|---|
| Local sync | On: the page reads a local copy that mirrors the ACS and refreshes automatically, so it stays fast and still loads when the ACS is down. Off: the page asks the ACS on every request, which is always current but only as fast and available as the ACS. Actions (reboot, provision, firmware) always go straight to the ACS either way. |
| Online threshold (Minutes) | How long after its last inform a device still counts as online. Default 10. Most CPEs inform every few minutes, so a few minutes is right. Set it to match the ACS dashboard your team already uses. |
| Tab | What you’ll find |
|---|---|
| Dashboard | Total Devices, Online, Offline, Faults and Median RX, with charts for RX power, temperature, product class, access type, PON mode and vendor, plus recently registered and last-seen devices. A banner warns if the ACS is unreachable or the last sync failed, and shows how old the data is. |
| ONUs | Every device: model, PON, MAC, IP, PPPoE user, SSID, RX power and temperature, clients, last seen and status. Search by serial, model or ID. Click a device to open it. |
| Faults | Errors recorded by the ACS: code, message, device, channel, retries and time. Open one to see the device as it was at the time of the fault. |
| Provision | Push a PPPoE customer’s login to a device (see below). |
| Firmware Upgrade | Upgrade one device’s firmware. |
| Settings | ACS credentials and the options above. |
Provision a device with a PPPoE customer
Section titled “Provision a device with a PPPoE customer”- Open the Provision tab.
- Choose the Device.
- Under PPPoE Customer, search by account number, phone or name, and pick the customer. PPPoE Username and PPPoE Password fill in automatically from that customer.
- Click Provision Device.
The device appears under Provisioned Devices with its serial, status and last inform. Click Unprovision to remove it.
Upgrade firmware
Section titled “Upgrade firmware”- Open Firmware Upgrade and choose the Device.
- Under Firmware Source, either type the file name of an image already on
the ACS (Image already on the ACS, for example
device_v2.1.bin; a file name, not a URL), or upload the image with Upload Firmware. - Click Start Firmware Upgrade.
The device page
Section titled “The device page”Clicking a device opens /dashboard/devices/tr069/<device>, with Refresh
and six tabs:
| Tab | Contents |
|---|---|
| Summary | Device information, connection, and telemetry such as optical RX power, coloured by how much margin is left. |
| WAN | The WAN session and PPPoE details, and interface counters (totals since the last boot, not a live rate). Edit PPPoE Credentials sets the username and password. |
| WiFi | Each radio’s settings and Edit WiFi Settings for SSID, Password (PSK) and Channel. Only fields you fill in are written. Setting a channel turns off automatic channel selection. |
| System | Device and optical module details, LAN & DHCP, Ethernet ports, and Actions: Reboot Device and Factory Reset. |
| Clients | Attached devices: hostname, IP, MAC, connection type, signal and status. |
| Parameters | The full TR-069 parameter tree, searchable. |
An Inform History list below the tabs shows the device’s recent check-ins.
Notes:
- Passwords show as Not readable. TR-069 CPEs report password fields as empty, so you can set a password from here but never read the current one.
- Clearing the PPPoE credentials stops the device authenticating and takes the customer offline.
- Reboot Device drops the customer’s connection for about a minute.
- Factory Reset can’t be undone. It clears the PPPoE/WAN credentials and the WiFi settings, so the customer goes offline. On most devices it also clears the ACS address, so you can’t manage the device from ISPMan again until it’s set up again on site.