Everything you need to install, configure, and master OLT EMS Solutions.
Install, configure, and launch your platform
OLT EMS Solutions runs on a standard LAMP/WAMP stack. Here's what you need:
Copy the OLT EMS Solutions directory to your web server document root (e.g., /var/www/html/ems or C:\xampp\htdocs\ems).
Create a virtual environment and install dependencies:
python3 -m venv /opt/ems/venv
source /opt/ems/venv/bin/activate
pip install -r requirements.txtEdit ems_config.json with your OLT IP addresses and connection credentials. The EMS will auto-detect the best protocol for each OLT.
cd /opt/ems && ./venv/bin/uvicorn ems_api:app --host 0.0.0.0For production, set this up as a systemd service for auto-start on boot.
Navigate to http://your-server/ems/ and log in with the admin credentials provided in your license email.
After installation, configure these core settings:
Go to System Settings → OLT Configuration. Add each OLT with its IP address and credentials. The system auto-detects the connection protocol. Supports V1600D, V1600G, V1600G4, and V2800 series.
Navigate to System Settings → Service Plans. Create internet packages with speed tiers, data caps, and monthly pricing.
Create team accounts under User Management. Assign roles: Admin, Manager, Supervisor, Technician, Support, Cashier, or OSP.
Configure SMTP under Email Settings for password resets, notifications, and alerts. Works with any provider via PHPMailer.
The dashboard is your central hub with these key components:
Track staff attendance with shift summaries and automatic hours calculation.
Quick-view shows today's staff overview. Expand to full month/week view with events.
Items needing attention. Claim, resolve, or escalate. Managers see all; staff see their own.
Quick payment processing with auto receipt generation. Cash, Linx, credit card, and online transfer.
Managers see daily KPIs: monitoring counts, work orders, transactions, and per-employee breakdown.
Connect, monitor, and manage your VSOL OLTs
OLT EMS supports secure connectivity to VSOL OLTs. The platform auto-detects supported models and configures the appropriate command set.
8-port EPON OLT. Secure managed. Up to 512 ONUs.
8-port GPON OLT. Secure managed. Up to 1024 ONUs.
4-port GPON compact OLT for smaller deployments.
High-density chassis OLT. Multiple line cards supported.
Go to System Settings → OLT Configuration and click "Add OLT".
Provide OLT name, IP address, and management credentials.
Set polling intervals and monitoring preferences. Used for ONU status, optical levels, and bandwidth data.
Click "Test Connection" to verify OLT connectivity. Save on success.
Monitor real-time and historical bandwidth consumption per ONU across your entire network.
Displays a real-time speed table with upload/download rates for every ONU on a selected OLT. Data refreshes every 30 seconds. Shows MAC address, customer name (auto-mapped), current speeds, and status.
Aggregated usage data over configurable time ranges (7, 14, 30, 60, or 90 days). Each ONU shows total download/upload in GB, average daily usage, and peak consumption. Export to CSV for external analysis.
Click any ONU row for a 24-hour hourly chart showing traffic patterns. Identifies peak usage times, potential abuse, and service quality issues with separate download/upload and peak indicators.
Monitor OLT GE uplink ports with real-time utilization percentages and throughput for each interface. Identify bandwidth bottlenecks before they affect subscribers.
Instant alerts when ONUs go online or offline. The system polls the EMS API and displays badge counts in the nav bar.
Configurable notification sounds. Different tones for single vs. mass offline events.
Nav bar shows unread count. Click to view the full event log with timestamps, ONU MAC, and customer name.
Automatically creates work orders for offline ONUs and routes them to field technicians.
Browse and search OLT event logs in real-time without direct OLT access.
Stream logs in real-time. New entries appear at the top with auto-scroll. Pause/resume anytime.
Keyword search and time-range filtering. Find events by MAC, ONU ID, or event type.
Breakdown by event type: registration, deregistration, power failures, link down, with counts.
Manage subscribers, billing, tickets, and field service
The guided onboarding wizard walks operators through the entire process of adding a new customer and provisioning their ONU on the network, all from a single interface.
Enter subscriber information: name, address, phone, email, area, and select an OLT node. Choose a service plan with speed tier and pricing.
The system monitors for new ONU authentication events on the selected OLT. When a new ONU is detected, the wizard auto-captures its MAC address and PON port assignment.
One-click registration adds the detected ONU to the OLT whitelist. The system polls until the ONU comes online, with a 5-minute timeout and intelligent EMS re-poll triggers.
Applies speed profile (DBA) and routing profile (SRV) to the registered ONU. Sets a descriptive label on the network equipment matching the customer name.
Review summary and finalize. The customer record, ONU mapping, and network configuration are saved together.
When a customer is deleted, the system automatically deregisters their ONU from the OLT whitelist, ensuring clean network lifecycle management without manual intervention.
Every subscriber has a detailed record with contact info, service plan, OLT assignment, MAC address, area, and status.
Real-time search across name, phone, MAC, area, and account number. Results appear as you type.
Select multiple customers and batch update fields like service plans, areas, OLT assignments, or status.
Import unmatched MACs from the EMS and link to customer records for automatic bandwidth association.
Generate invoices per customer with automatic calculation. Track payments across Cash, Linx, Credit Card, and Online Transfer.
Select customer → auto-populates plan, amount, and billing period. Add adjustments or notes.
Log the transaction with payment method. Receipt auto-generates with a unique transaction ID.
Print invoices/receipts directly from the browser with a professional layout.
Track issues from submission to resolution. Tickets are classified by category (billing, technical, service), priority (low–urgent), and department.
Quick-create from the dashboard. Assign to team members, add internal notes, and track resolution time. Notifications fire on new tickets and status changes.
Create work orders for installations, repairs, disconnections, and maintenance. Each includes customer details, location, issue description, and assigned technician.
Printable Documents: Generate printer-friendly technician sheets with all job details and a completion sign-off section.
Auto-Creation: ONU goes offline → work order auto-created and assigned to the next available technician by area.
Schedule and track new customer installations with a status workflow: Scheduled → In Progress → Completed. Assign technicians, attach notes, and track completion rates.
KPIs, manager dashboards, and data exports
Performance metrics across all work categories including monitoring, work orders, transactions, calls, and IT tasks.
Preset ranges (7, 14, 30, 90 days) or custom. All charts and tables update dynamically.
Filter by department for team-specific performance. Compare departments side by side.
Individual breakdown: tickets processed, work orders completed, calls handled.
Real-time overview for managers. Today's monitoring activity, work order progress, disconnections, and time logs in tabular views with drill-down capability.
Detailed per-feature activity reports (monitoring, work orders, transactions, disconnections) filterable by employee. Export to CSV for external reporting.
Centralized reporting dashboard with printable, XLS-exportable reports for compliance and management review.
Formatted consumer complaints report for submission to your local telecommunications authority. Printable with authority header.
Gross income breakdown by period with payment method splits.
New activations and churn overview for any date range.
Volume, resolution rates, and average response times.
Completion rates, pending jobs, and technician performance.
Approved expenses by category and period.
Comprehensive audit trail. Filter by category (auth, customer, billing, network), severity (info–critical), user, and date range. CSV export for compliance.
Roles, encryption, backups, and system config
Role-based access control with 7 distinct roles:
Full system access including users, settings, backups, and all modules.
Analytics, team management, expense/leave approvals.
Daily operations, work assignments, reports.
Work orders, installations, field status updates.
Tickets, customer calls, follow-ups.
Payments, receipts, transaction management.
Outside plant: GIS mapping, infrastructure.
Sensitive data encrypted at field level using AES-256-GCM including customer contacts, payment details, and auth tokens. Keys stored separately from data. Includes migration tools for encrypting existing data and key rotation.
Compressed ZIP of all JSON data, config, and encryption keys. Download from browser.
Today's activity data only: monitoring, work orders, calls, transactions.
Upload a backup ZIP. System validates integrity before applying.
Keep a versioned archive of your OLT running configurations. One-click download from any connected OLT, timestamped storage, and one-click restore. Included on all plans.
Pull the current running configuration from any OLT with one click.
All saved configs are stored with timestamps for easy history review.
Push a saved config back to the OLT to roll back after a problematic change.
Log calls, IT tasks, and network checks to track your team's daily activity.
Log every customer call with type, issue description, duration, resolution, and optional follow-up routing. Each call is linked to the customer record.
Categorize by type: support, billing, sales, or follow-up.
Flag calls for follow-up and route them to the correct team member.
Full call log with stats and per-employee filtering.
Track internal IT tasks with type, priority, system/server name, hours spent, and status. Supports follow-up flagging and links into the Analytics KPI dashboard.
Critical, High, Medium, Low — each task is prioritized for clear workload visibility.
Log hours spent per task for accurate KPI reporting.
Associate tasks with specific servers, network devices, or internal systems.
Log manual network checks per customer including status, MAC address, and outcome notes. Full history with stats and date/status filters.
Each log entry is linked to a customer record for quick lookup.
Browse the full log with status and date filters and summary stats.
Optional modules billed monthly alongside your base plan. Add or remove any time from your license portal.
Full automated ONU monitoring with SNMP polling across all connected OLTs. The engine detects offline ONUs, auto-creates work orders, and tracks signal history. Available on Professional and above.
Polls all OLTs on a configurable interval and raises an alert as soon as an ONU drops.
Creates a work order automatically when an ONU goes offline and resolves it when the ONU returns.
7-day Rx/Tx power trend charts per ONU for proactive fault detection.
Unified view of all ONU statuses across every connected OLT.
Live interactive subscriber map built on Leaflet. Subscribers are plotted with OLT-grouped markers and cross-referenced against your BMS and OSP records.
Color-coded pins grouped by OLT for a quick visual of your network footprint.
Click any marker to pull up the customer record with MAC address and service details.
Overlay outside-plant infrastructure data alongside subscriber locations.
Send automated SMS notifications to subscribers via your own SMS provider. Configure message templates and trigger rules from the system settings.
Automatic reminders before and on the due date.
Notify customers when their service is suspended.
Broadcast outage or maintenance notices to affected subscribers.
Set up automatic report generation on a daily, weekly, or monthly schedule. Reports are compiled and emailed to nominated recipients without any manual action.
Daily, weekly, or monthly delivery on a timetable you define.
Reports land in nominated inboxes as attachments with no portal login required.
Bandwidth, billing, work orders, customer growth, and more.
A branded self-service portal for your subscribers. Customers log in to view their invoices, submit support tickets, check service status, and update contact details.
Customers can view and download all past invoices.
Subscribers raise and track support tickets directly from the portal.
Live connection status and current plan details visible to the subscriber.
Customers can update their contact information without calling support.
FastAPI REST endpoints for OLT and ONU operations
The EMS engine exposes a RESTful API via FastAPI. All responses are JSON. The API provides read access to OLT and ONU data through the EMS polling system.
http://your-server/api/v1/system/{olt_id}
OLT system info (model, uptime, firmware)
/onu/list/{olt_id}
List all ONUs with MAC and status
/onu/status/{olt_id}/{onu_id}
Single ONU status (online/offline, uptime)
/onu/optical/{olt_id}/{onu_id}
ONU optical levels (Rx/Tx power in dBm)
/onu/traffic/{olt_id}
Real-time traffic for all ONUs on an OLT
/pon/ports/{olt_id}
PON port statistics (ONU count, status)
/interfaces/{olt_id}
All interfaces with traffic counters
/uplinks/{olt_id}
GE uplink utilization and throughput
GET /api/v1/onu/status/1/3
{
"olt_id": 1,
"onu_id": 3,
"mac": "AA:BB:CC:DD:EE:FF",
"status": "online",
"uptime": "14d 6h 32m",
"model": "V2802GW",
"rx_power": "-18.42 dBm",
"tx_power": "2.31 dBm",
"distance": "4.2 km"
}