Guest

Cisco IOS Software Releases 12.0 T

Configuring Multiport T1/E1 ATM Network Modules with IMA on Cisco 2600 and 3600 Series Routers

Table Of Contents

Configuring Multiport T1/E1 ATM Network Modules with Inverse Multiplexing over ATM on Cisco 2600 and 3600 Series Routers

Feature Overview

IMA Protocol Overview

General Description of the ATM T1/E1 IMA Feature Set

Benefits

Restrictions

Related Documents

Supported Platforms

Supported Standards, MIBs, and RFCs

Prerequisites

Configuration Tasks

Configuring the ATM Interface

Verifying the ATM Interface Configuration

Configuring IMA Groups

Verifying IMA Group Configuration

Troubleshooting Tips

Monitoring and Maintaining ATM Inverse Multiplexing

Configuration Examples

E1 IMA Configuration

T1 IMA Configuration

Command Reference

cablelength long

Syntax Description

Defaults

Command Mode

Command History

Usage Guidelines

Example

Related Command

cablelength short

Syntax Description

Default

Command Mode

Command History

Usage Guidelines

Example

Related Command

clock source

Syntax Description

Default

Command Mode

Command History

Usage Guidelines

Example

Related Command

fdl

Syntax Description

Default

Command Mode

Command History

Usage Guidelines

Example

ima active-links-minimum

Syntax Description

Default

Command Mode

Command History

Usage Guidelines

Example

ima clock-mode

Syntax Description

Default

Command Mode

Command History

Usage Guidelines

Example

Related Commands

ima differential-delay-maximum

Syntax Description

Default

Command Mode

Command History

Usage Guidelines

Example

Related Command

ima-group

Syntax Description

Default

Command Mode

Command History

Example

Related Commands

ima test

Syntax Description

Defaults

Command Mode

Command History

Command Usage

Example

Related Command

impedance

Syntax Description

Default

Command Mode

Command History

Command Usage

Example

interface atm ima

Syntax Description

Default

Command Mode

Command History

Usage Guidelines

Example

Related Commands

loopback

Syntax Description

Default

Command Mode

Command History

Usage Guidelines

Example

scrambling-payload

Syntax Description

Defaults

Command Mode

Command History

Usage Guidelines

Example

show controllers atm

Syntax Description

Default

Command History

Usage Guidelines

Example

Related Commands

show ima interface atm

Syntax Description

Default

Command History

Usage Guidelines

Example

Related Command

Debug Command

debug ima

Syntax Description

Default

Command History

Example

Related Commands

Glossary


Configuring Multiport T1/E1 ATM Network Modules with Inverse Multiplexing over ATM on Cisco 2600 and 3600 Series Routers


This document describes the Cisco IOS Inverse Multiplexing for ATM (IMA) features available with the introduction of Multiport T1/E1 ATM network modules with IMA for the Cisco 2600 and 3600 series routers. It includes the following sections:

Feature Overview

Supported Platforms

Supported Standards, MIBs, and RFCs

Prerequisites

Configuration Tasks

Monitoring and Maintaining ATM Inverse Multiplexing

Configuration Examples

Command Reference

Debug Command

Glossary

Feature Overview

Inverse multiplexing provides the capability to transmit and receive a single high-speed data stream over multiple slower-speed physical links. In inverse multiplexing over ATM, the originating stream of ATM cells is divided so that complete ATM cells are transmitted in round-robin order across the set of ATM links.

Asynchronous Transfer Mode (ATM) T1 and E1 IMA network modules provide four or eight T1 or E1 ports with inverse multiplexing capability. These modules allow wide-area networking (WAN) uplinks at speeds ranging from 1.536 Mbps to 12.288 Mbps for T1, and from 1.92 Mbps to 15.36 Mbps for E1. See the "Bandwidth Considerations" section.

Cisco's scalable ATM IMA solution means that you can deploy just the bandwidth you need by using multiple E1 or T1 connections instead of a more expensive E3, T3, or OC-3 to bridge between LANs and ATM WAN applications. Enterprises and branch offices can aggregate traffic from multiple low-bandwidth digital physical transmission media, such as T1 pipes, to transmit voice and data at high-bandwidth connection speeds. For example, illustrates a scenario where an organization must transport a mission-critical application among headquarters and branch offices at 6 Mbps.

Figure 1

LAN-to-WAN Application Connectivity with T1 and IMA

IMA Protocol Overview

In the transmit direction, IMA takes cells from the ATM layer and sends them in a round-robin order over the individual links that make up a logical link group called an IMA group (links can also be assigned as individuals rather than as group members). The IMA group performance is approximately the sum of the links, although some overhead is required for ATM control cells. At the receiving end, the cells are recombined to form the original cell stream and are passed up to the ATM layer.

Filler cells are used to ensure a steady stream on the receiving side. IMA control protocol (ICP) cells control the operation of the inverse multiplexing function. Using a frame length of 128, one out of every 128 cells on each link is an ICP cell. The inverse multiplexing operation is transparent to the ATM layer protocols; therefore, the ATM layer can operate normally as if only a single physical interface were being used.

illustrates inverse multiplexing and demultiplexing with four bundled links, providing 6.144 Mbps of bandwidth for T1s and 7.68 Mbps of bandwidth for E1 for packet traffic. The transmit side, where cells are distributed across the links, is referred to as Tx, and the receive side, where cells are recombined, is called Rx.

Figure 2 Inverse Multiplexing and Demultiplexing

General Description of the ATM T1/E1 IMA Feature Set

