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

Command Reference

AR500, AR510, and AR530 V200R007

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).
PPP Configuration Commands

PPP Configuration Commands

display ppp compression iphc rtp

Function

The display ppp compression iphc rtp command displays RTP/UDP/IP header compression statistics in IPHC.

Format

display ppp compression iphc rtp [ interface interface-type interface-number ]

Parameters

Parameter Description Value
interface interface-type interface-number

Displays RTP/UDP/IP header compression statistics on a specified interface.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view the following information:

  • Statistics on received packets, including the number of compressed packets, number of error packets, number of discarded packets, and total number of all received packets

  • Statistics on sent packets, including the number of compressed packets, number of all packets, number of sent bytes, number of saved bytes, and total number of all sent bytes

Example

# Display RTP/UDP/IP header compression statistics on Dialer0 in IPHC.

<Huawei> display ppp compression iphc rtp interface dialer 0
IPHC: RTP/UDP/IP header compression                                             

  Interface: Dialer0                                                      
    Received:                                                                   
      Compress/Error/Discard/Total: 0/0/0/0 (Packets)                           
    Sent:                                                                       
      Compress/Total: 0/0 (Packets)                                             
      Send/Save/Total: 0/0/0 (Bytes)                                            
Connect:   
  Rx/Tx: 16/16                                                                 
      Long-search/Miss: 0/0    
Table 6-3  Description of the display ppp compression iphc rtp command output

Item

Description

IPHC

IP header compression statistics.

Interface

Interface to which header compression is applied.

Received

Statistics on received packets.

Compress/Error/Discard/Total

Number of compressed packets/Number of error packets/Number of discarded packets/Total number of all received IPHC RTP packets (including full header packets and compressed packets).

Sent

Statistics on sent packets.

Compress/Total

Number of compressed packets/Total number of all IPHC RTP packets sent (including full header packets and compressed packets).

Send/Save/Total

Number of sent bytes/Number of saved bytes/Total number of all sent bytes.

Connect

Statistics on compression entry queries.

Rx

Maximum number of data connections that can be decompressed when the device functions as the receiver.

Tx

Maximum number of data connections that can be compressed when the device functions as the transmitter.

Long-search/Miss

Number of compression entry queries/Number of compression entry query failures.

Related Topics

display ppp compression iphc tcp

Function

The display ppp compression iphc tcp command displays TCP/IP header compression statistics in IPHC.

Format

display ppp compression iphc tcp [ interface interface-type interface-number ]

Parameters

Parameter Description Value
interface interface-type interface-number

Displays TCP/IP header compression statistics on a specified interface.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view the following information:

  • Statistics on received packets, including the number of compressed packets, number of error packets, number of discarded packets, and total number of all received packets.

  • Statistics on sent packets, including the number of compressed packets, number of all packets, number of sent bytes, number of saved bytes, and total number of all sent bytes.

  • Number of compression entry queries and number of compression entry query failures.

Example

# Display TCP/IP header compression statistics on Dialer0 in IPHC.

<Huawei> display ppp compression iphc tcp interface dialer 0
IPHC: TCP/IP header compression                                                 
  Interface: Dialer0                                                      
    Received:                                                                   
      Compress/Error/Discard/Total: 0/0/0/0 (Packets)                           
    Sent:                                                                       
      Compress/Total: 0/0 (Packets)                                             
      Send/Save/Total: 0/0/0 (Bytes)                                            
    Connect:                                                                    
         Rx/Tx: 16/16                                                              
         Long-search/Miss: 0/0 
Table 6-4  Description of the display ppp compression iphc tcp command output

Item

Description

IPHC

IP header compression statistics.

Interface

Interface to which header compression is applied.

Received

Statistics on received packets.

Compress/Error/Discard/Total

Number of compressed packets/Number of error packets/Number of discarded packets/Total number of all received IPHC TCP packets (including full header packets and compressed packets).

Sent

Statistics on sent packets.

Compress/Total

Number of compressed packets/Total number of all IPHC TCP packets sent (including full header packets and compressed packets).

Send/Save/Total

Number of sent bytes/Number of saved bytes/Total number of all sent bytes.

Connect

Statistics on compression entry queries.

Rx

Maximum number of data connections that can be decompressed when the device functions as the receiver.

Tx

Maximum number of data connections that can be compressed when the device functions as the transmitter.

Long-search/Miss

Number of compression entry queries/Number of compression entry query failures.

Related Topics

display ppp compression stac-lzs

Function

The display ppp compression stac-lzs command displays Stac LZS compression statistics.

Format

