Cisco IOS Intelligent Service Gateway Configuration Guide, Release 12.2 SB - Configuring ISG Accounting [Cisco IOS Software Releases 12.2 SB]

Table Of Contents

Configuring ISG Accounting

Contents

Prerequisites for ISG Accounting

Restrictions for ISG Accounting

Information About ISG Accounting

Overview of ISG Accounting

Accounting Records

Interim Accounting Updates

Broadcast Accounting

Postpaid Tariff Switching

How to Configure ISG Accounting

Enabling ISG Per-Session Accounting

Prerequisites

Enabling Per-Session Accounting in a User Profile on a AAA Server

Enabling Per-Session Accounting in a Service Profile on a AAA Server

Enabling Per-Session Accounting in a Service Policy Map on the Router

What to Do Next

Troubleshooting Tips

Enabling ISG Per-Flow Accounting

Prerequisites

Enabling Per-Flow Accounting in a Service Profile on the AAA Server

Enabling Per-Flow Accounting in a Service Policy Map on the Router

Troubleshooting Tips

What to Do Next

Configuring ISG Postpaid Tariff Switching

Prerequisites

What to Do Next

Verifying ISG Accounting and Postpaid Tariff Switching

Examples

Configuration Examples for ISG Accounting

Per-Flow Accounting: Examples

ISG Postpaid Tariff Switching: Examples

Additional References

Related Documents

Technical Assistance

Feature Information for ISG Accounting

Configuring ISG Accounting

First Published: March 20, 2006

Last Updated: March 20, 2006

Intelligent Service Gateway (ISG) is a Cisco IOS software feature set that provides a structured framework in which edge devices can deliver flexible and scalable services to subscribers.This module describes how to configure ISG accounting including per-session accounting or per-flow accounting, broadcast accounting, and postpaid tariff switching.

Finding Feature Information in This Module

Your Cisco IOS software release may not support all features. To find information about feature support and configuration and platform requirements, use the "Feature Information for ISG Accounting" section.

Contents

•Restrictions for ISG Accounting

•Information About ISG Accounting

•How to Configure ISG Accounting

•Configuration Examples for ISG Accounting

•Additional References

•Feature Information for ISG Accounting

Prerequisites for ISG Accounting

For information about release and platform support, see the "Feature Information for ISG Accounting" section.

Restrictions for ISG Accounting

Postpaid billing and tariff switching are not supported on the Cisco 10000-PRE2.

ISG accounting supports only the RADIUS protocol.

If AAA broadcast accounting is used in conjunction with periodic accounting, you cannot configure different accounting periods for different accounting groups.

Information About ISG Accounting

Before you configure ISG accounting or postpaid tariff switching, you should understand the following concepts:

•Overview of ISG Accounting

•Accounting Records

•Interim Accounting Updates

•Broadcast Accounting

•Postpaid Tariff Switching

Overview of ISG Accounting

ISG supports both per-session and per-flow accounting. Per-session accounting is the aggregate of all the flow traffic for a session. Per-session accounting can be enabled in a user profile or in a service profile or service policy map.

Per-flow accounting, which accounts for a subset of session traffic as defined by a traffic class, is enabled in a service profile or service policy map. When per-flow accounting is configured, the Parent-Session-ID vendor-specific attribute (VSA) is included in accounting records so that per-session and per-flow accounting records can be correlated in the RADIUS server.

When accounting is configured in a user profile, the service name attribute is not included in accounting records.

Session accounting is enabled if the aaa accounting network default command is configured and a AAA method list is specified. (It is recommended that you use a named method list rather than the default method list.) Flow accounting is disabled by default and will take place only if a AAA method list is specified in the service profile or service policy map. ISA accounting sends Accounting-Start, interim, and Accounting-Stop records to the specified AAA method list.

Accounting Records

ISA accounting uses the RADIUS protocol to facilitate interaction between ISG and an external RADIUS-based AAA or mediation server. ISG sends accounting records with the associated attributes to the AAA accounting method list when the following events occur: account logon, account logoff, service logon, and service logoff. The accounting server can be configured to interpret the records to generate bills for postpaid sessions.

Account Logon and Logoff

