Cisco IOS Multiprotocol Label Switching Command Reference
show mpls oam echo statistics through snmp-server host

Table Of Contents

show mpls oam echo statistics

show mpls platform

show mpls prefix-map

show mpls static binding ipv4

show mpls static binding ipv4 vrf

show mpls static crossconnect

show mpls traffic tunnel backup

show mpls traffic-eng autoroute

show mpls traffic-eng auto-tunnel mesh

show mpls traffic-eng destination list

show mpls traffic-eng fast-reroute database

show mpls traffic-eng fast-reroute log reroutes

show mpls traffic-eng forwarding-adjacency

show mpls traffic-eng forwarding path-set

show mpls traffic-eng forwarding statistics

show mpls traffic-eng link-management admission-control

show mpls traffic-eng link-management advertisements

show mpls traffic-eng link-management bandwidth-allocation

show mpls traffic-eng link-management igp-neighbors

show mpls traffic-eng link-management interfaces

show mpls traffic-eng link-management summary

show mpls traffic-eng lsp attributes

show mpls traffic-eng process-restart iprouting

show mpls traffic-eng topology

show mpls traffic-eng topology path

show mpls traffic-eng tunnels

sshow mpls traffic-eng tunnels statistics

show mpls traffic-eng tunnels summary

show mpls ttfib

show running interface auto-template

show running-config vrf

show tech-support mpls

show vrf

show xconnect

show xtagatm cos-bandwidth-allocation

show xtagatm cross-connect

show xtagatm vc

snmp mib mpls vpn

snmp-server community

snmp-server enable traps (MPLS)

snmp-server enable traps mpls ldp

snmp-server enable traps mpls rfc ldp

snmp-server enable traps mpls rfc vpn

snmp-server enable traps mpls traffic-eng

snmp-server enable traps mpls vpn

snmp-server group

snmp-server host

status (pseudowire class)

status redundancy

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 the show 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) 

Table 111 describes the significant fields shown in the displays.

Table 111 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 | statistics [reset] | vpn-vlan-mapping}

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.

statistics

Displays information about the RP-control plane statistics.

reset

(Optional) Resets the statistics counters.

vpn-vlan-mapping

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


Defaults

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.


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:

Router# 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
Router# 

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

Router# show mpls platform eompls

Interface        VLAN
GigabitEthernet  101
FastEthernet6/1  2022
Router# 

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

Router# show mpls platform gbte-tunnels

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

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

Router# 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:

Router# show mpls platform statistics

              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
Router# 

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

Router# show mpls platform statistics 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
Router#

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

Router# show mpls platform vpn-vlan-mapping

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
Router#

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

Table 112 describes the fields shown in the display.

Table 112 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 ipv4

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

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

Syntax Description

prefix {mask-length | mask}

(Optional) The labels for a specific prefix.

nexthop address

(Optional) Specifies the labels for a next hop address.

local | remote

(Optional) Specifies the local (incoming) or remote (outgoing) labels to be displayed.

nexthop address

(Optional) Specifies 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.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.


Usage Guidelines

If you do not specify any optional arguments, the show mpls static binding ipv4 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, the show 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

Related Commands

Command
Description

mpls static binding ipv4

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


show mpls static binding ipv4 vrf

To display configured Multiprotocol Label Switching (MPLS) virtual routing and forwarding (VRF)-aware static bindings, use the show mpls static binding ipv4 vrf command in privileged EXEC mode.

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

Syntax Description

vpn-name

The static label bindings for the specified VPN routing and forwarding instance.

prefix {mask-length | mask}

(Optional) The labels for a specified prefix.

nexthop address

(Optional) Specifies the labels for a next hop address.

local | remote

(Optional) Specifies the local (incoming) or remote (outgoing) labels to be displayed.

nexthop address

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


Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(26)S

This command was introduced.

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.


Examples

The following example displays statically assigned label bindings:

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 vrf

Binds a prefix to a local 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) Displays 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 parameters, then all the configured static crossconnects are displayed.

Examples

The following output of 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


Table 113 describes the significant fields shown in the display.

Table 113 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 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 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 tunneltunnel-id

Syntax Description

tunneltunnel-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 tunnel1000

Tunnel1000          Dest: 10.0.0.9        State: Up           
any-pool cfg 100 inuse 0 num_lsps 0
     protects: ATM0.1 

Table 114 describes the significant fields shown in the display.

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

Defaults

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.


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)

Table 115 describes the significant fields shown in the display.

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


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

Table 116 describes the significant fields shown in the display.

Table 116 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 destination list

To display an 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

Table 117 describes the significant fields shown in the display.

Table 117 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 fast-reroute database

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

show mpls traffic-eng fast-reroute database [network [mask | masklength] | labels low label [-high label] | interface ifname [backup-interface ifname] | backup-interface ifname] [state {active | ready | partial | complete}] [role {head | middle}] [detail] [vrf name]

Syntax Description

network

(Optional) IP address of the destination network. This functions as the prefix of the FRR rewrite.

mask

(Optional) Bit combination indicating the portion of the IP address that is being used for the subnet address.

masklength

(Optional) Number of bits in mask of 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

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

ifname

(Optional) Name of the primary outgoing interface.

backup-interface

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

ifname

(Optional) Name of the backup outgoing interface.

state

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

active

The FRR rewrite has been put into the forwarding database (where it can be placed onto appropriate incoming packets).

ready

The FRR rewrite has been created, but has not yet been moved into the forwarding database.

partial

State before the FRR rewrite has been fully created; its backup routing information is still incomplete.

complete

State after the FRR rewrite has been assembled: it is either ready or active.

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.

detail

(Optional) Shows long-form information: 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 Default

The contents of the FRR database are not displayed.

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

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 ouptut was updated to display Multiprotocol Label Switching (MPLS) traffic engineering (TE) point-to-multipoint (P2MP) information.


Examples

The following example shows 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 

Table 118 describes the significant fields shown in the display.

Table 118 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, or active. (These terms are defined above in the "Syntax Description" section).


The following example shows 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 

The following example shows 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

Table 119 describes the significant fields when the detail keyword is used.