display ppp compression stac-lzs [ interface interface-type interface-number ]

Parameters

Parameter Description Value
interface interface-type interface-number

Displays Stac LZS compression statistics on a specified interface.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display Stac LZS compression statistics on Dialer0.

<Huawei> display ppp compression stac-lzs interface dialer 0
Dialer0                                                                   
  sent:                                                                         
    CompressedPackets  = 0,  UnCompressedPackets  = 0                           
    CompressedOctets    = 0,  UnCompressedOctets    = 0                              
  receive:                                                                      
    CompressedPackets  = 0,  UnCompressedPackets  = 0                           
    CompressedOctets    = 0,  UnCompressedOctets     = 0                        
    DeCompressedPackets = 0, DeCompressedOctets = 0   
Table 6-5  Description of the display ppp compression stac-lzs command output

Item

Description

sent

Statistics on packets sent from the local device.

receive

Statistics on packets received by the local device.

CompressedPackets

Number of compressed packets.

UnCompressedPackets

Number of uncompressed packets.

CompressedOctets

Number of compressed bytes.

UnCompressedOctets

Number of uncompressed bytes .

DeCompressedPackets

Number of received compressed packets that are successfully decompressed and not discarded by the local device.

DeCompressedOctets

Number of received compressed bytes that are successfully decompressed and not discarded by the local device.

ip address ppp-negotiate

Function

The ip address ppp-negotiate command configures IP address negotiation on an interface to allow the interface to obtain an IP address from the remote device.

The undo ip address ppp-negotiate command cancels IP address negotiation.

By default, an interface does not obtain an IP address through PPP negotiation.

Format

ip address ppp-negotiate

undo ip address ppp-negotiate

Parameters

None

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the local interface runs PPP at the link layer but is not assigned an IP address, and the remote device has IP addresses, you can configure IP address negotiation on the local interface so that it can obtain an IP address from the remote device. For example, when the client accesses the Internet through an Internet Server Provider (ISP) network, it can obtain an IP address from the ISP.

Prerequisites

  • PPP has been configured as the link layer protocol of the interface.

  • The address assignment function has been enabled on the remote device.

Example

# Configure IP address negotiation on Dialer0.

<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] ip address ppp-negotiate

ip tcp vjcompress

Function

The ip tcp vjcompress command configures Van Jacobson Header Compression (VJHC) on an interface of a PPP link.

The undo ip tcp vjcompress command cancels the configuration.

By default, VJHC is not configured on an interface of a PPP link.

Format

ip tcp vjcompress

undo ip tcp vjcompress

Parameters

None

Views

3G cellular interface view, Dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

VJHC complies with RFC 1144 and is an algorithm for compressing TCP/IP packet headers on PPP links. The two devices on a PPP link use IP Control Protocol (IPCP) to negotiate with each other for VJHC capability, which improves transmission efficiency over PPP links. The two devices must negotiate with each other twice if packets sent on both directions of the PPP link need compression. The PPP field in an IP packet can be set to one of the following values:

  • 0021: IP packets.
  • 002d: compressed TCP packets. The original TCP/IP header of a packet is replaced by the compressed TCP/IP header.
  • 002f: uncompressed TCP packets.

A device does not compress a data packet if the packet header is not in the compression status list; instead, the device directly sends the packet with the PPP field 002f to the peer device and adds the packet header to the compression status list of the local device. When receiving the packet, the peer device adds the packet header to its compression status list.

Prerequisites

The link layer protocol on the interface has been set to PPP using the link-protocol ppp.

Precautions

VJHC compresses TCP/IP headers, while IPHC compresses TCP/IP headers or RTP/UDP/IP headers.

After running the ip tcp vjcompress command on an interface, restart the interface to make the configuration take effect.

You can restart an interface by using the following methods:
NOTE:

Ensure that the PPP link VJHC function is configured on the peer device; otherwise, the PPP compression negotiation between the two ends fails.

Example

# Configure VJHC on Dialer0.
<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] link-protocol ppp
[Huawei-Dialer0] ip tcp vjcompress
Related Topics

ppp authentication-mode

Function

The ppp authentication-mode command configures the PPP authentication mode in which the local device authenticates the remote device.

The undo ppp authentication-mode command restores the default configuration.

By default, PPP authentication is not performed.

Format

ppp authentication-mode { chap | pap } [ [ call-in ] domain domain-name ]

undo ppp authentication-mode

Parameters

Parameter Description Value
chap

Sets the PPP authentication mode to Challenge Handshake Authentication Protocol (CHAP) authentication.

-

pap