ISG sends a RADIUS Accounting-Request record to the specified AAA method list when a subscriber logs onto or off of ISG. The Acct-Status-Type attribute included in the Accounting-Request record indicates if the record marks the start (commencement) of the subscriber session or the stop (termination) of the session.

When a subscriber logs on, ISG sends an Accounting-Start record to the AAA server. When a subscriber logs off, ISG sends an Accounting-Stop record.

Service Logon and Logoff

ISG sends a RADIUS Accounting-Start record to the AAA server when a service is activated for a subscriber, and it sends an Accounting-Stop record when a service is deactivated. The record contains a different accounting session ID from the accounting session ID of the parent session.

The Acct-Status-Type attribute included in the Accounting-Request record indicates whether the record marks the start or the end of the service. The name of the service is included in accounting records for service logon and logoff.

Accounting records may be sent for events other than account and service logon and logoff. See the "Configuring Accounting" chapter of the Cisco IOS Security Configuration Guide, Release 12.2, for more information.

Interim Accounting Updates

ISG supports interim (intermittent) RADIUS accounting updates, which work the same way as "watchdog" RADIUS accounting. Accounting updates are sent between the times that ISG sends Accounting-Start and Accounting-Stop records.

ISG supports two types of interim accounting: accounting updates for new information (such as a new IP address) and periodic accounting, in which accounting records are sent at a configurable interval.

Interim accounting for new information can be enabled or disabled globally. Periodic accounting can be enabled for specific contexts, such as globally, in user profiles, and in services.

Broadcast Accounting

ISG supports AAA broadcast accounting, which is the ability to send user accounting records to multiple RADIUS servers. AAA broadcast accounting provides service providers with geographical redundancy for RADIUS servers, and provides accounting records to partners in wholesale models. For information about configuring AAA broadcast accounting, see the "Configuring Accounting" chapter in the "Authentication, Authorization, and Accounting" part of the Cisco IOS Security Configuration Guide.

Postpaid Tariff Switching

ISG postpaid tariff switching allows changes in tariffs during the lifetime of a connection. This feature applies to time-based or volume-based postpaid sessions in which the tariff changes at certain times of the day.

Typically, a service provider would use postpaid tariff switching to offer different tariffs to a subscriber while the subscriber is still connected; for example, changing a subscriber to a less expensive tariff during off-peak hours.

To handle tariff switches for postpaid connections, the accounting packets log the usage information during the various tariff-switch intervals. The service profile contains a weekly tariff-switch plan detailing the times of day at which tariff changes occur. ISG monitors the usage at every tariff-switch point and records this information in interim accounting records. The billing server monitors all interim accounting updates and obtains the information about the traffic sent at each tariff rate.

Note Tariff switching is not required for time-based billing services. Because the billing server knows the service logon time stamp and logoff time stamp, it can calculate the various tariffs that apply during that time.

How to Configure ISG Accounting

Perform one or more of the following tasks to configure ISG accounting:

•Enabling ISG Per-Session Accounting

•Enabling ISG Per-Flow Accounting

•Configuring ISG Postpaid Tariff Switching

•Verifying ISG Accounting and Postpaid Tariff Switching

Enabling ISG Per-Session Accounting

Per-session accounting can be configured in the following configuration sources:

•User profile on a AAA server

•Service profile on a AAA server

•Service policy map on the ISG device

This procedure contains the following sections:

•Prerequisites

•Enabling Per-Session Accounting in a User Profile on a AAA Server

•Enabling Per-Session Accounting in a Service Profile on a AAA Server

•Enabling Per-Session Accounting in a Service Policy Map on the Router

•What to Do Next

•Troubleshooting Tips

Prerequisites

ISG sends accounting records to the authentication, authorization, and accounting (AAA) method list specified in the user profile, service profile, or service policy map. The tasks in this section assume that you have configured a AAA method list by using the aaa accounting command. See the Cisco IOS Security Command Reference for more information.

AAA servers must be configured to support ISG accounting.

Enabling Per-Session Accounting in a User Profile on a AAA Server

Use the attributes in this procedure to enable per-session accounting in a user profile on a AAA server. When accounting is configured in the user profile instead of the service profile, the Service Name attribute does not appear in the accounting

SUMMARY STEPS