Table 119 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 describes a cluster (physical interface):

"10" is the interface's unique IOS-assigned ID number.

":" 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 describes a group:

"51" is the ID number of the backup interface.

":" is followed by the group's physical interface short name.

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


MPLS Traffic Engineering Point-to-Multipoint Fast Reroute Information

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 

Table 120 describes the significant fields shown in the display.

Table 120 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

Command
Description

show mpls traffic-eng fast-reroute log reroutes

Displays contents of 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.

Defaults

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 

Table 121 describes significant fields shown in the display.

Table 121 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 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 


Table 122 describes the significant fields shown in the display.

Table 122 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 consectutive 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 informtion 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

Table 123 describes the significant fields shown in the display.

Table 123 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

Table 124 describes the significant fields shown in the display.

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


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

Table 125 describes the significant fields shown in the display.

Table 125 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::

Table 126 describes the significant fields shown in the display.

Table 126 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 [interface-name | summary [interface-name]]

Syntax Description

interface-name

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

summary interface-name

(Optional) Displays bandwidth usage forthe specified interfaces.


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

The summary interface-name keyword-argument combination was added.


Usage Guidelines

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

Examples

Interface Example

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 Et4/0/1

System Information::
    Links Count:         2
    Bandwidth Hold Time: max. 15 seconds
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)
      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

Table 127 describes the significant fields shown in the display.

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

Field
Description

Links Count

Number of links configured for MPLS traffic engineering.

Bandwidth Hold Time

Amount of time that bandwidth can be held.

Link ID

Interface name and IP address of the link being described.

Physical Bandwidth

Link bandwidth capacity (in bits 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 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.


Summary Example for Regular Traffic Engineering (TE) (or Russian Dolls Model [RDM] DiffServ-aware TE) with Multiple Interfaces

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

Table 128 describes the significant fields shown in the display.

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


Summary Example for Regular Traffic Engineering (TE) (or Russian Dolls Model [RDM] DiffServ-aware TE) with a Single Interface

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 Ethernet0/0

interface     Intf Max    Intf Avail  Sub Max     Sub Avail
                kbps        kbps        kbps        kbps
  Et0/0         47000       42500       42000       40500

See Table 128 for an explanation of the preceding fields.

Summary Example with Specified Interface for Maximum Allocation Model (MAM) DS-TE

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

Table 129 describes the significant fields shown in the display.

Table 129 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 show 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 [igp-id [isis isis-address | ospf ospf-id] | ip A.B.C.D]

Syntax Description

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 A.B.C.D

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


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)

Table 130 describes the significant fields shown in the display.

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


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


Table 131 describes the significant fields shown in the displays.

Table 131 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

Table 132 describes the significant fields shown in the display.

Table 132 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

Table 133 describes the significant fields shown in the display.

Table 133 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 atrribute 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
!

Table 134 describes the significant fields shown in the display.

Table 134 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 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 

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


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

Table 136 describes significant fields shown in the display.

Table 136 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    

Table 137 describes the significant fields shown in the display.

