|
|
This chapter describes the ATM accounting and Remote Monitoring (RMON) features used with the LightStream 1010 ATM switch, and includes the following sections:
The following sections describe the process used to enable and configure the ATM accounting feature in the LightStream 1010 ATM switch:
The ATM accounting feature provides accounting and billing services for virtual circuits (VCs) used on the LightStream 1010 ATM switch. You enable ATM accounting on an edge switch to monitor call setup and traffic activity. A specific interface can be configured to monitor either incoming or outgoing or incoming and outgoing VC use. Figure 15-1 shows a typical ATM accounting environment.

Switching speeds and number of VCs supported by the LightStream 1010 ATM switch while monitoring virtual circuit use for accounting purposes can cause the amount of data to be gathered to reach the megabyte range. With such a large amount of data in the ATM accounting files, using traditional Simple Network Management Protocol (SNMP) methods of data retrieval is not feasible. You can store the collected accounting information in a file which you can retrieve via a file transfer protocol. SNMP provides management control of the selection and collection of accounting data. Figure 15-2 shows an interface, filtering, and file configuration example.

A file used for data collection actually corresponds to two memory buffers on the ASP. One buffer is actively saving data, while the second is passive and ready to have its data either retrieved using Trivial File Transport Protocol (TFTP) or overwritten when the currently active file reaches its maximum capacity. Using TFTP to download the file is the same process used to download Cisco IOS images and configuration files from the switch Flash memory to a host.
The ATM accounting feature must be enabled to start gathering ATM accounting virtual circuit call setup and use data. The ATM accounting feature runs in the background and captures configured accounting data for VC changes such as calling party, called party, or start time and connection type information for specific interfaces to a file.
![]() | Caution Enabling ATM accounting could slow the basic operation of the LightStream 1010 ATM switch. |
To enable the ATM accounting feature, use the following command in global configuration mode:
| Command | Task |
|---|---|
Enable ATM accounting for the switch. |
To display the ATM accounting status, use the following privileged EXEC command:
| Command | Task |
|---|---|
Display the ATM accounting status. |
After you enable ATM accounting, you must configure specific ingress or egress interfaces, usually on edge switches connected to the external network, to start gathering the ATM accounting data.
To enable ATM accounting on a specific interface, perform the following tasks, beginning in global configuration mode:
| Step | Command | Task |
|---|---|---|
| 1 | interface atm card/subcard/port | Select the interface to be configured. |
| 2 | atm accounting | Enable ATM accounting on the selected interface. |
The following example shows how to enable ATM accounting on ATM interface 1/0/3:
Switch(config)# interface atm 1/0/3 Switch(config-if)# atm accounting
To display the ATM accounting status, use the following privileged EXEC command:
| Command | Task |
|---|---|
show running-config | Display the ATM accounting status. |
The following display from the show running-config privileged EXEC command shows that ATM accounting is enabled on ATM interface 1/0/3:
Switch# show running-config Building configuration... Current configuration: ! <Information Deleted> ! interface ATM1/0/3 no keepalive atm accounting ! --More-- ! <information deleted>
The ATM accounting selection table determines the connection data to be gathered from the switch. To configure the ATM accounting selection entries, perform the following tasks, beginning in global configuration mode:
| Step | Command | Task |
|---|---|---|
| 1 | Configure the ATM accounting selection index number and change to accounting selection mode. | |
| 2 | default [connection-type | list] | Reset the ATM accounting selection table configuration to the default. |
| 3 | connection-types [pvc | pvp | spvc-originator | spvc-target | spvp-originator | spvp-target | svc-in | svc-out | svp-in | svp-out] | Configure the accounting connection type(s). |
| 4 | list hexadecimal_number | Configure the list of ATM accounting MIB objects to collect1. |
| 1The MIB objects are listed in the ATM Accounting Information MIB publication. |
The atm accounting selection command creates or modifies an entry in the selection table by specifying the fields of the entry.
Some features of the ATM selection table configuration include:
The following example shows how to change to ATM accounting selection configuration mode and add the SVPC originator connection type entry to selection entry 1:
Switch(config)# atm accounting selection 1 Switch(config-acct-sel)# connection-types spvc-originator
The following example shows how to change to ATM accounting selection configuration mode and reset the connection types for selection entry 1:
Switch(config)# atm accounting selection 1 Switch(config-acct-sel)# default connection-types
The following example shows how to change to ATM accounting selection configuration mode and configure the selection list to include all objects:
Switch(config)# atm accounting selection 1 Switch(config-acct-sel)# default list
The following example shows how to change to ATM accounting selection configuration mode and configure the selection list to include object number 20 (atmAcctngTransmitTrafficDescriptorParam1):
Switch(config)# atm accounting selection 1 Switch(config-acct-sel)# list 00001000
To display the ATM accounting status, use the following EXEC command:
| Command | Task |
|---|---|
show atm accounting | Display the ATM accounting. |
The following example shows the ATM accounting status using the show atm accounting EXEC command:
Switch# show atm accounting
ATM Accounting Info: AdminStatus - UP; OperStatus : UP
Trap Threshold - 90 percent (4500000 bytes)
Interfaces:
File Entry 1: Name acctng_file1
Descr: atm accounting data
Min-age (seconds): 3600
Failed_attempt : C0
Sizes: Active 69 bytes (#records 0); Ready 73 bytes (#records 0)
selection Entry -
Selection entry 1, subtree - 1.3.6.1.4.1.9.10.18.1.1
Selection entry 1, list - 00.00.10.00
Selection entry 1, connType - F0.00
Active selection -
Selection entry 1, subtree - 1.3.6.1.4.1.9.10.18.1.1
Selection entry 1, list - FF.FE.BF.FC
Selection entry 1, connType - F0.00
Debug output
Sig API: Err - 0
New_Conn: OK - 0; Err - 0
Rel_Conn: OK - 0; Err - 0
New_Leg: OK - 0; Err - 0
Rel_Leg: OK - 0; Err - 0
New_Party: OK - 0; Err - 0
Rel_Party: OK - 0; Err - 0
The ATM accounting data being gathered from the configured selection control table should be directed to a specific ATM accounting file. To configure the ATM accounting files and change to ATM accounting file configuration mode, perform the following tasks, beginning in global configuration mode:
| Step | Command | Task |
|---|---|---|
| 1 | Configure the ATM accounting file and change to accounting file configuration mode. | |
| 2 | collection-modes {on-release | periodic} | Configure when to write to the accounting file. |
| 3 | default [min-age] | Reset the ATM accounting file configuration to the default. |
| 4 | description 64_characters | Configure a short description for the ATM accounting file. |
| 5 | enable | Enable ATM accounting for a specific file. |
| 6 | failed-attempts {none | regular | soft} | Configure whether to record failed connection attempts. |
| 7 | interval {60-86400} | Configure the interval for periodic collection, in seconds. |
| 8 | min-age minutes | Configure the ATM accounting file minimum age of the VC. |
The following example shows how to enable ATM accounting file configuration mode for acctng_file1 and reconfigure the collection mode on release of a connection:
Switch(config)# atm accounting file acctng_file1 Switch(config-acct-file)# collection-mode on-release
The following example shows how to enable ATM accounting file configuration mode for acctng_file1 and reconfigure the minimum age to the default value:
Switch(config)# atm accounting file acctng_file1 Switch(config-acct-file)# default min-age
The following example shows how to enable ATM accounting file configuration mode for acctng_file1 and configure a short description to be displayed in the show atm accounting file display and the file header:
Switch(config)# atm accounting file acctng_file1 Switch(config-acct-file)# description Main accounting file for engineering
The following example shows how to enable ATM accounting file configuration mode for acctng_file1:
Switch(config)# atm accounting file acctng_file1 Switch(config-acct-file)# enable
The following example shows how to enable ATM accounting file configuration mode for acctng_file1 to collect connection data every hour:
Switch(config)# atm accounting file acctng_file1 Switch(config-acct-file)# interval 3600
To display the ATM accounting status, use the following privileged EXEC command:
| Command | Task |
|---|---|
show atm accounting | Display the ATM accounting. |
The following example shows the ATM accounting file status using the show atm accounting privileged EXEC command:
Switch# show atm accounting
ATM Accounting Info: AdminStatus - UP; OperStatus : UP
Trap Threshold - 90 percent (4500000 bytes)
Interfaces:
File Entry 1: Name acctng_file1
Descr: atm accounting data
Min-age (seconds): 3600
Failed_attempt : C0
Sizes: Active 69 bytes (#records 0); Ready 73 bytes (#records 0)
selection Entry -
Selection entry 1, subtree - 1.3.6.1.4.1.9.10.18.1.1
Selection entry 1, list - FF.FE.BF.FC
Selection entry 1, connType - F0.00
Active selection -
Selection entry 1, subtree - 1.3.6.1.4.1.9.10.18.1.1
Selection entry 1, list - FF.FE.BF.FC
Selection entry 1, connType - F0.00
Debug output
Sig API: Err - 0
New_Conn: OK - 0; Err - 0
Rel_Conn: OK - 0; Err - 0
New_Leg: OK - 0; Err - 0
Rel_Leg: OK - 0; Err - 0
New_Party: OK - 0; Err - 0
Rel_Party: OK - 0; Err - 0
To configure ATM accounting collection, use the following command in privileged EXEC mode:
| Command | Task |
|---|---|
Configure the ATM accounting data collection. |
The following example shows how to collect into the specified file all VCs older than the minimum age VCs when the Return key is pressed:
Switch# atm accounting collection collect-now accntg_file1
The following example shows how to swaps the buffers corresponding to the file named acctng_file1:
Switch# atm accounting collection swap acctng_file1
To display the ATM accounting file configuration status, use the following EXEC command:
| Command | Task |
|---|---|
show atm accounting | Display the ATM accounting status. |
The following example shows the ATM accounting status using the show atm accounting files EXEC command:
Switch# show atm accounting
ATM Accounting Info: AdminStatus - UP; OperStatus : DOWN
Trap Threshold - 90 percent (4500000 bytes)
Interfaces:
File Entry 1: Name acctng_file1
Descr: atm accounting data
Min-age (seconds): 3600
Failed_attempt : C0
No file buffers initialized
selection Entry -
Selection entry 1, subtree - 1.3.6.1.4.1.9.10.18.1.1
Selection entry 1, list - FF.FE.BF.FC
Selection entry 1, connType - F0.00
Active selection -
Selection entry 1, subtree - 1.3.6.1.4.1.9.10.18.1.1
Selection entry 1, list - FF.FE.BF.FC
Selection entry 1, connType - F0.00
Debug output
Sig API: Err - 0
New_Conn: OK - 0; Err - 0
Rel_Conn: OK - 0; Err - 0
New_Leg: OK - 0; Err - 0
Rel_Leg: OK - 0; Err - 0
New_Party: OK - 0; Err - 0
Rel_Party: OK - 0; Err - 0
This section describes configuring the SNMP server and traps for ATM accounting.
Using an SNMP network management system to monitor the status of the ATM accounting file being created requires two tasks:
To configure ATM accounting SNMP traps, use the following command in global configuraiton mode:
| Command | Task |
|---|---|
atm accounting trap threshold percent-value | Configure the ATM accounting file size threshold to generate an SNMP trap. |
The following example shows how to configure ATM accounting SNMP traps to be sent when the file size reaches 85 percent full:
Switch(config)# atm accounting trap threshold 85
To display the ATM accounting trap threshold configuration, use the EXEC command:
| Command | Task |
|---|---|
show atm accounting | Display the ATM accounting trap configuration. |
The following example shows the ATM accounting trap threshold configuration using the show atm accounting EXEC command:
Switch# show atm accounting
ATM Accounting Info: AdminStatus - UP; OperStatus : UP
Trap Threshold - 90 percent (4500000 bytes)
Interfaces:
File Entry 1: Name acctng_file1
Descr: atm accounting data
Min-age (seconds): 3600
Failed_attempt : C0
Sizes: Active 69 bytes (#records 0); Ready 73 bytes (#records 0)
selection Entry -
Selection entry 1, subtree - 1.3.6.1.4.1.9.10.18.1.1
Selection entry 1, list - FF.FE.BF.FC
Selection entry 1, connType - F0.00
Active selection -
Selection entry 1, subtree - 1.3.6.1.4.1.9.10.18.1.1
Selection entry 1, list - FF.FE.BF.FC
Selection entry 1, connType - F0.00
Debug output
Sig API: Err - 0
New_Conn: OK - 0; Err - 0
Rel_Conn: OK - 0; Err - 0
New_Leg: OK - 0; Err - 0
Rel_Leg: OK - 0; Err - 0
New_Party: OK - 0; Err - 0
Rel_Party: OK - 0; Err - 0
This section describes configuring the SNMP server ATM accounting traps.
To configure SNMP ATM accounting traps, perform the following tasks in global configuration mode:
| Command | Task |
|---|---|
Enable SNMP server ATM accounting trap generation. | |
snmp-server host ip_address [community-string] atm-accounting | Configure the ATM accounting file size threshold to generate an SNMP trap. |
The following example shows how to enable SNMP server ATM accounting traps and configure the SNMP server host at IP address 1.2.3.4 with community string public for ATM accounting:
Switch(config)# snmp-server enable traps atm-accounting Switch(config)# snmp-server host 1.2.3.4 public atm-accounting
To display the SNMP server ATM accounting configuration, use the following privileged EXEC command:
| Command | Task |
|---|---|
show running-config | Display the SNMP server ATM accounting configuration. |
The following example shows the SNMP server ATM accounting configuration using the show running-config privileged EXEC command:
Switch# show running-config Building configuration... Current configuration: ! version XX.X no service pad service udp-small-servers service tcp-small-servers ! hostname Switch ! ! username dplatz ip rcmd rcp-enable ip rcmd remote-host dplatz 171.69.194.9 dplatz ip rcmd remote-username dplatz atm template-alias byte_wise 47.9*f8.33... atm template-alias bit_set 47.9f9(1*0*)88ab... atm template-alias training 47.1328... atm accounting enable atm accounting trap threshold 85 ! <Information Deleted> no ip classless atm route 47.0091.8100.0000.0000.0ca7.ce01... ATM3/0/0 snmp-server enable traps chassis-fail snmp-server enable traps chassis-change snmp-server enable traps atm-accounting snmp-server host 1.2.3.4 public atm-accounting ! line con 0 line aux 0 line vty 0 4 login ! end
After the ATM accounting file is written to DRAM, you must configure TFTP to allow network requests to copy the accounting information to a host for processing.. To do this, use the following command in global configuration mode:
| Command | Task |
|---|---|
tftp-server atm-accounting filename ip_access_num | Use TFTP to copy the ATM accounting file to an IP host. |
The following example shows how to allow TFTP service to copy the ATM accounting file acctng_file1 to the IP access list of requesting host number 1:
Switch(config)# tftp-server atm-accounting acctng_file1 1
This section describes the process you use to configure ATM RMON on the LightStream 1010 ATM switch. The following sections describe the process:
The ATM RMON feature allows you to monitor network traffic for reasons such as fault monitoring or capacity planning. The ATM RMON feature is an extension of an existing, well-known RMON standard and provides high-level per-host and per-conversation statistics in a standards-track MIB similar to the following RMON MIBs:
The ATM-RMON counter uses the per-VC counters already maintained in the hardware and polled by the software. The ATM RMON agent can report cell traffic statistics by monitoring connection management activity. At connection setup and release time, some ATM-RMON bookkeeping code is executed. The amount of information varies, depending on the ATM RMON configuration. The ATM-RMON bookkeeping capability significantly reduces the CPU requirements for ATM-RMON, and allows collecting statistics on many or all the switch ports at once.
The ATM-RMON agent uses the 64-bit version of each cell counter if 64-bit counter support is present in the SNMP master-agent library.
Previously, RMON allowed collection of connection information on a per-interface basis only. ATM RMON allows a group of ports to be configured as an aggregate. The port select group defines this collection unit used by the ATM RMON agent to gather host and matrix connection data. For example, in Figure 15-3, agent 1 has a port selection group 1 made up of ports.

An active port select group must be defined before any data collection can begin. You can use the command-line interface (CLI) and SNMP modules to configure and access port select group structures.
To configure an RMON port selection group, use the following command in global configuration mode:
| Command | Task |
|---|---|
atm rmon portselgrp number {descr label | | Configure the ATM RMON port selection group. |
The following example shows how to configure port selection group 7 with the following:
Switch(config)# atm rmon portselgrp 7 maxhost 500 maxmatrix 2000 host-prio 1 owner "nms 3"
To display the ATM RMON port select group statistics, use the following EXEC command:
| Command | Task |
|---|---|
show atm rmon stats group_number | Display the ATM RMON port select group statistics. |
The following example shows how to display the configuration of port selection group 3 using the show atm rmon stats command from EXEC mode:
Switch# show atm rmon stats 3 PortSelGrp: 3 Collection: Enabled Drops: 0 CBR/VBR: calls: 0/0 cells: 0 connTime: 0 days 00:00:00 ABR/UBR: calls: 0/0 cells: 0 connTime: 0 days 00:00:00
Before the port selection group can begin gathering host and matrix connection information, an interface or group of interfaces must be added to the port selection group.
To configure an interface to an ATM RMON port selection group, use the following commands, beginning in global configuration mode:
| Command | Task |
|---|---|
interface atm card/subcard/port | Select the interface to be configured. |
atm rmon collect port_sel_group | Configure the interface to an ATM RMON port selection group. |
The following example shows how to configure ATM interface 0/1/3 to ATM RMON port selection group 6:
Switch(config)# interface atm 0/1/3 Switch(config-if)# atm rmon collect 6
To display the ATM RMON port configuration status, use the following EXEC command:
| Command | Task |
|---|---|
show atm rmon {host port_sel_group | | Display the interface port selection group configuration. |
The following example shows how to display the ATM RMON host configuration for port selection group 6 using the show atm rmon host command from user EXEC mode:
Switch# show atm rmon host 6 PortSelGrp: 6 Collection: Enabled Drops: 0
The following example shows how to display the ATM RMON matrix configuration for port selection group 6 using the show atm rmon matrix command from user EXEC mode:
Switch# show atm rmon matrix 6 PortSelGrp: 6 Collection: Enabled Drops: 0
The following example shows how to display the ATM RMON statistics configuration for port selection group 6 using the show atm rmon stats command from user EXEC mode:
Switch# show atm rmon stats 6 PortSelGrp: 6 Collection: Enabled Drops: 0 CBR/VBR: calls: 0/0 cells: 0 connTime: 0 days 00:00:00 ABR/UBR: calls: 0/0 cells: 0 connTime: 0 days 00:00:00
The following example shows how to display the ATM RMON status for all port selection groups using the show atm rmon status command from user EXEC mode:
Switch# show atm rmon status
PortSelGrp: 1 Status: Enabled Hosts: 4/no-max Matrix: 4/no-max
ATM0/0/0 ATM0/0/2
PortSelGrp: 2 Status: Enabled Hosts: 0/no-max Matrix: 0/no-max
ATM0/0/3
PortSelGrp: 3 Status: Enabled Hosts: 0/no-max Matrix: 0/no-max
ATM0/1/0 ATM0/1/1
PortSelGrp: 4 Status: Enabled Hosts: 0/1 Matrix: 0/5
ATM0/0/1
PortSelGrp: 5 Status: Enabled Hosts: 0/no-max Matrix: 0/no-max
ATM0/1/2
PortSelGrp: 6 Status: Enabled Hosts: 0/no-max Matrix: 0/no-max
ATM0/1/3
PortSelGrp: 7 Status: Enabled Hosts: 0/no-max Matrix: 0/no-max
ATM2/0/0
PortSelGrp: 8 Status: Enabled Hosts: 0/no-max Matrix: 0/no-max
PortSelGrp: 9 Status: Enabled Hosts: 0/no-max Matrix: 0/no-max
Use the atm rmon enable command to start ATM RMON data collection.
To enable ATM RMON data collection, use the following command in global configuration mode:
| Command | Task |
|---|---|
atm rmon enable | Enable ATM RMON. |
To display the ATM RMON configuration, use the following privileged EXEC command:
| Command | Task |
|---|---|
show running-config | Display the ATM RMON configuration. |
The following example shows the ATM RMON configuration using the show running-config privileged EXEC command:
Switch# show running-config Building configuration... Current configuration: ! <information deleted> ip default-gateway 172.20.53.206 no ip classless snmp-server community public RW snmp-server location racka-cs:2016 snmp-server contact abierman atm rmon portselgrp 1 host-scope 3 matrix-scope 3 atm rmon portselgrp 2 host-scope 3 matrix-scope 3 descr "router port 2" owner rubble" atm rmon portselgrp 3 host-scope 3 matrix-scope 3 descr "test" owner "bam_bam" atm rmon portselgrp 4 maxhost 1 maxmatrix 5 host-scope 1 descr "no active ports" owner "wilma" atm rmon portselgrp 5 atm rmon portselgrp 6 matrix-prio 1 atm rmon portselgrp 7 host-scope 3 matrix-scope 3 descr "CPU port" owner "pebbles" atm rmon portselgrp 8 atm rmon portselgrp 9 atm rmon enable ! line con 0 exec-timeout 0 0 line aux 0 transport input all line vty 0 4 login ! end
To configure an RMON event being generated, use the following command in global configuration mode:
| Command | Task |
|---|---|
rmon event number { description name | | Configure an RMON event. |
The following example shows how to configure a generated RMON event:
Switch(config)# rmon event 1 description test owner nms_3 trap test
To display the generated RMON events, use the following EXEC command:
| Command | Task |
|---|---|
show rmon events | Display generated RMON events. |
The following example shows the RMON events generated using the show rmon events EXEC command:
Switch# show rmon events Event 1 is active, owned by nms_3 Description is test Event firing causes trap to community test, last fired 00:00:00
You can configure RMON alarm generation if any of the configured parameters are met.
To configure RMON alarms, use the following command in global configuration mode:
| Command | Task |
|---|---|
rmon alarm number mib_object interval {absolute rising-threshold value falling-threshold value owner name | | Configure the ATM RMON alarm. |
The following example shows how to configure RMON alarm number 1 to generate an alarm:
Switch(config)# rmon alarm 1 atmHostInHCCells 500 absolute rising-threshold 10000 falling-threshold 1000 owner "nms 3"
To display the RMON alarm event, use the following EXEC command:
| Command | Task |
|---|---|
show rmon alarms events | Display RMON alarms. |
The following example shows the RMON alarms and events using the show rmon alarms events EXEC command:
Switch# show rmon alarms events Event 1 is active, owned by nms 3 Description is test Event firing causes trap to community test, last fired 00:00:00 Alarm table is empty
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Tue Jun 22 13:57:15 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.