Table of Contents
Cisco IOS CommandsCommand Reference
accounting method
accounting suppress
accounting template
acct-template
attribute acct-session-id overloaded
attribute h323-remote-id resolved
authentication method
authorization method
call accounting-template voice
call accounting-template voice reload
gw-accounting aaa
method
show call accounting-template voice
suppress
voice class aaa
voice-class aaa
Cisco IOS Commands
Command Reference
This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.2 command reference publications. All TCL verbs are documented in the TCL IVR API Version 2.0 Programmer's Guide and the VSAs are documented in the RADIUS Vendor-Specific Attributes Voice Implementation Guide.
New Commands:
- accounting method
- accounting suppress
- accounting template
- acct-template
- attribute acct-session-id overloaded
- attribute h323-remote-id resolved
- authentication method
- authorization method
- call accounting-template voice
- call accounting-template voice reload
- gw-accounting aaa
- method
- show call accounting-template voice
- suppress
- voice class aaa
- voice-class aaa
accounting method
To set an accounting method at login for calls coming into a dial peer, use the accounting method command in voice class AAA configuration mode. To disable the accounting method set at login, use the no form of this command.
- accounting method MethListName [out-bound]
- no accounting method MethListName [out-bound]
Syntax Description
Defaults
When a specific accounting method is not set at login, the system uses aaa accounting connection h323 as the default.
Command Modes
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, Cisco 5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850. |
Usage Guidelines
- This command sets the accounting method for dial peers in voice class AAA configuration mode. To initially define a method list, refer to the AAA Cisco IOS Security Configuration Guide, Release 12.2.
- When the outbound option in the command is specified, the out-bound call leg on the dial peer uses the method list name specified in the command.
- If the method list name is not specified, then by default, the out-bound call leg uses the same method list name as the inbound call leg.
Examples
Related Commands
| Command | Description |
|---|---|
|
Defines the accounting method list H.323 with RADIUS, using stop-only or start-stop accounting options. |
accounting suppress
To disable accounting that is generated automatically by a service provider module for a specific dial peer, use the accounting suppress command in voice class AAA configuration mode. To allow accounting to be automatically generated, use the no form of this command.
- accounting suppress [in-bound|out-bound]
- no accounting suppress [in-bound|out-bound]
Syntax Description
Defaults
Accounting is automatically generated by the service provider module.
Command Modes
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850. |
Usage Guidelines
- If a call leg option is not specified in the command, accounting is disabled for both in-bound and outbound calls.
- For accounting to be automatically generated in the service provider module, you must first configure gw-accounting aaa in global configuration mode before configuring dial peer based accounting in voice class AAA mode.
Examples
In the example below, accounting is suppressed for the incoming call leg.
Related Commands
| Command | Description |
|---|---|
|
Turns off accounting for a call leg on a pots or VoIP dial peer. The command is used in gw-accounting aaa configuration mode. |
accounting template
To allow each dial peer to choose and send a customized accounting template to the RADIUS server, use the accounting template command in voice class AAA configuration mode. To disable the dial peer from choosing and sending a customized accounting template, use the no form of this command.
- accounting template acctTempName [out-bound]
- no accounting template acctTempName [out-bound]
Syntax Description
Defaults
The dial peer does not choose and send a customized accounting template to the RADIUS server.
Command Modes
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850. |
Usage Guidelines
Examples
Related Commands
| Command | Description |
|---|---|
acct-template
To send a selected group of voice accounting VSAs, use the acct-template command in gateway accounting AAA configuration mode. To disable sending that selected group of voice accounting VSAs, use the no form of this command.
- acct-template {callhistory-detail | acctTempName}
- no acct-template {callhistory-detail | acctTempName}
Syntax Description
Defaults
No voice accounting VSAs are sent in gateway accounting AAA configuration mode.
Command Modes
Gateway accounting AAA configuration
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, AS5350, AS5400, AS5800, and AS5850. |
Usage Guidelines
- If you do not want to create a custom template, use the callhistory-detail command to send all voice VSAs to the accounting server. These are voice VSAs introduced in Cisco IOS releases up to Cisco IOS Release 12.2(11)T. See the RADIUS Vendor Specific Attributes Voice Implementation Guide and the Supplemental RADIUS Vendor Specific Attributes Voice Implementation Guide for the current list of attributes.
- Use the acct-template command to send only those voice VSAs that are defined in the accounting template. The accounting template is a text file that you can create by selecting specific VSAs that are applicable to your billing needs. You must first use the call accounting-template voice command to define your accounting template before using the acct-template command. See the RADIUS Vendor-Specific Attributes Voice Implementation Guide for the latest list of attributes.
- When you send only those VSAs defined in your accounting template, the default call history records that are created by the service provider are automatically suppressed.
Examples
In the example below, the acct-template command is used to create temp-glob, a custom template.
Related Commands
| Command | Description |
|---|---|
attribute acct-session-id overloaded
To overload the acct-session-id attribute with voice VSAs, use the attribute acct-session-id-overloaded command in gateway accounting AAA configuration mode. To disable overloading the acct-session-id attribute with voice VSAs, use the no form of this command.
- attribute acct-session-id overloaded
- no attribute acct-session-id overloaded
Syntax Description
There are no arguments or keywords for this command.
Defaults
The acct-session-id attribute is not overloaded with voice VSAs.
Command Modes
Gateway accounting AAA configuration
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850. |
Usage Guidelines
- acct-session-id is RADIUS attribute 44. For more information on this attribute, see the document, RADIUS attribute 44 (Accounting Session ID) in Access Requests .
- The attribute acct-session-id overloaded command replaces the gw-accounting h323 vsa command.
- Attributes that cannot be mapped to standard RADIUS attributes are packed into the acct-session-id attribute field as ASCII strings separated by the "/" character.
- The Accounting Session ID (acct-session-id) attribute contains the RADIUS account session ID, which is a unique identifier that links accounting records associated with the same login session for a user. This unique identifier makes it easy to match start and stop records in a log file.
- Accounting Session ID numbers restart at 1 each time the router is power-cycled or the software is reloaded.
Examples
Related Commands
attribute h323-remote-id resolved
To resolve the h323-remote-id attribute, use the attribute h323-remote-id resolved command in gw-accounting aaa configuration mode. To keep the h323-remote-id attribute unresolved, use the no form of this command.
- attribute h323-remote -id resolved
- no attribute h323-remote -id resolved
Syntax Description
There are no arguments or keywords for this command.
Defaults
The h323-remote-id attribute is not resolved.
Command Modes
gw-accounting aaa configuration
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, AS5350, AS5400, AS5800, and AS5850. |
Usage Guidelines
- In Cisco IOS release 12.2(11)T, the attribute h323-remote-id resolved command replaces the gw-accounting h323 resolve command, and the h323-remote-id attribute has been added as a Cisco vendor specific attribute (VSA). This attribute is a string that indicates the DNS name or locally defined host name of the remote gateway.
- You can obtain the value of the h323-remote-id attribute by doing a DNS lookup of the h323-remote-address attribute. The h323-remote-address attribute indicates the IP address of the remote gateway.
Examples
Related Commands
| Command | Description |
|---|---|
authentication method
To set an authentication method at login for calls coming into a dial peer, use the authentication method command in voice class AAA mode. To disable the authentication method set at login, use the no form of this command.
- authentication method MethListName
- no authentication method MethListName
Syntax Description
Defaults
When a specific authentication method is not set at login, the system uses aaa authentication login h323 as the default.
Command Modes
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, AS5350, AS5400, AS5800, and AS5850. |
Usage Guidelines
Examples
In the example below, dp is the method list name used for authentication. The method list name is defined during initial authentication setup.
Related Commands
| Command | Description |
|---|---|
authorization method
To set an authorization method at login for calls coming into a dial peer, use the authorization method command in voice class AAA configuration mode. To disable the authorization method set at login, use the no form of this command.
- authorization method MethListName
- no authorization method MethListName
Syntax Description
Defaults
When a specific authorization method is not set at login, the system uses aaa authorization exec h323 as the default.
Command Modes
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, AS5350, AS5400, AS5800, and AS5850. |
Usage Guidelines
Examples
Related Commands
call accounting-template voice
To select an accounting template at a specific location, use the call accounting-template voice command in global configuration mode. To remove a specific accounting template, use the no form of this command.
- call accounting-template voice acctTempName url
- no call accounting-template voice acctTempName url
Syntax Description
Defaults
Command Modes
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850. |
Usage Guidelines
- The template name must have a .cdr extension.
- To select call records based on your accounting needs, and to specify the location of an accounting template that defines the applicable vendor specific attributes (VSAs) for generating those selected call records, use the call accounting-template voice command in global configuration mode.
- acctTempName refers to a specific accounting template file that you want to send to the RADIUS server. This template file defines only specific VSAs selected by you, to allow you to control your call records based on your accounting needs.
Examples
The example below shows the accounting template cdr1 selected from a specific TFTP address.
Related Commands
| Command | Description |
|---|---|
|
Displays template status and attribute names of a specific template. |
|
|
Reloads the accounting template from the location where it is stored. |
call accounting-template voice reload
To reload the accounting template, use the call accounting-template voice reload command in privileged EXEC mode.
- call accounting-template voice reload acctTempName
Syntax Description
|
Reloads the accounting template from the address (for example, a tftp address) where the template is stored. |
|
Defaults
Command Modes
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850. |
Usage Guidelines
Examples
The example below shows how to reload accounting template cdr2.
Related Commands
gw-accounting aaa
To enable VoIP gateway accounting through the AAA system, use the gw-accounting aaa command in global configuration mode. To disable VoIP gateway accounting, use the no form of this command.
- gw-accounting aaa
- no gw-accounting aaa
Syntax Description
There are no arguments or keywords for this command.
Defaults
VoIP gateway accounting is disabled.
Command Modes
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850. |
Usage Guidelines
Examples
In the example below, gateway accounting AAA mode is first enabled before configuring the commands method, attribute acct-session-id overloaded, and attribute h323-remote-id resolved.
Related Commands
method
To set a specific accounting method list, use the method command in gateway accounting AAA configuration mode.
- method acctMethListName
Syntax Description
Defaults
h323 is the default accounting method list.
Command Modes
gw-accounting aaa configuration.
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850. |
Usage Guidelines
- For information on setting AAA network security for your network, including setting method lists, refer to the Authentication, Authorization, and Accounting Cisco IOS Security Configuration Guide, Release 12.2.
- The method command sets the accounting method globally (not for a dial peer). To initially define the AAA method list name for accounting, use the aaa accounting command.
- The argument acctMethListName in the method command is the same name used to define the method list name under the aaa accounting command.
In the example below, the method command uses the method list name klz_aaa6 which was previously defined using the AAA commands.
Related Commands
show call accounting-template voice
To view accounting template activity, use the show call accounting-template voice command in privileged EXEC mode.
- show call accounting-template voice [acctTempName | master | qdump | summary]
Syntax Description
|
Displays all VSAs that are filtered by accounting templates. |
|
|
Lists names of all the accounting templates and the number of attributes in each template currently being used. |
Defaults
Command Modes
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850. |
Usage Guidelines
- show call accounting-template voice displays the status and attributes defined in each template after it is configured.
- show call accounting-template voice acctTempName displays the status of a specific template and the attributes (VSAs) that are defined for that template.
- show call accounting-template voice master displays all the vendor specific attributes (VSAs) that can be filtered by accounting templates.
- show call accounting-template voice qdump displays template activity in the service (svc) and free queues. It displays the template URL, the number of legs on which a template is active, and the state of a template.
-
- After an accounting template is defined, it is put in the svc queue to serve new incoming calls. When a running accounting template is undefined or reloaded during an active call, the template is moved from the svc to the free queue, and can be reused after all the active calls stop referencing it. Templates that are reloaded or undefined while being referenced during an active call are considered to be in a dirty state, and are called dirty templates.
- To ensure that start and stop records correspond on an active call that is referencing a dirty template, it is necessary to keep all dirty templates alive until all active calls referencing that dirty template are released. After all the active calls are released, the reloaded templates are applied to the next call.
- show call accounting-template voice summary displays the current status of all the accounting templates that are configured. It shows if the template was loaded and running successfully.
Examples
show call accounting-template voice
show call accounting-template voice acctTempName
In this example, the command displays details about a specific template cdr1.
show call accounting-template voice master
In this example, the show call accounting-template voice master command displays all sixty four attributes that can be filtered by an accounting template.
show call accounting-template voice qdump
In the example shown below, the show call accounting-template voice qdump displays template activity in the service queue. Initially, no templates are in the dirty state.
show call accounting-template voice summary
In the example below, the show call accounting-template voice summary command displays a summary of all configured accounting templates. cdr3 is not in running mode because it has either been rejected or it does not exist at the given URL.
Table Table 3-1 describes the fields shown in the show call accounting-template voice display.
Related Commands
| Command | Description |
|---|---|
suppress
To turn off accounting for a specific call leg, use the suppress command in gateway accounting AAA configuration mode. To keep accounting for a specific call leg, use the no form of this command.
- suppress [pots][voip]
- no suppress [pots][voip]
Syntax Description
Defaults
Accounting is kept for the specified call leg. It is not turned off.
Command Modes
Gateway accounting AAA configuration
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, AS5350, AS5400, AS5800, and AS5850. |
Usage Guidelines
Examples
The example below suppresses accounting for the POTS call leg.
Related Commands
| Command | Description |
|---|---|
voice class aaa
To enable dial peer based VoIP AAA configurations, use the voice class aaa command in global configuration mode. To disable dial peer based VoIP AAA configurations, use the no form of this command.
- voice class aaa tag
- no voice class aaa tag
Syntax Description
Defaults
Command Modes
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, AS5350, AS5400, AS5800, and AS5850. |
Usage Guidelines
Examples
The example below shows AAA configurations in voice class AAA configuration mode. The number assigned to the tag is 1.
The example below shows accounting configurations in voice class AAA configuration mode.
Related Commands
voice-class aaa
To apply properties defined in the voice class to a dial peer, use the voice-class aaa command in dial peer configuration mode.
- voice-class aaa tag
Syntax Description
Defaults
Command Modes
Command History
| Release | Modification |
|---|---|
|
This command was introduced on the Cisco 3660, Cisco AS5300, Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850. |
Usage Guidelines
Examples
The example below shows redirecting AAA requests using DNIS. You define a voice class to specify the AAA methods and then use the voice-class aaa command in dial-peer mode.
Related Commands
| Command | Description |
|---|---|