ATM networks were designed to handle the demanding performance needs of voice, video, and data at broadband speeds of 34 Mbps and above. However, the high cost and spotty availability of long-distance broadband links limits broadband ATM WANs, preventing many organizations from taking advantage of ATM's power. In response to these issues, the ATM Forum defined lower-speed ATM interface options for T1 and E1. However, this was not a complete solution because a single T1 or E1 link often does not provide enough bandwidth to support either traffic among different router and switch locations or heavy end-user demand.

For this reason, many organizations find themselves caught between the bandwidth limitations of a narrowband T1 or E1 line and the much higher costs of moving to broadband links. In response to this dilemma, the ATM Forum, with Cisco as an active member, defined Inverse Multiplexing for ATM (IMA). Using Cisco 2600 and 3600 series routers to provide ATM access gives branch offices and enterprises an affordable LAN-to-ATM interface.

ATM IMA T1/E1 support on the Cisco 2600 and 3600 series routers includes the following features:

Prioritization of ATM transport, including the following traffic classes:

Real-time and non-real-time variable bit rate (VBR) connection-oriented service suitable for video and voice

Available bit rate (ABR) connection-oriented service for traffic, such as LAN interconnections and TCP/IP connectivity that work well with variable delays

Unspecified bit rate (UBR), as recognized by the ATM Forum, without resource allocation or quality of service (QoS) specifications

Cell-based inverse multiplexing that allows operation, administration, and maintenance (OAM) cells to provide management and monitoring, which performs across the imuxed (inverse multiplexed) links. In this fashion, a Cisco 2600 or 3600 router with ATM IMA functionality can exchange monitoring information, such as connectivity, alarm indication signals (AIS), and loopback.

Permanent virtual connections (PVCs) as well as the switched virtual connections (SVCs) being introduced by carriers. Up to 256 virtual circuits are supported on each interface.

ATM Interim Local Management Interface (ILMI) as specified by the ATM Forum for incorporating network-management capabilities

Automatic and dynamic removal of failed links or those not performing according to delay standards—along with automatic and dynamic restoration when the links are up or when delays are acceptable

Interoperation with the Cisco LS1010, ATM interfaces on Cisco 7200 and 7500 series routers, and Cisco BPX 8600 series wide-area ATM switches

AAL5

Benefits

The following benefits are offered by the ATM T1/E1 IMA features for the Cisco 2600 and 3600 series routers:

High-bandwidth performance at a lower cost than T3 and E3

Internetworking design flexibility and scalability for LAN-to-WAN solutions

Migration path to high bandwidth without the need to change transport facilities

Efficient prioritization provided by the ATM architecture

Restrictions

This section describes general restrictions and ATM aspects that the ATM IMA feature does not support as well as bandwidth considerations.

General Limitations

The following restrictions apply to the ATM IMA feature on the Cisco 2600 and 3600 series:

The ATM IMA T1 and E1 network modules interoperate with the Cisco 3810 multiservice access concentrator, but only when the Cisco MC3810 is in UNI mode, and only when the T1 or E1 links operate as individual links—not as IMA groups.

IMA frame length is automatically set to 128. You cannot configure a different frame length.

The feature does not support AAL1, AAL2, and AAL3/AAL4.

The feature does not support the ATM Constant Bit Rate (CBR) traffic class.

Bandwidth Considerations

When planning IMA groups and payload bandwidth requirements, consider the overhead required for ATM cell headers, service-layer encapsulation such as RFC 1483, AAL5 encapsulation, and ICP cells. and show approximate values for T1 and E1 IMA groups, respectively with a frame length of 128, estimating ATM overhead at about 10 percent. The effective payload bandwidth varies based on packet size because the packets must be divided into an integer number of ATM cells leaving the last cell padded with filler bytes.


Note   Control the bandwidth threshold to activate an IMA group by using the ima active-links-minimum command. For additional information, see "ima active-links-minimum" on page 32.


Table 1 T1 IMA AAL5 Payload Bandwidth; IMA Frame Size 128

Number of Links in the Group
Total Bandwidth
Payload Bandwidth

1

1.536

1.38

2

3.072

2.76

3

4.608

4.14

4

6.144

5.52

5

7.68

6.91

6

9.216

8.28

7

10.752

9.66

8

12.288

11.04


Table 2 E1 AAL5 Payload IMA Bandwidth; IMA Frame Size 128

Number of Links in the Group
Total Bandwidth
Payload Bandwidth

1

1.92

1.74

2

3.84

3.47

3

5.76

5.21

4

7.68

6.95

5

9.60

8.69

6

11.52

10.43

7

13.44

12.17

8

15.36

13.90


Related Documents

The following Cisco IOS Release 12.0 documents provide information about ATM configuration:

Wide-Area Networking Configuration Guide

Wide-Area Networking Command Reference

For information about the physical characteristics of the ATM T1/E1 IMA network modules, or for instructions on how to install the network or modem modules, either see the Cisco 2600 or 3600 series Network Module Hardware Installation Guide that came with your ATM T1/E1 IMA network module or view the up-to-date information on CCO.

Supported Platforms

The ATM IMA feature is supported on the following modular access routers:

Cisco 3640

Cisco 3620

Cisco 2610

Cisco 2611

Cisco 2612

Cisco 2613

Cisco 2620

Cisco 2621

Supported Standards, MIBs, and RFCs

This feature supports the following MIBs:

IMA MIB (ATM Forum, AF-PHY-0086.001)

DS1/E1 MIB (as defined in RFC 1406)

Chassis MIB

For descriptions of supported MIBs and how to use MIBs, see Cisco's MIB website on CCO at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.

This feature supports the following RFCs:

RFC 1573—ifGeneralGroup and ifStackGroup from the Interfaces Group of MIB-II

RFC 1577

RFC 1483

Prerequisites

