Skip to content
Ask AI

PPPoE Server Configuration

[Command] pppoe-server enable no pppoe-server enable

[Purpose] Enable PPPoE Server/Disable PPPoE Server

[View] System Configuration View

[Use Cases]

sonic# configure
sonic(config)# pppoe-server enable

[Command] show pppoe-session

[Purpose] View the established sessions of PPPoE Server

[View] System View

[Use Cases]

sonic# show pppoe-session
Id Iface SessionId RemoteMac RemoteIp LocalIp LocalIf PppoeServer Uptime
---- --------- ----------- ----------------- ------------- ------------ --------- -------------- --------
0 Ethernet3 1 60:eb:5a:01:75:50 192.168.18.10 192.168.18.1 ppp0 pppoe-server-1 0:05:54
Total number of entries 1

[Command] show pppoe-serverserver id

[Purpose] View detailed information on different PPPoE Server interfaces, including service operation status, core component statistics, PPPoE protocol statistics, session status, and more.

[View] System Configuration View

[Use Cases]

sonic# configure terminal
sonic# show pppoe-server 1
PPPoE-Server 1 stats:
uptime: 0.00:07:31
cpu: 0%
mem(rss/virt): 16192/187648 kB
core:
mempool_allocated: 2113954
mempool_available: 2110634
thread_count: 4
thread_active: 1
context_count: 7
context_sleeping: 0
context_pending: 0
md_handler_count: 6
md_handler_pending: 0
timer_count: 1
timer_pending: 0
sessions:
starting: 0
active: 1
finishing: 0
pppoe:
starting: 0
active: 1
delayed PADO: 0
recv PADI: 1
drop PADI: 0
sent PADO: 1
recv PADR(dup): 1(0)
sent PADS: 1
filtered: 0

[Command] ip-poolname

[Purpose] Configure address pool, such as referencing remote ip pool when configuring pppoe server interface.

[Parameter]

ParameterDescription
namecharacter configuration range: 1~32

[View] System Configuration View

[Use Cases]

sonic# configure terminal
sonic(config)# ip-pool pppoe-pool1

[Command] ip-maskip

[Purpose] Configure the IP address range in the address pool through masking, supporting IPV4/IPV6.

[Parameter]

ParameterDescription
ipA.B.C.D/mask or A::B/mask

[View] IP Pool Configuration View

[Use Cases]

sonic# configure terminal
sonic(config)# ip-pool pppoe-pool1
sonic(config-ippool-pppoe-pool1)# ip-mask 192.168.15.2/24

[Command] ip-rangestart-ip end-ip

[Purpose] Configure the IP address range in the address pool in a range based manner, supporting IPV4/IPV6; Support configuring multiple in one IP pool.

[Parameter]

ParameterDescription
start-ipA.B.C.D or A::B
end-ipA.B.C.D or A::B

[View] IP Pool Configuration View

[Use Cases]

sonic# configure terminal
sonic(config)# ip-pool pppoe-pool1
sonic(config-ippool-pppoe-pool1)# ip-range 192.168.15.10 192.168.15.20

[Command] interface pppoe-serverserver id

[Purpose] Configure the PPPoE Server interface to enter the PPPoE Server interface view for parameter configuration, which is used to receive client dial-up connections.

[Parameter]

ParameterDescription
Server IDrange: 0~7

[View] System Configuration View

[Use Cases]

sonic# configure terminal
sonic(config)# interface pppoe-server 1

[Command] ac-namestring

[Purpose] The full name of the access concentrator is’ access concentrator name ’, which defaults to’ device hostname - ppoe server - {id} ‘and is an optional configuration.

[Parameter]

ParameterDescription
stringcharacter range: 1~63

[View] PPPoE Server Interface View

[Use Cases]

sonic# configure terminal
sonic(config)# interface pppoe-server 1
sonic(config-if-pppoeserver-1)# ac-name pppoe-server-1

[Command] accept-any-service enable

no accept-any-service enable

[Purpose] After configuration, the server side allows the client to perform dial-up authentication with any service type.

[View] PPPoE Server Interface View

