This is an old revision of the document!

RADIUSdesk Accel-ppp Agent

Overview

• The RADIUSdesk Acell-ppp Agent is a lightweight add-on to Ubuntu or Raspberry Pi devices that serves as a broker between Acell-ppp and RADIUSdesk.
• It uses a couple of Lua based libraries and scripts to fulfill its mandate.

Installation

Please double check

• Make sure the iptables package is installed. (It was not installed on my Raspberry Pi OS image)

sudo apt-get install iptables

• Make sure packet forwarding for IPv4 is enabled. Edit the /etc/sysctl.conf.
• Find and uncomment net.ipv4.ip_forward=1 line.

The Rest

• We assume you already have a device that has Acell-ppp installed as per instructions elsewhere on this Wiki.
• Install the following packages.

sudo apt-get install -y curl lua-socket lua-cjson luarocks
sudo luarocks install inifile

• Check out the latest RADIUSdesk code

cd /var/www
sudo git clone https://github.com/RADIUSdesk/rdcore.git
#Link the accel-ppp agent's files to /etc directory
ln -s /var/www/rdcore/cake4/rd_cake/setup/accel-ppp/MESHdesk /etc/MESHdesk

Configuration

Startup and config file

• Copy the following reference files:

#config file for the agent
sudo cp /etc/MESHdesk/files/accel-ppp-rd.conf /etc/
#startup file. We make a backup first of the original one (of there were one)
cp /etc/rc.local /etc/rd.local.bak
sudo cp /etc/MESHdesk/files/rc.local /etc/

• Configuration is done by tweaking the /etc/accel-ppp-rd.conf file.
• Refer to the sample below

[internet]
disabled=0
dns=cloud.radiusdesk.com
protocol=https
http_port=80
https_port=443
ip=164.160.89.129
 
[pppoe]
interface=eth0

• In our setup we have a RADIUSdesk server which has a FQDN of cloud.radiusdesk.com
• We also specify the fallback ip as 164.160.89.129 in the event when DNS does not resolve.
• Protocol can be either https or http. We choose https which is more secure.
• We also specify the interface we want the PPPoE service to run on.
• In our case we have a Raspberry Pi 4 with an Enternet port (eth0) where we will run the PPPoE service on.
• The agent will then fetch the MAC Address of this interface and forward the request for config for the Accel-ppp server from RADIUSdesk using this MAC Address as the unique identifier.
• Make changes to this file so that it works with your environment and device.