Table 137 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}] [up]] [accounting | 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 the Fast Reroute 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 traffic engineering (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 Fast Reroute 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 traffic engineering (TE) label switched packets (LSPs) (that is, tunnels) protected, and the bandwidth protected.

fast-reroute

Selects Fast Reroute-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.

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, and property 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 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.


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

Table 111 describes the significant fields shown in the display.

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


MPLS Traffic Engineering Fast Reroute Examples

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 the traffic flow for the 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

MPLS Traffic Engineering Point-to-Multipoint Command Examples

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 show mpls traffic-eng tunnels statistics command displays status information about P2MP path and LSPs for Tunnel 100:

Router# 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 following show mpls traffic-eng tunnels summary command displays information about P2MP LSPs and sub-LSPs:

Router# show mpls traffic-eng tunnels statistics

Signalling Summary:
    LSP Tunnels Process:            running
    Passive LSP Listener:           running
    RSVP Process:                   running
    Forwarding:                     enabled
    Periodic reoptimization:        every 3600 seconds, next in 2599 seconds
    Periodic FRR Promotion:         Not Running
    Periodic auto-bw collection:    disabled
    P2P:
      Head: 10 interfaces,   0 active signalling attempts, 0 established
            0 activations,  0 deactivations
            0 SSO recovery attempts, 0 SSO recovered
      Midpoints: 0, Tails: 1
    P2MP:
      Head: 6 interfaces,   3 active signalling attempts, 3 established
            291 sub-LSP activations,  288 sub-LSP deactivations
            97 LSP successful activations,  96 LSP deactivations
            5 LSP failed activations
            SSO: Unsupported
      Midpoints: 0, Tails: 0


The following is sample output from the show mpls traffic-eng tunnels command for a tunnel named t1. The output includes an adjustment threshold of 5 percent, an overflow limit of 4, an overflow threshold of 25 percent, and an overflow threshold exceeded of 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 minutes, 56 seconds
     Time since path change: 7 minutes, 18 seconds
     Number of LSP IDs (Tun_Instances) used: 2
     Number of Auto-bw Adjustment resize requests: 1
     Time since last Auto-bw Adjustment resize request: 1 minutes, 7 seconds
     Number of Auto-bw Overflow resize requests: 1
     Time since last Auto-bw Overflow resize request: 52 seconds
     Current LSP:
      Uptime: 52 seconds
      Selection: reoptimization
    Prior LSP:
ID: path option 1 [1]
  Removal Trigger: configuration changed

The following sample output from the show mpls traffic-eng tunnels tunnel 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: 1 hours, 34 minutes 
  Time since path change: 1 minutes, 50 seconds 
  Number of LSP IDs (Tun_Instances) used: 188 
 Current LSP: 
  Uptime: 1 minutes, 50 seconds 
 Prior LSP: 
  ID: path option 10 [44] 
  Removal Trigger: label reservation removed

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 

Table 139 describes the significant fields shown in the display.

Table 139 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, 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

Resized the tunnel before the end of the sampling interval if the output rate exceeded the current bandwidth by the percent specified in the overflow threshold the number of times specified in the overflow limit. These fields are displayed only if an overflow limit was specified in the tunnel mpls traffic-eng auto-bw command.

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 (configuration)

Enables MPLS traffic engineering tunnel signaling on a device.

mpls traffic-eng tunnels (interface)

Enables MPLS traffic engineering tunnel signaling on an interface.


sshow mpls traffic-eng tunnels statistics

To display event counters for one or more Multiprotocol Label Switching (MPLS) traffic engineering tunnels, use the show mpls traffic-eng tunnels statistics command in user EXEC and 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.


Defaults

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.


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:

Router# 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
Router# 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
Router# 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

Table 140 describes the significant fields shown in the display.

Table 140 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

Internal name for the tunnel, composed of the router name and the tunnel interface number.

Path

Heading for counters for tunnel path events are as follows:

no path—Number of unsuccessful attempts to calculate a path for the tunnel.

path no longer valid—Number of times a previously valid path for the tunnel became invalid.

missing ip exp path—Number of times that attempts to use "obtain a path for the tunnel" failed because no path was configured (and there was no dynamic path option for the tunnel).

path changes—Number of times the tunnel path changed.

State

Heading for counters for tunnel state transitions.

Opens

Heading for counters for tunnel open attempt events.

Errors

Heading for various tunnel signaling errors, such as no bandwidth, no route, admin (preemption), a bad explicit route, and a loop in the explicit route.


Related Commands

Command
Description

clear mpls traffic-eng tunnel counters

Clears the counters for all MPLS traffic engineering tunnels.


show mpls traffic-eng tunnels summary

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

show mpls traffic-eng tunnels summary

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.0(10)ST

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

12.0(22)S

The command output was updated to display periodic Fast Reroute information. The command is supported on the Cisco 10000 series ESRs.

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

The command output was modified to display the number of tunnels that were attempted and successful in being recovered following a failover.

12.4(20)T

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


Usage Guidelines

Use the show mpls traffic-eng tunnels summary command to display the number of tunnel headends that were attempted and successful at being recovered following a stateful switchover (SSO).

Examples

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

Router# show mpls traffic-eng tunnels summary

Signalling Summary:
    LSP Tunnels Process:            running
    Passive LSP Listener:           running
    RSVP Process:                   running
    Forwarding:                     enabled
    Head: 3 interfaces, 3 active signalling attempts, 3 established
          3 activations, 3 deactivations
          3 SSO recovery attempts, 3 SSO recovered
    Midpoints: 1, Tails: 0
    Periodic reoptimization:        every 3600 seconds, next in 873 seconds
    Periodic FRR Promotion:         Not Running
    Periodic auto-bw collection:    every 300 seconds, next in 273 seconds

Table 141 describes the significant fields shown in the display.

Table 141 show mpls traffic-eng tunnels summary Field Descriptions 

Field
Description

LSP Tunnels Process

Multiprotocol Label Switching (MPLS) traffic engineering has or has not been enabled.

Passive LSP Listener

The device listens for LSPs and can terminate them, if desired.

RSVP Process

Resource Reservation Protocol (RSVP) has or has not been enabled. (This feature is enabled as a consequence of MPLS traffic engineering being enabled.)

Forwarding

Indicates whether appropriate forwarding is enabled. (Appropriate forwarding on a router is Cisco Express Forwarding switching.)

Head

Summary information about tunnel heads at this device. Information includes:

interfaces—Number of MPLS traffic engineering tunnel interfaces.

active signalling attempts—Number of LSPs currently successfully signaled or being signaled.

established—Number of LSPs currently signaled.

activations—Number of signaling attempts initiated.

deactivations—Number of signaling attempts terminated.

SSO recovery attempts—Number of MPLS traffic engineering tunnel headend LSPs that were attempted to be recovered following an SSO event.

SSO recovered—Number of MPLS traffic engineering tunnel headend LSPs that were successfully recovered following an SSO event.

Midpoints

Number of midpoints at this device.

Tails

Number of tails at this device.

Periodic reoptimization

Frequency of periodic reoptimization and time (in seconds) until the next periodic reoptimization.

Periodic FRR Promotion

Frequency that scanning occurs to determine if link-state packets (LSPs) should be promoted to better backup tunnels, and time (in seconds) until the next scanning.

Periodic auto-bw collection

Frequency of automatic bandwidth collection and time left (in seconds) until the next collection.


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 (configuration)

Enables MPLS traffic engineering tunnel signaling on a device.

mpls traffic-eng tunnels (interface)

Enables MPLS traffic engineering tunnel signaling on an interface.


show mpls ttfib

To display information about the Multiprotocol Label Switching (MPLS) TTFIB table, use the show mpls ttfib command in EXEC mode.

show mpls ttfib [detail [hardware] | vrf instance [detail]]

Syntax Description

detail

(Optional) Displays detailed information.

hardware

(Optional) Displays detailed hardware information.

vrf instance

(Optional) Displays entries for a specified Virtual Private Network (VPN) routing and forwarding instance (VRF).


Defaults

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(17d)SXB

Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.

12.2(33)SRA

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


Examples

This example shows how to display information about the MPLS TTFIB table:

Router# show mpls ttfib

Local  Outgoing    Packets Tag          LTL   Dest.   Destination    Outgoing 
Tag    Tag or VC   Switched             Index Vlanid  Mac Address    Interface
4116   21          0                    0xE0  1020    0000.0400.0000 PO4/1*
       34          0                    0x132 1019    00d0.040d.380a GE5/3
       45          0                    0xE3  4031    0000.0430.0000 PO4/4
4117   16	         0                    0x132 1019    00d0.040d.380a GE5/3*
       17          0                    0xE0  1020    0000.0400.0000 PO4/1
       18          0                    0xE3  4031    0000.0430.0000 PO4/4
4118   21          0                    0xE0  1020    0000.0400.0000 PO4/1*
       56          0                    0xE3  4031    0000.0430.0000 PO4/4
4119   35          0                    0xE3  4031    0000.0430.0000 PO4/4*
       47          0                    0xE0  1020    0000.0400.0000 PO4/1

show running interface auto-template

To display configuration information for a tunnel's interface, use the show running interface auto-template command in privileged EXEC mode.

show running interface auto-template num

Syntax Description

num

Number of the tunnel interface for which you want to display information.


Command Modes

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.


Usage Guidelines

The space before the num argument is optional.

Examples

The following is output from the show running interface auto-template command:

Router# show running interface auto-template 1

interface auto-template1 
 ip unnumbered Loopback0 
 no ip directed-broadcast 
 no keepalive 
 tunnel destination access-list 1 
 tunnel mode mpls traffic-eng 
 tunnel mpls traffic-eng autoroute announce 
 tunnel mpls traffic-eng path-option 1 dynamic

Table 142 describes the significant fields shown in the display.

Table 142 show running interface auto-template Field Descriptions 

Field
Description

ip unnumbered Loopback0

Indicates the type and number of another interface on which the router has an assigned IP address. It cannot be another unnumbered interface.

no ip directed-broadcast

Indicates that no IP broadcast addresses are used for the autotunnel interface.

no keepalive

Indicates that no keepalives are set for the autotunnel interface.

tunnel destination access-list 1

Indicates that access list 1 is the access list that the template interface will use for obtaining the autotunnel interface destination address.

tunnel mode mpls traffic-eng

Indicates that the mode of the autotunnel is set to Multiprotocol Label Switching (MPLS) for traffic engineering.

tunnel mpls traffic-eng autoroute announce

Indicates that the Interior Gateway Protocol (IGP) should use the tunnel (if the tunnel is up) in its enhanced shortest path first (SPF) calculation.

tunnel mpls traffic-eng path-option 1 dynamic

Indicates that a path option (path-option1) for the label switch router (LSR) for the MPLS traffic engineering (TE) mesh tunnel is configured dynamically.


Related Commands

Command
Description

interface auto-template

Creates the template interface.

tunnel destination access-list

Specifies the access list that the template interface will use for obtaining the mesh tunnel interface destination address.


show running-config vrf

To display the subset of the running configuration of a router that is linked to a specific Virtual Private Network (VPN) routing and forwarding (VRF) instance or to all VRFs configured on the router, use the show running-config vrf command in user EXEC or privileged EXEC mode.

show running-config vrf [vrf-name]

Syntax Description

vrf-name

(Optional) Name of the VRF configuration that you want to display.


Command Default

If you do not specify a vrf-name argument, the running configurations of all VRFs on the router are displayed.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.2(28)SB

This command was introduced.

12.2(33)SRB

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

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.


Usage Guidelines

Use the show running-config vrf command to display a specific VRF configuration or to display all VRF configurations on the router. To display the configuration of a specific VRF, enter the name of the VRF as an argument to the command.

This command displays the following elements of the VRF configuration:

The VRF submode configuration

The routing protocol and static routing configurations associated with the VRF

The configuration of the interfaces in the VRF, which includes the configuration of any owning controller and physical interface for a subinterface

Examples

The following is sample output from the show running-config vrf command. It includes a base VRF configuration for VRF vpn3 and Border Gateway Protocol (BGP) and Open Shortest Path First (OSPF) configurations associated with VRF vpn3.

Router# show running-config vrf vpn3

Building configuration...

Current configuration : 604 bytes
ip vrf vpn3
 rd 100:3
 route-target export 100:3
 route-target import 100:3
!
!
interface Loopback1
 ip vrf forwarding vpn3
 ip address 10.43.43.43 255.255.255.255
!
interface Ethernet6/0
 ip vrf forwarding vpn3
 ip address 172.17.0.1 255.0.0.0
 no ip redirects
 duplex half
!
router bgp 100
!
address-family ipv4 vrf vpn3
 redistribute connected
 redistribute ospf 101 match external 1 external 2
 no auto-summary
 no synchronization
 exit-address-family
 !
router ospf 101 vrf vpn3
 log-adjacency-changes
 area 1 sham-link 10.43.43.43 10.23.23.23 cost 10
 network 172.17.0.0 0.255.255.255 area 1
!
end

Table 143 describes the significant fields shown in the display.

Table 143 show running-config vrf Field Descriptions 

Field
Description

Current configuration: 604 bytes

Number of bytes (604) in the VRF vpn3 configuration.

ip vrf vpn3

Name of the VRF (vpn3) for which the configuration is displayed.

rd 100:3

Identifies the route distinguisher (100:3) for VRF vpn3.

route-target export 100:3
route-target import 100:3

Specifies the route-target extended community for VRF vpn3.

Routes tagged with route-target export 100:3 are exported from VRF vpn3.

Routes tagged with the route-target import 100:3 are imported into VRF vpn3.

interface Loopback1

Virtual interface associated with VRF vpn3.

ip vrf forwarding vpn3

Associates VRF vpn3 with the named interface.

ip address 10.43.43.43 255.255.255.255

IP address of the loopback interface.

interface Ethernet6/0

Interface associated with VRF vpn3.

ip address 172.17.0.1 255.0.0.0

IP address of the Ethernet interface.

router bgp 100

Sets up a BGP routing process for the router with autonomous system number 100.

address-family ipv4 vrf vpn3

Sets up a routing session for VRF vpn3 using standard IP Version 4 address prefixes.

redistribute connected

Redistributes routes automatically established by IP on an interface into the BGP routing domain.

redistribute ospf 101 match external 1 external 2

Redistribute routes from the OSPF 101 routing domain into the BGP routing domain.

router ospf 101 vrf vpn3

Set up an OSPF routing process and associates VRF vpn3 with OSPF VRF processes.

area 1 sham-link 10.43.43.43 10.23.23.23 cost 10

Configure a sham-link interface on a provider edge (PE) router in a Multiprotocol Label Switching (MPLS) VPN backbone.

1 is the ID number of the OSPF area assigned to the sham-link.

10.43.43.43 is the IP address of the source PE router.

10.23.23.23 is the IP address of the destination PE router.

10 is the OSPF cost to send IP packets over the sham-link interface.

network 172.17.0.0 0.255.255.255 area 1

Defines the interfaces on which OSPF runs and defines the area ID for those interfaces.


Related Commands

Command
Description

ip vrf

Configures a VRF routing table.

show ip interface

Displays the usability status of interfaces configured for IP.

show ip vrf

Displays the set of defined VRFs and associated interfaces.

show running-config interface

Displays the configuration for a specific interface.


show tech-support mpls

To generate a report of all Multiprotocol Label Switching (MPLS)-related information, use the show tech-support mpls command in privileged EXEC mode.

show tech-support mpls [vrf vrf-name]

Syntax Description

vrf vrf-name

(Optional) Displays MPLS information about the specified VPN routing and forwarding (VRF) instance.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)S

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB and implemented on the Cisco 10000 series routers.

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.


Usage Guidelines

This command is useful when you contact technical support personnel with questions regarding MPLS. The show tech-support mpls command generates a series of reports. The show tech-support mpls command is equivalent to issuing the following commands:

MPLS Forwarding Information Commands

show adjacency detail
show cef drop show cef events
show cef not-cef-switched
show cef state
show interface accounting | exclude sab
show interfaces statistic | exclude sabl
show ip cef adjacency discard
show ip cef adjacency drop
show ip cef adjacency glean
show ip cef adjacency null
show ip cef adjacency punt
show ip cef detail internal
show ip cef inconsistency
show ip cef summary
show ip cef unresolved internal
show ip interfaces
show ip route
show ip traffic
show mpls forwarding-table detail
show mpls interfaces all
show mpls interfaces all internal
show mpls label range
show mpls static binding

MPLS Forwarding: Cell Mode (LC-ATM) Commands


Note These commands are not supported on Cisco 10000 series routers.


show atm vc
show controller vsi descriptor
show controller vsi session
show controller vsi status
show XTagATM cross-connect
show XTagATM cross-connect traffic
show XTagATM vc

MPLS Forwarding: Quality of Service (QoS) Commands


Note These commands are not supported on Cisco 10000 series routers.


show interfaces fair-queue
show interfaces mpls-exp
show interfaces precedence

MPLS Label Distribution Protocol (LDP) Commands

show mpls atm-ldp bindings
show mpls atm-ldp bindwait
show mpls atm-ldp capability
show mpls atm-ldp summary            <=====
Not supported on Cisco 10000 series routers
show mpls ip binding detail
show mpls ldp backoff
show mpls ldp discovery all detail
show mpls ldp neighbor all
show mpls ldp neighbor detail
show mpls ldp parameters

MPLS LDP: Stateful Switchover/Nonstop Forwarding (SSO/NSF) Support and Graceful Restart Commands

show mpls checkpoint label-binding
show mpls ldp checkpoint
show mpls ldp graceful-restart
show mpls ldp neighbor graceful-restart

MPLS Traffic Engineering Commands

show ip ospf database opaque-area
show ip ospf database opaque-link
show ip ospf mpls traffic-eng fragment
show ip ospf mpls traffic-eng link
show ip rsvp fast-reroute detail
show ip rsvp installed
show ip rsvp interface
show ip rsvp neighbor
show ip rsvp reservation
show ip rsvp sender
show isis mpls traffic-eng adjacency-log
show isis mpls traffic-eng advertisements
show isis mpls traffic-eng tunnel
show mpls traffic-end link-management interfaces
show mpls traffic-eng autoroute
show mpls traffic-eng fast-reroute database detail
show mpls traffic-eng fast-reroute log reroutes
show mpls traffic-eng forwarding adjacency
show mpls traffic-eng link-management admission-control
show mpls traffic-eng link-management advertisements
show mpls traffic-eng link-management bandwidth-allocation
show mpls traffic-eng link-management summary
show mpls traffic-eng topology
show mpls traffic-eng tunnels
show mpls traffic-eng tunnels brief
show mpls traffic-eng tunnels statics summary

MPLS VPN Commands

show ip bgp labels
show ip bgp neighbors
show ip bgp vpnv4 all
show ip bgp vpnv4 all labels
show ip bgp vpnv4 all summary
show ip vrf detail
show ip vrf interfaces
show ip vrf select

Any Transport over MPLS (AToM) Commands

show mpls l2transport binding
show mpls l2transport hw-capability
show mpls l2transport summary
show mpls l2transport vc detail

MPLS VPN VRF-Specific Commands

show ip bgp vpnv4 vpn-name dampening flap-statistics
show ip bgp vpnv4
vpn-name labels
show ip bgp vpnv4
vpn-name peer-group
show ip bgp vpnv4
vpn-name summary
show ip bgp vpnv4 vrf
vpn-name neighbors
show ip vrf detail
vpn-name
show ip vrf interfaces vpn-name
show ip vrf select vpn-name

MPLS VPN VRF-Specific Forwarding Commands

show ip cef vrf vpn-name adjacency discard
show ip cef vrf
vpn-name adjacency drop
show ip cef vrf
vpn-name adjacency glean
show ip cef vrf
vpn-name adjacency null
show ip cef vrf
vpn-name adjacency punt
show ip cef vrf
vpn-name inconsistency
show ip cef vrf
vpn-name internal
show ip cef vrf
vpn-name summary
show ip route vrf
vpn-name
show ip vrf interfaces vpn-name
show mpls forwarding-table vrf vpn-name
show mpls interface vrfvpn-name detail

MPLS LDP VRF-Specific Commands

show mpls ip binding vrf vpn-name atm detail
show mpls ip binding vrf
vpn-name detail
show mpls ip binding vrf
vpn-name local
show mpls ip binding vrf
vpn-name summary
show mpls ldp discovery vrf
vpn-name detail
show mpls ldp neighbor vrf
vpn-name detail

MPLS LDP VRF Graceful Restart-Specific Commands

show mpls ldp neighbor vrf vpn-name graceful-restart

These commands are documented in individual feature modules or Cisco IOS Release 12.2 command references. Refer to the individual commands for information about the output these commands generate.

Examples

The following example displays an abbreviated version of the show tech-support mpls command output:

Router# show tech-support mpls 

------------------ show version ------------------

Cisco IOS Software, 7300 Software (C7300-P-M), Version 12.2(27)SBC, RELEASE SOF)
Technical Support: http://www.cisco.com/techsupport
Copyright (c) 1986-2005 by Cisco Systems, Inc.
Compiled Sat 10-Sep-05 17:44 by ssearch
.
.
.
------------------ show running-config ------------------

