Contents

PPPoE commands· 1

PPPoE server commands· 1

display pppoe-server session· 1

pppoe-server abnormal-offline-count threshold· 2

pppoe-server abnormal-offline-percent threshold· 2

pppoe-server bind· 3

pppoe-server log-information off 3

pppoe-server max-sessions local-mac· 4

pppoe-server max-sessions remote-mac· 5

pppoe-server max-sessions total 5

pppoe-server normal-offline-percent threshold· 6

reset pppoe-server 6

PPPoE client commands· 7

display pppoe-client session· 7

pppoe-client 8

reset pppoe-client 10

 

PPPoE commands

Support for the commands in this chapter depends on the device model. For more information, see About the H3C Access Controllers Command References.

PPPoE server commands

display pppoe-server session

Use display pppoe-server session to display information about PPPoE sessions on a device operating as a PPPoE server.

Syntax

display pppoe-server session all [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

all: Displays all the information about PPPoE sessions.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display all the information about PPPoE sessions. (Assume the current device is operating as a PPPoE server.)

<Sysname> display pppoe-server session all

Total PPPoE Session(s): 2

 

SID   Intf                      State OIntf          RemMAC       LocMAC

1     Virtual-Template1:0       UP    Vlan2         00e015004100 00e014004300

2     Virtual-Template2:0       UP    Vlan2         00e016004100 00e015004300

Table 1 Command output

Field	Description
SID	PPPoE session ID.
Intf	Virtual-template interface.
State	PPPoE session state.
OIntf	Corresponding VLAN interface.
RemMAC	Peer MAC address.
LocMAC	Local MAC address.

 

pppoe-server abnormal-offline-count threshold

Use pppoe-server abnormal-offline-count threshold to set the upper threshold for the PPPoE abnormal offline event count in 5 minutes.

Use undo pppoe-server abnormal-offline-count threshold to restore the default.

Syntax

pppoe-server abnormal-offline-count threshold number

undo pppoe-server abnormal-offline-count threshold

Default

The upper threshold for the PPPoE abnormal offline event count in 5 minutes is 65535.

Views

System view

Default command level

2: System level

Parameters

number: Specifies the upper threshold for the PPPoE abnormal offline event count in 5 minutes, in the range of 0 to 65535.

Usage guidelines

If the PPPoE abnormal offline event count in the last 5 minutes exceeds this threshold, the system outputs a trap message.

Examples

# Set the upper threshold for the PPPoE abnormal offline event count in 5 minutes to 100.

<Sysname> system-view

[Sysname] pppoe-server abnormal-offline-count threshold 100

pppoe-server abnormal-offline-percent threshold

Use pppoe-server abnormal-offline-percent threshold to set the upper threshold for the PPPoE abnormal offline event percentage in 5 minutes.

Use undo pppoe-server abnormal-offline-percent threshold to restore the default.

Syntax

pppoe-server abnormal-offline-percent threshold number

undo pppoe-server abnormal-offline-percent threshold

Default

The upper threshold for the PPPoE abnormal offline event percentage in 5 minutes is 100.

Views

System view

Default command level

2: System level

Parameters

number: Specifies the upper threshold for the PPPoE abnormal offline event percentage, in the range of 0 to 100.

Usage guidelines

If the PPPoE abnormal offline event percentage in the last 5 minutes exceeds this threshold, the system outputs a trap message.

PPPoE abnormal offline event percentage = 100 x Abnormal offline event count/(Abnormal offline event count + Normal offline event count).

Examples

# Set the upper threshold for the PPPoE abnormal offline event percentage to 10.

<Sysname> system-view

[Sysname] pppoe-server abnormal-offline-percent threshold 10

Related commands

pppoe-server normal-offline-percent threshold

pppoe-server bind

Use pppoe-server bind to enable PPPoE on a VLAN interface and bind the VLAN interface to a VT interface.

Use undo pppoe-server bind to disable PPPoE on a VLAN interface.

Syntax

pppoe-server bind virtual-template number

undo pppoe-server bind

Default

PPPoE is disabled.

Views

Interface view

Default command level

2: System level

Parameters

virtual template number: Specifies a VT interface by its number in the range of 0 to 1023.

Examples

# Enable PPPoE on interface Vlan-interface 1 and bind the VLAN interface to interface VT 1.

<Sysname> system-view

[Sysname] interface Vlan-interface 1

[Sysname-Vlan-interface1] pppoe-server bind virtual-template 1

pppoe-server log-information off

Use pppoe-server log-information off to disable PPP log displaying on a device operating as a PPPoE server.

Use undo pppoe-server log-information off to restore the default.

Syntax

pppoe-server log-information off

undo pppoe-server log-information off

Default

PPP log displaying is enabled on a PPPoE server.

Views

System view

Default command level

2: System level

Usage guidelines

With PPP log displaying enabled, large amounts of log information can affect device performance and be a nuisance to users during configuration. You can disable PPP log displaying by using the pppoe-server log-information off command.

Examples

# Disable PPP log displaying.

<Sysname> system-view

[Sysname] pppoe-server log-information off

pppoe-server max-sessions local-mac

Use pppoe-server max-sessions local-mac to set the maximum number of PPPoE sessions allowed with regard to the local MAC address on a device operating as a PPPoE server.

Use undo pppoe-server max-sessions local-mac to restore the default.

Syntax

pppoe-server max-sessions local-mac number

undo pppoe-server max-sessions local-mac

Default

The maximum number of PPPoE sessions allowed with regard to the local MAC address is 100.

Views

System view

Default command level

2: System level

Parameters

number: Specifies the maximum number of sessions allowed with regard to the local MAC address, in the range of 1 to 20480.

Examples

# Set the maximum number of PPPoE sessions allowed with regard to the local MAC address to 50. (Assume the device is operating as a PPPoE server.)

<Sysname> system-view

[Sysname] pppoe-server max-sessions local-mac 50

pppoe-server max-sessions remote-mac

Use pppoe-server max-sessions remote-mac to set the maximum number of PPPoE sessions allowed with regard to a peer MAC address.

Use undo pppoe-server max-sessions remote-mac to restore the default.

Syntax

pppoe-server max-sessions remote-mac number

undo pppoe-server max-sessions remote-mac

Default

The maximum number of PPPoE sessions allowed with regard to a peer MAC address is 100.

Views

System view

Default command level

2: System level

Parameters

number: Specifies the maximum number of PPPoE sessions that the entire system can establish with a peer MAC address, in the range of 1 to 4096.

Examples

# Set the maximum number of PPPoE sessions allowed with regard to a peer MAC address to 50.

<Sysname> system-view

[Sysname] pppoe-server max-sessions remote-mac 50

pppoe-server max-sessions total

Use pppoe-server max-sessions total to set the maximum number of PPPoE sessions allowed.

Use undo pppoe-server max-sessions total to restore the default.

Syntax

pppoe-server max-sessions total number

undo pppoe-server max-sessions total

Default

The maximum number of PPPoE sessions allowed is 4096.

Views

System view

Default command level

2: System level

Parameters

number: Specifies the maximum number of PPPoE sessions allowed, in the range of 1 to 20480.

Examples

# Set the maximum number of PPPoE sessions allowed to 3000 in the system.

<Sysname> system-view

[Sysname] pppoe-server max-sessions total 3000

pppoe-server normal-offline-percent threshold

Use pppoe-server normal-offline-percent threshold to set the lower threshold for the PPPoE normal offline event percentage.

Use undo pppoe-server normal-offline-percent threshold to restore the default.

Syntax

pppoe-server normal-offline-percent threshold number

undo pppoe-server normal-offline-percent threshold

Default

The lower threshold for the PPPoE normal offline event percentage is 0.

Views

System view

Default command level

2: System level

Parameters

number: Specifies the lower threshold for the PPPoE normal offline event percentage, in the range of 0 to 100.

Usage guidelines

If the PPPoE normal offline event percentage in the last 5 minutes is lower than this threshold, the system outputs a trap message.

PPPoE normal offline event percentage = 100 – PPPoE abnormal offline event percentage.

Examples

# Set the lower threshold for the PPPoE normal offline event percentage to 10.

<Sysname> system-view

[Sysname] pppoe-server normal-offline-percent threshold 10

Related commands

pppoe-server abnormal-offline-percent threshold

reset pppoe-server

Use reset pppoe-server to terminate a PPPoE session on the PPPoE server side.

Syntax

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

Views

User view

Default command level

2: System level

Parameters

all: Terminates all the PPPoE sessions.

interface interface-type interface-number: Specifies a port by its type and number.

virtual-template number: Specifies a VT interface by its number.

Examples

# Terminate the session established based on interface Virtual-template 1 on the PPPoE server side.

<Sysname> reset pppoe-server virtual-template 1

PPPoE client commands

display pppoe-client session

Use display pppoe-client session to display information about a PPPoE session.

Syntax

display pppoe-client session { packet | summary } [ dial-bundle-number number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

packet: Displays the packet statistics on PPPoE sessions.

summary: Displays PPPoE session summary.

dial-bundle-number number: Displays the statistics on a PPPoE session. The number argument ranges from 1 to 255. If this option is not specified, this command displays the statistics on all the PPPoE sessions.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display PPPoE session summary.

<Sysname> display pppoe-client session summary

PPPoE Client Session:

ID   Bundle  Dialer  Intf             RemMAC        LocMAC        State

1    1       1       GE1/0/5          00e014004300  00e015004100  PPPUP

Table 2 Command output

Field	Description
ID	PPPoE session ID.
Bundle	Dialer bundle to which a PPPoE session belongs.
Dialer	Dialer interface corresponding to a PPPoE session.
Intf	Ethernet interface where the PPPoE session is present.
RemMAC	Remote MAC address.
LocMAC	Local MAC address.
State	PPPoE session state. PPPoE session state is the PPP protocol state. PPPUP indicates that PPP negotiation is successful.

 

# Display the packet statistics on PPPoE sessions.

<Sysname> display pppoe-client session packet

PPPoE Client Session:

  ID: 1                            Interface: GE1/0/5

  InPackets: 19                    OutPackets: 19

  InBytes:   816                   OutBytes:   816

  InDrops:   0                     OutDrops:   0

Table 3 Command output

Field	Description
ID	PPPoE session ID.
Interface	Ethernet interface corresponding to a PPPoE session.
InPackets	Number of packets received.
InBytes	Size of received packets (in bytes).
InDrops	Number of discarded incoming packets.
OutPackets	Number of packets sent.
OutBytes	Size of sent packets (in bytes).
OutDrops	Number of discarded outgoing packets.

 

pppoe-client

Use pppoe-client to establish a PPPoE session and specify the dialer bundle corresponding to the session.

Use undo pppoe-client to remove a PPPoE session.

Syntax

pppoe-client dial-bundle-number number [ no-hostuniq ] [ diagnose [ interval seconds ] | idle-timeout seconds [ queue-length packets ] ]

undo pppoe-client dial-bundle-number number

Default

The Host-Uniq field is carried.

Default

No PPPoE session is established.

Views

Ethernet interface view, VLAN interface view

Default command level

2: System level

Parameters

dial-bundle-number number: Specifies the dialer bundle number corresponding to a PPPoE session, in the range of 1 to 255. A dialer bundle number uniquely identifies a PPPoE session, it can also be used as a PPPoE session ID.

no-hostuniq: Specifies the client not to carry the Host-Uniq field. diagnose: Specifies the operating mode of the PPPoE session to diagnostic.

interval seconds: Specifies the interval (in seconds) between two diagnostic PPPoE sessions. The seconds argument ranges from 5 to 65535. The default value is 120.

idle-timeout seconds: Specifies the PPPoE session idle time. The seconds argument ranges from 1 to 65535. If this option is specified, the PPPoE session operates in packet-triggered mode; if this option and the diagnose keyword are not specified, the PPPoE session established operates in permanent mode. queue-length packets: Specifies the number of the packets that can be cached before the PPPoE session is established. The packets argument ranges from 1 to 100 and defaults to 10. This option becomes valid only when the idle-timeout keyword is configured.

Usage guidelines

You can establish multiple PPPoE sessions on an Ethernet interface, or an Ethernet interface can belong to multiple dialer bundles. However, a dialer bundle can correspond to only one Ethernet interface. Each PPPoE session uniquely corresponds to a dialer bundle. If an Ethernet interface in a dialer bundle of a dialer interface is used to establish a PPPoE session, you cannot add any interfaces to the dialer bundle. Likewise, if a dialer bundle contains interfaces other than the PPPoE Ethernet interface, this dialer bundle cannot be added to an Ethernet interface operating as a PPPoE client.

A PPPoE session operates in one of the following modes:

·     Permanent mode—If you configure the pppoe-client command without specifying the idle-timeout seconds option or the diagnose keyword, the device initiates a PPPoE call to establish a PPPoE session immediately if the physical line is up. After the PPPoE session is established, it can only be terminated by the undo pppoe-client command.

·     Packet-triggered mode—If you configure the pppoe-client command with the idle-timeout seconds option specified, the device tries to establish the PPPoE session only when it has data to transmit. For a PPPoE session operating in this mode, if no data is transmitted across it within the period specified by the seconds argument, the PPPoE session is terminated automatically.

·     Diagnostic mode—If you configure the pppoe-client command with the diagnose keyword specified, the device initiates a PPPoE call to establish a PPPoE session immediately after this command is configured, and terminates the current PPPoE session and then establishes another PPPoE session each time the interval specified by interval seconds expires. By periodically establishing and terminating PPPoE sessions, this function can be used to detect whether the PPPoE link is normal. Only one diagnostic PPPoE session can be established on each device.

The difference between the reset pppoe-client command and the undo pppoe-client command lies in that the former only temporarily terminates a PPPoE session, but the latter permanently removes a PPPoE session.

After you configure the undo pppoe-client command, the PPPoE session identified by the number argument is removed permanently, regardless of the operating mode of the PPPoE session. To use the PPPoE session again, you must establish it from scratch.

Examples

# Establish a PPPoE session on interface GigabitEthernet 1/0/5.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/5

[Sysname-GigabitEthernet1/0/5] pppoe-client dial-bundle-number 1

Related commands

reset pppoe-client

reset pppoe-client

Use reset pppoe-client to reset a PPPoE session corresponding to a dialer bundle for the PPPoE session to be initiated again.

Syntax

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

Views

User view

Default command level

2: System level

Parameters

all: Clears all the PPPoE sessions.

dial-bundle-number number: Specifies a dialer bundle by its number. The number argument ranges from 1 to 255.

Usage guidelines

A PPPoE session in permanent mode and terminated by this command will be established again in 16 seconds. A PPPoE session in packet-triggered mode and terminated by this command will be established again only when there is a need for data transmission.

The difference between the reset pppoe-client command and the undo pppoe-client command lies in: the former only temporarily terminates a PPPoE session, but the latter permanently removes a PPPoE session.

Examples

# Reset all the PPPoE sessions.

<Sysname> reset pppoe-client all

Related commands

pppoe-client