1. Cisco-Avpair="accounting-list=<accounting_mlist_name>"

2. IETF RADIUS attribute Acct-Interim-Interval (attribute 85)

DETAILED STEPS

Step 1 Cisco-Avpair="accounting-list=<accounting_mlist_name>"

Add the Accounting attribute to the user profile. This attribute enables accounting and specifies the AAA method list to which accounting updates will be sent.

Step 2 IETF RADIUS attribute Acct-Interim-Interval (attribute 85)

(Optional) Add the Acct-Interim-Interval (attribute 85) to the user profile. This attribute specifies the number of seconds between interim updates.

Enabling Per-Session Accounting in a Service Profile on a AAA Server

Use the attributes in this procedure to enable per-session accounting in a service profile on a AAA server. Note that for per-session accounting, the traffic class attribute should not be included in the service profile.

SUMMARY STEPS

1. Cisco-Avpair="accounting-list=<accounting_mlist_name>"

2. IETF RADIUS attribute Acct-Interim-Interval (attribute 85)

DETAILED STEPS

Step 1 Cisco-Avpair="accounting-list=<accounting_mlist_name>"

Add the Accounting attribute to the service profile. This attribute enables accounting and specifies the AAA method list to which accounting updates will be sent.

Step 2 IETF RADIUS attribute Acct-Interim-Interval (attribute 85)

(Optional) Add the Acct-Interim-Interval (attribute 85) to the service profile. This attribute specifies the number of seconds between interim updates.

Enabling Per-Session Accounting in a Service Policy Map on the Router

To configure per-session accounting in a service policy map on the router, you must configure an empty traffic class map (a traffic class map that does not specify an access list) and enable accounting within the empty traffic class in a service policy map. Perform this task to enable per-session accounting in a service policy map.

SUMMARY STEPS

1. enable

2. configure terminal

3. class-map type traffic match-any class-map-name

4. exit

5. policy-map type service policy-map-name

6. [priority] class type traffic class-map-name

7. accounting aaa list AAA-method-list

DETAILED STEPS

Command or Action

Purpose

Step 1

enable
Example:

Router> enable

Enables privileged EXEC mode.

•Enter your password if prompted.

Step 2

configure terminal
Example:

Router# configure terminal

Enters global configuration mode.

Step 3

class-map type traffic match-any class-map-name
Example:

Router(config)# class-map type traffic match-any empty_class

Creates or modifies a traffic class map, which is used for matching packets to a specified ISG traffic class.

•For per-session accounting, create an empty traffic class map, that is, a traffic class map that does not specify an access list for matching traffic.

Step 4

exit
Example:

Router(config-traffic-classmap)# exit

Exit traffic class map configuration mode.

Step 5

policy-map type service policy-map-name
Example:

Router(config)#

Creates or defines a service policy map, which is used to define an ISG service.

Step 6

[priority] class type traffic class-map-name
Example:

Router(config-service-policymap)# class type traffic empty_class

Specifies a named traffic class whose policy you want to create or change.

•In this step, reference the empty traffic class map that you created in step 3.

Step 7

accounting aaa list AAA-method-list
Example:

Router(config-service-policymap-class-traffic)# accounting aaa list list1

Enables accounting and specifies the AAA method list to which accounting updates will be sent.

What to Do Next

You may want to configure a method of activating the service policy map or service profile; for example, control policies can be used to activate services. For more information about methods of service activation, see the module "Configuring ISG Subscriber Services."

Troubleshooting Tips

The following commands can be used to troubleshoot ISG accounting:

•debug aaa accounting

•debug radius [brief ]

•debug subscriber feature name accounting {event | error | detail}

Enabling ISG Per-Flow Accounting

ISG per-flow accounting can be configured in the following configuration sources:

•Service profile on a AAA server

•Service policy map on the ISG device

This procedure contains the following sections:

•Prerequisites

•Enabling Per-Flow Accounting in a Service Profile on the AAA Server

•Enabling Per-Flow Accounting in a Service Policy Map on the Router

•Troubleshooting Tips

•What to Do Next

Prerequisites

ISG sends accounting records to the authentication, authorization, and accounting (AAA) method list specified in the user profile, service profile, or service policy map. The tasks in this section assume that you have configured a AAA method list by using the aaa accounting command. See the Cisco IOS Security Command Reference for more information.