Building configuration...

Current configuration : 1827 bytes
.
.
.
------------------ show mpls ldp graceful-restart ------------------

LDP Graceful Restart is disabled
Neighbor Liveness Timer: 120 seconds
Max Recovery Time: 120 seconds
Forwarding State Holding Time: 600 seconds

Related Commands

Command
Description

show tech-support

Displays the equivalent of the show buffers, show controllers, show interfaces, show process, show process memory, show running-config, show stacks, and show version commands.


show vrf

To display the defined Virtual Private Network (VPN) routing and forwarding (VRF) instances, use the show vrf command in user EXEC or privileged EXEC mode.

show vrf [ipv4 | ipv6] [interface | brief | detail | id | select | lock] [vrf-name]

Syntax Description

ipv4

(Optional) Displays IPv4 address-family type VRF instances.

ipv6

(Optional) Displays IPv6 address-family type VRF instances.

interface

(Optional) Displays the interface associated with the specified VRF instances.

brief

(Optional) Displays brief information about the specified VRF instances.

detail

(Optional) Displays detailed information about the specified VRF instances.

id

(Optional) Displays VPN-ID information for the specified VRF instances.

select

(Optional) Displays selection information for the specified VRF instances.

lock

(Optional) Displays VPN lock information for the specified VRF instances.

