No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

AR500, AR510, and AR530 V200R007 Commands Reference

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
PPPoE Commands

PPPoE Commands

NOTE:

AR502G-L-D-H, and AR502GR-L-D-H do not support PPPoE Server configurations.

display pppoe-client session

Function

The display pppoe-client session command displays information about PPPoE sessions on the PPPoE client, including the session status and statistics.

Format

display pppoe-client session { packet | summary } [ dial-bundle-number number ]

Parameters

Parameter Description Value
packet

Displays the packet statistics of PPPoE sessions.

-
summary

Displays summary of PPPoE sessions.

-
dial-bundle-number number

Displays statistics about a specified PPPoE session.

The value of number is an integer that ranges from 1 to 255. If this parameter is not specified, statistics about all PPPoE sessions are displayed.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To monitor PPPoE sessions on the PPPoE client, use this command to obtain the session status and statistics. You can locate PPPoE faults according to the command output.

Example

# Display the summary of all PPPoE sessions on the PPPoE client.

<Huawei> display pppoe-client session summary
PPPoE Client Session:
ID   Bundle  Dialer  Intf             Client-MAC    Server-MAC    State
1    1       1       GE1/0/0          00e0fc030201  0819a6cd0680  UP
Table 6-11  Description of the display pppoe-client session summary command output

Item

Description

ID

ID of a PPPoE session.

Bundle

Dialer bundle of the PPPoE session.

Dialer

Number of the dialer interface.

Intf

Physical interface to which the dialer interface is bound.

Client-MAC

MAC address of the PPPoE client.

Server-MAC

MAC address of the PPPoE server.

State

Status of the PPPoE session.
  • IDLE: indicates that the PPPoE session is idle.
  • PADI: indicates that the PPPoE session is at the Discovery stage and a PPPoE Active Discovery Initiation (PADI) packet has been sent.
  • PADR: indicates that the PPPoE session is at the Discovery stage and a PPPoE Active Discovery Request (PADR) packet has been sent.
  • UP: indicates that the PPPoE session has been established successfully.

# Display packet statistics of all PPPoE sessions on the PPPoE client.

<Huawei> display pppoe-client session packet
PPPoE Client Session:
ID     InP        InO        InD         OutP       OutO       OutD
1      36         758        0           50         1222       0
Table 6-12  Description of the display pppoe-client session packet command output

Item

Description

ID

ID of a PPPoE session.

InP

Number of received packets.

InO

Number of received bytes.

InD

Number of incoming packets that are discarded.

OutP

Number of sent packets.

OutO

Number of sent bytes.

OutD

Number of outgoing packets that are discarded.

display pppoe-server session

Function

The display pppoe-server session command displays information about PPPoE sessions on the PPPoE server, including the session status and statistics.

Format

display pppoe-server session { all | packet }

Parameters

Parameter Description Value
all Displays information about all PPPoE sessions. -
packet Displays the packet statistics of PPPoE sessions. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To monitor PPPoE sessions on the PPPoE server, use this command to obtain the session status and statistics. You can locate PPPoE faults according to the command output.

Example

# Display information about all PPPoE sessions on the PPPoE server.

<Huawei> display pppoe-server session all
Total Session: 1                                                                
SID      Intf                    State   OIntf           RemMAC         LocMAC
1        Virtual-Template1        UP     GE1/0/0        00e0.fc03.0201 0819.a6cd.0680
Table 6-13  Description of the display pppoe-server session all command output

Item

Description

Total Session

Total number of PPPoE sessions.

SID

ID of a PPPoE session.

Intf

Number of the virtual template interface corresponding to the PPPoE session.

State

Status of the PPPoE session.

OIntf

Ethernet interface on which the PPPoE session is established.

RemMAC

MAC address of the PPPoE client.

LocMAC

MAC address of the PPPoE server.

# Display the statistics about PPPoE sessions.

