-
Cisco IOS XR MPLS Command Reference, Release 3.7
-
Preface
-
MPLS Label Distribution Protocol Commands on Cisco IOS XR Software
-
MPLS Forwarding Commands on Cisco IOS XR Software
-
MPLS Traffic Engineering Commands on Cisco IOS XR Software
-
RSVP Infrastructure Commands on Cisco IOS XR Software
-
MPLS Optical User Network Interface Commands on Cisco IOS XR Software
-
MPLS OAM Commands on Cisco IOS XR Software
-
Virtual Private Network Commands on Cisco IOS XR Software
-
Virtual Private LAN Services Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
Virtual Private LAN Services Commands on Cisco IOS XR Software
clear l2vpn bridge-domain (VPLS)
show l2vpn bridge-domain (VPLS)
show l2vpn forwarding bridge-domain (VPLS)
show l2vpn forwarding bridge-domain mac-address (VPLS)
Virtual Private LAN Services Commands on Cisco IOS XR Software
This chapter describes the commands used to configure, monitor, and troubleshoot Virtual Private LAN Services (VPLS).
For detailed information about MPLS concepts, configuration tasks, and examples, refer to the Cisco IOS XR MPLS Configuration Guide.
action (VPLS)
To configure the bridge behavior when the number of learned MAC addresses exceed the MAC limit configured, use the action command in l2vpn bridge group bridge domain MAC limit configuration mode. To disable this feature, use the no form of this command.
action {flood | no-flood | shutdown}
no action {flood | no-flood | shutdown}
Syntax Description
Defaults
No action is taken when the MAC address limit is reached.
Command Modes
l2vpn bridge group bridge domain MAC limit configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the action command to specify the type of action to be taken when the action is violated.
The configured action has no impact if the MAC limit has not been reached.
Task ID
Examples
The following example shows how to configure the bridge bar to flood all unknown unicast packets when more than 10 MACs are learned on the bridge:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# macRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac)# limitRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac-limit)# action floodRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac-limit)# maximum 10Related Commands
aging (VPLS)
To enter the MAC aging configuration submode to set the aging parameters such as time and type, use the aging command in l2vpn bridge group bridge domain configuration mode. To return to the default value for all parameters that are attached to this configuration submode, use the no form of this command.
aging
no aging
Syntax Description
This command has no arguments or keywords.
Defaults
No defaults are attached to this parameter since it is used as a configuration submode. See the defaults that are assigned to the time (VPLS) and the type (VPLS) parameters.
Command Modes
l2vpn bridge group bridge domain configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the aging command to enter l2vpn bridge group bridge domain MAC aging configuration mode.
Task ID
Examples
The following example shows how to enter MAC aging configuration submode and to set the MAC aging time to 120 seconds:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# macRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac)# agingRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac-aging)# time 120Related Commands
bridge-domain (VPLS)
To establish a bridge domain and to enter l2vpn bridge group bridge domain configuration mode, use the bridge-domain command in l2vpn bridge group configuration mode. To return to a single bridge domain, use the no form of this command.
bridge-domain bridge-domain name
no bridge-domain bridge-domain name
Syntax Description
Defaults
The default value is a single bridge domain.
Command Modes
l2vpn bridge group configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the bridge-domain command to enter l2vpn bridge group bridge domain configuration mode.
Task ID
Examples
The following example shows how to configure a bridge domain:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)#Related Commands
Creates a bridge group so that it can contain bridge domains and then assigns network interfaces to the bridge domain.
Enters L2VPN configuration mode.
bridge group (VPLS)
To create a bridge group so that it can contain bridge domains and then to assign network interfaces to the bridge domain, use the bridge group command in l2vpn configuration mode. To remove all the bridge domains that are created under this bridge group and to remove all network interfaces that are assigned under this bridge group, use the no form of this command.
bridge group bridge group name
no bridge-group bridge group name
Syntax Description
bridge group name
Number of the bridge group to which the interface belongs. The range is from 1 to 255.
Defaults
No bridge group is created.
Command Modes
l2vpn configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the bridge group command to enter l2vpn bridge group configuration mode.
Task ID
Examples
The following example shows that bridge group 1 is assigned:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)#Related Commands
Establishes a bridge domain and enters l2vpn bridge group bridge domain configuration mode.
Enters L2VPN configuration mode.
clear l2vpn bridge-domain (VPLS)
To clear the MAC addresses and to restart the bridge domains on the router, use the clear l2vpn bridge-domain command in EXEC mode.
clear l2vpn bridge-domain {all | bd-name name | group group}
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
This is the method that allows a bridge to forward again after it was put in Shutdown state as a result of exceeding the configured MAC limit.
Task ID
Examples
The following example shows how to clear all the MAC addresses and to restart all the bridge domains on the router:
RP/0/0/CPU0:router# clear l2vpn bridge-domain allRelated Commands
Displays information for the bridge ports such as attachment circuits and pseudowires for the specific bridge domains.
flooding disable (VPLS)
To configure flooding for traffic at the bridge domain level or at the bridge port level, use the flooding disable command in l2vpn bridge group bridge domain configuration mode. To return the bridge to normal flooding behavior when all unknown unicast packets, all broadcast packets, and all multicast packets are flooded over all other bridge domain network interfaces, use the no form of this command.
flooding disable
no flooding disable
Syntax Description
This command has no arguments or keywords.
Defaults
The default behavior is that packets are flooded when their destination MAC address is not found.
Command Modes
l2vpn bridge group bridge domain configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the flooding disable command to override the parent bridge configuration.
By default, bridge ports inherit the flooding behavior of the bridge domain.
When flooding is disabled, all unknown unicast packets, all broadcast packets, and all multicast packets are discarded.
Task ID
Examples
The following example shows how to disable flooding on the bridge domain called bar:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# flooding disableRelated Commands
interface (VPLS)
To add an interface to a bridge domain that allows packets to be forwarded and received from other interfaces that are part of the same bridge domain, use the interface command in l2vpn bridge group bridge domain configuration mode. To remove an interface from a bridge domain, use the no form of this command.
interface interface name
no interfaceinterface name
Syntax Description
interface name
Configures the name of the interface or attachment circuit in rack/slot/instance/port format.
Defaults
No default behavior or values
Command Modes
l2vpn bridge group bridge domain configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the interface command to enter l2vpn bridge group bridge domain attachment circuit configuration mode. In addition, the interface command enters the interface configuration submode to configure parameters specific to the interface.
By default, an interface is not part of a bridge.
Task ID
Examples
The following example shows how to configure the bundle Ethernet interface as an attachment circuit:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# interface bundle-ether 5RP/0/0/CPU0:router(config-l2vpn-bg-bd-ac)#Related Commands
learning disable (VPLS)
To override the MAC learning configuration of a parent bridge or to set the MAC learning configuration of a bridge, use the learning disable command in l2vpn bridge group bridge domain MAC configuration mode. To disable this feature, use the no form of this command.
learning disable
no learning disable
Syntax Description
This command has no arguments or keywords.
Defaults
By default, learning is enabled on all bridge domains and all interfaces on that bridge inherits this behavior.
Command Modes
l2vpn bridge group bridge domain MAC configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
When set, the learning disable command stops all MAC learning either on the specified interface or the bridge domain.
Task ID
Examples
In the following example, MAC learning is disabled on all ports in the bridge domain called bar, which is applied to all interfaces in the bridge unless the interface has its own MAC learning enable command.
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# macRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac)# learning disableRelated Commands
limit (VPLS)
To set the MAC address limit for action, maximum, and notification and to enter l2vpn bridge group bridge domain MAC limit configuration mode, use the limit command in l2vpn bridge group bridge domain MAC configuration mode. To remove all limits that were previously configured under the MAC configuration submodes, use the no form of this command.
limit
no limit
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
l2vpn bridge group bridge domain MAC configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the limit command to enter l2vpn bridge group bridge domain MAC limit configuration mode. The limit command specifies that one syslog message is sent or a corresponding trap is generated with the MAC limit when the action is violated.
Task ID
Examples
The following example shows how the MAC limit for the bridge bar is set to 100 with an action of shutdown. After the configuration, the bridge allows only up to 100 MAC addresses to be learned until the bridge stops all forwarding. When this happens, a syslog message and an SNMP trap are created.
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# macRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac)# limitRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac-limit)# maximum 100RP/0/0/CPU0:router(config-l2vpn-bg-bd-mac-limit)# action shutdownRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac-limit)# notification bothRelated Commands
mac (VPLS)
To enter l2vpn bridge group bridge domain MAC configuration mode, use the mac command in l2vpn bridge group bridge domain configuration mode. To disable all configurations added under the MAC configuration submodes, use the no form of this command.
mac
no mac
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
l2vpn bridge group bridge domain configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the mac command to enter l2vpn bridge group bridge domain MAC configuration mode.
Task ID
Examples
The following example shows how to enter l2vpn bridge group bridge domain MAC configuration mode:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# macRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac)#Related Commands
maximum (VPLS)
To configure the specified action when the number of MAC addresses learned on a bridge is reached, use the maximum command in l2vpn bridge group bridge domain MAC limit configuration mode. To disable this feature, use the no form of this command.
maximum {value}
no maximum {value}
Syntax Description
Defaults
The default maximum value is 4000.
Command Modes
l2vpn bridge group bridge domain MAC limit configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The action can either be flood, no flood, or shutdown. Depending on the configuration, a SYSDB, an SNMP trap notification, or both are issued.
Task ID
Examples
The following example shows when the number of MAC address learned on the bridge exceeds 5000 and the bridge stops learning but continues flooding:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# macRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac)# limitRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac-limit)# maximum 5000RP/0/0/CPU0:router(config-l2vpn-bg-bd-mac-limit)# action no-floodRelated Commands
mpls static label (VPLS)
To configure the MPLS static labels and the static labels for the access pseudowire configuration, use the mpls static label command in l2vpn bridge group bridge domain VFI pseudowire configuration mode. To assign the dynamic MPLS labels to either the virtual forwarding interface (VFI) pseudowire or the access pseudowire, use the no form of this command.
mpls static label {local value} {remote value}
no mpls static label {local value} {remote value}
Syntax Description
local value
Configures the local pseudowire label. The range is from 16 to 15999.
remote value
Configures the remote pseudowire label. The range is from 16 to 15999.
Defaults
By default, the router attempts to assign dynamic labels to the pseudowire.
Command Modes
l2vpn bridge group bridge domain VFI pseudowire configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Ensure that both ends of the pseudowire have matching static labels.
Task ID
Examples
The following example shows how to configure the VFI pseudowire 10.1.1.2 with pseudowire ID of 1000 to use MPLS label 800 and remote MPLS label 500:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# vfi modelRP/0/0/CPU0:router(config-l2vpn-bg-bd-vfi)# neighbor 10.1.1.2 pw-id 1000RP/0/0/CPU0:router(config-l2vpn-bg-bd-vfi-pw)# mpls static label local 800 remote 500Related Commands
mtu (VPLS)
To adjust the maximum packet size or maximum transmission unit (MTU) size for the bridge domain, use the mtu command in l2vpn bridge group bridge domain configuration mode. To disable this feature, use the no form of this command.
mtu bytes
no mtu
Syntax Description
Defaults
The default MTU value is 1500.
Command Modes
l2vpn bridge group bridge domain configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Each interface has a default maximum packet size or MTU size. This number generally defaults to the largest size possible for that interface type. On serial interfaces, the MTU size varies, but cannot be set smaller than 64 bytes.
The MTU for the bridge domain includes only the payload of the packet. For example, a configured bridge MTU of 1500 allows tagged packets of 1518 bytes (6 bytes DA, 6 bytes SA, 2 bytes ethertype, or 4 bytes qtag).
Task ID
Examples
The following example specifies an MTU of 1000 bytes:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# mtu 1000Related Commands
neighbor (VPLS)
To add an access pseudowire port to a bridge domain or a pseudowire to a bridge virtual forwarding interface (VFI), use the neighbor command in the appropriate l2vpn bridge group bridge domain configuration submode. To remove the pseudowire either from the bridge or from the VFI, use the no form of this command.
neighbor {A.B.C.D} {pw-id value}
no neighbor {A.B.C.D} {pw-id value}
Syntax Description
A.B.C.D
IP address of the cross-connect peer.
pw-id value
Configures the pseudowire ID and ID value. Range is 1 to 4294967295.
Defaults
No default behavior or values
Command Modes
l2vpn bridge group bridge domain configuration
l2vpn bridge group bridge domain VFI configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the neighbor command to enter l2vpn bridge group bridge domain VFI pseudowire configuration mode. Alternatively, use the neighbor command to enter l2vpn bridge group bridge domain access pseudowire configuration mode.
Task ID
Examples
The following example shows how to configure an access pseudowire directly under a bridge domain in l2vpn bridge group bridge domain configuration mode:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# neighbor 10.1.1.2 pw-id 1000RP/0/0/CPU0:router(config-l2vpn-bg-bd-pw)#The following example shows how to configure the parameters for any pseudowire in l2vpn bridge group bridge domain VFI configuration mode:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# vfi v1RP/0/0/CPU0:router(config-l2vpn-bg-bd-vfi)# neighbor 10.1.1.2 pw-id 1000RP/0/0/CPU0:router(config-l2vpn-bg-bd-vfi-pw)#Related Commands
notification (VPLS)
To specify the type of notification that is sent when the number of learned MAC addresses exceeds the configured limit, use the notification command in l2vpn bridge group bridge domain MAC limit configuration mode. To use the notification as only a syslog entry, use the no form of this command.
notification {both | none | trap}
no notification {both | none | trap}
Syntax Description
both
Sends syslog and trap notifications when the action is violated.
none
Specifies no notification.
trap
Sends trap notifications when the action is violated.
Defaults
By default, only a syslog message is sent when the number of learned MAC addresses exceeds the maximum configured.
Command Modes
l2vpn bridge group bridge domain MAC limit configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
A syslog message and an SNMP is generated. Alternatively, an SNMP is generated. Finally, no notification is generated.
Task ID
Examples
The following example shows how both a syslog message and an SNMP trap are generated with the bridge bar and learns more MAC addresses than the configured limit:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# bridge group 1RP/0/0/CPU0:router(config-l2vpn-bg)# bridge-domain barRP/0/0/CPU0:router(config-l2vpn-bg-bd)# macRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac)# limitRP/0/0/CPU0:router(config-l2vpn-bg-bd-mac-limit)# notification bothRelated Commands