04-Network Connectivity Command Reference

HomeSupportResource CenterH3C Access Points Cloud Mode Command References(E2442 R2442)-6W10004-Network Connectivity Command Reference
09-PPP commands
Title Size Download
09-PPP commands 81.74 KB

PPPoE commands

PPPoE client commands

dialer bundle enable

Use dialer bundle enable to enable bundle DDR on a dialer interface.

Use undo dialer bundle enable to disable bundle DDR on a dialer interface.

Syntax

dialer bundle enable

undo dialer bundle enable

Default

Bundle DDR is disabled on a dialer interface.

Views

Dialer interface view

Predefined user roles

network-admin

Usage guidelines

DDR includes traditional DDR and bundle DDR.

Before using bundle DDR, use this command to enable bundle DDR on a dialer interface. Then assign physical interfaces to the corresponding dialer bundle by using the dialer bundle-member command. To enable bundle DDR to receive calls, configure the dialer peer-name command on the dialer interface.

After you configure this command on a dialer interface already enabled with traditional DDR, the system clears the original traditional DDR settings.

The undo dialer bundle enable command clears all bundle DDR settings on the dialer interface.

Examples

# Enable bundle DDR on Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer bundle enable

 

 

dialer diagnose

Use dialer diagnose to configure DDR to operate in diagnostic mode.

Use undo dialer diagnose to restore the default.

Syntax

dialer diagnose [ interval interval ]

undo dialer diagnose

Default

DDR operates in non-diagnostic mode.

Views

Dialer interface view

Predefined user roles

network-admin

Parameters

interval: Specifies the diagnostic interval in the range of 5 to 65535 seconds. The default is 120 seconds.

Usage guidelines

This command takes effect only when a dialer interface is used with PPPoE client applications.

In diagnostic mode, the device performs the following operations:

·     Dials a PPPoE connection immediately after the device configurations are complete.

·     Automatically terminates the connection.

·     Starts the auto-dial timer after a configurable diagnostic interval.

·     Redials a connection when the auto-dial timer expires.

By establishing and terminating PPPoE sessions periodically, you can monitor the operating status of the PPPoE link.

In diagnostic mode, the link idle-timeout timer is ignored.

Examples

# Configure Dialer 1 to operate in diagnostic mode, with a diagnostic interval of 300 seconds.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer diagnose interval 300

Related commands

dialer timer autodial

dialer timer idle

dialer timer autodial

Use dialer timer autodial to set the auto-dial timer.

Use undo dialer timer autodial to restore the default.

Syntax

dialer timer autodial autodial-interval

undo dialer timer autodial

Default

The auto-dial timer is 300 seconds.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

autodial-interval: Specifies the interval between auto-dial attempts, in the range of 1 to 604800 seconds.

Usage guidelines

This command takes effect only when the autodial keyword is specified in the dialer number or dialer route command. DDR automatically dials the dial string at the specified interval until a connection is established. In the auto-dial method, dial attempts are not traffic triggered. Once a connection is established, it will not disconnect based on the idle timer mechanism.

Examples

# Set the auto-dial timer to 60 seconds on Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer timer autodial 60

dialer timer idle

Use dialer timer idle to set the link idle-timeout timer.

Use undo dialer timer idle to restore the default.

Syntax

dialer timer idle idle [ in | in-out ]

undo dialer timer idle

Default

The link idle-timeout timer is 120 seconds, and only outgoing interesting packets reset this timer.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

idle: Specifies the link idle-timeout timer value in the range of 0 to 65535 seconds.

in: Allows only incoming interesting packets to reset the timer.

in-out: Allows both incoming and outgoing interesting packets to reset the timer.

Usage guidelines

The link idle-timeout timer starts when a link is established. If no interesting packets arrive before the timer expires, DDR disconnects the link.

If you do not specify the in or in-out keyword, only outgoing interesting packets reset the timer.

If the timer is set to 0, DDR will never disconnect the link. For a PPPoE client application, if the timer is set to 0, a dialup connection is created automatically and remains active permanently.

Examples

# Set the link idle-timeout timer to 50 seconds on Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer timer idle 50

dialer-group

Use dialer-group to assign a dialup interface to a dialer group.

Use undo dialer-group to restore the default.

Syntax