Before you can configure a Cisco 2600 or 3600 series router to provide ATM IMA T1/E1 service, you must perform the following tasks:

Obtain T1 or E1 service from your telecommunications provider.

Install a multiport T1/E1 ATM network module with IMA into your Cisco router. One of the following multiport T1/E1 ATM network module with IMA is required to support inverse multiplexed ATM on the Cisco 2600 and 3600 series routers:

NM-4T-IMA—Four-port ATM network module providing T1 connectivity.

NM-8T-IMA—Eight-port ATM network module providing T1 connectivity.

NM-4E-IMA—Four-port ATM network module providing E1 connectivity.

NM-8E-IMA—Eight-port ATM network module providing E1 connectivity.

Configuration Tasks

This section describes the configuration tasks required in order to set up ATM IMA groups. You can also configure ATM links individually, but this feature description only includes those individual configuration steps that may pertain to ATM IMA groups.

Perform the following configuration tasks in order to enable ATM inverse multiplexing:

Configure the ATM interfaces to specify the links that are part of IMA groups.

Configure the IMA group functions.

Configuring the ATM Interface

Repeat the steps below to configure each ATM interface for ATM IMA operation.

Step
Command
Purpose

1

Router# configure terminal

Enter global configuration mode.

1

Router(config)# interface atm slot/port

Enter interface configuration mode and specify the location of the interface.

The slot value indicates the router slot position of the installed network module. Depending on the router, enter a slot value from 0 to 3.

The port value indicates the T1 or E1 link that you are configuring. Enter a value from 0 to 3 or from 0 to 7, depending on whether the network module has four ports or eight ports. Cisco IOS creates the interfaces automatically when a module is installed.

2

Router(config-if)# clock source {line | internal |
loop-timed}

The clock source command sets the clock source for a link.

line specifies that the link uses the recovered clock from the link and is the default setting. Generally, this setting is most reliable.

internal specifies that the DS1 link uses the internal clock.

loop-timed specifies that the T1 or E1 interface takes the clock from the Rx (line) and uses it for Tx. If the ATM interface is part of an IMA group, you can use the loop-timed keyword to specify that the clock source is the same as the IMA group clock source.

Note   Ensure that clock settings are properly configured for each link even when you intend to use a common link for clocking all the links in an IMA group. See the "ima clock-mode" section.

3

Router(config-if)# cablelength long {gain26 | gain36}
{-15db | -22.5db | -7.5db | 0db}

or

cablelength short {133 | 266 | 399 | 533 | 655}

(T1 interfaces only) To set a cable length longer than 655 feet for a T1 link, use the cablelength long command. The keywords are as follows:

gain26 is the number of decibels by which the receiver signal is increased. This is the default.

gain36 is the number of decibels by which the receiver signal is increased. The default is 26db.

-15db is the number of decibels by which the transmit signal is decreased. The default is 0db.

-22.5db is the number of decibels by which the transmit signal is decreased. The default is 0db.

-7.5db is the number of decibels by which the transmit signal is decreased. The default is 0db.

0db is the number of decibels by which the transmit signal is decreased. This is the default.

To set a cable length 655 feet or shorter for a T1 link, use the short command. There is no default for cablelength short. The keywords are as follows:

133 specifies a cable length from 0-133 feet.

266 specifies a cable length from 134-266 feet.

399 specifies a cable length from 267-399 feet.

533 specifies a cable length from 400-533 feet.

655 specifies a cable length from 534-655 feet.

If you do not set the cable length, the system defaults to a setting of cablelength long gain26 0db.

4

Router(config-if)# no ip address

Instead of configuring protocol parameters on the physical interface, you can set up the parameters on the IMA group virtual interface.

5

Router(config-if)# no atm oversubscribe

The no atm oversubscribe command1 enables the ATM bandwidth manager, which keeps track of bandwidth used by virtual circuits on a per-interface basis. This is useful because many services, such as ABR and VBR-RT, require guaranteed bandwidth. When you specify the no form of the command, a check determines whether the ATM link is already oversubscribed. If it is, the command is rejected. Otherwise, the total bandwidth available on the link is recorded and all future connection setup requests are monitored to ensure that the link is not oversubscribed.

6

Router(config-if)# no scrambling payload

Normally, the default setting for this command is sufficient. Helping to ensure reliability, scrambling randomizes the ATM cell payload frames to avoid continuous non-variable bit patterns and improve the efficiency of ATM's cell delineation algorithms. By default, payload scrambling is on for E1 links and off for T1 links.

7

Router(config-if)# impedance {75-ohm |120-ohm}

(E1 interfaces only) This command specifies the impedance (amount of wire resistance and reactivity to current) for the E1 link. Impedance levels are maintained to avoid data corruption over long-distance links. The impedance is determined by the dongle-type cable that you plug in to the IMA module. Set this command to match that cable.

Specify 120-ohm to match the unbalanced twisted-pair 120-ohm interface. This is the default.

75-ohm is for a balanced BNC 750-ohm interface.

8

Router(config-if)# loopback [line | local | payload |
remote]

(For testing only) This command is useful for testing because it loops all packets from the ATM interface back to the interface and directs the packets to the network.

The default line setting places the interface into external loopback mode at the line.

remote keeps the local end of the connection in remote loopback mode.

local places the interface into local loopback mode.

payload places the interface into external loopback at the payload level.

9

Router(config-if)# fdl {att | ansi | all | none}

(Optional, T1 only) This command sets the Facility Data Link (FDL) exchange standard for the CSU controllers. The FDL is a 4-Kpbs channel used with the Extended SuperFrame (ESF) framing format to provide out-of-band messaging for error-checking on a T1 link.

