Install on Ubuntu

Preparation

Before compile and build package need satisfy some dependencies

  • cmake - open-source system that manages the build process

  • gcc - GNU Compiler Collection (GCC) is a compiler system

  • linux-headers-`uname -r` - source code of current installing linux kernel, need for build ipoe and vlan_mon modules. If you don`t need these modules, you may don`t install this

  • git - version-control system for tracking changes, (need for downloading source code)

  • libpcre2-dev - source code of pcre2 lib, accel-ppp need it for use reg expression

  • libssl-dev - source code of ssl lib, accel-ppp need it for use regular expression

  • liblua5.1-0-dev - this need for create custom username (IPoE) from packet. Script write on lua language

apt-get install -y build-essential cmake gcc linux-headers-`uname -r` git libpcre2-dev libssl-dev liblua5.1-0-dev

After install dependencies, download accel-ppp source code with git client, tree master . Master tree contain actual patches last release.

git clone https://github.com/accel-ppp/accel-ppp.git /opt/accel-ppp-code

Create directory for build source code and go to this directory.

mkdir /opt/accel-ppp-code/build
cd /opt/accel-ppp-code/build/

For building code need we can set next params:

  • -DBUILD_IPOE_DRIVER=TRUE include IPoE module.This module need if you want use accel-ppp as shared interface.

  • -DBUILD_VLAN_MON_DRIVER=TRUE include vlan monitoring module. If you want create vlan automatically on analyse IP headers with regular expression set on accel-ppp config file. (Available for IPoE and PPPoE)

  • -DKDIR=/usr/src/linux-headers-`uname -r` sets path to Linux kernel source code. Need only for build IPOE, VLAN-MON.

  • -DCMAKE_INSTALL_PREFIX=/usr path for install executable code. If you build DEB package, not recommended change this.

  • -DCPACK_TYPE=Ubuntu18 this arguments for building DEB package. If used Ubuntu other version, set it. For example, if used Ubuntu 16 set -DCPACK_TYPE=Ubuntu16

cmake -DBUILD_IPOE_DRIVER=TRUE -DBUILD_VLAN_MON_DRIVER=TRUE -DCMAKE_INSTALL_PREFIX=/usr -DKDIR=/usr/src/linux-headers-`uname -r` -DLUA=TRUE -DCPACK_TYPE=Ubuntu18 ..

Notice:

ended symbols .. sets path to accel-ppp source code, not delete this! Or you can replace it full path to accel-ppp-code like /opt/accel-ppp-code/

Compile:

make

Create DEB package:

cpack -G DEB

Install package:

dpkg -i accel-ppp.deb

If you have success packet install, rename config file to accel-ppp.conf

mv /etc/accel-ppp.conf.dist /etc/accel-ppp.conf

Edit accel-ppp.conf for you schemas and run accel-ppp

Run as systemd unit:

systemctl start accel-ppp

or run manual (not recommended)

accel-pppd -d -c /etc/accel-ppp.conf -p /var/run/accel-ppp.pid