Cisco Systems MPR-151 Welder User Manual

MPLS Forwarding Commands on Cisco IOS XR
Software
This chapter describes the commands that you will use to configure and use Multiprotocol Label
Switching (MPLS) forwarding.
For detailed information about MPLS concepts, configuration tasks, and examples, refer to the
Cisco IOS XR Multiprotocol Label Switching Configuration Guide.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-151
MPLS Forwarding Commands on Cisco IOS XR Software
clear mpls forwarding counters
clear mpls forwarding counters
To clear (set to zero) the MPLS forwarding counters, use the clear mpls forwarding counters command
in EXEC mode.
clear mpls forwarding counters
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
Modification
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
No modification.
Release 3.3.0
No modification.
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 clear mpls forwarding counters command to set all MPLS forwarding counters to zero so that
you can easily see future changes.
Task ID
Examples
Task ID
Operations
mpls-te, mpls-ldp, mpls-static
read, write, read, write, read, write
The following example shows sample output before and after clearing all counters:
RP/0/RP0/CPU0:router# show mpls forwarding
Local Outgoing
Prefix
Outgoing
Next Hop
Label Label
or ID
Interface
----- -------- ------------- ---------- ------------ --------- 18
Exp-Null-v4 33.33.33.33/32
PO0/2/0/0
10.1.2.3
Bytes
Switched
T
O
1572
RP/0/RP0/CPU0:router# clear mpls forwarding counters
RP/0/RP0/CPU0:router# show mpls forwarding
Local Outgoing
Prefix
Outgoing
Next Hop
Label Label
or ID
Interface
----- -------- ------------- ---------- ------------ --------- 18
Exp-Null-v4 33.33.33.33/32
PO0/2/0/0
10.1.2.3
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-152
Bytes
Switched
0
T
O
MPLS Forwarding Commands on Cisco IOS XR Software
clear mpls forwarding counters
Related Commands
Command
Description
show mpls forwarding Displays the contents of MPLS forwarding table.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-153
MPLS Forwarding Commands on Cisco IOS XR Software
mpls ip-ttl-propagate
mpls ip-ttl-propagate
To configure the behavior controlling the propagation of the IP Time-To-Live (TTL) field to and from
the MPLS header, use the mpls ip-ttl-propagate command in global configuration mode. To return to
the default behavior, use the no form of this command.
mpls ip-ttl-propagate disable
no mpls ip-ttl-propagate
Syntax Description
disable
Defaults
Enabled
Command Modes
Global configuration
Command History
Release
Usage Guidelines
Stops the propagation of IP TTL to and from the MPLS header.
Modification
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0
No modification.
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.
By default, the IP TTL is propagated to the MPLS header when IP packets enter the MPLS domain.
Within the MPLS domain, the MPLS TTL is decremented at each MPLS hop. When an MPLS
encapsulated IP packet exits the MPLS domain, the MPLS TTL is propagated to the IP header. When
propagation is disabled, the MPLS TTL is set to 255 during the label imposition phase and the IP TTL
is not altered.
Task ID
Examples
Task ID
Operations
mpls-te, mpls-ldp
read, write, read, write
The following example shows how to disable IP TTL propagation:
RP/0/RP0/CPU0:router(config)# mpls ip-ttl-propagate disable
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-154
MPLS Forwarding Commands on Cisco IOS XR Software
mpls label range
mpls label range
To configure the range of local labels available for use on packet interfaces, use the mpls label range
command in global configuration mode. To return to the default behavior, use the no form of this
command.
mpls label range [table table-id] minimum maximum
no mpls label range [table table-id] minimum maximum
Syntax Description
Defaults
table table-id
(Optional) Identifies a specific label table; the global label table has table-id = 0. If
no table is specified, the global table is assumed. Currently, you can specify table 0
only.
minimum
Smallest allowed label in the label space. Default is 16.
maximum
Largest allowed label in the label space. Default is 1048575.
table-id: 0
minimum: 16
maximum: 1048575
Command Modes
Global configuration
Command History
Release
Usage Guidelines
Modification
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0
No modification.
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 label range defined by the mpls label range command is used by all MPLS applications that allocate
local labels (for dynamic label switching Label Distribution Protocol [LDP], MPLS traffic engineering,
and so on).
Labels 0 through 15 are reserved by the Internet Engineering Task Force (IETF) (see
draft-ietf-mpls-label-encaps-07.txt for details) and cannot be included in the range using the mpls label
range command.
Task ID
Task ID
Operations
mpls-te, mpls-ldp
read, write, read, write
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-155
MPLS Forwarding Commands on Cisco IOS XR Software
mpls label range
Examples
The following example shows how to configure the size of the local label space using a minimum of 200
and a maximum of 120000. The new range takes effect immediately. Labels outside the current range and
which are allocated by MPLS applications remain in circulation until released.
RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# mpls label range 200 120000
Related Commands
Command
Description
show mpls label range
Displays the range of the MPLS local label space.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-156
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls forwarding
show mpls forwarding
To display the contents of the MPLS Label Forwarding Information Base (LFIB), use the show mpls
forwarding command in EXEC mode.
show mpls forwarding [debug | detail | interface type instance | labels value | location | prefix
[network/mask | length] | private | summary | tunnels]
Syntax Description
debug
(Optional) Displays the failure reason if “?” is displayed in the “Byte
Switched” field of output. The typical reasons for failure to obtain statistics
include Communication Error b/w global and per-node forwarding process,
No such entry in per-node forwarding, and H/W stats error.
detail
(Optional) Displays information in long form (includes length of
encapsulation, length of Media Access Control [MAC] string, maximum
transmission unit [MTU], Packet switched, and label stack).
interface
(Optional) Displays information for the specified interface.
type
Interface type. For more information, use the question mark (?) online help
function.
instance
Either a physical interface instance or a virtual interface instance as follows:
•
Physical interface instance. Naming notation is rack/slot/module/port
and a slash between values is required as part of the notation.
– rack: Chassis number of the rack.
– slot: Physical slot number of the modular services card or line card.
– module: Module number. A physical layer interface module
(PLIM) is always 0.
– port: Physical port number of the interface.
Note
•
In references to a Management Ethernet interface located on a route
processor card, the physical slot number is alphanumeric (RP0 or
RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.
Virtual interface instance. Number range varies depending on interface
type.
For more information about the syntax for the router, use the question mark
(?) online help function.
labels value
(Optional) Entries with a local labels range.
location node-id
(Optional) Displays hardware resource counters on the designated node.
The node-id argument is entered in the rack/slot/module notation.
prefix network/mask |
length
(Optional) Destination address and mask/prefix length.
Note
The forward slash (/) between network and mask is required.
private
(Optional) Displays private information.
summary
(Optional) Displays summarized information.
tunnels [tunnel-id]
(Optional) Displays entries either for a specified label switch path (LSP)
tunnel or all LSP tunnel entries.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-157
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls forwarding
Command Modes
EXEC
Command History
Release
Modification
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0
No modification.
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 optional keywords and arguments described allow specification of a subset of the entire MPLS
forwarding table.
Task ID
Examples
Task ID
Operations
mpls-te or mpls-ldp or mpls-static
read, read, read
The following is sample output from the show mpls forwarding command:
RP/0/RP0/CPU0:router# show mpls forwarding
Local
Label
-----22
23
24
25
Outgoing
Prefix
Label
or ID
----------- -----------------Pop Label
10.1.2.0/24
Pop Label
10.1.3.0/24
Pop Label
22.22.22.22/32
Unlabeled 33.33.33.33/32
Outgoing Next Hop
Interface
--------- --------------PO0/1/0/0 10.1.1.2
PO0/1/0/0 10.1.1.2
PO0/1/0/0 10.1.1.2
tt13 point2point
Bytes
T
Switched
O
------------ 0
0
0
0
The following is sample output from the show mpls forwarding command using the detail keyword:
RP/0/RP0/CPU0:router# show mpls forwarding detail
Local Outgoing
Prefix
Outgoing
Next Hop
Bytes
T
Label Label
or ID
Interface
Switched
O
------ ----------- ----------------- ------------ --------------- ----------- 26
Pop Label
100.10.20.2/32
PO0/4/0/4
142.50.32.2
0
MAC/Encaps: 4/8, MTU: 4470
Label Stack (Top -> Bottom): { Imp-Null }
Packets Switched: 0
Installed: Jul 22 10:41:13.521 (3d23h ago)
<======================================**
Owner: LDP
<====================================================================**
Pop Label
100.10.20.2/32
PO0/4/0/5
MAC/Encaps: 4/8, MTU: 4470
Label Stack (Top -> Bottom): { Imp-Null }
Packets Switched: 0
Installed: Jul 22 10:41:13.521 (3d23h ago)
<======================================**
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-158
142.50.36.2
0
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls forwarding
Owner: LDP
<====================================================================**
The following is sample output from the show mpls forwarding command using the location keyword
and a specific node ID:
RP/0/RP0/CPU0:router# show mpls forwarding location 0/1/CPU0
Local
Label
-----22
23
24
25
Outgoing
Outgoing
Next Hop
Bytes
Label
Interface
Switched
----------- ------------ --------------- -----------Pop Label
PO0/1/0/0
10.1.1.2
0
Pop Label
PO0/1/0/0
10.1.1.2
0
Pop Label
PO0/1/0/0
10.1.1.2
0
Unlabeled tt13
point2point
0
The following is sample output from the show mpls forwarding command using the tunnels keyword:
RP/0/RP0/CPU0:router# show mpls forwarding tunnels
Tunnel
Name
-------tt13
Outgoing
Label
----------18
Outgoing
Next Hop
Interface
------------ --------------PO0/1/0/0
10.1.1.2
Bytes
Switched
-----------13200
The following is sample output from the show mpls forwarding command using the summary
keyword:
RP/0/RP0/CPU0:router# show mpls forwarding summary
Forwarding entries:
Label switching: 4
IPv4 label imposition: 4
MPLS TE tunnel head: 1
MPLS TE fast-reroute: 0
Forwarding updates:
42 updates, 28 messages
Labels in use:
Reserved: 4
Lowest: 22
Highest: 25
Table 37 describes the significant fields shown in the display.
Table 37
show mpls forwarding Field Descriptions
Field
Description
Local Label
Label assigned by this router.
Outgoing Label
Label assigned by the next hop or downstream peer. Some of the entries that
display in this column are:
•
Unlabeled —No label for the destination from the next hop, or label
switching is not enabled on the outgoing interface.
•
Pop Label — Next hop advertised an implicit-null label for the
destination.
Prefix or Tunnel ID
Address or tunnel to which packets with this label are going.
Outgoing interface
Interface through which packets with this label are sent.
Next Hop
IP address of neighbor that assigned the outgoing label.
Bytes Switched
Number of bytes switched with this incoming label.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-159
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls forwarding
Table 37
show mpls forwarding Field Descriptions (continued)
Field
Description
TO
Timeout: Indicates by an “*” if entry is being timed out in forwarding.
Mac/Encaps
Length in bytes of Layer 2 header, and length in bytes of packet
encapsulation, including Layer 2 header and label header.
MTU
Maximum transmission unit (MTU) of labeled packet.
Label Stack
All the outgoing labels on the forwarded packet.
Packets Switched
Number of packets switched with this incoming label.
Label switching
Number of Label switching (LFIB) forwarding entries.
IPv4 label imposition
Number of IPv4 label imposition forwarding entries (installed at ingress
LSR).
MPLS TE tunnel head
Number of forwarding entries (installed at ingress LSR) on MPLS TE
tunnel head.
MPLS TE fast-reroute
Number of forwarding entries (installed at PLR) for MPLS
traffic-engineering (TE) fast reroute.
Forwarding updates
Number of forwarding updates sent from LSD (RP/DRP) to LFIB/MPLS
(RP/DRP/LC) using BCDL mechanism, indicating the total number of
updates and total number of BCDL messages.
Labels in use
Local labels in use (installed in LFIB). These usually indicate the lowest
and highest label in use (allocated by applications). Furthermore, some
reserved labels (range: 0-15), such as explicit-nullv4, explicit-nullv6, are
installed in the forwarding plane.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-160
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls interfaces
show mpls interfaces
To display information about one or more interfaces that have been configured for MPLS, use the show
mpls interfaces command in EXEC mode.
show mpls interfaces [type instance] [location node-id] | [detail]
Syntax Description
type
Interface type. For more information, use the question mark (?) online help
function.
instance
Either a physical interface instance or a virtual interface instance as follows:
•
Physical interface instance. Naming notation is rack/slot/module/port
and a slash between values is required as part of the notation.
– rack: Chassis number of the rack.
– slot: Physical slot number of the modular services card or line card.
– module: Module number. A physical layer interface module
(PLIM) is always 0.
– port: Physical port number of the interface.
Note
•
In references to a Management Ethernet interface located on a route
processor card, the physical slot number is alphanumeric (RP0 or
RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.
Virtual interface instance. Number range varies depending on interface
type.
For more information about the syntax for the router, use the question mark
(?) online help function.
location node-id
(Optional) Displays hardware resource counters on the designated node.
The node-id argument is entered in the rack/slot/module notation
detail
(Optional) Displays detailed information for the designated node. The
node-id argument is entered in the rack/slot/module notation.
Command Modes
EXEC
Command History
Release
Modification
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0
No modification.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-161
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls interfaces
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 command displays MPLS information about a specific interface or about all interfaces where MPLS
is configured.
Task ID
Examples
Task ID
Operations
mpls-te or mpls-ldp or mpls-static
read, read, read
The following is sample output from the show mpls interfaces command:
RP/0/RP0/CPU0:router# show mpls interfaces
Interface
-------------------------POS0/4/0/0
POS0/4/0/1
POS0/4/0/2
LDP
-------Yes
Yes
Yes
Tunnel
-------Yes
Yes
Yes
Enabled
-------Yes
Yes
Yes
The following is sample output from the show mpls interfaces command using the detail keyword:
RP/0/RP0/CPU0:router# show mpls interfaces detail
Interface POS0/4/0/0:
LDP labelling
LSP labelling
MPLS enabled
MTU = 4474
Interface POS0/4/0/1:
LDP labelling
LSP labelling
MPLS enabled
MTU = 4474
Interface POS0/4/0/2:
LDP labelling
LSP labelling
MPLS enabled
MTU = 4474
enabled
enabled (TE-Control)
enabled
enabled (TE-Control)
enabled
enabled (TE-Control)
The following is sample output from the show mpls interfaces command using the location keyword:
RP/0/RP0/CPU0:router# show mpls interfaces location pos 0/4/0/0
Interface
LDP
Tunnel
-------------------------- -------- -------POS0/4/0/0
Yes
Yes
RP/0/0/CPU0:tops2-4#show mpls interfaces poS
Interface POS0/4/0/0:
LDP labelling enabled
LSP labelling enabled (TE-Control)
MPLS enabled
MTU = 4474
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-162
Enabled
-------Yes
0/4/0/0 detail
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls interfaces
Table 38 describes the significant fields shown in the display.
Table 38
show mpls interfaces Field Descriptions
Field
Description
LDP
Indicates state of LDP labelling.
Tunnel
Indicates state of LSP Tunnel labelling.
MTU
Maximum transmission unit (MTU) of labeled packet.
Caps
Capsulation switching chains installed on an interface.
M
MPLS switching capsulation/switching chains are installed on the interface and are
ready to switch MPLS traffic.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-163
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls label range
show mpls label range
To display the range of local labels available for use on packet interfaces, use the show mpls label range
command in EXEC mode.
show mpls label range
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
Modification
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Usage Guidelines
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0
No modification.
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.
You can use the show mpls label range command to configure a range for local labels that is different
from the default range.
Task ID
Examples
Task ID
Operations
mpls-te or mpls-ldp or mpls-static
read, read, read
The following is sample output from the show mpls label range command:
RP/0/RP0/CPU0:router# show mpls label range
Range for dynamic labels: Min/Max: 16/1048575
Table 39 describes the significant fields shown in the display.
Table 39
Related Commands
show mpls label range Field Descriptions
Field
Description
Range for dynamic labels
Minimum and maximum allowable range for local labels (which
differs from the default range).
Command
Description
mpls label range
Configures a range of values for use as local labels.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-164
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls label table
show mpls label table
To display the local labels contained in the MPLS label table, use the show mpls label table command
in EXEC mode.
show mpls label table table-index [application application | label label value | summary]
Syntax Description
table-index
The index of the label table to display. The global label table is 0.
Currently, you can specify table 0 only.
application application
(Optional) Displays all labels owned by the selected application.
Options are: bgp-ipv4, bgp-vpn-ipv4, internal, ldp, none, rsvp, static,
te-control, te-link, test, snmp.
label label value
Displays a selected label based on the label value. Range is 0-1048575.
summary
Displays a summary of local labels.
Command Modes
EXEC
Command History
Release
Modification
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0
No modification.
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.
Task ID
Task ID
Operations
mpls-te or mpls-ldp or mpls-static
read, read, read
Examples
The following is sample output from the show mpls label table command:
RP/0/RP0/CPU0:router# show mpls label table 0
Table
----0
0
0
0
0
Label
------0
1
2
3
16
Owner
---------LSD
LSD
LSD
LSD
TE-Link
State
-----InUse
InUse
InUse
InUse
InUse
Rewrite
------Yes
Yes
Yes
Yes
Yes
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-165
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls label table
Table 40 describes the significant fields shown in the display.
Table 40
show mpls label table Field Descriptions
Value
Description
Table
Table ID.
Label
Label index.
Owner
Application that allocated the label. All labels displaying “InUse” state have an
owner.
State
Rewrite
•
In Use—Label allocated and in use by an application.
•
Alloc—Label allocated but is not yet in use by an application.
•
Pend—Label was in use by an application that has terminated unexpectedly, and
the application has not reclaimed the label.
•
Pend-S—Label was in use by an application, but the MPLS Label Switching
Database (LSD) server has recently restarted and the application has not
reclaimed the label.
Number of initiated rewrites.
The following is sample output from the show mpls label table command using the application
keyword:
RP/0/RP0/CPU0:router# show mpls label table 0 application te-link
Table Label
Owner
State Rewrite
----- ------- ---------- ------ ------0
16
TE-Link
InUse Yes
Related Commands
Command
Description
show mpls forwarding
Displays entries in the MPLS forwarding table. Label switching entries
are indexed by their local label.
show mpls lsd applications
Displays MPLS applications that are registered with the MPLS LSD
server.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-166
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls lsd applications
show mpls lsd applications
To display the MPLS applications registered with the MPLS Label Switching Database (LSD) server,
use the show mpls lsd applications command in EXEC mode.
show mpls lsd applications
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
Modification
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Usage Guidelines
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0
No modification.
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.
MPLS applications include Traffic Engineering (TE) Control, TE Link Management, and Label
Distribution Protocol (LDP). The application must be registered with MPLS LSD for its features to
operate correctly. All applications are clients (see the show mpls lsd clients command), but not all
clients are applications.
Task ID
Examples
Task ID
Operations
mpls-te or mpls-ldp or mpls-static
read, read, read
The following is sample output from the show mpls lsd applications command:
RP/0/RP0/CPU0:router# show mpls lsd applications
Type
-----------LDP
TE-Control
TE-Link
State
-------Active
Active
Active
RecoveryTime
-----------300
100
600
Node
-----------0/0/CPU0
0/0/CPU0
0/0/CPU0
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-167
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls lsd applications
Table 41 describes the significant fields shown in the display.
Table 41
show mpls lsd applications Field Descriptions
Value
Description
Type
LSD application type.
State
•
Active—Application registered with MPLS LSD and is functioning correctly.
•
Recover—Application registered with MPLS LSD and is recovering after
recently restarting. In this state, the RecoveryTime value indicates how many
seconds are left before the application becomes active.
•
Zombie—Application not re-registered after an unexpected termination. In this
case, RecoveryTime indicates how many seconds are left before MPLS LSD gives
up on the application.
RecoveryTime Seconds remaining before MPLS LSD gives up or resumes the application.
Node
Related Commands
Node expressed in standard rack/slot/module notation.
Command
Description
show mpls lsd clients
Displays MPLS clients connected to the MPLS LSD server.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-168
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls lsd clients
show mpls lsd clients
To display the MPLS clients connected to the MPLS Label Switching Database (LSD) server, use the
show mpls lsd clients command in EXEC mode.
show mpls lsd clients
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
Modification
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Usage Guidelines
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0
No modification.
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.
MPLS clients include Traffic Engineering (TE) Control, TE Link Management, Label Distribution
Protocol (LDP), and Bulk Content Downloader (BCDL) Agent. Not all clients are applications (see the
show mpls lsd applications command), but all applications are clients.
Task ID
Examples
Task ID
Operations
mpls-te or mpls-ldp or mpls-static
read, read, read
The following is sample output from the show mpls lsd clients command:
RP/0/RP0/CPU0:router# show mpls lsd clients
Id
-0
1
2
3
Services
-------------------BA(p=none)
A(TE-Link)
A(LDP)
A(TE-Control)
Node
-----------0/0/CPU0
0/0/CPU0
0/0/CPU0
0/0/CPU0
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-169
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls lsd clients
Table 42 describes the significant fields shown in the display.
Table 42
Related Commands
show mpls lsd applications Field Descriptions
Value
Description
Id
Client identification number.
Services
A(xxx) means that this client is an application and xxx is the application name, BA(yyy)
means that this client is a BCDL Agent and yyy is expert data. Depending on system
conditions, there can be multiple BCDL Agent clients (this is normal).
Node
Node expressed in standard rack/slot/module notation.
Command
Description
show mpls lsd applications
Displays MPLS applications registered with the MPLS LSD server.
show mpls lsd clients
Displays MPLS clients connected to the MPLS LSD server.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-170
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls traffic-eng fast-reroute database
show mpls traffic-eng fast-reroute database
To display the contents of the fast reroute (FRR) database, use the show mpls traffic-eng fast-reroute
database command in EXEC mode.
show mpls traffic-eng fast-reroute database [ip-address | ip-address mask | afi-all [safi-all
{ip-address | ip-address mask}] | [unicast {ip-address | ip-adddress mask}] | backup-interface
[tunnel tunnel ID [summary] | unresolved] | interface interface [summary] | ipv4 [safi-all
{ip-address | ip-adddress mask}] | [unicast {ip-address | ip-adddress mask}] | labels number
[number [state [active | complete | partial | ready]] | [location node-id] | role [head
[summary] | midpoint [summary]] | state [active | complete | partial | ready]] | summary]
Syntax Description
ip-address
(Optional) IP address of the destination network.
ip-address mask
(Optional) Bit combination indicating the portion of the IP address that is
being used for the subnet address.
afi-all
(Optional) Returns data for all specified address family identifiers.
safi-all
(Optional) Returns data for all sub-address family identifiers
unicast
(Optional) Returns unicast data only.
backup-interface
(Optional) Displays entries with the specified backup interface.
tunnel tunnel-id
Tunnel and tunnel ID to which packets with this label are going. The
summary suboption is available.
unresolved
(Optional) Displays entries whose backup interface has not yet been fully
resolved.
interface
(Optional) Displays entries with this primary outgoing interface. The
summary suboption is available.
ipv4
(Optional) Displays IPv4 data only.
labels
(Optional) Displays database entries that possess in-labels assigned by this
router (local labels). Specify either a starting value or a range of values. The
state suboption is available.
location node-id
(Optional) Displays hardware resource counters on the designated node. The
node-id argument is entered in the rack/slot/module notation.
role
(Optional) Displays entries associated either with the tunnel head or tunnel
midpoint. The summary suboption is available.
state
(Optional) Filter the database according to the state of the entry:
active—FRR rewrite is in the forwarding active database (where it can be
placed onto appropriate incoming packets).
complete—FRR rewrite is assembled, ready or active.
partial—FRR rewrite is fully created; its backup routing information is still
incomplete.
ready—FRR rewrite was created but is not in the forwarding active state.
summary
Command Modes
(Optional) Displays summarized information about the FRR database.
EXEC
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-171
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls traffic-eng fast-reroute database
Command History
Release
Modification
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0
No modification.
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.
Task ID
Task ID
Operations
mpls-te
read
Examples
The following is sample output from the show mpls traffic-eng fast-reroute database command:
RP/0/RP0/CPU0:router# show mpls traffic-eng fast database
Tunnel head FRR information:
Tunnel
In-label Out intf/label
---------- -------- ---------------tt4000
Tun hd
PO0/3/0/0:34
tt4001
Tun hd
PO0/3/0/0:35
tt4002
Tun hd
PO0/3/0/0:36
FRR intf/label
---------------tt1000:34
tt1001:35
tt1001:36
Status
------Ready
Ready
Ready
Table 43 describes the significant fields shown in the display.
Table 43
show mpls traffic-eng fast-reroute database Field Descriptions
Field
Description
Tunnel
Short form of tunnel interface name.
In-label
Label advertised to other routers to signify a particular prefix. The value
“Tun hd” indicates that no label is advertised.
Out intf/label
Out interface—Short name of the physical interface through which traffic
goes to the protected link.
Out label:
•
At a tunnel head, this is the label that the tunnel destination device
advertises. The value “Unlabeled” indicates that no such label is
advertised.
•
At a tunnel midpoint, this is the label selected by the next hop device.
The value “Pop Label” indicates that the next hop is the final hop for the
tunnel.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-172
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls traffic-eng fast-reroute database
Table 43
show mpls traffic-eng fast-reroute database Field Descriptions
Field
Description
FRR intf/label
Fast reroute interface—Backup tunnel interface.
Fast reroute label:
Status
•
At a tunnel head, this is the label that the tunnel tail selected to indicate
the destination network. The value “Unlabeled” indicates that no label
is advertised.
•
At a tunnel midpoint, this has the same value as the Out label.
State of the rewrite: partial, ready, or active.
The following command displays filtering of the FRR database using the prefix argument:
RP/0/RP0/CPU0:router# show mpls traffic-eng fast-reroute database 175.10.200.253
Tunnel head FRR information:
Prefix
Tunnel
In-label Out intf/label
FRR intf/label
Status
------------------ ---------- -------- ---------------- ---------------- ------175.10.200.253/32 tu4000
Tun hd
PO0/3/0/0:34
tt1000:34
Ready
Note
The Prefix field indicates the IP address where packets with this label are headed.
The following command displays filtering of the FRR database using the backup-interface option:
RP/0/RP0/CPU0:router# show mpls traffic-eng fast database backup-interface tunnel-te 1000
Tunnel head FRR information:
Tunnel
In-label Out intf/label
FRR intf/label
Status
---------- -------- ---------------- ---------------- ------tu4000
Tun hd
PO0/3/0/0:34
tt1000:34
Ready
The following command displays the FRR database filtered by the primary outgoing interface:
RP/0/RP0/CPU0:router# show mpls traffic-eng fast-reroute database interface pos0/3/0/0
Tunnel head FRR information:
Tunnel
In-label Out intf/label
---------- -------- ---------------tt4000
Tun hd
PO0/3/0/0:34
tt4001
Tun hd
PO0/3/0/0:35
tt4002
Tun hd
PO0/3/0/0:36
FRR intf/label
---------------tt1000:34
tt1001:35
tt1001:36
Status
------Ready
Ready
Ready
The following command shows a summary of the FRR database with the role as head:
RP/0/RP0/CPU0:router# show mpls traffic-eng fast-reroute database role head summary
Status
---------Active
Ready
Partial
Other
Count
---------0
3
0
0
The following command shows the FRR database filtered according to the state of the entries (note that
FRR is triggered):
RP/0/RP0/CPU0:router# show mpls traffic-eng fast-reroute database state active
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-173
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls traffic-eng fast-reroute database
Tunnel head FRR information:
Tunnel
In-label Out intf/label
FRR intf/label
---------- -------- ---------------- ---------------tt4000
Tun hd
tt1000:34
tt4001
Tun hd
tt1001:35
tt4002
Tun hd
tt1001:36
Status
------Active
Active
Active
The following command shows the FRR database with protected midpoints:
RP/0/RP0/CPU0:router# show mpls traffic-eng fast-reroute database
LSP midpoint FRR information:
LSP identifier
----------------------------10.10.10.10 5000 [48]
10.10.10.10 8000 [105]
In-label
-------18
19
Out intf/label
---------------PO0/1/0/1:18
PO0/1/0/1:19
FRR intf/label
---------------tt2001:18
tt2000:19
Status
------Ready
Ready
The following command shows the FRR database filtered according to the inbound label (this output
applies only to LSP midpoint entries):
RP/0/RP0/CPU0:router# show mpls traffic-eng fast-reroute database labels 18 18
LSP midpoint FRR information:
LSP identifier
In-label Out intf/label
FRR intf/label
Status
----------------------------- -------- ---------------- ---------------- ------10.10.10.10 5000 [48]
18
PO0/1/0/1:18
tt2001:18
Ready
The following output shows summarized information for the FRR database with the role as midpoint:
RP/0/RP0/CPU0:router# show mpls traffic-eng fast-reroute database role midpoint summary
Status
------Active
Ready
Partial
Other
Related Commands
Count
----0
2
0
0
Command
Description
show mpls traffic-eng fast-reroute log
Displays the contents of the FRR event log.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-174
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls traffic-eng fast-reroute log
show mpls traffic-eng fast-reroute log
To display a history of Fast Reroute (FRR) events, use the show mpls traffic-eng fast-reroute log
command in EXEC mode.
show mpls traffic-eng fast-reroute log [interface type instance | node node-id]
Syntax Description
interface
(Optional) Displays all FRR events for the selected protected interface.
type
Interface type. For more information, use the question mark (?) online help
function.
instance
Either a physical interface instance or a virtual interface instance as follows:
•
Physical interface instance. Naming notation is rack/slot/module/port
and a slash between values is required as part of the notation.
– rack: Chassis number of the rack.
– slot: Physical slot number of the modular services card or line card.
– module: Module number. A physical layer interface module (PLIM)
is always 0.
– port: Physical port number of the interface.
Note
•
In references to a Management Ethernet interface located on a route
processor card, the physical slot number is alphanumeric (RP0 or
RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.
Virtual interface instance. Number range varies depending on interface
type.
For more information about the syntax for the router, use the question mark
(?) online help function.
node node-id
Displays all FRR events that occurred on the selected node.
Command Modes
EXEC
Command History
Release
Modification
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0
No modification.
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.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-175
MPLS Forwarding Commands on Cisco IOS XR Software
show mpls traffic-eng fast-reroute log
Task ID
Examples
Task ID
Operations
mpls-te
read
The following is sample output from the show mpls traffic-eng fast-reroute log command:
RP/0/RP0/CPU0:router# show mpls traffic-eng fast-reroute log
Node
-------0/0/CPU0
0/1/CPU0
0/2/CPU0
0/3/CPU0
Protected
Interface
--------PO0/1/0/1
PO0/1/0/1
PO0/1/0/1
PO0/1/0/1
LSPs
Rewrites When
----1
1
1
1
-------1
1
1
1
---------------------Feb 27 19:12:29.064000
Feb 27 19:12:29.060093
Feb 27 19:12:29.063814
Feb 27 19:12:29.062861
Switching Time
(usec)
-------------147
165
129
128
Table 44 describes the significant fields shown in the display.
Table 44
Related Commands
show mpls traffic-eng fast-reroute log Field Descriptions
Value
Description
Node
Node address.
Protected Interface
Type and interface-id that is being protected.
LSPs
Link-state packet (LSP) associated with each interface being protected.
Rewrites
Number of rewrites initiated on the LSP.
When
Date the interface was protected.
Switching Time
Time required to switch the protected interface in micro-seconds.
Command
Description
show mpls traffic-eng fast-reroute database
Displays the contents of the FRR database.
Cisco IOS XR Multiprotocol Label Switching Command Reference
MPR-176