Configuring ATM Accounting and ATM RMON

This chapter describes the ATM accounting and ATM Remote Monitoring (RMON) features used with the LightStream 1010 ATM switch. This chapter is separated into the following sections:

For a complete description of the commands mentioned in this chapter, refer to the LightStream 1010 ATM Switch Command Reference publication.

Note The ATM accounting and ATM RMON features are available with LightStream 1010 ATM switch Cisco IOS software Release 11.2(5) or later.

Configure ATM Accounting

This section describes the process needed to enable and configure the ATM accounting feature in the LightStream 1010 ATM switch. The following sections describe the process:

The ATM accounting feature provides accounting and billing services for virtual circuits (VCs) used on the LightStream 1010 ATM switch. ATM accounting is typically enabled on an edge switch to monitor call setup and traffic activity. A specific interface might be configured to monitor either incoming or outgoing or incoming and outgoing VC use. Figure 14-1 shows a typical ATM accounting environment.

Figure 14-1: ATM Accounting Environment

The edge switches, connected to the exterior internet, are typical connections requiring monitoring for accounting and billing purposes.

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. Because the data gathered can be so large, using traditional Simple Network Management Protocol (SNMP) methods of data retrieval is not feasible. A better method is to store the collected accounting information in a file which can subsequently be retrieved via a file transfer protocol. SNMP is used to provide management control of the selection and collection of accounting data. Figure 14-2 shows an interface, filtering, and file configuration example.

Figure 14-2: Interface and File Management for ATM Accounting

A file used for data collection actually corresponds to two memory buffers on the ATM Switch Processor (ASP). One buffer is actively saving data, while the second one is passive and ready to have its data either retrieved using the 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.

Configure Global ATM Accounting

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 or disable the ATM accounting feature for the entire switch, use the atm accounting command.

Note Even when ATM accounting is disabled globally, other ATM accounting commands, both global and for individual interfaces, remain in the configuration file.

To enable the ATM accounting feature, use the following command. Use the no form of this command to disable.

Task Command

At the privileged EXEC prompt, enter configuration mode from the terminal.

configure ¹
[terminal]

Enable ATM accounting for the switch.

atm accounting enable

¹This command is documented in the LightStream 1010 ATM Switch Command Reference publication.

Task	Command
At the privileged EXEC prompt, enter configuration mode from the terminal.	configure ¹ [terminal]
Enable ATM accounting for the switch.	atm accounting enable

Example

The following example enables ATM accounting:

Switch#config terminal

Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)# atm accounting enable

Switch(config)#

Display ATM Accounting Configuration

Use the show running-config command to display the ATM accounting configuration status.

To display the ATM accounting status, perform the following task in user EXEC mode:

Task Command

Display the ATM accounting status.

show running-config

Task	Command
Display the ATM accounting status.	show running-config

Example

The following example displays the ATM accounting status using the show atm accounting command from user EXEC mode:

Switch#show running-config

Building configuration...
Current configuration:
!
version 11.2
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 e164 translation-table
 e164 address 1111111 nsap-address 11.111111111111111111111111.112233445566.11
 --More--
<Information Deleted>
Switch#

Enable ATM Accounting on an Interface

After ATM accounting is enabled, specific ingress or egress interfaces must be configured to start gathering the ATM accounting data. Usually these are interfaces on edge switches connected to the external network. Use the interface atm command to change to interface configuration mode and the atm accounting command to enable ATM accounting.

To enable ATM accounting on a specific interface, use the following configuration command. Use the no form of these commands to disable:

Task Command

At the privileged EXEC prompt, enter configuration mode from the terminal.

configure ¹
[terminal]

Select the interface to be configured.

interface atm card/sub_card/port

Enable ATM accounting on the selected interface.

atm accounting

¹This command is documented in the LightStream 1010 ATM Switch Command Reference publication.

Task	Command
At the privileged EXEC prompt, enter configuration mode from the terminal.	configure ¹ [terminal]
Select the interface to be configured.	interface atm card/sub_card/port
Enable ATM accounting on the selected interface.	atm accounting

Example

The following example enables ATM accounting on ATM interface 1/0/3, shuts down the interface, and reenables it:

Switch#config terminal

Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)#interface atm 1/0/3

Switch(config-if)#atm accounting

Switch(config-if)#

Display ATM Accounting Interface Configuration

Use the show atm accounting command to display the interface ATM accounting configuration status.

To display the ATM accounting status, perform the following task in user EXEC mode:

Task Command

