Cisco IOS Multiprotocol Label Switching Command Reference

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Book Contents
Find Matches in This Book
Available Languages
Download Options

Book Title

Cisco IOS Multiprotocol Label Switching Command Reference

Chapter Title

show mpls oam echo statistics through switching tlv

Results

Updated:
June 10, 2020

Chapter: show mpls oam echo statistics through switching tlv

show mpls oam echo statistics through switching tlv

show mpls oam echo statistics

To display statistics about Multiprotocol Label Switching (MPLS) Operation, Administration, and Maintenance (OAM) echo request packets, use the show mpls oam echo statistics command in privileged EXEC mode.

show mpls oam echo statistics [summary]

Syntax Description

summary

(Optional) Displays summary information about the echo request packets (that is, the type, length, values (TLVs) version and the return codes of echo packets are not displayed).

Command Modes


Privileged EXEC

Command History

Release

Modification

12.4(6)T

This command was introduced.

12.0(32)SY

This command was integrated into Cisco IOS Release 12.0(32)SY.

12.4(11)T

This command was integrated into Cisco IOS Release 12.4(11)T.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2.

12.2(33)SXI

This command was integrated into Cisco IOS Release 12.2(33)SXI.

Usage Guidelines

You can use theshow mpls oam echo statistics command to display the following:

  • Currently configured TLV version for MPLS OAM operations.

  • Return code distribution among the received MPLS echo reply packets.

  • Statistics of sent and received MPLS echo packets, and counts of incomplete packet dispatches and timed out MPLS echo requests.

If you enter the summary keyword, the Echo Reply count shows all the echo reply packets, regardless of whether they are valid responses to a sent request packet. Therefore, the number of return codes will not match the number of echo reply packets received.

Examples

The following example displays sample detailed output when the summary keyword is not specified: 


Router# show mpls oam echo statistics 
Cisco TLV version: RFC 4379 Compliant
Return code distribution:
 !--Success (3) - 5
 B--Unlabeled output interface (9) - 0
 D--DS map mismatch (5) - 0
 f--Forward Error Correction (FEC) mismatch (10) - 0
 F--No FEC mapping (4) - 0
 I--Unknown upstream interface index (6) - 0
 L--Labeled output interface (8) - 0
 m--Unsupported TLVs (2) - 0
 M--Malformed echo request (1) - 0
 N--No label entry (11) - 0
 p--Premature termination of link-state packet (LSP) (13) - 0
 P--No receive interface label protocol (12) - 0
 U--Reserved (7) - 0
 x--No return code (0) - 0
 X--Undefined return code - 0
Echo Requests: sent (5)/received (0)/timedout (0)/unsent (0)
Echo Replies: sent (0)/received (5)/unsent (0)

The following example displays sample output when the summary keyword is specified: 


Router# show mpls oam echo statistics summary
Cisco TLV version: RFC 4379 Compliant
Echo Requests: sent (5)/received (0)/timedout (0)/unsent (0)
Echo Replies: sent (0)/received (5)/unsent (0)

The table below describes the significant fields shown in the displays.

Table 1. show mpls oam echo statistics Field Descriptions

Field

Description

Return Code Distribution

In each line of the return code distribution, the following information is displayed:

  • Single-character code corresponding to the return code in the received packet (for example ! or B).

  • Description of the return code (for example, Success).

  • Value of the return code (for example, (3)).

  • Number of packets received with the return code (for example, 5).

sent

Number of MPLS echo request packets that the router sent.

timedout

Number of MPLS echo request packets that timed out.

received

Number of MPLS echo request packets that the router received from the network.

unsent

Number of MPLS echo requests that were not forwarded due to errors.

show mpls platform

To display platform-specific information, use the show mpls platform command in EXEC mode.

show mpls platform {common | eompls | gbte-tunnels | reserved-vlans vlan vlan-id | stats [reset] | vpls vlan-id | vpn}

Syntax Description

common

Displays the counters for shared code between the LAN and WAN interfaces.

eompls

Displays information about the Ethernet over Multiprotocol Label Switching (EoMPLS)-enabled interface.

gbte-tunnels

Displays information about the Multicast Multilayer Switching (MMLS) Guaranteed Bandwidth Traffic Engineering (GBTE) tunnels.

reserved-vlans vlan vlan-id

Displays Route Processor (RP)-reserved VLAN show commands; valid values are from 0 to 4095.

stats

Displays information about the RP-control plane statistics.

reset

(Optional) Resets the statistics counters.

vpls vlan-id

Displays Virtual Private LAN Services (VPLS)-related information; valid values are from 1 to 4095.

vpn

Displays information about the Virtual Private Network (VPN)-to-VLAN mapping table.

Command Default

This command has no default settings.

Command Modes


EXEC

Command History

Release

Modification

12.2(17b)SXA

Support for this command was introduced on the Supervisor Engine 720.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(50)SY

This command was introduced on the Catalyst 6500.

Usage Guidelines

This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.

Examples

This example shows how to display the counters for shared code between the LAN and WAN interfaces: 


Device# show mpls platform common

Common MPLS counters for LAN and WAN
-------------------------------------
 No. of MPLS configured LAN interfaces           = 12
 No. of cross-connect configured VLAN interfaces = 0

This example shows how to display the EoMPLS-enabled interface information: 


Device# show mpls platform eompls

Interface        VLAN
GigabitEthernet  101
FastEthernet6/1  2022

This example shows how to display the GBTE-tunnels information: 


Device# show mpls platform gbte-tunnels

To            From          InLbl   I/I/F kbps     Kbits    H/W Info

This example shows how to display the RP-reserved VLAN show commands: 


Device# show mpls platform reserved-vlans vlan 1005

Note

This example shows the output if there are no configured reserved VLANs.

This example shows how to display the information about the RP-control plane statistics: 


Device# show mpls platform stats

              RP MPLS Control Plane Statistics:
      ==================================================
Reserved VLAN creates                    0000000001
Reserved VLAN frees                      0000000000
Reserved VLAN creation failures          0000000000
Aggregate Label adds                     0000000001
Aggregate Label frees                    0000000000
Aggregate Labels in Superman             0000000001
Feature Rsvd VLAN Reqs                   0000000000
Feature Gen Rsvd VLAN Reqs               0000000000
Feature Rsvd VLAN Free Reqs              0000000000
EoMPLS VPN# Msgs                         0000000009
EoMPLS VPN# Msg Failures                 0000000000
EoMPLS VPN# Msg Rsp Failures             0000000000
EoMPLS VPN# Set Reqs                     0000000010
EoMPLS VPN# Reset Reqs                   0000000008
FIDB mallocs                             0000000000
FIDB malloc failures                     0000000000
FIDB frees                               0000000000
EoMPLS Req mallocs                       0000000018
EoMPLS Req malloc failures               0000000000
EoMPLS Req frees                         0000000018
EoMPLS VPN# allocs                       0000000010
EoMPLS VPN# frees                        0000000008
EoMPLS VPN# alloc failures               0000000000
GB TE tunnel additions                   0000000000
GB TE tunnel label resolves              0000000000
GB TE tunnel deletions                   0000000000
GB TE tunnel changes                     0000000000
GB TE tunnel heads skips                 0000000000
gb_flow allocs                           0000000000
gb_flow frees                            0000000000
rsvp req creats                          0000000000
rsvp req frees                           0000000000
rsvp req malloc failures                 0000000000
gb_flow malloc failures                  0000000000
psb search failures                      0000000000
GB TE tunnel deleton w/o gb_flow         0000000000
errors finding slot number               0000000000

This example shows how to reset the RP-control plane statistics counters: 


Device# show mpls platform stats reset

Resetting Const RP MPLS control plane software statistics ...
GB TE tunnel additions                   0000000000
GB TE tunnel label resolves              0000000000
GB TE tunnel deletions                   0000000000
GB TE tunnel changes                     0000000000
GB TE tunnel heads skips                 0000000000
gb_flow allocs                           0000000000
gb_flow frees                            0000000000
rsvp req creats                          0000000000
rsvp req frees                           0000000000
rsvp req malloc failures                 0000000000
gb_flow malloc failures                  0000000000
psb search failures                      0000000000
GB TE tunnel deleton w/o gb_flow         0000000000
errors finding slot number               0000000000

This example shows how to display information about a VPLS instance: 


Device# show mpls platform vpls 100

----------------------------
VPLS VLAN 100 (BD 100):
VC info (#spoke VCs 0) :
Imp: tcam 224 (68 ) adj 131076 (0x20004) [peer 1.1.1.1 ID vc_id 100 2:1] stats 0/0 0/0
Disp: tcam 324 (66 ) adj 114692 (0x1C004) [in_label 16] stats 6/448
-------------------------------
BD Flood Manager: VLAN/BD 100, 1 peers
CMET handle 0x6 top 6 (0x6) bottom 6 (0x6)
Ingr flood: tcam 64/0x40 (sw 15) adj 196608 (0x30000) elif 0x701C0064 stats 0/0
Egr flood: tcam 65/0x41 (sw 72) adj 32868 (0x8064) elif 0x20000064 stats 1/94
Ingr local: tcam 32/0x20 (sw 13) adj 180224 (0x2C000) elif 0x20000064 stats 0/0
Egr local: tcam 33/0x21 (sw 14) adj 180225 (0x2C001) elif 0x20000064 stats 0/0
BD Flood Manager: 1 BDs, LTL base 0x90E, LTL clients: VPLS
: Wildcard entry tcam 288 (12) adj 78089 (0x13109)

This example shows how to display information about the VPN-to-VLAN mapping table: 


Device# show mpls platform vpn

VPN#  Rsvd Vlan  IDB Created  Feature  Has agg label  In superman    EoM data
0     1025       Yes          No       No             No             No
1     0          No           No       Yes            Yes            No

show mpls prefix-map


Note

Effective with Cisco IOS Release 12.4(20)T, the show mpls prefix-map command is not available in Cisco IOS software.

To display the prefix map used to assign a quality of service (QoS) map to network prefixes that match a standard IP access list, use the show mpls prefix-map command in privileged EXEC mode.

show mpls prefix-map [prefix-map]

Syntax Description

prefix-map

(Optional) Number specifying the prefix map to be displayed.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

12.0(5)T

This command was introduced.

12.0(10)ST

This command was modified to reflect Multiprotocol Label Switching (MPLS) Internet Engineering Task Force (IETF) syntax and terminology.

12.2(2)T

This command was integrated into Cisco IOS Release 12.2(2)T.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

12.4(20)T

This command was removed.

Usage Guidelines

Not entering a specific prefix-map argument number causes all prefix maps to be displayed.

Examples

The following is sample output from the show mpls prefix-map command: 


Router# show mpls prefix-map 2
prefix-map 2 access-list 2 cos-map 2

The table below describes the fields shown in the display.

Table 2. show mpls prefix-map Field Descriptions

Field

Description

prefix-map

Unique number of a prefix map.

access-list

Unique number of an access list.

cos-map

Unique number of a QoS map.

Related Commands

Command

Description

mpls prefix-map

Configures a router to use a specified QoS map when a label destination prefix matches the specified access-list.

show mpls static binding

To display Multiprotocol Label Switching (MPLS) static label bindings, use the show mpls static binding command in privileged EXEC mode.

show mpls static binding [ipv4 [vrf vrf-name]] [prefix {mask-length | mask}] [local | remote] [nexthop address]

Syntax Description

ipv4

(Optional) Displays IPv4 static label bindings.

vrf vrf-name

(Optional) The static label bindings for a specified VPN routing and forwarding instance.

prefix {mask-length | mask}

(Optional) Labels for a specific prefix.

local

(Optional) Displays the incoming (local) static label bindings.

remote

(Optional) Displays the outgoing (remote) static label bindings.

nexthop address

(Optional) Displays the label bindings for prefixes with outgoing labels for which the specified next hop is to be displayed.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

12.0(23)S

This command was introduced.

12.0(26)S

This command was modified. The vrf vrf-name keyword argument pair was added.

12.3(14)T

This command was integrated into Cisco IOS Release 12.3(14)T.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB.

Cisco IOS XE Release 2.1

This command was integrated into Cisco IOS XE Release 2.1.

Cisco IOS XE Release 3.5S

This command was implemented on the Cisco ASR 903 series routers.

Usage Guidelines

If you do not specify any optional arguments, the show mpls static binding command displays information about all static label bindings. Or the information can be limited to any of the following:

  • Bindings for a specific prefix or mask

  • Local (incoming) labels

  • Remote (outgoing) labels

  • Outgoing labels for a specific next hop router

Examples

In the following output, the show mpls static binding ipv4 command with no optional arguments displays all static label bindings: 


Router# show mpls static binding ipv4 
10.0.0.0/8: Incoming label: none;
  Outgoing labels:
     10.13.0.8           explicit-null
10.0.0.0/8: Incoming label: 55 (in LIB)
  Outgoing labels:
     10.0.0.66              2607
10.66.0.0/16: Incoming label: 17 (in LIB)
  Outgoing labels:  None

In the following output, the show mpls static binding ipv4 command displays remote (outgoing) statically assigned labels only: 


Router# show mpls static binding ipv4 remote
10.0.0.0/8: 
  Outgoing labels:
     10.13.0.8           explicit-null
10.0.0.0/8: 
  Outgoing labels:
     10.0.0.66              2607

In the following output, the show mpls static binding ipv4 command displays local (incoming) statically assigned labels only: 


Router# show mpls static binding ipv4 local 
10.0.0.0/8: Incoming label: 55 (in LIB)
10.66.0.0/16: Incoming label: 17 (in LIB)

In the following output, theshow mpls static binding ipv4 command displays statically assigned labels for prefix 10.0.0.0 / 8 only: 


Router# show mpls static binding ipv4 10.0.0.0/8
10.0.0.0/8: Incoming label: 55 (in LIB)
  Outgoing labels:
     10.0.0.66              2607

In the following output, the show mpls static binding ipv4 command displays prefixes with statically assigned outgoing labels for next hop 10.0.0.66: 


Router# show mpls static binding ipv4 10.0.0.0 8 nexthop 10.0.0.66
10.0.0.0/8: Incoming label: 55 (in LIB)
  Outgoing labels:
     10.0.0.66              2607

The following output, the show mpls static binding ipv4 vrf command displays static label bindings for a VPN routing and forwarding instance vpn100: 


Router# show mpls static binding ipv4 vrf vpn100
192.168.2.2/32: (vrf: vpn100) Incoming label: 100020 
Outgoing labels: None 
192.168.0.29/32: Incoming label: 100003 (in LIB) 
Outgoing labels: None

Related Commands

Command

Description

mpls static binding ipv4

Binds an IPv4 prefix or mask to a local or remote label.

show mpls static crossconnect

To display statically configured Label Forwarding Information Database (LFIB) entries, use the show mpls static crossconnect command in privileged EXEC mode.

show mpls static crossconnect [low label [high label]]

Syntax Description

low label high label

(Optional) The statically configured LFIB entries.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

12.0(23)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB.

Usage Guidelines

If you do not specify any label arguments, then all the configured static cross-connects are displayed.

Examples

The following sample output from the show mpls static crossconnect command shows the local and remote labels: 


Router# show mpls static crossconnect
Local  Outgoing    Outgoing   Next Hop    
label  label       interface              
45     46          pos5/0     point2point

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

Table 3. show mpls static crossconnect Field Descriptions

Field

Description

Local label

Label assigned by this router.

Outgoing label

Label assigned by the next hop.

Outgoing interface

Interface through which packets with this label are sent.

Next Hop

IP address of the next hop router’s interface that is connected to this router’s outgoing interface.

Related Commands

Command

Description

mpls static crossconnect

Configures an LFIB entry for the specified incoming label and outgoing interface.

show mpls tp link-management admission-control failures

To determine the end-to-end state of MPLS Transport Profile (TP) tunnels, use the show mpls tp link-management admission-control failures command in user EXEC or privileged EXEC mode.

show mpls tp link-management admission-control failures

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)

