Monitoring AToM on Cisco IOS

Platforms

Overview
While configuring AToM support is not complicated, network administrators must take care to 
ensure proper operation. This lesson describes the commands to verify the operation of AToM.

Relevance
To successfully support an AToM network, network administrators need to be able to identify 
the commands that are available to monitor and troubleshoot AToM operations.

Objectives
The previous lesson listed the configuration tasks, parameters, syntax, and descriptions for 
configuring AToM on Cisco IOS platforms. This lesson covers how to monitor the operation of
AToM. Upon completing this lesson, you will be able to do the following:
 Identify the commands that are available to monitor AToM operation
 Identify the function, syntax, and output of the show mpls l2transport vc command
 Identify the function, syntax, and output of the show mpls l2transport vc detail command
 Identify the function, syntax, and output of the show mpls l2transport summary 
command
 Identify the function, syntax, and output of the debug mpls l2transport vlan control 
command

Learner Skills and Knowledge

To benefit fully from this lesson, you must have these prerequisite skills and knowledge:
 Core MPLS knowledge
 MPLS and VPN technology and configuration knowledge

Copyright © 2004, Cisco Systems, Inc. Any Transport over MPLS 6-47
  Advanced BGP knowledge

6-48 Implementing Cisco MPLS Traffic Engineering and Other Features (MPLST) v2.0 Copyright © 2004, Cisco Systems, Inc.
Outline
This lesson includes these topics:
 Overview
 Monitoring AToM
 show mpls 12transport vc
 show mpls 12transport vc detail
 show mpls 12transport summary
 debug mpls 12transport vlan control
 Lesson Summary
 Lesson Review

Copyright © 2004, Cisco Systems, Inc. Any Transport over MPLS 6-49
Monitoring AToM
This topic identifies the commands that are available to monitor AToM operations.

Monitoring AToM

• Virtual-circui-based:
– show mpls l2transport vc
– show mpls l2transport vc detail
– show mpls l2transport summary
– debug mpls l2transport vlan control
• AAL5-based:
– Existing AAL5 commands
– http://www.cisco.com/en/US/partner/products/sw
/iosswrel/ps1612/products_feature_guide09186a
00800e9570.html

© 2004 Cisco Systems, Inc. All rights reserved. MPLST v2.0—6-3

The existing MPLS show and debug commands can be used to monitor the underlying MPLS 
core network. In addition, a new set of AToM­specific commands have been introduced.

6-50 Implementing Cisco MPLS Traffic Engineering and Other Features (MPLST) v2.0 Copyright © 2004, Cisco Systems, Inc.
show mpls l2transport vc
This topic describes the function, syntax, and output of the
show mpls l2transport vc command.

show mpls l2transport vc

router#
show mpls l2transport vc {summary} | {vc-id } | {{vc-id-min} {vc-id-max}} [detail]

• Displays the state of VCs on a router

© 2004 Cisco Systems, Inc. All rights reserved. MPLST v2.0—6-4

show mpls l2transport vc

To display the state of virtual circuits on a router, use the show mpls l2transport vc EXEC 
command.

show mpls l2transport vc [vcid vc­id] | [vc­id­min vc­id­max] [interface name [local­circuit­
id]] [destination ip­address | name] [detail]

Syntax Description

Parameter Description

vcid (Optional) The VC ID that is assigned to the router.

vc-id Displays information about the virtual circuit that you specify.

vc-id-min Displays information about a range of VC IDs that you specify.

The range is from 0 to 429,467,295.
and

vc-id-max

interface (Optional) The interface or subinterface of the router that has

been enabled to transport Layer 2 packets. This keyword lets you
display information about the virtual circuits that have been
assigned VC IDs on that interface or subinterface.

name (Optional) The name of the interface or subinterface.

Copyright © 2004, Cisco Systems, Inc. Any Transport over MPLS 6-51
 Parameter Description
local-circuit-id (Optional) The number that is assigned to the local circuit. This
argument value applies only to the following transport types:

• For Frame Relay, enter the DLCI of the PVC.

• For AAL5 and cell relay, enter the VPI and VCI of the PVC.

• For Ethernet VLANs, enter the VLAN number.

destination (Optional) Information about the virtual circuits that have been
assigned VC IDs for the remote router that you specify.

ip-address (Optional) The IP address of the remote router.

name (Optional) The name that is assigned to the remote router.

detail (Optional) Displays detailed information about the virtual circuits

on a PE router.

6-52 Implementing Cisco MPLS Traffic Engineering and Other Features (MPLST) v2.0 Copyright © 2004, Cisco Systems, Inc.
 show mpls l2transport vc (Cont.)

MPLS Backbone