Sets the PPP authentication mode to Password Authentication Protocol (PAP) authentication.

NOTE:

In PAP authentication, passwords are transmitted in plain text on the network, bringing potential security risks. CHAP authentication is recommended.

-

call-in

Indicates that the local device authenticates users only when these users call in.

-

domain domain-name

Specifies the domain name used for user authentication.

NOTE:

The specified domain must have been created using the domain (AAA view) command.

The value is a string of 1 to 64 case-sensitive characters without any space, asterisk (*), question mark (?), or quotation mark (").

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a PPP link, the local device authenticates the remote device to improve security. Two PPP authentication modes are available:
  • PAP: It is a two-way handshake authentication protocol that transmits passwords in plain text.

    PAP is used on networks that do not require high security.

  • CHAP: It is a three-way handshake authentication protocol that transmits passwords in cipher text.

    On networks requiring high security, CHAP authentication is used to establish a PPP connection. In practice, CHAP authentication is widely used.

Prerequisites

PPP has been configured as the link layer protocol of the interface.

Configuration Impact

The local device performs PPP authentication on the remote device by using the authentication mode configured by the command. If PPP authentication fails, the two devices cannot communicate.

  • If a domain is specified, the domain is used as the user authentication domain.

  • If no domain is specified, and the user name sent from the remote device contains a domain name, this domain is used as the authentication domain. If the user name sent from the remote device does not contain any domain name, the default domain is used as the authentication domain.

Example

# Configure CHAP authentication on Dialer0.

<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] ppp authentication-mode chap

ppp chap password

Function

The ppp chap password command configures a password for CHAP authentication.

The undo ppp chap password command deletes the password of CHAP authentication.

By default, no password is configured for CHAP authentication.

Format

ppp chap password { cipher | simple } password

undo ppp chap password

Parameters

Parameter Description Value
cipher

Displays the password in cipher text.

-

simple

Displays the password in plain text.

NOTE:

When you specify simple, the password is saved in plain text in the configuration, which brings potential security risks. You are advised to specify cipher to save the password in the cipher text.

-

password

Specifies the password for CHAP authentication.

The value is a case-sensitive character string without spaces. If simple is specified, the password is in plain text and contains 1 to 32 characters. If cipher is specified, the password is either in cipher text containing 24 to 68 characters, for example, %^%#k5bf>8df@:_;Na'+R"U,#L#w88HE1M.L4Y Y2~W2u0%RDL#z#%^%#, or in plain text containing 1 to 32 characters, for example, 214357.

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the PPP authentication mode is set to CHAP authentication on the authenticator by using the ppp authentication-mode command, you must configure the user name and password for CHAP authentication on the authenticated party.

Prerequisites

The link layer protocol on the interface has been set to PPP using the link-protocol ppp.

Precautions

After the ppp chap password and ppp chap user commands are used, the device sends the configured password and user name to the remote device for authentication.

The ppp chap password command must be used on the authenticated device, and the configured password must be the same as that configured on the authenticating device.

Example

# Configure password huawei for CHAP authentication on Dialer0.

<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] ppp chap password cipher huawei@123

ppp chap user

Function

The ppp chap user command configures a user name for CHAP authentication.

The undo ppp chap user command deletes the user name of CHAP authentication.

By default, no user name is configured for CHAP authentication.

Format

ppp chap user username

undo ppp chap user

Parameters

Parameter Description Value
username

Specifies a user name for CHAP authentication.

The value is a string of 1 to 64 case-sensitive characters without spaces.

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the PPP authentication mode is set to CHAP authentication by using the ppp authentication-mode command, you must configure the user name and password for CHAP authentication.

Prerequisites

The link layer protocol on the interface has been set to PPP using the link-protocol ppp.

Precautions

After the ppp chap password and ppp chap user commands are used, the device sends the configured password and user name to the remote device for authentication.

The ppp chap user command must be used on the authenticated device, and the configured user name must be the same as that configured on the authenticating device.

Example

# Configure user name huawei for CHAP authentication on Dialer0.

<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] ppp chap user huawei

ppp compression iphc

Function

The ppp compression iphc command configures IP Header Compression (IPHC) on an interface of a PPP link.

The undo ppp compression iphc command cancels the configuration.

By default, IPHC is not configured on an interface of a PPP link.

Format

ppp compression iphc [ nonstandard ]

undo ppp compression iphc

Parameters

Parameter Description Value
nonstandard

Uses the nonstandard mode to compress RTP/UDP/IP headers.

NOTE:

If this parameter is not specified, the standard mode is used to compress RTP/UDP/IP headers.

