Cisco MPR-151 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

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

MPLS Forwarding Commands on Cisco IOS XR Software

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

Task ID Operations

mpls-te, mpls-ldp, mpls-static read, write, read, write, read, write

Examples The following example shows sample output before and after clearing all counters:

RP/0/RP0/CPU0:router# show mpls forwarding

MPR-152

Local Outgoing Prefix Outgoing Next Hop Bytes T Label Label or ID Interface Switched O

----- -------- ------------- ---------- ------------ --------- 18 Exp-Null-v4 33.33.33.33/32 PO0/2/0/0 10.1.2.3 1572

RP/0/RP0/CPU0:router# clear mpls forwarding counters RP/0/RP0/CPU0:router# show mpls forwarding

Local Outgoing Prefix Outgoing Next Hop Bytes T Label Label or ID Interface Switched O

----- -------- ------------- ---------- ------------ --------- 18 Exp-Null-v4 33.33.33.33/32 PO0/2/0/0 10.1.2.3 0

Cisco IOS XR Multiprotocol Label Switching Command Reference

MPLS Forwarding Commands on Cisco IOS XR Software

Related Commands Command Description

show mpls forwarding Displays the contents of MPLS forwarding table.

clear mpls forwarding counters

Cisco IOS XR Multiprotocol Label Switching Command Reference

MPR-153

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

MPLS Forwarding Commands on Cisco IOS XR Software

Syntax Description

Defaults Enabled

Command Modes Global 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

disable Stops the propagation of IP TTL to and from the MPLS header.

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.

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 The following example shows how to disable IP TTL propagation:

Cisco IOS XR Multiprotocol Label Switching Command Reference

MPR-154

Task ID Operations

mpls-te, mpls-ldp read, write, read, write

RP/0/RP0/CPU0:router(config)# mpls ip-ttl-propagate disable

MPLS Forwarding Commands on Cisco IOS XR Software

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

mpls label range

Syntax Description

Defaults table-id: 0

Command Modes Global configuration

Command History

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.

minimum: 16

maximum: 1048575

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 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.

MPR-156

Cisco IOS XR Multiprotocol Label Switching Command Reference

MPLS Forwarding Commands on Cisco IOS XR Software

show mpls forwarding

To display the contents of the MPLS Label Forwarding Information Base (LFIB), use the show mpls forwarding command in EXEC mode.

[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

show mpls forwarding

Command Modes EXEC

MPLS Forwarding Commands on Cisco IOS XR Software

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

Task ID Operations

mpls-te or mpls-ldp or mpls-static read, read, read

Examples The following is sample output from the show mpls forwarding command:

RP/0/RP0/CPU0:router# show mpls forwarding

Local Outgoing Prefix Outgoing Next Hop Bytes T Label Label or ID Interface Switched O

------ ----------- ------------------ --------- --------------- ------------ 22 Pop Label 10.1.2.0/24 PO0/1/0/0 10.1.1.2 0 23 Pop Label 10.1.3.0/24 PO0/1/0/0 10.1.1.2 0 24 Pop Label 22.22.22.22/32 PO0/1/0/0 10.1.1.2 0 25 Unlabeled 33.33.33.33/32 tt13 point2point 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 142.50.36.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)

<======================================**

MPR-158

Cisco IOS XR Multiprotocol Label Switching Command Reference

+ 18 hidden pages