Note   For T1, ESF framing and binary eight zero substitution (B8ZS) line encoding are set. For E1, CRC4 multiframe framing and HDB3 line encoding are set. These are the parameters specified by the ATM Forum, and they cannot be changed.

You should generally leave this setting at the default, ansi, which follows the ANSI T1.403 standard for extended superframe facilities data link exchange support. Changing it allows improved management in some cases but can cause problems if your setting is not compatible with that of your service provider.

att selects the AT&T TR54016 standard for extended superframe facilities data link exchange support.

all enables both of the above standards.

none means that there is no standard suported for the FDL exchange standard.

10

Router(config-if)# ima-group group-number

This command specifies that the link is included in an IMA group. Enter an IMA group number from 0 to 3. You can specify up to four groups for each IMA network module. IMA groups usually span multiple ports on a module.

11

Router(config-if)# no shutdown

This command ensures that the link is active at the IMA level. If shut down, the link is added to the group but put in an inhibited state.

1 This command was introduced in Cisco IOS Release 12.0(3)T. For more information, see the online feature description, ATM OC-3 Network Module for the Cisco 3600 Series Routers, on CCO at http://www.cisco.com/univercd/cc/td/doc/product/software/ios120/120newft/120t/120t3/oc3_fm.htm. 


Verifying the ATM Interface Configuration

Follow the steps below to verify the configuration of ATM interfaces.


Step 1 Enter the privileged EXEC show interface atm slot/port command to verify the configuration of the ATM interface. Important information appears in bold. Notice that the total count of configured virtual circuits (VCs) is shown.

router# show interface atm0/1
ATM0/1 is up, line protocol is up
  Hardware is ATM T1
  Internet address is 21.1.1.2/8
  MTU 4470 bytes, sub MTU 4470, BW 1500 Kbit, DLY 20000 usec,
     reliability 0/255, txload 1/255, rxload 1/255
  Encapsulation ATM, loopback not set
  Keepalive not supported
  Encapsulation(s): AAL5
  256 maximum active VCs, 3 current VCCs
  VC idle disconnect time: 300 seconds
  Last input never, output never, output hang never
  Last clearing of "show interface" counters never
  Queueing strategy: fifo
  Output queue 0/40, 0 drops; input queue 0/75, 0 drops
  5 minute input rate 0 bits/sec, 0 packets/sec
  5 minute output rate 0 bits/sec, 0 packets/sec
     0 packets input, 0 bytes, 0 no buffer
     Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
     0 packets output, 0 bytes, 0 underruns
     0 output errors, 0 collisions, 3 interface resets
     0 output buffer failures, 0 output buffers swapped out

Step 2 To get information about the physical link, enter the privileged EXEC show controller atm [slot/port] command.

router# show controller atm0/2
Interface ATM0/2 is administratively down
  Hardware is ATM T1
LANE client MAC address is 0050.0f0c.1482
  hwidb=0x617BEE9C, ds=0x617D498C
  slot 0, unit 2, subunit 2
  rs8234 base 0x3C000000, slave base 0x3C000000
  rs8234 ds 0x617D498C
  SBDs - avail 2048, guaranteed 2, unguaranteed 2046, starved 0
 Seg VCC table 3C00B800, Shadow Seg VCC Table 617EF76C, VCD Table 61805798
 Schedule table 3C016800, Shadow Schedule table 618087C4, Size 63D
 RSM VCC Table 3C02ED80, Shadow RSM VCC Table 6180C994
 VPI Index Table 3C02C300, VCI Index Table 3C02E980
 Bucket2 Table 3C01E500, Shadow Bucket2 Table 6180A0E4
 MCR Limit Table 3C01E900, Shadow MCR Table 617D2160
 ABR template 3C01EB00, Shadow template 614DEEAC
 RM Cell RS Queue 3C02C980
 Queue           TXQ Addr  Pos  StQ Addr  Pos
 0  UBR CHN0     3C028B00  0    03118540  0
 1  UBR CHN1     3C028F00  0    03118D40  0
 2  UBR CHN2     3C029300  0    03119540  0
 3  UBR CHN3     3C029700  0    03119D40  0
 4  VBR/ABR CHN0 3C029B00  0    0311A540  0
 5  VBR/ABR CHN1 3C029F00  0    0311AD40  0
 6  VBR/ABR CHN2 3C02A300  0    0311B540  0
 7  VBR/ABR CHN3 3C02A700  0    0311BD40  0
 8  VBR-RT CHN0  3C02AB00  0    0311C540  0
 9  VBR-RT CHN1  3C02AF00  0    0311CD40  0
 10 VBR-RT CHN2  3C02B300  0    0311D540  0
 11 VBR-RT CHN3  3C02B700  0    0311DD40  0
 12 SIG          3C02BB00  0    0311E540  0
 13 VPD          3C02BF00  0    0311ED40  0
 Queue           FBQ Addr  Pos  RSQ Addr  Pos
 0  OAM          3C0EED80  255  0311F600  0
 1  UBR CHN0     3C0EFD80  0    03120600  0
 2  UBR CHN1     3C0F0D80  0    03121600  0
 3  UBR CHN2     3C0F1D80  0    03122600  0
 4  UBR CHN3     3C0F2D80  0    03123600  0
 5  VBR/ABR CHN0 3C0F3D80  0    03124600  0
 6  VBR/ABR CHN1 3C0F4D80  0    03125600  0
 7  VBR/ABR CHN2 3C0F5D80  0    03126600  0
 8  VBR/ABR CHN3 3C0F6D80  0    03127600  0
 9  VBR-RT CHN0  3C0F7D80  0    03128600  0
 10 VBR-RT CHN1  3C0F8D80  0    03129600  0
 11 VBR-RT CHN2  3C0F9D80  0    0312A600  0
 12 VBR-RT CHN3  3C0FAD80  0    0312B600  0
 13 SIG          3C0FBD80  255  0312C600  0
