- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
07-VPLS commands | 439.63 KB |
Contents
display bgp l2vpn auto-discovery
display l2vpn mac-address mac-move
display l2vpn service-instance
pw-class (auto-discovery VSI view)
reset l2vpn mac-address mac-move
tunnel-policy (auto-discovery VSI view)
VPLS commands
address-family l2vpn
Use address-family l2vpn to create the BGP L2VPN address family and enter its view, or enter the view of the existing BGP L2VPN address family.
Use undo address-family l2vpn to delete the BGP L2VPN address family and all settings from BGP L2VPN address family view.
Syntax
address-family l2vpn
undo address-family l2vpn
Default
No BGP L2VPN address family exists.
Views
BGP instance view
Predefined user roles
network-admin
Usage guidelines
To establish a BGP PW to a remote PE, you must execute the peer enable command in BGP L2VPN address family view to enable the remote PE.
Examples
# Create the BGP L2VPN address family and enter BGP L2VPN address family view.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp-default] address-family l2vpn
[Sysname-bgp-default-l2vpn]
# Create the BGP L2VPN address family and enter BGP L2VPN address family view.
<Sysname> system-view
[Sysname] bgp 100 instance abc
[Sysname-bgp-abc] address-family l2vpn
[Sysname-bgp-abc-l2vpn]
peer enable (Layer 3—IP Routing Command Reference)
auto-discovery
Use auto-discovery to enable a VSI to automatically discover neighbors through BGP and enter auto-discovery VSI view.
Use undo auto-discovery to restore the default.
Syntax
auto-discovery bgp
undo auto-discovery
Default
A VSI does not use BGP to automatically discover neighbors.
Views
VSI view
Predefined user roles
network-admin
Parameters
bgp: Enables the VSI to automatically discover neighbors through BGP.
Usage guidelines
After the remote PEs are discovered through BGP, you can use the signaling-protocol command to specify the signaling protocol (LDP or BGP) to establish PWs to the discovered remote PEs.
Examples
# Enable VSI aaa to automatically discover neighbors through BGP and enter auto-discovery VSI view.
<Sysname> system-view
[Sysname] vsi aaa
[Sysname-vsi-aaa] auto-discovery bgp
[Sysname-vsi-aaa-auto]
Related commands
display l2vpn pw
display l2vpn vsi
backup-peer
Use back-peer in VSI LDP PW view to configure a VSI LDP backup PW and enter its view, or enter the view of an existing VSI LDP backup PW.
Use back-peer in VSI static PW view to configure a VSI static backup PW and enter its view, or enter the view of an existing VSI static backup PW.
Use undo backup-peer to restore the default.
Syntax
VSI LDP PW view:
backup-peer ip-address [ pw-id pw-id ] [ pw-class class-name | tunnel-policy tunnel-policy-name ] *
undo backup-peer ip-address pw-id pw-id
VSI static PW view:
backup-peer ip-address [ pw-id pw-id ] in-label label-value out-label label-value [ pw-class class-name | tunnel-policy tunnel-policy-name ] *
undo backup-peer ip-address pw-id pw-id
Default
No backup PWs exist for VPLS.
Views
VSI LDP PW view
VSI static PW view
Predefined user roles
network-admin
Parameters
ip-address: Specifies the LSR ID of the peer PE on the backup PW.
pw-id pw-id: Specifies a PW ID for the backup PW, in the range of 1 to 4294967295.
in-label label-value: Specifies the incoming label for the backup PW. The value range is 16 to 1023.
out-label label-value: Specifies the outgoing label for the backup PW. The value range is 16 to 1048575.
pw-class class-name: Specifies a PW class by its name, a case-sensitive string of 1 to 19 characters. You can specify a PW class to configure the PW data encapsulation type for the backup PW. If you do not specify a PW class, the PW data encapsulation type of the backup PW is VLAN.
tunnel-policy tunnel-policy-name: Specifies a tunnel policy by its name, a case-insensitive string of 1 to 19 characters. If you do not specify a tunnel policy, the backup PW uses the default tunnel policy.
Usage guidelines
This command configures a backup PW for a PW to implement PW redundancy. The backup PW is used when the primary PW fails.
You must assign the backup PW a different peer LSR ID and PW ID than any existing VPLS PWs or cross-connect PWs.
A backup PW has the same no-split-horizon attributes as its primary PW.
If both the default PW ID in the default-pw-id command and a PW ID in the backup-peer command are configured, the PW ID in the backup-peer command is used. If only the default PW ID is configured, the default PW ID is used. If no default PW ID is configured, you must provide a PW ID in the backup-peer command.
When you add a static PW, you must make sure that static PW uses a different incoming label than an existing static LSP. If the incoming label is duplicated, you cannot make the static PW take effect by changing the incoming label of the static LSP. Instead, you must delete the static PW and then reconfigure the static PW with an unused incoming label.
Examples
# Configure a primary and a backup LDP PW for VSI vpn1, and specify the peer PE address and PW ID of the primary PW as 4.4.4.4 and 100, and those of the backup PW as 5.5.5.5 and 200.
<Sysname> system-view
[Sysname] vsi vpn1
[Sysname-vsi-vpn1] pwsignaling ldp
[Sysname-vsi-vpn1-ldp] peer 4.4.4.4 pw-id 100
[Sysname-vsi-vpn1-ldp-4.4.4.4-100] backup-peer 5.5.5.5 pw-id 200
[Sysname-vsi-vpn1-ldp-4.4.4.4-100-backup]
Related commands
default-pw-id
display l2vpn pw
peer
default-pw-id
Use default-pw-id to set the default PW ID for a VSI.
Use undo default-pw-id to restore the default.
Syntax
default-pw-id default-pw-id
undo default-pw-id
Default
No default PW ID is set for a VSI.
Views
VSI view
Predefined user roles
network-admin
Parameters
default-pw-id: Specifies the default PW ID for the VSI, in the range of 1 to 4294967295.
Usage guidelines
After you set the default PW ID for a VSI, you do not need to provide a PW ID in the backup-peer and peer commands.
Examples
# Set the default PW ID to 200 for VSI vpn1.
<Sysname> system-view
[Sysname] vsi vpn1
[Sysname-vsi-vpn1] default-pw-id 200
Related commands
backup-peer
peer
description
Use description to configure a description for a VSI.
Use undo description to restore the default.
Syntax
description text
undo description
Default
No description is configured for a VSI.
Views
VSI view
Predefined user roles
network-admin
Parameters
text: Specifies a description, a case-sensitive string of 1 to 80 characters.
Examples
# Configure a description of vsi for vpn1 for VSI vpn1.
<Sysname> system-view
[Sysname] vsi vpn1
[Sysname-vsi-vpn1] description vsi for vpn1
Related commands
display l2vpn vsi
display bgp l2vpn auto-discovery
Use display bgp l2vpn auto-discovery to display VPLS PE information discovered by BGP.
Syntax
display bgp [ instance instance-name ] l2vpn auto-discovery [ peer ip-address { advertised | received } | route-distinguisher route-distinguisher [ pe-address ip-address [ advertise-info ] ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
instance instance-name: Displays VPLS PE information in a BGP instance. The instance-name argument specifies the BGP instance name, a case-sensitive string of 1 to 31 characters. If you do not specify a BGP instance, this command displays VPLS PE information in the default BGP instance.
peer ip-address: Displays VPLS PE information advertised to or received from a BGP peer specified by its IP address.
advertised: Displays VPLS PE information advertised to the BGP peer.
received: Displays VPLS PE information received from the BGP peer.
route-distinguisher route-distinguisher: Displays BGP VPLS PE information for the route distinguisher (RD), which is a string of 3 to 21 characters. You can specify an RD in one of the following formats:
· 16-bit AS number:32-bit user-defined number. For example, 101:3.
· 32-bit IP address:16-bit user-defined number. For example, 192.168.122.15:1.
· 32-bit AS number:16-bit user-defined number, where the AS number must be equal to or greater than 65536. For example, 65536:1.
· 32-bit AS number in dotted decimal notation:16-bit user-defined number, for example, 10.1:1.
pe-address ip-address: Displays BGP VPLS PE information for a PE. The ip-address argument specifies the PE address.
advertise-info: Displays BGP VPLS PE advertisement information.
Usage guidelines
If you do not specify any parameters, this command displays brief information about all VPLS PEs discovered by BGP.
Examples
# Display brief information about all VPLS PEs discovered by BGP in the default BGP instance.
<Sysname> display bgp l2vpn auto-discovery
BGP local router ID is 192.168.1.140
Status codes: * - valid, > - best, d - dampened, h - history,
s - suppressed, S - stale, i - internal, e - external
Origin: i - IGP, e - EGP, ? - incomplete
Total number of automatically discovered PEs: 3
Route distinguisher: 2:2
Total number of automatically discovered PEs: 3
PE address Nexthop VPLS ID
* > 1.1.1.9 0.0.0.0 100:100
* >i 2.2.2.9 2.2.2.9 100:100
* >i 3.3.3.9 3.3.3.9 100:100
Table 1 Command output
Field |
Description |
Status codes |
Status codes: · * – valid—Valid route. · > – best—Best route. · d – damped—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – Stale—Stale route. · i – internal—Internal route. · e – external—External route. |
Origin |
Origin of the label block: · i – IGP—Originated in the AS. · e – EGP—Learned through EGP. · ? – incomplete—Unknown origin. |
# Display detailed information about the VPLS PE that has RD 2:2 and IP address 2.2.2.9 in the default BGP instance.
<Sysname> display bgp l2vpn auto-discovery route-distinguisher 2:2 pe-address 2.2.2.9
BGP local router ID: 192.168.1.140
Local AS number: 100
Route distinguisher: 2:2
Total number of automatically discovered PEs: 1
Paths: 1 available, 1 best
From : 2.2.2.9 (192.168.1.135)
Original nexthop: 2.2.2.9
Ext-Community : <RT: 2:2>, <VPLS ID: 100:100>
AS-path : (null)
Origin : igp
Attribute value : localpref 100, pref-val 0
PE address : 2.2.2.9
State : valid, internal, best
Table 2 Command output
Field |
Description |
Original nexthop |
Original next hop. If the VPLS PE information was obtained from a BGP update, this field displays the next hop address in the received update. |
Ext-Community |
Extended community attribute: · RT—Route Target. · VPLS ID—VPLS instance identifier. |
AS-path |
AS path attribute, which records all ASs that the VPLS PE information passed to prevent routing loops. |
Origin |
Origin of the label block: · igp—Originated in the AS. · egp—Learned through EGP. · incomplete—Unknown origin. |
Attribute value |
Attribute of the VPLS PE information: · MED—Multi-Exit Discriminator attribute. · localpref—Local preference value. · pref-val—Preferred value. · pre—Preference value. |
State |
State of the VPLS PE information: · valid. · internal. · external. · local. · best. · not preferred for reason. For more information about the reasons, see Table 3. |
Reason |
Description |
preferred-value |
The information with the maximum preferred value is preferred. |
local-preference |
The information with the highest local priority is preferred. |
local-origin-route |
The locally generated information, imported information, and aggregated information are selected in turn. |
as-path |
The information with the shortest AS path is preferred. |
origin |
The information with an ORIGIN type of IGP, EGP, and Incomplete is selected in turn. |
remote-route |
The information learned from EBGP, EBGP confederation, IBGP confederation, and IBGP is selected in turn. |
igp-cost |
The route with the smallest IGP metric value to the next hop is preferred. |
relydepth |
Routes with a small recursion depth value are preferred. |
rfc5004 |
Under the RFC5004 rule, the best route will not be changed by the BGP router after the BGP router receives routes from different EBGP neighbors if the current best route is an EBGP route. |
router-id |
The information published by the router with the smallest router ID is preferred. If the information contains RR attributes, the router ID is replaced with ORIGINATOR_ID during the information selection process. |
peer-address |
The information published by the peer with the lowest IP address is preferred. |
received |
The information that was learned first is preferred. |
# Display BGP advertisement information for the specified VPLS PE in the default BGP instance.
<Sysname> display bgp l2vpn auto-discovery route-distinguisher 2:2 pe-address 1.1.1.9 advertise-info
BGP local router ID: 192.168.1.140
Local AS number: 100
Route distinguisher: 2:2
Total number of automatically discovered PEs: 1
Paths: 1 best
VPLS ID : 100:100
PE address : 1.1.1.9
Advertised to peers (2 in total):
2.2.2.9
3.3.3.9
display bgp l2vpn signaling
Use display bgp l2vpn signaling to display VPLS label block information maintained by BGP.
Syntax
display bgp [ instance instance-name ] l2vpn signaling [ peer ip-address { advertised | received } | route-distinguisher route-distinguisher [ site-id site-id [ label-offset label-offset [ advertise-info ] ] ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
instance instance-name: Displays VPLS label block information in a BGP instance. The instance-name argument specifies the BGP instance name, a case-sensitive string of 1 to 31 characters. If you do not specify a BGP instance, this command displays VPLS label block information in the default BGP instance.
peer ip-address: Displays VPLS label block information advertised to or received from a BGP peer. The ip-address argument specifies the peer address.
advertised: Displays VPLS label block information advertised to the BGP peer.
received: Displays VPLS label block information received from the BGP peer.
route-distinguisher route-distinguisher: Displays BGP VPLS label block information for the route distinguisher (RD), which is a string of 3 to 21 characters. You can specify an RD in one of the following formats:
· 16-bit AS number:32-bit user-defined number. For example, 101:3.
· 32-bit IP address:16-bit user-defined number. For example, 192.168.122.15:1.
· 32-bit AS number:16-bit user-defined number, where the AS number must be equal to or greater than 65536. For example, 65536:1.
· 32-bit AS number in dotted decimal notation:16-bit user-defined number, for example, 10.1:1.
site-id site-id: Displays BGP VPLS label block information for a site. The site-id argument specifies the site ID. The site ID range is 0 to 65535.
label-offset label-offset: Displays information about the BGP VPLS label block with an offset. The label-offset argument specifies the offset in the range of 0 to 65535.
advertise-info: Displays BGP VPLS label block advertisement information.
Usage guidelines
If you do not specify any parameters, this command displays brief information about all BGP VPLS label blocks.
Examples
# Display brief information about all BGP VPLS label blocks in the default BGP instance.
<Sysname> display bgp l2vpn signaling
BGP local router ID is 192.168.1.135
Status codes: * - valid, > - best, d - dampened, h - history,
s - suppressed, S - stale, i - internal, e - external
Origin: i - IGP, e - EGP, ? - incomplete
Total number of label blocks: 2
Route distinguisher: 2:2
Total number of label blocks: 2
Site ID LB offset LB range LB base Nexthop
* > 1 0 10 1034 192.1.1.1
* >i 2 0 10 1162 192.3.3.3
Table 4 Command output
Field |
Description |
Status codes |
Status codes: · * – valid—Valid route. · > – best—Best route. · d – damped—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – Stale—Stale route. · i – internal—Internal route. · e – external—External route. |
Origin |
Origin of the label block: · i – IGP—Originated in the AS. · e – EGP—Learned through EGP. · ? – incomplete—Unknown origin. |
LB offset |
Offset of the label block. |
LB range |
Size of the label block. |
LB base |
Initial value of the label block. |
# Display detailed information about the BGP VPLS label block that has RD 1:1, site ID 2, and offset 0 in the default BGP instance.
<Sysname> display bgp l2vpn signaling route-distinguisher 1:1 site-id 2 label-offset 0
BGP local router ID: 192.168.1.140
Local AS number: 100
Route distinguisher: 1:1
Total number of label blocks: 1
Paths: 1 available, 1 best
From : 2.2.2.9 (192.168.1.135)
Original nexthop: 2.2.2.9
Ext-Community : <RT: 1:1>, <L2VPN info: MTU 1500, Encap type BGP VPLS>
AS-path : (null)
Origin : igp
Attribute value : localpref 100, pref-val 0
Site ID : 2
LB offset : 0
LB base : 1418
LB range : 10
State : valid, internal, best
Table 5 Command output
Field |
Description |
Original nexthop |
Original next hop. If the label block was obtained from a BGP route update, this field displays the next hop address in that BGP route update. |
Ext-Community |
Extended community attribute: · RT—Route target. · L2VPN info—L2VPN information, including the MTU and encapsulation type. |
AS-path |
AS path attribute, which records all ASs that the label block passed to prevent routing loops. |
Origin |
Origin of the label block: · igp—Originated in the AS. · egp—Learned through EGP. · incomplete—Unknown origin. |
Attribute value |
Attribute of the label block: · MED—Multi-Exit Discriminator attribute. · localpref—Local preference value. · pref-val—Preferred value. · pre—Preference value. |
LB offset |
Offset of the label block. |
LB base |
Initial value of the label block. |
LB range |
Size of the label block. |
State |
State of the label block: · valid. · internal. · external. · local. · best. · not preferred for reason. For more information about the reasons, see Table 3. |
# Display BGP advertisement information for the specified VPLS label block in the default BGP instance.
<Sysname> display bgp l2vpn signaling route-distinguisher 1:1 site-id 1 label-offset 0 advertise-info
BGP local router ID: 192.168.1.140
Local AS number: 100
Route distinguisher: 1:1
Total number of label blocks: 1
Paths: 1 best
Site ID : 1
LB offset : 0
LB base : 1418
LB range : 10
Advertised to peers (2 in total):
2.2.2.9
3.3.3.9
Field |
Description |
LB offset |
Offset of the label block. |
LB base |
Initial value of the label block. |
LB range |
Size of the label block. |
display l2vpn auto-discovery
Use display l2vpn auto-discovery to display information about automatically discovered VPLS PEs.
Syntax
display l2vpn auto-discovery [ peer ip-address ] [ vsi vsi-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
peer ip-address: Displays information about the specified VPLS PE. If you do not specify a PE, this command displays information about all automatically discovered VPLS PEs.
vsi vsi-name: Displays automatically discovered VPLS PEs for a VSI. The vsi-name argument specifies the VSI name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays automatically discovered VPLS PEs for all VSIs.
Examples
# Display information about all automatically discovered VPLS PEs.
<Sysname> display l2vpn auto-discovery
Total number of automatically discovered peers: 2
VSI Name: bbb
RD PE_address VPLS ID Nexthop
2:2 1.1.1.9 100:100 1.1.1.9
2:2 3.3.3.9 100:100 3.3.3.9
Related commands
route-distinguisher
vpls-id
display l2vpn bgp
Use display l2vpn bgp to display VPLS label block information.
Syntax
display l2vpn bgp [ local | peer ip-address ] [ vsi vsi-name ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
local: Displays local VPLS label block information.
peer ip-address: Displays VPLS label block information received from a remote peer. The ip-address argument specifies the peer address.
vsi vsi-name: Displays VPLS label block information for a VSI. The vsi-name argument specifies the VSI name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays VPLS label block information for all VSIs.
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.
Usage guidelines
If you specify a peer, this command displays both the label block received from the peer and the local label block that matches the received label block.
If you do not specify a peer or local, this command displays label blocks received from all peers and local label blocks that match the received ones.
A local label block matches a received label block if the following condition is met: local label block LO ≤ remote site ID ≤ local label block LO + local label block LR – 1.
Examples
# Display brief information about label blocks received from all peers.
<Sysname> display l2vpn bgp
Total number of BGP PWs: 2, 2 up, 0 down
VSI Name: aaa
Rmt Site Offset RD Nexthop In/Out Label State
1 0 1:1 1.1.1.9 1001/1002 Up
3 0 1:1 3.3.3.9 1003/1110 Up
Table 7 Command output
Field |
Description |
Rmt Site |
ID of the remote site. |
Offset |
Offset of the label block. |
# Display detailed information about label blocks received from all peers.
<Sysname> display l2vpn bgp verbose
VSI Name: aaa
Remote Site ID : 1
Offset : 0
RD : 1:1
PW State : Up
Encapsulation : BGP-VPLS
MTU : 1500
Nexthop : 1.1.1.9
Local VC Label : 1419
Remote VC Label : 1420
Link ID : 9
Local Label Block : 1418/10/0
Remote Label Block : 1418/10/0
Local Flow Label : -
Remote Flow Label : -
Export Route Target: 1:1
Table 8 Command output
Field |
Description |
Local VC Label |
Incoming label of the PW. |
Remote VC Label |
Outgoing label of the PW. |
Link ID |
Link ID of the PW. |
Local Label Block |
Local label block: label base/label range/label-block offset. |
Remote Label Block |
Remote label block: label base/label range/label-block offset. |
Local Flow Label |
This field is not supported in the current software version. Flow label capability of the local PE: · Both—Flow label sending and receiving capabilities. · Send—Flow label sending capability. · Recv—Flow label receiving capability. This field display a hyphen (-) if the flow label feature is disabled. |
Remote Flow Label |
This field is not supported in the current software version. Flow label capability of the remote PE: · Both—Flow label sending and receiving capabilities. · Send—Flow label sending capability. · Recv—Flow label receiving capability. This field displays a hyphen (-) if the flow label feature is disabled. |
Export Route Target |
Route target of the remote label block. |
# Display brief information about all local label blocks.
<Sysname> display l2vpn bgp local
VSI Name: aaa
Site Offset Range Label Base RD
2 0 10 1418 1:1
Table 9 Command output
Field |
Description |
Offset |
Offset of the label block. |
Range |
Range of the label block. |
Label Base |
Initial value of the label block. |
RD |
RD of the label block. If no RD is configured, this field displays a hyphen (-). |
# Display detailed information about all local label blocks.
<Sysname> display l2vpn bgp local verbose
VSI Name: aaa
Site ID : 2
Offset : 0
RD : 1:1
Range : 10
Label Base : 1418
Link ID : 8,9,10,11,12,13,14,15,16
Table 10 Command output
Field |
Description |
Offset |
Offset of the label block. |
RD |
RD of the label block. If no RD is configured, this field displays a hyphen (-). |
Range |
Range of the label block. |
Label Base |
Initial value of the label block. |
Link ID |
Link IDs of the PWs established using the label block. |
Related commands
display l2vpn pw
display l2vpn forwarding
Use display l2vpn forwarding to display L2VPN forwarding information.
Syntax
display l2vpn forwarding { ac | pw } [ vsi vsi-name ] [ slot slot-number ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ac: Displays AC forwarding information.
pw: Displays PW forwarding information.
vsi vsi-name: Displays L2VPN forwarding information for a VSI. The vsi-name argument specifies the VSI name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays L2VPN forwarding information for all VSIs.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays L2VPN forwarding information for the master device.
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.
Examples
# Display brief AC forwarding information for all VSIs.
<Sysname> display l2vpn forwarding ac
Total number of VSIs: 1
Total number of ACs: 3
AC VSI Name Link ID
GE1/0/1 srv1 test 3
GE1/0/1 srv2 test 4
Table 11 Command output
Field |
Description |
Total number of VSIs |
Total number of VSIs, including VSIs that are not bound to any ACs. |
AC |
AC type: Layer 2 interface and Ethernet service instance. |
Link ID |
Link ID of the AC in the VSI. |
# Display detailed AC forwarding information for all VSIs.
<Sysname> display l2vpn forwarding ac verbose
VSI Name: vpls2
Interface: GE1/0/3 Service Instance: 4
Link ID : 1
Access Mode : VLAN
Encapsulation : s-vid 10
Bandwidth : Unlimited
Type : Manual
Table 12 Command output
Field |
Description |
Service Instance |
Ethernet service instance ID. This field is displayed only when the AC is an Ethernet service instance on a Layer 2 interface. |
Link ID |
Link ID of the AC in the VSI. |
Access Mode |
AC access mode: · VLAN. · Ethernet. |
Encapsulation |
Match criterion of the Ethernet service instance. This field is displayed only when the AC is an Ethernet service instance on a Layer 2 interface. |
Bandwidth |
Maximum bandwidth in kbps for traffic on the AC. If this field displays Unlimited, the traffic bandwidth of the AC is not limited. |
Type |
Ethernet service instance type. This field can only be Manual, which indicates that the Ethernet service instance is manually created. |
On-demand entry flushing state: · Flushed—The AC forwarding information has been issued to the hardware. · Removed—The AC forwarding information has been removed from the hardware. This field is not displayed if on-demand entry flushing is not configured for the AC. This field is displayed in only VXLANs. |
# Display brief PW forwarding information for all VSIs.
<Sysname> display l2vpn forwarding pw
Total number of VSIs: 1
Total number of PWs: 2, 2 up, 0 blocked, 0 down
VSI Name In/Out Label NID Link ID State
aaa 1272/1275 1034 8 Up
aaa 1271/1273 1035 9 Up
Table 13 Command output
Field |
Description |
Total number of VSIs |
Total number of VSIs, including VSIs that do not contain PWs. |
In/Out Label |
Incoming and outgoing labels of the PW. A hyphen (-) indicates that no label exists. |
NID |
NHLFE ID for the public tunnel that carries the PW. If equal-cost tunnels are available, this field displays multiple NIDs. If no tunnel is available, this field displays None. |
Link ID |
Link ID of the PW in the VSI. |
State |
PW state: Up, Down, or Blocked. Blocked indicates that the PW is blocked. |
# Display detailed PW forwarding information for all VSIs.
<Sysname> display l2vpn forwarding pw verbose
VSI Name: aaa
Link ID: 8
PW Type : VLAN PW State : Up
In Label : 1002 Out Label: 1005
MTU : 1500
PW Attributes : Main
VCCV CC : -
VCCV BFD : Fault Detection with BFD
Flow Label : -
Tunnel Group ID : 0x960000000
Tunnel NHLFE IDs: 1034
Table 14 Command output
Field |
Description |
Link ID |
Link ID of the PW in the VSI. |
PW Type |
Data encapsulation type of the PW. |
PW State |
PW state: Up, Down, or Blocked. Blocked indicates that the PW is blocked. |
In Label |
Incoming label of the PW. A hyphen (-) indicates that no label exists. |
Out Label |
Outgoing label of the PW. A hyphen (-) indicates that no label exists. |
PW Attributes |
PW attribute: · Main—The PW is the primary PW. · Backup—The PW is the backup PW. · No-split-horizon—Split horizon forwarding is disabled. |
VCCV CC |
VCCV CC type: Router-Alert: MPLS Router Alert Label. This field displays a hyphen (-) if no VCCV CC type is specified. |
VCCV BFD |
VCCV BFD type: · Fault Detection with BFD—BFD packets use IP/UDP encapsulation (with IP/UDP headers). · Fault Detection with Raw-BFD—BFD packets use PW-ACH encapsulation (without IP/UDP headers). This field displays a hyphen (-) if BFD is not used to verify PW connectivity. |
Flow Label |
This field is not supported in the current software version. Flow label capability: · Both—Flow label sending and receiving capabilities. · Send—Flow label sending capability. · Recv—Flow label receiving capability. This field display a hyphen (-) if the flow label feature is disabled. |
Tunnel Group ID |
ID of the tunnel group for the PW. |
Tunnel NHLFE IDs |
NHLFE ID of the public tunnel that carries the PW. If equal-cost tunnels are available, this field displays multiple NIDs. If no tunnel is available, this field displays None. |
display l2vpn mac-address
Use display l2vpn mac-address to display MAC address table information for VSIs.
Syntax
display l2vpn mac-address [ [ vsi vsi-name ] [ dynamic ] [ count | verbose ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vsi vsi-name: Displays MAC address table information for a VSI. The vsi-name argument specifies the VSI name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays MAC address table information for all VSIs.
dynamic: Displays dynamically generated MAC address entries. If you do not specify this keyword, the command displays all types of MAC address entries. The device supports only dynamic MAC address entries in the current software version.
count: Displays the number of MAC address entries. If you do not specify this keyword, the command displays information about MAC address entries.
verbose: Displays detailed information about MAC address entries. If you do not specify this keyword, the command displays brief information about MAC address entries.
Examples
# Display MAC address table information for all VSIs.
<Sysname> display l2vpn mac-address
* - The output interface is issued to another VSI
MAC Address State VSI Name Link ID/Name Aging
0001-0001-0001 Dynamic aaa GE1/0/1 Aging
0001-0001-0002 Dynamic aaa GE1/0/2 Aging
--- 2 mac address(es) found ---
# Display the total number of MAC address entries of all VSIs.
<Sysname> display l2vpn mac-address count
2 mac address(es) found
Table 15 Command output
Field |
Description |
State |
MAC address type. The MAC address type can only be Dynamic in the current software version, which indicates that the MAC address is dynamically learned. |
For a local site's MAC address, this field displays the name of the interface on which the Ethernet service instance is created. For a remote site's MAC address, this field displays the link ID of the PW from which the MAC address is learned. |
|
Aging |
Whether the MAC address entry will be aged. |
XX mac address(es) found |
Total number of MAC address entries of the VSI. |
# Display detailed information about MAC address entries of all VSIs.
<Sysname> display l2vpn mac-address verbose
MAC Address : 0000-0000-000b
VSI Name : vpn1
VXLAN ID : -
Interface : GE1/0/1
Link ID : 1
State : Dynamic
Aging : Aging
Table 16 Command output
Field |
Description |
VSI Name |
Name of the VSI to which the MAC address belongs. |
VXLAN ID |
VPLS does not support this field. |
Interface |
For a local site's MAC address, this field displays the name of the interface on which the Ethernet service instance is created. For a remote site's MAC address, this field displays a hyphen (-). |
Link ID |
Link ID of the AC or PW in the VSI. |
State |
MAC address type. The MAC address type can only be Dynamic in the current software version, which indicates that the MAC address is dynamically learned. |
Aging |
Whether the MAC address entry will be aged. |
Related commands
reset l2vpn mac-address
display l2vpn mac-address mac-move
Use display l2vpn mac-address mac-move to display the MAC address move records generated in all VSIs after the start of the device.
Syntax
display l2vpn mac-address mac-move [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, the command displays MAC address move records for all IRF member devices.
Usage guidelines
When a MAC address frequently moves between the specified two interfaces, Layer 2 loops might occur in the network. To discover and locate loops, you can view the MAC address move records.
In the MAC address move records, records with the same MAC address, VLAN, source port, and current port are considered to be one record.
An IRF member device can generate a maximum of 200 MAC address move records.
Examples
# Display the MAC address move records for all VSIs.
<Sysname> display l2vpn mac-address mac-move
MAC address : 0000-4900-03e7 VSI name : 3
Current port: GE1/0/1 srv2 Source port: GE1/0/2 srv3
Last time : 2019-02-19 20:44:15 Move count : 1
--- 1 MAC address moving records found ---
Table 17 Command output
Field |
Description |
Current port |
Interface to which the MAC address was moved. |
Source port |
Interface from which the MAC address was moved. |
Last time |
Last time when the MAC address was moved. |
Move count |
Number of MAC address moves after the device is started. |
display l2vpn pw
Use display l2vpn pw to display L2VPN PW information.
Syntax
display l2vpn pw [ vsi vsi-name ] [ protocol { bgp | evpn | ldp | static } ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vsi vsi-name: Displays L2VPN PW information for a VSI. The vsi-name argument specifies the VSI name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays L2VPN PW information for all VSIs.
protocol: Displays PWs created by a signaling protocol. If you do not specify a protocol, this command displays PWs created by all protocols.
bgp: Displays BGP PW information.
evpn: Displays EVPN PW information.
ldp: Displays LDP PW information, including PWs for FEC 128 (LDP PWs) and FEC 129 (BGP auto-discovery LDP PWs).
static: Displays static PW information.
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.
Usage guidelines
After you enable PW statistics, you can use the display l2vpn pw verbose command to display PW statistics.
Examples
# Display brief information about all PWs.
<Sysname> display l2vpn pw
Flags: M - main, B - backup, E - ecmp, BY - bypass, H - hub link, S - spoke link
N - no split horizon, A - administration, ABY - ac-bypass
PBY - pw-bypass
Total number of PWs: 5
5 up, 0 blocked, 0 down, 0 defect, 0 idle, 0 duplicate
VSI Name: aaa
Peer PW ID/Rmt Site In/Out Label Proto Flag Link ID State
2.2.2.9 2 1000/1009 BGP M 9 Up
3.3.3.9 3 1001/1011 BGP M 10 Up
VSI Name: bbb
Peer PW ID/Rmt Site In/Out Label Proto Flag Link ID State
2.2.2.9 - 1003/1003 LDP M 8 Up
3.3.3.9 - 1004/1006 LDP M 9 Up
VSI Name: ccc
Peer PW ID/Rmt Site In/Out Label Proto Flag Link ID State
2.2.2.9 500 1002/1002 LDP M 8 Up
Table 18 Command output
Field |
Description |
PWID/RmtSite/SrvID |
This field displays the following: · PW ID for an LDP PW (FEC 128) or a static PW. · A hyphen (-) for a BGP auto-discovery LDP PW (FEC 129). · Remote site ID for a BGP PW. · Remote service ID for an EVPN PW. · A hyphen (-) for an EVPN VPLS PW. |
Proto |
Protocol used to establish the PW: LDP, Static, EVPN, or BGP. |
Flag |
PW attribute flag: · M—Primary PW. · B—Backup PW. · E—ECMP PW. (This value does not apply to VPLS.) · BY—Bypass PW. (This value does not apply to VPLS.) · N—Split horizon forwarding is disabled. |
Link ID |
Link ID of the PW in the VSI. |
State |
PW state: · Up—The PW is available. · Down—The PW is not available. · Blocked—The PW is a backup PW. · Defect—BFD has detected a defect on the PW. · Idle—The incoming label of the PW is not available. · Dup—The incoming label of the static PW is occupied by a static LSP or a static CRLSP. |
# Display detailed information about all L2VPN PWs.
<Sysname> display l2vpn pw verbose
VSI Name: aaa
Peer: 2.2.2.9 Remote Site: 2
Signaling Protocol : BGP
Link ID : 9 PW State : Up
In Label : 1020 Out Label: 1019
MTU : 1500
PW Attributes : Main
VCCV CC : -
VCCV BFD : -
Flow Label : -
Tunnel Group ID : 0x800000960000000
Tunnel NHLFE IDs : 1038
Admin PW : -
VSI Name: bbb
Peer: 2.2.2.9 VPLS ID: 100:100
Signaling Protocol : LDP
Link ID : 8 PW State : Up
In Label : 1003 Out Label: 1003
MTU : 1500
PW Attributes : Main
VCCV CC : -
VCCV BFD : -
Flow Label : -
Tunnel Group ID : 0x800000960000000
Tunnel NHLFE IDs : 1038
Admin PW : -
VSI Name: ccc
Peer: 2.2.2.9 PW ID: 500
Signaling Protocol : LDP
Link ID : 8 PW State : Up
In Label : 1002 Out Label: 1002
MTU : 1500
PW Attributes : Main
VCCV CC : -
VCCV BFD : -
Flow Label : -
Tunnel Group ID : 0x800000960000000
Tunnel NHLFE IDs : 1038
Admin PW : -
Table 19 Command output
Field |
Description |
Peer |
IP address of the peer PE to which the PW is destined. |
Signaling Protocol |
Protocol used to establish the PW: LDP, Static, EVPN, or BGP. |
Link ID |
Link ID of the PW in the VSI. |
PW State |
PW state: · Up—The PW is available. · Down—The PW is not available. · Blocked—The PW is a backup PW. · Defect—BFD has detected a defect on the PW. · Idle—The incoming label of the PW is not available. · Duplicate—The incoming label of the static PW is occupied by a static LSP. |
Wait to Restore Time |
Wait time to switch traffic from the backup PW to the primary PW when the primary PW recovers, in seconds. If the switchover is disabled, this field displays Infinite. This field is available when both primary and backup PW exist, and is displayed only for the primary PW. |
Remaining Time |
Remaining wait time for traffic switchover, in seconds. This field is displayed after the switchover wait timer is started. |
MTU |
Negotiated MTU of the PW. |
PW Attributes |
PW attribute: · Main—The PW is the primary PW. · Backup—The PW is the backup PW. · No-split-horizon—Split horizon forwarding is disabled. |
VCCV CC |
VCCV CC type: Router-Alert: MPLS Router Alert Label. This field displays a hyphen (-) if no VCCV CC type is specified. |
VCCV BFD |
VCCV BFD type: · Fault Detection with BFD—BFD packets use IP/UDP encapsulation (with IP/UDP headers). · Fault Detection with Raw-BFD—BFD packets use PW-ACH encapsulation (without IP/UDP headers). This field displays a hyphen (-) if BFD is not used to verify PW connectivity. |
Flow Label |
This field is not supported in the current software version. Flow label capability: · Both—Flow label sending and receiving capabilities. · Send—Flow label sending capability. · Recv—Flow label receiving capability. This field display a hyphen (-) if the flow label feature is disabled. |
Tunnel Group ID |
ID of the tunnel group for the PW. |
Tunnel NHLFE IDs |
NHLFE ID of the public tunnel that carries the PW. If equal-cost tunnels are available, this field displays multiple NIDs. If no tunnel is available, this field displays None. |
VPLS ID |
ID of the VPLS instance. |
Remote Site |
ID of the remote site. |
display l2vpn pw-class
Use display l2vpn pw-class to display PW class information.
Syntax
display l2vpn pw-class [ class-name ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
class-name: Displays information about the PW class specified by its name, a case-sensitive string of 1 to 19 characters. If you do not specify a PW class, this command displays information about all PW classes.
verbose: Displays detailed PW class information. If you do not specify this keyword, the command displays brief PW class information.
Examples
# Display information about all PW classes.
<Sysname> display l2vpn pw-class
Total number of PW classes: 2
PW Class Name PW Type Control Word VCCV CC VCCV BFD
pw1 Ethernet Disabled - -
pw2 VLAN Disabled - -
Table 20 Command output
Field |
Description |
Control Word |
This field is not supported in the current software version. Whether control word is enabled. |
VCCV CC |
VCCV CC type: Router-Alert: MPLS Router Alert Label. This field displays a hyphen (-) if no VCCV CC type is specified. |
VCCV BFD |
VCCV BFD type: · Fault Detection with BFD—BFD packets use IP/UDP encapsulation (with IP/UDP headers). · Fault Detection with Raw-BFD—BFD packets use PW-ACH encapsulation (without IP/UDP headers). This field displays a hyphen (-) if BFD is not used to verify PW connectivity. |
# Display detailed information about all PW classes.
<Sysname> display l2vpn pw-class verbose
PW Class Name : pw1
PW Type : Ethernet
Control Word: Disabled
VCCV CC : -
VCCV BFD : BFD
Sequencing : -
Flow Label : -
PW Class Name : pw2
PW Type : VLAN
Control Word: Disabled
VCCV CC : -
VCCV BFD : BFD
Sequencing : -
Flow Label : -
Table 21 Command output
Field |
Description |
PW Type |
PW data encapsulation type: Ethernet or VLAN. |
Control Word |
This field is not supported in the current software version. Whether control word is enabled. |
VCCV CC |
VCCV CC type: Router-Alert: MPLS Router Alert Label. This field displays a hyphen (-) if no VCCV CC type is specified. |
VCCV BFD |
VCCV BFD type: · BFD—BFD packets use IP/UDP encapsulation (with IP/UDP headers). · Raw-BFD—BFD packets use PW-ACH encapsulation (without IP/UDP headers). This field displays a hyphen (-) if BFD is not used to verify PW connectivity. |
Flow Label |
This field is not supported in the current software version. Flow label capability: · Both—Flow label sending and receiving capabilities. · Send—Flow label sending capability. · Recv—Flow label receiving capability. This field display a hyphen (-) if the flow label feature is disabled. |
Related commands
pw-class
display l2vpn service-instance
Use display l2vpn service-instance to display Ethernet service instance information.
Syntax
display l2vpn service-instance [ interface interface-type interface-number [ service-instance instance-id ] ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface interface-type interface-number: Displays Ethernet service instance information for the specified Layer 2 Ethernet interface or Layer 2 aggregate interface. If you do not specify an interface, this command displays Ethernet service instance information for all Layer 2 Ethernet interfaces and Layer 2 aggregate interfaces.
service-instance instance-id: Displays information about the Ethernet service instance specified by its ID. The instance ID is in the range of 1 to 4096. If you specify interface interface-type interface-number without this option, the command displays information about all Ethernet service instances on the specified Layer 2 Ethernet interface or Layer 2 aggregate interface.
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.
Examples
# Display brief information about all Ethernet service instances.
<Sysname> display l2vpn service-instance
Total number of service-instances: 2, 2 up, 0 down
Total number of ACs: 2, 2 up, 0 down
Interface ID Owner LinkID State Type
GE1/0/3 1 vpls1 1 Up VSI
GE1/0/3 2 vpls2 1 Up VSI
Table 22 Command output
Field |
Description |
Interface |
Layer 2 Ethernet interface or Layer 2 aggregate interface. |
ID |
Ethernet service instance ID. |
Owner |
Name of the VSI bound to the Ethernet service instance. This field is empty if no VSI is bound. |
LinkID |
Link ID of the AC in the VSI. |
State |
Ethernet service instance state. |
Type |
L2VPN type of the Ethernet service instance: VSI or VPWS. |
# Display detailed information about all Ethernet service instances on Layer 2 Ethernet interface GigabitEthernet 1/0/3.
<Sysname> display l2vpn service-instance interface gigabitethernet 1/0/3 verbose
Interface: GE1/0/3
Service Instance: 1
Type : Manual
Encapsulation : s-vid 16
Bandwidth : -
VSI Name : vpls1
Link ID : 1
State : Up
Statistics : Disabled
Table 23 Command output
Field |
Description |
Interface |
Layer 2 Ethernet interface or Layer 2 aggregate interface. |
Service Instance |
Ethernet service instance ID. |
Type |
Ethernet service instance type. This field can only be Manual, which indicates that the Ethernet service instance is manually created. |
Encapsulation |
Match criteria of the Ethernet service instance. If no match criteria are configured, the field is not displayed. |
Bandwidth |
Maximum bandwidth in kbps for traffic of the AC. If this field displays a hyphen (-), the traffic bandwidth of the AC is not limited. |
VSI Name |
Name of the VSI bound to the Ethernet service instance. |
Link ID |
Link ID of the AC in the VSI. |
State |
Ethernet service instance state: Up and Down. |
Statistics |
Packet statistics state: · Enabled—Packet statistics is enabled for the Ethernet service instance. · Disabled—Packet statistics is disabled for the Ethernet service instance. |
Related commands
service-instance
display l2vpn vsi
Use display l2vpn vsi to display VSI information.
Syntax
display l2vpn vsi [ name vsi-name ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
name vsi-name: Displays information about a VSI. The vsi-name argument specifies the VSI name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays information about all VSIs.
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.
Examples
# Display brief information about all VSIs.
<Sysname> display l2vpn vsi
Total number of VSIs: 2, 1 up, 1 down, 0 admin down
VSI Name VSI Index MTU State
vpls1 0 1500 Up
vpls2 1 1500 Down
Table 24 Command output
Field |
Description |
State |
VSI state: · Up. · Down. · Admin down—The VSI is manually brought down by using the shutdown command. |
# Display detailed information about all VSIs.
<Sysname> display l2vpn vsi verbose
VSI Name: vpls1
VSI Index : 0
VSI Description : vsi for vpls1
VSI State : Up
MTU : 1500
Bandwidth : -
Broadcast Restrain : -
Multicast Restrain : -
Unknown Unicast Restrain: -
MAC Learning : Enabled
MAC Table Limit : -
MAC Learning rate : -
Drop Unknown : -
PW Redundancy : Master
Flooding : Enabled
Statistics : Disabled
VXLAN ID : -
LDP PWs:
Peer PW ID Link ID State
192.3.3.3 1 8 Up
192.3.3.3 1001 8 Blocked
BGP PWs:
Peer Remote Site Link ID State
192.4.4.4 1 9 Up
ACs:
AC Link ID State Type
GE1/0/3 srv1 1 Up Manual
Table 25 Command output
Field |
Description |
VSI Description |
If no description is configured for the VSI, this field is not displayed. |
VSI State |
VSI state: · Up. · Down. · Admin down—The VSI is manually brought down by using the shutdown command. |
Bandwidth |
Maximum bandwidth for traffic in the VSI, in kbps. This field displays Unlimited if no limit is set on the traffic in the VSI. This field displays a hyphen (-) if the VSI does not support setting the maximum bandwidth for traffic. |
Broadcast Restrain |
This field is not supported in the current software version. Broadcast suppression bandwidth for the VSI, in kbps. This field displays Unlimited if no limit is set on the broadcast traffic in the VSI. This field displays a hyphen (-) if the VSI does not support setting the maximum bandwidth for broadcast traffic. |
Multicast Restrain |
This field is not supported in the current software version. Multicast suppression bandwidth for the VSI, in kbps. This field displays Unlimited if no limit is set on the multicast traffic in the VSI. This field displays a hyphen (-) if the VSI does not support setting the maximum bandwidth for mulicast traffic. |
Unknown Unicast Restrain |
This field is not supported in the current software version. Unknown unicast suppression bandwidth for the VSI, in kbps. This field displays Unlimited if no limit is set on the unknown unicast traffic in the VSI. This field displays a hyphen (-) if the VSI does not support setting the maximum bandwidth for unknown unicast traffic. |
MAC Table Limit |
This field is not supported in the current software version. Maximum number of MAC addresses that the VSI can learn. This field displays Unlimited if no limit is set on the number of MAC addresses that the VSI can learn. |
MAC Learning Rate |
MAC address learning interval of the VSI. |
Drop Unknown |
This field is not supported in the current software version. Whether the VSI drops packets with unknown source MAC addresses after it has leaned the maximum number of MAC addresses: · Enabled—Drops packets with unknown source MAC addresses. · Disabled—Forwards packets with unknown source MAC addresses. |
PW Redundancy |
PW redundancy mode: · Slave—Master/slave mode and the local PE operates as the slave node. · Master—Master/slave mode and the local PE operates as the master node. |
Flooding |
VPLS does not support this field. |
Statistics |
This field is not supported in the current software version. VSI statistics state, Enabled or Disabled. |
VXLAN ID |
VPLS does not support this field. |
State |
PW state: Up, Down, Blocked, or BFD Defect. |
AC |
AC type: Layer 2 interface and Ethernet service instance. |
Type |
Ethernet service instance type. This field can only be Manual, which indicates that the Ethernet service instance is manually created. |
Related commands
vsi
encapsulation
Use encapsulation to configure a packet match criterion for an Ethernet service instance.
Use undo encapsulation to restore the default.
Syntax
encapsulation c-vid vlan-id-list
encapsulation s-vid vlan-id-list [ only-tagged ]
encapsulation s-vid vlan-id c-vid { vlan-id-list | all }
encapsulation { default | tagged | untagged }
undo encapsulation
Default
No packet match criterion is configured for an Ethernet service instance.
Views
Ethernet service instance view
Predefined user roles
network-admin
Parameters
c-vid: Matches packets with the specified inner VLAN IDs.
s-vid: Matches packets with the specified outer VLAN IDs.
only-tagged: Matches tagged packets. If the outer VLAN is not the PVID, the matching result does not differ, whether or not you specify the only-tagged keyword. If the outer VLAN is the PVID, the matching result depends on whether or not the only-tagged keyword is specified.
· To match only PVID-tagged packets, specify the only-tagged keyword.
· To match both untagged packets and PVID-tagged packets, do not specify the only-tagged keyword.
s-vid vlan-id c-vid { vlan-id-list | all }: Matches packets with the specified outer VLAN IDs and the specified inner VLAN IDs.
vlan-id: Specifies a VLAN ID in the range of 1 to 4094.
vlan-id-list: Specifies a space-separated list of up to eight VLAN items. Each item specifies a VLAN ID or a range of VLAN IDs in the format of start-VLAN-ID to end-VLAN-ID. The value range for VLAN IDs is 1 to 4094.
all: Specifies all VLAN IDs.
default: Matches packets that do not match any other Ethernet service instances on the interface. On an interface, you can configure this criterion only in one Ethernet service instance. The Ethernet service instance matches all packets if it is the only instance on the interface.
tagged: Matches any packets that have a VLAN tag.
untagged: Matches any packets that do not have a VLAN tag.
Usage guidelines
The match criteria of different Ethernet service instances cannot overlap on an interface.
You cannot modify the match criterion of an Ethernet service instance by repeating the encapsulation command. To modify the match criterion, you must first delete the match criterion with the undo encapsulation command and then execute the encapsulation command.
Deleting the match criteria configured for an Ethernet service instance removes the association between that Ethernet service instance and the VSI.
Examples
# Configure Ethernet service instance 1 on Layer 2 Ethernet interface GigabitEthernet 1/0/1 to match packets that have an outer VLAN ID of 111.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] service-instance 1
[Sysname-GigabitEthernet1/0/1-srv1] encapsulation s-vid 111
Related commands
display l2vpn service-instance
l2vpn enable
Use l2vpn enable to enable L2VPN.
Use undo l2vpn enable to disable L2VPN.
Syntax
l2vpn enable
undo l2vpn enable
Default
L2VPN is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
You must enable L2VPN before configuring other L2VPN settings.
Examples
# Enable L2VPN.
<Sysname> system-view
[Sysname] l2vpn enable
l2vpn switchover
Use l2vpn switchover to switch traffic from a PW to its backup or primary PW.
Syntax
l2vpn switchover peer ip-address pw-id pw-id
Views
User view
Predefined user roles
network-admin
Parameters
peer ip-address: Specifies the LSR ID of the peer PE.
pw-id pw-id: Specifies a PW by its ID in the range of 1 to 4294967295.
Usage guidelines
The specified LSR ID and PW ID uniquely identify a PW.
If a PW has a backup PW or primary PW, this command switches traffic from the PW to the backup or primary PW. If the PW does not have a backup or primary PW, this command does not perform the switchover.
Examples
# Switch traffic from PW 100 destined for 3.3.3.3 to its backup PW.
<Sysname> l2vpn switchover peer 3.3.3.3 pw-id 100
mac-learning enable
Use mac-learning enable to enable MAC address learning for a VSI.
Use undo mac-learning enable to disable MAC address learning for a VSI.
Syntax
mac-learning enable
undo mac-learning enable
Default
MAC address learning is enabled for a VSI.
Views
VSI view
Predefined user roles
network-admin
Usage guidelines
If MAC address learning is disabled for a VSI, the VSI does not learn the source MAC addresses of received packets.
Examples
# Disable MAC address learning for VSI vpn1.
<Sysname> system-view
[Sysname] vsi vpn1
[Sysname-vsi-vpn1] undo mac-learning enable
Related commands
display l2vpn vsi
peer
Use peer in VSI LDP signaling view to configure a VSI LDP PW and enter its view, or enter the view of an existing VSI LDP PW.
Use peer in VSI static configuration view to configure a VSI static PW and enter its view, or enter the view of an existing VSI static PW.
Use undo peer to delete a VPLS PW.
Syntax
VSI LDP signaling view:
peer ip-address [ pw-id pw-id ] [ ignore-standby-state | no-split-horizon | pw-class class-name | tunnel-policy tunnel-policy-name ] *
undo peer ip-address pw-id pw-id
VSI static configuration view:
peer ip-address [ pw-id pw-id ] [ in-label label-value out-label label-value [ no-split-horizon | pw-class class-name | tunnel-policy tunnel-policy-name ] * ]
undo peer ip-address pw-id pw-id
Default
No PWs exist for VPLS.
Views
VSI LDP signaling view
VSI static configuration view
Predefined user roles
network-admin
Parameters
ip-address: Specifies the LSR ID of the peer PE.
pw-id pw-id: Specifies a PW ID for the PW, in the range of 1 to 4294967295.
in-label label-value: Specifies the incoming label of the PW. The value range is 16 to 1023.
out-label label-value: Specifies the outgoing label of the PW. The value range is 16 to 1048575.
ignore-standby-state: Ignores the PW active/standby status bit received from the remote PE. This keyword is applicable only to LDP PWs.
no-split-horizon: Disables split horizon forwarding for the PW. By default, a PW must use the split horizon forwarding scheme to forward packets.
pw-class class-name: Specifies a PW class by its name, a case-sensitive string of 1 to 19 characters. You can specify a PW class to configure the PW data encapsulation type. If you do not specify a PW class, the PW data encapsulation type is VLAN.
tunnel-policy tunnel-policy-name: Specifies a tunnel policy by its name, a case-insensitive string of 1 to 19 characters. If you do not specify a tunnel policy, the PW uses the default tunnel policy.
Usage guidelines
A PE uses the PW Preferential Forwarding Status bit in LDP messages to advertise the local PWs' active/standby states. When the bit is set, it indicates that the local PW is in standby state. When the bit is cleared, it indicates that the local PW is in active state.
In master/slave mode of PW redundancy, the slave PE selects the forwarding PW among the set of redundant PWs based on the status bit received from the master PE. If you specify the ignore-standby-state keyword, the PE ignores the status bit received from the master PE and uses the primary PW to forward packets as long as the primary PW is up.
To create a static PW, you must specify the incoming and outgoing labels. To enter VSI static PW view of an existing static PW, you do not need to specify the incoming and outgoing labels.
The PW ID for a PW must be the same on the PEs at the ends of the PW.
On a PE, the LSR ID of the peer PE and the PW ID uniquely identify a PW. The peer LSR ID and PW ID combination of a PW must be unique among all VPLS PWs and cross-connect PWs.
If both the default PW ID in the default-pw-id command and a PW ID in the peer command are configured, the PW ID in the peer command is used. If only the default PW ID is configured, the default PW ID is used. If no default PW ID is configured, you must provide a PW ID in the peer command.
When you add a static PW, you must make sure that static PW uses a different incoming label than an existing static LSP. If the incoming label is duplicated, you cannot make the static PW take effect by changing the incoming label of the static LSP. Instead, you must delete the static PW and then reconfigure the static PW with an unused incoming label.
Examples
# Configure an LDP PW for VSI vpn1 and enter VSI LDP PW view: specify the peer PE address as 4.4.4.4, set the PW ID to 200, and disable split horizon forwarding for the PW.
<Sysname> system-view
[Sysname] vsi vpn1
[Sysname-vsi-vpn1] pwsignaling ldp
[Sysname-vsi-vpn1-ldp] peer 4.4.4.4 pw-id 200 no-split-horizon
[Sysname-vsi-vpn1-ldp-4.4.4.4-200]
# Configure a static PW for VSI vpn1 and enter VSI static PW view: specify the peer PE address as 5.5.5.5, set the PW ID to 200, incoming label to 100, and outgoing label to 200, and disable split horizon forwarding for the PW.
<Sysname> system-view
[Sysname] vsi vpn1
[Sysname-vsi-vpn1] pwsignaling static
[Sysname-vsi-vpn1-static] peer 5.5.5.5 pw-id 200 in-label 100 out-label 200 no-split-horizon
[Sysname-vsi-vpn1-static-5.5.5.5-200]
Related commands
default-pw-id
display l2vpn pw
pw-class
tunnel-policy
peer auto-discovery
Use peer auto-discovery to enable BGP to exchange VPLS PE information with the specified peers.
Use undo peer auto-discovery to disable BGP from exchanging VPLS PE information with the specified peers.
Syntax
peer { group-name | ip-address [ mask-length ] } auto-discovery [ non-standard ]
undo peer { group-name | ip-address [ mask-length ] } auto-discovery
Default
BGP can exchange VPLS PE information with a BGP L2VPN peer or peer group through RFC 6074 MP_REACH_NLRI.
Views
BGP L2VPN address family view
Predefined user roles
network-admin
Parameters
group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The specified peer group must have been created.
ip-address: Specifies a peer by its IP address. The specified peer must have been created.
mask-length: Specifies a mask length in the range of 0 to 32. You can use the ip-address and mask-length arguments together to specify a subnet. If you specify a subnet, this command enables BGP to exchange VPLS PE information with all dynamic peers in the subnet.
non-standard: Uses non-standard MP_REACH_NLRI to exchange VPLS PE information. If you do not specify this keyword, RFC 6074 MP_REACH_NLRI is used to exchange VPLS PE information.
Usage guidelines
L2VPN can use MP-BGP to exchange VPLS PE information and find remote PEs in the same VPLS instance.
To enable BGP to exchange VPLS PE information with the specified peers through RFC 6074 MP_REACH_NLRI, you can also use the peer enable command in BGP L2VPN address family view. To disable the capability, use the undo peer auto-discovery command.
Examples
# Enable BGP to exchange VPLS PE information with the peer 3.3.3.9 through RFC 6074 MP_REACH_NLRI.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp-default] address-family l2vpn
[Sysname-bgp-default-l2vpn] peer 3.3.3.9 auto-discovery
Related commands
display bgp l2vpn auto-discovery
peer signaling
Use peer signaling to enable BGP to exchange label block information with the specified peers.
Use undo peer signaling to disable BGP to exchange label block information with the specified peers.
Syntax
peer { group-name | ip-address [ mask-length ] } signaling
undo peer { group-name | ip-address [ mask-length ] } signaling
Default
BGP can exchange label block information with a BGP L2VPN peer or peer group.
Views
BGP L2VPN address family view
Predefined user roles
network-admin
Parameters
group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters. The specified peer group must have been created.
ip-address: Specifies a peer by its IP address. The specified peer must have been created.
mask-length: Specifies a mask length in the range of 0 to 32. You can use the ip-address and mask-length arguments together to specify a subnet. If you specify a subnet, this command enables BGP to exchange label block information with all dynamic peers in the subnet.
Usage guidelines
L2VPN uses MP-BGP to exchange label blocks when creating a BGP PW.
To enable BGP to exchange label block information with the specified peers, you can also use the peer enable command in BGP L2VPN address family view. To disable the capability, use the undo peer signaling command.
Examples
# Enable BGP to exchange label block information with peer 3.3.3.9.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp-default] address-family l2vpn
[Sysname-bgp-default-l2vpn] peer 3.3.3.9 signaling
Related commands
display bgp l2vpn signaling
policy vpn-target
Use policy vpn-target to enable route target-based filtering of incoming BGP L2VPN information.
Use undo policy vpn-target to disable route target-based filtering of incoming BGP L2VPN information.
Syntax
policy vpn-target
undo policy vpn-target
Default
Route target-based filtering of incoming BGP L2VPN information is enabled.
Views
BGP L2VPN address family view
Predefined user roles
network-admin
Usage guidelines
If route target-based filtering is enabled, L2VPN accepts only the incoming BGP L2VPN information whose export route target attribute matches the local import route target attribute. If route target-based filtering is disabled, L2VPN accepts all incoming BGP L2VPN information.
To establish a BGP PW between two MP-IBGP peers that use a route reflector, you must disable route target-based filtering of incoming BGP L2VPN information on the route reflector.
Examples
# Disable route target-based filtering of incoming BGP L2VPN information.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp-default] address-family l2vpn
[Sysname-bgp-default-l2vpn] undo policy vpn-target
pw-class (auto-discovery VSI view)
Use pw-class to specify a PW class for an auto-discovery VSI.
Use undo pw-class to restore the default.
Syntax
pw-class class-name
undo pw-class
Default
No PW class is specified.
Views
Auto-discovery VSI view
Predefined user roles
network-admin
Parameters
class-name: Specifies a PW class by its name, a case-sensitive string of 1 to 19 characters.
Usage guidelines
The specified PW class will be used to establish all PWs on the auto-discovery VSI.
Examples
# Specify a PW class named pw100 for auto-discovery VSI aaa.
<Sysname> system-view
[Sysname] pw-class pw100
[Sysname-pw-pw100] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] auto-discovery bgp
[Sysname-vsi-aaa-auto] pw-class pw100
Related commands
display l2vpn pw-class
pw-type
pw-class (system view)
Use pw-class to create a PW class and enter its view, or enter the view of an existing PW class.
Use undo pw-class to delete a PW class.
Syntax
pw-class class-name
undo pw-class class-name
Default
No PW classes exist.
Views
System view
Predefined user roles
network-admin
Parameters
class-name: Specifies a name for the PW class, a case-sensitive string of 1 to 19 characters.
Usage guidelines
In PW class view, you can configure PW attributes such as the PW data encapsulation type. A PW class simplifies PW attribute configuration for PWs that have the same PW attributes. You can configure the PW attributes in a PW class, and specify the PW class for the PWs.
Examples
# Create a PW class named pw100 and enter PW class view.
<Sysname> system-view
[Sysname] pw-class pw100
[Sysname-pw-pw100]
Related commands
display l2vpn pw-class
pw-type
pw-redundancy
Use pw-redundancy to specify the master/slave PW redundancy mode and configure the local PE as the master node.
Use undo pw-redundancy to restore the default.
Syntax
pw-redundancy { independent | master }
undo pw-redundancy
Default
The PW redundancy mode is master/slave and the local PE operates as the slave node.
Views
VSI LDP signaling view
Predefined user roles
network-admin
Parameters
independent: Uses the independent PW redundancy operation mode.
master: Uses the master/slave PW redundancy mode and configures the local PE as the master node.
Usage guidelines
This command is applicable only to LDP PWs.
LDP PWs support the independent and master/slave PW redundancy operation modes.
· Independent mode—The two PEs of a PW use LDP to advertise their respective PW active/standby state to each other. A PW can forward traffic only when it is up and active at both ends of the PW. In this mode, make sure both PEs of a PW use the independent PW redundancy operation mode.
· Master/slave mode—One endpoint PE of a PW operates as the master node and the other endpoint PE operates as the slave node. The master PE determines the active/standby state of the PW and uses LDP to advertise the PW state to the slave PE. The slave PE uses the same PW state as the master PE based on the information received from the master PE. In this way, the master and slave PEs for the set of redundant PWs can use the same active PW to forward user traffic.
The slave PE does not need to send the PW states to the master PE and the master PE ignores the PW states sent by the slave PE.
Do not configure this command on the local PE if the remote PE does not support the master/slave PW redundancy mode.
Examples
# Use the master/slave PW redundancy mode and configure the local PE as the master node.
<Sysname> system-view
[Sysname] vsi vpn1
[Sysname-vsi-vpn1] pwsignaling ldp
[Sysname-vsi-vpn1-ldp] pw-redundancy master
Related commands
backup-peer
display l2vpn pw
peer
pwsignaling
Use pwsignaling to specify a PW signaling protocol for a VSI, and enter the VSI signaling protocol view.
Use undo pwsignaling to remove the specified PW signaling protocol for a VSI.
Syntax
pwsignaling { ldp | static }
undo pwsignaling { ldp | static }
Default
No PW signaling protocol is specified for a VSI.
Views
VSI view
Predefined user roles
network-admin
Parameters
ldp: Establishes PWs through LDP (FEC 128) and enters VSI LDP signaling view.
static: Establishes PWs statically and enters VSI static configuration view.
Examples
# Configure VSI vpn1 to use LDP to establish LDP PWs, and enter VSI LDP signaling view.
<Sysname> system-view
[Sysname] vsi vpn1
[Sysname-vsi-vpn1] pwsignaling ldp
[Sysname-vsi-vpn1-ldp]
Related commands
display l2vpn pw
pw-type
Use pw-type to specify a PW data encapsulation type for a PW class.
Use undo pw-type to restore the default.
Syntax
pw-type { ethernet | vlan } [ force-for-vpls ]
undo pw-type
Default
The PW data encapsulation type for a PW class is VLAN.
Views
PW class view
Predefined user roles
network-admin
Parameters
ethernet: Specifies the PW data encapsulation type as Ethernet.
vlan: Specifies the PW data encapsulation type as VLAN.
force-for-vpls: Forces VPLS to use and advertise the specified encapsulation type (Ethernet or VLAN). Use this keyword on a Comware 7 device when the device establishes a BGP PW with a Comware 5 device that uses the Ethernet or VLAN encapsulation type. If you do not specify this keyword for a Comware 7 device, the Comware 7 device always advertising the BGP-VPLS encapsulation type (type value 19) for BGP PW establishment.
Usage guidelines
When the PW data encapsulation type is Ethernet, the PE encapsulates packets forwarded between the AC and PW as follows:
· Traffic from the AC to the PW cannot carry the P-tag assigned by the service provider.
¡ If traffic from the AC has the P-tag, the PE removes the P-tag, and adds a PW label and an outer tag into the packet before forwarding it.
¡ If traffic from the AC does not have the P-tag, the PE adds a PW label and an outer tag into the packet before forwarding it.
· For traffic received from the PW:
¡ If the AC access mode is VLAN, the PE adds the P-tag and forwards the traffic through the AC.
¡ If the AC access mode is Ethernet, the PE directly forwards the traffic through the AC. The PE cannot modify or delete the P-tag for the traffic from the PW.
When the PW data encapsulation type is VLAN, the PE encapsulates packets forwarded between the AC and PW as follows:
· Traffic from the AC to the PW must carry the P-tag.
¡ If traffic from the AC has the P-tag, the PE performs one of the following operations:
- Keeps the P-tag when the peer PE does not require the ingress to modify the P-tag.
- Changes the P-tag to the expected value (which can be zero) when the peer PE requires the ingress to modify the P-tag. Then, the PE adds a PW label and an outer tag into the packet before forwarding it.
¡ If traffic from the AC does not have the P-tag, the PE performs one of the following operations:
- Adds a P-tag of 0 when the peer PE does not require the ingress to modify the P-tag.
- Adds the expected P-tag (which can be zero) when the peer PE requires the ingress to modify the P-tag. Then, the PE adds a PW label and an outer tag into the packet before forwarding it.
· For traffic received from the PW:
¡ If the AC access mode is VLAN, the PE modifies or keeps the P-tag and forwards the traffic through the AC.
¡ If the AC access mode is Ethernet, the PE removes the P-tag and forwards the traffic through the AC.
To ensure successful negotiation of the encapsulation type during PW establishment, configure the same data encapsulation type on all devices in the same VPLS instance.
Examples
# Configure the PW data encapsulation type as Ethernet.
<Sysname> system-view
[Sysname] pw-class pw100
[Sysname-pw-pw100] pw-type ethernet
Related commands
display l2vpn pw-class
reset l2vpn mac-address
Use reset l2vpn mac-address to clear MAC address entries for VSIs.
Syntax
reset l2vpn mac-address [ vsi vsi-name ]
Views
User view
Predefined user roles
network-admin
Parameters
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command clears MAC address entries for all VSIs.
Usage guidelines
When a VSI learns wrong MAC addresses or has learned the maximum number of MAC addresses, use this command to clear MAC addresses for the VSI. Then, the VSI can learn MAC addresses again.
Examples
# Clear MAC address entries for VSI vpn1.
<Sysname> reset l2vpn mac-address vsi vpn1
Related commands
display l2vpn mac-address vsi
reset l2vpn mac-address mac-move
Use reset l2vpn mac-address mac-move to clear the MAC address move records generated in all VSIs after the start of the device.
Syntax
reset l2vpn mac-address mac-move
Views
User view
Predefined user roles
network-admin
Examples
# Clear the MAC address move records for all VSIs.
<Sysname> reset l2vpn mac-address mac-move
Related commands
display l2vpn mac-address mac-move
revertive
Use revertive to specify the switchover mode and set the switchover wait time.
Use undo revertive to restore the default.
Syntax
revertive { wtr wtr-time | never }
undo revertive { wtr | never }
Default
The switchover mode is revertive and the switchover wait time is 0 seconds. When the primary PW recovers, traffic is immediately switched back from the backup PW to the primary PW.
Views
VSI static configuration view
Predefined user roles
network-admin
Parameters
wtr wtr-time: Specifies the switchover mode as revertive and specifies the wait time in the range of 0 to 3600 seconds. When the primary PW recovers, the PE waits for the specified time before switching traffic from the backup PW to the primary PW.
never: Specifies the switchover mode as non-revertive. After the primary PW recovers, traffic is not switched from the backup PW to the primary PW.
Examples
# Specify the revertive mode and set the switchover wait time to 120 seconds for static PWs in VSI vpn1.
<Sysname> system-view
[Sysname] vsi vpn1
[Sysname-vsi-vpn1] pwsignaling static
[Sysname-vsi-vpn1-static] revertive wtr 120
Related commands
display l2vpn pw
route-distinguisher
Use route-distinguisher to configure a route distinguisher (RD) for an auto-discovery VSI.
Use undo route-distinguisher to restore the default.
Syntax
route-distinguisher route-distinguisher
undo route-distinguisher
Default
No RD is configured for an auto-discovery VSI.
Views
Auto-discovery VSI view
Predefined user roles
network-admin
Parameters
route-distinguisher: Specifies an RD, a string of 3 to 21 characters. An RD can be in one of the following formats:
· 16-bit AS number:32-bit user-defined number. For example, 101:3.
· 32-bit IP address:16-bit user-defined number. For example, 192.168.122.15:1.
· 32-bit AS number:16-bit user-defined number, where the AS number must be equal to or greater than 65536. For example, 65536:1.
· 32-bit AS number in dotted decimal notation:16-bit user-defined number, for example, 10.1:1.
Usage guidelines
VPLS uses RDs to differentiate the sites with the same site ID but in different VPNs.
BGP adds the configured RD before the site ID. The RD and the site ID uniquely identify a VPN site.
The configured RD applies to both BGP neighbor auto-discovery and VPLS label block advertisement.
You cannot configure the same RD for different BGP VSIs.
To modify an RD, execute the undo route-distinguisher command to remove the RD and then execute the route-distinguisher command.
Examples
# Configure RD 22:1 for BGP VSI aaa.
<Sysname> system-view
[Sysname] vsi aaa
[Sysname-vsi-aaa] auto-discovery bgp
[Sysname-vsi-aaa-auto] route-distinguisher 22:1
rr-filter
Use rr-filter to create a route reflector (RR) reflection policy.
Use undo rr-filter to restore the default.
Syntax
rr-filter ext-comm-list-number
undo rr-filter
Default
An RR does not filter reflected L2VPN information.
Views
BGP L2VPN address family view
Predefined user roles
network-admin
Parameters
ext-comm-list-number: Specifies an extended community list number in the range of 1 to 65535.
Usage guidelines
After this command is executed, only the L2VPN information that is permitted by the specified extended community list is reflected.
By configuring different RR reflection policies on RRs in a cluster, you can implement load balancing among the RRs.
For more information about extended community lists, see Layer 3—IP Routing Configuration Guide.
Examples
# Configure the RR to reflect only the BGP L2VPN information that is permitted by extended community list 10.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp-default] address-family l2vpn
[Sysname-bgp-default-l2vpn] rr-filter 10
Related commands
ip extcommunity-list (Layer 3—IP Routing Command Reference)
service-instance
Use service-instance to create an Ethernet service instance on an interface and enter its view, or enter the view of an existing Ethernet service instance.
Use undo service-instance to delete an Ethernet service instance on an interface.
Syntax
service-instance instance-id
undo service-instance instance-id
Default
No Ethernet service instances exist.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
instance-id: Specifies an ID for the Ethernet service instance, in the range of 1 to 4096.
Examples
# Create Ethernet service instance 1 on Layer 2 Ethernet interface GigabitEthernet 1/0/1, and enter Ethernet service instance 1 view.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] service-instance 1
[Sysname-GigabitEthernet1/0/1-srv1]
Related commands
display l2vpn service-instance
shutdown
Use shutdown to disable a VSI.
Use undo shutdown to enable a VSI.
Syntax
shutdown
undo shutdown
Default
A VSI is enabled.
Views
VSI view
Predefined user roles
network-admin
Usage guidelines
After you disable a VSI, the VSI cannot provide VPLS services.
Use the shutdown command when you want to temporarily disable VPLS. When a VSI is disabled, you can still configure the VSI. After the configuration, use the undo shutdown command to enable the VSI. The VSI will provide VPLS services using the new settings.
Examples
# Disable VSI vpn1.
<Sysname> system-view
[Sysname] vsi vpn1
[Sysname-vsi-vpn1] shutdown
Related commands
display l2vpn vsi
signaling-protocol
Use signaling-protocol to specify a signaling protocol and enter the specified signaling view. The specified signaling protocol is used to establish PWs to the automatically discovered remote PEs.
Use undo signaling-protocol to restore the default.
Syntax
signaling-protocol { bgp | ldp }
undo signaling-protocol
Default
No signaling protocol is specified.
Views
Auto-discovery VSI view
Predefined user roles
network-admin
Parameters
bgp: Specifies the signaling protocol as BGP and enters auto-discovery VSI BGP signaling view.
ldp: Specifies the signaling protocol as LDP and enters auto-discovery VSI LDP signaling view.
Usage guidelines
You can specify only one signaling protocol in the same auto-discovery VSI view. To modify the signaling protocol, execute the undo signaling-protocol command to remove the signaling protocol and then execute the signaling-protocol command.
Examples
# Use LDP (FEC 129) to establish a PW to a remote PE discovered by BGP and enter auto-discovery VSI LDP signaling view.
<Sysname> system-view
[Sysname] vsi aaa
[Sysname-vsi-aaa] auto-discovery bgp
[Sysname-vsi-aaa-auto] signaling-protocol ldp
[Sysname-vsi-aaa-auto-ldp]
Related commands
display l2vpn pw
display l2vpn vsi
site
Use site to create a local site.
Use undo site to delete a local site.
Syntax
site site-id [ range range-value ] [ default-offset default-offset ]
undo site site-id
Default
No sites exist.
Views
Auto-discovery VSI BGP signaling view
Predefined user roles
network-admin
Parameters
site-id: Specifies a local site ID. The value range is 0 to 120.
range range-value: Specifies the maximum number of sites in a VPLS instance, in the range of 2 to 1 + the maximum number of site-id. The default value is 10.
default-offset default-offset: Specifies the start site ID, 0 or 1. The default value is 0.
Usage guidelines
You can create multiple local sites for a VSI.
You can use the site command to increase the range value for an existing site. You cannot decrease the range value for an existing site with the site command. To decrease the range value, execute the undo site command to delete the site and then execute the site command.
You cannot modify the default-offset for a site with the site command. To modify it, execute the undo site command to delete the site and then execute the site command.
Examples
# Create site 1, configure the VPLS instance to contain a maximum of 30 sites, and set the start site ID to 0 for VSI aaa.
<Sysname> system-view
[Sysname] vsi aaa
[Sysname-vsi-aaa] auto-discovery bgp
[Sysname-vsi-aaa-auto] signaling-protocol bgp
[Sysname-vsi-aaa-auto-bgp] site 1 range 30 default-offset 0
Related commands
display l2vpn pw
display l2vpn vsi
snmp-agent trap enable l2vpn
Use snmp-agent trap enable l2vpn to enable SNMP notifications for L2VPN PW.
Use undo snmp-agent trap enable l2vpn to disable SNMP notifications for L2VPN PW.
Syntax
snmp-agent trap enable l2vpn [ flow-label-nonsupport | label-resource | maclimit-vsi | pw-delete | pw-limitnum | pw-parameter | pw-switch | pw-up-down | vsi-delete | vsi-state-change ] *
undo snmp-agent trap enable l2vpn [ flow-label-nonsupport | label-resource | maclimit-vsi | pw-delete | pw-limitnum | pw-parameter | pw-switch | pw-up-down | vsi-delete | vsi-state-change ] *
Default
SNMP notifications for L2VPN PW are disabled.
Views
System view
Predefined user roles
network-admin
Parameters
flow-label-nonsupport: Enables L2VPN flow label not supported notifications.
label-resource: Enables PW label resource insufficiency notifications.
maclimit-vsi: Enables the system to generate notifications when the number of MAC addresses learned by a VSI reaches the limit.
pw-delete: Enables PW deletion notifications.
pw-limitnum: Enables the system to generate notifications when the number of PWs in a VSI reaches the limit.
pw-parameter: Enables PW negotiation parameter inconsistency notifications.
pw-switch: Enables PW primary/backup switchover notifications.
pw-up-down: Enables PW up-down notifications.
vsi-delete: Enables VSI deletion notifications.
vsi-state-change: Enables VSI state change notifications.
Usage guidelines
This feature enables L2VPN to generate SNMP notifications when the number of MAC addresses learned by an AC/PW/VSI reaches the limit, the number of PWs in a VSI reaches the limit, or VSI state change, PW label resource insufficiency, PW negotiation parameter inconsistency, PW deletion, PW switchover, or PW status change occurs. For L2VPN event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see the network management and monitoring configuration guide for the device.
If you do not specify a notification type, this command enables all types of notifications for L2VPN PW.
Examples
# Enable PW up-down SNMP notifications.
<Sysname> system-view
[Sysname] snmp-agent trap enable l2vpn pw-up-down
Related commands
display snmp-agent trap-list (Network Management and Monitoring Command Reference)
tunnel-policy (auto-discovery VSI view)
Use tunnel-policy to specify a tunnel policy for an auto-discovery VSI.
Use undo tunnel-policy to restore the default.
Syntax
tunnel-policy tunnel-policy-name
undo tunnel-policy
Default
No tunnel policy is specified.
Views
Auto-discovery VSI view
Predefined user roles
network-admin
Parameters
tunnel-policy-name: Specifies a tunnel policy by its name, a case-sensitive string of 1 to 19 characters.
Usage guidelines
The PWs on the auto-discovery VSI use the specified tunnel policy to select public tunnels.
If you do not specify a tunnel policy or specify a nonexistent tunnel policy, the default tunnel policy applies. The default tunnel policy selects only one public tunnel for a PW in this order: LSP tunnel, GRE tunnel, CRLSP tunnel.
Examples
# Specify tunnel policy policy1 for auto-discovery VSI aaa.
<Sysname> system-view
[Sysname] tunnel-policy policy1
[Sysname-tunnel-policy-policy1] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] auto-discovery bgp
[Sysname-vsi-aaa-auto] tunnel-policy policy1
Related commands
tunnel-policy (system view)
vpls-id
Use vpls-id to set the VPLS ID for a VSI.
Use undo vpls-id to restore the default.
Syntax
vpls-id vpls-id
undo vpls-id
Default
No VPLS ID is specified for a VSI.
Views
Auto-discovery VSI LDP signaling view
Predefined user roles
network-admin
Parameters
vpls-id: Specifies a VPLS ID, a string of 3 to 21 characters. You can specify a VPLS ID in one of the following formats:
· 16-bit AS number:32-bit user-defined number. For example, 101:3.
· 32-bit IP address:16-bit user-defined number. For example, 192.168.122.15:1.
· 32-bit AS number:16-bit user-defined number, where the AS number must be equal to or greater than 65536. For example, 65536:1.
Usage guidelines
A VPLS ID uniquely identifies a VPLS instance. Two PEs must have the same VPLS ID to establish a PW.
VPLS IDs are used in the scenarios where BGP is used to find remote PEs and where FEC 129 LDP is used to establish PWs to the remote PEs.
The local PE advertises a BGP update that includes the configured VPLS ID as an extended community attribute to the remote PE. The remote PE compares the received VPLS ID with its own VPLS ID. If the two VPLS IDs are identical, the two PEs use FEC 129 LDP to establish a PW. If not, the PEs do not establish a PW.
To change a VPLS ID, execute the undo vpls-id command to remove the VPLS ID and then execute the vpls-id command.
Examples
# Configure the VPLS ID 100:1 for VSI aaa.
<Sysname> system-view
[Sysname] vsi aaa
[Sysname-vsi-aaa] auto-discovery bgp
[Sysname-vsi-aaa-auto] signaling-protocol ldp
[Sysname-vsi-aaa-auto-ldp] vpls-id 100:1
Related commands
display l2vpn pw
display l2vpn vsi
vpn-target
Use vpn-target to configure route targets for an auto-discovery VSI.
Use undo vpn-target to remove route targets for an auto-discovery VSI.
Syntax
vpn-target vpn-target&<1-8> [ both | export-extcommunity | import-extcommunity ]
undo vpn-target { vpn-target&<1-8> | all } [ both | export-extcommunity | import-extcommunity ]
Default
No route targets are configured for an auto-discovery VSI.
Views
Auto-discovery VSI view
Predefined user roles
network-admin
Parameters
vpn-target&<1-8>: Specifies a space-separated list of a maximum of eight route targets.
A route target is a string of 3 to 21 characters in one of the following formats:
· 16-bit AS number:32-bit user-defined number. For example, 101:3.
· 32-bit IP address:16-bit user-defined number. For example, 192.168.122.15:1.
· 32-bit AS number:16-bit user-defined number, where the AS number must be equal to or greater than 65536. For example, 65536:1.
· 32-bit AS number in dotted decimal notation:16-bit user-defined number, for example, 10.1:1.
both: Uses the specified route targets as both import targets and export targets. The both keyword is used when you do not specify any of both, export-extcommunity, and import-extcommunity.
export-extcommunity: Uses the specified route targets as export targets.
import-extcommunity: Uses the specified route targets as import targets.
all: Removes all route targets.
Usage guidelines
A local PE sets the route targets as export targets in BGP update messages when it advertises L2VPN information through the update messages to a remote peer. The peer uses its import targets to match the received export targets. If a match is found, the peer accepts the L2VPN information.
If you repeat this command, all the configured route targets take effect.
Examples
# Configure import route targets as 10:1 100:1 1000:1 and export route targets as 20:1 200:1 2000:1 for auto-discovery VSI aaa.
<Sysname> system-view
[Sysname] vsi aaa
[Sysname-vsi-aaa] auto-discovery bgp
[Sysname-vsi-aaa-auto] vpn-target 10:1 100:1 1000:1 import-extcommunity
[Sysname-vsi-aaa-auto] vpn-target 20:1 200:1 2000:1 export-extcommunity
vsi
Use vsi to create a VSI and enter its view, or enter the view of an existing VSI.
Use undo vsi to delete a VSI.
Syntax
vsi vsi-name
undo vsi vsi-name
Default
No VSIs exist.
Views
System view
Predefined user roles
network-admin
Parameters
vsi-name: Specifies a name for the VSI, a case-sensitive string of 1 to 31 characters.
Usage guidelines
You can create multiple PWs for a VSI manually, or by using LDP or BGP.
Examples
# Create a VSI named vpls1 and enter VSI view.
<Sysname> system-view
[Sysname] vsi vpls1
[Sysname-vsi-vpls1]
Related commands
display l2vpn vsi
xconnect vsi
Use xconnect vsi to bind an Ethernet service instance to a VSI.
Use undo xconnect vsi to restore the default.
Syntax
xconnect vsi vsi-name [ access-mode { ethernet | vlan } ]
undo xconnect vsi
Default
An Ethernet service instance is not bound to any VSI.
Views
Ethernet service instance view
Predefined user roles
network-admin
Parameters
vsi-name: Specifies the name of a VSI, a case-sensitive string of 1 to 31 characters.
access-mode: Specifies the AC access mode. This keyword is configurable only in Ethernet service instance view, and the default access mode is VLAN. When the AC is a Layer 3 interface or Layer 3 subinterface, this keyword is not configurable.
ethernet: Specifies the access mode as Ethernet.
vlan: Specifies the access mode as VLAN.
Usage guidelines
After you bind an Ethernet service instance to a VSI, packets matching the service instance are forwarded according to the MAC address table of the VSI.
The Ethernet service instance specified in this command must have a packet match criterion configured by the encapsulation command.
The AC access mode determines how the PE considers the VLAN tag in Ethernet frames received from the AC and how the PE forwards Ethernet frames to the AC.
· VLAN access mode—Ethernet frames received from the AC must carry a VLAN tag in the Ethernet header. The PE considers the VLAN tag as a P-tag assigned by the service provider. Ethernet frames sent to the AC must also carry the P-tag.
· Ethernet access mode—If Ethernet frames from the AC have a VLAN tag in the header, the PE considers it as a U-tag and ignores it. Ethernet frames sent to the AC do not carry the P-tag.
Examples
# Configure Ethernet service instance 200 on GigabitEthernet 1/0/1 to match packets with outer VLAN tag 200, and bind the Ethernet service instance to VSI vpn1.
<Sysname> system-view
[Sysname] vsi vpn1 hub-spoke
[Sysname-vsi-vpn1] quit
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] service-instance 200
[Sysname-GigabitEthernet1/0/1-srv200] encapsulation s-vid 200
[Sysname-GigabitEthernet1/0/1-srv200] xconnect vsi vpn1
Related commands
display l2vpn interface
display l2vpn service-instance
encapsulation
vsi