Guest

ATM Signaling

Understanding and Troubleshooting ATM UNI Signaling

Document ID: 10503



Contents

Introduction
Prerequisites
      Requirements
      Components Used
      Conventions
Understanding the QSAAL PVC
UNI 3.0, 3.1 and 4.0 Versions
Signaling Messages
      Message Format
      Messages
      Information Elements
Call States
Sample Debug Output
      Choosing a Debug Command
Related Information

Introduction

ATM end systems and network switches use signaling protocols to establish dynamic user connections, known as switched virtual circuits (SVCs). An ATM switch and an ATM end system, such as an ATM-attached router, exchange user to network interface (UNI) signaling messages across UNI links. ATM switches exchange Network to Network Interface (NNI) signaling across NNI links. NNI signaling is part of the Private Network-Network Interface (PNNI) specification, which includes both signaling and routing.

In rare circumstances, SVC connection requests fail or are torn down unexpectedly. This document helps you to troubleshoot SVC connection failures across UNI links.

See also the ATM Signaling and Addressing chapter in the Guide to ATM Technology.

Note: PNNI is outside the scope of this document. Refer to the Configuring ATM Routing and PNNI chapter in the ATM Switch Router Software Configuration Guide for more information.

Prerequisites

Requirements

There are no specific requirements for this document.

Components Used

This document is not restricted to specific software and hardware versions.

Conventions

For more information on document conventions, refer to the Cisco Technical Tips Conventions.

Understanding the QSAAL PVC

The simplest way to view signaling messages is as control packets that carry important information between ATM switches and end-systems. ATM devices transmit signaling messages over a dedicated PVC configured with a special QSAAL (Quasi Signaling Application Adaptation Layer) ATM adaptation layer encapsulation. By default, the dedicated signaling VC uses virtual path identifier (VPI)=0 and virtual channel identifier (VCI)=5. Cisco Campus ATM switches such as the LightStream 1010 and Catalyst 8500 series create the signaling VC and other well-known (reserved) VCs like ILMI automatically during startup.

Use the show atm vc command to confirm that each interface supports a QSAAL PVC. Note how this VC cross-connects to interface ATM 2/0/0, which identifies the switch's internal management port. Since signaling messages are control messages, they must be sent to and processed by the CPU.

   Switch#show atm vc 
   Interface VPI VCI Type X-Interface X-VPI X-VCI Encap Status 
    atm0/0/0  0 5     PVC  atm2/0/0  0    39   QSAAL   UP 
    atm0/0/0  0 16    PVC  atm2/0/0  0    35   ILMI    UP 
    atm0/0/1  0 5     PVC  atm2/0/0  0    40   QSAAL   UP 
    atm0/0/1  0 16    PVC  atm2/0/0  0    36   ILMI    UP 
    atm0/0/1  4 50    PVC  atm2/0/0  0    230  SNAP    UP

If you need to use a VPI or VCI value other than the default of 0/5 for the QSAAL VC, use the atm manual-well-known-vc command, as shown in the following example:

   Switch(config)# interface atm 0/0/0 
   Switch(config-if)# atm manual-well-known-vc delete 
   Okay to delete well-known VCS for this interface? [no]: y 
   Switch(config-if)# atm pvc 1 35 interface atm0 any-vci encap qsaal

Confirm your settings with the show atm vc interface atm command.

   Switch# show atm vc interface atm 0/0/0 
   Interface VPI VCI Type    X-Interface X-VPI X-VCI Encap Status 
     atm0/0/0 1   35  PVC     atm0        0    150    QSAAL UP

UNI 3.0, 3.1 and 4.0 Versions

Most Cisco ATM interfaces support versions 3.0, 3.1 and 4.0 of the ATM Forum's UNI signaling recommendations. Use the atm uni-version command to manually change the UNI version on an ATM interface.

    3640-2.2(config-if)#atm uni-version ? 
    3.0 UNI Version 3.0 
    3.1 UNI Version 3.1 
    4.0 UNI Version 4.0

By default, ILMI autoconfiguration is enabled on ATM switch interfaces and negotiates the UNI version to the highest version in common between the devices at both ends of the physical link. Avoid manually setting the UNI version unless the attached device does not support autoconfiguration. When manually setting the UNI version, ensure that you also disable autoconfiguration with the no atm auto-configuration command.

Signaling Messages

The ATM Forum UNI specifications are based on the Q.2931 public network signaling protocol developed by the ITU-T. The Q.2931 protocol specifies a call control message format that carries information such as message type (setup, call proceeding, release, and so on) and information elements (IEs), which include addresses and quality of service (QoS).

When troubleshooting signaling issues, the message type and information elements of ATM signaling messages must be understood. We'll look at these in more detail later.