SAR Scheduling channels:  -1 -1 -1 -1 -1 -1 -1 -1
Part of IMA group 3
Link 2 IMA Info:
   group index is 1
   Tx link id is 2, Tx link state is unusableNoGivenReason
   Rx link id is 99, Rx link state is unusableFault
    Rx link failure status is fault,
    0 tx failures, 3 rx failures
Link 2 Framer Info:
    framing is ESF, line code is B8ZS, fdl is ANSI
    cable-length is long, Rcv gain is 26db and Tx gain is 0db,
    clock src is line, payload-scrambling is disabled, no loopback
    line status is 0x1064; or Tx RAI, Rx LOF, Rx LOS, Rx LCD.
    port is active, link is unavailable
    0 idle rx, 0 correctable hec rx, 0 uncorrectable hec rx
    0 cells rx, 599708004 cells tx, 0 rx fifo overrun.
Link (2):DS1 MIB DATA:
  Data in current interval (518 seconds elapsed):
     0 Line Code Violations, 0 Path Code Violations
     0 Slip Secs, 518 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
     0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 519 Unavail Secs
  Total Data (last 24 hours)
     0 Line Code Violations, 0 Path Code Violations,
     0 Slip Secs, 86400 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
     0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 86400 Unavail Secs
SAR counter totals across all links and groups:
   0 cells output, 0 cells stripped
   0 cells input, 0 cells discarded, 0 AAL5 frames discarded
   0 pci bus err, 0 dma fifo full err, 0 rsm parity err
   0 rsm syn err, 0 rsm/seg q full err, 0 rsm overflow err
   0 hs q full err, 0 no free buff q err, 0 seg underflow err
   0 host seg stat q full err

Configuring IMA Groups

As shown in the previous section, the ima-group command configures links on an ATM interface as IMA group members. When IMA groups have been set up in this way, you can configure settings for each group.

Step
Command
Purpose

1

Router# configure terminal

Enter global configuration mode.

2

Router(config)# interface atm slot/imagroup-number

Enter interface configuration mode and specify the slot location of the interface and IMA group number.

The slot value indicates the router slot where the network module is located. depending on the router, enter a slot value from 0 to 3.

The group-number is the IMA group label. Enter a value from 0 to 3. Do not leave a space between "ima" and the group number.

3

Router(config-if)# ip address ip-address

You can set protocol parameters for the whole group.

4

Router(config-if)# pvc vpi/vci ilmi

If you are going to use SVCs, create an ATM permanent virtual circuit (PVC) for ILMI management purposes and enter VC configuration mode. To set up communication with the ILMI, use a value of ilmi for ATM adaptation layer encapsulation; the associated vpi and vci values are ordinarily 0 and 16, respectively.

Note   This command is new to the Cisco 2600 and 3600 series, but was introduced for other platforms in prior releases.

5

Router(config-if-atm-vc)# pvc vpi/vci qsaal

To enable the signaling for setup and tear-down of SVCs, specify the Q.SAAL (Signaling ATM Adaptation Layer) encapsulation; the associated vpi and vci values are ordinarily 0 and 5, respectively.

Note   You can also set up PVCs for sending information.

6

Router(config-if)# svc name nsap nsap-address

You can also set up SVCs for sending ATM information. Once you specify a name for an SVC, you can re-enter the interface-ATM-VC configuration mode by simply entering svc name.

nsap-address is a 40-digit hexadecimal number.

7

Router(config-if-atm-vc)# protocol ip address broadcast

You can specify a protocol address for the SVC.

Note   The default AAL5 layer and SNAP encapsulation is used in this example, so the encapsulation aalencap command is unnecessary.

8

Router(config-if-atm-vc)# vbr-rt peak-rate average-rate
burst

You can configure a type of ATM service on the SVC. This example uses Variable Bit Rate, real-time, for AAL5 communications, allowing you to set different cell rate parameters for connections where there is a fixed timing relationship among samples. (VBR is generally used with AAL5 and IP over ATM.) The command configures traffic shaping, so that the carrier does not discard calls. Configure the burst value if the SVC will carry bursty traffic.1

The default is UBR at the maximum line rate of the physical interface, but for an SVC on an IMA group, configure one of the services listed below, or use the vbr-rt command described above. The -pcr and -mcr arguments are the peak cell rate and minimum cell rate, respectively. The -scr and -mbs arguments are the sustainable cell rate and maximum burst size respectively.

abr output-pcr output-mcr for best-effort Available Bit Rate traffic for such applications as LAN interconnections and TCP/IP where a guaranteed cell rate is not required. The peak cell -pcr specifies the maximum value of the allowed cell rate (ACR), and minimum cell rate -mcr specifies the minimum value for the ACR.

vbr-nrt output-pcr output-scr output-mbs [input-pcr] [input-scr] [input-mbs] for Variable Bit Rate, non-real-time traffic where no fixed timing relationship exists between samples.

ubr output-pcr [input-pcr for Unassigned Bit Rate traffic where any amount of data up to the specified maximum can be sent, but there are no guarantees in terms of cell loss rate and delay.

9

Router(config-if-atm-vc)# exit

Exit VC configuration mode and return to interface configuration mode.

10

Router(config-if)# ima clock-mode {common [port] |
independent}

To set the transmit clock mode for the group, use this command.

If all the links in the group should share a clock source, use the common keyword.

