ATM Switch Router Software Configuration Guide, 12.1(6)EY - Configuring ATM Accounting and ATM RMON [Cisco Catalyst 8500 Series Multiservice Switch Routers]

Note This chapter provides advanced configuration instructions for the Catalyst 8540 MSR, Catalyst 8510 MSR, and LightStream 1010 ATM switch routers. For complete descriptions of the commands mentioned in this chapter, refer to the ATM Switch Router Command Reference publication.

This chapter includes the following sections:

Configuring ATM Accounting
Configuring ATM RMON

Note The ATM accounting and ATM RMON features both require a minimum of 32 MB of dynamic random access memory (DRAM) installed on the multiservice route processor. If you want to run both ATM accounting and ATM RMON features together, you must have 64 MB of DRAM.

Configuring ATM Accounting

The following sections describe the process used to enable and configure the ATM accounting feature on the ATM switch router:

ATM Accounting Overview
Configuring Global ATM Accounting
Enabling ATM Accounting on an Interface
Configuring the ATM Accounting Selection Table
Configuring ATM Accounting Files
Controlling ATM Accounting Data Collection
Configuring ATM Accounting SNMP Traps
Using TFTP to Copy the ATM Accounting File
Configuring Remote Logging of ATM Accounting Records

ATM Accounting Overview

The ATM accounting feature provides accounting and billing services for virtual circuits (VCs) used on the ATM switch router. 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 14-1 shows a typical ATM accounting environment.

Figure 14-1 ATM Accounting Environment

The edge switches, connected to the exterior Internet, are connections that require monitoring for accounting and billing purposes.

Switching speeds and number of VCs supported by the ATM switch router 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 that you can retrieve using a file transfer protocol. SNMP provides 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 multiservice route processor. 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. Alternatively, the file can be written to a remotely connected PC over a TCP connection.

Configuring 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 ATM switch router.

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 in global configuration mode:

Command	Purpose
atm accounting enable	Enables ATM accounting for the ATM switch router.

Displaying the ATM Accounting Configuration

To display the ATM accounting status, use the following privileged EXEC command:

Command	Purpose
more system:running-config	Displays the ATM accounting status.

Enabling ATM Accounting on an Interface

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:

Command

Purpose

Step 1

Switch(config)# interface atm card/subcard/port

Switch(config-if)#

Selects the interface to be configured.

Step 2

Switch(config-line)# privilege level number

Configures the default privilege level.

Example

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

Displaying the ATM Accounting Interface Configuration

To display the ATM accounting status, use the following privileged EXEC command:

Command	Purpose
more system:running-config	Displays the ATM accounting status.

Example

The following display shows that ATM accounting is enabled on ATM interface 1/0/3:

 Switch# more system:running-config

 Building configuration...

 Current configuration:

!

 <information deleted>

!

 interface ATM1/0/3

  no keepalive

  atm accounting

!

 <information deleted>

Configuring the ATM Accounting Selection Table

The ATM accounting selection table determines the connection data to be gathered from the ATM switch router. To configure the ATM accounting selection entries, perform the following tasks, beginning in global configuration mode:

	Command	Purpose
Step 1	Switch(config)# atm accounting selection index Switch(config-acct-sel)#	Specifies the ATM accounting selection index number and changes to accounting selection mode.
Step 2	Switch(config-acct-sel)# default [connection-type \| list]	Resets the ATM accounting selection table configuration to the default.
Step 3	Switch(config-acct-sel)# connection-types [pvc \| pvp \| spvc-originator \| spvc-target \| spvp-originator \| spvp-target \| svc-in \| svc-out \| svp-in \| svp-out]	Specifies the connection type(s) for which you want to collect accounting records.
Step 4	Switch(config-acct-sel)# list hex-bitmap	Configures the list of ATM accounting MIB objects to collect.¹

1 The 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.

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