<Huawei> display pppoe-server session packet
SID     RemMAC       LocMAC         InP      InO   InD     OutP     OutO  OutD
1    00e0fc030201 0819a6cd0680       34      738     0       34      738     0
Table 6-14  Description of the display pppoe-server session packet all command output

Item

Description

SID

ID of a PPPoE session.

RemMAC

MAC address of the PPPoE client.

LocMAC

MAC address of the PPPoE server.

InP

Number of received packets.

InO

Number of received bytes.

InD

Number of incoming packets that are discarded.

OutP

Number of sent packets.

OutO

Number of sent bytes.

OutD

Number of outgoing packets that are discarded.

ppp keepalive in-traffic check

Function

The ppp keepalive in-traffic check command disables the device functioning as a PPPoE server from sending heartbeat packets when it receives packets.

The undo ppp keepalive in-traffic check command enables the virtual template interface to send heartbeat packets when it receives packets..

By default, the device functioning as a PPPoE server periodically sends heartbeat packets.

Format

ppp keepalive in-traffic check

undo ppp keepalive in-traffic check

Parameters

None

Views

Virtual template view

Default Level

2: Configuration level

Usage Guidelines

When a large number of users access the device functioning as a PPPoE server to decrease occupation of network resources by heartbeat packets, you can run the ppp keepalive in-traffic check command to disable the device from sending heartbeat packets when it receives packets.

Example

# Disable the device functioning as a PPPoE server from sending heartbeat packets when it receives packets.

<Huawei> system-view
[Huawei] interface virtual-template 10
[Huawei-Virtual-Template10] ppp keepalive in-traffic check

pppoe-client dial-bundle-number

Function

The pppoe-client dial-bundle-number command specifies a dialer bundle of a PPPoE session on an interface.

The undo pppoe-client dial-bundle-number command unbinds the dialer bundle from the PPPoE session.

By default, no dialer bundle is specified.

Format

pppoe-client dial-bundle-number number [ on-demand ] [ no-hostuniq ] [ ppp-max-payload value ] [ service-name name ]

undo pppoe-client dial-bundle-number number

Parameters

Parameter Description Value
number Specifies the dialer bundle of a PPPoE session. The value is an integer that ranges from 1 to 255. This parameter uniquely identifies a PPPoE session and can be used as the ID of a PPPoE session.
on-demand Configures on-demand dialing on the PPPoE client. -
no-hostuniq Indicates that the session initiated by the PPPoE client does not contain the Host-Uniq field.

By default, the session initiated by the PPPoE client contains the Host-Uniq field.

-
ppp-max-payload value Specifies the maximum value of the MTU of PPP negotiation during the establishment of a PPPoE session. The value is an integer that ranges from 64 to 1976. The default value is 1500.
service-name name Specifies the value of the Service-Name field in packets sent by a PPPoE client in the Discovery stage.

When users want to establish sessions with the PPPoE server providing specific services, specify service-name in this command.