dialer-group group-number

undo dialer-group

Default

A dialup interface does not belong to any dialer group.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

group-number: Specifies a dialer group by its number in the range of 1 to 255. Before the assignment, you must create the dialer group by using the dialer-group rule command.

Usage guidelines

A dialup interface can belong to only one dialer group. If you configure this command multiple times, the most recent configuration takes effect.

You must configure this command for DDR to send packets.

Examples

# Assign Dialer 1 to dialer group 1.

<Sysname> system-view

[Sysname] dialer-group 1 rule acl 3101

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer-group 1

Related commands

dialer-group rule

dialer-group rule

Use dialer-group rule to create a dialer group and configure a dial rule for it.

Use undo dialer-group rule to delete a dialer group.

Syntax

dialer-group group-number rule { ip | ipv6 } { deny | permit | acl { acl-number | name acl-name } }

undo dialer-group group-number rule [ ip | ipv6 ]

Default

No dialer group exists.

Views

System view

Predefined user roles

network-admin

Parameters

group-number: Specifies the number of the dialer group to be created, in the range of 1 to 255.

ip: Specifies the IPv4 protocol.

ipv6: Specifies the IPv6 protocol.

deny: Denies packets of the specified protocol.

permit: Permits packets of the specified protocol.

acl acl-number: Specifies an ACL by its number in the range of 2000 to 3999.

name acl-name: Specifies an ACL by its name.

Usage guidelines

A dial rule determines when an interface initiates DDR calls. You need to configure dial rules only on the initiator of DDR calls.

You can configure a dial rule to match only IP packets or use an ACL to match packets.

Permitted protocol packets or packets that match a permit statement of an ACL are interesting packets. When receiving an interesting packet, DDR performs one of the following operations:

·     Sends it out and resets the idle-timeout timer if a link is present.

·     Originates a new call to establish a link if no link is present.

Denied protocol packets or packets that match a deny statement of an ACL are uninteresting packets. When receiving an uninteresting packet, DDR performs one of the following operations:

·     Sends it out without resetting the idle-timeout timer if a link is present.

·     Drops it if no link is present.

For DDR to forward packets correctly, you must configure a dial rule and associate it with the dialup interface by using the dialer-group command.

Examples

# Create dialer group 1 and configure DDR to place calls for IPv4 packets. Associate Dialer 1 with dialer group 1.

<Sysname> system-view

[Sysname] dialer-group 1 rule ip permit

[Sysname] interface dialer 1

[Sysname-Dialer] dialer-group 1

# Create dialer group 1 and configure DDR to place calls for IPv6 packets. Associate Dialer 1 with dialer group 1.

<Sysname> system-view

[Sysname] dialer-group 1 rule ipv6 permit

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer-group 1

display pppoe-client session packet

Use display pppoe-client session packet to display the protocol packet statistics for a PPPoE session.

Syntax

