Table Of Contents
Data Compression AIM for the Cisco 2600 Series Routers
Configuring Frame-relay Map Compression
Configuring Frame-relay payload-compression
frame-relay map payload-compression frf9 stac caim
frame-relay payload-compression frf9 stac
Data Compression AIM for the Cisco 2600 Series Routers
The following sections are provided:
Feature Summary
This document describes how to configure, verify, and troubleshoot the data compression features of the Advanced Interface Module (AIM) on the Cisco 2600 series router. The data compression AIM provides hardware-based compression and decompression of packet data transmitted and received on the serial network interfaces of the Cisco 2600 series router without occupying the Port Module Slot which might otherwise be used for additional customer network ports. Supported are the industry standard Limpel Zif Stac (LZS) and Microsoft point-to-point compression (MPPC) compression algorithms over point-to-point protocol (PPP) or frame relay. High-level Data Link Control (HDLC) is not supported. The Data Compression AIM requires Cisco IOS Release 12.0(1)T, or later.
Benefits
The data compression AIM provides a cost effective hardware based compression which yields a higher level of performance than available from the main chassis CPU running the Cisco IOS compression feature. The data compression AIM series cards provide enhanced versatility, network peripheral integration, and performance for the Cisco 2600 series routers. The data compression AIM delivers higher levels of WAN bandwidth optimization by supporting compression ratios of up to 4:1 with 8 Mbps throughput.
List of Terms
AIM—Advanced Interface Module; a hardware module which is designed to plug directly into a header on the Cisco 2600 series router motherboard.
Compression AIM—(CAIM) A hardware module containing a data compression coprocessor device that serves as a compact Compression Port Module similar to those used in larger routers, but is more compact, and does not require a Port Module slot.
CAIM Element—A hardware component such as a HiFn 9711 Compression Coprocessor, which is designed to compress and decompress data.
Context—The history of a session where data is either compressed or decompressed. The session that provides compression is distinct from the session that provides decompression. The history of either session is stored long enough to reference the context so that data is handled correctly.
IDPROM—A PROM mounted on the CAIM daughter-board that provides identification for the system. Often referred to as EEPROM since it uses an electrically erasable PROM.
LZS—Limpel, Zif, and Stac compression algorithm. A widely used, patented compression algorithm, often referred to as STAC.
PPP—Point-to-Point Protocol for WANs. See RFC-1331 for more information.
STAC—The algorithm that includes the Limpel and Zif compression algorithms widely used for data compression.
MPPC—Microsoft Point-to-Point Compression (PPC) compression algorithm, used to exchange compressed information with a Microsoft NT remote access server.
WIC—Wide Area Network Interface Card placed in the network module slot.
Restrictions
The following restrictions apply:
•
Install the data compression AIM board in your Cisco 2600.
•
•
Platform
This feature is supported on these platforms:
•
•
•
•
•
•
Prerequisites
You must have installed the data compression AIM board in your Cisco 2600, and upgraded the programmable logic device (PLD) before you enter any other data compression AIM related commands. See "Data Compression AIM Configuration Note" P/N 78-5531-01 for more information about the steps required for the upgrade procedure.
Supported MIBs and RFCs
The required MIB and RFC support is as follows:
•
•
This feature supports the following SNMP version 1 MIBs:
•
•
•
•
•
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.
The compression service adapters can be monitored with the Cisco Compression Service Adapter (CSA) MIB (CISCO-COMPRESSION-SERVICE-ADAPTER-MIB.my). For information on accessing Cisco MIB files, refer to the Cisco MIB User Quick Reference.
This feature supports the following RFCs:
•
•
•
Functional Description
The data compression AIM is a daughter-card assembly which attaches directly to the Cisco 2600 motherboard leaving the single network module slot available for other purposes. The data compression AIM supports only serial interfaces using PPP encapsulation with STAC or MPPC compression, or Frame Relay encapsulation with STAC compression. No routing, bridging, or switching performance is impacted by this feature. The data compression AIM module contains a high-performance data compression coprocessor which implements the LZS and MPPC data compression algorithms. The module provides compression support for up to 2 E1 lines. The module contains a PCI Target/Initiator system bus interface for access into Host system memory with minimal Host processor intervention.
Configuration Tasks
To configure the data compression AIM daughter-card assembly, follow the steps provided in the "data compression AIM Configuration Note" P/N: 78-5531-xx, as follows:
•
•
Configuring PPP Compression
Configure your Cisco 2600 access server to use PPP compression. Specify the following information for each serial interface: encapsulation type, compression algorithm, designate the CAIM daughtercard as the source of this algorithm, and the port. Begin in global configuration mode.
Configure
To configure the PPP form of compression, use the following commands, beginning in global configuration mode:
1
Enter global configuration mode.
2
Enter interface configuration mode to configure serial interface 0 on port 0. If you have installed more than one WAN Interface Card (WIC), you have interfaces 0 and 1. Each WIC has a pair of ports, 0 and 1.
3
Enter the encapsulation type which is ppp.1
4
element-numberEnter the compress command to use one of the algorithms (mppc, predictor, or stac) on the caim card for port 0.2
5
Enter the no form of fair-queue to ensure correct compression.
6
Enter the no form of the shutdown command to bring up this interface.
7
Router(config-if)# ^ZEnter ^Z to return you to EXEC mode.
1 You also have the option of configuring encapsulation for frame-relay, which is the next example.
2 You could also have configured compression for another serial port or another CAIM card, depending upon your configuration.
Verify
•
Router# show interface serial 0/0Serial0/0 is up, line protocol is upHardware is PowerQUICC SerialInternet address is 1.1.1.2/24MTU 1500 bytes, BW 2000 Kbit, DLY 20000 usec,reliablility 255/255, txload 3/255, rxload 50/255Encapsulation PPP, loopback not set, keepalive not setLCP OpenOpen: IPCP, CCPLast input 00:00:04, output 00:00:00, output hang neverLast clearing of "show interface" counters 1w1dQueueing strategy: fifoOutput queue 0/40, 80 drops; input queue 0/75, 0 drops30 second input rate 397000 bits/sec, 40 packets/sec30 second output rate 30000 bits/sec, 40 packets/sec27859655 packets input, 4176659739 bytes, 0 no bufferReceived 175145 broadcasts, 0 runts, 0 giants, 0 throttles0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort55309592 packets output, 1044865717 bytes, 0 underruns0 output errors, 0 collisions, 12 interface resets0 output buffer failures, 0 output buffers swapped out36 carrier transitionsDCD=up DSR=up DTR=up RTS=up CTS=up•
Focus on locating compression bytes send and compression bytes recvd:
Router# show compressSerial0/0Hardware compression enabledCSA in slot 0 in useCompressed bytes sent: 317862131 bytes 61 Kbits/sec ratio: 12.870Compressed bytes recv: 221975672 bytes 43 Kbits/sec ratio: 9.194restarts: 1last clearing of counters: 41252 seconds
Tips
•
•
•
Configuring Frame-relay Map Compression
Configure frame-relay to map compression on this Data-Link Connection Identifier (DLCI) to use the specified AIM hardware compression on the Cisco 2600 access server. You must specify the following information for each serial interface: protocol, protocol-address, DLCI, encapsulation type, the frf.9 stac compression algorithm, designate the CAIM daughtercard as a source of this algorithm, and the CAIM element number.
Configure
To configure the frame-relay map compression command for operation, use the following commands beginning in global configuration mode:
1
Enter global configuration mode.
2
Router(config)# interface serial slot/portEnter interface configuration mode to configure serial interface. If you have installed more than one WAN Interface Card (WIC), you have interfaces 0 and 1. Each WIC has a pair of ports, 0 and 1.
3
Enter the encapsulation type which is frame-relay.1
4
broadcast payload-compression frf9 stac
caim element-numberEnter the compress stac command that will use the stac algorithm on the CAIM card for port 0.2
5
Enter the no form of the shutdown command bring up this interface.
6
Router(config-if)# ^ZEnter ^Z to return you to EXEC mode.
1 You also have the option of configuring PPP.
2 You could also have configured compression for another serial port or another CAIM card, depending upon your configuration.
Note
Verify
•
Focus on the serial interface which has Encapsulation FRAME-RELAY, serial 0/1, output queue and input queue.
Router# Show interface serial 0/1Serial0/1 is up, line protocol is upHardware is PowerQUICC SerialInternet address is 1.1.1.2/24MTU 1500 bytes, BW 2000 Kbit, DLY 20000 usec,reliablility 255/255, txload 1/255, rxload 1/255Encapsulation FRAME-RELAY, loopback not set, keepalive not setFR SVC disabled, LAPF state downBroadcast queue 0/64, broadcasts sent/dropped 2743/0, interface broadcasts 2742Last input 03:05:57, output 00:00:03, output hang neverLast clearing of "show interface" counters 1w1dQueueing strategy: fifoOutput queue 0/40, 80 drops; input queue 0/75, 0 drops30 second input rate 0 bits/sec, 0 packets/sec30 second output rate 0 bits/sec, 0 packets/sec30800054 packets input, 3488155802 bytes, 0 no bufferReceived 199567 broadcasts, 0 runts, 0 giants, 0 throttles2 input errors, 0 CRC, 2 frame, 0 overrun, 0 ignored, 0 abort58246738 packets output, 1325052697 bytes, 0 underruns0 output errors, 0 collisions, 15 interface resets0 output buffer failures, 0 output buffers swapped out36 carrier transitionsDCD=up DSR=up DTR=up RTS=up CTS=up•
Focus on locating Using Compression AIM 0:
Router# show controller serial1/0CD2430 Slot 1, Port 0, Controller 0, Channel 0, Revision 14Channel mode is synchronous serialidb 0x811082E8, buffer size 1524, X.21 DTE cableGlobal registersrpilr 0x2, rir 0x0, risr 0x0, rfoc 0x0, rdr 0x30tpilr 0x1, tir 0x0, tisr 0x60, tftc 0x0, tdr 0x41mpilr 0x3, mir 0x2, misr 0x60bercnt 0xFF, stk 0x0Per-channel registers for channel 0Option registers0x02 0x00 0x42 0xE7 0xE0 0x00 0x00Command and status registerscmr 0xC0, ccr 0x00, csr 0xAC, msvr-rts 0xF1, msvr-dtr 0xF1Clock option registersrcor 0x06, rbpr 0x01, tcor 0xC8, tbpr 0x01Interrupt registersier 0x89, livr 0x00, licr 0x00DMA buffer status 0x27DMA receive registersarbaddr 0x2549D44, arbcnt 1548, arbsts 0x1brbaddr 0x2548344, brbcnt 1548, brbsts 0x1rcbaddr 0x2549D94DMA transmit registersatbaddr 0x257F93E, atbcnt 104, atbsts 0x43btbaddr 0x25B25C2, btbcnt 1490, btbsts 0x43tcbaddr 0x25B25D2Special character registersschr1 0x00, schr2 0x00, schr3 0x00, schr4 0x00scrl 0x0, scrh 0x0, lnxt 0xF1Driver context informationContext structure 0x8110D830, Register table 0x40800400Serial Interface Control 5:1 Register (0x40800802) is 0x0Adaptor Flags 0x0Serial Modem Control Register (0x40800804) is 0x18Receive static buffer 0x810E1274Receive particle buffers 0x8110DE00, 0x8110DDC0Transmit DMA buffers 0x8113E240, 0x810F2808, 0x810D4C00, 0x810EA0DCTransmit packet with particles 0x0, first word is 0x0Interrupt rates (per second) transmit 25, receive 139, modem 0True fast-switched packets 41Semi fast-switched packets 13449573Transmitter hang count 0Residual indication count 0Bus error count 0Aborted short frames count 0CRC short frames count 0Error countersCTS deassertion failures 0Nested interrupt errors transmit 0, receive 0, modem 0Using Compression AIM 0CompressionAim0ds:0x8113FC04 idb:0x8113A6CC5005867 uncomp paks in --> 5005867 comp paks out38397501 comp paks in --> 38397502 uncomp paks out2882277146 uncomp bytes in--> 497476655 comp bytes out3500965085 comp bytes in --> 1211331227 uncomp bytes out72 uncomp paks/sec in--> 72 comp paks/sec out557 comp paks/sec in --> 557 uncomp paks/sec out334959 uncomp bits/sec in--> 57812 comp bits/sec out406855 comp bits/sec in --> 140827 uncomp bits/sec out68841 seconds since last clearholdq:0 hw_enable:1 src_limited:0 num cnxts:8no data:0 drops:0 nobuffers:0 enc adj errs:0 fallbacks:5322165no Replace:0 num seq errs:0 num desc errs:0 cmds complete:43403738Bad reqs:0 Dead cnxts:0 No Paks:0 enq errs:0rx pkt drops:0 tx pkt drops:0 dequeues:0 requeues:0drops disabled:0 clears:0 ints:41973007 purges:203200no cnxts:0 bad algos:0 no crams:0 bad paks:0# opens:0 # closes:4 # hangs:0# 9711 fatal:0 # poison pkts:0 cmd/res ovruns:0# dma fatal:0Jupiter DMA Controller Registers:(0x40200000Cmd Ring:0x025BAE60 Src Ring:0x025BBB60Res Ring:0x025BB4E8 Dst Ring:0x025BBDA8Status/Cntl:present:0x8080989C last int:0x9898989CInten:0x30302021 config:0x00080003Num DMA ints:41973355Hifn9711 Data Compression Coprocessor Registers (0x40201000):Config:0x000051D4 Inten:0x00000E00Status:0x00004000 FIFO status:0x00004000FIFO config:0x00000101
Tips
•
•
•
Configuring Frame-relay payload-compression
Configure frame-relay frf.9 stac payload-compression on a specified port for the Cisco 2600 access server. You must specify the following information for each serial interface: payload-compression, encapsulation type, compression algorithm, designate the CAIM daughtercard as a source of this algorithm, and the specific port.
Configure
To configure the frame-relay to map for compression, use the following commands beginning in global configuration mode:
1
Enter global configuration mode.
2
Router(config)# interface serial slot/portEnter the interface configuration mode to configure serial interface 0 on port 0.
3
Enter the encapsulation type which is ppp.1
4
element-numberEnter the compress stac command that will use the stac algorithm on the CAIM card for port 0.2
5
Enter the no form of the shutdown command bring up this interface.
6
Router(config-if)# ^ZEnter ^Z to return you to EXEC mode.
1 You also have the option of configuring
2 You could also have configured compression for another serial port or another CAIM card, depending upon your configuration.
Verify
•
Focus on the serial interface which has Encapsulation frame-relay, serial 0/0, output queue and input queue.
Router# Show interface serial 0/0Serial0/0 is up, line protocol is upHardware is PowerQUICC SerialInternet address is 1.1.1.2/24MTU 1500 bytes, BW 2000 Kbit, DLY 20000 usec,reliablility 255/255, txload 1/255, rxload 1/255Encapsulation FRAME-RELAY, loopback not set, keepalive not setFR SVC disabled, LAPF state downBroadcast queue 0/64, broadcasts sent/dropped 2743/0, interface broadcasts 2742Last input 03:05:57, output 00:00:03, output hang neverLast clearing of "show interface" counters 1w1dQueueing strategy: fifoOutput queue 0/40, 80 drops; input queue 0/75, 0 drops30 second input rate 0 bits/sec, 0 packets/sec30 second output rate 0 bits/sec, 0 packets/sec30800054 packets input, 3488155802 bytes, 0 no bufferReceived 199567 broadcasts, 0 runts, 0 giants, 0 throttles2 input errors, 0 CRC, 2 frame, 0 overrun, 0 ignored, 0 abort58246738 packets output, 1325052697 bytes, 0 underruns0 output errors, 0 collisions, 15 interface resets0 output buffer failures, 0 output buffers swapped out36 carrier transitionsDCD=up DSR=up DTR=up RTS=up CTS=upWarning
Tips
•
•
Configuring Diagnostics
Configure the AIM daughtercard to provide compression for the Cisco 2600 series router. You must specify the following information for each daughtercard installed.
Configure
To configure the ppp for compression, use the following commands beginning in global configuration mode:
Verify
•
Router# Show pas caim stats 0 CompressionAim0ds:0x80F56A44 idb:0x80F50DB8422074 uncomp paks in --> 422076 comp paks out422071 comp paks in --> 422075 uncomp paks out633912308 uncomp bytes in--> 22791798 comp bytes out27433911 comp bytes in --> 633911762 uncomp bytes out974 uncomp paks/sec in--> 974 comp paks/sec out974 comp paks/sec in --> 974 uncomp paks/sec out11739116 uncomp bits/sec in--> 422070 comp bits/sec out508035 comp bits/sec in --> 11739106 uncomp bits/sec out433 seconds since last clearholdq: 0 hw_enable: 1 src_limited: 0 num cnxts: 4no data: 0 drops: 0 nobuffers: 0 enc adj errs: 0 fallbacks: 0no Replace: 0 num seq errs: 0 num desc errs: 0 cmds complete: 844151Bad reqs: 0 Dead cnxts: 0 No Paks: 0 enq errs: 0rx pkt drops: 0 tx pkt drops: 0 dequeues: 0 requeues: 0drops disabled: 0 clears: 0 ints: 844314 purges: 0no cnxts: 0 bad algos: 0 no crams: 0 bad paks: 0# opens: 0 # closes: 0 # hangs: 0•
Router# show compressSerial0/0Hardware compression enabledCSA in slot 0 in useCompressed bytes sent: 317862131 bytes 61 Kbits/sec ratio: 12.870Compressed bytes recv: 221975672 bytes 43 Kbits/sec ratio: 9.194restarts: 1last clearing of counters: 41252 secondsSerial0/1Hardware compression enabledCSA in slot 0 in useCompressed bytes sent: 249720 bytes 0 Kbits/sec ratio: 5.923Compressed bytes recv: 465843659 bytes 43 Kbits/sec ratio: 9.128restarts: 1last clearing of counters: 85525 seconds•
Serial0/0Hardware compression enabledCSA in slot 0 in useCompressed bytes sent: 0 bytes 61 Kbits/sec ratio: 0Compressed bytes recv: 0 bytes 43 Kbits/sec ratio: 0restarts: 0last clearing of counters: 0 seconds
Tips
•
•
Configuration Example
Configuring your Cisco 2600 series router for compression over serial interfaces involves specifying many steps, regardless of your choice of compression algorithm, whether the compression you specify is software or hardware based, or whether you are configuring for just one port or to interface with a network protocol address associated with a Data-Link Connection Identifier (DLCI). The choices of functionality allow you to configure for frame-relay over a wide area network using a wide area network interface card (WIC) in your Cisco 2600 series router or for point-to-point protocol (even the Microsoft PPC compression algorithm for Microsoft NT networks) including the Stacker (LZS) compression algorithm that can be used on LAPB, HDLC, and PPP encapsulations. An entire configuration for ppp includes the following steps:
•
Router# show run----cut----!version 12.0service timestamps debug uptimeservice timestamps log uptime!----cut----!interface Serial0/1ip address 1.1.1.1 255.255.255.0no ip directed-broadcastencapsulation pppno ip mroute-cacheload-interval 30no keepaliveno fair-queueclockrate 2000000compress stacno cdp enable!----cut----Use a show compress command to display information about compression
Router# show compressSerial0/0Hardware compression enabledCSA in slot 0 in useCompressed bytes sent: 317862131 bytes 61 Kbits/sec ratio: 12.870Compressed bytes recv: 221975672 bytes 43 Kbits/sec ratio: 9.194restarts: 1last clearing of counters: 41252 seconds----cut----Use the show pas caim stats command to display statistics of traffic as it is handled by the CAIM hardware algorithm:
Router# show pas caim stats 0CompressionAim0ds:0x81110644 idb:0x8110B19034734673 uncomp paks in --> 34734673 comp paks out34733339 comp paks in --> 34733339 uncomp paks out4075117517 uncomp bytes in--> 3117657645 comp bytes out168220657 comp bytes in --> 4073901654 uncomp bytes out80 uncomp paks/sec in--> 80 comp paks/sec out80 comp paks/sec in --> 80 uncomp paks/sec out75509 uncomp bits/sec in--> 57768 comp bits/sec out3117 comp bits/sec in --> 75487 uncomp bits/sec out431744 seconds since last clearholdq: 0 hw_enable: 1 src_limited: 0 num cnxts: 4no data: 0 drops: 0 nobuffers: 0 enc adj errs: 0 fallbacks: 0no Replace: 0 num seq errs: 0 num desc errs: 0 cmds complete: 69468106Bad reqs: 0 Dead cnxts: 0 No Paks: 0 enq errs: 0rx pkt drops: 0 tx pkt drops: 0 dequeues: 0 requeues: 0drops disabled: 0 clears: 0 ints: 70566468 purges: 4no cnxts: 0 bad algos: 0 no crams: 0 bad paks: 0# opens: 4 # closes: 4 # hangs: 0# 9711 fatal: 0 # poison pkts: 0 cmd/res ovruns: 0# dma fatal: 0----cut----Command Reference
This section defines new and modified Cisco IOS commands that support the data compression AIM daughter-board when it is installed in the Cisco 2600 series router. These commands configure and debug CAIM operation. Some commands support PPP STAC configuration, while others support frame-relay on a per port basis. A few additional commands (where noted) already exist in the Cisco IOS command reference, but are modified to display CAIM related information, or to include configuration characteristics unique to the CAIM. Such commands have similar syntax to commands already described in the Cisco IOS command reference, and are only referenced as useful for CAIM operation. All other commands used with the CAIM feature are documented by the Cisco IOS Release 12.0 command references.
•
•
•
•
•
•
•
•
•
clear aim
To clear data compression AIM daughter-board registers and reset the hardware, enter the clear aim interface configuration command.
clear aim element-number
Syntax Description
Default
Disabled
Command Mode
Interface configuration mode
Usage Guidelines
This command first appeared in Cisco I OS Release 12.0(1)T.
The clear aim command is used to reset the data compression AIM hardware. This command is used if the CAIM hardware becomes "stuck" or hangs for some reason. The CAIM registers are cleared, and the hardware is reset upon execution. All compression history is lost when the CAM is reset.
Example
The following example shows how to use the interface configuration mode clear aim command. This command will reset the hardware, flushing the buffers and history for all compression tasks currently under operation:
Router# clear aim 0Router#1w0d: %CAIM-6-SHUTDOWN: CompressionAim0 shutting down1w0d: %CAIM-6-STARTUP: CompressionAim0 starting upRelated Commands
debug compress
show controller
show pci aim
test aim eepromcompress mppc
To configure compression using the mppc compression algorithm on your data compression Advanced Interface Module (AIM) for the Cisco 2600 series router, enter the compress mppc interface configuration mode command. The Microsoft PPC compression algorithm (mppc) is used to exchange compressed information with a Microsoft NT remote access server.
compress mppc
no compressSyntax Description
mppc
The Microsoft PPC compression algorithm (mppc) is used to exchange compressed information with a Microsoft NT remote access server.
Default
Disabled.
Command Mode
Interface configuration mode.
Usage Guidelines
This command first appeared in Cisco IOS Release 12.0(1)T.
When configuring point-to-point protocol (PPP) on a serial interface, you can use hardware compression on the data compression AIM daughtercard for mppc is one is installed, otherwise you can use software compression.
Example
The following example shows how to configure the data compression AIM daughtercard for mppc:
Router(config-if)# encapsulate pppRouter(config-if)# compress mppcRelated Commands
compress stac caim
clear aim
debug compress
encapsulation ppp
show pas caim stats
show compress
show processescompress stac caim
To specify the exact hardware compression resource preferred, enter the compress stac caim interface configuration mode command.
compress stac caim element-number
no compress stac element-numberSyntax Description
Default
Disabled
Command Mode
Interface configuration mode
Usage Guidelines
This command first appeared in Cisco IOS Release 12.0(1)T.
Specifying the compress stac command with no options causes the router to use the fastest available compression method:
•
•
Using hardware compression in the AIM frees the router's main processor for other tasks. You can also configure the router to use the Compression Port Module to perform compression by using the distributed option, or to use the router's main processor by using the software option. If the Compression Port Module is compression is performed in the router's main processor.
When compression is performed in software installed in the router's main memory, it might significantly affect system performance. It is recommended that you disable compression in the router's main processor if the router CPU load exceeds 40 percent. To display the CPU load, use the show process cpu EXEC command.
Specifying the compress stac command with no options causes the router to use the fastest available compression method.
Example
The following example specifies that hardware compression should be activated for CAIM element 0:
Router(config-if)# encapsulation ppp Router(config-if)# compress stac caim 0Router(config)# ^ZRouter# show compressinterface serial 3/1encapsulate pppcompress stac----cut----Related Commands
encapsulation ppp
compress stac came
clear aim
debug compress
show pas caim stats
show compress
show processesframe-relay map payload-compression frf9 stac caim
To enable frame-relay compression on a DLC basis, enter the frame-relay interface configuration command. Enter the no form of this command to deactivate frame-relay compression.
frame-relay map {protocol protocol-address dlci} payload-compression frf9 stac caim element-number
no frame-relay mapSyntax Description
Default
Disabled
Command Mode
Interface configuration mode
Usage Guidelines
This command first appeared in Cisco IOS Release 12.0(2)T.
Many DLCIs known by an access server can be used to send data to many different places, but they are all multiplexed over one physical link. The Frame Relay map tells the Cisco IOS software how to get from a specific protocol and address pair to the correct DLCI.
Note
Use the frame-relay map command to enable or disable payload compression on multipoint interfaces. Use the frame-relay payload-compress packet-by-packet command to enable or disable payload compression on point-to-point interfaces.
The broadcast keyword provides two functions: It forwards broadcasts when multicasting is not enabled, and it simplifies the configuration of OSPF for nonbroadcast networks that will use Frame Relay.
The broadcast keyword might also be required for some routing protocols--for example, AppleTalk--that depend on regular routing table updates, especially when the router at the remote site is waiting for a routing update packet to arrive before adding the route. Network broadcasts are necessary if you intend to use routing protocols such as RIP or OSPF running across the frame relay link.
The payload-compression FRF9 stac caim 0 enables compression on the frame relay link, but requires the caim 0 portion of the command.
Warning
Example
The following example shows configuration of frame-relay map payload-compression using the data compression AIM daughtercard for compression mapping the destination address 1.1.1.2 to DLCI 16:
Router(config-if)# frame-relay map ip 1.1.1.2 16 broadcast payload-compression frf9 stac caim 0Related Commands
debug compress
encapsulation frame-relay
compress frame-relay
frame-relay payload-compress packet-by-packet
frame-relay interface-dlciframe-relay payload-compression frf9 stac
To configure frame-relay payload-compression for each frame-relay port, enter the frame-relay payload-compression interface configuration command. Enter the no form of this command to terminate this form of payload-compression over frame relay.
frame-relay payload-compression frf9 stac caim element-number
no frame-relay payload-compressionSyntax Description
Default
Disabled
Command Mode
Interface configuration mode
Usage Guidelines
The frame-relay payload-compress command first appeared in Cisco IOS Release 11.0. The packet-by-packet keyword first appeared in Cisco IOS Release 11.2. The frf9 stac keyword first appeared in Cisco IOS Release 11.3. The frame-relay payload-compression frf9 stac caim command first appeared in Cisco IOS Release 12.0(2)T.
Use the frame-relay payload-compress command to enable or disable payload compression on a point-to-point interface or subinterface. Use the frame-relay map command to enable or disable payload compression on a multipoint interface or subinterface.
Note
Example
The following example shows configuration of frame-relay payload-compression using the data compression AIM daughtercard for compression:
Router(config-if)# frame-relay payload-compression frf9 stac caim 0Using this command, frame relay has been configured to use payload-compression with the frf9 stac algorithm for CAIM hardware compression using the installed data compression Advanced Interface Module (AIM) as the source.
Related Commands
debug compress
encapsulation frame-relay
compress frame-relay
show compress
frame-relay interface-dlcishow pci aim
To show the IDPROM contents for each AIM board in the Cisco 2600, enter the show pic aim global configuration command.
show pci aim
Syntax Description
There are no optional or required keywords or variables for this command.
Default
Disabled
Command Mode
Global configuration mode
Usage Guidelines
This command first appeared in Cisco IOS Release 12.0(1)T.
This command shows the IDPROM contents for each AIM board present in the system, by AIM slot number (currently 0, since that is the only daughter board installed for version 12.0(1)T). The IDPROM is a small PROM built into the AIM board used to identify it to the system. It is sometimes referred to as an EEPROM because it is implemented using electrically erasable PROM.
Example
The following example shows the IDPROM output for the installed AIM daughtercard:
Router# show pic aim 0AIM Slot 0: ID 0x012DHardware Revision : 1.0EEPROM format version 4EEPROM contents (hex):0x00: 04 FF 40 01 2D 41 01 00 FF FF FF FF FF FF FF FF0x10: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF0x20: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF0x30: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF0x40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FFRelated Commands
test aim eeprom
clear aimshow pas caim
To show debug information about data compression Advanced Interface Module (AIM) daughter-card, enter the show pas caim global configuration command.
show pas caim {rings | dma | coprocessor | stats | cnxt_table | page_table} element-number
Syntax Description
Default
Disabled
Command Mode
Global configuration mode
Usage Guidelines
This command first appeared in Cisco IOS Release 12.0(2)T.
This command displays performance statistics describing the operation of the CAIM. This command is primarily intended for engineering debug, but it can also be useful to Cisco support personnel and to Cisco customers in troubleshooting network problems. The output of this command consists of a number of fields as follows:
The show pas caim rings element-number form of this command displays the current state of the DMA ring buffers maintained by the CAIM software. These rings feed the CAIM with data and commands. It is intended for Engineering debug of the compression AIM. It produces the following output:
CAIM Command Ring: 0x01A2BC00 Stack: 0x01A2BE40 Shadow: 0x80F88BACHead: 0021 Tail: 0021 Count: 0000CAIM Source Ring: 0x01A2C900 Shadow: 0x80F88BACHead: 0021 Tail: 0021 Num: 0000CAIM Results Ring: 0x01A2C280 Stack: 0x01A2C4C0Head=021 Tail=021CAIM Dest Ring: 0x01A2CB40 Shadow: 0x80F892D8 Head=021 Tail=000Desc: 0x01A2CBE8 flags: 0x8000060C dptr: 0x019E7EB8 part: 0x80F84BE0Desc: 0x01A2CBF0 flags: 0x8000060C dptr: 0x019FC63C part: 0x80F85240----cut----The CAIM Command Ring feeds commands to the CAIM. The Address of the command ring is displayed first. The Stack is a ring which feeds additional commands to the CAIM, and its address is displayed next. The Shadow is a software ring which stores additional information about each command. The Head field is an index into the Source Ring, specifying where the next entry will be extracted from. The Tail field is an index into the Source Ring which specifies where the next entry will be inserted. Refer to the Jupiter DMA specification and the Hifn 9711 Data Sheet for more information.
The CAIM Source Ring feeds information about input data to the CAIM. The address of the Source Ring is displayed first. The Source Ring Shadow is a ring which contains additional information about each source buffer. The Head field specifies where the next entry will be extracted, and the Tail field specifies where the next entry will be inserted. Refer to the Jupiter DMA specification and the Hifn 9711 Data Sheet for more information.
The CAIM Results Ring receives information about each CAIM command as it is completed. The address of the ring is displayed first. The Stack is a ring which receives additional information about each completed command, and its address is next displayed. The Head field specifies where the next entry will be extracted, and the Tail field specifies where the next entry will be inserted. Refer to the Jupiter DMA specification and the Hifn 9711 Data Sheet for more information.
The CAIM Dest Ring holds information about the buffers available to the CAIM for output data. The address of the Dest Ring is displayed first. The Dest Shadow is a ring which holds additional information about each output buffer. The Head field specifies where the next entry will be extracted, and the Tail field specifies where the next entry will be inserted. Refer to the Jupiter DMA specification and the hifn 9711 Data Sheet for more information.
There now follows a line of information about each output data buffer. The desc field is the address of a so-called descriptor, used by the Jupiter DMA engine. The flags field contains flags describing attributes of the buffer. The dptr field displays the actual address of the output buffer. The part field displays the address of the corresponding particletype structure, a software defined structure which describes a buffer when its a component of a network data buffer. Refer to the Jupiter DMA specification and the hifn 9711 Data Sheet for more information.
The show pas caim dma element-number form of this command displays the registers of the Jupiter DMA Controller. These registers control the operation of the Jupiter DMA Controller. This command is intended for Engineering debug of the CAIM. Detailed descriptions of the various fields may be found in the Jupiter DMA Controller specification. The output of this command consists of:
Jupiter DMA Controller Registers: (0x40200000Cmd Ring: 0x01A2BCA8 Src Ring: 0x01A2C9A8Res Ring: 0x01A2C328 Dst Ring: 0x01A2CBE8Status/Cntl: present: 0x80808084 last int: 0x80808084Inten: 0x10100000 config: 0x00100003Num DMA ints: 143330469The show pas caim compressor element-number form of this command displays the registers of the Hifn 9711 compression coprocessor. These registers control the operation of the Hifn 9711 part. This command is intended for Engineering debug of the CAIM. Detailed descriptions of the various fields may be found in the Hifn 9711 data book. The output of this command consists of:
Hifn9711 Data Compression Coprocessor Registers (0x40201000):Config: 0x000051D4 Inten: 0x00000E00Status: 0x00004000 FIFO status: 0x00004000FIFO config: 0x00000101The address of the registers in the address space of the processor is displayed first. The Config field displays the current contents of the 9711 configuration register. The Inten field displays the contents of the 9711 interrupt enable register. The Status field displays the contents of the 9711 status register. The FIFO status field displays the contents of the 9711 FIFO Status register.
The show pas caim cnxt_table element-number form of this command displays the context table for the specified CAIM element. The context is a table of information concerning each compression context. The display has the following appearance:
CAIM0 Context TableContext: 0x8104F320 Type: Compr Algo: StacHdrlen: 0006 History: 0x0000Callback: 0x8011D68C Shutdown: x8011EBE4 Purge: NComp_db: 0x81034BC0 idb: 0x81038084 ds: 0x8104E514Context: 0x8104F340 Type: Decomp Algo: StacHdrlen: 0002 History: 0x0000Callback: 0x8011E700 Shutdown: x8011EBE4 Purge: NComp_db: 0x81034BC0 idb: 0x81038084 ds: 0x8104E514The Context field is a numeric internal reference for the compression context. The Type field gives the type of context, either "Compr" for a compression context or "Decomp" for a decompression context. The Algo field gives the compression algorithm used, either "Stac" or "Mppc". The Hdrlen field gives the number of bytes in the compression header for each compressed packet. The History field gives the 16 Kbyte page number in compression RAM for the context. The Callback, Shutdown, Comp_db, idb, and ds fields give internal numeric references for various control structures and procedures to facilitate debugging. The Purge field indicates whether the compression context has been flagged to have its history purged.
The show pas caim page_table element-number form of this command displays the page table for the selected CAIM element. The page table is a table of entries describing each page in compression RAM. The display appears as follows:
CAIM0 Page TablePage 0x0000 Comp cnxt: 8104F320 Decmp cnxt: 8104F340 Algo: StacThe Page field is the 16 Kbyte page number of the page. The Comp cnxt and Decmp cnxt fields contain internal numeric references to the context structures using this page. The Algo field gives the compression algorithm used, either "Stac" or "Mppc".
Example
The following example shows stats of an active data compression AIM session:
Router# show pas caim stats 0CompressionAim0ds:0x80F56A44 idb:0x80F50DB8422074 uncomp paks in --> 422076 comp paks out422071 comp paks in --> 422075 uncomp paks out633912308 uncomp bytes in--> 22791798 comp bytes out27433911 comp bytes in --> 633911762 uncomp bytes out974 uncomp paks/sec in--> 974 comp paks/sec out974 comp paks/sec in --> 974 uncomp paks/sec out11739116 uncomp bits/sec in--> 422070 comp bits/sec out508035 comp bits/sec in --> 11739106 uncomp bits/sec out433 seconds since last clearholdq: 0 hw_enable: 1 src_limited: 0 num cnxts: 4no data: 0 drops: 0 nobuffers: 0 enc adj errs: 0 fallbacks: 0no Replace: 0 num seq errs: 0 num desc errs: 0 cmds complete: 844151Bad reqs: 0 Dead cnxts: 0 No Paks: 0 enq errs: 0rx pkt drops: 0 tx pkt drops: 0 dequeues: 0 requeues: 0drops disabled: 0 clears: 0 ints: 844314 purges: 0no cnxts: 0 bad algos: 0 no crams: 0 bad paks: 0# opens: 0 # closes: 0 # hangs: 0Related Commands
show compress
debug compresstest aim eeprom
To test the data compression Advanced Interface Module (AIM) after it is installed in your Cisco 2600, enter the test aim eeprom global configuration command. Using this command can erase all locations in EEPROM memory.
test aim eeprom
Syntax Description
There are no optional or required keywords or variables for this command.
Default
Disabled
Command Mode
Global configuration mode
Usage Guidelines
This command first appeared in Cisco IOS Release 12.0(2)T.
This command is the AIM counterpart of the "test pas eeprom" command which performs similar tasks for port modules. The following lines are displayed:
Note
At any time you can use these commands:
During your session with the test dialog, you have access to the following commands:
H or h - Help - A summary of the available commands is displayed.
d - dump eeprom contents
e - erase all locations
p - primitive access
q - exit eeprom test
z - zero eeprom
`c' rules of radix type-in and display applyExample
The following example displays the test aim eeprom command's user dialog
Router# test aim eepromAIM Slot [0]: 0Use NMC93C46 ID EEPROM [y]: yAIM Slot 0 eeprom (? for help)[?]: ?d - dump eeprom contentse - erase all locations (to 1)p - primitive accessq - exit eeprom testz - zero eeprom'c' rules of radix type-in and display apply.AIM Slot 0 eeprom (? for help)[?]:Debug Commands
The following modified debug commands are provided for the data compression AIM:
debug compress
To debug compression, enter the debug compress global configuration command. To disable debugging output, use the no form of this command.
[no] debug compress
Syntax Description
There are no optional or required keywords or variables for this command.
Default
Disabled.
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
Use this command to display output from the compression and decompression configuration you made. Live traffic must be configured through the Cisco 2600 with a data compression Advanced Interface Module (AIM) installed for this command to work.
Sample Display
The following example is output from the debug compress command, which shows that compression is taking place on a Cisco 2600 Access Router using data compression Advanced Interface Module (AIM) hardware compression is configured correctly.
For a description of the debug output, see .
Router# debug compressCOMPRESS debugging is onRouter#compr-in:pak:0x810C6B10 npart:0 size:103pak:0x810C6B10 start:0x02406BD4 size:103 npart:0compr-out:pak:0x8118C8B8 stat:0x00000000 npart:1 size:71 lcb:0xEDpak:0x8118C8B8 start:0x0259CD3E size:71 npart:1mp:0x8118A980 start:0x0259CD3E size:71decmp-in:pak:0x81128B78 start:0x0255AF44 size:42 npart:1 hdr:0xC035pak:0x81128B78 start:0x0255AF44 size:42 npart:1mp:0x81174480 start:0x0255AF44 size:42decmp-out:pak:0x8118C8B8 start:0x025B2C42 size:55 npart:1 stat:0pak:0x8118C8B8 start:0x025B2C42 size:55 npart:1mp:0x8118B700 start:0x025B2C42 size:55
Related Commands
debug frame-relay
debug ppp
show compress
show diagWhat to Do Next
For additional software configuration information, see the following publications:
•
•
•
•
•
•
•
http://www.cisco.com/univercd/cc/td/doc/product/software/ios120/12cgcr/inter_r/index.htm•
http://www.cisco.com/univercd/cc/td/doc/product/access/acs_mod/cis2600/index.htm•
•
•
•
•
•
•
•
•
•
•
ROMMON Command http://www.cisco.com/warp/public/471/76.html•
xmodem ROMMON Command http://www.cisco.com/warp/public/471/77.html
Note
Guest