AAA servers must be configured to support ISG accounting.

Enabling Per-Flow Accounting in a Service Profile on the AAA Server

Perform this task to configure per-flow accounting in a service profile on the AAA server.

Prerequisites

This task assumes that you have defined IP access lists for specifying traffic.

SUMMARY STEPS

1. Cisco-AVpair = "ip:traffic-class={in | out} access-group [<acl_number> | name <acl_name>] [priority <n>]"

2. Cisco-Avpair="accounting-list=<accounting_mlist_name>"

3. IETF RADIUS attribute Acct-Interim-Interval (attribute 85)

DETAILED STEPS

Step 1 Cisco-AVpair = "ip:traffic-class={in | out} access-group [<acl_number> | name <acl_name>] [priority <n>]"

Add the ISG Traffic Class attribute to the service profile. This attribute specifies input and output traffic to which the service will apply. Both an input and output traffic classifier can be added to a service profile.

Step 2 Cisco-Avpair="accounting-list=<accounting_mlist_name>"

Add the Accounting attribute to the service profile on the AAA server. This attribute enables accounting and specifies the AAA method list to which accounting updates will be sent. The AAA method list must be configured.

Note If this attribute is configured in a service profile that does not include a traffic class, accounting is performed on the session rather than the flow.

Step 3 IETF RADIUS attribute Acct-Interim-Interval (attribute 85)

(Optional) Add the IETF RADIUS attribute Acct-Interim-Interval (attribute 85) to the service profile on the AAA server. This attribute specifies the number of seconds between interim updates.

Enabling Per-Flow Accounting in a Service Policy Map on the Router

Perform this task to enable accounting in a local service policy map for a specific flow.

Prerequisites

This task assumes that you have defined a traffic class map and associated IP access lists. See the module "Configuring ISG Subscriber Services" for more information about configuring traffic classes.

SUMMARY STEPS

1. enable

2. configure terminal

3. policy-map type service policy-map-name

4. [priority] class type traffic class-map-name

5. accounting aaa list AAA-method-list

DETAILED STEPS

Command or Action

Purpose

Step 1

enable
Example:

Router> enable

Enables privileged EXEC mode.

•Enter your password if prompted.

Step 2

configure terminal
Example:

Router# configure terminal

Enters global configuration mode.

Step 3

policy-map type service policy-map-name
Example:

Router(config)# policy-map type service service1

Creates or defines a service policy map, which is used to define an ISG service.

Step 4

[priority] class type traffic class-map-name
Example:

Router(config-service-policymap)# class type traffic firstclass

Associates a previously configured traffic class with the policy map.

Step 5

accounting aaa list AAA-method-list
Example:

Router(config-control-policymap-class-traffic)# accounting aaa list list1

Enables accounting and specifies the AAA method list to which accounting updates will be sent.

•The AAA method list must be configured.

Troubleshooting Tips

The following commands can be used to troubleshoot ISG accounting:

•debug aaa accounting

•debug radius [brief ]

•debug subscriber feature name accounting {event | error | detail}

What to Do Next

You may want to configure a method of activating the service policy map or service profile; for example, control policies can be used to activate services. For more information about methods of service activation, see the module "Configuring ISG Subscriber Services."

Configuring ISG Postpaid Tariff Switching

ISG postpaid tariff switching can be configured in the following configuration source:

•Service Profile on a AAA server

If you include a traffic class in the service profile, postpaid tariff switching will apply to the specified flow. If you do not configure a traffic class, postpaid tariff switching will apply to the session. Perform this task to configure per-session or per-flow postpaid tariff switching.

Prerequisites

ISG per-session or per-flow accounting must be configured in order for postpaid tariff switching to work.

SUMMARY STEPS

1. Cisco-AVpair = "PPWhh:mm:ss:days"

2. Cisco-AVpair = "ip:traffic-class={in | out} access-group [<acl_number> | name <acl_name>] [priority <n>]"

DETAILED STEPS

Step 1 Cisco-AVpair = "PPWhh:mm:ss:d"

Add the Post Paid Vendor-Specific Attribute (VSA) to the service profile. This attribute specifies the weekly tariff-switch points for postpaid tariff switching. The syntax description follows:

hh:mm:ss:d—Weekly tariff-switch time.

•hh = hour of day <0-23>

•mm = minutes <0-59>

•ss = seconds <0-59>

•d = bitmap format for the days of week. Each weekday is represented by one bit, as follows:

00000001 = Monday

00000010 = Tuesday

00000100 = Wednesday

00001000 = Thursday

00010000 = Friday

00100000 = Saturday

01000000 = Sunday

Step 2 Cisco-AVpair = "ip:traffic-class={in | out} access-group [<acl_number> | name <acl_name>] [priority <n>]"

Add the ISG Traffic Class attribute to the service profile. This attribute specifies input and output traffic to which the service will apply. Both an input and output traffic classifier can be added to a service profile.

What to Do Next

You may want to configure a method of activating the service policy map or service profile; for example, control policies can be used to activate services. For more information about methods of service activation, see the module "Configuring ISG Subscriber Services."

Verifying ISG Accounting and Postpaid Tariff Switching

Perform this task to verify ISG accounting and postpaid tariff switching configuration.

SUMMARY STEPS

1. enable

2. show subscriber session [detailed] [identifier identifier | uid session-id | username name]

DETAILED STEPS

Command or Action

Purpose

Step 1

enable
Example:

Router> enable

Enables privileged EXEC mode.

•Enter your password if prompted.

Step 2

show subscriber session [detailed] [identifier identifier | uid session-id | username name]
Example:

Router# show subscriber session

Displays ISG subscriber session information.

Examples

This section contains the examples of output for the show subscriber session command.

show subscriber session Output When ISG Accounting Is Applied to a Flow

In the following example, ISG accounting is configured in a service profile that specifies a traffic class, which means that accounting will be performed on the flow and not the parent session. In this example, 157 is the unique ID of the traffic class.
Router# show subscriber session uid 157 detailed
Subscriber session handle: E5000092, state: connected, service: Ltm Internal
Unique Session ID: 157
Identifier:
SIP subscriber access type(s): Traffic-Class
Root SIP Handle: 2B000011, PID: 76
Current SIP options: Req Fwding/Req Fwded
Session Up-time: 3 minutes, 45 seconds, Last Changed: 3 minutes, 45 seconds
AAA unique ID: 0
Switch handle: F300015F
Session inbound features:
Feature: Service accounting
 Service: video1
 Method List: remote-local
 Outbound direction:
        Packets = 84, Bytes = 33600
Feature: Policing
 Upstream Params:
Average rate = 8000, Normal burst = 1500, Excess burst = 3000
Config level = Service
Session outbound features:
Feature: Service accounting
 Service: video1
 Method List: remote-local
 Outbound direction:
        Packets = 84, Bytes = 33600
Feature: Policing
 Dnstream Params:
Average rate = 64000, Normal burst = 12000, Excess burst = 24000
Config level = Service
Configuration sources associated with this session:
Service: video1, Active Time = 3 minutes, 46 seconds
show subscriber session Output When ISG Accounting Is Applied to a Session

The following example shows sample output for the show subscriber session command for a session rather than a flow.
Router# show subscriber session uid 730 detailed
Subscriber session handle: 3800009A, state: connected, service: Local Term
Unique Session ID: 730
Identifier: igq2acct
SIP subscriber access type(s): IP-Interface/Account-Logon-CH
Root SIP Handle: A600000E, PID: 75
Child SIP Handle: F9000018, PID: 73
Current SIP options: Req Fwding/Req Fwded
Session Up-time: 3 minutes, 57 seconds, Last Changed: 2 minutes, 59 seconds
AAA unique ID: 81
Switch handle: 890003A0
Interface: ATM6/0.1
Policy information:
  Authentication status: authen
  Config downloaded for session policy:
  From Access-Type: Account-Logon-CH, Client: SM, Event: Got More Keys
    Profile name: apply-config-only, 2 references
      ssg-account-info     "SAfoo"
  Rules, actions and conditions executed:
    subscriber rule-map rule1
      condition always event any-event
        action 1 authenticate
Session inbound features:
Feature: Session accounting
 Method List: foo
 Outbound direction:
        Packets = 10, Bytes = 1000