display pppoe-client session packet [ dial-bundle-number number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

dial-bundle-number number: Specifies the dialer bundle number corresponding to a PPPoE session. The value range for the number argument is 0 to 1023.  If you do not specify this option, the command displays the protocol packet statistics for all PPPoE sessions.

Examples

# Display the protocol packet statistics for all PPPoE sessions.

<Sysname> display pppoe-client session packet

Bundle:    1                     Interface:  GE1/0/1

InPackets: 19                    OutPackets: 19

InBytes:   816                   OutBytes:   816

InDrops:   0                     OutDrops:   0

 

Bundle:    2                     Interface:  GE1/0/1

InPackets: 18                    OutPackets: 18

InBytes:   730                   OutBytes:   730

InDrops:   0                     OutDrops:   0

Table 1 Command output

Field

Description

Bundle

Dialer bundle to which a PPPoE session belongs.

Interface

Ethernet interface where the PPPoE session is present.

InPackets

Number of packets received.

OutPackets

Number of packets transmitted.

InBytes

Number of bytes received.

OutBytes

Number of bytes transmitted.

InDrops

Number of discarded incoming packets.

OutDrops

Number of discarded outgoing packets.

 

Related commands

reset pppoe-client session packet

display pppoe-client session summary

Use display pppoe-client session summary to display summary PPPoE session information.

Syntax

display pppoe-client session summary [ dial-bundle-number number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

dial-bundle-number number: Specifies the dialer bundle number corresponding to a PPPoE session. The value range for the number argument is 0 to 1023. If you do not specify this option, the command displays summary information for all PPPoE sessions.

Examples

# Display summary information for all PPPoE sessions.

<Sysname> display pppoe-client session summary

Bundle ID    Interface    VA          RemoteMAC      LocalMAC       State

1      1     GE1/0/1      VA0         00e0-1400-4300 00e0-1500-4100 SESSION

2      1     GE1/0/2      VA1         00e0-1500-4300 00e0-1600-4100 SESSION

Table 2 Command output

Field

Description

Bundle

Dialer bundle to which the PPPoE session belongs.

Interface

Ethernet interface where the PPPoE session is present.

VA

Virtual access interface created for the PPPoE session.

RemoteMAC

MAC address of the remote end.

LocalMAC

MAC address of the local end.

State

PPPoE session state:

·     IDLE—Initialization state.

·     PADI SENT—A PPPoE Active Discovery Initiation (PADI) packet has been sent, and a PPPoE Active Discovery Offer (PADO) packet is being expected.

·     PADR SENT—A PPPoE Active Discovery Request (PADR) packet has been sent, and a PPPoE Active Discovery Session-confirmation (PADS) packet is being expected.

·     SESSION—The PPPoE session has been successfully established.

 

mtu

Use mtu to set the maximum transmission unit (MTU) of a dialer interface.

Use undo mtu to restore the default.

Syntax

mtu size

undo mtu

Default

The MTU of dialer interfaces is 1500 bytes.

Views

Dialer interface view

Predefined user roles

network-admin

Parameters

size: Specifies the MTU in bytes. The value range for this argument is 128 to 1500.

Usage guidelines

The MTU setting of a dialer interface affects the fragmentation and reassembly of IP packets.

Examples

# Set the MTU of Dialer 1 to 1200 bytes.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] mtu 1200

 

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 ]

undo pppoe-client dial-bundle-number number

Default

No PPPoE session is established.

Views

Layer 3 Ethernet interface/subinterface view

VLAN interface view

Predefined user roles

network-admin

Parameters

dial-bundle-number number: Specifies the dialer bundle number corresponding to a PPPoE session. A dialer bundle number uniquely identifies a PPPoE session. It can also be used as a PPPoE session ID. The value range for the number argument is 0 to 1023.

no-hostuniq: Configures the client not to carry the Host-Uniq field in discovery packets. If you do not specify this keyword, the client carries the Host-Unique field. The Host-Unique field uniquely identifies a PPPoE client when an interface is configured with multiple PPPoE sessions. When the PPPoE server receives a packet with this field, it must include this field unmodified in the response packet. The device identifies the PPPoE client where the response packet belongs based on the Host-Unique field in the response packet.

Examples

# Establish a PPPoE session on VLAN-Interface 1.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] pppoe-client dial-bundle-number 1

reset pppoe-client

Use reset pppoe-client to reset a PPPoE session corresponding to a dialer bundle.

Syntax

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

Views

User view

Predefined user roles

network-admin

Parameters

all: Resets all the PPPoE sessions.

dial-bundle-number number: Specifies a dialer bundle by its number. The value range for the number argument is 0 to 1023.

Usage guidelines

A PPPoE session in permanent mode and terminated by this command will be established again when the auto dial timer expires.

A PPPoE session in on-demand mode and terminated by this command will be established again only when there is a need for data transmission.

Examples

# Reset all PPPoE sessions.

<Sysname> reset pppoe-client all

Related commands

dialer timer autodial

reset pppoe-client session packet

Use reset pppoe-client session packet to reset the protocol packet statistics for a PPPoE session.

Syntax

reset pppoe-client session packet [ dial-bundle-number number ]

Views

User view

Predefined user roles

network-admin

Parameters

dial-bundle-number number: Specifies the dialer bundle number corresponding to a PPPoE session. The value range for the number argument is 0 to 1023. If you do not specify this option, the command resets the protocol packet statistics for all PPPoE sessions.

Examples

# Reset the protocol packet statistics for all PPPoE sessions.

<Sysname> reset pppoe-client session packet

Related commands

display pppoe-client session packet