Privileged EXEC (#)

Command History

Release

Modification

15.2(2)S

This command was introduced.

Usage Guidelines

The show mpls tp link-management admission-control failures command is typically used to display information about MPLS Transport Profile (TP) endpoint and midpoint label switched path (LSP) admission failures. For example, this command can determine which MPLS-TP tunnels were not admitted due to insufficient bandwidth available on the physical interfaces.

Examples


        R1#show mpls tp link-management admission-control failures
MPLS-TP Endpoint LSP admission failures:
Tun   Dest                                              Out      Req BW
Num   Global-id::Node-id          LSP                   Intf     kbps
----- --------------------------  ----------------      -------- ------

MPLS-TP Midpoint LSP admission failures:
Src   Src                  Dest  Dest                 LSP   Out      Req BW
Tun   Global-id::Node-id   Tun   Global-id::Node-id   Num   Intf     kbps
----- -------------------- ----- -------------------- ----- -------- ------

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

Table 4. show mpls tp link-management admission-control failures Field Descriptions

Field

Description

Tun Num

Tunnel number.

Dest Global-id::Node-id

Destination global ID or the destination node ID. The global ID is usually the default global ID used for all endpoints and midpoint. The global ID is an autonomous system number, which is a controlled number space by which providers can identify each other.

LSP

LSP number.

Out Intf

Outbound (egress) interface.

Req BW kbps

Requisite bandwidth in kilobytes per second.

Src Tun

Source tunnel number.

Src Global-id::Node-id

Source global ID or source node ID number.

Dest Tun

Destination tunnel number.

LSP Num

LSP number.

Related Commands

Command

Description

show mpls tp tunnel-tplsps

Determines that both LSPs are up and working from a tunnel endpoint.

show mpls traffic tunnel backup

To display information about the backup tunnels that are currently configured, use the show mpls traffic tunnel backup command in user EXEC or privileged EXEC mode.

show mpls traffic tunnel backup tunnel tunnel-id

Syntax Description

tunnel tunnel-id

Tunnel ID of the backup tunnel for which you want to display information.

Command Default

Information about currently configured backup tunnels is not displayed.

Command Modes


User EXEC
Privileged EXEC

Command History

Release

Modification

12.0(22)S

This command was introduced.

12.2(18)SXD1

This command was integrated into Cisco IOS Release 12.2(18)SXD1.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T

Examples

The following is sample output from the show mpls traffic tunnel backup tunnel tunnel-id command: 


Router# show mpls traffic tunnel backup tunnel 1000
Tunnel1000          Dest: 10.0.0.9        State: Up           
any-pool cfg 100 inuse 0 num_lsps 0
     protects: ATM0.1

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

Table 5. show mpls traffic tunnel backup Field Descriptions

Field

Description

Tunnel

Tunnel ID of the backup tunnel for which this information is being displayed.

Dest

IP address of the destination of the backup tunnel.

State

State of the backup tunnel. Valid values are Up, Down, or Admin-down.

any-pool

Pool from which bandwidth is acquired. Valid values are any-pool, global-pool, and sub-pool.

cfg

Amount of bandwidth configured for that pool.

inuse

Amount of bandwidth currently being used.

num_lsps

Number of label-switched paths (LSPs) being protected.

protects

The protected interfaces that are using this backup tunnel.

Related Commands

Command

Description

tunnel mpls traffic-eng backup-bw

Specifies what types of LSPs can use a backup tunnel, whether the backup tunnel should provide bandwidth protection, and if so, how much.

show mpls traffic-eng autoroute

To display tunnels announced to the Interior Gateway Protocol (IGP), including interface, destination, and bandwidth, use the show mpls traffic-eng autoroute command in user EXEC or privileged EXEC mode.

show mpls traffic-eng autoroute

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values

Command Modes


User EXEC (>)
Privileged EXEC (#)

Command History

Release

Modification

12.0(5)S

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Cisco IOS XE Release 3.5S

This command was integrated into Cisco IOS XE Release 3.5S.

Usage Guidelines

The enhanced shortest path first (SPF) calculation of the IGP has been modified so that it uses traffic engineering tunnels. This command shows which tunnels IGP is currently using in its enhanced SPF calculation (that is, which tunnels are up and have autoroute configured).

Examples

The following is sample output from the show mpls traffic-eng autoroute command.

Note that the tunnels are organized by destination. All tunnels to a destination carry a share of the traffic tunneled to that destination. 


Router# show mpls traffic-eng autoroute
 
MPLS TE autorouting enabled
  destination 0002.0002.0002.00 has 2 tunnels
    Tunnel1021 (traffic share 10000, nexthop 10.2.2.2, absolute metric 11)
    Tunnel1022 (traffic share 3333, nexthop 10.2.2.2, relative metric -3)
  destination 0003.0003.0003.00 has 2 tunnels
    Tunnel1032 (traffic share 10000, nexthop 172.16.3.3)
    Tunnel1031 (traffic share 10000, nexthop 172.16.3.3, relative metric -1)

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

Table 6. show mpls traffic-eng autoroute Field Descriptions

Field

Description

MPLS TE autorouting enabled

IGP automatically routes traffic into tunnels.

destination

MPLS traffic engineering tailend router system ID.

traffic share

A factor based on bandwidth, indicating how much traffic this tunnel should carry, relative to other tunnels, to the same destination. If two tunnels go to a single destination, one with a traffic share of 200 and the other with a traffic share of 100, the first tunnel carries two-thirds of the traffic.

nexthop

MPLS traffic engineering tailend IP address of the tunnel.

absolute metric

MPLS traffic engineering metric with mode absolute of the tunnel.

relative metric

MPLS traffic engineering metric with mode relative of the tunnel.

Related Commands

Command

Description

show isis mpls traffic-eng tunnel

Displays information about tunnels considered in the IS-IS next hop calculation.

tunnel mpls traffic-eng autoroute announce

Causes the IGP to use the tunnel (if it is up) in its enhanced SPF calculation.

tunnel mpls traffic-eng autoroute metric

Specifies the MPLS traffic engineering tunnel metric that the IGP enhanced SPF calculation will use.

show mpls traffic-eng auto-tunnel backup

To display information about dynamically created Multiprotocol Label Switching (MPLS) traffic engineering (TE) tunnels, use the show mpls traffic-eng auto-tunnel backup command in user EXEC or privileged EXEC mode.

show mpls traffic-eng auto-tunnel backup

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)

Privileged EXEC (#)

Command History

Release

Modification

15.1(1)S

This command was introduced.

Cisco IOS XE Release 3.6S

This command was integrated into Cisco IOS XE Release 3.6S.

Examples

The following is sample output from the show mpls traffic-eng auto-tunnel backup command. 


Router# show mpls traffic-eng auto-tunnel backup
 
State: Enabled
  Auto backup tunnels: 4 (up:2, down:2)
  Tunnel ID Range: 65436-65535
  Create Nhop only: Yes
  Check for deletion of unused tunnels every: 600 sec
  SRLG Exclude: Preferred
  Config:
    Unnumbered-interface: Looback0
    Affinity/Mask: 0x2/0xFFFF

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

Table 7. show mpls traffic-eng auto-tunnel backup Field Descriptions

Field

Description

State

State of the dynamically created tunnel. Valid values are enabled or disabled.

Auto backup tunnels

Number of dynamically created backup tunnels created.

Tunnel ID Range

Tunnel ID range used when creating dynamically created backup tunnels.

Create Nhop only

Whether the feature was configured to enable the dynamic creation of NHOP backup tunnels (and not NNHOP). Valid values are yes or no.

Check for deletion of unused tunnels every

Number of seconds before an unused dynamically created tunnel is torn down.

SRLG Exclude

Type of Shared Risk Link Group. Valid values are forced, preferred, or not configured.

Unnumbered-interface

The interface configured with the mpls traffic-eng autotunnel backup config unnumbered-interface command.

Affinity/mask

The affinity and mask configured with the mpls traffic-eng autotunnel backup config affinity command.

Related Commands

Command

Description

mpls traffic-eng auto-tunnel backup config affinity

Enables you to specify link attributes on dynamically created MPLS TE backup tunnels.

mpls traffic-eng auto-tunnel backup config unnumbered-interface

Enables you to specify the interface to use as the unnumbered interface.

mpls traffic-eng auto-tunnel backup nhop

Specifies dynamically created NHOP backup tunnels only.

mpls traffic-eng auto-tunnel backup srlg

Specifies the use of Shared Risk Link Groups (SRLGs) as part of the dynamic backup tunnel calculation.

mpls traffic-eng auto-tunnel backup timers

Specifies the use of timers with dynamically created backup tunnels.

mpls traffic-eng auto-tunnel backup tunnel-num

Specifies tunnel interface numbers for dynamically created backup tunnels.

show mpls traffic-eng auto-tunnel mesh

To display the cloned mesh tunnel interfaces of each autotemplate interface and the current range of mesh tunnel interface numbers, use the show mpls traffic-eng auto-tunnel mesh command in user EXEC mode or privileged EXEC mode.

show mpls traffic-eng auto-tunnel mesh

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)

Privileged EXEC (#)

Command History

Release

Modification

12.0(27)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.

Cisco IOS XE Release 3.6S

This command was integrated into Cisco IOS XE Release 3.6S.

Examples

The following is output from the show mpls traffic-eng auto-tunnel mesh command that shows the cloned mesh tunnel interfaces for autotemplate1 and shows the range of mesh tunnel interface numbers. Information for only one autotemplate is displayed because only one autotemplate was configured. 


Router# show mpls traffic-eng auto-tunnel mesh 

Auto-Template1:
 Using access-list 1 to clone the following tunnel interfaces:
  Destination  Interface
  -----------  ---------
  10.2.2.2     Tunnel64336
  10.3.3.3     Tunnel64337
Mesh tunnel interface numbers: min 64336 max 65337

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

Table 8. show mpls traffic-eng auto-tunnel mesh Field Descriptions

Field

Description

Auto-Template1

Name of the autotemplate.

Destination

Destination addresses for the mesh tunnel interface cloned from access list 1.

Interface

Mesh tunnel interfaces cloned from access list 1.

min 64336 max 65337

Range of mesh tunnel interface numbers for this Auto-Template1--minimum (64336) and maximum (65337).

Related Commands

Command

Description

interface auto-template

Creates the template interface.

mpls traffic-eng auto-tunnel mesh tunnel-num

Configures the range of mesh tunnel interface numbers.

show mpls traffic-eng auto-tunnel primary

To display information about dynamically created Multiprotocol Label Switching (MPLS) traffic engineering (TE) tunnels, use the show mpls traffic-eng auto-tunnel primary command in user EXEC or privileged EXEC mode.

show mpls traffic-eng auto-tunnel primary

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)

Privileged EXEC (#)

Command History

Release

Modification

15.2(2)S

This command was introduced.

Cisco IOS XE Release 3.6S

This command was integrated into Cisco IOS XE Release 3.6S.

Examples

The following is sample output from the show mpls traffic-eng auto-tunnel primary command. 


Router# show mpls traffic-eng auto-tunnel primary

State: Enabled
  Auto primary tunnels: 2 (up: 2, down: 0)
  Tunnel ID Range: 1000-1100
  Check for deletion of FRR Active onehop tunnels every: 0 Sec

  Config:
   unnumbered I/f: Looback0
   mpls ip: TRUE
The table below describes the significant fields shown in the display.
Table 9. show mpls traffic-eng auto-tunnel primary Field Descriptions

State

State of the dynamically created tunnel. Valid values are enabled or disabled.

Auto primary tunnels

Number of dynamically created primary tunnels.

Tunnel ID Range

Tunnel ID range used when creating dynamically created primary tunnels.

Check for deletion of FRR Active onehop tunnels every

Amount of time, in seconds, after which a failed primary tunnel is removed.

unnumbered I/f

The interface configured with the mpls traffic-eng auto-tunnel primary config unnumbered-interface command.

mpls ip

Whether the Label Distribution Protocol (LDP) is enabled on primary tunnels. Valid values are true or false.

Related Commands

Command

Description

mpls traffic-eng auto-tunnel primary config

Enables IP processing without an explicit address.

mpls traffic-eng auto-tunnel primary config mpls ip

Enables LDP on primary autotunnels.

mpls traffic-eng auto-tunnel primary onehop

Automatically creates primary tunnels to all next hops.

mpls traffic-eng auto-tunnel primary timers

Configures how many seconds after a failure that primary autotunnels are removed.

mpls traffic-eng auto-tunnel primary tunnel-num

Configures the range of tunnel interface numbers for primary autotunnels.

show mpls traffic-eng destination list

To display a Multiprotocol Label Switching (MPLS) traffic engineering (TE) point-to-multipoint (P2MP) destination list, use the show mpls traffic-eng destination list command in user EXEC or privileged EXEC configuration mode.

show mpls traffic-eng destination list [name destination-list-name | identifier destination-list-identifier]

Syntax Description

name destination-list-name

(Optional) Specifies the name of a destination list.

identifier destination-list-identifier

(Optional) Specifies the number of a destination list.

Command Modes


User EXEC (>)
Privileged EXEC (#)

Command History

Release

Modification

12.2(33)SRE

This command was introduced.

Usage Guidelines

This command displays the information about any destination lists configured for an MPLS TE P2MP configuration.

Examples

The following example displays information about a destination list: 


Router# show mpls traffic-eng destination-list
Destination list: name p2mp-list1
    ip 10.3.3.3 path-option 1 dynamic
    ip 10.4.4.4 path-option 15 explicit identifier 4
    ip 10.5.5.5 path-option 2 explicit name r1-r2-r4-r5

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

Table 10. show mpls traffic-eng destination-list Field Descriptions

Field

Description

Destination list

The name of the destination list.

ip

The IP address of the path’s destination.

path-option

Information about the dynamic or explicit path.

Related Commands

Command

Description

mpls traffic-eng destination-list

Creates a destination list for MPLS Point-to-Multipoint Traffic Engineering.

show mpls traffic-eng exp

To display the configured and the actual experimental (EXP) bit mapping on a member tunnel that is part of the Class-based Tunnel Selection (CBTS) bundle, use the show mpls traffic-eng exp command in user EXEC or privileged EXEC mode.

show mpls traffic-eng exp ip-address

Syntax Description

ip-address

(Optional) Destination address of the primary tunnel.

Command Modes

User EXEC (>)

Privileged EXEC (#)

Command History

Release

Modification

12.2(33)SRA

This command was introduced.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.

Cisco IOS XE Release 3.6S

This command was integrated into Cisco IOS XE Release 3.6S.

Usage Guidelines

This command shows the member tunnels associated with each primary tunnel, whether the tunnel is up or down, whether the member tunnel is active or inactive, the configured EXP values, and the actual EXP values.

Examples

Router# show mpls traffic-eng exp

Destination: 11.11.11.11
   Master: Tunnel100            Status: up
   Members         Status               Conf Exp        Actual Exp
   Tunnel1         up  (Active)         0                    0
   Tunnel2         up  (Active)         3 4                 3 4
   Tunnel3         up  (Active)         Default           1 2 5 6 7
(D) : Destination is different
(NE): Exp values not configured on tunnel

Related Commands

Command

Description

tunnel mpls traffic-eng exp

Specifies the EXP bits that will be forwarded over a member tunnel that is part of the CBTS bundle.

tunnel mpls traffic-eng exp-bundle master

Configures the primary tunnel.

tunnel mpls traffic-eng exp-bundle member

Identifies which tunnel is a member (bundled tunnel) of the primary tunnel.

show mpls traffic-eng fast-reroute database

To display the contents of the Multiprotocol Label Switching (MPLS) traffic engineering (TE) Fast Reroute (FRR) database, use the show mpls traffic-eng fast-reroute database command in user EXEC or privileged EXEC mode.

Cisco IOS Release 15.0(1)M and Later

show mpls traffic-eng fast-reroute database [interface type number | labels low-label [high-label] ] [backup-interface {tunnel tunnel-number | unresolved}] [role {head | middle}] [state {active | ready | requested}] [detail] [vrf name]

Cisco IOS Releases 12.0S and 12.2S

show mpls traffic-eng fast-reroute database [destination-prefix slot slot-number | interface type number | labels low-label [high-label] ] [backup-interface {tunnel tunnel-number | unresolved}] [role {head | middle}] [state {active | ready | requested}] [detail] [vrf name]

Syntax Description

destination-prefix

(Optional) IP address of the destination.

slot

Specifies the MPLS Forwarding Infrastructure (MFI) slot.

slot-number

Slot number of the destination.

labels

(Optional) Shows only database entries that possess in-labels (local labels) assigned by this router. You specify either a starting value or a range of values.

low-label

(Optional) Starting label value or lowest value in the range.

- high-label

(Optional) Highest label value in the range.

interface type number

(Optional) Specifies the interface type and number to display the database entries related to the primary outgoing interface.

backup-interface

(Optional) Shows only database entries related to the backup outgoing interface.

tunnel tunnel-number

(Optional) Specifies the tunnel interface name and number.

unresolved

(Optional) Specifies the unresolved backup interface.

role

(Optional) Shows entries associated either with the tunnel head or tunnel midpoint.

head

Entry associated with tunnel head.

middle

Entry associated with tunnel midpoint.

state

(Optional) Displays entries that match one of four possible states: active, ready, partial, or complete.

active

Specifies the label switched paths (LSP) with an active FRR state.

ready

Specifies the LSPs with a ready FRR state.

requested

Specifies the LSPs with a requested FRR state.

detail

(Optional) Shows long-form information: Label Forwarding Information Base (LFIB)-FRR total number of clusters, groups, and items in addition to the short-form information of prefix, label and state.

vrf name

(Optional) Shows entries for a Virtual Private Network (VPN) routing/forwarding instance.

Command Modes


User EXEC (>)
Privileged EXEC (#)

Command History

Release

Modification

12.0(10)ST

This command was introduced.

12.2(18)S

This command was integrated into Cisco IOS Release 12.2(18)S.

12.2(18)SXD

This command was modified. It was implemented on the Catalyst 6000 series with the SUP720 processor.

12.2(28)SB

This command was modified. It was implemented on the Cisco 10000(PRE-2) router.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.

12.2(33)SRE

This command was modified. The output was updated to display MPLS TE point-to-multipoint (P2MP) information.

15.2(2)SNG

This command was integrated into Cisco ASR 901 Series Aggregation Services Routers.

Examples

Examples

The following is sample output from the show mpls traffic-eng fast-reroute database command at a tunnel head link: 


Router# show mpls traffic-eng fast-reroute database 10.0.0.0
Tunnel head fast reroute information:
Prefix 	      Tunnel  In-label  Out intf/label  FRR intf/label  Status
10.0.0.0/16   Tu111   Tun hd    PO0/0:Untagged  Tu4000:16       ready  
10.0.0.0/16   Tu449   Tun hd    PO0/0:Untagged  Tu4000:736      ready  
10.0.0.0/16   Tu314   Tun hd    PO0/0:Untagged  Tu4000:757      ready  
10.0.0.0/16   Tu313   Tun hd    PO0/0:Untagged  Tu4000:756      ready

The table below describes the fields shown in the display.

Table 11. show mpls traffic-eng fast-reroute database Field Descriptions

Field

Description

Prefix

Address to which packets with this label are going.

Tunnel

Tunnel’s identifying number.

In-label

Label advertised to other routers to signify a particular prefix. The value “Tun hd” occurs when no such label has been 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 advertised by the tunnel destination device. The value “Untagged” occurs when no such label has been advertised.

  • At tunnel midpoints, this is the label selected by the next hop device. The “Pop Tag” value occurs when the next hop is the tunnel’s final hop.

FRR intf/label

Fast Reroute interface--the backup tunnel interface.

Fast Reroute label:

  • At a tunnel head, this is the label selected by the tunnel tail to indicate the destination network. The value “Untagged” occurs when no such label has been advertised.

  • At tunnel midpoints, this has the same value as the Out Label.

Status

State of the rewrite: partial, ready, complete, or active. (These terms are defined above in the “Syntax Description” section).

The following is sample output from the show mpls traffic-eng fast-reroute database command with the detail keyword included at a tunnel head link: 


Router# show mpls traffic-eng fast-reroute database 10.0.0.0. detail
LFIB FRR Database Summary:
  Total Clusters:      2
  Total Groups:        2
  Total Items:         789
Link 10:PO5/0 (Down, 1 group)
  Group 51:PO5/0->Tu4000 (Up, 779 members)
    Prefix 10.0.0.0/16, Tu313, active
      Input label Tun hd, Output label PO0/0:773, FRR label Tu4000:773
    Prefix 10.0.0.0/16, Tu392, active
      Input label Tun hd, Output label PO0/0:775, FRR label Tu4000:775
    Prefix 10.0.0.0/16, Tu111, active
      Input label Tun hd, Output label PO0/0:16, FRR label Tu4000:16
    Prefix 10.0.0.0/16, Tu394, active
      Input label Tun hd, Output label PO0/0:774, FRR label Tu4000:774

The table below describes the significant fields when the detail keyword is used.

Table 12. show mpls traffic-eng fast-reroute database with detail Keyword Field Descriptions

Field

Description

Total Clusters

A cluster is the physical interface upon which Fast Reroute link protection has been enabled.

Total Groups

A group is a database record that associates the link-protected physical interface with a backup tunnel. A cluster (physical interface) therefore can have one or more groups.

For example, the cluster Ethernet4/0/1 is protected by backup Tunnel1 and backup Tunnel2, and so has two groups.

Total Items

An item is a database record that associates a rewrite with a group. A group therefore can have one or more items.

Link 10:PO5/0 (Down, 1 group)

This field describes a cluster (physical interface):

  • 10 is the interface’s unique IOS-assigned ID number.

  • The colon (:) is followed by the interface’s short name.

  • Parentheses contain the operating state of the interface (Up or Down) and the number of groups associated with it.

Group 51:PO5/0->Tu4000 (Up, 779 members)

This field describes a group:

  • 51 is the ID number of the backup interface.

  • The colon (:) is followed by the group’s physical interface short name.

  • The hyphen and angle bracket (->) is followed by the backup tunnel interface short name.

  • Parentheses contain the operating state of the tunnel interface (Up or Down) and the number of items--also called “members”-- associated with it.

The following is sample output from the show mpls traffic-eng fast-reroute database command with the labels keyword specified at a midpoint link: 


Router# show mpls traffic-eng fast-reroute database labels 250-255
Tunnel head fast reroute information:
Prefix   Tunnel   In-label   Outintf/label   FRR intf/label   Status
LSP midpoint frr information:
LSP identifier          In-label   Out intf/label  FRR intf/label  Status
10.110.0.10 229 [7334] 	255        PO0/0:694       Tu4000:694      active 
10.110.0.10 228 [7332] 	254        PO0/0:693       Tu4000:693      active 
10.110.0.10 227 [7331] 	253        PO0/0:692       Tu4000:692      active 
10.110.0.10 226 [7334] 	252        PO0/0:691       Tu4000:691      active 
10.110.0.10 225 [7333] 	251        PO0/0:690       Tu4000:690      active 
10.110.0.10 224 [7329] 	250        PO0/0:689       Tu4000:689      active

Examples

The following example shows MPLS TE P2MP information as part of the command output. 


Router> show mpls traffic-eng fast-reroute database
 
P2P Headend FRR information:
Protected tunnel               In-label Out intf/label   FRR intf/label   Status
---------------------------    -------- --------------   --------------   ------
Tunnel1                        Tun hd   Et0/1:20         Tu777:20         ready 
P2P LSP midpoint frr information:
LSP identifier                 In-label Out intf/label   FRR intf/label   Status
---------------------------    -------- --------------   --------------   ------
P2MP Sub-LSP FRR information:
Sub-LSP identifier
src_lspid[subid]->dst_tunid    In-label Out intf/label   FRR intf/label   Status
---------------------------    -------- --------------   --------------   ------
10.1.1..201_1[1]->10.1.1..203_22   Tun hd   Et0/0:20         Tu666:20         ready 
10.1.1..201_1[2]->10.1.1..206_22   Tun hd   Et0/0:20         Tu666:20         ready 
10.1.1..201_1[3]->10.1.1..213_22   Tun hd   Et0/0:20         Tu666:20         ready

The table below describes the significant field shown in the display.

Table 13. show mpls traffic-eng fast-reroute database Point-to-Multipoint Field Descriptions

Field

Description

Sub-LSP identifier src_lspid[subid]->dst_tunid

The source and destination address of the sub-LSP being protected. The P2MP ID is appended to the source address. The tunnel ID is appended to the destination address.

The detail keyword provides more information about the P2MP LSPs: 


Router# show mpls traffic-eng fast-reroute database detail
 
FRR Database Summary:
     Number of protected interfaces: 1
     Number of protected tunnels: 2
     Number of backup tunnels: 1
     Number of active interfaces: 0
P2MP Sub-LSPs:
   Tun ID: 1, LSP ID: 9, Source: 10.2.0.1
   Destination: 10.2.5.3, Subgroup ID: 19
   State        : Ready
   InLabel      : Tunnel Head
   OutLabel     : Se6/0:16
   FRR OutLabel : Tu100:16

Related Commands

Command

Description

show mpls traffic-eng fast-reroute log reroutes

Displays contents of the Fast Reroute event log.

show mpls traffic-eng fast-reroute log reroutes

To display the contents of the Fast Reroute event log, use the show mpls traffic-eng fast-reroute log reroutes command in user EXEC mode.

show mpls traffic-eng fast-reroute log reroutes

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values.

Command Modes


User EXEC

Command History

Release

Modification

12.0(10)ST

This command was introduced.

12.2(18)S

This command was integrated into Cisco IOS Release 12.2(18)S.

12.2(18)SXD

This command was implemented on the Catalyst 6000 series with the SUP720 processor.

12.2(28)SB

This command was implemented on the Cisco 10000(PRE-2) router.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

Examples

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


Router# show mpls traffic-eng fast-reroute log reroutes
When      Interface  Event   Rewrites  Duration  CPU msecs  Suspends  Errors
00:27:39  PO0/0      Down    1079      30 msecs  30         0         0
00:27:35  PO0/0      Up      1079      40 msecs  40         0         0

The table below describes significant fields shown in the display.

Table 14. show mpls traffic-eng fast-reroute log reroutes Field Descriptions

Field

Description

When

Indicates how long ago the logged event occurred (before this line was displayed on your screen). Displayed as hours, minutes, seconds.

Interface

The physical or tunnel interface where the logged event occurred.

Event

The change to Up or Down by the affected interface.

Rewrites

Total number of reroutes accomplished because of this event.

Duration

Time elapsed during the rerouting process, in milliseconds.

CPU msecs

CPU time spent processing those reroutes, in milliseconds. (This is less than or equal to the Duration value).

Suspends

Number of times that reroute processing for this event was interrupted to let the CPU handle other tasks.

Errors

Number of unsuccessful reroute attempts.

show mpls traffic-eng feature-control

To display a list of the Multiprotocol Label Switching (MPLS) Traffic Engineering (TE) features that are supported on a specific platform or image, use the show mpls traffic-eng feature-control command in privileged EXEC mode.

show mpls traffic-eng feature-control

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release Modification

Cisco IOS XE Release 3.12S

This command was introduced in a release earlier than Cisco IOS XE Release 3.12S.

Usage Guidelines

The show mpls traffic-eng feature-control command provides visibility to the MPLS TE feature control support.

Examples

The following is sample output from the show mpls traffic-eng feature-control command. The field descriptions are self-explanatory. 


Device# show mpls traffic-eng feature-control

MPLS-TE Feature                                             Configurable
---------------                                             ------------
Basic Feature Set                                           yes
Auto-Bandwidth                                              yes
Auto-Bandwidth Enhancements                                 yes
Auto-Tunnel Meshgroups                                      yes
Auto-Route Destination                                      yes
Auto-Tunnel Primary and Backup                              yes
Class-Based Tunnel Selection (CBTS)                         yes
IETF Diff-Serv Aware TE (DSTE)                              yes
Fast-Reroute: Link, Node and Bandwidth Protection           yes
Fast-Reroute Integration over ATM                           yes
Fast-Reroute Node Protection Desired                        yes
Fast-Reroute Triggered by BFD                               yes
RSVP Graceful Restart Help Neighbor                         yes
TE Support over Etherchannel Interface                      yes
TE Support over Multilink Interface                         yes
Inter-AS TE                                                 yes
LSP Attributes and Bandwidth Override                       yes
MPLS Transport Profile (MPLS-TP)                            yes
MPLS Transport Profile (MPLS-TP) Bandwidth Manager          yes
MPLS Transport Profile (MPLS-TP) support on BDI interfaces  yes
MPLS Transport Profile (MPLS-TP) support on ethernet subinteyes
MPLS Transport Profile (MPLS-TP) support on SVI interfaces  yes
MPLS Transport Profile (MPLS-TP) Non-IP                     yes
TE Point-to-Multipoint (P2MP)                               yes
Path-option Protect                                         yes
Path-option Protect Enhancements                            yes
Shared Risk Link Group (SRLG)                               yes
Stateful Switchover (SSO)                                   yes
TE Fast Tunnel Interface Down                               yes
Verbatim LSPs                                               yes

show mpls traffic-eng forwarding-adjacency

To display traffic engineering (TE) tunnels that are advertised as links in an Interior Gateway Protocol (IGP) network, use the show mpls traffic-eng forwarding-adjacency command in user EXEC or privileged EXEC mode.

show mpls traffic-eng forwarding-adjacency [ip-address]

Syntax Description

ip-address

(Optional) Destination address for forwarding adjacency tunnels.

Command Modes


User EXEC
Privileged EXEC

Command History

Release

Modification

12.0(15)S

This command was introduced.

12.0(16)ST

This command was integrated into Cisco IOS Release 12.0(16)ST.

12.2(18)S

This command was integrated into Cisco IOS Release 2.2(18)S.

12.2(18)SXD

This command was integrated into Cisco IOS Release 12.2(18)SXD.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.

Usage Guidelines

Use the show mpls traffic-eng forwarding-adjacency command to display information about tunnels configured with the tunnel mpls traffic-eng forwarding-adjacency command.

Examples

The following is sample output from the show mpls traffic-eng forwarding-adjacency command: 


Router# show mpls traffic-eng forwarding-adjacency
  destination 0168.0001.0007.00 has 1 tunnels
    Tunnel7     (traffic share 100000, nexthop 192.168.1.7)
                (flags:Announce Forward-Adjacency, holdtime 0)
Router# show mpls traffic-eng forwarding-adjacency 192.168.1.7
  destination 0168.0001.0007.00 has 1 tunnels
    Tunnel7     (traffic share 100000, nexthop 192.168.1.7)
                (flags:Announce Forward-Adjacency, holdtime 0)

Related Commands

Command

Description

debug mpls traffic-eng forwarding-adjacency

Displays debug messages for traffic engineering forwarding adjacency events.

tunnel mpls traffic-eng forwarding-adjacency

Advertises a TE tunnel as a link in an IGP network.

show mpls traffic-eng forwarding path-set

To display the sublabel switched paths (sub-LSPs) that originate from the headend router, use the show mpls traffic-eng forwarding path-set command in user EXEC or privileged EXEC mode.

show mpls traffic-eng forwarding path-set [brief | detail]

Syntax Description

brief

(Optional) Displays information about the sub-LSPs in a table format.

detail

(Optional) Displays detailed information about the sub-LSPs.

Command Modes


User EXEC (>)
Privileged EXEC (#)

Command History

Release

Modification

12.2(33)SRE

This command was introduced.

Examples

The following example displays information about the sub-LSPs in a summary format, including the number of sub-LSPs and the number of paths from the headend router. 


Router> show mpls traffic-eng forwarding path-set
 
ID       Input I/F  LSPID  InLabel  PathCnt  subLSPCnt
----     ---------  -----  -------  -------  ---------
9F000001 Tu22       1      none     2        6

The following example shows six sub-LSPs originating at the headend router and going to different destinations. All the sub-LSPs belong to the same path set, which is a collection of paths. The path set is given a unique ID, which is shown in the PSID column of the example: 


Router# show mpls traffic-eng forwarding path-set brief
Sub-LSP Identifier                      
src_lspid[subid]->dst_tunid              InLabel Next Hop      I/F    PSID
---------------------------              ------- ------------- ------ ----
10.1.1.201_1[1]->10.1.1.203_22             none    10.0.0.205    Et0/0  9F000001
10.1.1.201_1[2]->10.1.1.206_22             none    10.0.0.205    Et0/0  9F000001
10.1.1.201_1[3]->10.1.1.213_22             none    10.0.0.205    Et0/0  9F000001
10.1.1.201_1[4]->10.1.1.214_22             none    10.0.1.202    Et0/1  9F000001
10.1.1.201_1[5]->10.1.1.216_22             none    10.0.1.202    Et0/1  9F000001
10.1.1.201_1[6]->10.1.1.217_22             none    10.0.1.202    Et0/1  9F000001

The show mpls traffic-eng forwarding path-set detail command shows more information about the sub-LSPs that originate from the headend router. For example: 


Router# show mpls traffic-eng forwarding path-set detail
LSP: Source: 10.1.0.1, TunID: 100, LSPID: 7
  Destination: 10.2.0.1, P2MP Subgroup ID: 1
    Path Set ID: 0x30000001
    OutLabel : Serial2/0, 16
    Next Hop : 10.1.3.2
    FRR OutLabel : Tunnel666, 16 
  LSP: Source: 10.1.0.1, TunID: 100, LSPID: 7
  Destination: 10.3.0.1, P2MP Subgroup ID: 2
    Path Set ID: 0x30000001
    OutLabel : Serial2/0, 16
    Next Hop : 10.1.3.2
    FRR OutLabel : Tunnel666, 16

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

Table 15. show mpls traffic-eng forwarding path-set Field Descriptions

Field

Description

ID

Path set ID.

Input I/F

The ID assigned to the tunnel that the sub-LSPs use.

LSPID

Sub-LSP ID.

InLabel

MPLS label in the input interface.

PathCnt

Number of paths from the headend router.

subLSPCnt

Number of sub-LSPS from the headend router.

Sub-LSP Identifier src_lspid[subid]->dst_tunid

The source and destination address of the sub-LSP being protected. The P2MP ID is appended to the source address. The tunnel ID is appended to the destination address.

Next Hop

Next-hop router.

I/F

The interface that the sub-LSPs use.

PSID

Path set ID.

Source

IP address of the headend router.

TunID

The ID assigned to the tunnel that the sub-LSPs use.

Destination

IP address of the destination router.

P2MP Subgroup ID

A consecutive number assigned to each sub-LSP.

Path Set ID

Path set ID.

OutLabel

The interface from which the label exits and the MPLS label that exits the interface.

FRR OutLabel

The tunnel from which the label exits and the MPLS label that exits the tunnel.

Related Commands

Command

Description

ip path-option

Species an explicit or dynamic path option for a particular destination address in a destination list

show mpls traffic-eng forwarding statistics

To display information about Multiprotocol Label Switching (MPLS) traffic engineering (TE) point-to-pultipoint (P2MP) paths and sublabel switched paths (sub-LSPs), use the show mpls traffic-eng forwarding statistics command in user EXEC or privileged EXEC mode.

show mpls traffic-eng forwarding statistics

Syntax Description

This command has no arguments or keywords.

Command Modes


User EXEC (>)
Privileged EXEC (#)

Command History

Release

Modification

12.2(33)SRE

This command was introduced.

Examples

The following example displays information about MPLS TE P2MP paths and sub-LSPs: 


Router# show mpls traffic-eng forwarding statistics
 
TE P2MP:
Statistics:
    Path Set Creation:            2
    Path Set Deletion:            0
    Input Label Allocation for Path Sets:  2
    Input Label Free:             0
    Current Label Allocated:      2
    PSI Nodes Allocated:          2
    PSI Nodes Freed:              0
    Add sub-LSP to Path Set:      5
    Delete sub-LSP from Path Set  0 (prune: 0, flush: 0)
    Update Path for FRR:          4
  Failures:
    None

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

Table 16. show mpls traffic-eng forwarding statistics Field Descriptions

Field

Description

Path Set Creation

Number of path sets created.

Path Set Deletion

Number of path sets deleted.

Input Label Allocation for Path Sets

Number of input labels allocated for the path sets.

Input Label Free

Number of free input labels.

Current Label Allocated

Number of labels allocated for forwarding.

PSI Nodes Allocated

Number of path set nodes allocated.

PSI Nodes Freed

Number of path set nodes freed

Add sub-LSP to Path Set

Number of sub-LSPs in the path set.

Delete sub-LSP from Path Set

Number of sub-LSPs removed from the path set, either by pruning or flushing.

Update Path for FRR

Number of paths updated for fast reroute.

Failures

Number of path set failures

Related Commands

Command

Description

show mpls traffic-eng forwarding path-set

Display the sub-LSPs that originate from the headend router.

show mpls traffic-eng link-management admission-control

To show which tunnels were admitted locally and their parameters (such as, priority, bandwidth, incoming and outgoing interface, and state), use the show mpls traffic-eng link-management admission-control command in user EXEC or privileged EXEC mode.

show mpls traffic-eng link-management admission-control [interface-name]

Syntax Description

interface-name

(Optional) Displays only tunnels that were admitted on the specified interface.

Command Modes


User EXEC
Privileged EXEC

Command History

Release

Modification

12.0(5)S

This command was introduced.

12.1(3)T

The command output changed. The BW field now shows bandwidth in kBps, and it is followed by the status (reserved or held) of the bandwidth.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show mpls traffic-eng link-management admission-control command: 


Router # show mpls traffic-eng link-management admission-control
System Information::
    Tunnels Count:       4
    Tunnels Selected:    4
TUNNEL ID              UP IF     DOWN IF  PRIORITY STATE           	BW (kbps) 
10.106.0.6 1000_1      AT1/0.2   -        0/0      Resv Admitted   0          
10.106.0.6 2000_1      Et4/0/1   -        1/1      Resv Admitted   0          
10.106.0.6 1_2         Et4/0/1   Et4/0/2  1/1      Resv Admitted   3000       R
10.106.0.6 2_2         AT1/0.2   AT0/0.2  1/1      Resv Admitted   3000       R

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

Table 17. show mpls traffic-eng link-management admission-control Field Descriptions

Field

Description

Tunnels Count

Total number of tunnels admitted.

Tunnels Selected

Number of tunnels to be displayed.

TUNNEL ID

Tunnel identification.

UP IF

Upstream interface that the tunnel used.

DOWN IF

Downstream interface that the tunnel used.

PRIORITY

Setup priority of the tunnel followed by the hold priority.

STATE

Admission status of the tunnel.

BW (kbps)

Bandwidth of the tunnel (in kBps). If an “R” follows the bandwidth number, the bandwidth is reserved. If an “H” follows the bandwidth number, the bandwidth is temporarily being held for a path message.

Related Commands

Command

Description

show mpls traffic-eng link-management advertisements

Displays local link information that MPLS traffic engineering link management is currently flooding into the global traffic engineering topology.

show mpls traffic-eng link-management bandwidth-allocation

Displays current local link information.

show mpls traffic-eng link-management igp-neighbors

Displays IGP neighbors.

show mpls traffic-eng link-management interfaces

Displays per-interface resource and configuration information.

show mpls traffic-eng link-management summary

Displays a summary of link management information.

show mpls traffic-eng link-management advertisements

To display local link information that Multiprotocol Label Switching (MPLS) traffic engineering link management is flooding into the global traffic engineering topology, use the show mpls traffic-eng link-management advertisements command in user EXEC or privileged EXEC mode.

show mpls traffic-eng link-management advertisements

Syntax Description

This command has no arguments or keywords.

Command Modes


User EXEC (>)
Privileged EXEC (#)

Command History

Release

Modification

12.0(5)S

This command was introduced.

12.1(3)T

The command output was modified.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

The output was enhanced to show Internet Gateway Protocol (IGP) recovery status provided by the Cisco IOS Software Modularity: MPLS Layer 3 VPNs feature.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.

Cisco IOS XE Release 3.5S

This command was integrated into Cisco IOS XE Release 3.5S.

Examples

The following is sample output from the show mpls traffic-eng link-management advertisements command: 


Router# show mpls traffic-eng link-management advertisements 
Flooding Status:     ready
Configured Areas:    1
IGP Area[1] ID:: isis level-1
  System Information::
    Flooding Protocol:   ISIS
  Header Information::
    IGP System ID:       0001.0000.0001.00
    MPLS TE Router ID:   10.106.0.6
    Flooded Links:       1
  Link ID:: 0
    Link IP Address:     10.1.0.6
    IGP Neighbor:        ID 0001.0000.0001.02
    Admin. Weight:       10
    Physical Bandwidth:  10000 kbits/sec
    Max Reservable BW:   5000 kbits/sec
    Downstream::
      Reservable Bandwidth[0]:       5000 kbits/sec
      Reservable Bandwidth[1]:       2000 kbits/sec
      Reservable Bandwidth[2]:       2000 kbits/sec
      Reservable Bandwidth[3]:       2000 kbits/sec
      Reservable Bandwidth[4]:       2000 kbits/sec
      Reservable Bandwidth[5]:       2000 kbits/sec
      Reservable Bandwidth[6]:       2000 kbits/sec
      Reservable Bandwidth[7]:       2000 kbits/sec
    Attribute Flags:     0x00000000

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

Table 18. show mpls traffic-eng link-management advertisements Field Descriptions

Field

Description

Flooding Status

Status of the link management flooding system.

Configured Areas

Number of the Interior Gateway Protocol (IGP) areas configured.

IGP Area [1] ID

Name of the first IGP area.

Flooding Protocol

IGP that is flooding information for this area.

IGP System ID

Identification that IGP flooding uses in this area to identify this node.

MPLS TE Router ID

MPLS traffic engineering router ID.

Flooded Links

Number of links that are flooded in this area.

Link ID

Index of the link that is being described.

Link IP Address

Local IP address of this link.

IGP Neighbor

IGP neighbor on this link.

Admin. Weight

Administrative weight associated with this link.

Physical Bandwidth

Link bandwidth capacity (in kBps).

Max Reservable BW

Amount of reservable bandwidth (in kBps) on this link.

Reservable Bandwidth

Amount of bandwidth (in kBps) that is available for reservation.

Attribute Flags

Attribute flags of the link are being flooded.

The following is sample output from the show mpls traffic-eng link-management advertisements command with the enhanced output, which shows the “IGP recovering” status, from the Cisco IOS Software Modularity: MPLS Layer 3 VPNs feature: 


Router# show mpls traffic-eng link-management advertisements 
show mpls traffic-eng link-management advertisements 
Flooding Status:      ready (IGP recovering)
Configured Areas:     1
IGP Area[1] ID::  ospf  area nil
  System Information::
    Flooding Protocol:    OSPF
  Header Information::

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

Table 19. show mpls traffic-eng link-management advertisements Field Descriptions

Field

Description

Flooding Status

Status of the link management flooding system. The notation (IGP recovering) indicates that flooding cannot be determined because an IP routing process restart is in progress.

Configured Areas

Number of the IGP areas configured.

Related Commands

Command

Description

show mpls traffic-eng link-management bandwidth-allocation

Displays current local link information.

show mpls traffic-eng link-management igp-neighbors

Displays IGP neighbors.

show mpls traffic-eng link-management interfaces

Displays per-interface resource and configuration information.

show mpls traffic-eng link-management summary

Displays a summary of link management information.

show mpls traffic-eng link-management bandwidth-allocation

To display current local link information, use the show mpls traffic-eng link-management bandwidth-allocation command in user EXEC or privileged EXEC mode.

show mpls traffic-eng link-management bandwidth-allocation [summary] [interface-type interface-number]

Syntax Description

summary

(Optional) Displays summary of bandwidth allocation.

interface-type interface-number

(Optional) The specified interface that admitted tunnels.

Command Modes


User EXEC (>)
Privileged EXEC (#)

Command History

Release

Modification

12.0(5)S

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

12.2(33)SRC

This command was modified. The summary interface-name interface-number keyword and argument combination was added.

Cisco IOS XE Release 2.6

This command was integrated into Cisco IOS XE Release 2.6.

Usage Guidelines

Advertised information might differ from the current information, depending on how flooding was configured.

Examples

Examples

The following is sample output from the show mpls traffic-eng link-management bandwidth-allocation command for a specified interface: 


Router# show mpls traffic-eng link-management bandwidth-allocation gigabitEthernet 4/0/1
System Information::
    Links Count:         2
    Bandwidth Hold Time: max. 15 seconds
Link ID:: Ge4/0/1 (10.1.0.6)
    Link Status:
      Physical Bandwidth:  10000 kbits/sec
      Max Reservable BW:   5000 kbits/sec (reserved:0% in, 60% out)
      BW Descriptors:      1
      MPLS TE Link State:  MPLS TE on, RSVP on, admin-up, flooded
      Inbound Admission:   reject-huge
      Outbound Admission:  allow-if-room
      Admin. Weight:       10 (IGP)
      IGP Neighbor Count:  1
      Up Thresholds:       15 30 45 60 75 80 85 90 95 96 97 98 99 100 (default)
      Down Thresholds:     100 99 98 97 96 95 90 85 80 75 60 45 30 15 (default)
    Downstream Bandwidth Information (kbits/sec):
      KEEP PRIORITY     BW HELD  BW TOTAL HELD   BW LOCKED  BW TOTAL LOCKED
                  0           0              0           0                0
                  1           0              0        3000             3000
                  2           0              0           0             3000
                  3           0              0           0             3000
                  4           0              0           0             3000
                  5           0              0           0             3000
                  6           0              0           0             3000
                  7           0              0           0             3000

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

Table 20. show mpls traffic-eng link-management bandwidth-allocation Field Descriptions

Field

Description

Links Count

Number of links configured for Multiprotocol Label Switching (MPLS) traffic engineering (TE).

Bandwidth Hold Time

Amount of time, in seconds, that bandwidth can be held.

Link ID

Interface name and IP address of the link being described.

Physical Bandwidth

Link bandwidth capacity (in kilobits per second).

Max Reservable BW

Amount of reservable bandwidth on this link.

BW Descriptors

Number of bandwidth allocations on this link.

MPLS TE Link State

Status of the link’s MPLS traffic engineering-related functions.

Inbound Admission

Link admission policy for incoming tunnels.

Outbound Admission

Link admission policy for outgoing tunnels.

Admin. Weight

Link administrative weight.

IGP Neighbor Count

List of the Interior Gateway Protocol (IGP) neighbors directly reachable over this link.

Up Thresholds

Link’s bandwidth thresholds for allocations.

Down Thresholds

Link’s bandwidth thresholds for deallocations.

KEEP PRIORITY

Priority levels for the link’s bandwidth allocations.

BW HELD

Amount of bandwidth (in kBps) temporarily held at this priority for path messages.

BW TOTAL HELD

Bandwidth held at this priority and those above it.

BW LOCKED

Amount of bandwidth reserved at this priority.

BW TOTAL LOCKED

Bandwidth locked at this priority and those above it.

Examples

The following is sample output from the show mpls traffic-eng link-management bandwidth-allocation summary command for all the configured interfaces: 


Router# show mpls traffic-eng link-management bandwidth-allocation summary
  interface     Intf Max    Intf Avail  Sub Max     Sub Avail
                kbps        kbps        kbps        kbps
  Et0/0         47000       42500       42000       40500
  Et1/0         7500        7500        0           0

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

Table 21. show mpls traffic-eng link-management bandwidth-allocation summary Field Descriptions

Field

Description

interface

Name of the interface.

Intf Max

Maximum amount of bandwidth, in kbps, available on the interface.

Intf Avail

Amount of bandwidth, in kbps, currently available on the interface.

Sub Max

Maximum amount of bandwidth, in kbps, available in the subpool.

Sub Avail

Amount of bandwidth, in kbps, currently available in the subpool.

Examples

The following is sample output from the show mpls traffic-eng link-management bandwidth-allocation summary command for one configured interface: 


Router# show mpls traffic-eng link-management bandwidth-allocation summary Ethernet 0/0
interface     Intf Max    Intf Avail  Sub Max     Sub Avail
                kbps        kbps        kbps        kbps
  Et0/0         47000       42500       42000       40500

See the table above for an explanation of the fields.

Examples

The following is sample output from the show mpls traffic-eng link-management bandwidth-allocation summary command for all the configured interfaces: 


Router# show mpls traffic-eng link-management bandwidth-allocation summary
  interface     Intf Max    BC0 Max     BC0 Avail   BC1 Max     BC1 Avail
                kbps        kbps        kbps        kbps        kbps
  Et0/0         45000       40000       37000       30000       28500
  Et1/0         0           0           0           0           0

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

Table 22. show mpls traffic-eng link-management bandwidth-allocation summary Field Descriptions

Field

Description

interface

Name of the interface.

Intf Max

Maximum amount of bandwidth, in kbps, available on the interface.

BC0 Max

Maximum amount of bandwidth, in kbps, available in the global pool.

BC0 Avail

Amount of bandwidth, in kbps, currently available in the global pool.

BC1 Max

Maximum amount of bandwidth, in kbps, available in the subpool.

BC1 Avail

Amount of bandwidth, in kbps, currently available in the subpool.

Related Commands

Command

Description

show mpls traffic-eng link-management advertisements

Displays local link information currently being flooded by MPLS traffic engineering link management into the global traffic engineering topology.

show mpls traffic-eng link-management igp-neighbors

Displays IGP neighbors.

show mpls traffic-eng link-management interfaces

Displays per-interface resource and configuration information.

show mpls traffic-eng link-management summary

Displays a summary of link management information.

show mpls traffic-eng link-management igp-neighbors

To display Interior Gateway Protocol (IGP) neighbors, use the show mpls traffic-eng link-management igp-neighbors command in user EXEC or privileged EXEC mode.

show mpls traffic-eng link-management igp-neighbors [interface-type number | igp-id {isis isis-address | ospf ospf-id} | ip ip-address]

Syntax Description

interface-type number

(Optional) Specifies the interface type and number for which the IGP neighbors are displayed.

igp-id

(Optional) Displays the IGP neighbors that are using a specified IGP identification.

isis isis-address

(Optional) Displays the specified IS-IS neighbor when you display neighbors by IGP ID.

ospf ospf-id

(Optional) Displays the specified OSPF neighbor when you display neighbors by IGP ID.

ip ip-address

(Optional) Displays the IGP neighbors that are using a specified IGP IP address.

Command Modes


User EXEC (>)
Privileged EXEC (#)

Command History

Release

Modification

12.0(5)S

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

12.4(24)T

This command was modified in a release earlier than Cisco IOS Release 12.4(24)T. The interface-type and number arguments were added.

Examples

The following is sample output from the show mpls traffic-eng link-management igp-neighbors command: 


Router# show mpls traffic-eng line-management igp-neighbors
 
Link ID::  Et0/2
    Neighbor ID:  0000.0024.0004.02 (area: isis level-1, IP: 10.0.0.0)
Link ID::  PO1/0/0
    Neighbor ID:  0000.0026.0001.00 (area: isis level-1, IP: 172.16.1.2)

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

Table 23. show mpls traffic-eng link-management igp-neighbors Field Descriptions

Field

Description

Link ID

Link by which the neighbor is reached.

Neighbor ID

IGP identification information for the neighbor.

Related Commands

Command

Description

show mpls traffic-eng link-management advertisements

Displays local link information currently being flooded by MPLS traffic engineering link management into the global traffic engineering topology.

show mpls traffic-eng link-management bandwidth-allocation

Displays current local link information.

show mpls traffic-eng link-management interfaces

Displays per-interface resource and configuration information.

show mpls traffic-eng link-management summary

Displays a summary of link management information.

show mpls traffic-eng link-management interfaces

To display interface resource and configuration information, use the show mpls traffic-eng link-management interfaces command in user EXEC or privileged EXEC mode.

show mpls traffic-eng link-management interfaces [interface-name]

Syntax Description

interface-name

(Optional) Displays information only for the specified interface.

Command Modes


User EXEC (>)
Privileged EXEC (#)

Command History

Release

Modification

12.0(5)S

This command was introduced.

12.1(3)T

The command output was modified.

12.2(28)SB

The command output was enhanced to display the Shared Risk Link Group (SRLG) membership of links.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.

Cisco IOS XE Release 3.5S

This command was integrated into Cisco IOS XE Release 3.5S.

Usage Guidelines

Use this command to display resource and configuration information for all configured interfaces.

Examples

The following is sample output from the show mpls traffic-eng link-management interfaces command: 


Router# show mpls traffic-eng link-management interfaces Et4/0/1
System Information::
    Links Count:         2
Link ID:: Et4/0/1 (10.1.0.6)
    Link Status:
      Physical Bandwidth:  10000 kbits/sec
      Max Reservable BW:   5000 kbits/sec (reserved:0% in, 60% out)
      MPLS TE Link State:  MPLS TE on, RSVP on, admin-up, flooded
      Inbound Admission:   reject-huge
      Outbound Admission:  allow-if-room
      Admin. Weight:       10 (IGP)
      IGP Neighbor Count:  1
      IGP Neighbor:        ID 0001.0000.0001.02, IP 10.0.0.0 (Up)
      Flooding Status for each configured area [1]:
      IGP Area[1]: isis level-1: flooded

The following is sample output from the show mpls traffic-eng link-management interfaces command when SRLGs are configured: 


Router# show mpls traffic-eng link-management interfaces pos3/1 
System Information::
    Links Count:         11
Link ID:: PO3/1 (10.0.0.33)
    Link Status:
      SRLGs:               1 2
      Physical Bandwidth:  2488000 kbits/sec
      Max Res Global BW:   20000 kbits/sec (reserved:0% in, 0% out)
      Max Res Sub BW:      5000 kbits/sec (reserved:0% in, 0% out)
      MPLS TE Link State:  MPLS TE on, RSVP on, admin-up, flooded
      Inbound Admission:   allow-all
      Outbound Admission:  allow-if-room
      Admin. Weight:       10 (IGP)
      IGP Neighbor Count:  1
      IGP Neighbor:        ID 0000.0000.0004.00, IP 10.0.0.34 (Up)
      Flooding Status for each configured area [1]: 
      IGP Area[1]: isis level-2: flooded

The table below describes the significant fields shown in the displays.

Table 24. show mpls traffic-eng link-management interfaces Field Descriptions

Field

Description

Links Count

Number of links that were enabled for use with Multiprotocol Label Switching (MPLS) traffic engineering.

Link ID

Index of the link.

SRLGs

The SRLGs to which the link belongs.

Physical Bandwidth

Link’s bandwidth capacity, in kBps.

Max Reservable BW

Amount of reservable bandwidth, in kb/s, on this link.

Max Res Global BW

Amount of reservable bandwidth, in kb/s, available for the global pool.

Max Res Sub BW

Amount of reservable bandwidth, in kb/s, available for the subpool.

MPLS TE Link State

The status of the MPLS link.

Inbound Admission

Link admission policy for inbound tunnels.

Outbound Admission

Link admission policy for outbound tunnels.

Admin. Weight

Administrative weight associated with this link.

IGP Neighbor Count

Number of Interior Gateway Protocol (IGP) neighbors directly reachable over this link.

IGP Neighbor

IGP neighbor on this link.

Flooding Status for each configured area

Flooding status for the specified configured area.

Related Commands

Command

Description

show mpls traffic-eng link-management advertisements

Displays local link information being flooded by MPLS traffic engineering link management into the global traffic engineering topology.

show mpls traffic-eng link-management bandwidth-allocation

Displays current local link information.

show mpls traffic-eng link-management igp-neighbors

Displays IGP neighbors.

show mpls traffic-eng link-management summary

Displays a summary of link management information.

show mpls traffic-eng link-management summary

To display a summary of link management information, use the show mpls traffic-eng link-management summary command in user EXEC or privileged EXEC mode.

show mpls traffic-eng link-management summary [interface-name]

Syntax Description

interface-name

Specific interface for which information will be displayed.

Command Modes


User EXEC
Privileged EXEC

Command History

Release

Modification

12.0(5)S

This command was introduced.

12.1(3)T

The command output was modified.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

The output was enhanced to display Internet Gateway Protocol (IGP) recovery status provided by the Cisco IOS Software Modularity: MPLS Layer 3 VPNs feature.

Examples

The following is sample output from the show mpls traffic-eng link-management summary command: 


Router# show mpls traffic-eng link-management summary
System Information::
    Links Count:         2
    Flooding System:     enabled
IGP Area ID:: isis level-1
    Flooding Protocol:   ISIS
    Flooding Status:     data flooded
    Periodic Flooding:   enabled (every 180 seconds)
    Flooded Links:       1
    IGP System ID:       0001.0000.0001.00
    MPLS TE Router ID:   10.106.0.6
    IGP Neighbors:       1
Link ID:: Et4/0/1 (10.1.0.6)
    Link Status:
      Physical Bandwidth:  10000 kbits/sec
      Max Reservable BW:   5000 kbits/sec (reserved:0% in, 60% out)
      MPLS TE Link State:  MPLS TE on, RSVP on, admin-up, flooded
      Inbound Admission:   reject-huge
      Outbound Admission:  allow-if-room
      Admin. Weight:       10 (IGP)
      IGP Neighbor Count:  1
Link ID:: AT0/0.2 (10.42.0.6)
    Link Status:
      Physical Bandwidth:  155520 kbits/sec
      Max Reservable BW:   5000 kbits/sec (reserved:0% in, 0% out)
      MPLS TE Link State:  MPLS TE on, RSVP on
      Inbound Admission:   allow-all
      Outbound Admission:  allow-if-room
      Admin. Weight:       10 (IGP)
      IGP Neighbor Count:  0

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

Table 25. show mpls traffic-eng link-management summary Field Descriptions

Field

Description

Links Count

Number of links configured for Multiprotocol Label Switching (MPLS) traffic engineering.

Flooding System

Enable status of the MPLS traffic engineering flooding system.

IGP Area ID

Name of the IGP area being described.

Flooding Protocol

IGP being used to flood information for this area.

Flooding Status

Status of flooding for this area.

Periodic Flooding

Status of periodic flooding for this area.

Flooded Links

Number of links that were flooded.

IGP System ID

IGP for this node associated with this area.

MPLS TE Router ID

MPLS traffic engineering router ID for this node.

IGP Neighbors

Number of reachable IGP neighbors associated with this area.

Link ID

Interface name and IP address of the link being described.

Physical Bandwidth

Link bandwidth capacity (in kBps).

Max Reservable BW

Amount of reservable bandwidth (in kBps) on this link.

MPLS TE Link State

Status of the link’s MPLS traffic engineering-related functions.

Inbound Admission

Link admission policy for incoming tunnels.

Outbound Admission

Link admission policy for outgoing tunnels.

Admin. Weight

Link administrative weight.

IGP Neighbor Count

List of the IGP neighbors directly reachable over this link.

The following is sample output from the show mpls traffic-eng link-management summary command with the enhanced output, which shows the “IGP recovering” status, from the Cisco IOS Software Modularity: MPLS Layer 3 VPNs feature: 


Router# show mpls traffic-eng link-management summary
System Information::
    Links Count:          3
    Flooding System:      enabled (IGP recovering)
IGP Area ID::  ospf  area nil
    Flooding Protocol:    OSPF
    Flooding Status:      data flooded
    Periodic Flooding:    enabled (every 180 seconds)
    Flooded Links:        0

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

Table 26. show mpls traffic-eng link-management summary Field Descriptions

Field

Description

Links Count

Number of links configured for MPLS traffic engineering.

Flooding System

Status of the MPLS traffic engineering flooding system.

The notation (IGP recovering) indicates that status cannot be determined because an IP routing process restart is in progress.

IGP Area ID

Name of the IGP area being described.

Flooding Protocol

IGP being used to flood information for this area.

Flooding Status

Status of flooding for this area.

Periodic Flooding

Status of periodic flooding for this area.

Flooded Links

Number of links that were flooded.

Related Commands

Command

Description

show mpls traffic-eng link-management advertisements

Displays local link information currently being flooded by MPLS traffic engineering link management into the global traffic engineering topology.

show mpls traffic-eng link-management bandwidth-allocation

Displays current local link information.

show mpls traffic-eng link-management igp-neighbors

Displays IGP neighbors.

show mpls traffic-eng link-management interfaces

Displays per-interface resource and configuration information.

show mpls traffic-eng lsp attributes

To display global label switched path (LSP) attribute lists, use the show mpls traffic-eng lsp attributes command in user EXEC or privileged EXEC mode.

show mpls traffic-eng lsp attributes [name string] [internal]

Syntax Description

name

(Optional) Identifies a specific LSP attribute list.

string

Describes the string argument.

internal

(Optional) Displays LSP attribute list internal information.

Command Default

If no keywords or arguments are specified, all LSP attribute lists are displayed.

Command Modes


User EXEC (>)
Privileged EXEC (#)

Command History

Release

Modification

12.0(26)S

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.

Cisco IOS XE Release 2.1

This command was integrated into Cisco IOS XE Release 2.1.

Usage Guidelines

Use this command to display information about all LSP attribute lists or a specific LSP attribute list.

Examples

The following example shows output from the show mpls traffic-eng lsp attributes command : 


Router# show mpls traffic-eng lsp attributes 
LIST list1
    affinity 0xFF mask 0xFFFFFFFF
    auto-bw collect-bw
    bandwidth 12
    protection fast-reroute bw-protect
    lockdown
    priority 2 2
    record-route LIST 2
  	bandwidth 5000
LIST hipriority
  priority 0 0
!

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

Table 27. show mpls traffic-eng lsp attributes Field Descriptions

Field

Description

LIST

Identifies the LSP attribute list.

affinity

Indicates the LSP attribute that specifies attribute flags for LSP links. Values are 0 or 1.

mask

Indicates which attribute values should be checked.

auto-bw collect-bw

Indicates automatic bandwidth configuration.

protection fast re-route bw-protect

Indicates that the failure protection is enabled.

lockdown

Indicates that the reoptimization for the LSP is disabled.

priority

Indicates the LSP attribute that specifies LSP priority.

record-route

Indicates the record of the route used by the LSP.

bandwidth

Indicates the LSP attribute that specifies LSP bandwidth.

Related Commands

Command

Description

mpls traffic-eng lsp attributes

Creates or modifies an LSP attribute list.

show mpls traffic-eng nsr

To display configuration information for Multiprotocol Label Switching (MPLS) Traffic Engineering (TE) Nonstop Routing (NSR) support, use the show mpls traffic-eng nsr command in privileged EXEC mode.

show mpls traffic-eng nsr [ counters | database { if-autotun | internal | lsp-ac | lsp-frr | lsp-head filter { destination | lsp-id | source | tunnel-id} | pcalc { auto-mesh | nbr | node | srlg} | summary | tun-setup} | oos | summary]

Syntax Description

counters

(Optional) Displays information about the data structures or states that are successfully created or removed, along with errors counts.

database

(Optional) Displays information about write and read databases supporting MPLS TE NSR.

if-autotun

Displays information about the MPLS TE NSR auto-tunnel interfaces.
internal

Displays detailed information about MPLS TE NSR.
lsp-ac

Displays information about the admission control functionality of label switched paths (LSPs).
lsp-frr

Displays information about the Fast Reroute (FRR) functionality of LSPs.

lsp-head

Displays information about LSPs at the head end.

filter

Displays information about the FRR functionality of LSP filter options.
destination

Displays LSP information filtered by the destination address of the tunnel.
lsp-id

Displays LSP information filtered by the LSP ID of the source port.
source

Displays LSP information filtered by the source address of the tunnel.
tunnel-id

Displays LSP information filtered by the tunnel ID.
pcalc

Displays information about the MPLS TE NSR topology database.

auto-mesh

Displays information for the auto-mesh topologies in the database.
nbr

Displays information for the neighbor topologies in the database.
node

Displays information for the topology nodes in the database.
srlg

Displays information for the topology of the Shared Risk Link Group (SRLG).
tune-setup

Displays options to configure the tunnel path setup.
oos

(Optional) Displays information about the out-of-sync databases supporting MPLS TE NSR.

summary

(Optional) Displays a summary of MPLS TE NSR information such as the current TE NSR state (standby-hot / recovering / staling / active), recovery time, and the recovery result (success / failure).

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

Cisco IOS Release XE 3.10S

This command was introduced.

Usage Guidelines

The write and read databases store the data that is used for recovering TE states on a standby device after Stateful Switchover (SSO).

The out of sync databases indicate the devices whose states are not in sync with each other.

Examples

The following example shows how to view information about the data structures or states that are successfully created or removed, along with errors counts: 


enable
 show mpls traffic-eng nsr counters

State: Active

Bulk sync
  Last bulk sync was successful (entries sent: 24)
  initiated: 1

Send timer
  started: 7

Checkpoint Messages (Items) Sent
  Succeeded:      13  (101)
    Acks accepted:13  (101)
    Acks ignored:     (0)
    Nacks:        0  (0)
  Failed:         0  (0)
  Buffer alloc:   13
  Buffer freed:   13

ISSU:
  Checkpoint Messages Transformed:
    On Send:
      Succeeded:         13
      Failed:            0
      Transformations:   0
    On Recv:
      Succeeded:         0
      Failed:            0
      Transformations:   0

  Negotiation:
    Started:              1
    Finished:             1
    Failed to Start:      0
    Messages:
      Sent:
        Send succeeded:   5
        Send failed:      0
        Buffer allocated:        5
        Buffer freed:            0
        Buffer alloc failed:     0
      Received:
        Succeeded:        7
        Failed:           0
        Buffer freed:     7
  Init:
    Succeeded:            1
    Failed:               0

  Session Registration:
    Succeeded:            0
    Failed:               0

  Session Unregistration:
    Succeeded:            0
    Failed:               0

Errors:
  None

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

Table 28. show mpls traffic-eng nsr counters Field Descriptions

Field

Description

Bulk sync

Specifies the status of the counters' last bulk synchronization attempt.

Send timer

Specifies the time lapse since the timer that counts the sent entries was started.

Checkpoint Messages

Specifies the information about the error checkpoint messages, such as the number of the messages sent, number of acknowledgments received, number of messages that failed to reach, and the buffer status.

ISSU

Specifies information about the Cisco IOS In-Service Software Upgrade (ISSU) clients, such as the checkpoint message status, negotiation message status, session registration, and so on.

Errors

Lists errors encountered during checkpointing and negotiations.

Examples

The following example shows how to view internal information pertaining to the write and read databases supporting MPLS TE NSR: 



Device# show mpls traffic-eng nsr database internal

Write DB:
                    Checkpointed
   Entry Type       or Ack-Pending  Send-Pending
     PCALC Node                  0             0
     PCALC Link                  0             0
     PCALC Auto-Mes              0             0
     PCALC SRLG                  0             0
     lm_tunnel_t                 0             0
     NSR LSP FRR                 0             0
     nsr_if_autotun              0             0
     nsr_tspvif_set              0             0
     nsr_slsp_head               0             0

Read DB:
   Entry Type        Checkpointed
     PCALC Node                 5
     PCALC Link                12
     PCALC Auto-Mesh            0
     PCALC SRLG                 0
     lm_tunnel_t                5
     NSR LSP FRR                0
     nsr_if_autotun             0
     nsr_tspvif_setup           3
     nsr_slsp_head              5

TE NSR Sequence Bulk Sync List:
Entries: 0; next avail seq num: 132

TE NSR Sequence State Creation List:
Entries: 30; next expected seq num: 132
   Seq Num: 7  EntryPtr: 0x5A03B208
     Type: PCALC Node  Action: Add  Bundle Seq #: 1
   Seq Num: 8  EntryPtr: 0x5A0B8B38
     Type: PCALC Link  Action: Add  Bundle Seq #: 2
   Seq Num: 9  EntryPtr: 0x5A0B8DA0
     Type: PCALC Link  Action: Add  Bundle Seq #: 2
   Seq Num: 10  EntryPtr: 0x59FF1BB0
     Type: PCALC Node  Action: Add  Bundle Seq #: 1
   Seq Num: 11  EntryPtr: 0x5A0B9008
     Type: PCALC Link  Action: Add  Bundle Seq #: 2
   Seq Num: 32  EntryPtr: 0x586F2A50
     Type: PCALC Node  Action: Add  Bundle Seq #: 4
   Seq Num: 33  EntryPtr: 0x5949FC58
     Type: PCALC Link  Action: Add  Bundle Seq #: 5
   Seq Num: 34  EntryPtr: 0x5949FEC0
     Type: PCALC Link  Action: Add  Bundle Seq #: 5
   Seq Num: 60  EntryPtr: 0x5725BC30
     Type: lm_tunnel_t  Action: Add  Bundle Seq #: 12
   Seq Num: 61  EntryPtr: 0x5725BE00
     Type: nsr_tspvif_setup  Action: Add  Bundle Seq #: 12
   Seq Num: 62  EntryPtr: 0x59FC9E80
     Type: nsr_slsp_head  Action: Add  Bundle Seq #: 12
   Seq Num: 79  EntryPtr: 0x59296190
     Type: lm_tunnel_t  Action: Add  Bundle Seq #: 16
   Seq Num: 80  EntryPtr: 0x59296360
     Type: nsr_tspvif_setup  Action: Add  Bundle Seq #: 16
   Seq Num: 81  EntryPtr: 0x571EB7F8
     Type: nsr_slsp_head  Action: Add  Bundle Seq #: 16
   Seq Num: 98  EntryPtr: 0x5A04B770
     Type: lm_tunnel_t  Action: Add  Bundle Seq #: 20
   Seq Num: 99  EntryPtr: 0x59296108
     Type: nsr_tspvif_setup  Action: Add  Bundle Seq #: 20
   Seq Num: 100  EntryPtr: 0x57258670
     Type: nsr_slsp_head  Action: Add  Bundle Seq #: 20
   Seq Num: 101  EntryPtr: 0x5A060348
     Type: lm_tunnel_t  Action: Add  Bundle Seq #: 20
   Seq Num: 102  EntryPtr: 0x5A03B2B0
     Type: nsr_slsp_head  Action: Add  Bundle Seq #: 20
   Seq Num: 103  EntryPtr: 0x5B1F12B0
     Type: lm_tunnel_t  Action: Add  Bundle Seq #: 20
   Seq Num: 104  EntryPtr: 0x5A03B400
     Type: nsr_slsp_head  Action: Add  Bundle Seq #: 20
   Seq Num: 121  EntryPtr: 0x57258358
     Type: PCALC Node  Action: Add  Bundle Seq #: 21
   Seq Num: 122  EntryPtr: 0x59FAF080
     Type: PCALC Link  Action: Add  Bundle Seq #: 22
   Seq Num: 123  EntryPtr: 0x59502AC0
     Type: PCALC Link  Action: Add  Bundle Seq #: 23
   Seq Num: 124  EntryPtr: 0x594AE918
     Type: PCALC Link  Action: Add  Bundle Seq #: 21
   Seq Num: 125  EntryPtr: 0x59502120
     Type: PCALC Link  Action: Add  Bundle Seq #: 23
   Seq Num: 126  EntryPtr: 0x59FAFA20
     Type: PCALC Link  Action: Add  Bundle Seq #: 22
   Seq Num: 129  EntryPtr: 0x59FC9CC0
     Type: PCALC Node  Action: Add  Bundle Seq #: 24
   Seq Num: 130  EntryPtr: 0x5A060518
     Type: PCALC Link  Action: Add  Bundle Seq #: 24
   Seq Num: 131  EntryPtr: 0x59FAFC88
     Type: PCALC Link  Action: Add  Bundle Seq #: 24

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

Table 29. show mpls traffic-eng nsr database Field Descriptions

Field

Description

Write DB

Specifies information about the write databases.

Read DB

Specifies information about the read databases

TE NSR Sequence Bulk Sync List

Specifies information about the sequence of the databases queued up in the list for bulk synchronization. The information includes the number of entries lined up and the next available sequence number.

TE NSR Sequence State Creation List

Specifies information about the list of sequence states being created.

Examples

The following example shows how to verify information pertaining to the out-of-sync databases supporting MPLS TE NSR: 


enable
 show mpls traffic-eng nsr oos
		Tunnel: 4000
  Time created: 02/20/13-12:03:13
  Time synced: 02/20/13-12:03:14
  Key:
    Source:                    10.1.0.1
    Destination:               10.2.0.1
    ID:                        4000
    Ext Tun ID:                10.1.0.1
    Instance:                  4
    Slsp p2mp ID:              0
    Slsp p2mp subgroup ID:     0
    Slsp p2mp subgroup origin: 0

  RSVP States:
    Signal:       Unknown
    Fast-Reroute: Disabled
    Delete State: True

  TE States:
    Signal:       Unknown
    Fast-Reroute: Disabled
    Delete State: True

  Update History:
    Total number of updates: 2

      Update Time: 02/20/13-12:03:13
        Client Updating: RSVP
        Update State:
          Signal:       Unknown
          Fast-Reroute: Unknown
          Delete State: True

      Update Time: 02/20/13-12:03:14
        Client Updating: TE
        Update State:
          Signal:       Unknown
          Fast-Reroute: Unknown
          Delete State: True

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

Table 30. show mpls traffic-eng nsr oos Field Descriptions

Field

Description

Key

Specifies information such as the source address, destination address, tunnel ID, database instance, LSP origin, and so on, of the out-of-sync databases.

RSVP States

Specifies information about the Resource Reservation Protocol (RSVP) states of the out-of-sync databases.

TE States

Specifies information about the TE states of the out-of-sync databases.

Update History

Specifies information about the update log of the out of sync databases. The information includes the update time, the client that is getting updated, and the state of the update (Signal/Fast-Reroute/Deletion).

Examples

The following example shows how to view a summary of MPLS TE NSR information: 


enable
 show mpls traffic-eng nsr summary
		State:
  Graceful-Restart: Disabled
  HA state: Active
  Checkpointing: Allowed
  Messages:
  	Send timer: not running (Interval: 1000 msec)
  	Items sent per Interval: 200
  	CF buffer size used: 3968

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

Table 31. show mpls traffic-eng nsr summary Field Descriptions

Field

Description

State

Specifies information, if any, about the state of the write and read databases and the out of sync databases.

Graceful-Restart

Specifies information on whether Graceful Restart (GR) is Enabled or Disabled.

HA State

Specifies information about the MPLS high-availability states of the databases.

Checkpointing

Specifies information on whether checkpointing is allowed or prohibited.

Messages

Specifies different summary messages of the databases. The information displayed includes the send timer count, the number of items sent per interval, and the buffer size of the Checkpoint Facility (CF).

Related Commands

Command

Description

mpls traffic-eng nsr

Enables MPLS TE NSR support for a device.

show mpls traffic-eng process-restart iprouting

To display the status of IP routing and Multiprotocol Label Switching (MPLS) traffic engineering synchronization after an IP routing process restart, use the show mpls traffic-eng process-restart iprouting command in user EXEC or privileged EXEC mode.

show mpls traffic-eng process-restart iprouting

Syntax Description

This command has no arguments or keywords.

Command Modes


User EXEC
Privileged EXEC

Command History

Release

Modification

12.2(33)SXH

This command was introduced.

Usage Guidelines

This command displays information about the synchronization between the IP routing process and MPLS TE that you can provide to your technical support representative when you are reporting a problem.

All counters are set to zero when the system process initializes and are not reset no matter how often the IP routing process restarts.

The following is sample output from the show mpls traffic-eng process-restart iprouting command when an IP routing process has restarted normally: 


Router# show mpls traffic-eng process-restart iprouting
IP Routing Restart Statistics:
  Current State: NORM
  Flushing State: IDLE
State Entered       Count     Timestamp            Timestamp            Timestamp 
INIT                1         05/10/06-13:07:01
NORM                3         05/10/06-13:07:10    05/10/06-13:10:45   05/10/06-13:11:5
NORM-SPCT           0
AWAIT-CFG           2         05/10/06-13:10:32    05/10/06-13:11:45 
CFG                 2         05/10/06-13:10:32    05/10/06-13:11:45
CMPL-FLSH           0 
NCMPL-FLSH          2         05/10/06-13:10:32    05/10/06-13:11:45 
NCMPL-FLSHD         2         05/10/06-13:10:32     05/10/06-13:11:45
Stuck State         Count     Timestamp             Timestamp          Timestamp
No Stuck states encountered
Counter             Count     Timestamp             Timestamp          Timestamp
Reg Succeed         40       05/10/06-13:11:51      05/10/06-13:11:45  05/10/06-13:11:45
Reg Fail             0 
Incarnation          5       05/10/06-13:11:45      05/10/06-13:11:45  05/10/06-13:10:37
Flushing             2        05/10/06-13:10:32      05/10/06-13:11:45

The table below describes the normal output of the significant fields shown in the display. You should contact your technical support representative if your display has values other than those described in the table.

Table 32. show mpls traffic-eng process-restart iprouting Field Descriptions

Field

Description

Current State

This indicates the restart status. NORM indicates that routing convergence has occurred and that TE and the Internet Gateway Protocols (IGPs) have synchronized.

Flushing State

This indicates the flushing state. It should indicate IDLE.

Stuck State

This indicates the stuck state. The Count column should indicate that no stuck state has been encountered.

Reg Fail

This indicates a registry failure. The Count column should indicate 0.

Related Commands

Command

Description

debug mpls traffic-eng process-restart

Displays information about process restarts for reporting to your technical support representative.

show mpls traffic-eng topology

To display the Multiprotocol Label Switching (MPLS) traffic engineering global topology as currently known at the node, use the show mpls traffic-eng topology command in user EXEC or privileged EXEC mode.

show mpls traffic-eng topology [area area-id | level-1 | level-2] [ip-address [brief | internal] | igp-id {isis nsapaddr | ospf ip-address [network | router]} [brief] | srlg]

Syntax Description

area

(Optional) Restricts output to an Open Shortest Path First (OSPF) area.

area-id

The OSPF area ID. The range is from 0 to 4294967295.

level-1

(Optional) Restricts output to a System-to-Intermediate System (IS-IS) level-1.

level-2

(Optional) Restricts output to an IS-IS level-2.

ip-address

(Optional) The node by the IP address (router identifier to interface address).

brief

(Optional) Provides a less detailed version of the topology.

internal

(Optional) Specifies to use the internal format.

igp-id

(Optional) Specifies the node by Interior Gateway Protocol (IGP) router identifier.

isis nsapaddr

Specifies the node by router identification if using Intermediate IS-IS.

ospf ip-address

Specifies the node by router identifier if using OSPF.

network

(Optional) Specifies the node type as network.

router

(Optional) Specifies the node type as router.

srlg

(Optional) Displays Shared Risk Link Groups (SRLG) membership for each link in a topology.

Command Modes


User EXEC (>)
Privileged EXEC (#)

Command History

Release

Modification

12.0(5)S

This command was introduced.

12.0(11)ST

This command was modified. The single “Reservable” column was replaced by two columns: one each for “global pool” and for “subpool.”

12.2(8)T

This command was integrated into Cisco IOS Release 12.2(8)T.

12.2(28)SB

This command was modified. The area , level-1 , and level-2 keywords were added.

12.2(33)SRA

This command was modified and integrated into Cisco IOS Release 12.2(33)SRA. The srlg keyword was added.

12.2SX

This command was integrated into Cisco IOS Release 12.2SX. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Cisco IOS XE Release 3.5S

This command was integrated into Cisco IOS XE Release 3.5S.

Examples

The following example shows output from the show mpls traffic-eng topology command: 


Router# show mpls traffic-eng topology
My_System_id: 0000.0000.0001.00 (isis 1 level-2)
My_System_id: 10.10.10.10 (ospf 100 area 0)
My_BC_Model_Type: MAM 
Signalling error holddown: 10 sec Global Link Generation 56
IGP Id: 0000.0000.0001.00, MPLS TE Id: 10.10.10.10 Router Node  (isis 1 level-2)
  Link[0]:Point-to-Point, Nbr IGP Id:0000.0000.0002.00, Nbr Node Id:6, gen:56
      Frag Id:0, Intf Address:10.2.2.1, Intf Id:0
       Nbr Intf Address:10.2.2.2, Nbr Intf Id:0
      TE Metric:10, IGP Metric:10, Attribute Flags:0x0
      Switching Capability:, Encoding:
      BC Model ID:MAM
      Physical BW:155520 (kbps), Max Reservable BW:1000 (kbps)
      BC0:600 (kbps) BC1:400 (kbps)
                     Total Allocated   Reservable
                     BW (kbps)         BW (kbps)
                     ---------------   -----------
        TE-class[0]:            0            600
        TE-class[1]:            0            400
        TE-class[2]:            0              0
        TE-class[3]:            0              0
        TE-class[4]:            0            600
        TE-class[5]:            0            400
        TE-class[6]:            0              0
        TE-class[7]:            0              0
  Link[1]:Point-to-Point, Nbr IGP Id:0000.0000.0002.00, Nbr Node Id:6, gen:56
      Frag Id:0, Intf Address:10.1.1.1, Intf Id:0
       Nbr Intf Address:10.1.1.2, Nbr Intf Id:0
      TE Metric:10, IGP Metric:10, Attribute Flags:0x0
      Switching Capability:, Encoding:
      BC Model ID:MAM
      Physical BW:155520 (kbps), Max Reservable BW:1000 (kbps)
      BC0:600 (kbps) BC1:400 (kbps)
                     Total Allocated   Reservable
                     BW (kbps)         BW (kbps)
                     ---------------   -----------
        TE-class[0]:           10            590
        TE-class[1]:            0            400
        TE-class[2]:            0              0
        TE-class[3]:            0              0
        TE-class[4]:            0            600
        TE-class[5]:            0            400
        TE-class[6]:            0              0
        TE-class[7]:            0              0

The table below describes significant fields shown in the display.

Table 33. show mpls traffic-eng topology Field Descriptions

Field

Description

My_System_id

Unique identifier of the IGP.

My_BC_Model_Type: MAM

Bandwidth constraints model of the local node: either Maximum Allocation Model (MAM) or Russian Dolls Model (RDM).

Signalling error holddown:

Link hold-down timer configured to handle path error events to exclude link from topology.

IGP Id

Identification of the advertising router.

MPLS TE Id

Unique MPLS traffic engineering node identifier.

Intf Id:

Interface identifier.

Router Node

Type of node.

Nbr IGP Id

Neighbor IGP router identifier.

Intf Address

The interface address of the link.

Nbr Intf Address:

IP address of the neighbor interface.

BC Model ID:

Bandwidth Constraints Model ID: RDM or MAM.

gen

Generation number of the link-state packet (LSP). This internal number is incremented when any new LSP is received.

Frag Id

IGP link-state advertisement (LSA) fragment identifier.

TE Metric

TE cost of the link.

IGP Metric

IGP cost of the link.

Attribute Flags

The requirements on the attributes of the links that the traffic crosses.

Physical BW

Physical line rate.

Max Reservable BW

Maximum amount of bandwidth, in kilobits per second (kb/s), that can be reserved on a link.

Total Allocated

Amount of bandwidth, in kb/s, allocated at that priority.

Reservable

Amount of available bandwidth, in kb/s, reservable for that TE-Class for two pools: BC0 (formerly called “global”) and BC1 (formerly called “sub”).

Related Commands

Command

Description

show mpls traffic-eng tunnels

Displays information about tunnels.

show mpls traffic-eng topology path

To show the properties of the best available path to a specified destination that satisfies certain constraints, use the show mpls traffic-eng topology path command in user EXEC or privileged EXEC mode.

show mpls traffic-eng topology path {tunnel-interface [destination address] | destination address} [bandwidth value] [priority value [value] ] [affinity value [mask mask]]

Syntax Description

tunnel-interface

Name of an MPLS traffic engineering interface (for example, Tunnel1) from which default constraints should be copied.

destination address

(Optional) IP address specifying the path’s destination.

bandwidth value

(Optional) Bandwidth constraint. The amount of available bandwidth that a suitable path requires. This overrides the bandwidth constraint obtained from the specified tunnel interface. You can specify any positive number.

priority value [value]

(Optional) Priority constraints. The setup and hold priorities used to acquire bandwidth along the path. If specified, this overrides the priority constraints obtained from the tunnel interface. Valid values are from 0 to 7.

affinity value

(Optional) Affinity constraints. The link attributes for which the path has an affinity. If specified, this overrides the affinity constraints obtained from the tunnel interface.

mask mask

(Optional) Affinity constraints. The mask associated with the affinity specification.

Command Modes


User EXEC
Privileged EXEC

Command History

Release

Modification

12.1(3)T

This command was introduced.

12.0(10)ST

This command was integrated into Cisco IOS Release 12.0(10)ST.

12.0(22)S

This command was integrated into Cisco IOS Release 12.0(22)S.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

The specified constraints override any constraints obtained from a reference tunnel.

Examples

The following is sample output from the show mpls traffic-eng topology path command: 


Router # show mpls traffic-eng topology path Tunnel1 bandwidth 1000
Query Parameters:
  Destination:10.112.0.12
    Bandwidth:1000
   Priorities:1 (setup), 1 (hold)
     Affinity:0x0 (value), 0xFFFF (mask)
Query Results:
  Min Bandwidth Along Path:2000 (kbps)
  Max Bandwidth Along Path:5000 (kbps)
  Hop  0:10.1.0.6       :affinity 00000000, bandwidth 2000 (kbps)
  Hop  1:10.1.0.10      :affinity 00000000, bandwidth 5000 (kbps)
  Hop  2:10.43.0.10     :affinity 00000000, bandwidth 2000 (kbps)
  Hop  3:10.112.0.12

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

Table 34. show mpls traffic-eng topology path Field Descriptions

Field

Description

Destination

IP address of the path’s destination.

Bandwidth

Amount of available bandwidth that a suitable path requires.

Priorities

Setup and hold priorities used to acquire bandwidth.

Affinity

Link attributes for which the path has an affinity.

Min Bandwidth Along Path

Minimum amount of bandwidth configured for a path.

Max Bandwidth Along Path

Maximum amount of bandwidth configured for a path.

Hop

Information about each link in the path.

show mpls traffic-eng tunnels

To display information about tunnels, use the show mpls traffic-eng tunnels command in user EXEC or privileged EXEC mode.

show mpls traffic-eng tunnels [ [attributes list-name] | [destination address] | [down] | [interface type number] | [name name] | [name-regexp reg-exp] | [property {auto-tunnel {backup | mesh | primary} | backup-tunnel | fast-reroute}] | [role {all | head | middle | remote | tail}] | [source-id {ipaddress [tunnel-id]}] | [suboptimal constraints {current | max | none}] | [statistics] | [summary] | [up]]accounting | backup | brief | protection

Syntax Description

attributes list-name

(Optional) Restricts the display to tunnels that use a matching attributes list.

destination address

(Optional) Restricts the display to tunnels destined to the specified IP address.

down

(Optional) Displays tunnels that are not active.

interface

(Optional) Displays information for the specified interface.

type

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

number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

name name

(Optional) Displays the tunnel with the specified string. The tunnel string is derived from the interface description, if specified; otherwise, it is the interface name. The tunnel string is included in the signaling message so that it is available at all hops.

name-regexp regexp

(Optional) Displays tunnels whose descriptions match the specified regular expression.

property

(Optional) Displays tunnels with the specified property.

auto-tunnel

Displays information about autotunnels.

backup

Displays information about Fast Reroute (FRR) protection provided by each tunnel selected by other options specified with this command. The information includes the physical interface protected by the tunnel, the number of TE label switched packets (LSPs) (that is, tunnels) protected, and the bandwidth protected.

mesh

Displays information about auto-tunnel mesh tunnel interfaces.

primary

Displays information about auto-tunnel primary tunnel interfaces.

backup-tunnel

Displays information about the FRR protection provided by each tunnel selected by other options specified with this command. The information includes the physical interface protected by the tunnel, the number of TE label switched packets (LSPs) (that is, tunnels) protected, and the bandwidth protected.

fast-reroute

Selects FRR-protected MPLS TE tunnels originating, transmitting, or terminating on this router.

role

Restricts the display to tunnels with the indicated role (all, head, middle, tail, or remote).

all

Displays all tunnels.

head

Displays tunnels with their head at this router.

middle

Displays tunnels with a midpoint at this router.

remote

Displays tunnels with their head at some other router; this is a combination of middle and tail .

tail

Displays tunnels with a tail at this router.

source-id

(Optional) Restricts the display to tunnels with a matching source IP address or tunnel number.

ipaddress

Source IP address.

tunnel-id

Tunnel number. The range is from 0 to 65535.

suboptimal

(Optional) Displays information about tunnels using a suboptimal path.

constraints

Specifies constraints for finding the best comparison path.

current

Displays tunnels whose path metric is greater than the current shortest path, constrained by the tunnel’s configured options. Selected tunnels would have a shorter path if they were reoptimized immediately.

max

Displays information for the specified tunneling interface.

none

Displays tunnels whose path metric is greater than the shortest unconstrained path. Selected tunnels have a longer path than the Interior Gateway Protocol’s (IGP) shortest path.

statistics

(Optional) Displays event counters for one or more tunnels.

summary

(Optional) Displays event counters accumulated for all tunnels.

up

(Optional) Displays tunnels if the tunnel interface is up. Tunnel midpoints and tails are typically up or not present.

accounting

(Optional) Displays accounting information (the rate of the traffic flow) for tunnels.

brief

(Optional) Specifies a format with one line per tunnel.

protection

(Optional) Displays information about the protection provided by each tunnel selected by other options specified with this command. The information includes whether protection is configured for the tunnel, the protection (if any) provided to the tunnel by this router, and the bandwidth protected.

Command Default

General information about each MPLS TE tunnel known to the router is displayed.

Command Modes


User EXEC (>)
Privileged EXEC (#)

Command History

Release

Modification

12.0(5)S

This command was introduced.

12.1(3)T

Input and output interface information was added to the new brief form of the output. The suboptimal and interface keywords were added to the nonbrief format. The nonbrief, nonsummary formats contain the history of the LSP selection.

12.0(10)ST

This command was integrated into Cisco IOS Release 12.0(10)ST.

12.0(22)S

The property and protection keywords were added. The command is supported on the Cisco 10000 series routers.

12.2(18)S

The following keywords were added: accounting , attributes , name-regexp , property , and auto-tunnel . The property backup keyword was changed to property backup-tunnel .

12.2(18)SXD1

This command was integrated into Cisco IOS Release 12.2(18)SXD1.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.

12.2(33)SRE

This command was modified. The detail and dest-mode keywords were added. The output was updated to display MPLS TE point-to-multipoint (P2MP) information.

The command output was enhanced to include the configuration and status when a path option list is configured for backup path options. The output also shows information about tunnels configured with autoroute announce.

15.0(1)S

This command was modified. The command output was enhanced to include formation about P2MP LSPs and sub-LSPs.

12.2(50)SY

This command was integrated into Cisco IOS Release 12.2(50)SY.

Cisco IOS XE Release 3.5S

This command was integrated into Cisco IOS XE Release 3.5S.

15.2(2)SNG

This command was integrated into Cisco ASR 901 Series Aggregation Services Routers.

Usage Guidelines

To select the tunnels for which information is displayed, use the auto-tunnel , backup-tunnel , attributes , destination ,interface , name , name-regexp , property , role , source-id , suboptimal constraints , up , and down keywords singly or combined.

To select the type of information displayed about the selected tunnels, use the accounting , backup , protection , statistics , and summary keywords.

The auto-tunnel , backup-tunnel , and property keywords display the same information, except that the property keyword restricts the display to autotunnels, backup tunnels, or tunnels that are Fast Reroute-protected.

The name-regexp keyword displays output for each tunnel whose name contains a specified string. For example, if there are tunnels named iou-100-t1, iou-100-t2, and iou-100-t100, the show mpls traffic-eng tunnels name-regexp iou-100 command displays output for the three tunnels whose name contains the string iou-100.

If you specify the name keyword, there is command output only if the command name is an exact match, for example, iou-100-t1.

The nonbrief and nonsummary formats of the output contain the history of the LSP selection.

The “Reroute Pending” State Changes in Cisco IOS Release 12.2(33)SRE

In releases earlier than Cisco IOS Release 12.2(33)SRE, MPLS TE P2P tunnels display “reroute pending” during reoptimization until the “delayed clean” status of the old path is complete. During the “delayed clean” process, the command output displays the following status: 


Router# show mpls traffic-eng tunnels tunnel 534
Name: Router_t534                        (Tunnel534) Destination: 10.30.30.8
    Status:
      Admin: up         Oper: up     Path: valid       Signalling: connected 
      path option 10, type explicit PRIMARY_TO_8 (Basis for Setup, path weight 30)
  !!! path option 10 delayed clean in progress
  !!!     Change in required resources detected: reroute pending
          Currently Signalled Parameters:
            Bandwidth: 300      kbps (Global)  Priority: 7  7   Affinity: 0x0/0xFFFF
            Metric Type: TE (default)

In Cisco IOS Release 12.2(33)SRE and later releases, P2P and P2MP MPLS TE tunnels display “reroute pending” during reoptimization until the new path is used for forwarding. The “reroute pending” status is not displayed during the delayed clean operation. There is no change to data forwarding or tunnel creation. You might see the “reroute pending” status for a shorter time. In the following example, the “reroute pending” message appears, but the “delayed clean” message does not. 


Router# show mpls traffic-eng tunnels tunnel 534
  Name: Router_t534                        (Tunnel534) Destination: 10.30.30.8
    Status:
      Admin: up         Oper: up     Path: valid       Signalling: connected
      path option 10, type explicit PRIMARY_TO_8 (Basis for Setup, path weight 30)
            Change in required resources detected: reroute pending
          Currently Signalled Parameters:
            Bandwidth: 300      kbps (Global)  Priority: 7  7   Affinity: 0x0/0xFFFF
            Metric Type: TE (default)

Examples

The following is sample output from the show mpls traffic-eng tunnels brief command. It displays brief information about every MPLS TE tunnel known to the router. 


Router# show mpls traffic-eng tunnels brief 
Signalling Summary:
    LSP Tunnels Process:           running
    RSVP Process:                  running
    Forwarding:                    enabled
    Periodic reoptimization:       every 3600 seconds, next in 1706 seconds
TUNNEL NAME                      DESTINATION      UP IF     DOWN IF   STATE/PROT
Router_t1                        10.112.0.12      -         PO4/0/1   up/up     
Router_t2                        10.112.0.12      -         unknown   up/down   
Router_t3                        10.112.0.12      -         unknown   admin-down
Router_t1000                     10.110.0.10      -         unknown   up/down   
Router_t2000                     10.110.0.10      -         PO4/0/1   up/up     
Displayed 5 (of 5) heads, 0 (of 0) midpoints, 0 (of 0) tails

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

Table 35. show mpls traffic-eng tunnels Field Descriptions

Field

Description

LSP Tunnels Process

Status of the LSP tunnels process.

RSVP Process

Status of the Resource Reservation Protocol (RSVP) process.

Forwarding

Status of forwarding (enabled or disabled).

Periodic reoptimization

Schedule for periodic reoptimization (in seconds).

TUNNEL NAME

Name of the interface that is configured at the tunnel head.

DESTINATION

Identifier of the tailend router.

UP IF

Upstream interface that the tunnel used.

DOWN IF

Downstream interface that the tunnel used.

STATE/PROT

For tunnel heads, the value is admin-down, up, or down. For nonheads, the value is signaled.

The following is sample output from the show mpls traffic-eng tunnels property fast-reroute brief command. It displays brief information about all MPLS TE tunnels acting as Fast Reroute backup tunnels (property backup-tunnel ) for interfaces on the router. 


Router# show mpls traffic-eng tunnels property fast-reroute brief
Signalling Summary:
    LSP Tunnels Process:            running
    RSVP Process:                   running
    Forwarding:                     enabled
    Periodic reoptimization:        every 3600 seconds, next in 2231 seconds
    Periodic FRR Promotion:         every 300 seconds, next in 131 seconds
    Periodic auto-bw collection:    disabled
TUNNEL NAME                      DESTINATION      UP IF     DOWN IF   STATE/PROT
Router_t2000                     10.110.0.10      -         PO4/0/1   up/up     
Router_t2                        10.112.0.12      -         unknown   up/down   
Router_t3                        10.112.0.12      -         unknown   admin-down
Displayed 3 (of 9) heads, 0 (of 1) midpoints, 0 (of 0) tails

The following is sample output from the show mpls traffic-eng tunnels backup command. This command selects every MPLS TE tunnel known to the router and displays information about the Fast Reroute protection each selected tunnels provides for interfaces on this router; the command does not generate output for tunnels that do not provide Fast Reroute protection of interfaces on this router. 


Router# show mpls traffic-eng tunnels backup
Router_t578
  LSP Head, Tunnel578, Admin: up, Oper: up
  Src 10.55.55.55, Dest 10.88.88.88, Instance 1
  Fast Reroute Backup Provided: 
    Protected I/fs: PO1/0, PO1/1, PO3/3
    Protected lsps: 1
    Backup BW: any pool unlimited; inuse: 100 kbps
Router_t5710
  LSP Head, Tunnel5710, Admin: admin-down, Oper: down
  Src 10.55.55.55, Dest 192.168.7.7, Instance 0
  Fast Reroute Backup Provided: 
    Protected I/fs: PO1/1
    Protected lsps: 0
    Backup BW: any pool unlimited; inuse: 0 kbps
Router_t5711
  LSP Head, Tunnel5711, Admin: up, Oper: up
  Src 10.55.55.55, Dest 10.7.7.7, Instance 1
  Fast Reroute Backup Provided: 
    Protected I/fs: PO1/0
    Protected lsps: 2
    Backup BW: any pool unlimited; inuse: 6010 kbps

The following is sample output from the show mpls traffic-eng tunnels property fast-reroute protection command. This command selects every MPLS TE tunnel known to the router that was signaled as a Fast Reroute-protected LSP (property fast-reroute ) and displays information about the protection this router provides each selected tunnel. 


Router# show mpls traffic-eng tunnels property fast-reroute protection
Router_t1
  LSP Head, Tunnel1, Admin: up, Oper: up
  Src 10.55.55.55, Dest 10.88.88.88, Instance 25
  Fast Reroute Protection: Requested
    Outbound: FRR Ready
      Backup Tu5711 to LSP nhop
        Tu5711: out I/f: PO1/1, label: implicit-null
      LSP signalling info:
        Original: out I/f: PO1/0, label: 12304, nhop: 10.1.1.7
        With FRR: out I/f: Tu5711, label: 12304
      LSP bw: 6000 kbps, Backup level: any unlimited, type: any pool
Router_t2
  LSP Head, Tunnel2, Admin: up, Oper: up
  Src 10.55.55.55, Dest 10.88.88.88, Instance 2
  Fast Reroute Protection: Requested
    Outbound: FRR Ready
      Backup Tu578 to LSP nhop
        Tu578: out I/f: PO1/0, label: 12306
      LSP signalling info:
        Original: out I/f: PO3/3, label: implicit-null, nhop: 10.3.3.8
        With FRR: out I/f: Tu578, label: implicit-null
      LSP bw: 100 kbps, Backup level: any unlimited, type: any pool
r9_t1
  LSP Midpoint, signalled, connection up
  Src 10.9.9.9, Dest 10.88.88.88, Instance 2347
  Fast Reroute Protection: Requested
    Inbound:  FRR Inactive
      LSP signalling info:
        Original: in I/f: PO1/2, label: 12304, phop: 10.205.0.9
    Outbound: FRR Ready
      Backup Tu5711 to LSP nhop
        Tu5711: out I/f: PO1/1, label: implicit-null
      LSP signalling info:
        Original: out I/f: PO1/0, label: 12305, nhop: 10.1.1.7
        With FRR: out I/f: Tu5711, label: 12305
      LSP bw: 10 kbps, Backup level: any unlimited, type: any pool

The following is sample output from the show mpls traffic-eng tunnels tunnel command. This command displays information about just a single tunnel. 


Router# show mpls traffic-eng tunnels tunnel 1
Name: swat76k1_t1                         (Tunnel1) Destination: 10.0.0.4
   Status:
     Admin: admin-down Oper: down   Path: not valid   Signalling: Down
     path option 1, type explicit gi7/4-R4
   Config Parameters:
     Bandwidth: 0        kbps (Global)  Priority: 7  7   Affinity: 0x0/0xFFFF
     Metric Type: TE (default)
     AutoRoute:  disabled  LockDown: disabled  Loadshare: 0        bw-based
     auto-bw: disabled
   Shortest Unconstrained Path Info:
     Path Weight: 2 (TE)
     Explicit Route: 10.1.0.1 10.1.0.2 172.0.0.1 192.0.0.4
   History:
     Tunnel:
       Time since created: 13 days, 52 minutes
       Number of LSP IDs (Tun_Instances) used: 0 swat76k1#
swat76k1#sh mpls traf tun property ?
   auto-tunnel    auto-tunnel created tunnels
   backup-tunnel  Tunnels used as fast reroute
   fast-reroute   Tunnels protected by fast reroute

The following is sample output from the show mpls traffic-eng tunnels accounting command. This command displays the rate of traffic flow for tunnels. 


Router# show mpls traffic-eng tunnels accounting
Tunnel1 (Destination 10.103.103.103; Name iou-100_t1)
 5 minute output rate 0 kbits/sec, 0 packets/sec
Tunnel2 (Destination 10.103.103.103; Name iou-100_t2)
 5 minute output rate 0 kbits/sec, 0 packets/sec Tunnel100 (Destination 10.101.101.101; Name iou-100_t100)
 5 minute output rate 0 kbits/sec, 0 packets/sec Totals for 3 Tunnels
 5 minute output rate 0 kbits/sec, 0 packets/sec

When the MPLS TE P2MP feature is configured, the show mpls traffic-eng tunnels command categorizes the output as follows:

  • P2P tunnels/LSPs

  • P2MP tunnels

  • P2MP sub-LSPs

The following show mpls traffic-eng tunnels brief command displays P2MP tunnel and sub-LSP information: 


Router# show mpls traffic-eng tunnels brief
Signalling Summary:
   LSP Tunnels Process:            running
   Passive LSP Listener:           running
   RSVP Process:                   running
   Forwarding:                     enabled
   Periodic reoptimization:        every 60 seconds, next in 5 seconds
   Periodic FRR Promotion:         Not Running
   Periodic auto-bw collection:    disabled
P2P TUNNELS/LSPs:
TUNNEL NAME                      DESTINATION      UP IF     DOWN IF   STATE/PROT
p2p-LSP                          10.2.0.1         -         Se2/0     up/up    
Displayed 2 (of 2) heads, 0 (of 0) midpoints, 0 (of 0) tails
P2MP TUNNELS:
                        DEST    CURRENT
INTERFACE   STATE/PROT UP/CFG TUNID LSPID
Tunnel2     up/up      3/10   2     1
Tunnel5     up/down    1/10   5     2
Displayed 2 (of 2) P2MP heads
P2MP SUB-LSPS:
SOURCE          TUNID LSPID   DESTINATION     SUBID     ST UP IF    DOWN IF
10.1.0.1        2     1       10.2.0.1        1         up head     Se2/0  
10.1.0.1        2     1       10.3.0.199      2         up head     Et2/0   
10.1.0.1        2     1       19.4.0.1        2         up head     s2/0   
10.1.0.1        2     2       1 9.4.0.1       2         up head     s2/0   
10.1.0.1        5     2       10.5.0.1        7         up head     e2/0   
100.100.100.100 1     3       200.200.200.200 1         up ge2/0    s2/0
100.100.100.100 1     3       10.1.0.1        1         up e2/0     tail
Displayed 7 P2MP sub-LSPs:
          5 (of 5) heads, 1 (of 1) midpoints, 1 (of 1) tails

The following is sample output from the show mpls traffic-eng tunnels command for a tunnel named t1. The output displays the following:

  • An adjustment threshold of 5 percent

  • An overflow limit of 4

  • An overflow threshold of 25 percent

  • An overflow threshold exceeded by 1 


Router# show mpls traffic-eng tunnels name t1
 
Name:tagsw4500-9_t1 (Tunnel1) Destination:10.0.0.4
 Status:
  Admin:up Oper:up Path:valid Signalling:connected
  path option 1, type explicit pbr_south (Basis for Setup, path weight 30)
  path option 2, type dynamic
Config Parameters:
 Bandwidth:13 kbps (Global) Priority:7 7 Affinity:0x0/0xFFFF
 AutoRoute: disabled LockDown:disabled Loadshare:13 bw-based
 auto-bw:(300/265) 53 Bandwidth Requested: 13
   Adjustment threshold: 5%
   Overflow Limit: 4  Overflow Threshold: 25%  
  Overflow Threshold Crossed: 1
  Sample Missed: 1 Samples Collected: 1
Active Path Option Parameters:
  State: dynamic path option 1 is active
  BandwidthOverride: disabled  LockDown: disabled  Verbatim: disabled
 InLabel  :  -
 OutLabel : Serial3/0, 18
 RSVP Signalling Info:
   Src 10.0.0.1, Dst 10.0.0.4, Tun_Id 2, Tun_Instance 2
  RSVP Path Info:
   My Address: 10.105.0.1
   Explicit Route: 10.105.0.2 104.105.0.1 10.0.0.4
   Record   Route:   NONE
   Tspec: ave rate=13 kbits, burst=1000 bytes, peak rate=13 kbits
 Record   Route:   NONE
   Tspec: ave rate=13 kbits, burst=1000 bytes, peak rate=13 kbits
  RSVP Resv Info:
   Record   Route:   NONE
   Fspec: ave rate=13 kbits, burst=1000 bytes, peak rate=13 kbits
  Shortest Unconstrained Path Info:
   Path Weight: 128 (TE)
   Explicit Route: 10.105.0.2 104.105.0.1 10.0.0.4
History:
    Tunnel:
      Time since created: 7 days, 4 hours, 42 minutes
      Time since path change: 54 seconds
      Number of LSP IDs (Tun_Instances) used: 2
      SSO recovered <full|partial> (2 subLSP recovered, 0 failed)
    Current LSP: [ID: 2]
      Uptime: 54 seconds
      Selection: SSO recovered
    Prior LSP: [ID: 1]
      Removal Trigger: signalling shutdown

The following sample output from the show mpls traffic-eng tunnels command for Cisco IOS Release 12.2(33)SRE shows path protection information. This command displays information about a single tunnel. 


Router# show mpls traffic-eng tunnels tunnel 1
Name: iou-100_t2 (Tunnel2) Destination: 10.10.0.2 
 Status:
  Admin: up Oper: up Path: valid Signalling: connected
  path option 10, type explicit primary1 (Basis for Setup, path weight 10)
  Path Protection: 0 Common Link(s), 0 Common Node(s)
  path protect option 10, type list name secondary-list
   Inuse path-option 10, type explicit secondary1 (Basis for Protect, path weight 20) 
Config Parameters:
 Bandwidth: 0 kbps (Global) Priority: 7 7 Affinity: 0x0/0xFFFF
 Metric Type: TE (default)
 AutoRoute announce: enabled LockDown: disabled Loadshare: 0 bw-based
 auto-bw: disabled
Active Path Option Parameters:
 State: explicit path option 10 is active
 BandwidthOverride: disabled LockDown: disabled Verbatim: disabled 
InLabel : - 
OutLabel : Ethernet7/0, implicit-null
RSVP Signalling Info:
 Src 100.100.100.100, Dst 10.10.0.2, Tun_Id 2, Tun_Instance 188
RSVP Path Info:
 My Address: 10.1.0.1 
 Explicit Route: 10.1.0.2 10.10.0.2 
 Record Route: NONE
 Tspec: ave rate=0 kbits, burst=1000 bytes, peak rate=0 kbits
RSVP Resv Info:
 Record Route: NONE
 Fspec: ave rate=0 kbits, burst=1000 bytes, peak rate=0 kbits
Shortest Unconstrained Path Info:
 Path Weight: 10 (TE)
 Explicit Route: 10.1.0.1 10.1.0.2 10.10.0.2 
History:
    Tunnel:
      Time since created: 7 days, 4 hours, 42 minutes
      Time since path change: 54 seconds
      Number of LSP IDs (Tun_Instances) used: 2
      SSO recovered <full|partial> (2 subLSP recovered, 0 failed)
    Current LSP: [ID: 2]
      Uptime: 54 seconds
      Selection: SSO recovered
    Prior LSP: [ID: 1]
      Removal Trigger: signalling shutdown

The following sample output from the show mpls traffic-eng tunnels command for Cisco IOS Release 12.2(33)SRE shows autoroute destination information. 


Router# show mpls traffic-eng tunnel tunnel 109
Name: PE-7_t109                    (Tunnel109) Destination: 10.0.0.9
 Status:
  Admin: up   Oper: up   Path: valid Signalling: connected
  path option 1, type explicit to_109 (Basis for Setup, path weight 64)
  path option 20, type explicit to_109_alt
Config Parameters:
 Bandwidth: 0   kbps (Global   Priority: 7  7   Affinity: 0x0/0xFFFF
 Metric Type: TE (default)
 Autoroute announce: enabled LockDown: disabled   Loadshare: 0    bx-based
 auto-bw: disabled
 AutoRoute destination: enabled

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

Table 36. show mpls traffic-eng tunnels Field Descriptions

Field

Description

LSP Tunnels Process

Status of the LSP tunnels process.

RSVP Process

Status of the RSVP process.

Forwarding

Status of forwarding (enabled or disabled).

Periodic reoptimization

Schedule for periodic reoptimization (in seconds).

TUNNEL NAME

Name of the interface configured at the tunnel head.

DESTINATION

Identifier of the tailend router.

UP IF

Upstream interface that the tunnel used.

DOWN IF

Downstream interface that the tunnel used.

STATE/PROT

For tunnel heads, admin-down, up, or down. For nonheads, signaled.

Adjustment threshold

Configured threshold. This field is displayed only if a threshold is explicitly configured.

Overflow Limit Overflow Threshold

These fields are displayed only if an overflow limit was specified in the tunnel mpls traffic-eng auto-bw command. The tunnel resizes before the end of the sampling interval if the output rate exceeds the current bandwidth by the percentage specified in the overflow threshold, or if the output rate exceeds the number of times specified in the overflow limit.

Overflow Threshold Crossed

Number of times the output rate exceeded the overflow threshold in consecutive collection intervals. This value is reset at the beginning of the automatic bandwidth sampling interval.

Number of Auto-bw Adjustment resize requests

Number of times the tunnel was resized because an output rate exceeded the adjustment threshold. This field is displayed only if the number is greater than zero and if automatic bandwidth is enabled on the tunnel. This counter is reset each time automatic bandwidth is enabled on the tunnel. You can clear this counter at any time by entering the clear mpls traffic-eng auto-bw timer command.

Time since last Auto-bw Adjustment resize request

The amount of time (in minutes and seconds) since the last bandwidth adjustment.

Number of Auto-bw Overflow resize requests

The number of times (in seconds) the tunnel was resized because an overflow limit was exceeded. This field is displayed only if the number is greater than zero and if an overflow limit is enabled on the tunnel. This counter is reset each time automatic bandwidth is enabled on the tunnel. You can clear this counter at any time by entering the clear mpls traffic-eng auto-bw timer command.

Time since last Auto-bw Overflow resize request

The amount of time (in seconds) since the tunnel was resized because an overflow limit was exceeded.

Related Commands

Command

Description

mpls traffic-eng reoptimize timers frequency

Controls the frequency with which tunnels with established LSPs are checked for better LSPs.

mpls traffic-eng tunnels (global configuration)

Enables MPLS traffic engineering tunnel signaling on a device.

mpls traffic-eng tunnels (interface configuration

Enables MPLS traffic engineering tunnel signaling on an interface.

show mpls traffic-eng tunnels statistics

To display event counters for one or more Multiprotocol Label Switching (MPLS) traffic engineering (TE) tunnels, use the show mpls traffic-eng tunnels statistics command in user EXEC or privileged EXEC mode.

show mpls traffic-eng tunnels [tunnel tunnel-name] statistics [summary]

Syntax Description

tunnel tunnel-name

(Optional) Displays event counters accumulated for the specified tunnel.

summary

(Optional) Displays event counters accumulated for all tunnels.

Command Default

If you enter the command without any keywords, the command displays the event counters for every MPLS traffic engineering tunnel interface configured on the router.

Command Modes

User EXEC (>)

Privileged EXEC mode (#)

Command History

Release

Modification

12.0(14)ST

This command was introduced.

12.2(11)S

This command was integrated into Cisco IOS Release 12.2(11)S.

12.0(22)S

This command was integrated into Cisco IOS Release 12.0(22)S.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.

12.2(33)SRE

This command was modified. The output was updated to display MPLS TE point-to-multipoint (P2MP) information.

Cisco IOS XE Release 3.12S

This command was modified. The output was updated to display reoptimization statistics information.

Usage Guidelines

A label switching router (LSR) maintains counters for each MPLS traffic engineering tunnel headend that counts significant events for the tunnel, such as state transitions for the tunnel, changes to the tunnel path, and various signaling failures. You can use the show mpls traffic-eng tunnels statistics command to display these counters for a single tunnel, for every tunnel, or for all tunnels (accumulated values). Displaying the counters is often useful for troubleshooting tunnel problems.

Examples

The following are examples of output from the show mpls traffic-eng tunnels statistics command: 


Device# show mpls traffic-eng tunnels tunnel tunnel1001 statistics
 
Tunnel1001 (Destination 10.8.8.8; Name Router_t1001)
  Management statistics:
    Path:	25 no path, 1 path no longer valid, 0 missing ip exp path
	5 path changes
    State:	3 transitions, 0 admin down, 1 oper down
  Signalling statistics:
    Opens:	2 succeeded, 0 timed out, 0 bad path spec
	0 other aborts
    Errors:	0 no b/w, 0 no route, 0 admin
	0 bad exp route, 0 rec route loop, 0 other

Device# show mpls traffic-eng tunnels statistics

Tunnel1001 (Destination 10.8.8.8; Name Router_t1001)
  Management statistics:
    Path:	25 no path, 1 path no longer valid, 0 missing ip exp path
	5 path changes
    State:	3 transitions, 0 admin down, 1 oper down
  Signalling statistics:
    Opens:	2 succeeded, 0 timed out, 0 bad path spec
	0 other aborts
    Errors:	0 no b/w, 0 no route, 0 admin
	0 bad exp route, 0 rec route loop, 0 other

. . .


Tunnel7050 (Destination 10.8.8.8; Name Router_t7050)
  Management statistics:
    Path: 	19 no path, 1 path no longer valid, 0 missing ip exp path
	3 path changes
    State: 	3 transitions, 0 admin down, 1 oper down
  Signalling statistics:
    Opens: 	2 succeeded, 0 timed out, 0 bad path spec
	0 other aborts
    Errors:	0 no b/w, 0 no route, 0 admin
	0 bad exp route, 0 rec route loop, 0 other

. . .


Device# show mpls traffic-eng tunnels statistics summary

	Management statistics:
    Path:	2304 no path, 73 path no longer valid, 0 missing ip exp path
	432 path changes
    State:	300 transitions, 0 admin down, 100 oper down
	Signalling statistics:
    Opens:	200 succeeded, 0 timed out, 0 bad path spec
	0 other aborts
    Errors:	0 no b/w, 18 no route, 0 admin
	0 bad exp route, 0 rec route loop, 0 other

The following show mpls traffic-eng tunnels statistics command displays reoptimization statistics information under label switched path (LSP) activations. The text ‘No better/reopt path that satisfies tunnel constraints’ indicates a scenario in which an attempt to reoptimize the tunnel and check for the availability of a better path is performed. If there is no better path, there will be no new activation. 


Device# show mpls traffic-eng tunnels statistics

Tunnel0 (Destination 10.4.0.1;Name p2mp-1_t0)
  Management statistics:
    Path:   6 no path, 0 path no longer valid, 0 missing ip exp path
            1 path changes, 8 path lookups
            0 protection pathoption_list errors
            0 invalid inuse popt in pathoption list
            0 loose path reoptimizations, triggered by PathErrors
    State:  1 transitions, 0 admin down, 0 oper down
  Signalling statistics:
    Opens:  1 succeeded, 0 timed out, 0 bad path spec
            0 other aborts
      LSP Activations: 1 succeeded
        Last Failure: No path that satisfy tunnel constraints
        Failures stats:
          6: No path that satisfy tunnel constraints
        Reoptimization stats:
          1: No better/reopt path that satisfies tunnel constraints
    Errors: 0 no b/w, 0 no route, 0 admin, 0 remerge detected
            0 bad exp route, 0 rec route loop, 0 frr activated
            0 bad label, 0 other

The following show mpls traffic-eng tunnels statistics command displays status information about P2MP path and LSPs for Tunnel 100: 


Device# show mpls traffic-eng tunnels statistics

Tunnel100 (Name p2mp-1_t100)
  Management statistics:
    Path:   0 no path, 0 path no longer valid, 0 missing ip exp path
            97 path changes, 306 path lookups 
            0 protection pathoption_list errors 
            0 invalid inuse popt in pathoption list 
            0 loose path reoptimizations, triggered by PathErrors
    State:  1 transitions, 0 admin down, 0 oper down
  Signalling statistics:
    Opens:  1 succeeded, 0 timed out, 0 bad path spec
            0 other aborts
      LSP Activations: 97 succeeded 
        Last Failure: No path that satisfy tunnel constraints 
        Failures stats: 
          5: No path that satisfy tunnel constraints 
    Errors: 0 no b/w, 288 no route, 0 admin, 0 remerge detected
            0 bad exp route, 0 rec route loop, 0 frr activated
            0 other

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

Table 37. show mpls traffic-eng tunnels statistics Field Descriptions

Field

Description

Tunnel 1001

Name of the tunnel interface.

Destination

IP address of the tunnel tailend.

Name