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 Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

To use this command, you must
be in a user group associated with a task group that includes appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

Use the clear mpls forwarding counters command to set all MPLS forwarding counters to zero so that you can easily see the future changes.

Task ID

Task ID

Operations

mpls-te

read, write

mpls-ldp

read, write

mpls-static

read, write

Examples

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

Related Commands

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-propagatedisable
[ forwarded | local ]

nompls ip-ttl-propagate

Syntax Description

disable

Disables the propagation of IP TTL to and from the MPLS header for both forwarded and local packets.

forwarded

(Optional) Disables the propagation of IP TTL to and from the MPLS headed for only the forwarded packets. This prevents the traceroute command from displaying the MPLS-enabled nodes beyond the device under the configuration.

local

(Optional) Disables the propagation of IP TTL to the MPLS header for only locally generated packets. This prevents the traceroute command from displaying the MPLS-enabled nodes beyond the device under the configuration.

Command Default

Enabled

Command Modes

Global configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 3.9.0

Both forwarded and local keywords were added as optional.

Usage Guidelines

To use this command, you must
be in a user group associated with a task group that includes appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

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

Task ID

Operations

mpls-te

read, write

mpls-ldp

read, write

Examples

The following example shows how to disable IP TTL propagation:

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

The following example shows how to disable IP TTL propagation for forwarded MPLS packets:

The following example shows how to disable IP TTL propagation for locally generated MPLS packets:

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

mpls label range

To configure the dynamic 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 rangetabletable-idminimummaximum

nompls label rangetabletable-idminimummaximum

Syntax Description

table
table-id

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

maximum

Largest allowed label in the label space. Default is 1048575.

Command Default

table-id: 0

minimum: 16000

maximum: 1048575

Command Modes

Global configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

To use this command, you must
be in a user group associated with a task group that includes appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

After configuring the mpls label range command, restart the router for the configuration to take effect.

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 the draft-ietf-mpls-label-encaps-07.txt for details) and cannot be included in the range using the mpls label range command.

Labels 16 through 15999 are reserved for Layer 2 VPN static pseudowires. You should not configure Layer 2 VPN static pseudowires which fall within the dynamic range. If more Layer 2 VPN static pseudowires are required, restrict the dynamic label range using this configuration.

The default label limit is 273999 when ASR 9000 Ethernet Line Card and ASR 9000 Enhanced Ethernet Line Card are installed.

The maximum allowed label limit is 1000000 when ASR 9000 Enhanced Ethernet Line Card is used.

Note

Labels outside the current range and which are allocated by MPLS applications remain in circulation until released.

The maximum labels that are available are 144K.

You must understand the maximum labels that are supported for each platform versus the labels that are supported for the CLI.

Task ID

Task ID

Operations

mpls-te

read, write

mpls-ldp

read, write

Examples

The following example shows how to configure the size of the local label space using a minimum of 16200 and a maximum of 120000:

Command Modes

Command History

Usage Guidelines

The optional keywords and arguments described allow specification of a subset of the entire MPLS forwarding table.

Note

When the show mpls forwarding detail command is executed with the location keyword (for example, with the address, 0/1/cpu0), it displays the forwarding information available on this node. If this node hosts a displayed interface, then the FIB displays a configured MTU; otherwise, it displays the default value of 1500. This is because in Cisco IOS XR software, interface information is available only on nodes hosting the interface. Note that for bundle interfaces, the information is available in line cards with bundle-member links. If the location is not specified, the FIB displays the data from the node where the interface is created. For physical interfaces, this location keyword value would match the actual address; therefore, FIB displays correct information. It is different in the case of bundles--bundles are created on RP, but located on LC(s); therefore, you would see default values. This is also applicable to any per-interface data; for example, adjacencies.

The node-id argument is entered in the rack/slot/module notation.

Task ID

Task ID

Operations

mpls-te

read, write

mpls-ldp

read, write

mpls-static

read, write

