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

S7700 and S9700 V200R011C10

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+ Configuration Commands

PPPoE+ Configuration Commands

Command Support

Commands provided in this section and all the parameters in the commands are supported by all switch models by default, unless otherwise specified. For details, see specific commands.

display pppoe intermediate-agent information encapsulation

Function

The display pppoe intermediate-agent information encapsulation command displays the fields and vendor ID added to PPPoE packets.

Format

display pppoe intermediate-agent information encapsulation

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To view the fields and vendor ID added to PPPoE packets, you can run display pppoe intermediate-agent information encapsulation command to view the information.

Example

# Display the fields and vendor ID added to PPPoE packets.

<HUAWEI> display pppoe intermediate-agent information encapsulation
 The vendor id is: 2011
 Encapsulation content contains: Circuit-id and Remote-id
Table 14-70  Description of the display pppoe intermediate-agent information encapsulation command output

Item

Description

The vendor id is

Vendor ID added to PPPoE packets.

You can run the pppoe intermediate-agent information vendor-id vendor-id command to set this parameter.

Encapsulation content contains

Fields added to PPPoE packets.

You can run the pppoe intermediate-agent information encapsulation { circuit-id | remote-id } * command to set this parameter.

display pppoe intermediate-agent information format

Function

The display pppoe intermediate-agent information format command displays formats of circuit ID and remote ID that are configured globally.

Format

display pppoe intermediate-agent information format

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After PPPoE+ is enabled globally, you can run the display pppoe intermediate-agent information format command to check whether the configuration of the circuit ID or remote ID added to PPPoE packets is correct.

Example

# Display formats of circuit ID and remote ID that are configured globally.

<HUAWEI> display pppoe intermediate-agent information format
 The current information format :
  Circuit ID : EXTEND
  Remote  ID : COMMON
 For example:
  interface Ethernet1/0/1 SVLAN:200 CVLAN:100
  The PPPOE Intermediate Agent information follow:
  Circuit ID:00 04 00 c8 00 00
  Remote  ID:0022-0033-0044                   
Table 14-71  Description of the display pppoe intermediate-agent information format command output

Item

Description

Circuit ID

Format of the circuit ID
  • COMMON: indicates the standard fill format.
  • EXTEND: indicates the extended fill format.
  • USER DEFINE: indicates user-defined fill format.

You can run the pppoe intermediate-agent information format command to set this parameter.

If the portdescription keyword is specified in the user-defined circuit-id and no interface description is configured, the Circuit ID in For example displays portdescription.

Remote ID

Format of the remote ID
  • COMMON: indicates the standard fill format.
  • EXTEND: indicates the extended fill format.
  • USER DEFINE: indicates user-defined fill format.

You can run the pppoe intermediate-agent information format command to set this parameter. Remote IDs vary according to devices.

If the portdescription keyword is specified in the user-defined remote-id and no interface description is configured, the Remote ID in For example displays portdescription.

display pppoe intermediate-agent information policy

Function

The display pppoe intermediate-agent information policy command displays the global policy for processing original fields in PPPoE packets at the user side and PPPoE server side.

Format

display pppoe intermediate-agent information policy

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display pppoe intermediate-agent information policy command displays the global policy for processing original fields in PPPoE packets at the user side and PPPoE server side.

Example

# Display the global policy for processing original information fields in PPPoE packets at the user side and PPPoE server side.

<HUAWEI> display pppoe intermediate-agent information policy
The current information Policy :REPLACE
The current ignore-reply Policy:ENABLE
Table 14-72  Description of the display pppoe intermediate-agent information policy command output

Item

Description

The current information Policy

Global policy for processing original information fields in PPPoE packets at the user side:
  • DROP: removes original information fields from PPPoE packets.
  • REPLACE: replaces original fields in PPPoE packets according to the field format.
  • KEEP: reserves the content and format of original fields in PPPoE packets.

You can run the pppoe intermediate-agent information policy (system view) command to set this parameter.

The current ignore-reply Policy

Global policy for processing PPPoE reply packets sent by the PPPoE server:
  • ENABLE: indicates that the device does not process PPPoE reply packets sent by the PPPoE server.
  • DISABLE: indicates that the device processes PPPoE reply packets sent by the PPPoE server.

You can run the pppoe intermediate-agent information ignore-reply command to set this parameter.

pppoe intermediate-agent information enable

Function

The pppoe intermediate-agent information enable command enables PPPoE+ globally.

The undo pppoe intermediate-agent information enable command disables PPPoE+.

By default, PPPoE+ is disabled.

Format

pppoe intermediate-agent information enable

undo pppoe intermediate-agent information enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