Display the ATM accounting status.

show running-config

Task	Command
Display the ATM accounting status.	show running-config

Example

The following example displays the interface ATM accounting status using the show running-config command from user EXEC mode:

Switch#show running-config

Building configuration...
Current configuration:
!
<Information Deleted>
!
interface ATM1/0/3
 no keepalive
 atm accounting
!
--More--
!
end
Switch#

Configure ATM Accounting Selection Table

The ATM accounting selection table determines the connection data to be gathered from the switch. To configure the ATM selection table, use the atm accounting selection command.

To configure the ATM accounting selection entries, use the following commands. Use the no form of these commands to disable.

Task Command

At the privileged EXEC prompt, enter configuration mode from the terminal.

configure ¹
[terminal]

Configure ATM accounting selection index number and change to accounting selection mode.

atm accounting selection 1

Resets the ATM accounting selection table configuration to the default.

default [ connection-type | list ]

Configure accounting connection type(s).

connection-types [ spvc-originator | spvc-target | spvp-originator | spvp-target | svc-in | svc-out | svp-in | svp-out ]

Configure the list of ATM Accounting MIB objects to collect².

list hexadecimal_number

¹This command is documented in the LightStream 1010 ATM Switch Command Reference publication.
²The MIB objects are listed in the ATM Accounting Information MIB document.

Task	Command
At the privileged EXEC prompt, enter configuration mode from the terminal.	configure ¹ [terminal]
Configure ATM accounting selection index number and change to accounting selection mode.	atm accounting selection 1
Resets the ATM accounting selection table configuration to the default.	default [ connection-type \| list ]
Configure accounting connection type(s).	connection-types [ spvc-originator \| spvc-target \| spvp-originator \| spvp-target \| svc-in \| svc-out \| svp-in \| svp-out ]
Configure the list of ATM Accounting MIB objects to collect².	list hexadecimal_number

This command creates or modifies an entry in the selection table by specifying the fields of the entry.

Note A default selection entry is automatically configured during initial startup and cannot be deleted.

Following are some features of the ATM selection table configuration:

An entry in the selection table points to a data collection file.
A selection entry cannot be deleted when data collection is active.
A selection entry can point to a non-existent file, in which case the entry is considered inactive.
One selection entry can apply to more than one type of VC (For example, SVC, PVC).
If a selection entry list is modified, the new value is used the next time the data collection cycle begins, for example, the next time the ATM accounting collection file swap occurs.

Note The following ATM accounting MIB objects are not supported:
--- atmAcctngTransmittedClp0Cells (object number 16)
--- atmAcctngReceivedClp0Cells (object number 18)
--- atmAcctngCallingPartySubAddress (object number 31)
--- atmAcctngCalledPartySubAddress (object number 32)
--- atmAcctngRecordCrc16 (object number 33)

Examples

The following example changes to ATM accounting selection configuration mode:

Switch#config terminal

Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)#atm accounting selection 1

Switch(config-acct-sel)#

The following example changes to ATM accounting selection configuration mode and adds the soft permanent-virtual-circuit-originator connection type entry to the selection entry 1:

Switch(config)#atm accounting selection 1

Switch(config-acct-sel)#connection-types spvc-originator

Switch(config-acct-sel)#

The following example changes to ATM accounting selection configuration mode and resets the connection types for selection entry 1:

Switch(config)#atm accounting selection 1

Switch(config-acct-sel)#default connection-types

Switch(config-acct-sel)#

The following example changes to ATM accounting selection configuration mode and configures the selection list to include all objects:

Switch(config)#atm accounting selection 1

Switch(config-acct-sel)# default list

Switch(config-acct-sel)#

The following example changes to ATM accounting selection configuration mode and configures the selection list to include object number 20 (atmAcctngTransmitTrafficDescriptorParam1):

Switch(config)#atm accounting selection 1

Switch(config-acct-sel)#list 00001000

Switch(config-acct-sel)#

Display ATM Accounting Selection Configuration

Use the show atm accounting command to display the ATM accounting selections table configuration status.

To display the ATM accounting status, perform the following task in user EXEC mode:

Task Command

Display the ATM accounting.

show atm accounting

Task	Command
Display the ATM accounting.	show atm accounting

Example

The following example displays the ATM accounting status using the show atm accounting command from user EXEC mode:

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
Switch#

Configure ATM Accounting Files

The ATM accounting data being gathered from the configured selection control table should be directed to a specific ATM accounting file. Use the atm accounting file commands to configure the ATM accounting file.

