Service Management
Managing AthenaBNG services via systemd.
Overview
All AthenaBNG services are managed via systemd. The main target is AthenaBNG.target, which starts all required services in the correct order.
Service List
| Service | Unit | Purpose |
|---|---|---|
| abngd | abngd.service | Core daemon |
| abng-demux | abng-demux.service | VLAN demux |
| accel-ppp | accel-ppp.service | PPPoE server |
| abng-dhcpd | abng-dhcpd.service | DHCP server |
| abng-qos | abng-qos.service | QoS orchestrator |
| REST API | abng-api.service | Management API |
| SNMP Agent | snmpd.service | SNMP monitoring |
Starting Services
Start All Services
sudo systemctl start AthenaBNG.target
Start Individual Service
sudo systemctl start abngd
sudo systemctl start abng-demux
sudo systemctl start accel-ppp
Stopping Services
Stop All Services
sudo systemctl stop AthenaBNG.target
Stop Individual Service
sudo systemctl stop abng-demux
Checking Status
Check All Services
sudo systemctl status AthenaBNG.target
Check Individual Service
sudo systemctl status abngd
List All Services
sudo systemctl list-units --all | grep -i athena
Viewing Logs
View Service Logs
sudo journalctl -u abngd -f
sudo journalctl -u abng-demux -f
sudo journalctl -u accel-ppp -f
View Last 100 Lines
sudo journalctl -u abngd -n 100
View Logs Since Startup
sudo journalctl -u abngd -b
Enabling/Disabling Services
Enable Service at Boot
sudo systemctl enable AthenaBNG.target
Disable Service at Boot
sudo systemctl disable AthenaBNG.target
Check if Enabled
sudo systemctl is-enabled AthenaBNG.target
Restarting Services
Restart All Services
sudo systemctl restart AthenaBNG.target
Restart Individual Service
sudo systemctl restart abngd
Service Dependencies
Services start in this order:
- abngd (core daemon)
- abng-demux (VLAN demux)
- accel-ppp (PPPoE)
- abng-dhcpd (DHCP)
- abng-qos (QoS)
- REST API (management)
- SNMP Agent (monitoring)
Troubleshooting
Service Failed to Start
sudo journalctl -u abngd -n 50
Service Stuck
sudo systemctl kill -s KILL abngd
sudo systemctl start abngd
Check Service Dependencies
systemctl list-dependencies AthenaBNG.target
Next Steps
- Monitoring — Monitoring and observability
- Troubleshooting — Common issues and solutions