After PPPoE+ is enabled globally, the device can add information about the interface connected to the PPPoE client such as the slot ID/subcard ID/interface number to PPPoE packets. The user account and access interface information are both authenticated, preventing user account embezzling.

After the pppoe intermediate-agent information enable command is executed in the system view, PPPoE+ is enabled on all interfaces.

NOTE:

If PPPoE+ is enabled on the device that has no ACL resources, the system displays the following message "Warning: Allocate acl resources failed." In this case, PPPoE+ does not work.

Example

# Enable PPPoE+ globally.

<HUAWEI> system-view
[HUAWEI] pppoe intermediate-agent information enable

pppoe intermediate-agent information encapsulation

Function

The pppoe intermediate-agent information encapsulation command configures fields added to PPPoE packets.

The undo pppoe intermediate-agent information encapsulation command restores the default fields added to PPPoE packets.

By default, the device adds the circuit-id and remote-id fields to PPPoE packets.

Format

pppoe intermediate-agent information encapsulation { circuit-id | remote-id } *

undo pppoe intermediate-agent information encapsulation

Parameters

Parameter

Description

Value

circuit-id

Indicates the circuit ID (CID).

-

remote-id

Indicates the remote ID (RID).

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After PPPoE+ is enabled, the device adds the circuit-id and remote-id fields to PPPoE packets by default. If the remote non-Huawei PPPoE server can identify only the circuit-id or remote-id field, run the pppoe intermediate-agent information encapsulation command to configure the device only to add the circuit-id or remote-id fields to PPPoE packets.

Prerequisites

The PPPoE+ function has been enabled by running the pppoe intermediate-agent information enable command in the system view.

Example

# Configure the device only to add the circuit-id field to PPPoE packets.

<HUAWEI> system-view
[HUAWEI] pppoe intermediate-agent information enable 
[HUAWEI] pppoe intermediate-agent information encapsulation circuit-id

pppoe intermediate-agent information format

Function

The pppoe intermediate-agent information format command configures the format of fields added to PPPoE packets.

The undo pppoe intermediate-agent information format command restores the format of fields added to PPPoE packets to default values.

By default, the format of fields circuit-id and remote-id added to PPPoE packets is common.

Format

pppoe intermediate-agent information [ vlan vlan-id ] [ ce-vlan cevlan-id ] format { circuit-id | remote-id } { common | extend | user-defined text }

undo pppoe intermediate-agent information format all

undo pppoe intermediate-agent information [ vlan vlan-id ] [ ce-vlan cevlan-id ] format { circuit-id | remote-id }

Parameters

Parameter

Description

Value

vlan vlan-id

Indicates the outer VLAN ID.

NOTE:

This parameter is not supported in the system view.

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

ce-vlan cevlan-id

Indicates the end inner VLAN ID.

NOTE:

This parameter is not supported in the system view.

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

circuit-id

Indicates the circuit ID (CID).

-

remote-id

Indicates the remote ID (RID).

-

common

Indicates the standard fill format.

  • CID format: {eth|trunk}slot ID/subcard ID/port ID:svlan.cvlan host name0/0/0/0/0, in ASCII format
  • RID format: device MAC address (6 bytes), in ASCII format

-

extend

Indicates the extended format.

  • CID format: circuit-id type (0) + length (4) + S-VLAN ID (2 bytes) + slot ID (5 bits) + subslot ID (3 bits) + port (1 byte), in hexadecimal notation

  • RID format: remote-id type (0) + length (6) + MAC address (6 bytes), in hexadecimal notation

In the format of the CID or RID, the values in parentheses without a unit are fixed values of the fields, and the values in parentheses with a unit indicate the length of the corresponding fields.

-

user-defined text

Indicates the user-defined format.

The text parameter specifies a user-defined format, and the value is a string of 1 to 127 characters. The details about the customized format string are provided in Precautions.

all

Indicates the all format of fields.

NOTE:

This parameter is not supported in the system view.

-

Views

System view and interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After PPPoE+ is enabled globally, the default policy for processing user-side PPPoE packets is replace. The device replaces original information fields in the PPPoE packets received at the user side with those in common format. You can run the pppoe intermediate-agent information format command to change the format of information fields.

When the policy for processing user-side PPPoE packets is replace and the pppoe intermediate-agent information format command is executed, all interfaces add fields in a specified format to received PPPoE packets in the system view.