Examples

The following sample output is from the show mpls forwarding command using the location keyword and a specific node ID:

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-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, such as explicit-nullv4, explicit-nullv6, are installed in the forwarding plane. The label range is 0 to 15.

(Optional) Displays the policy-based tunnel selection (PBTS) to direct traffic into specific TE tunnels. The policy-class attribute maps the correct traffic class to this policy. The range for the policy-class value is from 1 to 7.

hardware

(Optional) Displays the hardware location entry.

ingress

(Optional) Reads information from the ingress PSE.

egress

(Optional) Reads information from the egress PSE.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 3.9.0

The following keywords and arguments were added:

detail keyword

location keyword and node-id argument

policy-class keyword and value argument

hardware, ingress, and egress keywords

Usage Guidelines

To use this command, you must
be in a user group associated with a task group that includes appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

The show mpls forwarding exact-route command displays information in long form and includes the following information:

Encapsulation length

Media Access Control (MAC) string length

Maximum transmission unit (MTU)

Packet switching information

Label stacking information

Task ID

Task ID

Operations

mpls-te

read, write

mpls-ldp

read, write

mpls-static

read, write

Examples

The following shows a sample output from the show mpls forwarding exact-route command:

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-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, such as explicit-nullv4, explicit-nullv6, are installed in the forwarding plane. The label range is 0 to 15.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

To use this command, you must
be in a user group associated with a task group that includes appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

This command displays MPLS information about a specific interface or about all interfaces where MPLS is configured.

Task ID

Task ID

Operations

mpls-te

read, write

mpls-ldp

read, write

mpls-static

read, write

Examples

The following shows a sample output from the show mpls interfaces command:

show mpls label range

To display the range of local labels available for use on packet interfaces, use theshow mpls label range command in EXEC mode.

show mpls label range

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

To use this command, you must
be in a user group associated with a task group that includes appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

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

Task ID

Operations

mpls-te

read, write

mpls-ldp

read, write

mpls-static

read, write

Examples

The following shows a sample output from the show mpls label range command:

(Optional) Displays a selected label based on the label value. Range is 0 to 1048575.

summary

(Optional) Displays a summary of local labels.

detail

(Optional) Displays detailed information for the MPLS label table.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 3.9.0

The detail keyword was added.

Usage Guidelines

To use this command, you must
be in a user group associated with a task group that includes appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

Note

Labels 16 to 15999 are reserved for static Layer 2 VPN pseudowires.

Task ID

Task ID

Operations

mpls-te

read, write

mpls-ldp

read, write

mpls-static

read, write

Examples

The following shows a sample output from the show mpls label table command:

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 3.9.0

The application keyword was added.

Usage Guidelines

To use this command, you must
be in a user group associated with a task group that includes appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

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

Task ID

Operations

mpls-te

read, write

mpls-ldp

read, write

mpls-static

read, write

Examples

The following shows a sample output from the show mpls lsd applications command:

Related Commands

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 Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

To use this command, you must
be in a user group associated with a task group that includes appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

The following table describes the significant fields shown in the display.

Table 7 show mpls lsd clients Command Field Descriptions

Field

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.

Related Commands

Command

Description

show mpls lsd applications

Displays MPLS applications registered with the MPLS LSD server.

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.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

To use this command, you must
be in a user group associated with a task group that includes appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

Syntax Description

(Optional) Displays all FRR events for the selected protected interface.

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or virtual interface.

Note

Use the show interfaces command to see a list of all possible interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

locationnode-id

(Optional) Displays all FRR events that occurred on the selected node.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 3.9.0

Sample output was modified.

Usage Guidelines

To use this command, you must
be in a user group associated with a task group that includes appropriate task
IDs. If the user group assignment is preventing you from using a command,
contact your AAA administrator for assistance.

Task ID

Task ID

Operations

mpls-te

read

Examples

The following shows a sample output from the show mpls traffic-eng fast-reroute log command: