Skip to main content

Troubleshooting

Common issues and solutions.

Sessions Not Appearing​

Check Prerequisites​

  1. VLAN demux enabled

    abng> show configuration | match demux

  2. VLAN interfaces created

    abng> show vlans

  3. RADIUS reachable

    radtest testuser testpass <radius-ip> 1812 <secret>

Check Logs​

sudo journalctl -u abngd -f
sudo journalctl -u accel-ppp -f
sudo journalctl -u abng-dhcpd -f

Sessions Disconnecting Frequently​

Check Network Stability​

ping -c 100 <upstream-router>

Check LCP Echo Settings​

abng> show configuration | match lcp_echo

Check RADIUS Timeout​

Increase RADIUS timeout in config if network is slow.

Check Logs​

sudo journalctl -u accel-ppp -f
sudo journalctl -u abng-dhcpd -f

Sessions Not Getting IP​

Check RADIUS Configuration​

abng> show configuration | match radius

Test RADIUS​

radtest testuser testpass <radius-ip> 1812 <secret>

Verify RADIUS Returns IP​

Expected output should include:

Framed-IP-Address = 203.0.113.100

Check Logs​

sudo journalctl -u abngd -f
sudo journalctl -u accel-ppp -f

QoS Not Applying​

Check QoS Enabled​

abng> show configuration | match qos

Check CAKE Qdisc​

tc qdisc show dev ppp0

Check Session Active​

abng> show subscribers

Check Logs​

sudo journalctl -u abng-qos -f

VLAN Interfaces Not Created​

Check Demux Enabled​

abng> show configuration | match demux

Check Trunk Interface Up​

ip link show eth1

Check for Matching Packets​

tcpdump -i eth1 -e 'ether[12:2] == 0x8100'

Check Logs​

sudo journalctl -u abng-demux -f

VLAN Interfaces Not Cleaned Up​

Check Idle Timeout​

abng> show configuration | match idle_timeout

Check Active Sessions​

abng> show subscribers

Check Interface Traffic​

ethtool -S eth1.111.500.100

Service Failed to Start​

Check Service Status​

sudo systemctl status abngd

View Error Logs​

sudo journalctl -u abngd -n 50

Restart Service​

sudo systemctl restart abngd

Socket Connection Error​

Check Socket Exists​

ls -la /opt/athena-bng/run/abngd.sock

Check Service Running​

sudo systemctl status abngd

Restart Service​

sudo systemctl restart abngd

High CPU Usage​

Check Active Sessions​

abng> show subscribers | count

Check CAKE Stats​

tc -s qdisc show

Check System Load​

top -b -n 1 | head -20

High Memory Usage​

Check Memory Stats​

free -h

Check Process Memory​

ps aux | grep -E 'abngd|abng-demux|accel-ppp'

Check VLAN Interface Count​

ip link show | grep -c "eth1\."

Next Steps​