When the pppoe intermediate-agent information format command is configured, the device uses the following matching rules to encapsulate the information fields in PPPoE packets:
  • For a double-tagged packet, the device matches the VLAN IDs in both the outer and inner VLAN tags. If the match fails, the device matches the VLAN ID in the inner VLAN tag, followed by that in the outer VLAN tag. If the match still fails, the device considers the packet does not carry a VLAN ID, and does not encapsulate the packet.
  • For a single-tagged packet, the device matches the VLAN ID in the outer VLAN tag. If the match fails, the device considers the packet does not carry a VLAN ID, and does not encapsulate the packet.

If the pppoe intermediate-agent information format command is configured in both the interface and system views, the configuration in the interface view takes effect.

NOTE:

Fields in PPPoE Intermediate-Agent Information packets support the following formats: common, extend, and user-defined. The formats are the same as those of DHCP Option 82. For description of the three parameters, see dhcp option82 format.

Prerequisites

PPPoE+ has been enabled globally by running the pppoe intermediate-agent information enable command.

Precautions

You can use the following keywords to define the format. The format string can use the hexadecimal notation, ASCII format, or combination of the two formats.
  • sysname: indicates the ID of the access point. This keyword is valid only in ASCII format.
  • portname: indicates the name of a port. For example, GigabitEthernet1/0/1. This keyword is valid only in ASCII format.
  • porttype: indicates the type of a port. This keyword is valid in ASCII or hexadecimal notation. For example, if the value is Ethernet in ASCII format, the value is 15 in hexadecimal notation.
  • iftype: indicates the type of an interface, including eth and trunk. This keyword is valid only in ASCII format.
  • mac: indicates the MAC address of an interface. In ASCII format, the value is expressed as H-H-H in hexadecimal notation, and the value is a number of six bytes.
  • Slot: specifies the slot ID. This keyword is valid in ASCII or hexadecimal notation.
  • subslot: indicates the subslot ID. This keyword is valid in ASCII or hexadecimal notation.
  • port: indicates the port number. This keyword is valid in ASCII or hexadecimal notation.
  • svlan: indicates the outer VLAN ID. The value ranges from 0 to 4095. This keyword is valid in ASCII or hexadecimal notation.
  • cvlan: indicates the inner VLAN ID. The value ranges from 0 to 4095. This keyword is valid in ASCII or hexadecimal notation.
  • n: specifies the value of the svlan or cvlan keyword if the outer VLAN tag or inner VLAN tag does not exist. The n keyword is on the left of the svlan or cvlan keyword. If the corresponding VLAN does not exist, the default value of the svlan or cvlan keyword is 4096 in ASCII format and is all Fs in hexadecimal notation. If the keyword n is added to the left of the svlan or cvlan keyword, the svlan or cvlan keyword is set to 0. This keyword is valid in ASCII or hexadecimal notation.
  • length: indicates the total length of the keywords following the length keyword.
  • portdescription: indicates the interface description. It is available only in ASCII format.
NOTE:

Separators must be added between keywords; otherwise, they cannot be parsed. The separators cannot be numbers.

The symbols used in the format string are as follows:
  • The symbol % followed by a keyword indicates the format of the keyword.
  • A number between the % symbol and a keyword indicates the length of the keyword. In an ASCII character string, %05 has the same meaning as %05d in the C language. In a hexadecimal character string, the number indicates the length of the corresponding keyword in bits.
  • The [] symbol indicates an optional keyword. Each pair of brackets can contain only one keyword, svlan or cvlan. The keyword in the [] symbol is added to information fields only if the corresponding VLAN ID exists. To facilitate syntax check, the system does not support nested [] symbols.
  • The \ symbol is an escape character. The %, \, and [] symbols following the escape character indicate themselves. For example, \\ represents \.
  • The content in quotation marks (" ") is expressed in a character string, and the content outside the quotation marks are expressed in hexadecimal notation.
  • Other symbols are processed as common characters. The rules for setting the format string in ASCII format or hexadecimal notation are as follows:
    • An ASCII character string can contain letters, numerals, and symbols ! @ # $ % ^ & * () _ + | - = \ [] {} ; : '" / ? . , <> `.
    • By default, the length of each keyword in an ASCII character string is the actual length of the keyword.
    • A hexadecimal notation string can contain numerals, space characters, %, and the keywords.
    • In a hexadecimal notation string, numbers are encapsulated in information fields. A number in the range of 0-255 occupies one byte; a number in the range of 256-65535 occupies two bytes; a number in the range of 65536-4294967295 occupies four bytes. Numbers larger than 4294967295 are not supported. Multiple numbers must be separated by space characters; otherwise, they are considered as a number.
    • All the space characters in a hexadecimal character string are ignored.
    • By default, each slot ID, subslot ID, port number, and VLAN ID in a hexadecimal notation string occupy two bytes. The length field occupies one byte.
    • If the length of each keyword in a hexadecimal character string is specified, the total length of the hexadecimal character string must be a multiple of 8. If the specified length of a keyword is longer than 32 bits, the first 32 bits of the keyword are the actual keyword value, and other bits are set to 0.
    • A hexadecimal character string can contain only the keywords whose values are numbers. Other keywords, such as the port name, cannot be added to the hexadecimal character string.
    • If a string is not contained in quotation marks, it is encapsulated in hexadecimal notation. To encapsulate to the string in the ASCII format, add the string into a pair of quotation marks. For example, the slot ID is 3, and the port ID is 4. If the format string is %slot %port, the value of the string after encapsulation is a hexadecimal number 00030004. If the format string is "%slot %port", the value of the string after encapsulation is 3 4.
    • A format string can contain both hexadecimal strings and ASCII strings, for example, %slot %port "%sysname %portname:%svlan.%cvlan."