Session outbound features:
Feature: Session accounting
 Method List: foo
 Outbound direction:
        Packets = 10, Bytes = 1000
Configuration sources associated with this session:
Interface: ATM6/0.1, Active Time = 3 minutes, 58 seconds
Configuration Examples for ISG Accounting

This section contains the following examples:

•Per-Flow Accounting: Examples

•ISG Postpaid Tariff Switching: Examples

Per-Flow Accounting: Examples

Per-Flow Accounting Configured in a Local Service Policy Map

The following example shows per-flow accounting configured in a service policy map for a service called "video1".
class-map type traffic match-any video1
 match access-group output 101
 match access-group input 100
policy-map type service video1
 class type traffic video1
  accounting aaa list mlist1
Per-Flow Accounting Configured in a Service Profile on the AAA Server

The following example shows per-flow accounting configured in a remote service profile for a service called "video1".
video1        Password = "cisco"
   Cisco-AVpair = "traffic-class=input access-group 101 priority 20",
   Cisco-AVpair = "traffic-class=output access-group 112 priority 20",
   Cisco-Avpair = "accounting-list=remote-local",
   Service-Info = "QU;8000",
   Service-Info = "QD;64000"
ISG Postpaid Tariff Switching: Examples

The following example shows the configuration of a postpaid tariff switch each day of the week at midnight.
Cisco-AVpair = "PPW00:00:00:127" 
The following example shows the configuration of a postpaid tariff switch Monday through Friday at 8:00 p.m.
Cisco-AVpair = "PPW20:00:00:31" 
The following example shows the configuration of a postpaid tariff switch Monday through Friday at 6:00 a.m.
Cisco-AVpair = "PPW06:00:00:31" 
Additional References

The following sections provide references related to ISG accounting.

Related Documents

Related Topic

Document Title

ISG commands

Intelligent Service Gateway Command Reference

AAA configuration tasks

The "Authentication, Authorization, and Accounting (AAA)" section in the Cisco IOS Security Configuration Guide, Release 12.2

AAA commands

The "Authentication, Authorization, and Accounting (AAA) section in the Cisco IOS Security Command Reference, Release 12.2

Technical Assistance

Description

Link

Technical Assistance Center (TAC) home page, containing 30,000 pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.

http://www.cisco.com/public/support/tac/home.shtml

Feature Information for ISG Accounting

Table 15 lists the features in this module and provides links to specific configuration information. Only features that were introduced or modified in Cisco IOS Release 12.2(28)SB or later releases appear in the table. If you are looking for information on a feature in this technology that is not documented here, see the "Intelligent Service Gateway Features Roadmap."

Not all commands may be available in your Cisco IOS software release. For details on when support for specific commands was introduced, see the command reference documents.

Cisco IOS software images are specific to a Cisco IOS software release, a feature set, and a platform. Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.

Note Table 15 list only the Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS software release train also support that feature.

Table 15 Feature Information for ISG Accounting

Feature Name

Releases

Feature Configuration Information

ISG: Accounting: Per Session, Service, and Flow

12.2(28)SB

ISG accounting provides the means to bill for account or service usage. ISG accounting uses the RADIUS protocol to facilitate interaction between ISG and an external RADIUS-based AAA or mediation server.

The following sections provide information about this feature:

•Information About ISG Accounting

•How to Configure ISG Accounting

ISG: Accounting: Postpaid

12.2(28)SB

ISG accounting provides the means to bill for account or service usage. ISG sends accounting start and stop records for sessions and services to an accounting server for postpaid billing. The accounting server interprets the records to generate bills.

The following sections provide information about this feature:

•Information About ISG Accounting

•How to Configure ISG Accounting

ISG: Accounting: Tariff Switching

12.2(28)SB

ISG accounting provides the means to bill for account or service usage. Where billing rates change at fixed times and sessions are active across the boundary at which the rates change, ISG will provide accounting data to the billing server indicating the boundary. Tariff switching can also be used between accounting methods, such as switching from prepaid billing to postpaid billing.

•Postpaid Tariff Switching

•Enabling Per-Flow Accounting in a Service Policy Map on the Router

Copyright © 2006 Cisco Systems, Inc. All rights reserved.