|
|
This document includes the following major sections:
Cisco documentation and additional literature are available in a CD-ROM package, which ships with your product. The Documentation CD-ROM, a member of the Cisco Connection Family, is updated monthly. Therefore, it might be more up to date than printed documentation. To order additional copies of the Documentation CD-ROM, contact your local sales representative or call customer service. The CD-ROM package is available as a single package or as an annual subscription. You can also access Cisco documentation on the World Wide Web at http://www.cisco.com, http://www-china.cisco.com, or http://www-europe.cisco.com.
If you are reading Cisco product documentation on the World Wide Web, you can submit comments electronically. Click Feedback in the toolbar, select Documentation, and click Enter the feedback form. After you complete the form, click Submit to send it to Cisco. We appreciate your comments.
The label switch controller (LSC), combined with the Cisco BPX 8650 IP+ATM switch, supports scalable integration of IP services over an ATM network. The MPLS LSC enables the Cisco BPX 8650 to:
The MPLS LSC supports highly scalable integration of MPLS (IP+ATM) services by using a direct peer relationship between the Cisco BPX 8650 switch and MPLS routers. This direct peer relationship removes the limitation on the number of IP edge routers (typical of traditional IP-over-ATM networks), allowing service providers to meet growing demands for IP services. The MPLS LSC also supports direct and rapid implementation of advanced IP services over ATM networks using Cisco BPX 8650 switches.
MPLS combines the performance and virtual circuit capabilities of Layer 2 (data link layer) switching with the scalability of Layer 3 (network layer) routing capabilities. This combination enables service providers to deliver solutions for managing growth, providing differentiated services, and leveraging existing networking infrastructures.
The MPLS LSC architecture provides the flexibility to:
By deploying the MPLS LSC across large enterprise networks or wide area networks, customers can:
The MPLS LSC is a label switch router (LSR) that is configured to control the operation of a separate ATM switch. Together, the MPLS LSC and the controlled ATM switch function as a single ATM MPLS router (ATM-LSR).
Figure 1 shows the functional relationship between the MPLS LSC and the ATM switch that it controls.
Referring to Figure 1, note that the following devices can function as an MPLS LSC:
Note also from Figure 1 that a Cisco BPX 8600 Service Node (or a slave ATM device) can function as the controlled ATM switch.
The MPLS LSC controls the ATM switch by means of the Virtual Switch Interface (VSI), which runs over an ATM link connecting the two devices.
The dotted outline in Figure 1 represents the logical boundaries of the external interfaces of the MPLS LSC and the controlled ATM switch, as discovered by the IP routing topology. The controlled ATM switch provides one or more LC-ATM interfaces at this external boundary. The MPLS LSC can incorporate other label controlled or non-label controlled router interfaces.
In the LSC, the LC-ATM ports on the controlled ATM switch are used as an IOS interface type called extended Label ATM (XTagATM). To associate these XTagATM interfaces with particular physical interfaces on the controlled ATM switch, use the interface configuration command extended-port.
Figure 2 shows a typical MPLS LSC configuration which controls three ATM ports on a Cisco BPX switch: ports 6.1, 6.2, and 12.2. These corresponding XTagATM interfaces were created on the MPLS LSC and associated with the corresponding ATM ports on the Cisco BPX switch by means of the extended-port interface configuration command.
Observe from Figure 2 that:
Virtual trunks provide connectivity for Cisco WAN MPLS switches through an ATM cloud, as shown in Figure 3. Since several virtual trunks can be configured across a given physical trunk, virtual trunks provide a cost effective means of connecting across an entire ATM network, because each virtual trunk typically consumes only a part of the resources of the physical trunk.
The ATM equipment in the cloud must support virtual path switching and transmission of ATM cells based solely on the VPI in the ATM cell header. The virtual path identifier (VPI) is provided by the ATM cloud administrator (that is, by the Service Provider).
Figure 3 shows three Cisco WAN MPLS switching networks, each connected to an ATM network by means of a physical line. The ATM network is shown linking all three of these subnetworks to every other subnetwork with a full meshed network of virtual trunks. In this example, each physical interface is configured with two virtual trunks.
Virtual trunks provide the following benefits:
A virtual trunk number (slot number.port number.trunk number) is used to differentiate the virtual trunks found within a physical trunk port. In Figure 4, three virtual trunks 4.1.1, 4.1.2, and 4.1.3 are configured on a physical trunk that connects to the port 4.1 interface of a BXM.
These virtual trunks are mapped to the XtagATM interfaces on the LSC. On the XtagATM interface, you configure the respective VPI value using the command tag-switching atm vp-tunnel vpi. This VPI should match the VPI in the ATM network. The LVCs are generated inside this VP, and this VP carries the LVCs and their traffic across the network.
Virtual Trunk Bandwidth
The total bandwidth of all the virtual trunks on one port cannot exceed the maximum bandwidth of the port. Trunk loading (units of load) is maintained per virtual trunk, but the cumulative loading of all virtual trunks on a port is restricted by the transmit and receive rates for the port.
Virtual Trunk Features
The maximum number of virtual trunks that can be configured per card equals the number of virtual interfaces (VIs) on the BPX. The BXM supports 31 virtual interfaces; hence, it supports up to 31 virtual trunks. Accordingly, you can have interfaces starting from XtagATM411 to XtagATM4131 on the same physical interface.
As a label edge device, you can use the MPLS LSC to:
 |