-

Views

Dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

IPHC is an algorithm for compressing IP headers on PPP links. This algorithm compresses TCP/IP headers or RTP/IP headers to reduce the packet length and improve transmission efficiency over PPP links.

Prerequisites

The link layer protocol on the interface has been set to PPP using the link-protocol ppp.

Precautions

VJHC compresses TCP/IP headers, while IPHC compresses TCP/IP headers or RTP/UDP/IP headers.

After running the ppp compression iphc command on an interface, restart the interface to make the configuration take effect.

You can restart an interface by using the following methods:
NOTE:

Ensure that the PPP link IPHC function is configured on the peer device; otherwise, the PPP compression negotiation between the two ends fails.

Example

# Configure IPHC on Dialer0.
<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] link-protocol ppp
[Huawei-Dialer0] ppp compression iphc 
Related Topics

ppp compression iphc rtp-connections

Function

The ppp compression iphc rtp-connections command sets the maximum number of connections for RTP/UDP/IP header compression on an interface of a PPP link.

The undo ppp compression iphc rtp-connections command restores the default configuration.

By default, RTP/UDP/IP header compression is allowed on a maximum of 16 connections on an interface of a PPP link.

Format

ppp compression iphc rtp-connections number

undo ppp compression iphc rtp-connections

Parameters

Parameter Description Value
number

Sets the maximum number of connections for RTP/UDP/IP header compression.

The value is an integer that ranges from 3 to 1000.

Views

Dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Packets with the same source and destination addresses are transmitted on the same PPP link. You can run the ppp compression iphc rtp-connections number command to set the maximum number of connections for RTP/UDP/IP header compression over a PPP link. This configuration limits the number of packets that the device processes concurrently.

If the maximum numbers of connections for RTP/UDP/IP header compression are different on the compressing and decompressing ends, the smaller number takes effect after the negotiation using IP Control Protocol (IPCP).

Prerequisites

  1. The link layer protocol on the interface has been set to PPP using the link-protocol ppp.

  2. IPHC compression has been enabled on the interface of a PPP link using the ppp compression iphc command.

Precautions

RTP header compression is performed for the packets sent by multiple users when the packets pass through the PPP link. When the number of connections for RTP header compression exceeds the packet rate, the RTP header compression function may not take effect due to the compression aging mechanism. It is recommended that the number of connections for RTP header compression should be configured to be less than the packet rate (unit: pps).

NOTE:

If the compression aging mechanism is used, the device checks compression connections once every second and ages the compression connections that are not used recently.

Example

# Set the maximum number of connections for RTP/UDP/IP header compression on Dialer0 to 20 in IPHC.
<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] link-protocol ppp
[Huawei-Dialer0] ppp compression iphc
[Huawei-Dialer0] ppp compression iphc rtp-connections 20
Related Topics

ppp compression iphc tcp-connections

Function

The ppp compression iphc tcp-connections command sets the maximum number of connections for TCP/IP header compression on an interface of a PPP link.

The undo ppp compression iphc tcp-connections command restores the default configuration.

By default, TCP/IP header compression is allowed on a maximum of 16 connections on an interface of a PPP link.

Format

ppp compression iphc tcp-connections number

undo ppp compression iphc tcp-connections

Parameters

Parameter Description Value
number

Sets the maximum number of connections for TCP/IP header compression.

The value is an integer that ranges from 3 to 256.

Views

Dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Packets with the same source and destination addresses are transmitted on the same PPP link. You can run the ppp compression iphc tcp-connections number command to set the maximum number of connections for TCP/IP header compression over a PPP link. This configuration limits the number of packets that the device processes concurrently.

If the maximum numbers of connections for TCP/IP header compression are different on the compressing and decompressing ends, the smaller number takes effect after the negotiation using IP Control Protocol (IPCP).

Prerequisites

  1. The link layer protocol on the interface has been set to PPP using the link-protocol ppp.

  2. IPHC compression has been enabled on the interface of a PPP link using the ppp compression iphc command.

Example

# Set the maximum number of connections for TCP/IP header compression on Serial1/0/0 to 20 in IPHC.
<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] link-protocol ppp
[Huawei-Dialer0] ppp compression iphc
[Huawei-Dialer0] ppp compression iphc tcp-connections 20
Related Topics

ppp compression stac-lzs

Function

The ppp compression stac-lzs command configures Stac Lempel Ziv Standard (Stac LZS) compression on an interface of a PPP link.

The undo ppp compression stac-lzs command cancels the configuration.

By default, Stac LZS compression is not configured on an interface of a PPP link.

