Commands for PPoE server

20.1 debug pppoe-server

Command: debug pppoe-server {discovery | lcp | auth | ipcp | receive | send | error}
no debug pppoe-server {discovery | lcp | auth | ipcp | receive | send | error}
Function: Enable debugging (on/off) of the pppoe-server.
Parameters:

  • discovery: DISCOVERY stage debug.
  • lcp: debug LCP.
  • auth: debug authentication.
  • ipcp: debug IPCP.
  • receive: debug receive packet.
  • send: debug send packet.
  • error: debug errors.

Command mode: Admin Mode
Default: Disabled.
Usage guide: Enable debugging (on/off) of the designated parameter. This command is for users experienced in PPPoE. Use Ctrl+O to disable this debugging command.
Example: Enable error debugging of the PPPoE server.

active500EM#debug pppoe-server error

 

20.2 interface virtual-template

Command: interface virtual-template <1-255>
no interface virtual-template <1-255>
Function: Create/cancel a virtual template.
Parameters:

  • <1-255>: Virtual template number.

Command mode: Global Mode
Default: No templates.
Usage guide: Each virtual template can be applied to a specific VLAN. Enable the PPPoE server on the VLAN to bind the virtual template. This provides PPPoE access for the client.
Example: Create a virtual template of 1 on the AC.

active500EM(config)#interface virtual-template 1

 

20.3 ip address

Command: ip address <A.B.C.D> <A.B.C.D>
no ip address <A.B.C.D> <A.B.C.D>
Function: Set/cancel the virtual template IP address as the PPPoE server address.
Parameters:

  • <A.B.C.D>: IP address.
  • <A.B.C.D>: address mask.

Command mode: Virtual Template Configuration Mode
Default: No IP address configuration as default.
Usage guide: Set/cancel the virtual template IP address and enter the IPCP configuration requisition packet information.
Example: Configure the PPPoE server address to 1.1.1.2 and the mask as 255.255.255.0.

active500EM(config-if-VT1)#ip address 1.1.1.2 255.255.255.0

 

20.4 ip pppoe pool pool-name

Command: ip pppoe pool <WORD> <A.B.C.D> <A.B.C.D>
no ip pppoe pool <WORD>
Function: Set/cancel the IP address pool function. This is used to distribute the client IP address.
Parameters

  • <WORD>: Pool name <1-32> character.
  • <A.B.C.D>: the prefix of the address.
  • <A.B.C.D>: the mask of the address.

Command mode: Global Mode
Default: No address pools.
Usage guide: The configured address pool can be applied to the virtual template to distribute addresses for the PPPoE client of a VLAN.
Example: Set the PPPoE address pool to A on the AC; the address prefix is 192.168.1.0 and the mask is 255.255.255.0.

active500EM(config)#ip pppoe pool A 192.168.1.0 255.255.255.0

 

20.5 max-terminate-request

Command: max-terminate-request <mtr-limit>
no max-terminate-request
Function: Configure/recover the max times for sending the termination requisition packets.
Parameters:

  • <mtr-limit>: maximum times the termination requisition is sent; range is 1-3.

Command mode: Virtual Template Configuration Mode
Default: 2 times.
Usage guide: Configure/recover max number of times the termination requisition packets can be sent. If the response of the client is not received before disconnecting a session, send the maximum mtr-limit times the PPPoE termination requisition packet can be sent before the session ends.
Example: Configure max-terminate-request to 3 times.

active500EM(config-if-VT1)#max-terminate-request 3

 

20.6 no pppoe-server session

Command: no pppoe-server session {<peer-ip> | <session-id>}
Function: Disconnect the session connection.
Parameters:

  • <peer-ip>: IP address of session client.
  • <session-id>: session ID.

Command mode: Global Mode/Virtual Template Configuration Mode
Default: None.
Usage guide: Disconnect the session connection and release the resource that the session occupied.
Example: Release the session connection with client 192.168.1.1.

active500EM(config)#no pppoe-server session 192.168.1.1

 

20.7 ppp account-statistics enable