Message Format

The following table describes the fields in a standard Q.2931 message.

Field

Description

Protocol discriminator

Identifies the message as using either Q.93B or Q.2931 or it identifies another layer-3 signaling protocol, such as that used with X.25.

Call reference value

Identifies each call and is assigned by the originating side of the call (that is, the user at the local side and the network at the remote side). Contains a one-bit call reference flag to identify which end of the signaling VC originated the call.

Message type

Identifies the specific type of message, such as a SETUP or CALL PROCEEDING. (See the Messages section below.)

Message length

Identifies the length of the contents of a message. The value does not count the octets used for the protocol discriminator, call reference, and message type fields.

Variable length information elements

See the Information Elements section below.

Messages

UNI signaling messages have a name which normally appears in documentation in all capital letters. Let's look at the two most common sets of signaling messages.

Message

Function

Call Establishment

SETUP

Call establishment has been initiated.

CALL PROCEEDING

Call establishment has begun.

CONNECT

Call has been accepted.

CONNECT ACKNOWLEDGE

Call acceptance has been acknowledged.

Call Clearing

RELEASE

Call clearing has been initiated.

RELEASE COMPLETE

Call has been cleared.

The UNI protocol also supports three other sets of messages: miscellaneous, global call reference, and point-to-multipoint connections. Since these messages typically are not seen in Cisco ATM debugs, we will not discuss them here.

Information Elements

IEs form the body of a signaling message. Each message contains one or more IEs. The SETUP message contains numerous IEs, which are listed below.

Information Element

Function

AAL parameters

Indicates the requested ATM adaptation layer (AAL) parameter, which has end-to-end significance. Supported values include AAL1, AAL 3, AAL 4, and AAL5. Each AAL adds more parameters. For example, AAL1 adds constant bit rate (CBR) Rate Identifier and Clock Recovery Type Identifier.

ATM user cell rate

Specifies several traffic parameters, such as the forward and backward peak cell rate.

Broadband bearer capability

Indicates several network bearer services, such as end-to-end timing requirements and whether the traffic type is CBR or variable bit rate (VBR).

Broadband high layer information

Identifies upper layer protocols or a vendor-specific application (that is the protocol in use at layer 3).

Broadband repeat indicator

Allows repeated information elements to be interpreted correctly.

Broadband low layer information

Identifies lower layer protocols or configurations (that is, the protocol in use at layer 2).

Called party number

Identifies the E.164 or private ATM end-system address of the called party or the destination of the call.

Called party subaddress

Conveys an ATM address in the OSI NSAP format across a public network which supports only E.164 addresses.

Calling party number

Identifies the E.164 or private ATM end-system address of the calling party or the origin of the call.

Calling party subaddress

Conveys an ATM address in the OSI NSAP format across a public network which supports only E.164 addresses.

Call state

Specifies one of twelve values describing status of a call. See section below on Call States.

Cause

Describes the reason for generating certain messages, provides diagnostic information in the event of procedural errors, and indicates the location of the cause originator.

Connection identifier

Identifies the VPI and VCI for the call.

QoS parameter

Requests and indicates the quality of service class for a connection.

Broadband sending complete

Indicates the completion of the called party number. Optional for ATM end stations to send and is ignored by network equipment when received.

Transit network selection

Identifies a transit network.

Endpoint reference

Identifies endpoints in a point-to-multipoint connection.

Endpoint state

Indicates each endpoint's state, such as add party initiated, received or active.

Restart indicator

Identifies which virtual channels are to be restarted.

Call States

Networking protocols frequently use state machines that take a device or interface through several stages to normal operation. UNI recommendations specify ATM call control states for both the user side and the network side. Understanding these states is another important piece of information for troubleshooting ATM signaling issues.

The following table lists the call states that may exist on the user side of the UNI link.

ATM Call States for the User Side

Null (U0)

No call exists.

Call Initiated (U1)

This state exists for an outgoing call when the user requests call establishment from the network.

Outgoing Call Proceeding (U3)

This state exists for an outgoing call when the user has received acknowledgment that the network has received all call information to effect call establishment.

Call Present (U6)

This state exists for an incoming call when the user has received a call establishment request but has not yet responded.

Connect Request (U8)

This state exists for an incoming call when the user has answered the call and is waiting to be awarded the call.

Incoming Call Proceeding (U9)

This state exists for an incoming call when the user has sent acknowledgment that the user has received all call information necessary to effect call establishment.

Active (U10)

This state exists for an incoming call when the user has received an acknowledgment from the network that the user has been awarded the call. This state exists for an outgoing call when the user has received an indication that the remote user has answered the call.

Release Request (U11)