[Use Cases]

sonic# configure terminal
sonic(config)# interface pppoe-server 1
sonic(config-if-pppoeserver-1)# accept-any-service enable

[Command] accept-blank-service enable

no accept-blank-service enable

[Purpose] Once enabled, the server allows traffic without a service type to proceed with dial-up authentication, but it requires the server to simultaneously configure a service-name, while the client-side service-name must be left empty.

[View] PPPoE Server Interface View

[Use Cases]

sonic# configure terminal
sonic(config)# interface pppoe-server 1
sonic(config-if-pppoeserver-1)# accept-blank-service enable

[Command] dns-serverA.B.C.D

[Purpose] Specify the DNS server address assigned to the client.

[View] PPPoE Server Interface View

[Use Cases]

sonic# configure terminal
sonic(config)# interface pppoe-server 1
sonic(config-if-pppoeserver-1)# dns-server 8.8.8.8

[Command] keepaliveinterval

[Purpose] Set the LCP echo request interval time, disconnect the dead connection after exceeding the retry count, and the old session will be cleared after the default keepalive * 3 time, which is 10 seconds.

[Parameter]

ParameterDescription
intervalrange: 0~65535

[View] PPPoE Server Interface View

[Use Cases]

sonic# configure terminal
sonic(config)# interface pppoe-server 1
sonic(config-if-pppoeserver-1)# keepalive 10

[Command] local-ipA.B.C.D mask

[Purpose] Set the IP address of the PPPoE server local end, which is the layer 3 address used to establish PPP connections, and be careful not to conflict with the remote ip pool.

[View] PPPoE Server Interface View

[Use Cases]

sonic# configure terminal
sonic(config)# interface pppoe-server 1
sonic(config-if-pppoeserver-1)# local-ip 192.168.18.1 255.255.255.0

[Command] mruvalue

[Purpose] Set the maximum receiving unit on the server side to 1492 by default, and negotiate with the MRU value on the client side to obtain the final receiving unit size, which is generally based on the client side; The ifconfig command can be used to view the final MTU value in the PPP interface to determine the negotiation result. The MTU value on the server side is completely determined by the MRU negotiation result, otherwise the default value of 1492 will be used.

[Parameter]

ParameterDescription
valuereceiving unit range: 1312~10218

[View] PPPoE Server Interface View

[Use Cases]

sonic# configure terminal
sonic(config)# interface pppoe-server 1
sonic(config-if-pppoeserver-1)# mru 1400

[Command] ppp chap usernameusername password

[Purpose] Configure local users supported by PPPoE server, support configuring multiple users/deleting multiple users.

[View] PPPoE Server Interface View

[Use Cases]

sonic# configure terminal
sonic(config)# interface pppoe-server 1
sonic(config-if-pppoeserver-1)# ppp chap username test1 test1

[Command] remote-ip-poolpool name

[Purpose] Configure the IP address range assigned by the PPPoE server to the client and specify the configured IP pool.

[Parameter]

ParameterDescription
pool nameconfiguration range: 1~32

[View] PPPoE Server Interface View

[Use Cases]

sonic# configure terminal
sonic(config)# interface pppoe-server 1
sonic(config-if-pppoeserver-1)# remote-ip-pool pppoe-pool1

[Command] service-namestring

[Purpose] Configure the service name of the PPPoE server, which is empty by default and an optional field; Support configuring multiple.

[Parameter]

ParameterDescription
stringconfiguration range: 1~63

[View] PPPoE Server Interface View

[Use Cases]

sonic# configure terminal
sonic(config)# interface pppoe-server 1
sonic(config-if-pppoeserver-1)# service-name BroadbandService

[Command] session-maxvalue

[Purpose] Configure the maximum concurrent PPPoE sessions allowed by the PPPoE server, with no limit by default.

[Parameter]

ParameterDescription
valueconfiguration range: 1~65535

[View] PPPoE Server Interface View

[Use Cases]

sonic# configure terminal
sonic(config)# interface pppoe-server 1
sonic(config-if-pppoeserver-1)# session-max 20