Command: ppp account-statistics enable
no ppp account-statistics enable
Function: Enable/disable PPP accounting statistics. Statistics include the number of packets and bytes that flow through the link (ingress and egress). The AAA application module can display flow statistic information, which can be used for verification.
Parameters: None.
Command mode: Virtual Template Configuration Mode
Default: Do not count.
Usage guide: When enabled, all sessions send accounting starting packets to the accounting server and send the updating packets regularly. When disabled, all sessions send accounting ending packets to accounting server.
Example: Enable PPP accounting statistic function.

active500EM(config-if-VT1)#ppp account-statistics enable

 

20.8 ppp authentication-mode

Command: ppp authentication-mode (pap | chap)
Function: Configure the default authentication mode of the PPP protocol, including PAP and CHAP authentication. Use CHAP authentication as the default.
Parameters:

  • pap: PAP authentication.
  • chap: CHAP authentication.

Command mode: Virtual Template Configuration Mode
Default: CHAP authentication.
Usage guide: PAP (Password Authentication Protocol) is the two-handshake verification to check that the password is valid. CHAP (Challenge-Handshake Authentication Protocol) is three-way handshake verification. The password is ciphertext (key).
Example: Configure the authentication mode of the PPP protocol to CHAP.

active500EM(config-if-VT1)#ppp authentication-mode chap

 

20.9 ppp ipcp dns

Command: ppp ipcp dns <A.B.C.D> <A.B.C.D>
no ppp ipcp dns
Function: Configure the DNS host server and the aide server for the virtual template and issue it to the client.
Parameters:

  • <A.B.C.D>: the host server.
  • <A.B.C.D>: the aide server.

Command mode: Virtual Template Configuration Mode
Default: There is no DNS server configuration.
Usage guide: Configures to enable saving in the virtual template configuration and issues to the client in IPCP consulting.
Example: Configure the host dns of ppp ipcp as 2.2.2.2 and the aide dns as 3.3.3.3.

active500EM(config-if-VT1)#ppp ipcp dns 2.2.2.2 3.3.3.3

 

20.10 ppp lcp max-echo-interval

Command: ppp lcp max-echo-interval <interval>
no ppp lcp max-echo-interval
Function: Configure/recover the interval of the client response after sending the LCP keep-alive requisition packet.
Parameters:

  • <interval>: response interval; range is 1 to 10s.

Command mode: Virtual Template Configuration Mode
Default: 3s.
Usage guide: Configure/recover the interval of the client response after sending the LCP keep-alive requisition packet. If the client does not give the response in this interval, trigger the next requisition. After the set requisition times, disconnect this session if there is still no response.
Example: Configure max-echo-interval to 5s.

active500EM(config-if-VT1)#ppp lcp max-echo-interval 5

 

20.11 ppp lcp max-echo-request

Command: ppp lcp max-echo-request <reqnum>
no ppp lcp max-echo-request
Function: Configure/recover interval of the sending LCP keep-alive requisition packets.
Parameters:

  • <reqnum>: sending times; range is 1 to 10.

Command mode: Virtual Template Configuration Mode
Default: 5.
Usage guide: Configure/recover the number of requests for sending the keep-alive requisition packets. At a certain time interval, send the requisition once and await for the client response. After the set number of requests, if there is still no response, disconnect the session.
Example: Configure max-echo-request to 10 times.

active500EM(config-if-VT1)#ppp lcp max-echo-request 10

 

20.12 ppp lcp mru

Command: ppp lcp mru <mru>
no ppp lcp mru
Function: Configure the maximum receiving LCP packet size in data bytes.
Parameters:

  • <mru>: maximum received unit; range is 1 to 1-1492 bytes.

Command mode: Virtual Template Configuration Mode
Default: 1492.
Usage guide: Configure/recover the maximum receiving size in bytes of LCP packets. This notifies the client server on the maximum data bytes of packets it can receive.
Example: Configure mru as 1000.

active500EM(config-if-VT1)#ppp lcp mru 1000

 

20.13 ppp negotiate-timeout

Command: ppp negotiate-timeout <time-out>
no ppp negotiate-timeout
Function: Configure/recover the PPP negotiation timeout.
Parameters:

  • <time-out>: timeout; range is 1 to 10s.