If each link uses a different clock source, use the independent clock source keyword. The optional port keyword allows you to specify a link to be used for common clocking. The default uses the common clock and automatically chooses a recovered Rx (receive) clock source as the Tx (transmit) clock source.

11

Router(config-if)# ima active-links-minimum number

To specify how many transmit links must be active in order for the IMA group to be operational, use this command with a number value from 1 to 8. The setting you choose depends upon your performance requirements and the total number of links in the group. If fewer than the preset minimum number are active, the group is automatically rendered inactive until the minimum number of links are up again. The default value is 1.

12

Router(config-if)# ima differential-delay-maximum msec

To specify the maximum allowed differential timing delay that can exist among the active links in an IMA group, use this command by entering a milliseconds value from 25 to 200. If a link's differential delay exceeds the configured value, it stops carrying ATM-layer cells; otherwise, the IMA feature adjusts for differences in delays so that all links in a group are actively carrying network traffic. A short delay provides less tolerance in adjusting for long differential delays. However, a high value may affect overall group performance, because increased differential delay adds more latency to the traffic that is transmitted across the group.

13

Router(config-if)# ima test [link port] [pattern 
pattern id]

This command is typically used to troubleshoot or diagnose physical link connectivity. The IMA feature performs ongoing tests on all links in a group to verify link connectivity. The command specifies a link to use for testing and a test pattern. The pattern is sent from the specified link and looped back from the receiving end in the multiplexing-demultiplexing process. A byte in the ICP cell identifies the pattern.


Verifying IMA Group Configuration


Step 1 Enter the privileged EXEC show ima interface atm [slot] /ima[group-number] [detail] command to get information about IMA group interfaces. In the examples below, important information is shown in bold. The first example shows the command output without the detail keyword; the second example shows the detailed information.


Note   This command is unavailable in Cisco IOS Release 12.0(5)T. It is available in Release 12.0(5)XK and is planned for availability in Cisco IOS Releases 12.0(5.1)T and 12.0(7)T.


Router# show ima interface ATM2/IMA2
Interface ATM2/IMA2 is up
        Group index is 2
        Ne state is operational, failure status is noFailure
        active links bitmap 0x30
    IMA Group Current Configuration:
        Tx/Rx configured links bitmap 0x30/0x30
        Tx/Rx minimum required links 1/1
        Maximum allowed diff delay is 25ms, Tx frame length 128
        Ne Tx clock mode CTC, configured timing reference link ATM2/4
        Test pattern procedure is disabled
    IMA Group Current Counters (time elapsed 12 seconds):
        3 Ne Failures, 3 Fe Failures, 4 Unavail Secs
    IMA Group Total Counters (last 0 15 minute intervals):
        0 Ne Failures, 0 Fe Failures, 0 Unavail Secs
    IMA link Information:
        Link     Physical Status        NearEnd Rx Status      Test Status 
        ----     ---------------        -----------------      ----------- 
        ATM2/4   up                     active                 disabled    
        ATM2/5   up                     active                 disabled    

router# show ima interface ATM2/IMA2 detail 
Interface ATM2/IMA2 is up
        Group index is 2
        Ne state is operational, failure status is noFailure
        active links bitmap 0x30
    IMA Group Current Configuration:
        Tx/Rx configured links bitmap 0x30/0x30
        Tx/Rx minimum required links 1/1
        Maximum allowed diff delay is 25ms, Tx frame length 128
        Ne Tx clock mode CTC, configured timing reference link ATM2/4
        Test pattern procedure is disabled
    Detailed group Information:
        Tx/Rx Ima_id 0x22/0x40, symmetry symmetricOperation
        Number of Tx/Rx configured links 2/2
        Number of Tx/Rx active links 2/2
        Fe Tx clock mode ctc, Rx frame length 128
        Tx/Rx timing reference link 4/4
        Maximum observed diff delay 0ms, least delayed link 5
        Running seconds 32
        GTSM last changed 10:14:41 UTC Wed Jun 16 1999
    IMA Group Current Counters (time elapsed 33 seconds):
        3 Ne Failures, 3 Fe Failures, 4 Unavail Secs
    IMA Group Total Counters (last 0 15 minute intervals):
        0 Ne Failures, 0 Fe Failures, 0 Unavail Secs
    Detailed IMA link Information:
Interface ATM2/4 is up
        ifIndex 13, Group Index 2, Row Status is active
        Tx/Rx Lid 4/4, relative delay 0ms
        Ne Tx/Rx state active/active
        Fe Tx/Rx state active/active
        Ne Rx failure status is noFailure
        Fe Rx failure status is noFailure
        Rx test pattern 0x41, test procedure disabled
    IMA Link Current Counters (time elapsed 35 seconds):
        1 Ima Violations, 0 Oif Anomalies
        1 Ne Severely Err Secs, 2 Fe Severely Err Secs
        0 Ne Unavail Secs, 0 Fe Unavail Secs
        2 Ne Tx Unusable Secs, 2 Ne Rx Unusable Secs
        0 Fe Tx Unusable Secs, 2 Fe Rx Unusable Secs
        0 Ne Tx Failures, 0 Ne Rx Failures
        0 Fe Tx Failures, 0 Fe Rx Failures
    IMA Link Total Counters (last 0 15 minute intervals):
        0 Ima Violations, 0 Oif Anomalies
        0 Ne Severely Err Secs, 0 Fe Severely Err Secs
        0 Ne Unavail Secs, 0 Fe Unavail Secs
        0 Ne Tx Unusable Secs, 0 Ne Rx Unusable Secs
        0 Fe Tx Unusable Secs, 0 Fe Rx Unusable Secs
        0 Ne Tx Failures, 0 Ne Rx Failures
        0 Fe Tx Failures, 0 Fe Rx Failures