CE-A1 CE-A2
PE-Site-X PE-Site-Y

PE-site-X# show mpls l2transport vc

Transport Client VC Local Remote Tunnel
VC ID Intf State VC Label VC Label Label
4 vl4 UP 23 21 77
101 vl101 UP 24 22 77

© 2004 Cisco Systems, Inc. All rights reserved. MPLST v2.0—6-5

show mpls l2transport vc Field Descriptions

Syntax Description

Field Description

Transport VC ID The virtual circuit identifier that is assigned to one of the interfaces on the router.

Client Intf The ingress or egress interface through which the Layer 2 VLAN packet travels.
For EoMPLS, VLAN interfaces are used.

VC State The status of the virtual circuit. The status can be one of the following:

UP—The virtual circuit is in a state where it can carry traffic between the two
virtual circuit endpoints. A virtual circuit is up when both imposition and disposition
interfaces are programmed.
The disposition interface is programmed if the virtual circuit has been configured
and the client interface is up.

The imposition interface is programmed if the disposition interface is programmed

and there is a remote VC label and an IGP label. The IGP label can be implicit
null in a back- to- back configuration. (An IGP label means there is an LSP to the
peer.)

DOWN—The virtual circuit is not ready to carry traffic between the two virtual
circuit end points.

Local VC Label The VC label that a router signals to its peer router, which is used by the peer
router during imposition. The local VC label is a disposition label. The local VC
label determines the egress interface of an arriving packet from the MPLS
backbone.

Remote VC The disposition VC label of the remote peer router.

Label

Tunnel Label An IGP label that is used to route the packet over the MPLS backbone to the
destination router with the egress interface.

Copyright © 2004, Cisco Systems, Inc. Any Transport over MPLS 6-53
show mpls l2transport vc detail
This topic describes the syntax and output of the show mpls 12transport vc detail command.

show mpls l2transport summary

MPLS Backbone

CE-A1 CE-A2
PE-Site-X PE-Site-Y

PE-Site-X# show mpls l2transport vc 2 detail

VC ID: 2, Local Group ID: 8, Remote Group ID: 8 (VC is up)
Client Intf: Vl2 is up, Destination: 172.21.0.1, Peer LDP Ident: 172.20.0.1:0
Local VC Label: 21, Remove VC Label: 21, Tunnel Label: 22
Outgoing Interface: Gi3/2, Next Hop: 4.0.0.1
Local MTU: 1500, Remote MTU: 1500
Imposition: LC Programmed,
Current Imposition/Disposition Slot: 3/32
Packet Totals(in/out): 803713123/802954183
Byte Totals(in/out): 2067870672/942882144

© 2004 Cisco Systems, Inc. All rights reserved. MPLST v2.0—6-7

show mpls l2transport vc detail Field Descriptions

6-54 Implementing Cisco MPLS Traffic Engineering and Other Features (MPLST) v2.0 Copyright © 2004, Cisco Systems, Inc.
 Field Description

VC ID The virtual circuit identifier that is assigned to one of the interfaces on the
router.

Local Group ID The ID that is used to group virtual circuits locally. EoMPLS groups virtual
circuits by the hardware port, which is unique for each port on a router.

Remote Group ID The ID that is used by the peer to group several virtual circuits.

VC is up The status of the virtual circuit. The status can be one of the following:

or UP—The virtual circuit is in a state where it can carry traffic between the two
virtual circuit endpoints. A virtual circuit is up when both imposition and
VC is down disposition interfaces are programmed.

The disposition interface is programmed if the virtual circuit has been

configured and the client interface is up.

The imposition interface is programmed if the disposition interface is

programmed and there is a remote VC label and an IGP label. The IGP label
can be implicit null in a back- to-back configuration. (An IGP label means there
is an LSP to the peer.)

DOWN—The virtual circuit is not ready to carry traffic between the two virtual
circuit endpoints.

Client Intf The ingress or egress interface through which the Layer 2 VLAN packet travels.
For EoMPLS, VLAN interfaces are used.

Destination The destination that you specify for this virtual circuit. You specify the
destination IP address as part of the mpls l2transport route command.

Peer LDP ID The LDP IP address of the targeted peer.

Local VC Label The VC label that a router signals to its peer router, which is used by the peer
router during imposition. The local VC label is a disposition label. The local VC
label determines the egress interface of an arriving packet from the MPLS
backbone.

Remote VC Label The disposition VC label of the remote peer router.

Tunnel Label An IGP label that is used to route the packet over the MPLS backbone to the
destination router with the egress interface.

Outgoing Interface The egress interface of the virtual circuit.

Next Hop The IP address of the next hop.