To configure the ATM accounting files and change to ATM accounting file configuration mode, use the following command. Use the no form of this command to disable.

Task Command

At the privileged EXEC prompt, enter configuration mode from the terminal.

configure ¹
[terminal]

Configure ATM accounting file and change to accounting file configuration mode.

atm accounting file filename

Reset the ATM accounting file configuration to the default.

default [ min-age ]

Configure a short description for the ATM accounting file.

description 64_characters

Enable ATM accounting for a specific file.

enable

Configure the ATM accounting file minimum age of the VC.

min-age minutes

¹This command is documented in the LightStream 1010 ATM Switch Command Reference publication.

Task	Command
At the privileged EXEC prompt, enter configuration mode from the terminal.	configure ¹ [terminal]
Configure ATM accounting file and change to accounting file configuration mode.	atm accounting file filename
Reset the ATM accounting file configuration to the default.	default [ min-age ]
Configure a short description for the ATM accounting file.	description 64_characters
Enable ATM accounting for a specific file.	enable
Configure the ATM accounting file minimum age of the VC.	min-age minutes

Note Only one ATM accounting file can be configured and that file cannot be deleted.

Examples

The following example switches to ATM accounting file configuration mode:

Switch(config)#atm accounting file acctng_file1

Switch(config-acct-file)#

The following example switches to ATM accounting file configuration mode and reconfigures the minimum age to the default value:

Switch(config)#atm accounting file acctng_file1

Switch(config-acct-file)#default min-age

Switch(config-acct-file)#

The following example switches to ATM accounting file configuration mode and configures a short description to be displayed in the show atm accounting file display and the header of the file:

Switch(config)#atm accounting file acctng_file1

Switch(config-acct-file)#description Main accounting file for engineering

Switch(config-acct-file)#

The following example enables ATM accounting file configuration mode for the ATM accounting file acctng_file1:

Switch(config)#atm accounting file acctng_file1

Switch(config-acct-file)#enable

Switch(config-acct-file)#

Display ATM Accounting File Configuration

Use the show atm accounting command to display the ATM accounting file configuration status.

To display the ATM accounting status, perform the following task in user EXEC mode:

Task Command

Display the ATM accounting.

show atm accounting

Task	Command
Display the ATM accounting.	show atm accounting

Example

The following example displays the ATM accounting file status using the show atm accounting command from user EXEC mode:

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
Switch#

Control ATM Accounting Data Collection

The following commands allow you to control the collection of ATM accounting data to a specific file.

To configure ATM accounting collection in EXEC configuration mode, use the atm accounting collection command. Use the no form of this command to disable.

Task Command

Configure the ATM accounting data collection.

atm accounting collection {collect-now | swap} filename

Task	Command
Configure the ATM accounting data collection.	atm accounting collection {collect-now \| swap} filename

Examples

The following example does a collection into the specified file for all VCs older than the minimum age VCs when the <Return> key is pressed:

Switch#atm accounting collection collect-now accntg_file1

Switch#

The following example swaps the buffers corresponding to the file named acctng_file1:

Switch#atm accounting collection swap acctng_file1

Switch#

Display ATM Accounting Data Collection Configuration and Status

Use the show atm accounting command to display the ATM accounting file configuration status.

To display the ATM accounting status, perform the following task in user EXEC mode:

Task Command

Display the ATM accounting status.

show atm accounting

Task	Command
Display the ATM accounting status.	show atm accounting

Example

The following example displays the ATM accounting status using the show atm accounting files command from user EXEC mode:

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
Switch#

Configure ATM Accounting SNMP Traps

This section describes configuring the SNMP server and traps for ATM accounting.

To use an SNMP network management system to monitor the status of the ATM accounting file being created requires the following two processes:

Configure ATM Accounting Trap Generation

Use the atm accounting trap threshold command to enable and configure ATM accounting SNMP trap generation.

To configure ATM accounting SNMP traps in EXEC configuration mode, use the following commands using the no form of the atm accounting trap threshold command to disable trap generation.

Task Command

At the privileged EXEC prompt, enter configuration mode from the terminal.

configure ¹
[terminal]

Configure the ATM accounting file size threshold to generate an SNMP trap.

atm accounting trap threshold percent-value

¹This command is documented in the LightStream 1010 ATM Switch Command Reference publication.

Task	Command
At the privileged EXEC prompt, enter configuration mode from the terminal.	configure ¹ [terminal]
Configure the ATM accounting file size threshold to generate an SNMP trap.	atm accounting trap threshold percent-value