Interface ATM2/5 is up
        ifIndex 14, Group Index 2, Row Status is active
        Tx/Rx Lid 5/5, relative delay 0ms
        Ne Tx/Rx state active/active
        Fe Tx/Rx state active/active
        Ne Rx failure status is noFailure
        Fe Rx failure status is noFailure
        Rx test pattern 0x41, test procedure disabled
    IMA Link Current Counters (time elapsed 46 seconds):
        1 Ima Violations, 0 Oif Anomalies
        1 Ne Severely Err Secs, 2 Fe Severely Err Secs
        0 Ne Unavail Secs, 0 Fe Unavail Secs
        2 Ne Tx Unusable Secs, 2 Ne Rx Unusable Secs
        0 Fe Tx Unusable Secs, 2 Fe Rx Unusable Secs
        0 Ne Tx Failures, 0 Ne Rx Failures
        0 Fe Tx Failures, 0 Fe Rx Failures
    IMA Link Total Counters (last 0 15 minute intervals):
        0 Ima Violations, 0 Oif Anomalies
        0 Ne Severely Err Secs, 0 Fe Severely Err Secs
        0 Ne Unavail Secs, 0 Fe Unavail Secs
        0 Ne Tx Unusable Secs, 0 Ne Rx Unusable Secs
        0 Fe Tx Unusable Secs, 0 Fe Rx Unusable Secs
        0 Ne Tx Failures, 0 Ne Rx Failures
        0 Fe Tx Failures, 0 Fe Rx Failures