vrf-name

(Optional) Name assigned to a VRF.


Command Default

If you do not specify any arguments or keywords, the command displays concise information about all configured VRFs.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SRB

This command was introduced.

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.

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.

12.2(33)SRE

This command was modified. When backup paths have been created either through the Prefix Independent Convergence or Best External feature, the output of the show vrf detail command displays the following line:

Prefix protection with additional path enabled


Usage Guidelines

Use the show vrf command to display information about specified VRF instances or all VRF instances. Specify no arguments or keywords to display information on all VRF instances.

Examples

The following is the sample output from the show vrf command that displays brief information about all configured VRF instances:

Router# show vrf 

  Name                             Default RD          Protocols   Interfaces
  N1                               100:0               ipv4,ipv6   
  V1                               1:1                 ipv4        Lo1
  V2                               2:2                 ipv4,ipv6   Et0/1.1
                                                                   Et0/1.2
                                                                   Et0/1.3
  V3                               3:3                 ipv4        Lo3
                                                                   Et0/1.4

Table 144 describes the significant fields shown in the display.

Table 144 show vrf Field Descriptions 

Field
Description

Name

Name of the VRF instance.

Default RD

The default route distinguisher (RD) for the specified VRF instances.

Protocols

The address-family protocol type for the specified VRF instance.