Format

ppp compression stac-lzs

undo ppp compression stac-lzs

Parameters

None

Views

3G cellular interface view, Dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Stac Lempel Ziv Standard (Stac LZS) compression, developed by Stac Electronics, is a standard of data compression at the link layer. Stac LZS compression compresses only the payload in a packet.

Before using Stac LZS compression, the two devices on a PPP link use the Compression Control Protocol (CCP) to negotiate with each other for a data compression algorithm. After the devices at both ends of a PPP link (an LCP link before authentication) complete authentication, the two devices check whether Stac LZS compression is enabled on the connected interfaces. If Stac LZS compression is enabled, the two devices start CCP negotiation. After CCP negotiation succeeds, the two devices transmit compressed data packets.

Prerequisites

The link layer protocol on the interface has been set to PPP using the link-protocol ppp.

Precautions

After running the ppp compression stac-lzs command on an interface, restart the interface to make the configuration take effect.

You can restart an interface by using the following methods:
NOTE:

Ensure that the PPP link STAC-LZS function is configured on the peer device; otherwise, the PPP compression negotiation between the two ends fails.

Example

# Configure Stac LZS compression on Dialer0.
<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] link-protocol ppp
[Huawei-Dialer0] ppp compression stac-lzs
Related Topics

ppp ipcp dns

Function

The ppp ipcp dns command enables the device to specify a DNS server address for the remote device.

The undo ppp ipcp dns command disables the device from specifying a DNS server address for the remote device.

By default, the device does not specify any DNS server address for the remote device.

Format

ppp ipcp dns primary-dns-address [ secondary-dns-address ]

undo ppp ipcp dns primary-dns-address [ secondary-dns-address ]

Parameters

Parameter Description Value
primary-dns-address

Specifies the IP address of a primary DNS server.

The value is in dotted decimal notation.

secondary-dns-address

Specifies the IP address of a secondary DNS server.

The value is in dotted decimal notation.

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a host connects to the device by using PPP and needs to use a domain name to access the Internet, the device must specify a DNS server address for the host.

Prerequisites

PPP has been configured as the link layer protocol of the interface.

Precautions

The ppp ipcp dns command cannot be used together with ppp ipcp dns admit-any or ppp ipcp dns request.

Example

# Specify a DNS server address for the remote device of Dialer0.

<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] ppp ipcp dns 10.10.10.10 10.10.10.11

ppp ipcp dns admit-any

Function

The ppp ipcp dns admit-any command configures the device to accept the DNS server address specified by the remote device.

The undo ppp ipcp dns admit-any command cancels the configuration.

By default, the device cannot obtain the DNS server address specified by the remote device.

Format

ppp ipcp dns admit-any

undo ppp ipcp dns admit-any

Parameters

None

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the device connects to a remote device by using PPP and needs to use a domain name to access the Internet, you must configure the remote device to specify a DNS server address for the device.

To configure the remote device to specify a DNS server address for the device, run the ppp ipcp dns admit-any command to configure the device to accept the DNS server address specified by the remote device or run the ppp ipcp dns request command to configure the device to request a DNS server address from the remote device.

Prerequisites

PPP has been configured as the link layer protocol of the interface.

Precautions

If the device obtains a valid DNS server address from the remote device, run the display dns server command to view the negotiated DNS server address.

The ppp ipcp dns admit-any command cannot be used together with ppp ipcp dns.

Example

# Configure Dialer0 to accept the DNS server address specified by the remote device.
<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] ppp ipcp dns admit-any

ppp ipcp dns request

Function

The ppp ipcp dns request command configures the device to request a DNS server address from the remote device.

The undo ppp ipcp dns request command restores the default configuration.

By default, the device is disabled from requesting a DNS server address from the remote device.

Format

ppp ipcp dns request

undo ppp ipcp dns request

Parameters

None

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the device connects to a remote device by using PPP and needs to use a domain name to access the Internet, you must configure the remote device to specify a DNS server address for the device.

To configure the remote device to specify a DNS server address for the device, run the ppp ipcp dns request command to configure the device to request a DNS server address from the remote device or run the ppp ipcp dns admit-any command to configure the device to accept the DNS server address specified by the remote device.

Prerequisites

PPP has been configured as the link layer protocol of the interface.

Precautions

If the device obtains a valid DNS server address from the remote device, run the display dns server command to view the negotiated DNS server address.

The ppp ipcp dns request command cannot be used together with ppp ipcp dns.

Example

# Configure Dialer0 to request a DNS server address from the remote device.