Note A Cisco 6400 UAC with an NRP configured to function as an LSC should have MPLS edge LSR functionality disabled. Refer to the "tag-switching atm disable-headend-vc" section for information about how to disable MPLS edge LSR functionality using this command. An NRP LSC should only support transit Label Switch Paths through the controlled ATM switch under VSI control. |
You can configure the Cisco 6400 UAC to operate as an MPLS LSC in an MPLS network. The hardware that supports MPLS LSC functionality on the Cisco 6400 UAC is described in the following sections.
A Cisco 6400 UAC that incorporates the following components shown can operate as an MPLS LSC in your network:
|
Note A Cisco 6400 UAC chassis can accommodate multiple NRPs, including one dedicated to MPLS LSC functions. Beyond this dedicated NRP, you can use additional NRPs to run MPLS and perform other networking services. However, you cannot use an additional NRP as an MPLS LSC. |
Figure 5 shows the components that you can configure to enable the Cisco 6400 UAC to function as an MPLS LSC.
The NRP controls the slave ATM switch by means of the Virtual Switch Interface (VSI) protocol. VSI operates over a manually configured PVC that is dedicated to the virtual circuits (VCs) used by the VSI control channel. In order for the NRP LSC to control an ATM switch through the VSI, control VCs need to be cross-connected from the BPX through the NSP to the NRP LSC. The BPX uses defined control VCs for each BXM slot of the BPX chassis, enabling the LSC to control external XTagATM interfaces through the VSI.
Table 1 defines the PVCs that must be configured on the NSP interface connected to the BPX VSI shelf. These PVCs are cross-connected via the NSP to the NRP VSI master control port, which is running the VSI protocol.
For an NRP that is installed in slot 3 of a Cisco 6400 UAC chassis, the master control port would be ATM3/0/0 on the NSP. As shown in Figure 2, the BPX switch control interface is 12.1, and the NSP ATM port connected to this interface is the ATM interface that is cross-connected to ATM3/0/0. Because Figure 2 shows that the BXM slaves in BPX slots 6 and 12 are to be configured as external XTagATM ports, the PVCs that must be cross-connected through the NSP are 0/45 for slot 6 and 0/51 for slot 12, respectively, as outlined in Table 1.
| BPX VSI Slave Slot | VSI Interface Control VC |
|---|---|
1 | 0/40 |
2 | 0/41 |
3 | 0/42 |
4 | 0/43 |
5 | 0/44 |
6 | 0/45 |
7 | 0/46 |
8 | 0/47 |
9 | 0/48 |
10 | 0/49 |
11 | 0/50 |
12 | 0/51 |
13 | 0/52 |
14 | 0/53 |
Figure 6 shows the functional relationships among the Cisco 6400 UAC hardware components and the PVPs that you can configure to support MPLS LSC functionality.
All other MPLS LSC functions, such as routing, terminating LVCs, and LDP control VCs (default 0/32), can be accomplished by means of a separate, manually configured PVP (see the upper shaded area in Figure 6). The value of "n" for this manually configured PVP must be the same among all the associated devices (the NRP, the NSP, and the slave ATM switch). Because the NSP uses VP=0 for ATM Forum signaling and the BPX uses VP=1 for autoroute, the value of "n" for this PVP for MPLS LSC functions must be greater than or equal to 2, while not exceeding an upper bound.
Note that some edge LSRs have ATM interfaces with limited VC space per virtual path (VP). For these interface types, several VPs must be defined. For example, the Cisco ATM Port Adapter (PA-A1) and the AIP interface are limited to VC range 33 through 1018. To use the full capacity of the ATM interface, four consecutive VPs must be configured. Furthermore, the selection of these VPs should be within the configured range of the BPX.
For internodal BPX connections, it is suggested that you configure VPs 2 through 15; for edge LSRs, it is suggested that you configure VPs 2 through 5. (See the IOS CLI command "tag-switching atm vpi" for examples of how to configure edge LSRs; see the BPX command "cnfrsrc" described in the Cisco BPX 8600 Series documentation for examples of how to configure BPX Service Nodes.)
After you connect the NRP, the NSP, and the slave ATM switch by means of manually configured PVPs (as shown in Figure 6), the NRP is able to control the slave ATM switch as though it is directly connected to the NRP. The NRP discovers the interfaces of the slave ATM switch and establishes the default control VC to be used in creating MPLS VCs.
The slave ATM switch shown in Figure 6 incorporates two external ATM interfaces (labeled 1 and 2) that are known to the NRP as XTagATM61 and XTagATM122, respectively. On interface 6.1 of the slave ATM switch, VC 0/32 is connected to VC 2/35 by the VSI protocol. On the NRP, VC 2/35 is terminated on interface XTagATM61 and mapped to VC 0/32, also by means of the VSI protocol. This mapping enables the LDP to discover MPLS LSC neighbors by means of the default control VC 0/32 on the physical interface. On interface 12.2 of the slave ATM switch, VC 0/32 is connected to VC 2/83 by the VSI protocol. On the NRP, VC 2/83 is terminated on interface XTagATM122 and mapped to VC 0/32.
Note that the selection of these VCs is dependent on the availability of VC space. Hence it is not predictable what physical VC will be mapped to the external default control VC 0/32 on the XTagATM interface. The control VC will be shown as a PVC on the LSC, as opposed to a LVC, when you execute the IOS CLI command "show xtagatm vc".
Figure 7 shows a Cisco 6400 UAC containing a single NRP that has been configured to perform basic MPLS LSC operations.
|
Note If the NRP incurs a fault that causes it to malfunction (in a single NRP configuration), the LVCs and routing paths pertaining to MPLS LSC functions are lost. |
|
Note The loopback addresses must be configured with a 32 bit mask and be included in the relevant IGP or BGP routing protocol, as shown in the following example: ip address 192.103.210.5 255.255.255.255 |
In the MPLS LSC topology shown in Figure 7, the devices labeled LSR1 and LSR2 are external to the Cisco 6400 UAC. These devices, with loopback addresses as their respective LDP identifiers, are connected to two separate interfaces labeled 6.1 and 12.2 on the slave ATM switch. Both LSR1 and LSR2 learn about each other's routes from the NRP by means of the data path represented as the thick dashed line in Figure 7. Subsequently, LVCs are established by means of LDP operations to create the data paths between LSR1 and LSR2 through the ATM slave switch.
Both LSR1 and LSR2 learn of the loopback address of the NRP and create a data path (LVCs) from each other that terminates in the NRP. These LVCs, called tailend LVCs, are not shown in Figure 7.
By default, the NRP requests LVCs for the next hop devices (the LSRs shown in Figure 7). These LVCs, called headend LVCs, enable the NRP/ATM slave switch combination to operate as an edge label switch router (edge LSR). Because the NRP is dedicated to slave ATM switch control by default, the headend LVCs are not required.
|
Note A Cisco 6400 UAC with an NRP configured to function as an LSC should have MPLS edge LSR functionality disabled. An NRP LSC should only support transit Label Switch Paths through the controlled ATM switch under VSI control. (Refer to the command described in the section entitled "tag-switching atm disable-headend-vc" for information about how to disable MPLS edge LSR functionality. |
The tag-switching atm disable-headend-vc CLI command disables the default behavior of the NRP in setting up headend switch LVCs, thereby saving VC space over the VP between the NRP and the slave ATM switch that the NRP controls. In the absence of additional LVCs, data traffic follows the same path as that for control traffic.
You can connect the MPLS LSC to a network that is running ATM Forum protocols while the MPLS LSC simultaneously performs its functions. However, you must connect the ATM Forum network through a separate ATM interface (that is, not through the master control port).
Table 2 lists current tag switching terms and the equivalent MPLS terms now being used in this document.
| Old Tag Switching Terminology | New MPLS IETF Terminology |
|---|---|
Tag Switching | MPLS, Multiprotocol Label Switching |
Tag (short for Tag Switching) | MPLS |
Tag (item or packet) | Label |
TDP (Tag Distribution Protocol) | LDP (Label Distribution Protocol) Cisco TDP and LDP (MPLS Label Distribution Protocol) are nearly identical in function, but use incompatible message formats and some different procedures. Cisco is changing from TDP to a fully compliant LDP. |
Tag Switched | Label Switched |
TFIB (Tag Forwarding Information Base) | |
LSR (Label Switching Router) | |
TSC (Tag Switch Controller) | LSC (Label Switch Controller) |
ATM-TSR (ATM Tag Switch Router) | ATM-LSR (ATM Label Switch Router, such as the Cisco BPX 8650 switch) |
LVC (Label VC, Label Virtual Circuit) | |
TSP (Tag Switch Path) | LSP (Label Switch Path) |
XTag ATM (extended Tag ATM port) |
By using the MPLS LSC, you can derive the following benefits:
You can use the following platforms in conjunction with the MPLS LSC:
This section provides examples of configuration tasks for enabling MPLS LSC functionality.
Refer to the Cisco BPX 8600 Series documentation for BPX Service Node configuration examples.
| Command | Purpose | |
|---|---|---|
Step 1 | Router(config)# interface loopback0 Router(config-if)# ip address 192.103.210.5 255.255.255.255 | Enable a loopback interface. A loopback interface provides stable router and LDP identifiers. |
Step 2 | Router(config)# interface atm1/0 Router(config-if)# tag-control-protocol vsi | |
Step 3 | Router(config-if)# interface XTagATM61 Router(config-if)# extended-port atm1/0 bpx 6.1 | Configure MPLS on the extended label ATM interface by creating an extended label ATM (XTagATM) virtual interface and binding it to BPX port 6.1. |
Step 4 | Router(config-if)# | Configure MPLS on the extended label ATM interface. Limit the range so that the total number of VPIs does not exceed 4. For example: |
Step 5 | Router(config-if)# interface XTagATM122 Router(config-if)# extended-port atm1/0 bpx 12.2 | Configure MPLS on the other extended label ATM interface by creating an extended label ATM (XTagATM) virtual interface and binding it to BPX port 12.2. |
Step 6 | Router(config-if)# | Configure MPLS on the extended label ATM interface. Limit the range so that the total number of VPIs does not exceed 4. For example: |
Step 7 | Router(config)# |
|
Note If the LSC is a 75xx series router, the ip cef distributed command must be issued to configure the router. |
|
Note For Release 12.0(5)T, you must configure the XTagATM interfaces using the no ip route-cache cef command. |
| Command | Purpose | |
|---|---|---|
Step 1 | Router(config)# interface loopback0 Router(config-if)# ip address 192.103.210.5 255.255.255.255 | Enable a loopback interface. A loopback interface provides stable router and LDP identifiers. |
Step 2 | Router(config)# interface atm3/0/0 Router(config-if)# tag-control-protocol vsi | |
Step 3 | Router(config-if)# interface XTagATM61 Router(config-if)# extended-port atm1/0 bpx 6.1 | Configure MPLS on the extended label ATM interface by creating an extended label ATM (XTagATM) virtual interface and binding it to BPX port 6.1. |
Step 4 | Router(config-if)# | Configure MPLS on the extended label ATM interface. Limit the range so that the total number of VPIs does not exceed 4. For example: |
Step 5 | Router(config-if)# interface XTagATM122 Router(config-if)# extended-port atm1/0 bpx 12.2 | Configure MPLS on the other extended label ATM interface by creating an extended label ATM (XTagATM) virtual interface and binding it to BPX port 12.2. |
Step 6 | Router(config-if)# | Configure MPLS on the extended label ATM interface. Limit the range so that the total number of VPIs does not exceed 4. For example: |
Step 7 | Router(config)# | |
Step 8 | Router(config)# | Disable Headend VC label advertisement. |
| Command | Purpose | |
|---|---|---|
Step 1 | Switch# show hardware 3/0 NRP 00-0000-00 ....... | Show the hardware connected to the Cisco 6400 UAC, inlcuding the position (3/0) of the NRP in the Cisco 6400 chassis, as shown in the sample output at the left. |
Step 2 | Switch(config)# interface atm3/0/0 | Specify the ATM interface for which you want to configure PVCs and PVPs. |
Step 3 | Switch(config-if)# atm pvc 0 40 interface ATM1/0/0 0 40 atm pvc 0 41 interface ATM1/0/0 0 41 atm pvc 0 42 interface ATM1/0/0 0 42 atm pvc 0 43 interface ATM1/0/0 0 43 atm pvc 0 44 interface ATM1/0/0 0 44 atm pvc 0 45 interface ATM1/0/0 0 45 atm pvc 0 46 interface ATM1/0/0 0 46 atm pvc 0 47 interface ATM1/0/0 0 47 atm pvc 0 48 interface ATM1/0/0 0 48 atm pvc 0 49 interface ATM1/0/0 0 49 atm pvc 0 50 interface ATM1/0/0 0 50 atm pvc 0 51 interface ATM1/0/0 0 51 atm pvc 0 52 interface ATM1/0/0 0 52 atm pvc 0 53 interface ATM1/0/0 0 53 | Configure the PVC for the VSI control channel1, depending on which of the 14 slots in the Cisco BPX is occupied by a Cisco Broadband Switch Module (BXM). If you do not know the BPX slots containing a BXM, configure all 14 PVCs (as shown opposite) to ensure that the NSP functions properly. However, if you know that Cisco BPX slots 10 and 12, for example, contain a BXM, you only need to configure PVCs corresponding to those slots, as shown below: atm pvc 0 49 interface ATM1/0/0 0 49 Instead of configuring multiple PVCs, as shown opposite in this step, you can configure PVP 0 by deleting all well-known VCs. For example, you can use the command atm manual-well-known-vc delete on both interfaces and then configure PVP 0, as indicated below: atm pvp 0 interface ATM1/0/0 0 |
Step 4 | Switch(config-if)# | Configure the PVPs for the LVCs. For XtagATM interfaces, use the VPI range 2 through 5 (by issuing a tag-switching atm vpi 2-5 command). If you want to use some other VPI range, configure the PVPs accordingly. |
| Command | Purpose | |
|---|---|---|
Step 1 | Router# show controller vsi session | Display the VSI session state. |
Step 2 | Router# show tag-switching interfaces | Display the MPLS-enabled interface states. |
Step 3 | Router# show controllers vsi control-interface | Display information about an ATM interface that controls an external ATM switch or VSI control interface. |
Step 4 | Router# show interface XTagATM | Display information about an extended MPLS ATM interface. |
Step 5 | Router# show tag-switching tdp discovery | Display information about the discovery of MPLS neighbors. |
Step 6 | Router# show tag-switching tdp neighbor | Display information about the MPLS neighbor relationship. |
Step 7 | Router# show tag-switching atm capabilities | Display information about negotiated of TDP or LDP control VPs. |
Step 8 | Router# show tag-switching atm summary | Display summary information about the number of destination networks discovered via routing protocol and the LVCs created on each extended label ATM interface. |
The following sections present typical network configurations for using MPLS LSC functionality.
The network topology shown in Figure 8 incorporates two ATM-LSRs in an MPLS network. This topology includes two LSCs (Cisco 7200 routers), two BPX service nodes, and two edge LSRs (Cisco 7500 routers).
Based on Figure 8, the following configuration examples are provided:
7200 LSC1:ip cef ! interface loopback0
ip address 192.103.210.5 255.255.255.255
! interface ATM3/0no ip address tag-control-protocol vsi
! interface XTagATM13extended-port ATM3/0 bpx 1.3 ip unnumbered loopback0 tag-switching atm vpi 2-15 no ip route-cache cef tag-switching ip
! interface XTagATM22extended-port ATM3/0 bpx 2.2 ip unnumbered loopback0 tag-switching atm vpi 2-5 no ip route-cache cef tag-switching ip
BPX1 and BPX2:uptrk 1.1 addshelf 1.1 v 1 1 cnfrsrc 1.1 256 252207 y 1 e 512 6144 2 15 26000 100000 uptrk 1.3 cnfrsrc 1.3 256 252207 y 1 e 512 6144 2 15 26000 100000 uptrk 2.2 cnfrsrc 2.2 256 252207 y 1 e 512 4096 2 5 26000 100000
7500 LSC2:ip cef distributed ! interface loopback0
ip address 142.2.143.22 255.255.255.255
! interface ATM3/0/0no ip address tag-control-protocol vsi
! interface XTagATM13extended-port ATM3/0/0 bpx 1.3 ip unnumbered loopback0 tag-switching atm vpi 2-15 no ip route-cache cef tag-switching ip
! interface XTagATM22extended-port ATM3/0/0 bpx 2.2 ip unnumbered loopback0 tag-switching atm vpi 2-5 no ip route-cache cef tag-switching ip
!
7500 LSR1:ip cef distributed ! interface loopback 0
ip address 142.6.132.2 255.255.255.255
! interface ATM2/0/0no ip address
! interface ATM2/0/0.5 tag-switchingip unnumbered loopback 0 tag-switching atm vpi 2-5 tag-switching ip
7200 LSR2:ip cef interface loopback 0
ip address 142.6.142.2 255.255.255.255
! interface ATM2/0no ip address
! interface ATM2/0.9 tag-switchingip unnumbered loopback 0 tag-switching atm vpi 2-5 tag-switching ip
When you configure multi-vc support, four label VCs for each destination are created by default. These four VCs are called:
This section provides examples for the following configurations, based on the sample network configuration shown earlier in Figure 8:
7200 LSC1:ip cef ! interface loopback0
ip address 192.103.210.5 255.255.255.255
! interface ATM3/0no ip address tag-control-protocol vsi
! interface XTagATM13ip unnumbered loopback 0 extended-port ATM3/0 bpx 1.3 tag-switching atm vpi 2-15 tag-switching atm cos available 25 tag-switching atm cos standard 25 tag-switching atm cos premium 25 tag-switching atm cos control 25 tag-switching ip
! interface XTagATM23ip unnumbered loopback 0 extended-port ATM3/0 bpx 2.2 tag-switching atm vpi 2-5 tag-switching atm cos available 20 tag-switching atm cos standard 30 tag-switching atm cos premium 25 tag-switching atm cos control 25 tag-switching ip
BPX1 and BPX2:uptrk 1.1 addshelf 1.1 v 1 1 cnfrsrc 1.1 256 252207 y 1 e 512 6144 2 15 26000 100000 uptrk 1.3 cnfrsrc 1.3 256 252207 y 1 e 512 6144 2 15 26000 100000 uptrk 2.2 cnfrsrc 2.2 256 252207 y 1 e 512 4096 2 5 26000 100000
7500 LSC2:ip cef distributed ! interface loopback0
ip address 142.2.143.22 255.255.255.255
! interface ATM3/0/0no ip address tag-control-protocol vsi
! interface XTagATM13ip unnumbered loopback 0 extended-port ATM3/0/0 bpx 1.3 tag-switching atm vpi 2-15 tag-switching atm cos available 25 tag-switching atm cos standard 25 tag-switching atm cos premium 25 tag-switching atm cos control 25 tag-switching ip
! interface XTagATM23ip unnumbered loopback 0 extended-port ATM3/0/0 bpx 2.2 tag-switching atm vpi 2-5 tag-switching atm cos available 20 tag-switching atm cos standard 30 tag-switching atm cos premium 25 tag-switching atm cos control 25 tag-switching ip
7500 LSR1:ip cef distributed interface loopback 0 ip address 142.6.132.2 255.255.255.255 ! interface ATM2/0/0
no ip address
! interface ATM2/0/0.5 tag-switchingip unnumbered loopback 0 tag-switching atm vpi 2-5 tag-switching atm multi-vc tag-switching ip
7200 LSR2:ip cef interface loopback 0 ip address 142.2.142.2 255.255.255.255 ! interface ATM2/0
no ip address
! interface ATM2/0.9 tag-switchingip unnumbered loopback 0 tag-switching atm vpi 2-5 tag-switching atm multi-vc tag-switching ip
If LSC1 supports QoS, but LSC2 does not, LSC1 makes VC requests for the following default classes:
LSC2 ignores the call field in the request and allocates two UBR label VCs.
If LSR1 supports QoS, but LSR2 does not, LSR2 receives the request to create multiple label VCs, but by default, creates class 0 only (UBR).
When you use the NRP as an MPLS LSC in the Cisco 6400 UAC, you must configure the NSP to provide connectivity between the NRP and the Cisco BPX switch. When configured in this way (as shown in Figure 9), the NRP is connected to the NSP by means of the internal interface ATM3/0/0, while external connectivity from the Cisco 6400 UAC to the Cisco BPX switch is provided by means of the external interface ATM1/0/0 from the NSP.
Based on Figure 9, the following configuration examples are provided:
6400 NSP:! interface ATM3/0/0
atm pvp 0 interface ATM1/0/0 0 atm pvp 2 interface ATM1/0/0 2 atm pvp 3 interface ATM1/0/0 3 atm pvp 4 interface ATM1/0/0 4 atm pvp 5 interface ATM1/0/0 5 atm pvp 6 interface ATM1/0/0 6 atm pvp 7 interface ATM1/0/0 7 atm pvp 8 interface ATM1/0/0 8 atm pvp 9 interface ATM1/0/0 9 atm pvp 10 interface ATM1/0/0 10 atm pvp 11 interface ATM1/0/0 11 atm pvp 12 interface ATM1/0/0 12 atm pvp 13 interface ATM1/0/0 13 atm pvp 14 interface ATM1/0/0 14 atm pvp 15 interface ATM1/0/0 15
|
Note Instead of configuring multiple PVCs, you can also configure PVP 0 by deleting all well-known VCs. For example, you can use the command atm manual-well-known-vc delete on both interfaces and then configure PVP 0, as indicated below: atm pvp 0 interface ATM1/0/0 0 |
ip cef ! interface Loopback0ip address 142.2.143.22 255.255.255.255
! interface ATM0/0/0no ip address tag-control-protocol vsi
! interface XTagATM13ip unnumbered Loopback0 extended-port ATM0/0/0 bpx 1.3 tag-switching atm vpi 2-15 tag-switching ip
! interface XTagATM22ip unnumbered Loopback0 extended-port ATM0/0/0 bpx 2.2 tag-switching atm vpi 2-5 tag-switching ip
! tag-switching atm disable-headend-vc
BPX1 and BPX2:uptrk 1.1 addshelf 1.1 v 1 1 cnfrsrc 1.1 256 252207 y 1 e 512 6144 2 15 26000 100000 uptrk 1.3 cnfrsrc 1.3 256 252207 y 1 e 512 6144 2 15 26000 100000 uptrk 2.2 cnfrsrc 2.2 256 252207 y 1 e 512 4096 2 5 26000 100000
ip cef ! interface Loopback0ip address 192.103.210.5 255.255.255.255
! interface ATM0/0/0no ip address tag-con trol-protocol vsi
! interface XTagATM13ip unnumbered Loopback0 extended-port ATM0/0/0 bpx 1.3 tag-switching atm vpi 2-15 tag-switching ip
! interface XTagATM22ip unnumbered Loopback0 extended-port ATM0/0/0 bpx 2.2 tag-switching atm vpi 2-5 tag-switching ip
! tag-switching atm disable-headend-vc
7500 LSR1:ip cef distributed ! interface loopback 0
ip address 142.6.132.2 255.255.255.255
! interface ATM2/0/0no ip address
! interface ATM2/0/0.5 tag-switchingip unnumbered loopback 0 tag-switching atm vpi 2-5 tag-switching ip
7500 LSR2:ip cef distributed ! interface loopback 0
ip address 142.6.142.2 255.255.255.255
! interface ATM2/0/0no ip address
! interface ATM2/0/0.9 tag-switchingunnumbered loopback 0 tag-switching atm vpi 2-5 tag-switching ip
The network topology shown in Figure 10 incorporates two ATM-LSRs using virtual trunking to create an MPLS network through a private ATM Network. This topology includes two LSCs (Cisco 7200 and 7500 routers), two BPX Service Nodes, and two edge LSRs (Cisco 7500 and 7200 routers).
Based on Figure 10, the following configuration examples are provided:
7200 LSC1:ip cef ! interface loopback0
ip address 192.103.210.5 255.255.255.255
! interface ATM3/0no ip address tag-control-protocol vsi
! interface XTagATM132extended-port ATM3/0 bpx 1.3.2 ip unnumbered loopback0 tag-switching atm vp-tunnel 2 no ip route-cache cef tag-switching ip
! interface XTagATM22extended-port ATM3/0 bpx 2.2 ip unnumbered loopback0 tag-switching atm vpi 2-5 no ip route-cache cef tag-switching ip
BPX1 and BPX2:uptrk 1.1 addshelf 1.1 v 1 1 cnfrsrc 1.1 256 252207 y 1 e 512 6144 2 15 26000 100000 uptrk 1.3.2 cnftrk 1.3.2 100000 N 1000 7F V,TS,NTS,FR,FST,CBR,NRT-VBR,ABR,RT-VBR N TERRESTRIAL 10 0 N N Y Y Y CBR 2 cnfrsrc 1.3.2 256 252207 y 1 e 512 6144 2 2 26000 100000 uptrk 2.2 cnfrsrc 2.2 256 252207 y 1 e 512 4096 2 5 26000 100000
7500 LSC2:ip cef distributed ! interface loopback0
ip address 142.2.143.22 255.255.255.255
! interface ATM3/0/0no ip address tag-control-protocol vsi
! interface XTagATM132extended-port ATM3/0/0 bpx 1.3.2 ip unnumbered loopback0 tag-switching atm vp-tunnel 2 no ip route-cache cef tag-switching ip
! interface XTagATM22extended-port ATM3/0/0 bpx 2.2 ip unnumbered loopback0 tag-switching atm vpi 2-5 no ip route-cache cef
tag-switching ip
7500 LSR1:ip cef distributed interface loopback 0
ip address 142.6.132.2 255.255.255.255
! interface ATM2/0/0no ip address
! interface ATM2/0/0.5 tag-switchingip unnumbered loopback 0 tag-switching atm vpi 2-5 tag-switching ip
7200 LSR2:ip cef interface loopback 0
ip address 142.6.142.2 255.255.255.255
! interface ATM2/0no ip address
! interface ATM2/0.9 tag-switchingip unnumbered loopback 0 tag-switching atm vpi 2-5 tag-switching ip
The network topology shown in Figure 11 incorporates two ATM-LSRs using virtual trunking to create an MPLS network through a private ATM Network. This topology includes two LSCs (Cisco 6400 UAC NRP routers), two BPX Service Nodes, and two edge LSRs (Cisco 7500 and 7200 routers).
Based on Figure 11, the following configuration examples are provided:
6400 NSP:! interface ATM3/0/0
atm pvp 0 interface ATM1/0/0 0 atm pvp 2 interface ATM1/0/0 2 atm pvp 3 interface ATM1/0/0 3 atm pvp 4 interface ATM1/0/0 4 atm pvp 5 interface ATM1/0/0 5 atm pvp 6 interface ATM1/0/0 6 atm pvp 7 interface ATM1/0/0 7 atm pvp 8 interface ATM1/0/0 8 atm pvp 9 interface ATM1/0/0 9 atm pvp 10 interface ATM1/0/0 10 atm pvp 11 interface ATM1/0/0 11 atm pvp 12 interface ATM1/0/0 12 atm pvp 13 interface ATM1/0/0 13 atm pvp 14 interface ATM1/0/0 14 atm pvp 15 interface ATM1/0/0 15
|
Note Instead of configuring multiple PVCs, you can also configure PVP 0 by deleting all well-known VCs. For example, you can use the command atm manual-well-known-vc delete on both interfaces and then configure PVP 0, as indicated below: atm pvp 0 interface ATM1/0/0 0 |
ip cef ! interface Loopback0ip address 142.2.143.22 255.255.255.255
! interface ATM0/0/0no ip address tag-control-protocol vsi
! interface XTagATM132ip unnumbered Loopback0 extended-port ATM0/0/0 bpx 1.3.2 tag-switching atm vp-tunnel 2 tag-switching ip
! interface XTagATM22ip unnumbered Loopback0 extended-port ATM0/0/0 bpx 2.2 tag-switching atm vpi 2-5 tag-switching ip
! tag-switching atm disable-headend-vc
BPX1 and BPX2:uptrk 1.1 addshelf 1.1 v 1 1 cnfrsrc 1.1 256 252207 y 1 e 512 6144 2 15 26000 100000 uptrk 1.3.2 cnftrk 1.3.2 100000 N 1000 7F V,TS,NTS,FR,FST,CBR,NRT-VBR,ABR,RT-VBR N TERRESTRIAL 10 0 N N Y Y Y CBR 2 cnfrsrc 1.3.2 256 252207 y 1 e 512 6144 2 2 26000 100000 uptrk 2.2 cnfrsrc 2.2 256 252207 y 1 e 512 4096 2 5 26000 100000
ip cef ! interface Loopback0ip address 192.103.210.5 255.255.255.255
! interface ATM0/0/0no ip address tag-con trol-protocol vsi
! interface XTagATM132ip unnumbered Loopback0 extended-port ATM0/0/0 bpx 1.3.2 tag-switching atm vp-tunnel 2 tag-switching ip
! interface XTagATM22ip unnumbered Loopback0 extended-port ATM0/0/0 bpx 2.2 tag-switching atm vpi 2-5 tag-switching ip
! tag-switching atm disable-headend-vc
7500 LSR1:ip cef distributed ! interface loopback 0
ip address 142.6.132.2 255.255.255.255
! interface ATM2/0/0no ip address
! interface ATM2/0/0.5 tag-switchingip unnumbered loopback 0 tag-switching atm vpi 2-5 tag-switching ip
7500 LSR2:ip cef distributed ! interface loopback 0
ip address 142.6.142.2 255.255.255.255
! interface ATM2/0/0no ip address
! interface ATM2/0/0.9 tag-switchingunnumbered loopback 0 tag-switching atm vpi 2-5 tag-switching ip
This section describes the CLI commands that you can use in conjunction with the MPLS LSC:
All other commands used with this feature are documented in the Cisco IOS Release 12.0 command reference publications.
Cisco IOS Release 12.0(1)T or later enables you to search and filter the output for the show and more commands. This capability helps you to sort through large amounts of output, or to exclude output that you do not need.
To use this functionality, enter a show or more command, followed by the "pipe" character (|), one of the keywords begin, include, or exclude, and an expression that you want to search or filter on:
command | {begin | include | exclude} regular-expressionAn example of a show atm vc command follows, which indicates that you want the command output to begin with the first line containing the "PeakRate" expression:
show atm vc | begin PeakRateFor more information about the search and filter capability, refer to the Cisco IOS Release 12.0(1)T feature module entitled CLI String Search.
boldface font | Commands and keywords are in boldface type. |
italic font | Arguments for which you supply values are in italics. In a context that does not allow italics, arguments are enclosed in angle brackets < >. |
[ ] | Elements in square brackets are optional. |
{ x | y | z } | Alternative keywords are grouped in braces and separated by vertical bars. |
[ x | y | z ] | Optional keywords are grouped in brackets and separated by vertical bars. |
To associate the currently selected extended MPLS ATM (XTagATM) interface with a particular external interface on the remotely controlled ATM switch, use the following interface configuration command.
extended-port ctrl-if {bpx bpx-port-number | descriptor vsi-descriptor | vsi vsi-port-number }
Syntax Description
ctrl-if Identifies the ATM interface used to control the remote ATM switch. You must configure VSI on this interface using the tag-control-protocol interface configuration command. bpx bpx-port-number Specifies the associated Cisco BPX interface using the native BPX syntax. slot.port [.virtual port] You can only use this form of the command when the controlled switch is a Cisco BPX switch. descriptor vsi-descriptor Specifies the associated port by its VSI physical descriptor. Note that the vsi-descriptor string must exactly match the corresponding VSI physical descriptor. vsi vsi-port-number Specifies the associated port by its VSI physical descriptor. The vsi-descriptor string must exactly match the corresponding VSI physical descriptor.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
The extended-port interface configuration command associates an XTagATM interface with a particular external interface on the remotely controlled ATM switch. The three alternate forms of the command permit the external interface on the controlled ATM switch to be specified in three different ways.
Examples
The following example shows you how to create an extended MPLS ATM interface and bind it to BPX port 2.3.
interface XTagATM0 extended-port atm0/0 bpx 2.3
Related Commands
interface XTagATM Enters interface configuration mode for an extended MPLS ATM (XTagATM) interface.
Command
Description
To enter interface configuration mode for the extended MPLS ATM (XTagATM) interface, use the following interface XTagATM global configuration command. The interface is created the first time this command is issued for a particular interface number.
interface XTagATM if-num
Syntax Description
if-num Specifies the interface number.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
Extended MPLS ATM interfaces are virtual interfaces that are created on first reference-like tunnel interfaces. Extended MPLS ATM interfaces are similar to ATM interfaces except that the former only supports LC-ATM encapsulation.
Examples
The following example shows how you create an extended MPLS ATM interface with interface number 62:
(config)# interface XTagATM62
Related Commands
extended-port Associates the currently selected extended MPLS ATM (XTagATM) interface with a remotely controlled switch.
Command
Description
To display information about private ATM virtual circuits (VCs), use the following show atm vc privileged EXEC command.
show atm vc [vcd]Private VCs exist on the control interface of an MPLS LSC to support corresponding VCs on an extended MPLS ATM interface.
Syntax Description
vcd (Optional). Specifies the virtual circuit to display information about.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
VCs on the extended MPLS ATM interfaces do not appear in the show atm vc command output. Instead, the show xtagatm vc command provides similar output which shows information only on extended MPLS ATM VCs.
Examples
In the following example, no VCD is specified and private VCs are present.
Router# show atm vc AAL / Peak Avg. Burst Interface VCD VPI VCI Type Encapsulation Kbps Kbps Cells Status ATM1/0 1 0 40 PVC AAL5-SNAP 0 0 0 ACTIVE ATM1/0 2 0 41 PVC AAL5-SNAP 0 0 0 ACTIVE ATM1/0 3 0 42 PVC AAL5-SNAP 0 0 0 ACTIVE ATM1/0 4 0 43 PVC AAL5-SNAP 0 0 0 ACTIVE ATM1/0 5 0 44 PVC AAL5-SNAP 0 0 0 ACTIVE ATM1/0 15 1 32 PVC AAL5-XTAGATM 0 0 0 ACTIVE ATM1/0 17 1 34 TVC AAL5-XTAGATM 0 0 0 ACTIVE ATM1/0 26 1 43 TVC AAL5-XTAGATM 0 0 0 ACTIVE ATM1/0 28 1 45 TVC AAL5-XTAGATM 0 0 0 ACTIVE ATM1/0 29 1 46 TVC AAL5-XTAGATM 0 0 0 ACTIVE ATM1/0 33 1 50 TVC AAL5-XTAGATM 0 0 0 ACTIVE
When you specify a VCD value and the VCD corresponds to that of a private VC on a control interface, the display output appears as follows:
Router# show atm vc 15 ATM1/0 33 1 50 TVC AAL5-XTAGATM 0 0 0 ACTIVE
ATM1/0: VCD: 15, VPI: 1, VCI: 32, etype:0x8, AAL5 - XTAGATM, Flags: 0xD38 PeakRate: 0, Average Rate: 0, Burst Cells: 0, VCmode: 0x0
XTagATM1, VCD: 1, VPI: 0, VCI: 32
OAM DISABLED, InARP DISABLED
InPkts: 38811, OutPkts: 38813, InBytes: 2911240, OutBytes: 2968834
InPRoc: 0, OutPRoc: 0, Broadcasts: 0
InFast: 0, OutFast: 0, InAS: 0, OutAS: 0
OAM F5 cells sent: 0, OAM cells received: 0
Status: ACTIVE
Table 3 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
ATM1/0 | Interface slot and number. |
VCD | Virtual circuit descriptor (virtual circuit number). |
VPI | Virtual path identifier. |
VCI | Virtual circuit identifier. |
etype | Ethernet type. |
AAL5 - XTAGATM | Type of ATM adaptation layer (AAL) and encapsulation. A private VC has AAL5 and encapsulation XTAGATM. |
Flags | Bit mask describing virtual circuit information. The flag values are summed to result in the displayed value. 0x10000 ABR VC 0x10 ACTIVE 0x6 AAL5-ILMI |
PeakRate | Number of packets transmitted at the peak rate. |
Average Rate | Number of packets transmitted at the average rate. |
Burst Cells | Value that, when multiplied by 32, equals the maximum number of ATM cells the virtual circuit can transmit at the peak rate of the virtual circuit. |
VCmode | AIP-specific or NPM-specific register describing the usage of the virtual circuit. Contains values such as rate queue, peak rate, and AAL mode, which are also displayed in other fields. |
XTagATM1 | Interface of corresponding extended MPLS ATM VC. |
VCD | Virtual circuit descriptor (virtual circuit number) of the corresponding extended MPLS ATM VC. |
VPI | Virtual path identifier of the corresponding extended MPLS ATM VC. |
VCI | Virtual channel identifier of the corresponding extended MPLS ATM VC. |
OAM frequency | Seconds between OAM loopback messages or DISABLED if OAM is not in use on this VC. |
InARP frequency | Minutes between InARP messages, or DISABLED if InARP is not in use on this VC. |
InPkts | Total number of packets received on this virtual circuit. This number includes all silicon-switched, fast-switched, autonomous-switched, and process-switched packets. |
OutPkts | Total number of packets sent on this virtual circuit. This number includes all silicon-switched, fast-switched, autonomous-switched, and process-switched packets. |
InBytes | Total number of bytes received on this virtual circuit. This number includes all silicon-switched, fast-switched, autonomous-switched, and process-switched packets. |
OutBytes | Total number of bytes sent on this virtual circuit. This number includes all silicon-switched, fast-switched, autonomous-switched, and process-switched packets. |
InPRoc | Number of process-switched input packets. |
OutPRoc | Number of process-switched output packets. |
Broadcasts | Number of process-switched broadcast packets. |
InFast | Number of fast-switched input packets. |
OutFast | Number of fast-switched output packets. |
InAS | Number of autonomous-switched or silicon-switched input packets. |
OutAS | Number of autonomous-switched or silicon-switched output packets. |
OAM F5 cells sent | Number of OAM cells sent on this virtual circuit. |
OAM cells received | Number of OAM cells received on this virtual circuit. |
Status | Displays the current state of the specified ATM interface. |
To display information about an extended MPLS ATM interface, use the following show interface XTagATM EXEC command.
show interface XTagATM if-num
Syntax Description
if-num Specifies the MPLS ATM interface number.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
Extended MPLS ATM interfaces are virtual interfaces that are created on first reference like tunnel interfaces. Extended MPLS ATM interfaces are similar to ATM interfaces except that the former only supports LC-ATM encapsulation.
Examples
The following is sample output from the show interface XTagATM command:
Router# show interface XTagATM0
XTagATM0 is up, line protocol is up
Hardware is Tag-Controlled Switch Port
Interface is unnumbered. Using address of Loopback0 (12.0.0.17)
MTU 4470 bytes, BW 156250 Kbit, DLY 80 usec, rely 255/255, load 1/255
Encapsulation ATM Tagswitching, loopback not set
Encapsulation(s): AAL5
Control interface: ATM1/0, switch port: bpx 10.2
9 terminating VCs, 16 switch cross-connects
Switch port traffic:
129302 cells input, 127559 cells output
Last input 00:00:04, output never, output hang never
Last clearing of "show interface" counters never
Queueing strategy: fifo
Output queue 0/0, 0 drops; input queue 0/75, 0 drops
Terminating traffic:
5 minute input rate 1000 bits/sec, 1 packets/sec
5 minute output rate 0 bits/sec, 1 packets/sec
61643 packets input, 4571695 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
53799 packets output, 4079127 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffers copied, 0 interrupts, 0 failures
Table 4 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
XTagATM0 is up | Interface is currently active. |
line protocol is up | Shows line protocol is up. |
Hardware is Tag-Controlled Switch Port | Specifies the hardware type. |
Interface is unnumbered | Specifies that this is an unnumbered interface. |
MTU | Maximum transmission unit of the extended MPLS ATM interface. |
BW | Bandwidth of the interface in kilobits per second. |
DLY | Delay of the interface in microseconds. |
rely | Reliability of the interface as a fraction of 255/ (255/255 is 100% reliability), calculated as an exponential average over 5 minutes. |
load | Load on the interface as a fraction of 255 (255/255 is completely saturated), calculated as an exponential average over 5 minutes. |
Encapsulation ATM Tagswitching | Encapsulation method. |
loopback not set | Indicates that loopback is not set. |
Encapsulation(s) | Identifies the ATM adaptation layer. |
Control interface | Identifies the control port switch port with which the extended MPLS ATM interface has been associated through the extended-port interface configuration command. |
9 terminating VCs | Number of terminating VCs with an endpoint on this extended MPLS ATM interface. Packets are transmitted and/or received by the MPLS LSC on a terminating VC, or are forwarded between an LSC-controlled switch port and a router interface. |
16 switch cross-connects | Number of switch cross-connects on the external switch with an endpoint on the switch port that corresponds to this interface. This includes cross-connects to terminating VCs that carry data to and from the LSC, as well as cross-connects that bypass the MPLS LSC and switch cells directly to other ports. |
Switch port traffic | Number of cells received and transmitted on all cross-connects associated with this interface. |
Terminating traffic counts | Indicates that counters below this line apply only to packets transmitted or received on terminating VCs. |
5-minute input rate, | Average number of bits and packets transmitted per second in the last 5 minutes. |
packets input | Total number of error-free packets received by the system. |
bytes | Total number of bytes, including data and MAC encapsulation, in the error-free packets received by the system. |
no buffer | Number of received packets discarded because there was no buffer space in the main system. Compare with ignored count. Broadcast storms on Ethernet systems and bursts of noise on serial lines are often responsible for no input buffer events. |
broadcasts | Total number of broadcast or multicast packets received by the interface. |
runts | Number of packets that are discarded because they are smaller than the medium's minimum packet size. |
giants | Number of packets that are discarded because they exceed the medium's maximum packet size. |
input errors | Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored and abort counts. Other input-related errors can also increment the count, so that this sum may not balance with other counts. |
CRC | Cyclic redundancy checksum generated by the originating LAN station or far end device does not match the checksum calculated from the data received. On a LAN, this usually indicates noise or transmission problems on the LAN interface or the LAN bus. A high number of CRCs is usually the result of traffic collisions or a station transmitting bad data. On a serial link, CRCs usually indicate noise, gain hits or other transmission problems on the data link. |
frame | Number of packets received incorrectly having a CRC error and a non integer number of octets. |
overrun | Number of times the serial receiver hardware was unable to hand received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data. |
ignored | Number of received packets ignored by the interface because the interface hardware ran low on internal buffers. These buffers are different from the system buffers mentioned previously in the buffer description. Broadcast storms and bursts of noise can cause the ignored count to be incremented. |
abort | Illegal sequence of one bits on the interface. This usually indicates a clocking problem between the interface and the data link equipment. |
packets output | Total number of messages transmitted by the system. |
bytes | Total number of bytes, including data and MAC encapsulation, transmitted by the system. |
underruns | Number of times that the transmitter has been running faster than the router can handle data. This condition may never be reported on some interfaces. |
output errors | Sum of all errors that prevented the final transmission of datagrams out of the interface being examined. Note that this may not balance with the sum of the enumerated output errors, since some datagrams may have more than one error, and others may have errors that do not fall into any of the specifically tabulated categories. |
collisions | Number of messages retransmitted due to an Ethernet collision. This is usually the result of an overextended LAN (Ethernet or transceiver cable too long, more than two repeaters between stations, or too many cascaded multiport transceivers). A packet that collides is counted only one time in output packets. |
interface resets | Number of times an interface has been completely reset. Resets occur if packets queued for transmission were not sent within several seconds. On a serial line, this can be caused by a malfunctioning modem that is not supplying the transmit clock signal, or by a cable problem. If the system notices that the carrier detect line of a serial interface is up, but the line protocol is down, it periodically resets the interface in an effort to restart it. Interface resets can also occur when an interface is looped back or shut down. |
output buffers copied | Number of packets copied from a MEMD buffer into a system buffer before being placed on the output hold queue. |
interrupts | Displays the value of hwidb to tx_restarts. |
failures | Number of packets discarded because no MEMD buffer was available. |
Related Commands
interface XTagATM Enters configuration mode for an extended MPLS ATM (XTagATM) interface.
Command
Description
To display information about an extended MPLS ATM interface controlled through the VSI protocol (or, if an interface is not specified, to display information about all extended MPLS ATM interfaces controlled through the VSI protocol), use the following show controllers XTagATM EXEC command.
show controllers XTagATM if-num
Syntax Description
if-num Specifies the interface number.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
Per-interface information includes the following:
Similar information appears if you enter the show controllers vsi descriptor command. However, you must specify an interface by its (switch-supplied) physical descriptor, instead of its IOS interface name. For the Cisco BPX switch, the physical descriptor has the form:
slot.port.0
Examples
In this example, the sample output is from the show controllers XTagATM command specifying interface 0.
Router# show controllers XTagATM 0 Interface XTagATM0 is up
Hardware is Tag-Controlled ATM Port (on BPX switch BPX-VSI1)
Control interface ATM1/0 is up
Physical descriptor is 10.2.0
Logical interface 0x000A0200 (0.10.2.0)
Oper state ACTIVE, admin state UP
VPI range 1-255, VCI range 32-65535
VPI is not translated at end of link
Tag control VC need not be strictly in VPI/VCI range
Available channels: ingress 30, egress 30
Maximum cell rate: ingress 300000, egress 300000
Available cell rate: ingress 300000, egress 300000
Endpoints in use: ingress 7, egress 8, ingress/egress 1
Rx cells 134747
rx cells discarded 0, rx header errors 0
rx invalid addresses (per card): 52994
last invalid address 0/32
Tx cells 132564
tx cells discarded: 0
Table 5 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
Interface XTagATM0 is up | Indicates the overall status of the interface. May be "up," "down," or "administratively down." |
Hardware is Tag-Controlled ATM Port | Indicates the hardware type. If the XTagATM was successfully associated with a switch port, a description of the form "(on <switch_type> switch <name)" follows this field, where <switch_type> indicates the type of switch (for example, BPX), and "name" is an identifying string learned from the switch. If the XTagATM interface was not bound to a switch interface (with the extended-port interface configuration command), then the label "Not bound to a control interface and switch port" appears. If the interface has been bound, but the target switch interface has not been discovered by the LSC, then the label "Bound to undiscovered switch port (id <number>)" appears, where <number> is the logical interface ID in hexadecimal notation. |
Control interface ATM1/0 is up | Indicates that the XTagATM interface was bound (with the extended-port interface configuration command) to the VSI master whose control interface is ATM1/0 and that this control interface is up. |
Physical descriptor is... | A string identifying the interface which was learned from the switch. |
Logical interface | This 32-bit entity, learned from the switch, uniquely identifies the interface. It appears in both hexadecimal and dotted quad notation. |
Oper state | Operational state of the interface, according to the switch. Can be one of the following:
|
admin state | Administrative state of the interface, according to the switch---Either Up or Down. |
VPI range 1 to 255 | Indicates the allowable VPI range for the interface which was configured on the switch. |
VCI range 32 to 65535 | Indicates the allowable VCI range for the interface which was configured on, or determined by, the switch. |
LSC control VC need not be strictly in VPI or VCI range | Indicates that the label control VC does not need to be within the range specified by VPI range, but may be on VPI 0 instead. |
Available channels | Indicates the number of channels (endpoints) which are currently free to be used for cross-connects. |
Maximum cell rate | Maximum cell rate for the interface, which was configured on the switch. |
Available cell rate | Cell rate which is currently available for new cross-connects on the interface. |
Endpoints in use | Number of endpoints (channels) in use on the interface, broken down by anticipated traffic flow, as follows:
|
Rx cells | Number of cells received on the interface. |
rx cells discarded | Number of cells received on the interface which were discarded due to traffic management actions (rx header errors). |
rx header errors | Number of cells received on the interface with cell header errors. |
rx invalid addresses (per card) | Number of cells received with invalid addresses (that is, unexpected VPI or VCI.). On the BPX, this counter is maintained per port group (not per interface). |
last invalid address | Address of the last cell received on the interface with an invalid address (for example, 0/32). |
Tx cells | Number of cells transmitted from the interface. |
tx cells discarded | Number of cells intended for transmission from the interface that were discarded due to traffic management actions. |
Related Commands
show controllers vsi descriptor Displays information about a switch interface discovered by the MPLS LSC through the VSI.
Command
Description
To display information about an ATM interface configured with the tag-control-protocol vsi EXEC command to control an external switch (or if an interface is not specified, to display information about all VSI control interfaces), use the following show controllers vsi control-interface command.
show controllers vsi control-interface [interface]
Syntax Description
interface (Optional). Specifies the interface number.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
Examples
The following is sample output from the show controllers vsi control-interface command:
Router# show controllers vsi control-interface Interface: ATM2/0 Connections: 14
The display shows the number of cross-connects currently on the switch that were established by the MPLS LSC through the VSI over the control interface.
Related Commands
tag-control-protocol vsi Configures the use of VSI on a control port.
Command
Description
To display information about a switch interface discovered by the MPLS LSC through VSI, or if no descriptor is specified, about all such discovered interfaces, use the following show controllers vsi descriptor EXEC command. You specify an interface by its (switch-supplied) physical descriptor.
show controllers vsi descriptor [descriptor]
Syntax Description
descriptor (Optional). Physical descriptor. For the Cisco BPX switch, the physical descriptor has the following form: slot.port.0
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
Per-interface information includes the following:
Similar information is displayed when you enter the show controllers XTagATM command. However, you must specify an IOS interface name instead of a physical descriptor.
Examples
The following is sample output from the show controllers vsi descriptor command:
Router# show controllers vsi descriptor 12.2.0 Phys desc: 12.2.0 Log intf: 0x000C0200 (0.12.2.0) Interface: XTagATM0 IF status: up IFC state: ACTIVE
Min VPI: 1 Maximum cell rate: 10000
Max VPI: 259 Available channels: 2000
Min VCI: 32 Available cell rate (forward): 10000
Max VCI: 65535 Available cell rate (backward): 10000
Table 6 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
Phys desc | Physical descriptor. A string learned from the switch which identifies the interface. |
Log intf | Logical interface ID. This 32-bit entity, learned from the switch, uniquely identifies the interface. |
Interface | The (IOS) interface name. |
IF status | Overall interface status. Can be "up," "down," or "administratively down." |
Min VPI | Minimum virtual path identifier. Indicates the low end of the VPI range configured on the switch. |
Max VPI | Maximum virtual path identifier. Indicates the high end of the VPI range configured on the switch. |
Min VCI | Minimum virtual path identifier. Indicates the high end of the VPI range configured on the switch. |
Max VCI | Maximum virtual channel identifier. Indicates the high end of the VCI range configured on, or determined by, the switch. |
IFC state | Operational state of the interface, according to the switch. Can be one of the following:
|
Maximum cell rate | Maximum cell rate for the interface, which has been configured on the switch, in cells per second. |
Available channels | Indicates the number of channels (endpoints) that are currently free to be used for cross-connects. |
Available cell rate (forward) | Cell rate that is currently available in the forward (that is, ingress) direction for new cross-connects on the interface. |
Available cell rate (backward) | Cell rate that is currently available in the backward (that is, egress) direction for new cross-connects on the interface. |
Related Commands
show controllers XTagATM Displays information about an extended MPLS ATM interface.
Command
Description
To display information about all sessions with VSI slaves, use the following show controllers vsi session EXEC command.
show controllers vsi session [session-num [interface interface]] |
Note A session consists of an exchange of VSI messages between the VSI master (the LSC) and a VSI slave (an entity on the switch). There can be multiple VSI slaves for a switch. On the BPX, each port or trunk card assumes the role of a VSI slave. |
Syntax Description
session-num Specifies the session number. interface interface Specifies the VSI control interface.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
If a session number and an interface are specified, detailed information on the individual session is presented. If the session number is specified, but the interface is omitted, detailed information on all sessions with that number is presented. (Only one session can contain a given number in the first release, since multiple control interfaces are not supported.)
Examples
The following is sample output from the show controllers vsi session command:
Router# show controllers vsi session Interface Session VCD VPI/VCI Switch/Slave Ids Session State ATM0/0 0 1 0/40 0/1 ESTABLISHED
ATM0/0 1 2 0/41 0/2 ESTABLISHED
ATM0/0 2 3 0/42 0/3 DISCOVERY
ATM0/0 3 4 0/43 0/4 RESYNC-STARTING
ATM0/0 4 5 0/44 0/5 RESYNC-STOPPING
ATM0/0 5 6 0/45 0/6 RESYNC-UNDERWAY
ATM0/0 6 7 0/46 0/7 UNKNOWN
ATM0/0 7 8 0/47 0/8 UNKNOWN
ATM0/0 8 9 0/48 0/9 CLOSING
ATM0/0 9 10 0/49 0/10 ESTABLISHED
ATM0/0 10 11 0/50 0/11 ESTABLISHED
ATM0/0 11 12 0/51 0/12 ESTABLISHED
Table 7 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
Interface | Control interface name. |
Session | Session number (from 0 to <n-1>), where n is the number of sessions on the control interface. |
VCD | Virtual circuit descriptor (virtual circuit number). Identifies the VC carrying the VSI protocol between the master and the slave for this session. |
VPI/VCI | Virtual path identifier/virtual channel identifier (for the VC used for this session). |
Switch/Slave Ids | Switch and slave identifiers supplied by the switch. |
Session State | Indicates the status of the session between the master and the slave.
Other possible states include the following: CONFIGURING |
In the following example, session number 9 is specified with the show controllers vsi session command:
Router# show controllers vsi session 9 Interface: ATM1/0 Session number: 9 VCD: 10 VPI/VCI: 0/49 Switch type: BPX Switch id: 0 Controller id: 1 Slave id: 10 Keepalive timer: 15 Powerup session id: 0x0000000A Cfg/act retry timer: 8/8 Active session id: 0x0000000A Max retries: 10 Ctrl port log intf: 0x000A0100 Trap window: 50 Max/actual cmd wndw: 21/21 Trap filter: all Max checksums: 19 Current VSI version: 1 Min/max VSI version: 1/1 Messages sent: 2502 Inter-slave timer: 4.000 Messages received: 2502 Messages outstanding: 0
Table 8 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
Interface | Name of the control interface on which this session is configured. |
Session number | A number from 0 to <n-1>, where n is the number of slaves. Configured on the MPLS LSC with the slaves option of the tag-control-protocol vsi command. |
VCD | Virtual circuit descriptor (virtual circuit number). Identifies the VC which carries VSI protocol messages for this session. |
VPI/VCI | Virtual path identifier or virtual channel identifier for the VC used for this session. |
Switch type | Switch device (for example, the BPX). |
Switch id | Switch identifier (supplied by the switch). |
Controller id | Controller identifier. Configured on the LSC, as well as on the switch, with the id option of the tag-control-protocol vsi command. |
Slave id | Slave identifier (supplied by the switch). |
Keepalive timer | VSI master keepalive timeout period, in seconds. Configured on the MPLS LSC through the keepalive option of the tag-control-protocol-vsi command. If no valid message is received by the MPLS LSC within this time period, it sends a keepalive message to the slave. |
Powerup session id | Session id (supplied by the slave) used at powerup time. |
Cfg/act retry timer | Configured and actual message retry timeout period, in seconds. If no response is received for a command sent by the master within the actual retry timeout period, the message is resent. This applies to most message transmissions. The configured retry timeout value is specified through the retry option of the tag-control-protocol vsi command. The actual retry timeout value is the larger of the configured value and the minimum retry timeout value permitted by the switch. |
Active session id | Session ID for the currently active session (supplied by the slave). |
Max retries | Maximum number of times that a particular command transmission will be retried by the master. That is, a message may be sent up to <max_retiries+1> times. Configured on the MPLS LSC through the retry option of the tag-control-protocol vsi command. |
Ctrl port log intf | Logical interface identifier for the control port, as supplied by the switch. |
Trap window | Maximum number of outstanding trap messages permitted by the master. This is advertised, but not enforced, by the LSC. |
Max/actual cmd wndw | Maximum command window is the maximum number of outstanding (that is, unacknowledged) commands that may be sent by the master before waiting for acknowledgments. This number is communicated to the master by the slave. The command window is the maximum number of outstanding commands that are permitted by the master, before it waits for acknowledgments. This is always less than the maximum command window. |
Trap filter | This is always "all" for the LSC, indicating that it wants to receive all traps from the slave. This is communicated to the slave by the master. |
Max checksums | Maximum number of checksum blocks supported by the slave. (In this release, the MPLS LSC uses only one checksum block.) |
Current VSI version | VSI protocol version currently in use by the master for this session. (In the first release, this is always 1.) |
Min/max VSI version | Minimum and maximum VSI versions supported by the slave, as last reported by the slave. If both are zero, the slave has not yet responded to the master. |
Messages sent | Number of commands sent to the slave. |
Inter-slave timer | Timeout value associated by the slave for messages it sends to other slaves. On a VSI-controlled switch with a distributed slave implementation (such as the BPX), VSI messages may be sent between slaves to complete their processing. For the MPLS LSC VSI implementation to function properly, the value of its retry timer is forced to be at least two times the value of the inter-slave timer. (See "Cfg/act retry timer" in this table.) |
Messages received | Number of responses and traps received by the master from the slave for this session. |
Messages outstanding | Current number of outstanding messages (that is, commands sent by the master for which responses have not yet been received). |
Related Commands
tag-control-protocol vsi Configures the use of VSI on a control port.
Command
Description
To display a one-line summary of each VSI-controlled interface, use the following show controllers vsi status EXEC command.
show controllers vsi statusSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Related Commands
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
If an interface has been discovered by the LSC, but no extended MPLS ATM interface has been associated with it through the extended-port interface configuration command, then the interface name is marked <unknown>, and interface status is marked n/a.
Examples
The following is sample output from the show controllers vsi status command:
Router# show controllers vsi status Interface Name IF Status IFC State Physical Descriptor
switch control port n/a ACTIVE 12.1.0
XTagATM0 up ACTIVE 12.2.0
XTagATM1 up ACTIVE 12.3.0
<unknown> n/a FAILED-EXT 12.4.0
Table 9 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
Interface Name | The (IOS) interface name. |
IF Status | Overall interface status. Can be "up," "down," or "administratively down." |
IFC State | The operational state of the interface, according to the switch. Can be one of the following:
|
Physical Descriptor | A string learned from the switch that identifies the interface. |
To display traffic information about VSI-controlled interfaces, VSI sessions, or VCs on VSI-controlled interfaces, use the following show controllers vsi traffic EXEC command.
show controllers vsi traffic [{ descriptor descriptor | session session-num |vc [descriptor descriptor [vpi vci ]]}]
Syntax Description
descriptor descriptor Specifies the interface. session session-num Specifies a session number. vpi Virtual path identifier. vci Virtual circuit identifier.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
If none of the optional command parameters is specified, traffic for all interfaces is displayed. You can specify a single interface by its (switch-supplied) physical descriptor. For the BPX, the physical descriptor has the form:
slot.port. 0
If a session number is specified, VSI protocol traffic counts by message type are displayed. The VC traffic display is the same as the one produced by the show xtagatm vc cross-connect traffic descriptor command.
Examples
The following is sample output from the show controllers vsi traffic command:
Router# show controllers vsi traffic
Phys desc: 10.1.0
Interface: switch control port
IF status: n/a
Rx cells: 304250 Rx cells discarded: 0
Tx cells: 361186 Tx cells discarded: 0
Rx header errors: 4294967254 Rx invalid addresses (per card): 80360
Last invalid address: 0/53
Phys desc: 10.2.0
Interface: XTagATM0
IF status: up
Rx cells: 202637 Rx cells discarded: 0
Tx cells: 194979 Tx cells discarded: 0
Rx header errors: 4294967258 Rx invalid addresses (per card): 80385
Last invalid address: 0/32
Phys desc: 10.3.0
Interface: XTagATM1
IF status: up
Rx cells: 182295 Rx cells discarded: 0
Tx cells: 136369 Tx cells discarded: 0
Rx header errors: 4294967262 Rx invalid addresses (per card): 80372
Last invalid address: 0/32
Table 10 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
Phys desc | Physical descriptor of the interface. |
Interface | The (IOS) interface name. |
Rx cells | Number of cells received on the interface. |
Tx cells | Number of cells transmitted on the interface. |
Rx cells discarded | Number of cells received on the interface which were discarded due to traffic management. |
Tx cells discarded | Number of cells which could not be transmitted on the interface due to traffic management and which were therefore discarded. |
Rx header errors | Number of cells which were discarded due to ATM header errors. |
Rx invalid addresses | Number of cells received with an invalid address (that is, an unexpected VPI/VCI combination). With the Cisco BPX switch, this count is of all such cells received on all interfaces in the port group of this interface. |
Last invalid address | Number of cells received on this interface with ATM cell header errors. |
The following sample output is displayed when you enter the show controllers vsi traffic session 9 command:
Router# show controllers vsi traffic session 9
Sent Received
Sw Get Cnfg Cmd: 3656 Sw Get Cnfg Rsp: 3656
Sw Cnfg Trap Rsp: 0 Sw Cnfg Trap: 0
Sw Set Cnfg Cmd: 1 Sw Set Cnfg Rsp: 1
Sw Start Resync Cmd: 1 Sw Start Resync Rsp: 1
Sw End Resync Cmd: 1 Sw End Resync Rsp: 1
Ifc Getmore Cnfg Cmd: 1 Ifc Getmore Cnfg Rsp: 1
Ifc Cnfg Trap Rsp: 4 Ifc Cnfg Trap: 4
Ifc Get Stats Cmd: 8 Ifc Get Stats Rsp: 8
Conn Cmt Cmd: 73 Conn Cmt Rsp: 73
Conn Del Cmd: 50 Conn Del Rsp: 0
Conn Get Stats Cmd: 0 Conn Get Stats Rsp: 0
Conn Cnfg Trap Rsp: 0 Conn Cnfg Trap: 0
Conn Bulk Clr Stats Cmd: 0 Conn Bulk Clr Stats Rsp: 0
Gen Err Rsp: 0 Gen Err Rsp: 0
unused: 0 unused: 0
unknown: 0 unknown: 0
TOTAL: 3795 TOTAL: 3795
Table 11 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
Sw Get Cnfg Cmd | Number of VSI "get switch configuration command" messages sent. |
Sw Cnfg Trap Rsp | Number of VSI "switch configuration asynchronous trap response" messages sent. |
Sw Set Cnfg Cmd | Number of VSI "set switch configuration command" messages sent. |
Sw Start Resync Cmd | Number of VSI "set resynchronization start command" messages sent. |
Sw End Resync Cmd | Number of VSI "set resynchronization end command" messages sent. |
Ifc Getmore Cnfg Cmd | Number of VSI "get more interfaces configuration command" messages sent. |
Ifc Cnfg Trap Rsp | Number of VSI "interface configuration asynchronous trap response" messages sent. |
Ifc Get Stats Cmd | Number of VSI "get interface statistics command" messages sent. |
Conn Cmt Cmd | Number of VSI "set connection committed command" messages sent. |
Conn Del Cmd | Number of VSI "delete connection command" messages sent. |
Conn Get Stats Cmd | Number of VSI "get connection statistics command" messages sent. |
Conn Cnfg Trap Rsp | Number of VSI "connection configuration asynchronous trap response" messages sent. |
Conn Bulk Clr Stats Cmd | Number of VSI "bulk clear connection statistics command" messages sent. |
Gen Err Rsp | Number of VSI "generic error response" messages sent or received. |
Sw Get Cnfg Rsp | Number of VSI "get connection configuration command response" messages received. |
Sw Cnfg Trap | Number of VSI "switch configuration asynchronous trap" messages received. |
Sw Set Cnfg Rsp | Number of VSI "set switch configuration response" messages received. |
Sw Start Resync Rsp | Number of VSI "set resynchronization start response" messages received. |
Sw End Resync Rsp | Number of VSI "set resynchronization end response" messages received. |
Ifc Getmore Cnfg Rsp | Number of VSI "get more interfaces configuration response" messages received. |
Ifc Cnfg Trap | Number of VSI "interface configuration asynchronous trap" messages received. |
Ifc Get Stats Rsp | Number of VSI "get interface statistics response" messages received. |
Conn Cmt Rsp | Number of VSI "set connection committed response" messages received. |
Conn Del Rsp | Number of VSI "delete connection response" messages received. |
Conn Get Stats Rsp | Number of VSI "get connection statistics response" messages received. |
Conn Cnfg Trap | Number of VSI "connection configuration asynchronous trap" messages received. |
Conn Bulk Clr Stats Rsp | Number of VSI "bulk clear connection statistics response" messages received. |
unused, unknown | "Unused" messages are those whose function codes are recognized as being part of the VSI protocol, but which are not used by the MPLS LSC and, consequently, are not expected to be received or sent. "Unknown" messages have function codes which the MPLS LSC does not recognize as part of the VSI protocol. |
TOTAL | Total number of VSI messages sent or received. |
To display the requested entries from the ATM LDP label bindings database, use the following show tag-switching atm-tdp bindings EXEC command.
show tag-switching atm-tdp bindings [A.B.C.D {mask | length}]
Syntax Description
A.B.C.D Destination of prefix. mask Destination netmask prefix. length Netmask length, in the range from 1 to 32. local-tag vpi vci Matches locally assigned label values. neighbor atm slot/subslot/port Matches labels assigned by a neighbor on the specified ATM interface. remote-tag vpi vci Matches remotely assigned label values.
Defaults
Displays all database entries.
Command Modes
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
The display output can show the entire database or a subset of entries based on the prefix, the VC label value, or an assigning interface.
Examples
The following is sample output from this command.
Switch# show tag-switching atm-tdp bindings Destination: 13.13.13.6/32 Headend Router ATM1/0.1 (2 hops) 1/33 Active, VCD=8, CoS=available Headend Router ATM1/0.1 (2 hops) 1/34 Active, VCD=9, CoS=standard Headend Router ATM1/0.1 (2 hops) 1/35 Active, VCD=10, CoS=premium Headend Router ATM1/0.1 (2 hops) 1/36 Active, VCD=11, CoS=control Destination: 102.0.0.0/8 Headend Router ATM1/0.1 (1 hop) 1/37 Active, VCD=4, CoS=available Headend Router ATM1/0.1 (1 hop) 1/34 Active, VCD=5, CoS=standard Headend Router ATM1/0.1 (1 hop) 1/35 Active, VCD=6, CoS=premium Headend Router ATM1/0.1 (1 hop) 1/36 Active, VCD=7, CoS=control Destination: 13.0.0.18/32 Tailend Router ATM1/0.1 1/33 Active, VCD=8
Table 12 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
Destination: | Destination IP address/length of netmask |
Headend Router | VC type:
|
ATM1/0.1 | ATM interface |
1/33 | VPI/VCI |
Active | LVC state:
|
Related Commands
show tag-switching atm-tdp bindwait Displays the number of bindings waiting for label assignments for a remote MPLS ATM switch.
Command
Description
To display the number of bindings waiting for label assignments from a remote MPLS ATM switch, use the following show tag-switching atm-tdp bindwait EXEC command.
show tag-switching atm-tdp bindwaitSyntax Description
This command has no keywords or arguments.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
Examples
The following shows a sample display using this command:
Router# show tag-switching atm-tdp bindwait
Related Commands
show tag-switching atm-tdp bindings Displays requested entries from the ATM LDP label binding database.
Command
Description
To display information about CoS bandwidth allocation on extended MPLS ATM interfaces, use the following show xtagatm cos-bandwidth-allocation XTagATM EXEC command.
show xtagatm, cos-bandwidth-allocation XTagATM [XTagATM interface number]
Syntax Description
XTagATM interface number Specifies the XTagATM interface number.
Defaults
Available 50%, control 50%.
Command Modes
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
Use this command to display CoS bandwidth allocation information for the following CoS traffic categories:
Examples
The following example shows output from this command:
Router# show xtagatm cos-bandwidth-allocation XTagATM 123 CoS Bandwidth allocation available 25% standard 25% premium 25% control 25%
To display information about the LSC view of the cross-connect table on the remotely controlled ATM switch, use the following show xtagatm cross-connect EXEC command.
show xtagatm cross-connect [traffic] [{interface interface [vpi vci] |
Syntax Description
traffic Displays receive and transmit cell counts for each connection. interface interface Displays only connections with an endpoint of the specified interface. vpi vci Displays only detailed information on the endpoint with the specified VPI/VCI on the specified interface. descriptor descriptor Displays only connections with an endpoint on the interface with the specified physical descriptor.
Defaults
No default behavior or values.
Related Commands
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
Examples
Each connection is listed twice in the sample output from the show xtagatm vc cross-connect command under each interface that is linked by the connection. Connections are marked as -> (unidirectional traffic flow, into the first interface), <- (unidirectional traffic flow, away from the interface), or <-> (bidirectional).
The following is sample output from the show xtagatm cross-connect command:
Router# show xtagatm cross-connect Phys Desc VPI/VCI Type X-Phys Desc X-VPI/VCI State
10.1.0 1/37 -> 10.3.0 1/35 UP
10.1.0 1/34 -> 10.3.0 1/33 UP
10.1.0 1/33 <-> 10.2.0 0/32 UP
10.1.0 1/32 <-> 10.3.0 0/32 UP
10.1.0 1/35 <- 10.3.0 1/34 UP
10.2.0 1/57 -> 10.3.0 1/49 UP
10.2.0 1/53 -> 10.3.0 1/47 UP
10.2.0 1/48 <- 10.1.0 1/50 UP
10.2.0 0/32 <-> 10.1.0 1/33 UP
10.3.0 1/34 -> 10.1.0 1/35 UP
10.3.0 1/49 <- 10.2.0 1/57 UP
10.3.0 1/47 <- 10.2.0 1/53 UP
10.3.0 1/37 <- 10.1.0 1/38 UP
10.3.0 1/35 <- 10.1.0 1/37 UP
10.3.0 1/33 <- 10.1.0 1/34 UP
10.3.0 0/32 <-> 10.1.0 1/32 UP
Table 13 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
Phys desc | Physical descriptor. A switch-supplied string identifying the interface on which the endpoint exists. |
VPI/VCI | Virtual path identifier and virtual channel identifier for this endpoint. |
Type | The notation -> indicates an ingress endpoint, where traffic is only expected to be received into the switch; <- indicates an egress endpoint, where traffic is only expected to be transmitted from the interface; <-> indicates that traffic is expected to be both transmitted and received at this endpoint. |
X-Phys Desc | Physical descriptor for the interface of the other endpoint belonging to the cross-connect. |
X-VPI/VCI | Virtual path identifier and virtual channel identifier of the other endpoint belonging to the cross-connect. |
State | Indicates the status of the cross-connect to which this endpoint belongs. The state is typically UP; other values, all of which are transient, include the following: DOWN |
A sample of the detailed command output provided for a single endpoint is shown below.
Router# show xtagatm cross-connect descriptor 12.1.0 1 42 Phys desc: 12.1.0 Interface: n/a Intf type: switch control port VPI/VCI: 1/42 X-Phys desc: 12.2.0 X-Interface: XTagATM0 X-Intf type: extended tag ATM X-VPI/VCI: 2/38 Conn-state: UP Conn-type: input/output Cast-type: point-to-point Rx service type: Tag COS 0 Rx cell rate: n/a Rx peak cell rate: 10000 Tx service type: Tag COS 0 Tx cell rate: n/a Tx peak cell rate: 10000
Table 14 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
Phys desc | Physical descriptor. A switch-supplied string identifying the interface on which the endpoint exists. |
Interface | The (IOS) interface name. |
Intf type | Interface type. Can be either extended MPLS ATM or switch control port. |
VPI/VCI | Virtual path identifier and virtual channel identifier for this endpoint. |
X-Phys desc | Physical descriptor for the interface of the other endpoint belonging to the cross-connect. |
X-Interface | The (IOS) name for the interface of the other endpoint belonging to the cross-connect. |
X-Intf type | Interface type for the interface of the other endpoint belonging to the cross-connect. |
X-VPI/VCI | Virtual path identifier and virtual channel identifier of the other endpoint belonging to the cross-connect. |
Conn-state | Indicates the status of the cross-connect to which this endpoint belongs. The cross-connect state is typically UP; other values, all of which are transient, include the following: DOWN ABOUT_TO_DOWN ABOUT_TO_CONNECT |
Conn-type | Input---Indicates an ingress endpoint where traffic is only expected to be received into the switch Output---Indicates an egress endpoint, where traffic is only expected to be transmitted from the interface Input/output---Indicates that traffic is expected to be both transmitted and received at this endpoint |
Cast-type | Indicates whether or not the cross-connect is multicast. In the first release, this is always point-to-point. |
Rx service type | Class of service type for the receive, or ingress, direction. This is MPLS COS <n>, (MPLS Class of Service <n>), where n is in the range 0-7 for input and input/output endpoints; this will be n/a for output endpoints. (In the first release, this is either 0 or 7.) |
Rx cell rate | (Guaranteed) cell rate in the receive, or ingress, direction. In the first release, this is always n/a. |
Rx peak cell rate | Peak cell rate in the receive, or ingress, direction, in cells per second. This is n/a for an output endpoint. |
Tx service type | Class of service type for the transmit, or egress, direction. This is MPLS COS <n>, (MPLS Class of Service <n>), where n is in the range 0-7 for output and input/output endpoints; this will be n/a for input endpoints. (In the first release, n will be either 0 or 7.) |
Tx cell rate | (Guaranteed) cell rate in the transmit, or egress, direction. In the first release, this is always N/A. |
Tx peak cell rate | Peak cell rate in the transmit, or egress, direction, in cells per second. This is N/A for an input endpoint. |
To display information about terminating VCs on extended MPLS ATM (XTagATM) interfaces, use the following show xtagatm vc EXEC command.
show xtagatm vc [vcd [interface]]
Syntax Description
vcd (Optional). Virtual circuit descriptor (virtual circuit number). If you specify the vcd argument, then detailed information about all VCs with that vcd appears. If you do not specify the vcd argument, a summary description of all VCs on all XTagATM interfaces appears. interface (Optional). Interface number. If you specify the interface and the vcd arguments, the single VC with the specified vcd on the specified interface is selected.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modifications
Usage Guidelines
The columns marked VCD, VPI, and VCI display information for the corresponding private VC on the control interface. The private VC connects the XTagATM VC to the external switch. It is termed private because its VPI and VCI are only used for communication between the MPLS LSC and the switch, and it is different from the VPI and VCI seen on the XTagATM interface and the corresponding switch port.
Examples
Each connection is listed twice in the sample output from the show xtagatm vc cross-connect command under each interface that is linked by the connection. Connections are marked as input (unidirectional traffic flow, into the interface), output (unidirectional traffic flow, away from the interface), or in/out (bidirectional).
The following is sample output from the show xtagatm vc command.
Router# show xtagatm vc AAL / Control Interface
Interface VCD VPI VCI Type Encapsulation VCD VPI VCI Status XTagATM0 1 0 32 PVC AAL5-SNAP 2 0 33 ACTIVE XTagATM0 2 1 33 TVC AAL5-MUX 4 0 37 ACTIVE XTagATM0 3 1 34 TVC AAL5-MUX 6 0 39 ACTIVE
Table 15 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
VCD | Virtual circuit descriptor (virtual circuit number). |
VPI | Virtual path identifier. |
VCI | Virtual circuit identifier. |
Control Interf. VCD | VCD for the corresponding private VC on the control interface. |
Control Interf. VPI | VPI for the corresponding private VC on the control interface. |
Control Interf. VCI | VCI for the corresponding private VC on the control interface. |
Encapsulation | Displays the type of connection on the interface. |
Status | Displays the current state of the specified ATM interface. |
Related Commands
show atm vc Displays information about private ATM VCs. show xtagatm cross-connect Displays information about remotely connected ATM switches.
Command
Description
To configure the use of VSI on a particular master control port, use the following tag-control-protocol vsi interface configuration command. To disable VSI, use the no form of this command.
tag-control-protocol vsi [id controller-id] [base-vc vpi vci] [slaves slave-count]
Syntax Description
id controller-id Determines the value of the controller-id field present in the header of each VSI message. The default is 1. base-vc vpi vci Determines the VPI/VCI value for the channel to the first slave. The default is 0/40. Together with the slave value, this value determines the VPI/VCI values for the channels to all of the slaves, which are: vpi/vci slaves slave-count Determines the number of slaves reachable through this master control port. The default is 14 (suitable for the Cisco BPX switch). In the first release, no more than twelve sessions will be established with the BPX. The default of 14 will attempt sessions with cards 7 and 8, but such sessions are not used in this release and are always marked as UNKNOWN. keepalive timeout Determines the value of the keepalive timer (in seconds). Make sure that the keepalive timer value is greater than the value of the retry_timer times the retry_count+1. The default is 15 seconds. retry timeout count Determines the value of the message retry timer (in seconds) and the maximum number of retries. The default is 8 seconds and 10 retries.
vpi/vci+1, and so on
vpi/vci+slave_count-1
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
The command is only available on interfaces that can serve as a VSI master control port. It is recommended that all options to the tag-control-protocol command be entered at one time.
After VSI is active on the control interface (through the earlier issuance of a tag-control-protocol vsi command), re-entering the command may cause all associated XTagATM interfaces to shut down and restart. In particular, if you re-enter the tag-control-protocol vsi command with any of the following options, doing so causes the VSI to be shut down and re-activated on the control interface:
VSI remains continuously active (that is, the VSI does not shut down and then re-activate) if you re-enter the tag-control-protocol vsi command with only one or more of the following options:
In either case, if you re-enter the tag-control-protocol vsi command, this causes the specified options to take on the newly-specified values; the other options retain their previous values. To restore default values to all the options, enter the no tag-control-protocol command, followed by the tag-control-protocol vsi command.
Examples
The following example shows how to configure the VSI driver on the control interface:
interface atm 0/0 tag-control-protocol vsi 0 51
To configure the VPI and VCI values to be used for the initial link to the MPLS peer, use the following tag-switching atm control-vc interface configuration command. Use this link to establish the LDP session and to carry non-IP traffic.
tag-switching atm control-vc vpi vci
Syntax Description
vpi Virtual path identifier, in the range from 0 to 255. vci Virtual circuit identifier, in the range from 1 to 65535.
Defaults
0/32
Command Modes
Interface configuration
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
On an extended MPLS ATM (XTagATM) interface, the default VPI range to use for tagged VCs is the configured VPI range that is learned from the switch. This default range is sufficient for most applications. Use the tag-switching vpi command on an XTagATM interface only when it is necessary to override the default.
For the tag-switching atm vpi command, the VPI range specified must lie within the range that was configured on the Cisco BPX switch for the corresponding BPX interface.
Examples
The following example shows how to create an MPLS subinterface on a router and how to select VPI 1 and VCI 34 as the control VC.
interface atm4/0.1 tag-switchingtag-switching iptag-switching atm control-vc 1 34
Related Commands
tag-switching ip (interface) Enables label switching of IPv4 packets on an interface.
Command
Description
To change the value of configured bandwidth allocation for CoS, use the following tag-switching atm cos global configuration command.
tag-switching atm cos [available | standard | premium | control] weight
Syntax Description
available Specifies the weight for the available class. This is the lowest class priority. standard Specifies the weight for the standard class. This is the next lowest class priority. premium Specifies the weight for the premium class. This is the next highest class priority. control Specifies the weight for the control class. This is the highest class priority. weight Specifies the total weight for all CoS traffic classes. This value ranges from 0 to 100.
Defaults
Available 50%, control 50%
Command Modes
Global configuration
Command History
12.0(5)T This command was introduced.
Release
Modifications
Examples
The following example shows output from this command:
tag-switching atm cos interface XTagATM 0 ip unnumbered loopback0 no ip directed-broadcast no ip route-cache cef extended-port ATM1/0 bpx 10.2 tag-switching atm cos available 50 tag-switching atm cos control 50 tag-switching atm vpi 2-5 tag-switching ip
To remove all headend VCs from the MPLS LSC and disable its ability to function as an edge label switch router (edge LSR), use the following tag-switching atm disable-headend-vc command. The no form of this command restores the headend VCs of the MPLS LSC and enables it to function as an edge LSR.
tag-switching atm disable-headend-vcSyntax Description
This command has no arguments or keywords.
Defaults
Removes all headend VCs from the MPLS LSC and disables its ability to function as an edge LSR.
Command Modes
Global configuration
Command History
12.0(7)DC This command was introduced.
Release
Modification
Usage Guidelines
This new CLI function increases the number of label virtual circuits (LVCs) that can be supported by the LSC.
To configure the range of values to use in the VPI field for label VCs, use the following tag-switching atm vpi interface configuration command. To clear the interface configuration, use the no form of this command.
tag-switching atm vpi vpi [- vpi]
Syntax Description
vpi Virtual path identifier, low end of range (1 to 255). - vpi (Optional). Virtual path identifier, high end of range (1 to 255).
Defaults
1-1
Command Modes
Interface configuration
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
To configure ATM MPLS on a router interface (for example, an ATM Interface Processor), you must enable an MPLS subinterface.
|
Note The tag-switching atm control-vc and tag-switching atm vpi subinterface level configuration commands are available on any interface that can support ATM labeling. |
Use this command to select an alternate range of VPI values for ATM label assignment on this interface. The two ends of the link negotiate a range defined by the intersection of the range configured at each end.
To configure the VPI range for an edge label switch router (edge LSR) subinterface connected to another router or to an LSC, the range selected should be limited to four VPIs.
Examples
The following example shows how to create a subinterface and how to select a VPI range from VPI 1 to VPI 3:
interface atm4/0.1 tag-switching tag-switching ip tag-switching atm vpi 1-3
Related Commands
tag-switching atm control-vc Configures VPI and VCI values for the initial link to an MPLS peer.
Command
Description
To specify an interface or a subinterface as a VP tunnel, use the following tag-switching atm vp-tunnel interface configuration command.
tag-switching atm vp-tunnel vpi
Syntax Description
vpi Provides VPI value for the local end of the tunnel.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
The tag-switching atm vp-tunnel and tag-switching atm vpi commands are mutually exclusive.
This command is available on both extended MPLS ATM interfaces and on LC-ATM subinterfaces of ordinary router ATM interfaces. The command is not available on the LS1010, where all subinterfaces are automatically VP tunnels.
On an XTagATM interface, the tunnel/non-tunnel status and the VPI value to be used in case the XTagATM interface is a tunnel are normally learned from the switch through VSI interface discovery. Therefore, it is not necessary to use the tag-switching atm vp-tunnel command on an XTagATM interface in most applications.
Examples
The following example shows how to specify an MPLS subinterface VP tunnel with a VPI value of 4.
tag-switching atm vp-tunnel 4
This section describes the following new debug commands related to the MPLS LSC feature:
Use the following debug tag-switching xtagatm cross-connect command to display requests and responses for establishing and removing cross-connects on the controlled ATM switch. The no form of this command disables debugging output.
debug tag-switching xtagatm cross-connectSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
Use the debug tag-switching xtagatm cross-connect command to monitor requests to establish or remove cross-connects from XTagATM interfaces to the VSI master, as well as the VSI master's responses to these requests.
Examples
The following is sample output from the debug tag-switching xtagatm cross-connect command:
Router# debug tag-switching xtagatm cross-connect
XTagATM: cross-conn request; SETUP, userdata 0x17, userbits 0x1, prec 7
0xC0100 (Ctl-If) 1/32 <-> 0xC0200 (XTagATM0) 0/32
XTagATM: cross-conn response; DOWN, userdata 0x60CDCB5C, userbits 0x2, result
OK
0xC0200 1/37 --> 0xC0300 1/37
Table 16 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
XTagATM | Identifies the source of the debug message as an XTagATM interface. |
cross-conn | Indicates that the debug message pertains to a cross-connect setup or teardown operation. |
request | A request from an XTagATM interface to the VSI master to set up or tear down a cross-connect. |
response | Response from the VSI master to an XTagATM interface that a cross-connect was set up or removed. |
SETUP | A request for the setup of a cross-connect. |
TEARDOWN | A request for the teardown of a cross-connect. |
UP | The cross-connect is established. |
DOWN | The cross-connect is not established. |
userdata, userbits | Values passed with the request that are returned in the corresponding fields in the matching response. |
prec | The precedence for the cross-connect. |
result | Indicates the status of the completed request. |
0xC0100 (Ctl-If) 1/32 | Indicates the following: that one endpoint of the cross-connect is on the interface whose logical interface number is 0xC0100; that this interface is the VSI control interface; that the VPI value at this endpoint is 1; and that the VCI value at this end of the cross-connect is 32. |
<-> | Indicates that this is a bidirectional cross-connect. |
0xC0200 (XTagATM0) 0/32 | Indicates the following: that the other endpoint of the cross-connect is on the interface whose logical interface number is 0xC0200; that this interface is associated with XTagATM interface 0; that the VPI value at this endpoint is 0; and that the VCI value at this end of the cross-connect is 32. |
-> | Indicates that this response pertains to a unidirectional cross-connect. |
Related Commands
show xtagatm cross-connect Displays information about remotely connected ATM switches.
Command
Description
Use the following debug tag-switching xtagatm errors command to display information about error and abnormal conditions that occur on XTagATM interfaces. The no form of this command disables debugging output.
debug tag-switching xtagatm errorsSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
Use the debug tag-switching xtagatm errors command to display information about abnormal conditions and events that occur on XTagATM interfaces.
Examples
The following is sample output from the debug tag-switching xtagatm errors command:
Router# debug tag-switching xtagatm errors XTagATM VC: XTagATM0 1707 2/352 (ATM1/0 1769 3/915): Cross-connect setup failed NO_RESOURCES
This message indicates that an attempt to set up a cross-connect for a terminating VC on XTagATM0 failed, and that the reason for the failure was a lack of resources on the controlled ATM switch.
Use the following debug tag-switching xtagatm events command to display information about major events that occur on XTagATM interfaces, not including events for specific XTagATM VCs and switch cross-connects. The no form of this command disables debugging output.
debug tag-switching xtagatm eventsSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command History
12.0(5)T This command was introduced.
Command
Modification
Usage Guidelines
Use the debug tag-switching xtagatm events command to monitor major events that occur on XTagATM interfaces. This command only monitors events that pertain to XTagATM interfaces as a whole and does not include any events which pertain to individual XTagATM VCs or individual switch cross-connects. The specific events monitored when the debug tag-switching xtagatm events command is in effect include the following:
Examples
The following is sample output from the debug tag-switching xtagatm events command:
Router# debug tag-switching xtagatm events XTagATM: desired cross-connect table size set to 256 XTagATM: ExATM API intf event Up, port 0xA0100 (None) XTagATM: ExATM API intf event Down, port 0xA0100 (None) XTagATM: marking all VCs stale on XTagATM0
Table 17 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
XTagATM | Identifies the source of the debug message as an XTagATM interface. |
desired cross-connect table size set to 256 | Indicates that the table of cross-connect information has been set to hold 256 entries. A single cross-connect table is shared among all XTagATM interfaces. The cross-connect table is automatically resized as the number of cross-connects increases. |
ExATM API | Indicates that the information in the debug output pertains to an asynchronous notification sent by the VSI master to the XTagATM driver. |
event Up/Down | Indicates the specific event that was sent by the VSI master to the XTagATM driver. |
port 0xA0100 (None) | Indicates that the event pertains to the VSI interface whose logical interface number is 0xA0100, and that this logical interface is not bound (through the extended-port interface configuration command) to any XTagATM interface. |
marking all VCs stale on XTagATM0 | Indicates that all existing XTagATM VCs on interface XTagATM0 are marked as stale, and that XTagATM0 remains down until all of these VCs are refreshed. |
Use the following debug tag-switching xtagatm vc command to display information about events that affect individual XTagATM terminating VCs. The no form of this command disables debugging output.
debug tag-switching xtagatm vcSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
Use the debug tag-switching xtagatm vc command to display detailed information about all events that affect individual XTagATM terminating VCs.
|
Note Use this command with care, because it results in extensive output when the number of XTagATM VCs being set up or torn down is large. This output may interfere with system timing and normal operation of other router functions. Use the debug tag-switching xtagatm vc command only in situations in which the number of XTagATM VCs being created or removed is small. |
Examples
The following is sample output from the debug tag-switching xtagatm vc command:
Router# debug tag-switching xtagatm vc XTagATM VC: XTagATM1 18 0/32 (ATM1/0 0 0/0): Setup, Down --> UpPend XTagATM VC: XTagATM1 18 0/32 (ATM1/0 88 1/32): Complete, UpPend --> Up XTagATM VC: XTagATM1 19 1/33 (ATM1/0 0 0/0): Setup, Down --> UpPend XTagATM VC: XTagATM0 43 0/32 (ATM1/0 67 1/84): Teardown, Up --> DownPend
Table 18 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
XTagATM VC | Identifies the source of the debug message as the XTagATM interface terminating VC facility. |
XTagATM <ifnum> | Identifies the particular XTagATM interface number for the terminating VC. |
vcd vpi/vci | Indicates the VCD and VPI/VCI values for the terminating VC. |
(ctl-if vcd vpi/vci) | Shows the control interface, the VCD, and the VPI and VCI values for the private VC corresponding to the XTagATM vc on the control interface. |
Setup, Complete, Teardown | Indicates the name of the particular event that has occurred for the indicated VC. |
oldstate -> newstate | Indicates the state of the terminating VC before and after the processing of the indicated event. |
Use the following debug vsi api command to display information on events associated with the external ATM API interface to the VSI master. The no form of this command disables debugging output.
debug vsi apiSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
Use the debug vsi api command to monitor the communication between the VSI master and the XTagATM component regarding interface changes and cross-connect requests.
Examples
The following is sample output from the debug vsi api command:
Router# debug vsi api
VSI_M: vsi_exatm_conn_req: 0x000C0200/1/35 -> 0x000C0100/1/50
desired state up, status OK
VSI_M: vsi_exatm_conn_resp: 0x000C0200/1/33 -> 0x000C0100/1/49
curr state up, status OK
Table 19 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
vsi_exatm_conn_req | Indicates that a connect or disconnect request was submitted to the VSI master. |
0x000C0200 | The logical interface identifier of the primary endpoint, in hexadecimal form. |
1/35 | VPI and VCI of the primary endpoint. |
-> | Indicates that the expected traffic flow is unidirectional (from the primary endpoint to the secondary endpoint). The other value for this field is <->, which indicates bidirectional traffic flow. |
0x000C0100 | Logical interface identifier of the secondary endpoint. |
1/50 | VPI and VCI of the secondary endpoint. |
desired state | Up indicates a connect request; Down indicates a disconnect request. |
status (in vsi_exatm_conn_req output) | A mnemonic indicating the success or failure of the initial processing of the request. One of following status indications appears: OK OK means only that the request is successfully queued for transmission to the switch; it does not indicate completion of the request. |
Use the following debug vsi errors command to display information on errors encountered by the VSI master. The no form of this command disables debugging output.
debug vsi errors [interface interface [slave number]]
Syntax Description
interface interface Specifies the interface number. slave number Specifies the slave number (beginning with 0).
Defaults
No default behavior or values.
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
Use the debug vsi errors command to display information about errors encountered by the VSI master when parsing received messages, as well as information about unexpected conditions encountered by the VSI master.
If the interface parameter is specified, output is restricted to errors associated with the indicated VSI control interface. If the slave number is specified, output is further restricted to errors associated with the session with the indicated slave.
|
Note Slave numbers are the same as the session numbers discussed under the show controllers vsi session command. |
Multiple uses of the form of the command which specifies slave number allows multiple slaves to be debugged immediately. For example, the following commands restrict output to that for errors associated with sessions 0 and 1 on control interface atm2/0, but for no other sessions.
Router#debug vsi errors interface atm2/0 slave 0Router#debug vsi errors interface atm2/0 slave 1
Some errors are not associated with any particular control interface or session. Messages associated with these errors are printed, regardless of the interface or slave options currently in effect.
Examples
The following is sample output from the debug vsi errors command:
Router# debug vsi errors
VSI Master: parse error (unexpected param-group contents) in GEN ERROR RSP rcvd on ATM2/0:0/51 (slave 0)
errored section is at offset 16, for 2 bytes:
01.01.00.a0 00.00.00.00 00.12.00.38 00.10.00.34
*00.01*00.69 00.2c.00.00 01.01.00.80 00.00.00.08
00.00.00.00 00.00.00.00 00.00.00.00 0f.a2.00.0a
00.01.00.00 00.00.00.00 00.00.00.00 00.00.00.00
00.00.00.00
Table 20 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
parse error | Indicates that an error was encountered during the parsing of a message received by the VSI master. |
unexpected param-group contents | Indicates the type of parsing error. In this case, a parameter group within the message contained invalid data. |
GEN ERROR RSP | A mnemonic for the function code in the header of the error message. |
ATM2/0 | The control interface on which the error message was received. |
0/51 | VPI or VCI of the VC (on the control interface) on which the error message is received. |
slave | Number of the session on which the error message is received. |
offset <n> | Indicates the number of bytes between the start of the VSI header and the start of that portion of the message in error. |
<n> bytes | Length of the error section. |
00.01.00.a0 [...] | The entire error message, as a series of hexadecimal bytes. Note that the error section is between asterisks (*). |
Use the following debug vsi events command to display information on events that affect entire sessions, as well as events that affect only individual connections. The no form of this command disables debugging output.
debug vsi events [interface interface [slave number]]
Syntax Description
interface interface Specifies the interface number. slave number Specifies the slave number (beginning with zero).
Defaults
No default behavior or values.
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
Use the debug vsi events command to display information about events associated with the per-session state machines of the VSI master, as well as the per-connection state machines. If the interface parameter is specified, output is restricted to events associated with the indicated VSI control interface. If the slave number is specified, output is further restricted to events associated with the session with the indicated slave.
|
Note Slave numbers are the same as the session numbers discussed under the show controllers vsi session command. |
Multiple uses of the form of the command which specifies slave number allows multiple slaves to be debugged at once. For example, the following commands restrict output to that for events associated with sessions 0 and 1 on control interface atm2/0, but for no other sessions. Output associated with all per-connection events are displayed, regardless of the interface or slave options currently in effect.
Router#debug vsi events interface atm2/0 slave 0Router#debug vsi events interface atm2/0 slave 1
Examples
The following is sample output from the debug vsi events command:
Router# debug vsi events
VSI Master: conn 0xC0200/1/37->0xC0100/1/51:
CONNECTING -> UP
VSI Master(session 0 on ATM2/0):
event CONN_CMT_RSP, state ESTABLISHED -> ESTABLISHED
VSI Master(session 0 on ATM2/0):
event KEEPALIVE_TIMEOUT, state ESTABLISHED -> ESTABLISHED
VSI Master(session 0 on ATM2/0):
event SW_GET_CNFG_RSP, state ESTABLISHED -> ESTABLISHED
debug vsi packets
Table 21 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
conn | Indicates that the event applies to a particular connection. |
0xC0200 | Logical interface identifier of the primary endpoint, in hexadecimal form. |
1/37 | VPI or VCI of the primary endpoint. |
-> | Indicates that the expected traffic flow is unidirectional (from the primary endpoint to the secondary endpoint). The other value for this field is <->, indicating bidirectional traffic flow. |
0xC0100 | Logical interface identifier of the secondary endpoint. |
1/51 | VPI or VCI of the secondary endpoint. |
<state1> -> <state2> | <state1> is a mnemonic for the state of the connection before the event occurred. <state2> represents the state of the connection after the event occurred. |
session | Indicates the number of the session with which the event is associated. |
ATM2/0 | Indicates the control interface associated with the session. |
event | |
state <state1> -> <state2> | Mnemonics for the session states associated with the transition triggered by the event. <state1> is a mnemonic for the state of the session before the event occurred; <state2> is a mnemonic for the state of the session after the event occurred. |
Use the following debug vsi packets command to display a one-line summary of each VSI message sent and received by the LSC. The no form of this command disables debugging output.
debug vsi packets [interface interface [slave number]]
Syntax Description
interface interface Specifies the interface number. slave number Specifies the slave number (beginning with zero).
Defaults
No default behavior or values
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
If the interface parameter is specified, output is restricted to messages sent and received on the indicated VSI control interface. If the slave number is specified, output is further restricted to messages sent and received on the session with the indicated slave.
|
Note Slave numbers are the same as the session numbers discussed under the show controllers vsi session command. |
Multiple uses of the form of the command which specifies slave number allows multiple slaves to be debugged at once. For example, the following commands restrict output to that for messages received on atm2/0 for sessions 0 and 1, but for no other sessions.
Router#debug vsi packets interface atm2/0 slave 0Router#debug vsi packets interface atm2/0 slave 1
Examples
The following is sample output from the debug vsi packets command:
Router# debug vsi packets VSI master(session 0 on ATM2/0): sent msg SW GET CNFG CMD on 0/51 VSI master(session 0 on ATM2/0): rcvd msg SW GET CNFG RSP on 0/51 VSI master(session 0 on ATM2/0): sent msg SW GET CNFG CMD on 0/51 VSI master(session 0 on ATM2/0): rcvd msg SW GET CNFG RSP on 0/51
Table 22 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
session | |
ATM2/0 | Identifier for the control interface on which the message is sent or received. |
sent | Indicates that message is sent by the VSI master. |
rcvd | Indicates that message is received by the VSI master. |
msg | A mnemonic for the function code from the message header. |
0/51 | VPI or VCI of the VC (on the control interface) on which the message is sent or received. |
Use the following debug vsi param-groups command to display the first 128 bytes of each VSI message sent and received by the MPLS LSC (in hexadecimal form). The no form of this command disables debugging output.
debug vsi param-groups [interface interface [slave number]] |
Note param-groups stands for parameter groups. A parameter group is a component of a VSI message. |
Syntax Description
interface interface Specifies the interface number. slave number Specifies the slave number (beginning with zero).
Defaults
No default behavior or values.
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
This command is most commonly used with the debug vsi packets command to monitor incoming and outgoing VSI messages.
If the interface parameter is specified, output is restricted to messages sent and received on the indicated VSI control interface.
If the slave parameter is specified, output is further restricted to messages sent and received on the session with the indicated slave.
|
Note Slave numbers are the same as the session numbers discussed under the show controllers vsi session command. |
Multiple uses of the form of the command which specifies a slave number allows multiple slaves to be debugged at once. For example, the following commands restrict output to that for messages received on atm2/0 for sessions 0 and 1, but for no other sessions.
Router#debug vsi param-groups interface atm2/0 slave 0Router#debug vsi param-groups interface atm2/0 slave 1
Examples
The following is sample output from the debug vsi param-groups command:
Router# debug vsi param-groups Outgoing VSI msg of 12 bytes (not including encap): 01.02.00.80 00.00.95.c2 00.00.00.00 Incoming VSI msg of 72 bytes (not including encap): 01.02.00.81 00.00.95.c2 00.0f.00.3c 00.10.00.08 00.01.00.00 00.00.00.00 01.00.00.08 00.00.00.09 00.00.00.09 01.10.00.20 01.01.01.00 0c.08.80.00 00.01.0f.a0 00.13.00.15 00.0c.01.00 00.00.00.00 42.50.58.2d 56.53.49.31 Outgoing VSI msg of 12 bytes (not including encap): 01.02.00.80 00.00.95.c3 00.00.00.00 Incoming VSI msg of 72 bytes (not including encap): 01.02.00.81 00.00.95.c3 00.0f.00.3c 00.10.00.08 00.01.00.00 00.00.00.00 01.00.00.08 00.00.00.09 00.00.00.09 01.10.00.20 01.01.01.00 0c.08.80.00 00.01.0f.a0 00.13.00.15 00.0c.01.00 00.00.00.00 42.50.58.2d 56.53.49.31
Table 23 describes the significant fields in the sample command output shown above.
| Field | Description |
|---|---|
Outgoing | Indicates that the message is sent by the VSI master. |
Incoming | Indicates that the message is received by the VSI master. |
bytes | Number of bytes in the message, starting at the VSI header, and excluding the link layer encapsulation. |
01.02... | Identifies up to the first 128 bytes of the message, in hexadecimal form. |
The terms in this glossary are defined in an MPLS context, rather than a general usage context.
AIP---ATM Interface Processor
An ATM interface for Cisco 7000 series routers designed to minimize performance bottlenecks at the user-network interface (UNI).
A dual-wide port adapter for the Cisco 7200 router. The Alien port adapter is ABR-ready and supports traffic shaping.
A router that is connected to the ATM-LSR cloud through LSC-ATM interfaces. The ATM edge LSR adds labels to unlabeled packets and strips labels from labeled packets.
A label switch router with several LSC-ATM interfaces. The router forwards the cells among these interfaces using labels carried in the VPI/VCI field of the cells.
BPX---Broadband Packet Exchange
A carrier-quality switch with trunk and CPU hot standby redundancy.
BXM---Broadband Switch Module
An ATM port card for the Cisco BPX switch.
CAR---Committed Access Rate
CAR is the main feature supporting packet classification. CAR uses the type of service (TOS) bits in the IP header to classify packets. You can use the CAR classification commands to classify and reclassify a packet.
Controlled ATM Switch
An ATM switch that is being controlled by an LSC.
CoS---Class of Service
A feature that provides scalable, differentiated types of service across an MPLS network.
VIP-Distributed WFQ (Weighted Fair Queueing).
VIP-Distributed WRED (Weighted Random Early Detection).
Extended label ATM interface
A new type of interface supported by the remote ATM switch driver and a particular switch-specific driver that supports MPLS over an ATM interface on a remotely controlled switch.
External ATM interface
One of the interfaces on the controlled ATM switch other than the switch control port. It is also referred to as an exposed ATM interface, because it is available for connections outside of the label controlled switch.
A 3-bit value in the Type of Service (TOS) byte used for assigning precedence to IP packets.
Label
A short fixed-length label that tells switching nodes how the data (packets or cells) should be forwarded.
Label controlled switch
The label switch controller and the controlled ATM switch that it controls, viewed together as a unit.
The act of putting the first label on a packet.
A node that forwards units of data (packets or cells) on the basis of labels.
Label switch controller (LSC)
An IOS platform that runs the generic MPLS software and that is capable of controlling the operation of an external ATM (or other type of) switch, making the interfaces of the latter appear externally as LC-ATM interfaces.
Label switched path (LSP tunnel)
A configured connection between two routers, using MPLS to carry the packets.
Label switching router (LSR)
A Layer 3 router that forwards a packet based on the value of a label encapsulated in the packet.
Label VC (LVC)
An ATM virtual circuit that is set up through ATM LSR label distribution procedures.
LBR
Label Bit Rate. Service category defined by this document for label-VC traffic. Link and per-VC bandwidth sharing may be controlled by relative bandwidth configuration at the edge and each switch along a label-VC. No ATM traffic-related parameters specified.
LC-ATM (label-controlled ATM) interface
An MPLS interface in which labels are carried in the VPI or VCI fields of the ATM cells and in which VC connections are established under the control of MPLS software.
LFIB---Label forwarding information base
A data structure and way of managing forwarding in which destinations and incoming labels are associated with outgoing interfaces and labels.
LVC---Label switched controlled virtual circuit
A virtual circuit (VC) established under the control of MPLS. An LVC is neither a PVC nor an SVC. The LVC must traverse only a single hop in a label-switched path (LSP), but the LVC may traverse several ATM hops only if the LVC exists within a VP tunnel.
Master control port
A physical interface on an MPLS LSC that is connected to one end of a slave control link.
MPLS---Multiprotocol Label Switching
An emerging industry standard on which label switching is based.
QoS
Remote ATM switch driver
A set of interfaces that allows IOS software to control the operation of a remote ATM switch through a control protocol, such VSI.
Ships in the night (SIN)
The ability to support both MPLS functions and ATM forum protocols on the same physical interface, or on the same router or switch platform. In this mode, the two protocol stacks operate independently.
Switch control port
An interface that uses an MPLS LSC to control the operation of a controlled ATM switch (for example, VSI). The protocol runs on an ATM link.
TOS---Type of Service
VPN
Virtual private network. Enables IP traffic to use tunneling to travel securely over a public TCP/IP network.
VSI master
In a hardware context, a device that controls a VSI switch (for example, a VSI label switch controller). In a software context, a process that implements the master side of the VSI protocol.
VSI slave
In a hardware context, a switch or a port card that implements the VSI protocol. In a software context, a process that impalements the salve side of the VSI protocol.
VSI---Virtual switch interface
The protocol that enables an MPLS LSC to control an ATM switch over an ATM link.
WEPD---Weighted Early Packet Discard
WRED (Weighted Random Early Detection)
A variant of RED in which the probability of a packet being dropped depends on its IP Precedence, CAR marking, or MPLS CoS (as well as other factors in the RED algorithm).
A queue management algorithm that provides a certain fraction of link bandwidth to each of several queues, based on relative bandwidth applied to each of the queues.
Posted: Thu Mar 9 08:41:43 PST 2000
Copyright 1989 - 2000©Cisco Systems Inc.