Examples

The following example configures ATM accounting SNMP traps to be sent when the file size reaches 85 percent full:

Switch#config terminal

Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)#atm accounting trap threshold 85

Switch(config)#

Display ATM Accounting Trap Threshold Configuration

Use the show atm accounting command to display the ATM accounting traps configuration status.

To display the ATM accounting trap threshold configuration, perform the following task in user EXEC mode:

Task Command

Display the ATM accounting trap configuration.

show atm accounting

Task	Command
Display the ATM accounting trap configuration.	show atm accounting

Example

The following example displays the ATM accounting trap threshold configuration using the show atm accounting command from user EXEC mode:

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
Switch#

Configure SNMP Server for ATM Accounting

This section describes configuring the SNMP server ATM Accounting traps.

Use the snmp-server command to enable and configure SNMP ATM accounting trap generation.

To configure SNMP ATM accounting traps in EXEC configuration mode, use the following commands. Use the no form of the snmp-server command to disable trap generation.

Task Command

At the privileged EXEC prompt, enter configuration mode from the terminal.

configure ¹
[terminal]

Enable SNMP server ATM accounting traps generation.

snmp-server enable traps atm-accounting

Configure the ATM accounting file size threshold to generate an SNMP trap.

snmp-server host ip_address [community-string] atm-accounting

¹This command is documented in the LightStream 1010 ATM Switch Command Reference publication.

Task	Command
At the privileged EXEC prompt, enter configuration mode from the terminal.	configure ¹ [terminal]
Enable SNMP server ATM accounting traps generation.	snmp-server enable traps atm-accounting
Configure the ATM accounting file size threshold to generate an SNMP trap.	snmp-server host ip_address [community-string] atm-accounting

Example

The following example enables SNMP server ATM accounting traps and configures the SNMP server host at IP address 1.2.3.4 with community string public for ATM accounting:

Switch#config terminal

Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)#snmp-server enable traps atm-accounting

Switch(config)#snmp-server host 1.2.3.4 public atm-accounting

Switch(config)#

Display SNMP Server ATM Accounting Configuration

Use the show running-config command to display the SNMP server ATM accounting configuration status.

To display the SNMP server ATM accounting configuration, perform the following task in user EXEC mode:

Task Command

Display the SNMP server ATM accounting configuration.

show running-config

Task	Command
Display the SNMP server ATM accounting configuration.	show running-config

Example

The following example displays the SNMP server ATM accounting configuration using the show running_config command from user EXEC mode:

Switch#show running-config

Building configuration...
Current configuration:
!
version 11.2
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
Switch#

Use TFTP to Copy the ATM Accounting File

After the ATM accounting file is written to DRAM you need to configure TFTP to allow network requests to copy the accounting information to a host for processing. Use the tftp-server atm-accounting command to allow the files to be copied from the LightStream 1010 ATM switch to a host.

To copy the ATM accounting files from DRAM to a host in EXEC configuration mode.

Task Command

At the privileged EXEC prompt, enter configuration mode from the terminal.

configure ¹
[terminal]

Use TFTP to copy the ATM accounting file to an IP host.

tftp-server atm-accounting filename ip_access_num

¹This command is documented in the LightStream 1010 ATM Switch Command Reference publication.

Task	Command
At the privileged EXEC prompt, enter configuration mode from the terminal.	configure ¹ [terminal]
Use TFTP to copy the ATM accounting file to an IP host.	tftp-server atm-accounting filename ip_access_num

Example

The following example allows TFTP service to copy the ATM accounting file named acctng_file1 to the IP access list of requesting host number 1:

Switch#config terminal

Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)#tftp-server atm-accounting acctng_file1 1

Switch(config)#

Configure ATM RMON

This section describes the process needed to configure ATM Remote Monitoring (RMON) on the LightStream 1010 ATM switch. The following sections describe the process:

Overview of RMON

The ATM RMON feature allows you to monitor network traffic for such reasons as fault monitoring or capacity planning. The ATM RMON feature is an extension of existing, well-known RMON standard and provides high-level per-host and per-conversation statistics in a standards-track MIB similar to the following existing RMON MIBs:

RMON-1 MIB---RFC 1757
RMON-2 MIB---RFC 2021 and 2074

The ATM-RMON counter uses the per-VC counters which are already maintained in the hardware and polled by 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 makes it possible to collect 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.

Configure Port Select Groups

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 14-3, agent 1 has a port selection group 1 made up of three ports.