This state exists when the user has requested the network to clear the end-to-end connection (if any) and is waiting for a response.

Release Indication (U12)

This state exists when the user has received an invitation to disconnect because the network has disconnected the end-to-end connection (if any).

The following table lists the call states that may exist on the network side of the UNI link.

ATM Call States for the Network Side

Null (N0)

No call exists.

Call Initiated (N1)

This state exists for an outgoing call when the network has received a call establishment request but has not yet responded.

Outgoing Call Proceeding (N3)

This state exists for an outgoing call when the network has sent acknowledgment that the network has received the call information to effect call establishment.

Call Present (N6)

This state exists for an incoming call when the network has sent a call establishment request but not yet received a satisfactory response.

Connect Request (N8)

This state exists for an incoming call when the network has received an answer but the network has not yet awarded the call.

Incoming Call Proceeding (N9)

This state exists for an incoming call when the network has received acknowledgment that the user has received all call information necessary to effect call establishment.

Active (N10)

This state exists for an incoming call when the network has awarded the call to the call user. This state exists for an outgoing call when the network has indicated that the remote user has answered the call.

Release Request (N11)

This state exists when the network has received a request from the user to clear the end-to-end connection (if any).

Release Indication (N12)

This state exists when the network has disconnected end-to-end connection (if any) and has sent an invitation to disconnect the user-network connection.

Sample Debug Output

Let's now look at some sample debug output in order to understand the information presented so far. In the following output, we can see that ATM interface 12/1/1 receives a SETUP message containing the AAL5 parameters, ATM traffic descriptor, and broadband bearer capability IEs. The user-side state changes from Null (U0) for no call exists to Call Present (U6) to indicate that the interface received an incoming call establishment request but has not yet responded. The reports by the LightStream 1010 of a change in call state are highlighted in bold below.

   LS1010-1# 
   1d03h: ATMSIG(12/1/1:0 0,0 - 0056/00): (vcnum:0) Input event : Rcvd Setup in Null(U0) 
   1d03h: ATMSIG(12/1/1:0 0,0 - 0056/00): (vcnum:0) AAL5 Parameters IE (type 5) 
   1d03h: ATMSIG(12/1/1:0 0,0 - 0056/00): (vcnum:0) 
   ATM Traffic Descriptor IE: Forward PCR01 ID = 58600 Backward PCR01 ID = 58600 Best1 
   1d03h: ATMSIG(12/1/1:0 0,117 - 0056/00): (vcnum:0) 
   Broadband Bearer Capability IE: Bearer class = 0x10 ATC = 0x80 User plane = 0x80 
   1d03h: ATMSIG(12/1/1:0 0,117 - 0056/00): (vcnum:0) Null(U0) -> Call Present(U6)    
   1d03h: SIG->CC: Svc Event Rcvd Setup, 
   State Call Present(U6)atmsig_set_e2e_extqos_def:serv_category 4 extQos 0,
    end2enddelayIe 0 
   1d03h: ATMSIG(12/1/1:0 0,117 - 0056/00): (vcnum:0) sending next port req    
   1d03h: ATMSIG: ROUTING INTERFACE : call ref = 56(0x800038); call end pt ref = 0(0x0); 
    calling port : (12/1/1)    : 0 ; 
   1d03h: Port List : no of ports = 0 
   1d03h: dtl_node : 0:0:00.000000000000000000000000.000000000000.00    
   1d03h: output_port : (0x0)0/0/0:0 
   1d03h: next_hop.type = addr(0x2);
    next_hop addr = 47.000018036680057000000000.00A0B10716B2.0B    
   1d03h: ATMSIG: processing port_rsp message from routing 
   1d03h: ATMSIG: ROUTING INTERFACE : err_code = PNNI_SUCCESS
    (0x1)call ref = 56(0x800038); 
   call end pt ref = 0(0x0); 
    calling port : (12/1/1)    : 0 ; 
   1d03h: Port List : no of ports = 1 
    Port ID 1 : (12/0/0) :    0 
   1d03h: dtl_node : 0:0:00.000000000000000000000000.000000000000.00    
   1d03h: output_port : (0x0)0/0/0:0 
   1d03h: next_hop.type = addr(0x2);
    next_hop addr = 47.000018088770005500000000.00A0B10716B2.0B    
   1d03h: No Received DTLs 
   1d03h: ATMSIG(12/1/1:0 0,117 - 0056/00): (vcnum:0)Call Control nodetype : uni_node 
   1d03h: CC->SIG: Svc Event Req Call Proceeding, State Call Present(U6)    
   1d03h: ATMSIG(12/1/1:0 0,117 - 0056/00): (vcnum:0)
    Input event : Req Call Proceeding in Call Present(U6) 
   1d03h: ATMSIG(12/1/1:0 0,117 - 0056/00): (vcnum:0)
    Output Call Proc msg, Call Present(U6) state 
   1d03h: ATMSIG(12/1/1:0 0,117 - 0056/00): (vcnum:0)
    Call Present(U6) -> Incoming Call Proceeding(U9)