Interfaces

The network interface associated with the VRF instance.


The following example displays output from the show vrf command with the detail keyword. The information shown is for a VRF named cisco1.

Router# show vrf detail

VRF cisco1; default RD 100:1; default VPNID <not set>
  Interfaces:
    Ethernet0/0                  Loopback10
Address family ipv4 (Table ID = 0x1):
  Connected addresses are not in global routing table
  Export VPN route-target communities
    RT:100:1
  Import VPN route-target communities
    RT:100:1
  No import route-map
  No export route-map
  VRF label distribution protocol: not configured
Address family ipv6 (Table ID = 0xE000001):
  Connected addresses are not in global routing table
  Export VPN route-target communities
    RT:100:1
  Import VPN route-target communities
    RT:100:1
  No import route-map
  No export route-map
  VRF label distribution protocol: not configured

Table 145 describes the significant fields shown in the display.

Table 145 show vrf detail Field Descriptions 

Field
Description

default RD 100:1

The RD given to this VRF.

Interfaces:

Interfaces to which the VRF is attached.

Export VPN route-target communities

  RT:100:1

Route-target VPN extended communities to be exported.

Import VPN route-target communities

  RT:100:1

Route-target VPN extended communities to be imported.


The following example displays output from the show vrf detail command when backup paths have been created either through the Prefix Independent Convergence or Best External feature. The output of the show vrf detail command displays the following line:

Prefix protection with additional path enabled

Router# show vrf detail

VRF vpn1 (VRF Id = 1); default RD 1:1; default VPNID <not set>
  Interfaces:
    Et1/1                   
Address family ipv4 (Table ID = 1 (0x1)):
  Export VPN route-target communities
    RT:1:1                  
  Import VPN route-target communities
    RT:1:1                  
  No import route-map
  No export route-map
  VRF label distribution protocol: not configured
  VRF label allocation mode: per-prefix
  Prefix protection with additional path enabled
Address family ipv6 not active.

The following is the sample output from the show vrf lock command that displays VPN lock information:

Router# show vrf lock 

VRF Name: Mgmt-intf; VRF id = 4085 (0xFF5)
VRF lock count: 3
         Lock user: RTMGR, lock user ID: 2, lock count per user: 1
         Caller PC tracebacks:
         Trace backs: :10000000+44DAEB4 :10000000+21E83AC :10000000+45A9F04 :108
         Lock user: CEF, lock user ID: 4, lock count per user: 1
         Caller PC tracebacks:
         Trace backs: :10000000+44DAEB4 :10000000+21E83AC :10000000+45A9F04 :10C
         Lock user: VRFMGR, lock user ID: 1, lock count per user: 1
         Caller PC tracebacks:
         Trace backs: :10000000+44DAEB4 :10000000+21E83AC :10000000+21EAD18 :10C
VRF Name: vpn1; VRF id = 1 (0x1)
VRF lock count: 3
         Lock user: RTMGR, lock user ID: 2, lock count per user: 1
         Caller PC tracebacks:
         Trace backs: :10000000+44DAEB4 :10000000+21E83AC :10000000+45A9F04 :10C
         Lock user: CEF, lock user ID: 4, lock count per user: 1
         Caller PC tracebacks:
         Trace backs: :10000000+44DAEB4 :10000000+21E83AC :10000000+45A9F04 :100
         Lock user: VRFMGR, lock user ID: 1, lock count per user: 1
         Caller PC tracebacks:
         Trace backs: :10000000+44DAEB4 :10000000+21E83AC :10000000+21EAD18 :10C

