OneConnect ACS
Complete TR-069 Auto Configuration Server & Network Management Platform
OneConnect ACS is a full-featured ISP management platform built on GenieACS for managing GPON/EPON ONUs, OLTs, subscribers, and network infrastructure. It provides real-time monitoring, automated configuration push, firmware management, and comprehensive reporting.
Key Features
| Feature | Description |
|---|---|
| Dashboard | Real-time overview of all ONUs, OLTs, alarms, traffic, and jobs with live charts and network map |
| Device Management | Full CRUD for ONU/ONT devices with status monitoring, optical power readings, and subscriber linking |
| OLT Management | Manage OLT chassis, PON ports, splitters, and associated ONUs |
| Subscriber Management | Customer profiles with PPPoE credentials, package details, billing info, and device assignment |
| Alarm Management | Critical/Major/Minor alarm tracking with acknowledge and resolve workflows |
| Job Queue | Background jobs for firmware upgrades, config pushes, reboots, and speed tests |
| Firmware Management | Upload and push firmware to devices, track upgrade history |
| Configuration Templates | JSON-based TR-069 parameter templates for PPPoE, Bridge, Wi-Fi, QoS configurations |
| Network Map | Interactive Leaflet map showing OLTs, splitters, and ONUs with real-time status |
| Reports & Analytics | Traffic trends, alarm summaries, vendor distribution, offline ONU lists |
| Inventory | Track hardware stock: ONUs, SFPs, cables, splitters with quantity management |
| Scheduled Tasks | Cron-based automated tasks for polling, backups, reports |
Login & Access
Access OneConnect ACS at https://acs.mikrotikworld.com
Default Credentials
| Field | Value |
|---|---|
| Username | admin |
| Password | admin123 |
User Roles
| Role | Permissions |
|---|---|
| Super Admin | Full access including user management, system settings, delete operations |
| Admin | Full access except user management and system settings |
| NOC | View, add, edit devices; manage alarms and jobs; no delete |
| Viewer | Read-only access to all modules |
Dashboard
The dashboard provides a real-time overview of your entire network. It auto-refreshes every 60 seconds.
Stat Cards (Top Row)
- Online ONUs — Count of all ONU/ONT devices with status "online"
- Offline ONUs — Devices that have lost connection
- LOS Devices — Loss of Signal — fiber break or ONU power issue
- Active Subscribers — Subscribers with active service status
- Firmware Pending — Firmware upgrade jobs in pending/running state
- Provisioning Queue — Devices awaiting provisioning with TR-069
- Today's Registrations — New devices provisioned today
- OLT Count — Total OLTs with online/offline breakdown
Network Map
Interactive Leaflet map showing OLT locations as blue squares and ONU status as colored dots (green=online, red=offline, yellow=LOS). Click any marker for details and device links.
Active Alarms Panel
Shows the 8 most recent active alarms sorted by severity. Red border = Critical, Orange = Major, Blue = Minor. Click "View All" to open the full Alarms module.
Charts
- Device Status Donut — Visual breakdown of Online/Offline/LOS
- ONU Status Over Time — 7-day trend of device states
- Interface Traffic — 24-hour download/upload traffic in Gbps
- Vendor Distribution — Breakdown of ONU vendors in your network
ONU / Device Management
Manage all GPON/EPON ONU and ONT devices in your network.
Adding a Device
- Go to Devices → Add Device
- Enter Serial Number (required) and MAC Address
- Select the OLT and Splitter it's connected to
- Enter the PON port and ONU port numbers
- Set vendor, model, and firmware version
- Click Save Device
Device Status Meanings
| Status | Meaning | Action |
|---|---|---|
| Online | ONU is connected and registered to OLT | Normal operation |
| Offline | ONU is not responding to OLT | Check power, fiber, PPPoE |
| LOS | Loss of Signal — fiber cut or power issue | Check fiber splice points |
Optical Power Readings
- -8 to -25 dBm — Normal range
- -25 to -30 dBm — Warning — marginal signal
- Below -30 dBm — Critical — check fiber
Bulk Operations
Use Import to bulk-load devices from CSV. Download the sample CSV template from the import page. Use Export to download all device data.
OLT / Network
Manage your OLT (Optical Line Terminal) chassis and network topology.
Adding an OLT
- Go to OLT / Network → Add OLT
- Enter name, IP address, location, vendor, and model
- Configure SNMP community string (default:
public) - Set GPS coordinates for map display
- Save — the OLT will be polled on the next monitoring cycle
OLT View Page
The OLT detail page shows all connected splitters, PON port utilization, and the list of all ONUs registered to that OLT. It also displays SNMP data including CPU usage, memory, and temperature.
Subscribers / Clients
Manage your internet service subscribers and their accounts.
Subscriber Workflow
- Create subscriber with customer ID, name, and contact details
- Set package with bandwidth limits (download/upload Mbps)
- Add PPPoE credentials (username/password for authentication)
- Link to device — assign the subscriber's ONU
- Activate — change status from Pending to Active
Subscriber Statuses
| Status | Description |
|---|---|
| Active | Account is active and service is enabled |
| Inactive | Account exists but service is not active |
| Suspended | Service suspended (non-payment, violation) |
| Pending | New account awaiting activation |
Alarm Management
Real-time alarm monitoring for your network infrastructure.
Alarm Severity Levels
| Severity | Description | Response Time |
|---|---|---|
| Critical | Service-affecting — OLT down, LOS on major splice | Immediate |
| Major | Significant — multiple ONUs offline, high temperature | < 15 minutes |
| Minor | Degraded service — marginal optical power | < 1 hour |
| Warning | Potential issue — trending toward threshold | Next business day |
| Info | Informational events — device reboots, config changes | No action needed |
Alarm Workflow
- Active — Alarm is raised, needs attention
- Acknowledge — Engineer has seen it and is working on it (click )
- Resolve — Issue has been fixed (click )
Bulk Operations
Use "Resolve All Active" button after a maintenance window to clear all existing alarms at once.
Job Management
Background task queue for long-running operations like firmware upgrades, config pushes, and reboots.
Job Types
| Type | Description |
|---|---|
| firmware_upgrade | Push new firmware to one or multiple ONUs |
| configuration | Apply TR-069 configuration template to devices |
| reboot | Reboot selected ONUs |
| sync | Synchronize device parameters with GenieACS |
| backup | Backup device configurations |
| speed_test | Run bandwidth test on selected ONU |
| provision | Provision new device via TR-069 |
Job Statuses
- Pending — Queued, waiting for worker to pick up
- Running — Currently executing (shows progress bar)
- Completed — Finished successfully
- Failed — Error occurred (check error_message)
- Cancelled — Manually stopped
Rebooting ONUs
Go to Jobs → Reboot ONUs to reboot devices.
Reboot Options
- All ONUs — Network-wide reboot (use with caution)
- ONUs on specific OLT — Reboot all ONUs on one OLT
- Single Device — Target one specific ONU
Firmware Management
Uploading Firmware
- Go to Firmware → Upload Firmware
- Enter firmware name, vendor, model, and version
- Select the firmware file (.bin, .tar, .gz, .zip)
- Add release notes describing what changed
- Mark as Stable or Beta
- Click Upload Firmware
Pushing Firmware
- From the Firmware list, click Push next to the desired version
- Select target: All Compatible / Single Device / Batch
- Click Start Upgrade — a job is queued in the Jobs module
- Monitor progress from Jobs
Configuration Push
Push TR-069 parameter configurations to devices using JSON templates.
Push to Single Device
- Go to Configuration
- Select the target device
- Select a configuration template
- Click Push Configuration
Bulk Push
Use the Bulk Push panel to apply the same configuration to all devices or all devices on a specific OLT. This creates a job in the queue for mass deployment.
Configuration Templates
Templates define TR-069 parameter sets in JSON format that can be pushed to devices.
Template Content Format
{
"WanType": "PPPoE",
"VlanId": 100,
"Priority": 0,
"ServiceList": "INTERNET",
"Username": "{{pppoe_user}}",
"Password": "{{pppoe_pass}}"
}
Use {{variable_name}} for dynamic values that will be substituted per-device at push time.
Template Types
- wan_pppoe — PPPoE WAN configuration
- wan_bridge — Bridge mode WAN
- wan_static — Static IP WAN
- wifi — Wireless network configuration
- voip — VoIP SIP parameters
- qos — Quality of Service / bandwidth limits
- firewall — Firewall rules
- custom — Any custom TR-069 parameters
GenieACS Integration
OneConnect ACS is built on top of GenieACS for TR-069 communication with CPE devices.
GenieACS Services
| Service | Port | Purpose |
|---|---|---|
| NBI (North Bound Interface) | 7557 | REST API for querying and managing devices |
| CWMP (ACS Server) | 7547 | TR-069 communication endpoint for CPEs |
| FS (File Server) | 7567 | Firmware and configuration file hosting |
| UI | 3000 | GenieACS web interface |
Database Configuration
OneConnect ACS uses its own MySQL database (acs_app) separate from GenieACS's MongoDB database. GenieACS uses MongoDB for device parameters and connection history.
CPE Configuration (ONU Side)
Configure each ONU to point to your ACS server:
ACS URL: https://acs.mikrotikworld.com:7547/ Username: [device_serial_number] Password: [acs_password] Inform Interval: 3600 (seconds)
TR-069 Protocol
TR-069 (CWMP - CPE WAN Management Protocol) is the standard protocol used by ISPs to remotely manage CPE (Customer Premises Equipment) devices.
How TR-069 Works
- CPE (ONU) boots up and sends an Inform request to the ACS
- ACS acknowledges and sends back a session
- ACS can then GetParameterValues, SetParameterValues, Download (firmware), or Reboot
- Session ends and CPE waits for the next inform interval
Key TR-069 Parameters
| Parameter | Description |
|---|---|
Device.DeviceInfo.SerialNumber | Device unique identifier |
Device.DeviceInfo.SoftwareVersion | Current firmware version |
Device.WANDevice.WANConnectionDevice.WANPPPConnection.Username | PPPoE username |
Device.LANDevice.WLANConfiguration.SSID | Wi-Fi network name |
Device.Reboot() | RPC to reboot the device |
Device.Download() | RPC to trigger firmware download |
Troubleshooting
Device Shows Offline
- Check if ONU has power (LED indicators)
- Check fiber cable continuity
- Verify optical power reading is above -25 dBm
- Check OLT port status — PON port may be disabled
- Verify ONU serial number matches registration
- Try rebooting the ONU via Jobs → Reboot ONUs
Device Shows LOS (Loss of Signal)
- Check fiber splice boxes for damage
- Inspect connector cleanliness (dirty connectors cause LOS)
- Measure optical power with an OTDR
- Check if ONU laser is functioning (TX power)
- Verify splitter ratio — if overloaded, signal degrades
PPPoE Authentication Failed
- Verify PPPoE username/password in Subscribers module
- Check RADIUS server configuration
- Ensure VLAN ID matches PPPoE server configuration
- Check if subscriber is suspended in the system
- Try pushing configuration template again
TR-069 Device Not Connecting
- Verify ACS URL is correctly configured on the ONU
- Check firewall — port 7547 must be reachable from ONU
- Verify CWMP credentials match on both ONU and ACS
- Check GenieACS logs:
journalctl -u genieacs-cwmp - Ensure GenieACS is running:
systemctl status genieacs-cwmp
Common Error Messages
| Error | Cause | Fix |
|---|---|---|
| CSRF token invalid | Session expired | Refresh page and try again |
| Database connection failed | MySQL not running | Start MySQL: systemctl start mariadb |
| File upload failed | uploads/ not writable | chmod 755 uploads/firmware/ |
| Login failed | Wrong credentials | Check username/password, check user status |
GenieACS Service Commands
# Start all GenieACS services systemctl start genieacs-cwmp genieacs-nbi genieacs-fs genieacs-ui # Check status systemctl status genieacs-cwmp # View logs journalctl -u genieacs-cwmp -f # Restart after config change systemctl restart genieacs-cwmp
Server Details
| Property | Value |
|---|---|
| Server IP | 103.159.32.4 |
| Domain | acs.mikrotikworld.com |
| Database | acs_app (MySQL) |
| Web Root | /var/www/html/acs |
| GenieACS Config | /etc/genieacs/ |
| GenieACS DB | MongoDB (localhost:27017) |
docs.genieacs.com.
← Back to Dashboard