Figure 14-3: ATM RMON Port Select Group Examples

An active port select group must be defined before any data collection can actually begin. The command-line interface (CLI) and SNMP modules are used to configure and access port select group structures, although infrequently.

Use the atm rmon portselgrp command to configure an RMON port selection group.

To configure an RMON port selection group in EXEC configuration mode, use the following command. Use the no form of the atm rmon portselgrp command to disable:

Task Command

At the privileged EXEC prompt, enter configuration mode from the terminal.

configure ¹
[terminal]

Configure the ATM RMON port selection group.

atm rmon portselgrp number {
descr label |
host-prio value_1-3 |
host-scope value_1-3 |
matrix-prio value_1-3 |
matrix-scope value_1-3 |
maxhost number |
maxmatrix number |
nostats [ label | value_1-3 | value_1-3 | value_1-3 | value_1-3 | number | number | owner ] |
owner name }

¹This command is documented in the LightStream 1010 ATM Switch Command Reference publication.

Task	Command
At the privileged EXEC prompt, enter configuration mode from the terminal.	configure ¹ [terminal]
Configure the ATM RMON port selection group.	atm rmon portselgrp number { descr label \| host-prio value_1-3 \| host-scope value_1-3 \| matrix-prio value_1-3 \| matrix-scope value_1-3 \| maxhost number \| maxmatrix number \| nostats [ label \| value_1-3 \| value_1-3 \| value_1-3 \| value_1-3 \| number \| number \| owner ] \| owner name }

Example

The following example configures port selection group 7 with the following:

maximum host count of 500
maximum matrix count of 2000
host priority of 1
the owner name "nms 3"

Switch#config terminal

Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)#atm rmon portselgrp 7 maxhost 500 maxmatrix 2000 host-prio 1 owner "nms 3"

Switch(config)#

Display ATM RMON Port Select Group

Use the show atm rmon stats command to display the ATM RMON port select group statistics.

To display the ATM RMON port select group statistics, perform the following task in user EXEC mode:

Task Command

Display the ATM RMON port select group statistics.

show atm rmon stats group_number

Task	Command
Display the ATM RMON port select group statistics.	show atm rmon stats group_number

Example

The following example displays the configuration of port selection group 3 using the show atm rmon stats command from user 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
Switch#

Configure Interfaces into a Port Select Group

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.

Use the atm rmon collect interface command to add an individual interface to a port selection group.

To configure an interface to an ATM RMON port selection group in EXEC configuration mode, use the following commands. Use the no form of the atm rmon interface command to disable ATM RMON collection on that interface:

Task Command

At the privileged EXEC prompt, enter configuration mode from the terminal.

configure ¹
[terminal]

Select the interface to be configured.

interface atm card-A/sub_card-A/port-A

Configure the interface to an ATM RMON port selection group.

atm rmon collect port_sel_group

¹This command is documented in the LightStream 1010 ATM Switch Command Reference publication.

Task	Command
At the privileged EXEC prompt, enter configuration mode from the terminal.	configure ¹ [terminal]
Select the interface to be configured.	interface atm card-A/sub_card-A/port-A
Configure the interface to an ATM RMON port selection group.	atm rmon collect port_sel_group

Example

The following example configures ATM interface 0/1/3 to ATM RMON port selection group 6:

Switch#config terminal

Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)#interface atm 0/1/3

Switch(config-if)#atm rmon collect 6

Switch(config-if)#

Display Interface Port Selection Group Configuration

Use the show atm rmon command to display the ATM RMON port selection configuration status.

To display the ATM RMON configuration, perform the following task in user EXEC mode:

Task Command

Display the interface port selection group configuration.

show atm romon {
host port_sel_group |
matrix port_sel_group |
stats port_sel_group |
status }

Task	Command
Display the interface port selection group configuration.	show atm romon { host port_sel_group \| matrix port_sel_group \| stats port_sel_group \| status }

Examples

The following example displays the ATM RMON host configuration for port selection group 6 using the show atm rmon host command from user EXEC mode:

Switch#
Switch#show atm rmon host 6

PortSelGrp: 6   Collection: Enabled     Drops: 0
Switch#

The following example displays 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
Switch#

The following example displays 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
Switch#

The following example displays 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
Switch#

Enable Data Collection

Use the atm rmon enable command to start ATM RMON data collection.

Note If ATM RMON is disabled the configuration remains but is made inactive similar to using the shutdown command on and interface.