<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] ppp ipcp dns request

ppp ipcp remote-address forced

Function

The ppp ipcp remote-address forced command configures the device to assign an IP address to the remote device. This prevents the remote device from using its configured IP address.

The undo ppp ipcp remote-address forced command cancels the configuration. The remote device can use its configured IP address.

By default, the remote device can use its configured IP address during IP address negotiation with the local device in the IPCP negotiation phase.

Format

ppp ipcp remote-address forced

undo ppp ipcp remote-address forced

Parameters

None

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The ppp ipcp remote-address forced command enables the device to assign an IP address to the remote device, preventing the remote device from using its configured IP address. The ppp ipcp remote-address forced command must be used together with the remote address command.

Prerequisites

PPP has been configured as the link layer protocol of the interface.

Example

# Configure Dialer0 to assign IP address 10.0.0.1 to the remote device. In this situation, the remote device can accept or reject the assigned IP address.
<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] remote address 10.0.0.1
# Configure Dialer0 to forcibly assign IP address 10.0.0.1 to the remote device. In this situation, the remote device must accept the assigned IP address, and can't accept or reject the assigned IP address.
<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] remote address 10.0.0.1
[Huawei-Dialer0] ppp ipcp remote-address forced
Related Topics

ppp ipcp default-route

Function

The ppp ipcp default-route command generates a default route with both the destination IP address and mask as all 0s when IPCP negotiation succeeds.

The undo ppp ipcp default-route deletes the default route with both the destination IP address and mask as all 0s.

Format

ppp ipcp default-route

undo ppp ipcp default-route

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To configure a default route to specify the default outbound interface, run the ppp ipcp default-route command.

Prerequisites

The link layer protocol on the interface has been set to PPP using the link-protocol ppp.

Example

# Generate a default route with both the destination IP address and mask as all 0s when IPCP negotiation succeeds.

<Huawei> system-view
[Huawei] interface serial 3/0/0
[Huawei-Serial3/0/0] ppp ipcp default-route

ppp keepalive retry-times

Function

The ppp keepalive retry-times command sets the number of times for retransmitting PPP heartbeat packets.

The undo ppp keepalive retry-times command restores the default setting.

By default, the number of times for retransmitting PPP heartbeat packets is 4.

Format

ppp keepalive retry-times retry-times

undo ppp keepalive retry-times

Parameters

Parameter Description Setting
retry-times

Specifies the number of times for retransmitting PPP heartbeat packets.

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

Views

Dialer interface view, virtual template view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The device sends PPP heartbeat packets to detect PPP link quality. When the link quality is low and the number of times for retransmitting PPP heartbeat packets reaches the upper limit, the device tears down the PPP connection.

  • When services have high PPP link quality requirements and will be greatly affected by poor link quality, decrease the number of times for retransmitting PPP heartbeat packets to detect link quality and take measures in a timely manner.
  • When services have low PPP link quality requirements and will be slightly affected by poor link quality, increase the number of times for retransmitting PPP heartbeat packets to prevent frequent disconnection of PPP links.

Prerequisites

PPP has been configured as the link-layer protocol of the interface.

Precautions

The command configuration on a PPP link takes effect on new online users, but not existing online users.

Example

# Set the number of times for retransmitting PPP heartbeat packets to 5.
<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] ppp keepalive retry-times 5
Related Topics

ppp lcp remote-mru forced

Function

The ppp lcp remote-mru forced configures the router to force the peer to use a larger MRU in LCP negotiation. MRU stands for maximum receive unit.

The undo ppp lcp remote-mru forced command disables the router from forcing the peer to use a larger MRU in LCP negotiation.

By default, when a router functions as a PPPoE or PPPoA client, it forces the peer to use a larger MRU in LCP negotiation; otherwise, the peer is not forced to use a larger MRU in LCP negotiation.

Format

ppp lcp remote-mru forced

undo ppp lcp remote-mru forced

Parameters

None

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In the L2TP scenario, the router functions as a LAC and other vendors' device functions as a LNS. When a PPPoE client attempts to go online in dial-up mode, it performs LCP negotiation with the LAC. After establishing an L2TP tunnel with the LNS, the LAC sends the result of LCP negotiation with the PPPoE client to the LNS. If the MRU value negotiated with the PPPoE client is smaller than the MTU value on the LNS end, the LNS sends the PPP link disconnection request and therefore the client fails to go online. In this case, you can run the ppp lcp remote-mru forced command on the LAC PPP interface to force the PPPoE client to use a greater MRU in LCP negotiation.

Prerequisites