Example

# Configure the extended format for the remote-id field added to PPPoE packets.

<HUAWEI> system-view
[HUAWEI] pppoe intermediate-agent information enable
[HUAWEI] pppoe intermediate-agent information format remote-id extend

# Configure the user-defined format for the circuit-id field added to PPPoE packets and encapsulate the port name, outer VLAN ID, inner VLAN ID, and host name in ASCII format.

<HUAWEI> system-view
[HUAWEI] pppoe intermediate-agent information enable
[HUAWEI] pppoe intermediate-agent information format circuit-id user-defined "%portname:%svlan.%cvlan %sysname"

# Configure the extended format for the remote-id field added to PPPoE packets on GE1/0/1.

<HUAWEI> system-view
[HUAWEI] pppoe intermediate-agent information enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] pppoe intermediate-agent information format remote-id extend

pppoe intermediate-agent information ignore-reply

Function

The pppoe intermediate-agent information ignore-reply command configures the device whether to directly forward PPPoE reply packets sent by the PPPoE server.

The undo pppoe intermediate-agent information ignore-reply command restores the default policy for processing PPPoE packets sent by the PPPoE server.

By default, the device does not process PPPoE reply packets sent by the PPPoE server.

Format

pppoe intermediate-agent information ignore-reply { disable | enable }

undo pppoe intermediate-agent information ignore-reply

Parameters

Parameter Description Value
disable Indicates that the device processes PPPoE reply packets sent by the PPPoE server. -
enable Indicates that the device does not process PPPoE reply packets sent by the PPPoE server. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, the device does not process PPPoE reply packets and directly forwards them to the PPPoE client. Only when the PPPoE client cannot identify PPPoE packets that the device directly forwards, the device needs to process the PPPoE reply packets sent by the PPPoE server to ensure communication between the PPPoE server and PPPoE client. The PPPoE reply packets are processed as follows:
  • When the policy for processing original fields in PPPoE packets is replace or keep:
    • If fields are not contained in PPPoE reply packets sent by the PPPoE server, the device directly forwards PPPoE reply packets.
    • If fields are contained in PPPoE reply packets sent by the PPPoE server and the format and content are consistent with those of the fields added to the user-side PPPoE packets, the device removes the original fields from PPPoE packets and forwards the packets. If the format and content are different from those of the fields added to the user-side PPPoE packets, the device directly forwards PPPoE reply packets.
  • When the policy for processing original fields in PPPoE packets is drop, the device directly forwards the PPPoE packets:

Precautions

The pppoe intermediate-agent information ignore-reply command takes effect only after PPPoE+ is enabled globally. To modify the configuration, disable PPPoE+ globally first.

If the device is configured to process the PPPoE reply packets sent by the PPPoE server, the user access rate is reduced when the PPPoE server sends a large number of PPPoE+ packets.

Example

# Configure the device to process PPPoE reply packets sent by the PPPoE server.

<HUAWEI> system-view
[HUAWEI] undo pppoe intermediate-agent information enable
[HUAWEI] pppoe intermediate-agent information ignore-reply disable
[HUAWEI] pppoe intermediate-agent information enable

pppoe intermediate-agent information policy (interface view)

Function

The pppoe intermediate-agent information policy command configures the policy for a specified interface to process original fields in user-side PPPoE packets.

The undo pppoe intermediate-agent information policy command restores the default policy for a specified interface to process original fields in user-side PPPoE packets.

By default, the policy configured on an interface to process original fields in user-side PPPoE packets is replace.

Format

pppoe intermediate-agent information policy { drop | replace | keep }

undo pppoe intermediate-agent information policy

Parameters

Parameter

Description

Value

drop

Removes the original fields from PPPoE packets.

-

replace