Choosing a Debug Command

Debug commands are a powerful tool to troubleshoot ATM signaling issues. Since using debug commands also can interrupt operation of your Cisco device as well as produce a large amount of output, it is important to choose the correct debug command.

caution Caution: Before issuing debug commands, please see Important Information on Debug Commands.

   ls1010-2#debug atm sig-? 
   sig-all sig-error sig-events sig-hog  sig-ie 
   sig-mibs sig-mp2p sig-nni sig-packets

Command

Description

sig-all

Turns on the debug output for all of the above conditions.

sig-error

Turns on the debug output for the ATM signaling error conditions.

sig-events

Turns on the debug output for the ATM signaling state machine events.

sig-ie

Turns on the debug output for the ATM signaling messages information element encoding.

sig-nni

Turns on the debug output for the ATM signaling NNI state machine events.

sig-packets

Turns on the debug output for the ATM signaling packets.

card/subcard/ port

Specifies the card, subcard, and port number for the ATM interface.

Note the following when enabling signaling debug commands:

  • debug atm sig-all command does not enable debug atm sig-packet, which must be enabled with a separate configuration command.

         LS1010-1#debug atm sig-all int atm 0/0/0 
         ATM Signaling Events debugging is on 
         ATM Signaling Error debugging is on 
         ATM Signaling IE debugging is on 
         ATM Signaling NNI debugging is on 
         ATM Soft vc/vp Events debugging is on 
         ATM Signaling CALLFAIL debugging is on 
         ATM Signaling Api debugging is on
  • Peform the following steps to limit the impact of the debug output on the operation of the ATM switch:

    1. Define a specific interface on which to run the debugs.

    2. Disable logging to the console with the no logging console command.

    3. Enable logging to the buffer, and configure a large buffer size to store the output.

  • debug sscop error helps to troubleshoot link up or down events at the logical level. Such events are often due to the service-specific connection-oriented protocol (SSCOP) at the signaling plane that resets all signaling. Use the show atm sig statistics command to see the number of resets.

  • Note in particular the location code in the cause IE of a RELEASE message and use the value to isolate your troubleshooting to a problem with an endpoint or a switch in the ATM network.

       Protocol Discriminator:   Q.2931 user-network call control message 
       Call Reference Length:    3 bytes 
        Direction Flag:          Message sent from the side originating call 
        Value:                   0x02c858 
       Message Type:             Release (0x4d) 
        Message AI Flag:         Ignore Action Indicator Field 
        Action Indicator Field:  Not significant 
        Message Length:          7 bytes 
       Information Element Name: Cause (0x08) 
        Coding Standard:         ITU-T standardized 
        Instruction Flag:        Ignore Instruction Field 
        Instruction Field:       Not significant 
        Element Length:          3 bytes 
        Location:                User 
        Cause:                   Invalid information element contents (100) 
        Diagnostics:             Present (listed below) 
        Information Element:     ATM Traffic Descriptor    
    
        Frame 10:    
    
        Protocol Discriminator:   Q.2931 user-network call control message 
         Call Reference Length:   3 bytes 
          Direction Flag:         Message sent to the side originating call 
          Value:                  0x00096e 
         Message Type:            Release (0x4d) 
          Message AI Flag:        Ignore Action Indicator Field 
          Action Indicator Field: Not significant 
          Message Length:         6 bytes 
         Information Element Name: Cause (0x08) 
          Coding Standard:        ITU-T standardized 
          Instruction Flag:       Ignore Instruction Field 
          Instruction Field:      Not significant 
          Element Length:         2 bytes 
          Location:               Private network serving the local user 
          Cause:                  Message not compatible with call state (101)  
      
        Protocol Discriminator:   Q.2931 user-network call control message 
         Call Reference Length:   3 bytes 
          Direction Flag:         Message sent from the side originating call 
          Value:                  0x00096e 
         Message Type:            Release Complete (0x5a) 
          Message AI Flag:        Ignore Action Indicator Field 
          Action Indicator Field: Not significant 
          Message Length:         6 bytes 
         Information Element Name: Cause (0x08) 
          Coding Standard:        ITU-T standardized 
          Instruction Flag:       Ignore Instruction Field 
          Instruction Field:      Not significant 
          Element Length:         2 bytes 
          Location:               User 
          Cause:                  Destination out of order (27)
    

Related Information



Updated: Nov 15, 2007 Document ID: 10503