The link layer protocol on the interface has been set to PPP using the link-protocol ppp.

Example

# Configure the router force the peer to use a larger MRU in LCP negotiation.

<Huawei> system-view
[Huawei] interface virtual-template 10
[Huawei-Virtual-Template10] ppp lcp remote-mru forced

ppp pap local-user

Function

The ppp pap local-user command configures the user name and password to be sent from the local device to the remote device in PAP authentication.

The undo ppp pap local-user command deletes the configured user name and password.

By default, the local device sends a request to the remote device without the user name and password in PAP authentication.

Format

ppp pap local-user username password { cipher | simple } password

undo ppp pap local-user

Parameters

Parameter Description Value
username

Specifies the user name sent from the local device to the remote device in PAP authentication.

The value is a string of 1 to 64 case-sensitive characters without spaces.

cipher

Displays the password in cipher text.

-
simple

Displays the password in plain text.

NOTE:

When you specify simple, the password is saved in plain text in the configuration, which brings potential security risks. You are advised to specify cipher to save the password in the cipher text.

-
password

Specifies the password sent from the local device to the remote device in PAP authentication.

The value is a case-sensitive character string without spaces. If simple is specified, the password is in plain text and contains 1 to 32 characters. If cipher is specified, the password is either in cipher text containing 24 to 68 characters, for example, %^%#k5bf>8df@:_;Na'+R"U,#L#w88HE1M.L4Y Y2~W2u0%RDL#z#%^%#, or in plain text containing 1 to 32 characters, for example, 214357.

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the PPP authentication mode is set to PAP authentication on the authenticator by using the ppp authentication-mode command, you must configure the user name and password for PAP authentication on the authenticated party.

In PAP authentication, the local device needs to send the user name and password to the remote device. The remote device checks its user table to determine whether the local device passes the authentication or sends the user name and password to the remote authentication server.

Prerequisites

The link layer protocol on the interface has been set to PPP using the link-protocol ppp.

Precautions

The user name and password configured by using the ppp pap local-user command must be the same as those configured on the remote device.

NOTE:

In PAP authentication, the password is transmitted in plain text on the network no matter whether you specify cipher or simple, which brings potential security risks.

Example

# Configure user name papuser1 and password huawei on Dialer0.

<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] ppp pap local-user papuser1 password cipher huawei@123

ppp peer hostroute-suppress

Function

The ppp peer hostroute-suppress command enables the suppression of adding the peer host route to the local routing table of direct routes.

The undo ppp peer hostroute-suppress command disables the suppression of adding the peer host route to the local routing table of direct routes.

By default, the local routing table of direct routes contains the peer host route.

Format

ppp peer hostroute-suppress

undo ppp peer hostroute-suppress

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A PPP link does not strictly require that the peer and local IP addresses exist at the same network segment. Two ends of a PPP link with IP addresses at different network segments can communicate with each other. In addition, one end automatically adds the host route of the other end at a different network segment to the local routing table of direct routes.

However, when one end is configured with an incorrect IP address, the other end automatically adds the incorrect peer host route to the local routing table of direct routes. As a result, the incorrect routing information is advertised across the network.

You can run the ppp peer hostroute-suppress or undo ppp peer hostroute-suppress command to enable or disable the suppression of adding the peer host route to the local routing table of direct routes.

  • After you run the ppp peer hostroute-suppress command, the local routing table of direct routes no longer contains the peer host route.
  • After you run the undo ppp peer hostroute-suppress command, the local routing table of direct routes contains the peer host route.

Prerequisites

The link layer protocol on the interface has been set to PPP using the link-protocol ppp.

Follow-up Procedure

Run the shutdown and undo shutdown or restart commands to restart the interface to make the configuration take effect.

Example

# Enable the suppression of adding the peer host route to the local routing table of direct routes, and restart the interface.

<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] ppp peer hostroute-suppress
[Huawei-Dialer0] shutdown
[Huawei-Dialer0] undo shutdown
Related Topics

ppp timer negotiate

Function

The ppp timer negotiate command sets the timeout period of PPP negotiation.

The undo ppp timer negotiate command restores the default setting.

By default, the timeout period of PPP negotiation is 3 seconds.

Format

ppp timer negotiate seconds

undo ppp timer negotiate

Parameters

Parameter Description Value
seconds

Specifies the timeout period of PPP negotiation.

The value is an integer that ranges from 1 to 10, in seconds.

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In PPP negotiation, if the local end does not receive any response from the remote end within the specified timeout period, the local end retransmits the last packet until it receives a response from the remote end.

Prerequisites