Local MTU The maximum transmission unit that you specify for the client interface.

Remote MTU The maximum transmission unit that you specify for the client interface of the
remote router.

Imposition The status of the line card, which can be one of the following:

 LC programmed

 LC not programmed

Current The current imposition is the outgoing interface that is used for imposition.
Imposition/Last
Disposition Slot The last disposition slot is the interface where packets for this virtual circuit
arrive.

Packet Totals The total number of packets that have been forwarded in each direction.
(in/out)

Byte Totals (in/out) The total number of bytes that have been forwarded in each direction.

Copyright © 2004, Cisco Systems, Inc. Any Transport over MPLS 6-55
show mpls l2transport summary
This topic describes the syntax and output of the show mpls 12transport summary command.

show mpls l2transport vc summary

MPLS Backbone

CE-A1 CE-A2
PE-Site-X PE-Site-Y

PE-Site-X# show mpls l2transport vc summary

MPLS interface VC summary:
interface: Gi8/1, programmed imposition vcs: 1
interface: Gi8/3, programmed imposition vcs: 1
VC summary (active/non-active) by destination:
destination: 13.0.0.1, Number of locally configured vc(s): 2

© 2004 Cisco Systems, Inc. All rights reserved. MPLST v2.0—6-6

To display summary information about virtual circuits that have been enabled to route AToM 
Layer 2 packets on a router, use the show mpls l2transport summary command in privileged 
EXEC mode.

The following sample output shows summary information about virtual circuits that have been 
enabled to transport Layer 2 packets: 
Router# show mpls l2transport summary

Destination address: 172.16.24.12 Total number of VCs: 60

0 unknown, 58 up, 0 down, 2 admin down
5 active vc on MPLS interface PO4/0

6-56 Implementing Cisco MPLS Traffic Engineering and Other Features (MPLST) v2.0 Copyright © 2004, Cisco Systems, Inc.
 show mpls l2transport summary Field Descriptions

Field Description
Destination address The IP address of the remote router to which the virtual circuit has been
established.

Total number of VCs The number of virtual circuits that have been established.
unknown The number of virtual circuits that are in an unknown state.

up The number of virtual circuits that are operational.

down The number of virtual circuits that are not operational.

admin down The number of virtual circuits that have been disabled.

Copyright © 2004, Cisco Systems, Inc. Any Transport over MPLS 6-57
debug mpls l2transport vlan control
This topic identifies the command syntax of the debug mpls 12transport vlan control 
command.

debug mpls l2transport vlan control

router#
debug mpls l2transport vlan control

• To enable debug messages about the control of

traffic transported between Layer 2 VLAN and
MPLS, use the debug mpls l2transport vlan control
EXEC command.
• To disable the debug messages about transport
control, use the no form of this command.

© 2004 Cisco Systems, Inc. All rights reserved. MPLST v2.0—6-8

debug mpls l2transport vlan control

To enable debug messages about the control of traffic that is transported between Layer 2 
VLAN and MPLS, use the debug mpls 12transport vlan control EXEC command. To disable
the debug messages about transport control, use the no form of this command.

[no] debug mpls l2transport vlan control

Example
The following example shows how the debug mpls 12transport vlan control command 
enables debug messages about the control of traffic between Layer 2 VLANs and MPLS:
Router# debug mpls l2transport vlan control
Ethernet VLAN transport over MPLS, Control interactions debugging is
on
Router# config t
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# int vlan2
Router(config-if)# shut
Router(config-if)#
*May 25 12:18:33: ATOM_TRANS: atom_if_state_change from Vlan2
*May 25 12:18:33: ATOM_TRANS: Withdrawing all EoMPLS vcs for lgroupid
8

6-58 Implementing Cisco MPLS Traffic Engineering and Other Features (MPLST) v2.0 Copyright © 2004, Cisco Systems, Inc.
 *May 25 12:18:33: ATOM_TRANS: sending extended withdraw_bind for vcid