The value is a string of 1 to 128 case-sensitive characters without spaces and special characters such as asterisk (*), question mask (?), and quotation mask (").

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A PPPoE session can be created on a physical Ethernet interface.

NOTE:
The Ethernet interface must be a WAN-side Ethernet interface. LAN-side Ethernet interfaces do not support PPPoE.

Prerequisites

A dialer interface has been configured and the dialer bundle has been specified for the dialer interface.

Precautions

  • If on-demand is not specified, the PPPoE session works in permanent online mode. If this parameter is specified, the PPPoE session works in on-demand dialing mode. The device supports the packet triggering mode for on-demand dialing.

    • In permanent online mode, the device initiates a PPPoE session immediately after the physical link becomes Up. The PPPoE session persists until you use the undo pppoe-client dial-bundle-number command to delete it.
    • In triggered online mode, the device does not initiate a PPPoE session immediately after the physical link becomes Up. Instead, the device initiates a PPPoE session only when data needs to be transmitted on the link. If no data is transmitted on the PPPoE link within the interval specified by dialer timer idle seconds, the device terminates the PPPoE session. When data needs to be transmitted on the PPPoE link, the device sets up the PPPoE session again.
    NOTE:
    • The undo pppoe-client dial-bundle-number command deletes a PPPoE session permanently regardless of the working mode of the session. To establish the session again, run the pppoe-client dial-bundle-number command.
    • Multiple PPPoE sessions can be established on an Ethernet interface. That is, an Ethernet interface can belong to multiple dialer bundles. A dialer bundle can contain only one Ethernet interface. One dialer bundle maps one PPPoE session. If the dialer bundle of a dialer interface already has an Ethernet interface used for PPPoE, no interface can be added to the dialer bundle. If the dialer bundle contains other interfaces, no Ethernet interface can be added to the dialer bundle to establish PPPoE sessions on the PPPoE client.

  • If no-hostuniq is not specified, the PPPoE session initiated by the PPPoE client contains the Host-Uniq field. The PPPoE client uses this field to associate an access server response with a particular host request, which ensures strict check.

Example

# Specify dialer bundle 1 for the PPPoE session on GE1/0/0.

<Huawei> system-view
[Huawei] interface gigabitethernet 1/0/0
[Huawei-GigabitEthernet1/0/0] pppoe-client dial-bundle-number 1

ppp lcp sn accept

Function

The ppp lcp sn accept command configures a PPPoE client to allow for serial number (SN) negotiation during the LCP negotiation.

The undo ppp lcp sn accept command restores the default setting.

By default, a PPPoE client is not allowed to perform SN negotiation during the LCP negotiation.

Format

ppp lcp sn accept

undo ppp lcp sn accept

Parameters

None

Views

Dialer interface view

Default Level

2: Configuration level

Usage Guidelines

To enhance access security for PPPoE users, a PPPoE server can authenticate the SNs of PPPoE clients by actively requesting SNs from PPPoE clients during LCP the negotiation. When the device functioning as a PPPoE client receives such a request from the PPPoE server, the device does not return its SN during LCP negotiation. As a result, the PPPoE server cannot authenticate the SN of the PPPoE client.

To resolve this problem, you can run the ppp lcp sn accept command to configure the PPPoE client to allow for SN negotiation.

Example

# Configure a PPPoE client to allow for SN negotiation during the LCP negotiation.

<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] ppp lcp sn accept
Related Topics

ppp lcp imsi accept

Function

The ppp lcp imsi accept command configures a PPPoE client to allow for international mobile subscriber identity (IMSI) negotiation during the LCP negotiation.

The undo ppp lcp imsi accept command restores the default setting.

By default, a PPPoE client is not allowed to perform IMSI negotiation during the LCP negotiation.

Format

ppp lcp imsi accept

undo ppp lcp imsi accept

Parameters

None

Views

Dialer interface view

Default Level

2: Configuration level

Usage Guidelines

To enhance access security for PPPoE users, a PPPoE server can authenticate the IMSIs of PPPoE clients by actively requesting IMSIs from PPPoE clients during LCP the negotiation. When the device functioning as a PPPoE client receives such a request from the PPPoE server, the device does not return its IMSI during LCP negotiation. As a result, the PPPoE server cannot authenticate the IMSI of the PPPoE client.

To resolve this problem, you can run the ppp lcp imsi accept command to configure the PPPoE client to allow for IMSI negotiation.

Example

# Configure a PPPoE client to allow for IMSI negotiation during the LCP negotiation.

<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] ppp lcp imsi accept
Related Topics

pppoe-server bind virtual-template

Function

The pppoe-server bind virtual-template command binds a virtual template interface to an Ethernet interface and enables PPPoE on the Ethernet interface.

The undo pppoe-server bind virtual-template command disables PPPoE on an interface.

By default, PPPoE is disabled.

Format

pppoe-server bind virtual-template vt-number

undo pppoe-server bind