PPP has been configured as the link layer protocol of the interface.

Example

# Set the timeout period of PPP negotiation to 4 seconds on Dialer1.

<Huawei> system-view
[Huawei] interface dialer 1
[Huawei-Dialer1] ppp timer negotiate 4
Related Topics

remote address

Function

The remote address command configures the local device to assign an IP address to or specify an IP address pool for the remote device.

The undo remote address command restores the default configuration.

By default, the local device does not assign any IP address to the remote device.

Format

remote address { ip-address | pool pool-name }

undo remote address

Parameters

Parameter Description Value
ip-address Specifies an IP address to be assigned to the remote device.
NOTE:

This parameter does not take effect when the PPPoE server assigns an IP address to a PPPoE client on the VT interface.

The value is in dotted decimal notation.

NOTE:

The IP address to be assigned to the remote device cannot be 0.0.0.0 or 255.255.255.255.

pool pool-name

Specifies the name of the IP address pool, from which an IP address is assigned to the remote device.

The value is a string of 1 to 64 case-sensitive characters without spaces.

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the remote interface is not assigned an IP address but the local device has IP addresses, you can run the remote address command to configure the local device to assign an IP address to or specify an IP address pool for the remote interface.

Prerequisites

The remote interface has been shut down to release its IP address.

The ip address ppp-negotiate command has been used to enable the remote interface to accept the IP address assigned in PPP negotiation.

The link layer protocol on the interface has been set to PPP using the link-protocol ppp.

Precautions

If you run the remote address ip-address command multiple times in the same interface view, only the latest configuration takes effect.

To configure the local device to assign an IP address to the remote device, run the ppp ipcp remote-address forced command in the interface view.

Example

# Specify IP address pool pool_a for the remote interface connecting to VT interface 10.
<Huawei> system-view
[Huawei] interface virtual-template 10
[Huawei-Virtual-Template10] remote address pool pool_a

reset ppp compression iphc

Function

The reset ppp compression iphc command clears IPHC compression statistics.

Format

reset ppp compression iphc [ interface interface-type interface-number ]

Parameters

Parameter Description Value
interface interface-type interface-number

Clears IPHC compression statistics on a specified interface.

If this parameter is not specified, the command clears IPHC statistics on all interfaces.

-

Views

User view

Default Level

3: Management level

Usage Guidelines

None

Example

# Clear IPHC compression statistics on all interfaces.

<Huawei> reset ppp compression iphc
Related Topics

reset ppp compression stac-lzs

Function

The reset ppp compression stac-lzs command clears Stac LZS compression statistics on an interface of a PPP link.

Format

reset ppp compression stac-lzs [ interface interface-type interface-number ]

Parameters

Parameter Description Value
interface interface-type interface-number

Specifies the type and number of an interface.

If this parameter is not specified, the command clears Stac LZS compression statistics on all interfaces.

-

Views

User view

Default Level

2: Configuration level

Usage Guidelines

None

Example

# Clear Stac LZS compression statistics on all interfaces of a PPP link.

<Huawei> reset ppp compression stac-lzs
Related Topics

timer hold (PPP)

Function

The timer hold command sets the interval for sending Keepalive packets.

The undo timer hold command restores the default setting.

By default, the interval for sending Keepalive packets is 10s.

Format

timer hold seconds

undo timer hold

Parameters

Parameter Description Value
seconds Specifies the polling interval for an interface.

The value is an integer that ranges from 0 to 32767, in seconds.

If the interval is set to 0 seconds, no Keepalive packet is sent.

Views

dialer interface view, virtual template interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The polling interval of an interface is the interval at which the interface sends Keepalive packets.

Keepalive packets are used to monitor and maintain the link status. If an interface does not receive any Keepalive packet after five Keepalive intervals, it considers that the link fails.

Prerequisites

PPP has been configured as the link layer protocol of the interface.

Precautions

On a low-speed link, the seconds parameter cannot be set to a small value because it may take a long time to transmit oversized packets on the link. If the interval for sending Keepalive packets is set to a small value, transmission of Keepalive packets is delayed. If an interface does not receive any Keepalive packet from the remote interface after five Keepalive intervals, the interface considers that the link fails.

Example

# Set the interval for sending Keepalive packets to 15 seconds on Dialer0.

<Huawei> system-view
[Huawei] interface dialer 0
[Huawei-Dialer0] link-protocol ppp
[Huawei-Dialer0] timer hold 15
Related Topics
Translation
Download
Updated: 2019-02-18

Document ID: EDOC1000097293

Views: 35150

Downloads: 101

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