0
to 12.0.0.1, local groupid 8
*May 25 12:18:33: ATOM_TRANS: holding down local label 21
*May 25 12:18:33: ATOM_TRANS: clearing imp. rewrite for vcid = 2
Router(config-if)#
*May 25 12:18:35: ATOM_TRANS: freeing held label 21
Router(config-if)#
*May 25 12:18:35: %LINK-5-CHANGED: Interface Vlan2, changed state to
administratively down
*May 25 12:18:36: %LINEPROTO-5-UPDOWN: Line protocol on Interface
Vlan2,
changed state to down
Router(config-if)# no shut
Router(config-if)#
*May 25 12:19:57: ATOM_TRANS: atom_if_state_change from Vlan2
*May 25 12:19:57: ATOM_TRANS: Withdrawing all EoMPLS vcs for lgroupid
8
*May 25 12:19:57: ATOM_TRANS: sending extended withdraw_bind for vcid
0
to 12.0.0.1, local groupid 8
Router(config-if)#
*May 25 12:19:59: %LINK-3-UPDOWN: Interface Vlan2, changed state to
up
Router(config-if)#
*May 25 12:19:59: ATOM_TRANS: sending bind for vcid 2 to 12.0.0.1,
local
groupid 8
*May 25 12:19:59: ATOM_TRANS: sending request_bind for vcid 2 to
12.0.0.1, local groupid 8
*May 25 12:19:59: ATOM_TRANS: Stale tfib event discarded (12.0.0.1)
*May 25 12:19:59: ATOM_TRANS: Stale tfib event discarded (12.0.0.1)
*May 25 12:19:59: ATOM_TRANS: Stale tfib event discarded (12.0.0.1)
*May 25 12:19:59: ATOM_TRANS: processing tfib event for 12.0.0.1
*May 25 12:19:59: ATOM_TRANS: received BIND from 12.0.0.1:0 remote
group id: 8 vc_id: 2 label: 21
*May 25 12:19:59: ATOM_TRANS: Done setting imp.rewrite for vcid = 2
parent dest 12.0.0.1
*May 25 12:20:00: %LINEPROTO-5-UPDOWN: Line protocol on Interface
Vlan2,
changed state to up

Copyright © 2004, Cisco Systems, Inc. Any Transport over MPLS 6-59
Lesson Summary
This topic summarizes the key points discussed in this lesson.

Summary

• Virtual-circuit-based:
– show mpls l2transport vc
– show mpls l2transport vc detail
– show mpls l2transport summary
– debug mpls l2transport vlan control
• AAL5-based:
– Check www.cisco.com for details

© 2004 Cisco Systems, Inc. All rights reserved. MPLST v2.0—6-9

References
For additional information, refer to this resource:
 Access the Cisco website at http://www.cisco.com for additional information about the 
unified VPN suite solution for service providers.

Next Steps
For the associated lab exercises, refer to the following sections of the course Lab Guide:
 Lab Exercise 6­1: Implementing a Port­to­Port FRoMPLS Configuration (Case Study)
 Lab Exercise 6­2: Implementing a DLCI­to­DLCI FRoMPLS Configuration (Case Study)

6-60 Implementing Cisco MPLS Traffic Engineering and Other Features (MPLST) v2.0 Copyright © 2004, Cisco Systems, Inc.
Lesson Review
Use the practice items here to review what you learned in this lesson. The correct answers are 
found in the Lesson Answer Key.

Q1) Which commands do you use to monitor an AToM session?

            
       
               
               
               
               
               
               
               
               

            
       
               
               
               
               
               
               
               
               

Q2) Which command do you use to display the status of all of the active virtual circuits on a
router?
A) show mpls l2transport vc
B) show mpls l2transport vc summary
C) show mpls l2transport vc detail 
D) debug mpls l2transport vlan control
Q3) Which command do you use to display summary information about virtual circuits that 
have been enabled to route AToM Layer 2 packets on a router?
A) show mpls l2transport vc
B) show mpls l2transport vc summary
C) show mpls 12transport vc detail 
D) debug mpls l2transport vlan control
Q4) Which command do you use to display comprehensive information about the virtual 
circuits that have been assigned VC IDs?
A) show mpls l2transport vc
B) show mpls l2transport vc summary
C) show mpls 12transport vc detail 
D) debug mpls l2transport vlan control
Q5) Which command do you use to display messages about the control of traffic that is 
transported between Layer 2 VLAN and MPLS?
A) show mpls 12transport vc
B) show mpls 12transport vc summary
C) show mpls 12transport vc detail 
D) debug mpls 12transport vlan control

Copyright © 2004, Cisco Systems, Inc. Any Transport over MPLS 6-61
Lesson Answer Key
Q1) show mpls l2transport vc, show mpls l2transport vc summary, show mpls l2transport vc detail, and 
debug mpls l2transport vlan control
Relates to: Monitoring AToM

Q2) A
Relates to: show mpls l2transport vc

Q3) B
Relates to: show mpls l2transport vc summary

Q4) C
Relates to: show mpls l2transport vc detail

Q5) D
Relates to: debug mpls l2transport vlan control

6-62 Implementing Cisco MPLS Traffic Engineering and Other Features (MPLST) v2.0 Copyright © 2004, Cisco Systems, Inc.
Copyright © 2004, Cisco Systems, Inc. Any Transport over MPLS 6-63