Step 2 To review physical level information about the IMA group, enter the show controllers atm [slot//ima group-number] command, as shown in the following example:

router# show controller atm0/ima3
Interface ATM0/IMA3 is up
  Hardware is ATM IMA
  LANE client MAC address is 0050.0f0c.148b
  hwidb=0x61C2E990, ds=0x617D498C
  slot 0, unit 3, subunit 3
  rs8234 base 0x3C000000, slave base 0x3C000000
  rs8234 ds 0x617D498C
  SBDs - avail 2048, guaranteed 3, unguaranteed 2045, starved 0
 Seg VCC table 3C00B800, Shadow Seg VCC Table 617EF76C, VCD Table 61805798
 Schedule table 3C016800, Shadow Schedule table 618087C4, Size 63D
 RSM VCC Table 3C02ED80, Shadow RSM VCC Table 6180C994
 VPI Index Table 3C02C300, VCI Index Table 3C02E980
 Bucket2 Table 3C01E500, Shadow Bucket2 Table 6180A0E4
 MCR Limit Table 3C01E900, Shadow MCR Table 617D2160
 ABR template 3C01EB00, Shadow template 614DEEAC
 RM Cell RS Queue 3C02C980
 Queue           TXQ Addr  Pos  StQ Addr  Pos
 0  UBR CHN0     3C028B00  0    03118540  0
 1  UBR CHN1     3C028F00  0    03118D40  0
 2  UBR CHN2     3C029300  0    03119540  0
 3  UBR CHN3     3C029700  0    03119D40  0
 4  VBR/ABR CHN0 3C029B00  0    0311A540  0
 5  VBR/ABR CHN1 3C029F00  0    0311AD40  0
 6  VBR/ABR CHN2 3C02A300  0    0311B540  0
 7  VBR/ABR CHN3 3C02A700  0    0311BD40  0
 8  VBR-RT CHN0  3C02AB00  0    0311C540  0
 9  VBR-RT CHN1  3C02AF00  0    0311CD40  0
 10 VBR-RT CHN2  3C02B300  0    0311D540  0
 11 VBR-RT CHN3  3C02B700  0    0311DD40  0
 12 SIG          3C02BB00  0    0311E540  0
 13 VPD          3C02BF00  0    0311ED40  0
 Queue           FBQ Addr  Pos  RSQ Addr  Pos
 0  OAM          3C0EED80  255  0311F600  0
 1  UBR CHN0     3C0EFD80  0    03120600  0
 2  UBR CHN1     3C0F0D80  0    03121600  0
 3  UBR CHN2     3C0F1D80  0    03122600  0
 4  UBR CHN3     3C0F2D80  0    03123600  0
 5  VBR/ABR CHN0 3C0F3D80  0    03124600  0
 6  VBR/ABR CHN1 3C0F4D80  0    03125600  0
 7  VBR/ABR CHN2 3C0F5D80  0    03126600  0
 8  VBR/ABR CHN3 3C0F6D80  0    03127600  0
 9  VBR-RT CHN0  3C0F7D80  0    03128600  0
 10 VBR-RT CHN1  3C0F8D80  255  03129600  0
 11 VBR-RT CHN2  3C0F9D80  0    0312A600  0
 12 VBR-RT CHN3  3C0FAD80  0    0312B600  0
 13 SIG          3C0FBD80  255  0312C600  0
SAR Scheduling channels:  -1 -1 -1 -1 -1 -1 -1 -1
ATM channel number is 1
link members are 0x7, active links are 0x0
Group status is blockedNe, 3 links configured,
Group Info: Configured links bitmap 0x7, Active links bitmap 0x0,
    Tx/Rx IMA_id 0x3/0x63,
    NE Group status is startUp,
    frame length 0x80, Max Diff Delay 0,
    1 min links, clock mode ctc, symmetry symmetricOperation, trl 0,
    Group Failure status is startUpNe.
    Test pattern procedure is disabled
SAR counter totals across all links and groups:
   0 cells output, 0 cells stripped
   0 cells input, 0 cells discarded, 0 AAL5 frames discarded
   0 pci bus err, 0 dma fifo full err, 0 rsm parity err
   0 rsm syn err, 0 rsm/seg q full err, 0 rsm overflow err
   0 hs q full err, 0 no free buff q err, 0 seg underflow err
   0 host seg stat q full err

Step 3 Enter the privileged EXEC show atm vc command to see how SVCs and PVCs are set up.

 VCD /                                      Peak  Avg/Min Burst
Interface   Name       VPI   VCI  Type   Encaps   SC   Kbps   Kbps   Cells  Sts
0/1        1            0    50   PVC    SNAP     UBR    1000              INAC
0/IMA3     2            0     5   PVC    SAAL     UBR    4000                UP
0/IMA3     3            0    16   PVC    ILMI     UBR    4000                UP
0/IMA3     first        1    13   PVC    MUX      VBR     640    320   80    UP
0/IMA3     4            0    34   SVC    SNAP     VBR-RT  768    768         UP

Troubleshooting Tips

To troubleshoot the ATM and IMA group configuration, enter the ping EXEC (user) or privileged EXEC command that checks host reachability and network connectivity. This command can confirm basic network connectivity on AppleTalk, ISO CLNS, IP, Novell, Apollo, VINES, DECnet, or XNS networks.

For IP, the ping command sends ICMP (Internet Control Message Protocol) Echo messages. If a station receives an ICMP Echo message, it sends an ICMP Echo Reply message back to the source.

The extended command mode of the ping command permits you to specify the supported IP header options, so that the router can perform a more extensive range of test options. To enter ping extended command mode, enter yes at the extended commands prompt of the ping command.

For detailed information on using the ping and extended ping commands, see the Cisco IOS Release 12.0 Configuration Fundamentals Command Reference.

If a ping command fails, check the following possible reasons for the connectivity problem:

The interface is down, causing a "no ip route" error message.

The PVC or SVC does not include proper mapping configured for the destination address, causing an "encapsulation failure" error. For more information about the VC encapsulation command, see the "Configuring IMA Groups" section and the Cisco IOS Release 12.0 Wide-Area Networking Command Reference.

If there is a firmware problem, the privileged EXEC show controller atm [slot/port] command shows whether an interface is able to transmit and receive cells. For sample output, see the "Verifying the ATM Interface Configuration" section.


Tips


Use the ping command when the network is functioning properly to see how the command works under normal conditions and so that you can compare the results when troubleshooting.

If a communication session is closing when it should not be, an end-to-end connection problem can be the cause. The debug ip packet command is useful for analyzing the messages traveling between the local and remote hosts. IP debugging information includes packets received, generated, and forwarded. Because the debug ip packet command generates a significant amount of output, use it only when traffic on the IP network is low, so other activity on the system is not adversely affected.

Monitoring and Maintaining ATM Inverse Multiplexing

Command
Purpose
Router# show ima interface atm [slot]/ima [group-number] 
[detail]

Displays general or detailed information about IMA groups and the links in those groups.

Note   This command is unavailable in Cisco IOS Release 12.0(5)T. It is available in Release 12.0(5)XK and is planned for availability in Cisco IOS Releases 12.0(5.1)T and 12.0(7)T.

Router# show controllers [atm slot/port]
Router# show controllers [atm slot/ima group-number]

Display information about current settings and performance at the physical level.


Configuration Examples

This section shows two sample configurations: one for a router that is set up for E1 ATM IMA and one for T1 ATM IMA.

E1 IMA Configuration

The following configuration example shows setup of ATM interfaces, IMA groups, PVCs, and SVCs for E1 IMA.

version 12.0
service timestamps debug uptime
service timestamps log uptime
no service password-encryption
!
hostname IMARouter
!
logging buffered 4096 debugging
!
ip subnet-zero
no ip domain-lookup
ip host 10.11.16.2
ip host 10.11.16.3
ip host 10.11.55.192
ip host 10.11.55.193
ip host 10.11.55.195
ip host 10.11.55.196
!
!
!
!
interface Ethernet0/0
 ip address 10.17.12.100 255.255.255.192
 no ip directed-broadcast
!

ATM interface 1/0 includes a PVC, but the specified link is not included in an IMA group. In this example, impedance and scrambling are set at their default values for E1 links and must match the far-end setting. The broadcast setting on the PVC takes precedence (addresses are fictional).

interface ATM1/0
 ip address 10.1.1.26 255.255.255.1
 no ip directed-broadcast
 no atm oversubscribe
 pvc 1/40 
  protocol ip 10.10.10.10 broadcast
 !
 scrambling-payload
 impedance 120-ohm
 no fair-queue
!

The eight-port ATM IMA E1 network module is in slot 1, and the interface commands below specify three links as members of IMA group 0.

interface ATM1/1
 no ip address
 no ip directed-broadcast
 no atm oversubscribe
 ima-group 0
 scrambling-payload
 impedance 120-ohm
 no fair-queue
!
interface ATM1/2
 no ip address
 no ip directed-broadcast
 no atm oversubscribe
 ima-group 0
 scrambling-payload
 impedance 120-ohm
 no fair-queue
!
interface ATM1/3
 no ip address
 no ip directed-broadcast
 no atm oversubscribe
 ima-group 0
 scrambling-payload
 impedance 120-ohm
 no fair-queue
!

Four links are members of IMA group 1.

interface ATM1/4
 no ip address
 no ip directed-broadcast
 no atm oversubscribe
 ima-group 1
 scrambling-payload
 impedance 120-ohm
 no fair-queue
!
interface ATM1/5
 no ip address
 no ip directed-broadcast
 no atm oversubscribe
 ima-group 1
 scrambling-payload
 impedance 120-ohm
 no fair-queue