Replaces original fields in PPPoE packets according to the field format.

-

keep

Reserves the content and format of original fields in PPPoE packets.

-

Views

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the policy for processing original fields in user-side PPPoE packets is configured, the device can add information about the interface connected to the PPPoE client such as the slot ID/subcard ID/interface number, VLAN ID, and MAC address to PPPoE packets. The user account and access interface information are both authenticated, preventing user account embezzling. If received PPPoE packets contain fields related to the interface that connected to the PPPoE client, the device removes or reserves original fields as required.

You can run the pppoe intermediate-agent information policy (system view) command to configure the PPPoE packet processing policy for all interfaces in the system view. To use a different policy on a specified interface, run the pppoe intermediate-agent information policy command. In this case, the policy for processing PPPoE packets on the interface depends on the interface configuration.

Prerequisites

PPPoE+ has been enabled globally by running the pppoe intermediate-agent information enable command.

Example

# Configure GE1/0/0 to replace original fields in the received PPPoE packets with the circuit ID and remote ID of the local device.

<HUAWEI> system-view
[HUAWEI] pppoe intermediate-agent information enable
[HUAWEI] interface gigabitethernet 1/0/0
[HUAWEI-GigabitEthernet1/0/0] pppoe intermediate-agent information policy replace

pppoe intermediate-agent information policy (system view)

Function

The pppoe intermediate-agent information policy command configures the policy for all interfaces to process original fields in user-side PPPoE packets.

The undo pppoe intermediate-agent information policy command restores the policy for all interfaces to process original fields in user-side PPPoE packets.

By default, the policy configured on all interfaces to process original fields in user-side PPPoE packets is replace.

Format

pppoe intermediate-agent information policy { drop | replace | keep }

undo pppoe intermediate-agent information policy

Parameters

Parameter

Description

Value

drop

Removes the original fields from PPPoE packets.

-

replace

Replaces original information fields in PPPoE packets according to the field format.

-

keep

Reserves the content and format of original fields in PPPoE packets. If a PPPoE packet does not contain the fields, the device adds the fields to the packet according to the configuration.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the policy for processing original fields in user-side PPPoE packets is configured, the device can add information about the interface connected to the PPPoE client such as the slot ID/subcard ID/interface number, VLAN ID, and MAC address to PPPoE packets. The user account and access interface information are both authenticated, preventing user account embezzling. If received PPPoE packets contain fields related to the interface that connected to the PPPoE client, the device removes or reserves original fields as required.

After the command is executed, the policy for processing PPPoE packets takes effect on all interfaces. To configure a policy on a specified interface, run the pppoe intermediate-agent information policy (interface view) command. In this case, the policy for processing PPPoE packets on the interface depends on the interface configuration.

Prerequisites

PPPoE+ has been enabled globally by running the pppoe intermediate-agent information enable command.

Example

# Configure all interfaces to replace original fields in the received PPPoE packets with the circuit ID and remote ID of the local device.

<HUAWEI> system-view
[HUAWEI] pppoe intermediate-agent information enable
[HUAWEI] pppoe intermediate-agent information policy replace

pppoe intermediate-agent information vendor-id

Function

The pppoe intermediate-agent information vendor-id command sets the vendor ID that the device adds to PPPoE packets.

The undo pppoe intermediate-agent information vendor-id command restores the default vendor ID that the device adds to PPPoE packets.

The default vendor ID that the device adds to PPPoE packets is 2011.

Format

pppoe intermediate-agent information vendor-id vendor-id

undo pppoe intermediate-agent information vendor-id

Parameters

Parameter Description Value
vendor-id vendor-id Specifies a vendor ID added to PPPoE packets. The value is an integer ranging from 0 to 4294967295. The default value is 2011.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After PPPoE+ is enabled, the device must negotiate with the PPPoE server using PPPoE packets containing the vendor ID. By default, the device adds vendor ID 2011 to PPPoE packets. If the device is connected to a non-Huawei PPPoE server, the vendor ID may not be 2011; for example, the vendor ID is 3561. In this case, run the pppoe intermediate-agent information vendor-id vendor-id command to set the vendor ID to be the same as that in PPPoE packets sent from the non-Huawei PPPoE server.

Prerequisites

PPPoE+ has been enabled globally by running the pppoe intermediate-agent information enable command.

Example

# Set the vendor ID added to PPPoE packets to 3561.

<HUAWEI> system-view
[HUAWEI] pppoe intermediate-agent information enable 
[HUAWEI] pppoe intermediate-agent information vendor-id 3561
Translation
Download
Updated: 2019-10-18

Document ID: EDOC1000178288

Views: 29157

Downloads: 109

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