To configure ATM RMON in EXEC configuration mode, use the following commands. Use the no form of the atm rmon enable command to disable.

Task Command

At the privileged EXEC prompt, enter configuration mode from the terminal.

configure ¹
[terminal]

Enable ATM RMON.

atm rmon enable

¹This command is documented in the LightStream 1010 ATM Switch Command Reference publication.

Task	Command
At the privileged EXEC prompt, enter configuration mode from the terminal.	configure ¹ [terminal]
Enable ATM RMON.	atm rmon enable

Example

The following example enables ATM RMON:

Switch#config terminal

Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)#atm rmon enable

Switch(config)#

Display ATM RMON Configuration

Use the show running-config command to display the ATM RMON configuration status.

To display the ATM RMON configuration, perform the following task in user EXEC mode:

Task Command

Display the ATM RMON configuration.

show running-config

Task	Command
Display the ATM RMON configuration.	show running-config

Example

The following example displays the ATM RMON configuration using the show atm rmon status command from user EXEC mode:

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

Switch#

Configure an RMON Event

Use the atm event command to generate an RMON event.

To configure an RMON event being generated in EXEC configuration mode, use the following commands. Use the no form of the atm accounting trap command to disable trap generation.

Task Command

At the privileged EXEC prompt, enter configuration mode from the terminal.

configure ¹
[terminal]

Configure RMON event.

rmon event number {
description name |
log [ description name | owner name |
trap community_string ] |
owner name |
trap community_string }

¹This command is documented in the LightStream 1010 ATM Switch Command Reference publication.

Task	Command
At the privileged EXEC prompt, enter configuration mode from the terminal.	configure ¹ [terminal]
Configure RMON event.	rmon event number { description name \| log [ description name \| owner name \| trap community_string ] \| owner name \| trap community_string }

Example

The following example configures an RMON event to be generated:

named 1
description string test
to the owner nm_3
an SNMP trap with the community string test

Switch#config terminal

Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)#rmon event 1 description test owner nms_3 trap test

Switch(config)#

Display RMON Events Generated

Use the show rmon events command to display RMON events generation status.

To display the RMON events generated, perform the following task in user EXEC mode:

Task Command

Display RMON events generated.

show rmon events

Task	Command
Display RMON events generated.	show rmon events

Example

The following example displays RMON events generated using the show rmon events command from user EXEC mode:

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
Switch#

Configure an RMON Alarm

Use the rmon alarm command to configure RMON alarm generation if any of the configured parameters are met.

Note See the section "Configure RMON Support" in the chapter "Initially Configuring the LightStream 1010 ATM Switch" for general SNMP RMON configuration information.

To configure RMON alarms in EXEC configuration mode, use the following commands. Use the no form of the rmon alarm command to disable:

Task Command

At the privileged EXEC prompt, enter configuration mode from the terminal.

configure ¹
[terminal]

Configure the ATM RMON alarm.

rmon alarm number mib_object interval {
absolute rising-threshold value falling-threshold value owner name |
delta rising-threshold value falling-threshold value owner name}

¹This command is documented in the LightStream 1010 ATM Switch Command Reference publication.

Task	Command
At the privileged EXEC prompt, enter configuration mode from the terminal.	configure ¹ [terminal]
Configure the ATM RMON alarm.	rmon alarm number mib_object interval { absolute rising-threshold value falling-threshold value owner name \| delta rising-threshold value falling-threshold value owner name}

Example

The following example configures RMON alarm number 1 to generate an alarm:

If the MIB atmHostHCCells exceed 500
If each sample, in absolute mode, shows:
- rising threshold exceeding 10,000
- falling threshold falling below 1000
Then the RMON alarm number 1 sends the alarm to the owner, "nms 3"

Switch#config terminal

Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)#rmon alarm 1 atmHostInHCCells 500 absolute rising-threshold 10000 
falling-threshold 1000 owner "nms 3"

Switch(config)#

Display RMON Alarms Generated

Use the show rmon alarms command to display RMON alarms status.

To display the RMON alarm event, perform the following task in user EXEC mode:

Task Command

Display RMON alarms.

show rmon alarms events

Example

The following example displays RMON alarms and events using the show rmon alarms events command from user EXEC mode:

Switch#
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
Switch#

Table of Contents

Configuring ATM Accounting and ATM RMON

Example

Example

Example

Example

Examples

Example

Examples

Example

Examples

Example

Examples

Example

Example

Example

Example

Example

Example

Example

Examples

Example

Example

Example

Example

Example

Example