Parameters

Parameter Description Value
vt-number Specifies the number of a virtual template interface. The value is an integer that ranges from 0 to 1023.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the device functions as the PPPoE server, it authenticates PPPoE clients and allocates IP addresses to PPPoE clients. The pppoe-server bind virtual-template command binds a virtual template interface to an Ethernet interface. The virtual template specifies the authentication mode and IP addresses.

NOTE:
The Ethernet interface must be a WAN-side Ethernet interface. LAN-side Ethernet interfaces do not support PPP.

Prerequisites

The virtual template interface has been created.

Precautions

  • A physical interface can bind only one VT.

  • This command specifies a physical link for the virtual template interface.

  • When configuring a static route passing through a virtual interface, specify the next hop IP address but not the outbound interface. To specify the outbound interface, ensure that the virtual template interface is bound to a physical interface in Up state; otherwise, packets cannot be transmitted using this route.

NOTE:

Restarting a card or removing and reinstalling a card will cause interruption of PPPoE services. Therefore, exercise caution when performing these operations. Before you restart a card or remove and reinstall a card, run the shutdown command to shut down interfaces on the card.

Example

# Bind virtual template interface 1 to GE1/0/0 and enable PPPoE.

<Huawei> system-view
[Huawei] interface gigabitethernet 1/0/0
[Huawei-GigabitEthernet1/0/0] pppoe-server bind virtual-template 1

pppoe-server max-sessions local-mac

Function

The pppoe-server max-sessions local-mac command sets the maximum number of PPPoE sessions that can be created on a MAC address of the device that functions as the PPPoE server.

The undo pppoe-server max-sessions local-mac command restores the default setting.

By default, a maximum of 128 PPPoE sessions can be created on a MAC address of the device except AR510 and AR500 series that functions as the PPPoE server. A maximum of 4 PPPoE sessions can be created on a MAC address of the AR510 series that function as the PPPoE server.

Format

pppoe-server max-sessions local-mac number

undo pppoe-server max-sessions local-mac

Parameters

Parameter Description Value
number

Specifies the maximum number of PPPoE sessions that can be created on a MAC address of the device.

The value is an integer that ranges from 1 to 128 except AR510 and AR500 series. The value is an integer that ranges from 1 to 4 for AR510 series.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

This command limits the maximum number of PPPoE sessions that can be created on a MAC address of the device that functions as the PPPoE server.

Example

# Set the maximum number of PPPoE sessions that can be created on a MAC address of the device to 15.

<Huawei> system-view
[Huawei] pppoe-server max-sessions local-mac 15

pppoe-server max-sessions total

Function

The pppoe-server max-sessions total command sets the maximum number of PPPoE sessions that can be created on the device.

The undo pppoe-server max-sessions total command restores the default setting.

By default, a maximum of 128 PPPoE sessions can be created on the device except AR510 and AR500 series. A maximum of 4 PPPoE sessions can be created on AR510 series.

Format

pppoe-server max-sessions total number

undo pppoe-server max-sessions total

Parameters

Parameter Description Value
number Specifies the maximum number of PPPoE sessions that can be created on the device.

The value is an integer that ranges from 1 to 128 except AR510 and AR500 series. The value is an integer that ranges from 1 to 4 for AR510 series.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

This command limits the number of access users on the device.

Example

# Set the maximum number of PPPoE sessions that can be created on the device to 15.

<Huawei> system-view
[Huawei] pppoe-server max-sessions total 15

pppoe-server service-name

Function

The pppoe-server service-name command sets the name of the server that starts the PPPoE service on an interface.

The undo pppoe-server service-name command restores the default setting.

By default, the name of the server that starts the PPPoE service on an interface is an empty character string.

Format

pppoe-server service-name name

undo pppoe-server service-name

Parameters