Some features of the ATM accounting selection table configuration include:

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 nonexistent file, in which case the entry is considered inactive.
One selection entry can apply to more than one type of VC (or example, SVC and PVC).
If you modify a selection entry list, 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 shows how to change to ATM accounting selection configuration mode and add the SPVC 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

Displaying ATM Accounting Selection Configuration

To display the ATM accounting status, use the following EXEC command:

Command	Purpose
show atm accounting	Displays the ATM accounting selection configuration.

Example

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

 <information deleted>

Configuring ATM Accounting Files

Direct the ATM accounting data being gathered from the configured selection control table 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:

	Command	Purpose
Step 1	Switch(config)# atm accounting file acctng_file1 Switch(config-acct-file)#	Specifies the ATM accounting file and enters accounting file configuration mode.
Step 2	Switch(config-acct-file)# collection-modes [on-release] [periodic]	Configures when to write to the accounting file.
Step 3	Switch(config-acct-file)# default [min-age]	Resets the ATM accounting file configuration to the default.
Step 4	Switch(config-acct-file)# description string	Configures a short description for the ATM accounting file.
Step 5	Switch(config-acct-file)# enable	Enables ATM accounting for a specific file.
Step 6	Switch(config-acct-file)# failed-attempts [none] [regular] [soft]	Configures whether to record failed connection attempts.
Step 7	Switch(config-acct-file)# interval seconds	Configures the interval for periodic collection, in seconds.
Step 8	Switch(config-acct-file)# min-age seconds	Configures the ATM accounting file minimum age of the VC.

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

Examples

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 

Displaying the ATM Accounting File Configuration

To display the ATM accounting status, use the following EXEC command:

Command	Purpose
show atm accounting	Displays the ATM accounting.

Example

The following example shows the ATM accounting file 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 - 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

Controlling ATM Accounting Data Collection

To configure the behavior of the buffers used for ATM accounting collection, use the following command in privileged EXEC mode:

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

Examples

The following example specifies that all VCs that meet the minimum age requirement should be collected:

 Switch# atm accounting collection collect-now accntg_file1

The following example swaps the buffers used to store accounting records; the old buffer is now ready to download:

 Switch# atm accounting collection swap acctng_file1

Displaying the ATM Accounting Data Collection Configuration and Status

To display the ATM accounting file configuration status, use the following EXEC command:

Command	Purpose
show atm accounting	Displays the ATM accounting status.

Example

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

 <Information deleted>

Configuring ATM Accounting SNMP Traps

You can configure SNMP traps to be generated when the ATM accounting file reaches a specified threshold. You can use these traps to alert you when a file is full and needs to be downloaded.

Configuring ATM Accounting Trap Generation

To configure ATM accounting SNMP traps, use the following command in global configuration mode:

Command	Purpose
atm accounting trap threshold percent-value	Configures the ATM accounting file threshold to generate an SNMP trap when it reaches a percentage of the maximum size.

Example

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

Displaying ATM Accounting Trap Threshold Configuration

To display the ATM accounting trap threshold configuration, use the following EXEC command:

Command	Purpose
show atm accounting	Displays the ATM accounting trap configuration.

Example

The following example shows the ATM accounting trap threshold configuration using the show atm accounting 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

 <information deleted>

Configuring SNMP Server for ATM Accounting

To enable SNMP ATM accounting trap generation and specify an SNMP server, perform the following steps in global configuration mode:

	Command	Purpose
Step 1	Switch(config)# snmp-server enable traps atm-accounting	Enables SNMP server ATM accounting trap generation.
Step 2	Switch(config)# snmp-server host host community-string atm-accounting	Configures SNMP server host IP address and community string for ATM accounting.

Example

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

Displaying SNMP Server ATM Accounting Configuration

To display the SNMP server ATM accounting configuration, use the following privileged EXEC command:

Command	Purpose
more system:running-config	Displays the SNMP server ATM accounting configuration.

Example

The following example shows the SNMP server ATM accounting configuration using the more system:running-config privileged EXEC command:

 Switch# more system:running-config

 Building configuration...

 Current configuration:

!

 <information deleted>

!

 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

!

 <information deleted>

Using TFTP to Copy the ATM Accounting File

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	Purpose
Step 1	Switch(config)# access-list access-list-number {deny \| permit} {source [source-wildcard] \| any}	Defines a standard IP access list using a source address and wildcard or the any option default source 0.0.0.0 and source mask 255.255.255.255.
Step 2	Switch(config)# tftp-server {atm-acct-active:acctng_file1 \| atm-acct-ready:acctng_file1} ip-access-list	Allows TFTP to copy the ATM accounting file to an IP host in response to a read request.

Example

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)# access-list 1 permit 10.1.1.1

 Switch(config)# tftp-server atm-acct-ready:acctng_file1 1

For more information about access lists, see the "Filtering IP Packets at the IP Interfaces" section.

Configuring Remote Logging of ATM Accounting Records

You can collect ATM accounting records to a remotely connected PC or UNIX workstation. You can use this method in place of, or in addition to, collecting ATM accounting records as a file into the switch's memory.

The remote logging method requires a server daemon to be running on a PC or a UNIX workstation that is reachable from the switch using IP. The server daemon listens to the TCP port specified in the switch side remote logging configuration. When the ATM accounting process on the switch sends a TCP connect request, the daemon accepts the connection. After connection has been established, the switch side ATM accounting process sends accounting records, as they are created, to the remote host. The remote host then receives the records and stores them in a local file. The collected ATM accounting records are in ASN1 format. The first record contains the format of the following records.

To configure remote logging, perform the following steps in global configuration mode:

	Command	Purpose
Step 1	Switch(config)# atm accounting file acctng_file1	Configures the ATM accounting file and changes to accounting file configuration mode.
Step 2	Switch(config)# remote-log [only] primary-host hostname1 tcp-port1 [alternate-host hostname2 tcp-port2]	Specifies the main and optional backup hostname or IP address and TCP port number.

The PC or workstation configured as backup takes over collection of ATM accounting records if the primary fails. Using the keyword only causes only remote logging to be performed, freeing the ATM switch router's memory for other purposes.

Example

The following example shows how to configure remote logging to a PC named eagle on port 2001, with port 2002 as a backup:

 Switch(config)# atm accounting file acctng_file1

 Switch(config-acct-file)# remote-log primary-host eagle 2001 alternate-host eagle 2002

Displaying the Remote Logging Configuration

To display the remote logging configuration, use the following privileged EXEC command:

Command	Purpose
show atm accounting	Displays the remote logging configuration.

The following example shows the remote logging 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:

     AT1/0/0

     AT2/0/0

 File Entry 1 -

     Name: acctng_file1

     Descr: atm accounting data

     Min-age (seconds): 0

     Failed_attempt : soft regular 

Table of Contents

Configuring ATM Accounting and ATM RMON

Configuring ATM Accounting

ATM Accounting Overview

Configuring Global ATM Accounting

Displaying the ATM Accounting Configuration

Enabling ATM Accounting on an Interface

Example

Displaying the ATM Accounting Interface Configuration

Example

Configuring the ATM Accounting Selection Table

Examples

Displaying ATM Accounting Selection Configuration

Example

Configuring ATM Accounting Files

Examples

Displaying the ATM Accounting File Configuration

Example

Controlling ATM Accounting Data Collection

Examples

Displaying the ATM Accounting Data Collection Configuration and Status

Example

Configuring ATM Accounting SNMP Traps

Configuring ATM Accounting Trap Generation

Example

Displaying ATM Accounting Trap Threshold Configuration

Example

Configuring SNMP Server for ATM Accounting

Example

Displaying SNMP Server ATM Accounting Configuration

Example

Using TFTP to Copy the ATM Accounting File

Example

Configuring Remote Logging of ATM Accounting Records

Example

Displaying the Remote Logging Configuration