Command mode: Virtual Template Configuration Mode
Default: 3s.
Usage guide: If the response of the client cannot be received, reissue the consulting configuration requisition; if the response is still not received in the set number of requisitions, disconnect the connection.
Example: Configure the consulting timeout of PPP to 10s.

active500EM(config-if-VT1)#ppp negotiate-timeout 10

 

20.14 pppoe-server bind radius-group

Command: pppoe-server bind radius-group WORD
no pppoe-server bind radius-group WORD
Function: Configure the associated radius server groups.
Parameters:

  • WORD: radius server name.

Command mode: Global Mode
Default: No configuration.
Usage guide: Save the configured server group name globally. It is used to partipate based on AAA requests.
Example: Configure the associated RADIUS server group as AAA1.

active500EM(config)#pppoe-server bind radius-group aaa1

 

20.15 pppoe-server bind virtual-template

Command: pppoe-server bind virtual-template <vtid>
no pppoe-server bind virtual-template <vtid>
Function: Enable/disable server bind of the virtual template.
Parameters:

  • <vtid>: virtual template ID; range is 1 to 255.

Command mode: Virtual Template Configuration Mode
Default: Server does not bind the virtual template.
Usage guide: When enabled, the PPPoE server binds to this VLAN and uses the virtual template configuration to handle the requisition that the VLAN received. When disabled, this VLAN no longer provides PPPoE service and releases all sessions.
Example: Bind the virtual template 1 to vlan 1.

active500EM(config-if-vlan1)#pppoe-server bind virtual-template 1

 

20.16 pppoe-server enable

Command: pppoe-server enable
no pppoe-server enable
Function: Enable/disable pppoe server function globally.
Parameters: None.
Command mode: Global Mode
Default: Disabled.
Usage guide: After the PPPOE server function is enabled, the PPPOE packets can be intercepted. After this function is disabled, other configurations will not be deleted, but the port can no longer receive PPPoE packets.
Example: Enable PPPoE server function on the AC.

active500EM(config)#pppoe-server enable

 

20.17 pppoe-server max-sessions

Command: pppoe-server max-sessions <limit>
no pppoe-server max-sessions
Function: Configure/recover the maximum number of sessions. If the number exceeds this restriction, the session connection will no longer be created.
Parameters:

  • <limit>: maximum number of sessions restricted; range is 1 to 2048.

Command mode: Global Mode
Default: 2048 sessions can be created as default.
Usage guide: This command is used to limit the number of sessions. If the number exceeds this restriction, the session connection will not longer be created. The no command resets to default.
Example: Limit the number of PPPoE sessions to 100.

active500EM(config)#pppoe-server max-sessions 100

 

20.18 remote address pppoe-pool WORD

Command: remote address pppoe-pool WORD
no remote address pppoe-pool WORD
Function: The virtual template enables/abandons the IP address pool.
Parameters:

  • WORD: address pool name.

Command mode: Virtual Template Configuration Mode
Default: Do not enable address pool.
Usage guide: The virtual template enables the IP address pool and distributes addresses for clients from this pool. When it abandons the pool, all sessions are deleted under the virtual template and the addresses are removed.
Example: Enable PPPoE address pool A on virtual template 1.

active500EM(config-if-VT1)#remote address pppoe-pool A

 

20.19 show interface virtual-template

Command: show interface virtual-template <vtid>
Function: Show the appointed virtual template information.
Parameters:

  • <vtid>: Virtual template number, range <1-255>.

Command mode: Any Mode
Default: None.
Usage guide: When the configurations in show run are exceeded, use this command to view the configuration information of the virtual-template.
Example: View the configuration information of virtual-template 1.

active500EM(config)#show interface virtual-template 1

 

20.20 show pppoe-server session

Command: show pppoe-server session {interface virtual-template <vtid> | all}
Function: Show the session information of the designated template or information for all sessions.
Parameters

  • <vtid>: Virtual template number, range <1-255>.
  • All: all sessions.

Command mode: Any Mode
Default: None.
Usage guide: Print session information of the designated template or information for all sessions.
Example: View the session information of virtual-template 1.

active500EM(config)#show pppoe-server session interface virtual-template 1
276