From 962df04990ec693b965a3545bdcec09183371903 Mon Sep 17 00:00:00 2001 From: Eshenko Dmitriy Date: Tue, 28 Jan 2020 23:30:35 +0300 Subject: Add features load-balancing and maintenance-mode --- docs/services/pppoe-server.rst | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) (limited to 'docs/services') diff --git a/docs/services/pppoe-server.rst b/docs/services/pppoe-server.rst index 70511f4f..29cadd16 100644 --- a/docs/services/pppoe-server.rst +++ b/docs/services/pppoe-server.rst @@ -209,6 +209,36 @@ is working. Other attributes can be used, but they have to be in one of the dictionaries in /usr/share/accel-ppp/radius. + +Load Balancing +-------------- + +There exist PPPoE server session balancing mechanisms based on PADO packet delays. + +.. code-block:: none + + set service pppoe-server pado-delay 50 sessions '500' + set service pppoe-server pado-delay 100 sessions '1000' + set service pppoe-server pado-delay 300 sessions '3000' + +First 499 session connects without delay. PADO packets will be delayed 50 ms for connection from 500 to 999, this trick allows other PPPoE servers send PADO faster and clients will connect to other servers. Last command says that this PPPoE server can serve only 3000 clients. + + +Maintenance mode +---------------- + +For network maintenance, it's a good idea to direct users to a backup server so that the primary server can be safely taken out of service. It's possible to switch your PPPoE server to maintenance mode where it maintains already established connections, but refuses new connection attempts. + +.. code-block:: none + + vyos@vyos:~$ set pppoe-server maintenance-mode enable + +You can also cancel maintenance mode with the following command + +.. code-block:: none + + vyos@vyos:~$ set pppoe-server maintenance-mode cancel + Examples ======== -- cgit v1.2.3