Related Commands

Command
Description

vrf definition

Configures a VRF routing table instance and enters VRF configuration mode.

vrf forwarding

Associates a VRF instance with an interface or subinterface.


show xconnect

To display information about xconnect attachment circuits and pseudowires, use the show xconnect command in user EXEC or privileged EXEC mode.

show xconnect {{all | interface type number} [detail] | peer ip-address {all | vcid vcid-value} [detail] | pwmib [peer ip-address vcid-value]}

Cisco IOS SR Train

show xconnect {{all | interface type number | memory | rib} [detail] | peer ip-address {all | vcid vcid-value} [detail] | pwmib [peer ip-address vcid-value]}

Cisco uBR10012 Router and Cisco uBR7200 Series Universal Broadband Routers

show xconnect {all | peer ip-address {all | vcid vcid} | pwmib [peer ip-address vcid]} [detail]

Syntax Description

all

Displays information about all xconnect attachment circuits and pseudowires.

interface

Displays information about xconnect attachment circuits and pseudowires on the specified interface.

type

Interface type. For more information, use the question mark (?) online help function. Valid values for the type argument are as follows:

atm number—Displays xconnect information for a specific ATM interface or subinterface.

atm number vp vpi-value—Displays virtual path (VP) xconnect information for a specific ATM virtual path identifier (VPI). This command will not display information about virtual circuit (VC) xconnects using the specified VPI.

atm number vp vpi-value/vci-value—Displays VC xconnect information for a specific ATM VPI and virtual circuit identifier (VCI) combination.

ethernet number—Displays port-mode xconnect information for a specific Ethernet interface or subinterface.

fastethernet number—Displays port-mode xconnect information for a specific Fast Ethernet interface or subinterface.

serial number—Displays xconnect information for a specific serial interface.

serial number dlci-number—Displays xconnect information for a specific Frame Relay data-link connection identifier (DLCI).

number

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

detail

(Optional) Displays detailed information about the specified xconnect attachment circuits and pseudowires.

peer

Displays information about xconnect attachment circuits and pseudowires associated with the specified peer.

ip-address

Specifies the IP address of the peer.

all

Displays all xconnect information associated with the specified peer IP address.

vcid

Displays xconnect information associated with the specified peer IP address and the specified VC ID.

vcid-value

Specifies the VC ID value.

pwmib

Displays information about pseudowires Management Information Base (MIB).

memory

Displays information about the xconnect memory usage.

rib

Displays information about the pseudowire Routing Information Base (RIB).

pwmib

Displays MIB information for all xconnect attachment circuits and pseudowires.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.0(31)S

This command was introduced.

12.2(28)SB

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

12.4(11)T

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

12.2(33)SRB

This command was modified. The rib keyword was added.

12.2(33)SXI

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

Cisco IOS XE Release 2.1

This command was integrated into Cisco IOS XE Release 2.1.

12.4(24)T

This command was modified in a release earlier than Cisco IOS Release 12.4(24)T. The pwmib keyword was added.

12.2(33)SRC

This command was modified in a release earlier than Cisco IOS Release 12.2(33)SRC. The memory keyword was added.

12.2(33)SCC

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


Usage Guidelines

The show xconnect command can be used to display, sort, and filter basic information about all xconnect attachment circuits and pseudowires.

You can use the show xconnect command output to help determine the appropriate steps required to troubleshoot an xconnect configuration problem. More specific information about a particular type of xconnect can be displayed using the commands listed in the "Related Commands" table.

Examples

The following example shows show xconnect all command output in the brief (default) display format:

Router# show xconnect all

Legend: XC ST=Xconnect State, S1=Segment1 State, S2=Segment2 State
UP=Up, DN=Down, AD=Admin Down, IA=Inactive, SB=Standby, RV=Recovering, NH=No Hardware 
XC ST     Segment 1                         S1 Segment 2                         S2
------+---------------------------------+--+---------------------------------+--
UP     ac   Et0/0(Ethernet)              UP mpls 10.55.55.2:1000              UP
UP     ac   Se7/0(PPP)                   UP mpls 10.55.55.2:2175              UP
UP pri ac   Se6/0:230(FR DLCI)           UP mpls 10.55.55.2:2230              UP
IA sec ac   Se6/0:230(FR DLCI)           UP mpls 10.55.55.3:2231              DN
UP     ac   Se4/0(HDLC)                  UP mpls 10.55.55.2:4000              UP
UP     ac   Se6/0:500(FR DLCI)           UP l2tp 10.55.55.2:5000              UP
UP     ac   Et1/0.1:200(Eth VLAN)        UP mpls 10.55.55.2:5200              UP
UP pri ac   Se6/0:225(FR DLCI)           UP mpls 10.55.55.2:5225              UP
IA sec ac   Se6/0:225(FR DLCI)           UP mpls 10.55.55.3:5226              DN
IA pri ac   Et1/0.2:100(Eth VLAN)        UP ac   Et2/0.2:100(Eth VLAN)        UP
UP sec ac   Et1/0.2:100(Eth VLAN)        UP mpls 10.55.55.3:1101              UP
UP     ac   Se6/0:150(FR DLCI)           UP ac   Se8/0:150(FR DLCI)           UP

The following example shows show xconnect all command output in the detailed display format:

Router# show xconnect all detail

Legend: XC ST=Xconnect State, S1=Segment1 State, S2=Segment2 State
UP=Up, DN=Down, AD=Admin Down, IA=Inactive, SB=Standby, RV=Recovering, NH=No HardwareXC 
ST     Segment 1                         S1 Segment 2                         S2
------+---------------------------------+--+---------------------------------+--
UP     ac   Et0/0(Ethernet)              UP mpls 10.55.55.2:1000              UP
            Interworking: ip                     Local VC label 16 
                                                 Remote VC label 16 
                                                 pw-class: mpls-ip 