Parameter Description Value
name Specifies the name of the server that starts the PPPoE service on an interface. The value is a string of 1 to 128 case-sensitive characters without any space, asterisk (*), question mark (?), or quotation mark (").

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To establish sessions between users and the specified PPPoE server, you can run the pppoe-server service-name command to specify the name of the server that starts the PPPoE service on an interface.

Pre-configuration Task

The PPPoE service is started on the interface using the pppoe-server bind virtual-template command.

Example

# Set IP-Service as the name of the server that starts the PPPoE service on the interface GE1/0/0.

<Huawei> system-view
[Huawei] interface gigabitethernet 1/0/0
[Huawei-GigabitEthernet1/0/0] pppoe-server bind virtual-template 1
[Huawei-GigabitEthernet1/0/0] pppoe-server service-name IP-Service

pppoe-server log enable

Function

The pppoe-server log enable command enables logging of PPPoE user state changes.

The undo pppoe-server log enable command disables logging of PPPoE user state changes.

By default, logging of PPPoE user state changes is disabled.

Format

pppoe-server log enable

undo pppoe-server log enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

You can run the pppoe-server log enable command to enable logging of PPPoE user state changes. The PPPoE server then records information about the Up/Down protocol state during user access, and you can check the user state changes.

Example

# Enable logging of PPPoE user state changes.

<Huawei> system-view
[Huawei] pppoe-server log enable

reset pppoe-client

Function

The reset pppoe-client command resets all PPPoE sessions or a specified PPPoE session on the PPPoE client. After a PPPoE session is reset, the PPPoE client will establish the session later.

Format

reset pppoe-client { all | dial-bundle-number number }

Parameters

Parameter Description Value
all

Resets all PPPoE sessions on the PPPoE client.

-
dial-bundle-number number

Resets the specified PPPoE session.

The value is an integer that ranges from 1 to 255.

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The PPP parameters of a PPPoE session set after a PPP link is created do not take effect immediately. To make the parameter settings effective, run the reset pppoe-client command to reset the PPPoE session. The parameter settings take effect after the PPPoE session is established again.

Configuration Impact

If all is specified, all the online PPPoE users are disconnected. If dial-bundle-number is specified, the PPPoE users that dial up from the specified dialer interface are disconnected.

If a PPPoE session in permanent online mode is reset, the device will establish the session again after 16 seconds. If a PPPoE session in packet triggered mode is reset, the device will establish the session again when data needs to be transmitted using the session.

NOTE:
The reset pppoe-client command terminates PPPoE sessions temporarily, and the sessions will be established later; the undo pppoe-client dial-bundle-number command deletes PPPoE sessions permanently.

Example

# Reset the PPPoE session created on dialer bundle 1.

<Huawei> reset pppoe-client dial-bundle-number 1

reset pppoe-server

Function

The reset pppoe-server command terminates all PPPoE sessions or a specified PPPoE session on the PPPoE server.

Format

reset pppoe-server { all | interface interface-type interface-number | virtual-template number }

Parameters

Parameter Description Value
all

Terminates all PPPoE sessions on the PPPoE server.

-
interface interface-type interface-number

Terminates the PPPoE session on the specified physical interface.

-
virtual-template number

Terminates the PPPoE session on the specified virtual template interface.

The value of number is an integer that ranges from 0 to 1023.

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To disconnect users from the device or trigger re-negotiation, terminate PPPoE sessions.

Configuration Impact

If all is specified, all the online PPPoE users are disconnected. If interface interface-type interface-number is specified, the PPPoE users that dial up from this interface are disconnected. If virtual-template number is specified, the PPPoE users that dial up from the physical interface bound to this virtual template interface are disconnected.

User services are interrupted when PPPoE sessions are terminated; therefore, use the reset pppoe-server command with caution.

Example

# Terminate PPPoE sessions on GE1/0/0.

<Huawei> reset pppoe-server interface gigabitethernet 1/0/0
Translation
Download
Updated: 2019-05-29

Document ID: EDOC1000097293

Views: 89280

Downloads: 122

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next