UP     ac   Se7/0(PPP)                   UP mpls 10.55.55.2:2175              UP
            Interworking: ip                     Local VC label 22 
                                                 Remote VC label 17 
                                                 pw-class: mpls-ip 
UP pri ac   Se6/0:230(FR DLCI)           UP mpls 10.55.55.2:2230              UP
            Interworking: ip                     Local VC label 21 
                                                 Remote VC label 18 
pw-class: mpls-ip 
IA sec ac   Se6/0:230(FR DLCI)           UP mpls 10.55.55.3:2231              DN
            Interworking: ip                     Local VC label unassigned 
                                                 Remote VC label 19 
                                                 pw-class: mpls-ip 
SB ac   Se4/0:100(FR DLCI) 										UP mpls 10.55.55.2:4000              SB
            Interworking: none                   Local VC label 18 
                                                 Remote VC label 19 
                                                 pw-class: mpls 
UP     ac   Se6/0:500(FR DLCI)           UP l2tp 10.55.55.2:5000              UP
            Interworking: none                   Session ID: 34183 
                                                 Tunnel ID: 62083 
                                                 Peer name: pe-iou2 
                                                 Protocol State: UP 
                                                 Remote Circuit State: UP 
                                                 pw-class: l2tp 
UP     ac   Et1/0.1:200(Eth VLAN)        UP mpls 10.55.55.2:5200              UP
            Interworking: ip                     Local VC label 17 
                                                 Remote VC label 20 
                                                 pw-class: mpls-ip 
UP pri ac   Se6/0:225(FR DLCI)           UP mpls 10.55.55.2:5225              UP
            Interworking: none                   Local VC label 19 
                                                 Remote VC label 21 
                                                 pw-class: mpls 
IA sec ac   Se6/0:225(FR DLCI)           UP mpls 10.55.55.3:5226              DN
            Interworking: none                   Local VC label unassigned 
                                                 Remote VC label 22 
                                                 pw-class: mpls 
IA pri ac   Et1/0.2:100(Eth VLAN)        UP ac   Et2/0.2:100(Eth VLAN)        UP
            Interworking: none                   Interworking: none 
UP sec ac   Et1/0.2:100(Eth VLAN)        UP mpls 10.55.55.3:1101              UP
            Interworking: none                   Local VC label 23 
                                                 Remote VC label 17 
                                                 pw-class: mpls 
UP     ac   Se6/0:150(FR DLCI)           UP ac   Se8/0:150(FR DLCI)           UP
            Interworking: none                   Interworking: none 

Sample Output for All Xconnect Attachment Circuits and Pseudowires on a Cisco uBR10012 Router in the Brief Display Format

The following is a sample output of the show xconnect command in the brief (default) display format for all xconnect attachment circuits and pseudowires on a Cisco uBR10012 router:

Router# show xconnect all

Legend:    XC ST=Xconnect State  S1=Segment1 State  S2=Segment2 State
  UP=Up       DN=Down            AD=Admin Down      IA=Inactive
  SB=Standby  RV=Recovering      NH=No Hardware

XC ST  Segment 1                         S1 Segment 2                         S2
------+---------------------------------+--+---------------------------------+--
UP     ac   Bu254:2001(DOCSIS)           UP mpls 10.76.1.1:2001               UP
UP     ac   Bu254:2002(DOCSIS)           UP mpls 10.76.1.1:2002               UP
UP     ac   Bu254:2004(DOCSIS)           UP mpls 10.76.1.1:2004               UP
DN     ac   Bu254:22(DOCSIS)             UP mpls 101.1.0.2:22                 DN

Sample Output for All Xconnect Attachment Circuits and Pseudowires on a Cisco uBR10012 Router in the Detailed Display Format

The following is a sample output of the show xconnect command in the detailed display format for all xconnect attachment circuits and pseudowires on a Cisco uBR10012 router:

Router# show xconnect all detail

Legend:    XC ST=Xconnect State  S1=Segment1 State  S2=Segment2 State
  UP=Up       DN=Down            AD=Admin Down      IA=Inactive
  SB=Standby  RV=Recovering      NH=No Hardware

XC ST  Segment 1                         S1 Segment 2                         S2
------+---------------------------------+--+---------------------------------+--
UP     ac   Bu254:2001(DOCSIS)           UP mpls 10.76.1.1:2001               UP
            Interworking: ethernet               Local VC label 40
                                                 Remote VC label 110
                                                 pw-class:
UP     ac   Bu254:2002(DOCSIS)           UP mpls 10.76.1.1:2002               UP
            Interworking: ethernet               Local VC label 41
                                                 Remote VC label 88
                                                 pw-class:
UP     ac   Bu254:2004(DOCSIS)           UP mpls 10.76.1.1:2004               UP
            Interworking: ethernet               Local VC label 42
                                                 Remote VC label 111
                                                 pw-class:
DN     ac   Bu254:22(DOCSIS)             UP mpls 101.1.0.2:22                 DN
            Interworking: ethernet               Local VC label 39
                                                 Remote VC label unassigned
                                                 pw-class:

Table 146 describes the significant fields shown in the display.

Table 146 show xconnect all Field Descriptions 

Field
Description

XC ST

State of the xconnect attachment circuit or pseudowire. Valid states are:

DN—The xconnect attachment circuit or pseudowire is down. Either segment 1, segment 2, or both segments are down.

IA—The xconnect attachment circuit or pseudowire is inactive. This state is valid only when pseudowire redundancy is configured.

NH—One or both segments of this xconnect no longer have the required hardware resources available to the system.

UP—The xconnect attachment circuit or pseudowire is up. Both segment 1 and segment 2 must be up for the xconnect to be up.

Segment1

or

Segment2

Information about the type of xconnect, the interface type, and the IP address the segment is using. Types of xconnects are as follows:

ac—Attachment circuit

l2tp—Layer 2 Tunnel Protocol

mpls—Multiprotocol Label Switching

pri ac—Primary attachment circuit

sec ac—Secondary attachment circuit

S1

or

S2

State of the segment. Valid states are:

AD—The segment is administratively down.

DN—The segment is down.

HS—The segment is in hot standby mode.