|
|
This document introduces the Call Tracker feature and a set of ISDN and authentication, authorization, and accounting (AAA) enhancements to expand the call handling and real-time monitoring capabilities of the Cisco AS5300 and Cisco AS5800 universal access servers. The Call Tracker feature captures detailed statistics on the status and progress of active calls and retains historical data for disconnected call sessions. Call Tracker collects session information such as call states and resources, traffic statistics, total bytes transmitted and received, user IP address, and disconnect reason. This data is maintained within the Call Tracker database tables, accessible through SNMP, CLI , or SYSLOG.
The ISDN enhancements provide additional call-handling functionality for incoming ISDN calls, including a timer for authentication responses, an override for ISDN cause codes, and a flag indicating support for B-channel busyouts. The AAA enhancements include authentication by dialed number identification service (DNIS), selective termination of call sessions, and expanded support for several RADIUS attributes.
This document includes the following sections:
This feature set provides additional call handling and monitoring functionality in these areas:
MIBs
CISCO-CALL-TRACKER-MIB
CISCO-CALL-TRACKER-MODEM-MIB
CISCO-CALL-TRACKER-TCP-MIB
CISCO-MODEM-MGMT-MIB
CISCO-POP-MGMT-MIB
CISCO-IPMROUTE-MIB
For descriptions of supported MIBs and how to use MIBs, see Cisco's MIB web site on CCO at: http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
RFCs
RADIUS Extensions (draft-ietf-radius-ext04.txt)
Before configuring Call Tracker and its associated features, you must complete the following tasks on your network access server:
 |
Note This is only valid if you are using Call Tracker via SNMP. |
Perform the following tasks to configure Call Tracker and its related features:
To configure Call Tracker, perform the following tasks in global configuration mode:
| Command | Purpose | |
|---|---|---|
Step 1 | | Enter global configuration mode. You have entered global configuration mode when the prompt changes to 5300(config)#. |
Step 2 | 5300(config)# calltracker enable | Enable Call Tracker. |
Step 3 | 5300(config)# calltracker history max-size number | Set the maximum call entries to store in the Call Tracker history table. |
Step 4 | 5300(config)# calltracker history retain-mins minutes | Set the number of minutes that calls are stored in the Call Tracker history table. |
Step 5 | 5300(config)# calltracker call-record <terse|verbose> [quiet] | Enable Call Tracker SYSLOG support for generating detailed Call Records. |
Step 6 | 5300(config)# snmp-server packetsize byte-count | Set the maximum packet size allowed for SNMP server requests and replies. |
Step 7 | 5300(config)# snmp-server queue-length length | Set the queue length for SNMP traps. |
Step 8 | 5300(config)# snmp-server enable traps calltracker | Enable Call Tracker to send traps whenever a call starts or ends. |
Step 9 | 5300(config)# snmp-server host host community-string | Specify the name or Internet address of the host to send Call Tracker traps. |
Step 10 | 5300# show call calltracker summary | Verify the Call Tracker configuration and current status. |
To poll modem-link statistics, perform the following tasks in global configuration mode:
|
Note The modem link-info poll time command consumes a significant amount of memory, approximately 500 bytes for each MICA modem call. Use this command only if you require the specific data that it collects; for instance, if you have enabled Call Tracker on your access server. |
| Command | Purpose | |
|---|---|---|
Step 1 | | Enter global configuration mode. |
Step 2 | 5300(config)# modem link-info poll time seconds | Set the polling interval at which link statistics for active calls are retrieved from the modem. |
To configure AAA to include the Acct-Session-ID in Access-Request packets, perform the following tasks in global configuration mode:
| Command | Purpose | |
|---|---|---|
Step 1 | | Enter global configuration mode. |
Step 2 | 5300(config)# radius-server attribute 44 include-in-access-req | Include the Acct-Session-Id attribute in Access-Request packets. |
|
Note The format of a user profile depends on the specific RADIUS server that you are using. The following user profile examples are included to help illustrate Cisco IOS functionality; they are not intended to demonstrate the actual configuration of your RADIUS server. |
To enable the network access server to attempt more than one login host when trying to connect a dial-in user, you can enter up to three Login-IP-Host entries in the user's profile on the RADIUS server. The following example shows that three Login-IP-Host instances have been configured for the user joeuser, and that TCP-Clear will be used for the connection:
joeuser Password = xyz
Service-Type = Login,
Login-Service = TCP-Clear,
Login-IP-Host = 10.0.0.0,
Login-IP-Host = 10.2.2.2,
Login-IP-Host = 10.255.255.255,
Login-TCP-Port = 23
The order in which the hosts are entered is the order in which they are attempted. Use the ip tcp synwait-time command to set the seconds that the network access server waits before trying to connect to the next host on the list; otherwise, it waits 30 seconds.
|
Note Your RADIUS server might permit more than three Login-IP-Host entries; however, the network access server supports only three hosts in Access-Accept packets. |
To control whether a user's responses to Access-Challenge packets are echoed to the screen, the Prompt attribute can be configured in the user's profile on the RADIUS server. This attribute is included only in Access-Challenge packets. The following example shows the Prompt attribute set to No-Echo, which prevents the user's responses from echoing:
joeuser Password = xyz
Service-Type = Login,
Login-Service = Telnet,
Prompt = No-Echo,
Login-IP-Host = 172.31.255.255
To allow a user's responses to echo, set the attribute to Echo. If the Prompt attribute is not included in the user profile, responses are echoed by default.
This attribute overrides the behavior of the radius-server challenge-noecho command configured on the access server. For example, if the access server is configured to suppress echoing, but the individual user's profile allows echoing, then the user's responses are echoed.
|
Note To use the Prompt attribute, your RADIUS server must be configured to support Access-Challenge packets. |
To configure DNIS authentication, perform the following tasks in global configuration mode:
| Command | Purpose | |
|---|---|---|
Step 1 | | Enter global configuration mode. |
Step 2 | 5300(config)# aaa preauth | Enter AAA pre-authentication mode. |
Step 3 | 5300(config-preauth)# group {radius | tacacs+ | server-group}
| (Optional) Select the security server to use for AAA pre-authentication requests. The default is RADIUS. |
Step 4 | 5300(config-preauth)# dnis [password string] | Enable pre-authentication using DNIS and optionally specify a password to use in Access-Request packets. |
To configure POD, perform the following tasks in global configuration mode:
| Command | Purpose | |
|---|---|---|
Step 1 | | Enter global configuration mode. |
Step 2 | 5300(config)# aaa accounting network default start-stop radius | Enable AAA accounting records. |
Step 3 | 5300(config)# aaa accounting delay-start | Delay generation of the start accounting record until the Framed-IP-Address is assigned, allowing its use in the POD packet. |
Step 4 | 5300(config)# aaa pod server server-key string | Enable POD reception. |
Step 5 | 5300(config)# radius-server host IP address non-standard | Declare a RADIUS host that uses a vendor-proprietary version of RADIUS. |
To allow the busyout of individual ISDN PRI B channels, perform the following tasks in interface configuration mode:
| Command | Purpose | |
|---|---|---|
Step 1 | 5300(config)# interface serial controller:timeslot | Enter interface configuration mode for a D-channel serial interface. |
Step 2 | 5300(config-if)# | Allow the busyout of individual PRI B channels via SNMP. |
To configure ISDN cause code overrides, perform the following tasks in interface configuration mode:
| Command | Purpose | |
|---|---|---|
Step 1 | 5300(config)# interface serial controller:timeslot | Enter interface configuration mode for a D-channel serial interface. |
Step 2 | 5300(config-if)# | Specify an ISDN cause code to send to the switch. |
To configure the ISDN guard timer, perform the following tasks in interface configuration mode:
| Command | Purpose | |
|---|---|---|
Step 1 | 5300(config)# interface serial controller:timeslot | Enter interface configuration mode for a D-channel serial interface. |
Step 2 | 5300(config-if)# isdn guard-timer msecs | Enable the guard timer and set the number of milliseconds that the access server waits for RADIUS to respond before rejecting or accepting (optional) a call. |
To configure IP multicast heartbeat, perform the following tasks in global configuration mode:
| Command | Purpose | |
|---|---|---|
Step 1 | 5300# config term | Enter global configuration mode. |
Step 2 | 5300(config)# ip multicast-routing | Enables IP multicast routing. |
Step 3 | 5300(config)# snmp-server host host traps community-string | Specifies the recipient of an SNMP notification operation. |
Step 4 | 5300(config)# snmp-server enable traps ipmulticast | Enables the router to send IP mulitcast traps. |
Step 5 | 5300(config)# ip multicast heartbeat interface group minimum | Enables the monitoring of the health of multicast delivery. |
To verify that the Call Tracker feature is configured properly, perform these tasks:
5300-UUT# show call calltracker summary
Call Tracker Status:
Active Table:
- 7 call(s)
- 4473 bytes used (639 average, 639 maximum)
History Table:
- 50 of a maximum of 240 call(s) (20% full)
- 45157 bytes used (903 average, 921 maximum)
- 260000 minute(s) call retain time
API Front-end:
- event elements:512 total, 512 free, 0 in-use
- free event elements' low watermark:467
- events dropped due to unavailability of free elts:0
|
Note For a description of each output display field, see the show call calltracker summary command reference page. |
To verify that other features are configured correctly, enter the show running-config command.
The following examples display the screen output using the show running-config command:
! calltracker enable calltracker call-record terse calltracker history max-size 50 calltracker history retain-mins 5000 ! snmp-server engineID local 0012345 snmp-server community public RW snmp-server community private RW snmp-server community wxyz123 view v1default RO snmp-server trap-source FastEthernet0 snmp-server packetsize 17940 snmp-server queue-length 200 snmp-server location SanJose snmp-server contact Bob snmp-server enable traps snmp snmp-server enable traps calltracker snmp-server enable traps isdn call-information snmp-server enable traps hsrp snmp-server enable traps config snmp-server enable traps entity snmp-server enable traps envmon snmp-server enable traps bgp snmp-server enable traps ipmulticast-heartbeat snmp-server enable traps rsvp snmp-server enable traps frame-relay snmp-server enable traps rtr snmp-server enable traps syslog snmp-server enable traps dlsw snmp-server enable traps dial snmp-server enable traps dsp card-status snmp-server enable traps voice poor-qov snmp-server host 10.255.255.255 wxyz123 snmp-server host 10.0.0.0 xxxyyy calltracker ! radius-server host 172.16.0.0 auth-port 1645 acct-port 1646 non-standard radius-server key xyz !
! ip multicast-routing ! snmp-server host 224.1.0.1 traps public snmp-server enable traps ipmulticast ip multicast heartbeat ethernet0 224.1.1.1 1 1 10
! clock timezone PDT -8 clock summer-time PDT recurring calltracker enable calltracker history retain-mins 10 modem link-info poll time 300 ip subnet-zero no ip domain-lookup ip host jjjxxx 192.168.255.255 ip host xxxyyy 172.31.255.255 ip domain-name cisco.com ! isdn switch-type primary-5ess chat-script dial ABORT ERROR ABORT BUSY ABORT "NO CARRIER" TIMEOUT 30 "" at OK " mta receive maximum-recipients 0 partition flash 2 8 8 !
! aaa new-model aaa authentication login CONSOLE none aaa authentication login RADIUS-LIST group radius local aaa authentication ppp default local aaa authentication ppp RADIUS-LIST group radius aaa authorization exec RADIUS-LIST group radius if-authenticated aaa authorization exec CONSOLE none aaa authorization network RADIUS-LIST group radius if-authenticated aaa accounting suppress null-username aaa accounting delay-start aaa accounting network default start-stop group radius aaa configuration config-username pools-ISP-r2 password ascend aaa nas port extended enable secret 5 $ABCxyz ! radius-server configure-nas radius-server host 172.16.0.0 auth-port 1645 acct-port 1646 non-standard radius-server timeout 15 radius-server attribute 6 on-for-login-auth radius-server attribute 44 include-in-access-req no radius-server attribute nas-port radius-server key cisco radius-server vsa send accounting radius-server vsa send authentication !
! aaa new-model aaa authentication login CONSOLE none aaa authentication login RADIUS_LIST group radius aaa authentication login TAC_PLUS group tacacs+ enable aaa authentication login V.120 none aaa authentication enable default enable group tacacs+ aaa authentication ppp RADIUS_LIST if-needed group radius aaa authorization exec RADIUS_LIST group radius if-authenticated aaa authorization exec V.120 none aaa authorization network default group radius if-authenticated aaa authorization network RADIUS_LIST if-authenticated group radius aaa authorization network V.120 group radius if-authenticated aaa accounting suppress null-username aaa accounting exec default start-stop group radius aaa accounting commands 0 default start-stop group radius aaa accounting network default start-stop group radius aaa accounting connection default start-stop group radius aaa accounting system default start-stop group radius aaa preauth dnis password Cisco-DNIS aaa nas port extended ! radius-server configure-nas radius-server host 10.0.0.0 auth-port 1645 acct-port 1646 non-standard radius-server host 10.255.255.255 auth-port 1645 acct-port 1646 non-standard radius-server retransmit 2 radius-server deadtime 1 radius-server attribute nas-port format c radius-server unique-ident 18 radius-server key MyKey !
! aaa new-model aaa authentication ppp default radius aaa accounting network default start-stop radius aaa accounting delay-start aaa pod server server-key xyz123 radius-server host 172.16.0.0 non-standard radius-server key rad123 !
! interface Serial0:23 ip address 172.16.0.0 192.168.0.0 no ip directed-broadcast encapsulation ppp no keepalive dialer idle-timeout 400 dialer load-threshold 1 either dialer-group 1 isdn switch-type primary-5ess isdn incoming-voice modem isdn snmp busyout b-channel no fair-queue no cdp enable !
! interface Serial0:23 no ip address no ip directed-broadcast encapsulation ppp dialer rotary-group 0 isdn switch-type primary-5ess isdn incoming-voice modem isdn disconnect-cause 17 isdn guard-timer 3000 on-expiry accept isdn calling-number 8005551234 no fair-queue no cdp enable !
This section documents new and modified commands. All other commands used with these features are documented in the Cisco IOS Release 12.1 command references.
New Commands
Modified Commands
To enable inbound user sessions to be disconnected when specific session attributes are presented, use the aaa pod server command. Enter the no form of this command to disable this feature.
aaa pod server [port port number] [auth-type {any | all | session-key}] server-key string
Syntax Description
port port number (Optional) The network access server port to use for POD requests. If no port is specified, port 1700 is used. auth-type (Optional) The type of authorization required for disconnecting sessions. any Session that matches all of the attributes sent in the POD packet is disconnected. The POD packet may contain one or more of four key attributes (user-name, framed-IP-address, session-ID, and session-key). all Only a session that matches all four key attributes is disconnected. All is the default. session-key Session with a matching session-key attribute is disconnected. All other attributes are ignored. string The secret text string that is shared between the network access server and the client workstation. This secret string must be the same on both systems.
Defaults
The POD server function is disabled.
Command Modes
Global configuration
Command History
12.1(2)XH This command was introduced.
Release
Modification
Usage Guidelines
To disconnect a session, the values in one or more of the key fields in the POD request must match the values for a session on one of the network access server's ports. Which values must match depends on the auth-type attribute defined in the command. If no auth-type is specified, then all four values must match. If no match is found, all connections remain intact and an error response is returned. The key fields are as follows:
Examples
The following example enables POD and sets the secret key to ab9123.
aaa pod server server-key ab9123
Related Commands
Displays debug messages for POD packets. aaa authentication Enables authentication. aaa accounting Enables accounting records. aaa accounting delay-start Delays generation of the start accounting record until the user IP address is established. radius-server host Identifies a RADIUS host.
Command
Description
To enable AAA pre-authentication, use the aaa preauth command. Use the no form of this command to disable AAA pre-authentication.
aaa preauthSyntax Description
This command has no keywords or arguments.
Defaults
Pre-authentication using DNIS is disabled.
Command Modes
Global configuration
Command History
12.1(2)XH This command was introduced.
Release
Modification
Usage Guidelines
Use the aaa preauth command to enter AAA pre-authentication mode and enable pre-authentication using DNIS. In this mode, you can specify pre-authentication using the dnis subcommand and select the security server that provides authentication using the group subcommand.
Examples
The following example enables DNIS pre-authentication using a RADIUS server and the password Ascend-DNIS:
aaa preauth dnis password Ascend-DNIS
Related Commands
Enables AAA pre-authentication using DNIS. Selects the security server to use for AAA pre-authentication. Enables a timer for AAA server requests.
Command
Description
To enable Call Record SYSLOG generation for the purpose of debugging, monitoring, or externally saving detailed call record information, use the calltracker call-record command. Use the no form of this command to disable Call Record SYSLOG generation.
calltracker call-record <terse | verbose> [quiet]
Syntax Description
terse Generates a brief set of call-records containing a subset of the data stored within Call Tracker used primarily to manage calls. verbose Generates a complete set of call-records containing all of the data stored within Call Tracker used primarily to debug calls. quiet (Optional) Call Record will be sent only to configured SYSLOG server and not to console
Defaults
Call Tracker Call Record logging is disabled.
Command Modes
Global configuration
Related Commands
12.1(2)XH This command was introduced.
Release
Modification
Usage Guidelines
SYSLOG Call Records will be generated in the order of 10 seconds of call termination. A small delay is needed to ensure that all subsystems finish reporting all appropriate information upon call termination. Furthermore, the process of logging is considered a very low priority with respect to normal call processing and data routing. As such, logging all call records can be guaranteed if Call Tracker is properly configured. However, the delay from the time a call actually terminated may vary if the CPU is busy handling higher-priority processes.
Call Tracker records must be found within the History table for at least 1 minute after call termination for this capability to work. As such, one must ensure that Call Tracker history collection is not disabled with the calltracker history configuration options.
Since the call rates possible on a high-capacity Access Server can be rather large and the information provided by the Call Records is substantial, simply enabling normal SYSLOG Call Records can make the use of the console difficult from the volume of records. As such, by using the quiet option and having a SYSLOG server configured to capture the Call Records, the console can be freed from displaying any Call Records, yet still have the Call Records captured by a SYSLOG server.
Currently, five different informational logs are available:
Examples
The following example reports the Verbose Call Records for a normal modem call termination:
*Nov 16 18:30:26.097: %CALLTRKR-3-CALL_RECORD: ct_hndl=5, service=PPP, origin=Answer, category=Modem, DS0 slot/cntr/chan=0/0/22, called=71071, calling=6669999, resource slot/port=1/0, userid=maverick5200, ip=192.9.1.2, mask=255.255.255.0, account id=5, setup=10/16/1999 18:29:20, conn=0.10, phys=17.12, srvc=23.16, auth=23.16, init-rx/tx b-rate=31200/33600, rx/tx chars=246/161, time=53.50, disc subsys=ModemDrvr, disc code=0xA220, disc text= Rx (line to host) data flushing - not OK/EC condition - locally detected/received DISC frame -- normal LAPM termination *Nov 16 18:30:26.097: %CALLTRKR-3-MODEM_CALL_REC: ct_hndl=5, prot: last=LAP-M, attempt=LAP-M, comp: last=V.42bis-Both, supp= V.42bis-RX V.42bis-TX, std: last=V.34+, attempt=V.34+, init=V.34+, snr=38, sq=3, rx/tx: chars=246/161, ec: rx/tx=22/12, rx bad=46, rx/tx b-rate: last=33600/33600, low=31200/33600, high=33600/33600, desired-client=33600/33600, desired-host=33600/33600, retr: local=0, remote=0, fail=0, speedshift: local up/down=1/0, remote up/down=0/0, fail=0, v90: stat=No Attempt, client=(n/a), fail=None, time(sec)=52, disc reason=0xA220 *Nov 16 18:30:26.101: %CALLTRKR-3-MODEM_LINE_CALL_REC: ct_hndl=5, rx/tx levl=-17/-16, phase-jit: freq=0, levl=0, far-end echo-levl=-71, freq offst=0, phase-roll=-98, round-trip=1, d-pad=None, d-pad comp=0, rbs=0, const=16, rx/tx: sym-rate=3429/3429, carr-freq=1959/1959, trel-code=0/0, preemph-index=6/0, rx/tx: const-shape=Off/On, nonlin-encode=Off/On, precode=Off/On, xmit levl-reduct=2/3, shape=0x1920212120202120202020202020202020202020201F1D191100 *Nov 16 18:30:26.101: %CALLTRKR-3-MODEM_INFO_CALL_REC: ct_hndl=5, general info=0x0, rx/tx link-layer=264/182, NAKs=0/0, rx/tx ppp-slip=5/7, bad ppp-slip=0, proj max rx b-rate: client=19200, host=24000, rx/tx: max neg I frame=128/128, neg window=15/15, T401 timeouts=1, tx window closures=0, rx overruns=0, retrans frames=0, v110: rx good=0, rx bad=0, tx=0, sync-lost=0, ss7/cot=0x00, v42bis size: dict=1024, test err=0, reset=0, v0 synch-loss=0, mail lost: host=0, sp=0, diag=0x00000000000000000000000000000000 *Nov 16 18:30:26.101: %CALLTRKR-3-MODEM_NEG_CALL_REC: ct_hndl=5, v8bis cap=0x00000000000000000000000000000000000000000000, v8bis mod-sl=0x00000000000000000000000000000000000000000000, v8 jnt-menu=0x01E0C14513942A000000000000000000000000000000, v8 call-menu=0x01C14513942A00000000000000000000000000000000, v90 train=0x00000000, v90 sgn-ptrn=0x00000000, state trnsn=0x000102030410204042430451FF00000000000000000000000000000000000000, phase2=0x010000F4EF221FF37E0001E4EFA21FF2E30001A4EF980101B7CF98003C0000000034EF40000502160AE0301FFFFE1C07A707A70D650D6500
Related Commands
Sets the maximum calls saved in the history table. Sets the number of minutes to save calls in the history table. Displays the detailed data stored within Call Tracker for terminated calls. Displays the number of calls in the active table and history table, and the values of the history table attributes.
Command
Description
To enable Call Tracker on the access server, use the calltracker enable command. Use the no form of this command to restore the default condition.
calltracker enableSyntax Description
This command has no keywords or arguments.
Defaults
Call Tracker is not enabled.
Command Modes
Global configuration
Command History
12.1(2)XH This command was introduced.
Release
Modification
Usage Guidelines
To enable real-time call statistics from the MICA modem to Call Tracker, you must configure the modem link-info poll time command.
Examples
None
Related Commands
Enable Call Tracker SYSLOG support for generating detailed Call Records. Sets the maximum calls saved in the history table. Sets the number of minutes to save calls in the history table. Displays debug messages tracing the Call Tracker processing flow. Sets the interval at which active call statistics are polled from the MICA modem. Displays the detailed data stored within Call Tracker for active calls. Displays the detailed data stored within Call Tracker for terminated calls. Displays the detailed data stored within Call Tracker for last call on specified modem. Specifies the host to receive Call Tracker traps.
Command
Description
To set the maximum number of call entries stored in the Call Tracker history table, use the calltracker history max-size command. Use the no form of this command to restore the default value.
calltracker history max-size number
Syntax Description
number The maximum call entries to store in the Call Tracker history table. The valid range is from 0 through 10 times the max DS0 supported on given platform. A value of 0 prevents any history from being saved.
Defaults
The default maximum is dynamically calculated to be 1 time the max DS0 supported on given platform.
Command Modes
Global configuration
Command History
12.1(2)XH This command was introduced.
Release
Modification
Usage Guidelines
Be careful when extending the history max-size, as this activity will cause Call Tracker to use more memory resources to store the additional call data. NAS memory consumption must be considered when increasing this parameter. The active call table is not affected by this command.
Examples
The following example sets the history table size to 50 calls:
calltracker history max-size 50
Related Commands
Sets the number of minutes to save calls in the history table. Displays the detailed data stored within Call Tracker for terminated calls. Displays the number of calls in the active table and history table, and the values of the history table attributes.
Command
Description
To set the number of minutes that call entries are stored in the Call Tracker history table, use the calltracker history retain-mins command. Use the no form of this command to restore the default value.
calltracker history retain-mins minutes
Syntax Description
minutes The length of time to store calls in the Call Tracker history table. The valid range is from 0 through 26,000 minutes. A value of 0 prevents any history from being saved.
Defaults
The default minutes is 5000.
Command Modes
Global configuration
Command History
12.1(2)XH This command was introduced.
Release
Modification
Usage Guidelines
Active calls are not affected by this command. Entries in the active table are retained as long as the calls are connected.
Examples
The following example sets the retain time for the history table to 5000 minutes:
calltracker history retain-mins 5000
Related Commands
Sets the maximum calls saved in the history table. Displays the detailed data stored within Call Tracker for terminated calls. Displays the number of calls in the active table and history table, and the values of the history table attributes.
Command
Description
To enable AAA pre-authentication based on the DNIS number, use the dnis AAA pre-authentication command.
dnis [password string]
Syntax Description
password string (Optional) Password to use in the Access-Request packet. The default is cisco.
Pre-authentication using DNIS is disabled.
Command Modes
AAA pre-authentication configuration
Command History
12.1(2)XH This command was introduced.
Release
Modification
Examples
The following example enables DNIS pre-authentication using a RADIUS server and the password Ascend-DNIS:
aaa preauth dnis password Ascend-DNIS
Related Commands
Enters AAA pre-authentication mode. Selects the security server to use for AAA pre-authentication. Enables a timer for AAA server requests.
Command
Description
To select the security server to use for AAA pre-authentication requests, use the group AAA pre-authentication command.
group {radius | tacacs+ | server-group}
Syntax Description
group Enables authentication using the listed AAA server or server group. If no group is selected, radius is the default. radius Uses a RADIUS server for authentication. tacacs+ Uses a TACACS+ server for authentication. server-group Name of the server group to use for authentication.
Defaults
If this command is not configured, pre-authentication is performed by a RADIUS server.
Command Modes
AAA pre-authentication configuration
Command History
12.1(2)XH This command was introduced.
Release
Modification
Examples
The following example enables DNIS pre-authentication using the abc123 server group and the password aaa-DNIS:
aaa preauth group abc123 dnis password aaa-DNIS
Related Commands
Enters AAA pre-authentication mode. Enables AAA pre-authentication using DNIS.
Command
Description
To monitor the health of multicast delivery and be alerted when the delivery fails to meet certain parameters, use the ip multicast heartbeat command in global configuration mode. Use the no form of the command to disable the heartbeat.
ip multicast heartbeat group minimum window-size interval
Syntax Description
group A multicast group address (Class D address, between 224.0.0.0 and 239.255.255.255) minimum Number of packets to be received within a specified number of intervals (window-size). window-size Window size within which a number of intervals specified must receive a specified number of packets (minimum). interval Number of seconds interval to receive packet. Value must be a multiple of 10.
Defaults
The command is disabled by default.
Command Modes
Global configuration
Command History
12.1(2)XH This command was introduced.
Release
Modification
Usage Guidelines
The subject group is joined at the subject interface so multicast data for the subject group will be attracted toward the subject router.
The router monitors multicast packets destined to group at interval seconds. This is a binary decision. That is, the number of packets seen in this period is not as important as whether any packet for the group is seen or not.
If multicast packets were observed in less than minimum out of the last window-size intervals, an SNMP trap would be sent from this router to a network management station to indicate a "loss of hearbeat" exception. This trap will be defined in CISCO-IPMROUTE-MIB.my.
The value of interval must be a multiple of 10. In multicast distributed switching (MDS), statistics from VIP (in RSP) or LC (in GSR) are passed to the routing processor once every 10 seconds. Monitoring packets not in intervals of multiple of 10 seconds may lead to incorrect decisions.
This command does not create any multicast routing entries that is necessary for the monitoring of the heartbeat packets. These entries can be created by either the downstream members of the group, or with the ip pim join-group or ip pim static-group commands. If a multicast routing entry corresponding to a group address is expired due to lack of interest from the downstream members, then the monitoring for the subject group would cease to work; that is, no more SNMP Trap would be emitted.
Examples
The following is an example configuration of the ip multicast heartbeat command.
snmp-server enable traps ipmulticast-heartbeat ip multicast heartbeat 224.0.1.53 1 1 10
In this example, multicast packets forwarded through this router to group address 224.0.1.53 will be monitored. If no packet for this group is received in a 10-second interval, an SNMP trap would be sent to a designated SNMP management station.
|
Note This means, in the worst case, it may take close to 20 seconds of losing the multicast feed before the SNMP Trap is sent. |
Related Commands
Enables the router to send SNMP traps. Monitors the action of the heartbeat trap.
Command
Description
To send a specific ISDN cause code to the switch, use the isdn disconnect-cause command. Use the no form of the command to return to the default condition.
isdn disconnect-cause {cause-code-number | busy | not-available}
Syntax Description
cause-code-number Sends a cause code number (submitted as integer in the range of 1 through 127) to the switch. busy Sends the USER BUSY code to the switch. not-available Sends the CHANNEL-NOT-AVAILABLE code to the switch.
Defaults
The default condition is no cause code override. If the isdn disconnect-cause command is not configured, the default cause codes for the application are sent.
Command Modes
Interface configuration
Command History
12.0(5)T This command was introduced, and is a replacement for the isdn modem-busy-cause command.
Release
Modification
Usage Guidelines
The isdn disconnect-cause command overrides specific cause codes (such as modem availability and resource pooling) that are sent to the switch by ISDN applications. When the isdn disconnect-cause command is implemented, the configured cause codes are sent to the switch; otherwise, the default cause codes for the application are sent. ISDN protocol errors are still reflected in the cause codes and are not overridden.
Examples
The following example sends the CHANNEL-NOT-AVAILABLE code to the ISDN switch:
interface serial0:20
isdn disconnect-cause not-available
Related Commands
isdn modem-busy cause Sends a specific cause code to the ISDN switch.
Command
Description
To enable a managed timer for authentication requests, use the isdn guard-timer command. Use the no form of this command to reset the timer to its default value.
isdn guard-timer msecs [on-expiry {accept | reject}]
Syntax Description
msecs Number of milliseconds that the NAS waits for a response from the AAA security server. The valid range is from 1000 through 20,000. on-expiry (Optional) Determines whether calls are accepted or rejected after the specified number of milliseconds has expired. If no expiry action is selected, calls are rejected. accept Calls are accepted if the guard-timer expires before AAA responds. reject Calls are rejected if the guard-timer expires before AAA responds.
Defaults
The default timer value is eight (8) seconds and calls are rejected when the timer expires.
Command Modes
Interface configuration
Command History
12.1(2)XH This command was introduced.
Release
Modification
Usage Guidelines
The guard-timer starts when the DNIS number is sent to AAA for authentication. When the timer expires, authentication ends and the call is accepted or rejected based on the configured expiry action.
Examples
The following example sets the guard-timer to six (6) seconds and specifies that the call should be rejected if AAA does not respond within that interval:
interface serial 1/0/0:23 isdn guard-timer 6000 on-expiry reject
Related Commands
Enables authentication using DNIS numbers.
Command
Description
To enable PRI B channels to be busied out via SNMP, use the isdn snmp busyout b-channel command. Use the no form of this command to prevent B channels from being busied out via SNMP.
isdn snmp busyout b-channelSyntax Description
This command has no keywords or arguments.
Defaults
The default value is TRUE; that is, setting busyout via SNMP is allowed.
Command Modes
Interface configuration
Command History
12.1(2)XH This command was introduced.
Release
Modification
Usage Guidelines
To busy out B channels on a PRI, the ISDN switch must support service messages. The isdn snmp busyout b-channel command sets the MIB object, cpmDS0BusyoutAllow, indicating whether or not the switch supports service messages, thereby allowing the busyout of B channels. When the network access server receives an SNMP request for a busyout, it checks the value of this object. If the no isdn snmp busyout b-channel command is configured, the busyout request fails.
Examples
The following example allows the busyout of B channels for serial interface 0:23:
router# conf t router(config)# interface serial 0:23 router(config-if)# isdn snmp busyout b-channel
Related Commands
None
To set the polling interval at which link statistics are retrieved from the MICA modem, use the modem link-info poll time command. Use the no form of this command to return to the default condition.
modem link-info poll time seconds
Syntax Description
seconds Number of seconds between polling intervals. The valid range is from 10 through 6,5535 seconds.
Link statistics are not polled.
Command Modes
Global configuration
Command History
12.1(2)XH This command was introduced.
Release
Modification
Usage Guidelines
The modem link-info poll time command periodically polls active modem sessions to collect information such as attempted transmit and receive rates, maximum and minimum transmit and receive rates, and locally and remotely issued retrains and speedshift counters. This data is polled from MICA portware and passed to Cisco IOS software unsolicited.
Enabling the modem link-info poll time command disables the modem poll time command. Any modem poll time configuration is ignored because all modem events are sent to the access server unsolicited and no longer require polling by Cisco IOS software.
|
Note The modem link-info poll time command consumes a significant amount of memory, approximately 500 bytes for each MICA modem call. You should use this command only if you require the specific data that it collects; for instance, if you have enabled Call Tracker on your access server using the calltracker call-record command. |
Examples
The following example polls link statistics at 90 second intervals:
modem link-info poll time 300
Related Commands
Enables Call Tracker on the access server. Displays the detailed data stored within Call Tracker for active calls. Displays the detailed data stored within Call Tracker for specific call having specified unique call handle identifier. Displays the detailed data stored within Call Tracker for terminated calls. Displays the detailed data stored within Call Tracker for last call on specified modem.
Command
Description
To send the RADIUS Acct-Session-Id (attribute 44) in authentication Access-Request packets, use the radius-server attribute 44 include-in-access-req command. Use the no form of this command to return to the default condition.
radius-server attribute 44 include-in-access-reqSyntax Description
This command has no arguments or keywords.
Defaults
The Acct-Session-Id is not included in Access-Request packets.
Command Modes
Global configuration
Command History
12.1(2)XH This command was introduced.
Release
Modification
Usage Guidelines
Using the radius-server attribute 44 include-in-access-req command generates the Acct-Session_Id prior to authentication, allowing a call's authentication records to be linked to its accounting records.
Examples
The following example sends the Acct-Session-Id in authentication Access-Requests:
radius-server attribute 44 include-in-access-req
Related Commands
None
To prevent user responses to Access-Challenge packets from displaying on the screen, use the radius-server challenge-noecho command. Use the no form of this command to return to the default condition.
radius-server challenge-noechoSyntax Description
This command has no arguments or keywords.
Defaults
All user responses to Access-Challenge packets are echoed to the screen.
Command Modes
Global configuration
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
This command applies to all users. When the radius-server challenge-noecho command is configured, user responses to Access-Challenge packets are not displayed; unless the Prompt attribute in the user's profile is set to echo on the RADIUS server. The Prompt attribute in a user's profile overrides the radius-server challenge-noecho command, for the individual user. For more information, see the "Configuring RADIUS Prompt" section.
Examples
The following example stops all user responses from displaying on the screen:
radius-server challenge-noecho
Related Commands
None
To display all of the information stored within the Call Tracker Active Database for all active calls, use the show call calltracker active command. This command allows you to display only calls for a single supported call category type, if desired.
show call calltracker active [category <isdn | modem | other | v110 | v120>]
Syntax Description
category <isdn | modem | other | v110 | v120> (Optional) Displays Call Tracker data for a certain type of call. The default is to show all calls, regardless of type. By specifying the category, Call Tracker will only show calls whose records indicate that category.
Defaults
The activity and configuration information is not displayed. The command show call calltracker active will show all calls, regardless of type, unless specified by the category option field.
Command Modes
Privileged EXEC
Command History
12.1(2)XH This command was introduced.
Release
Modification
5300# show call calltracker active category modem
-------------------------- call handle=0000000058 --------------------------
status=Active, service=PPP, origin=Answer, category=Modem
DS0 slot/cntr/chan=0/0/22, called=71071, calling=6669999
userid=maverick5200, ip=192.9.4.2, mask=255.255.255.0
setup=10/16/1999 18:29:20, conn=0.10, phys=17.00, service=24.71, authen=24.71
init rx/tx b-rate=28800/33600, rx/tx chars=0/0
resource slot/port=1/1, mp bundle=0, charged units=0, account id=75
idb handle=0x6185B968, tty handle=0x612F8598, tcb handle=0x0
----------------------------------------------------------------------------
protocol: last=LAP-M, attempted=LAP-M
compression: last=V.42bis-Both, supported= V.42bis-RX V.42bis-TX
standard: last=V.34+, attempted=V.34+, initial=V.34+
snr=35 dB, sq=3, rx/tx level=-16/-15 dBm
phase jitter: freq=0 Hz, level=0 degrees
far end echo level=-83 dBm, freq offset=0 Hz
phase roll=-99 degrees, round-trip delay=1 msecs
digital pad=None dB, digital pad comp=0
rbs pattern=0, constellation=16 point
rx/tx: symbol rate=3429/3429, carrier freq=1959/1959
rx/tx: trellis code=0/0, preemphasis index=6/0
rx/tx: constellation shape=Off/On, nonlinear encode=Off/On
rx/tx: precode=Off/On, xmit level reduct=2/2 dBm
rx/tx: chars=0/0, general info=0x0
rx/tx: link layer chars=0/0, NAKs=0/0
error corrected: rx/tx=0/0, rx bad=0
ec retransmissions=0, retransmitted frames=0
rx/tx ppp slip=0/0, bad ppp slip=0
rx/tx b-rate: last=28800/33600, lowest=28800/33600, highest=28800/33600
phase 2 projected max rx b-rate: client=19200, host=24000
phase 4 desired rx/tx b-rate: client=28800/33600, host=28800/33600
retrains: local=0, remote=0, failed=0
speedshift: local up/down=0/0, remote up/down=0/0, failed=0
v110: rx good=0, rx bad=0, tx=0, sync lost=0
SS7/COT status=0x00
v90: status=No Attempt, client=(n/a), failure=None
rx/tx: max neg I frame=128/128, neg window=15/15
v42bis size: dictionary=1024, string=64
T401 timeouts=0, tx window closures=0, rx overruns=0
test err=0, reset=0, v0 synch loss=0
mail lost: host=0, sp=0
duration(sec)=16, disc reason=0x0
disc text=(n/a)
--------5---------10--------15--------20--------25--------30
line shape : 0x1920212120202120202021202020202020202020201F1D191100
v8bis capab : 0x00000000000000000000000000000000000000000000
v8bis mod sl: 0x00000000000000000000000000000000000000000000
v8 jnt menu : 0x01E0C14513942A000000000000000000000000000000
v8 call menu: 0x01C14513942A00000000000000000000000000000000
v90 training: 0x00000000
v90 sgn ptrn: 0x00000000
state trnsn : 0x00010203041020404243FF00000000000000000000000000000000000000
0000
portwre diag: 0x00000000000000000000000000000000
phase 2 info: 0x010000F4EF221FF37E0001E4EFA21FF2E30001A4EF980101B7CF98003C00
00000024EF40000502160AE0304DFFFECE07A707A70D650D6500
phase 4 info: 0x01834070808340708000
Related Commands
Displays the detailed data stored within Call Tracker for specific call having specified unique call handle identifier. Displays all the information stored within the Call Tracker History Database Table for the most recent disconnected calls.
Command
Description
To display all the information stored within the Call Tracker Active or History Database Table for a specified unique call handle identifier, the show call calltracker handle command.
show call calltracker handle handle
Syntax Description
handle Unique Call Identifier assigned by Call Tracker from moment a DS0 B Channel is requested. This identifier is a sequential number starting with handle 1.
Defaults
The activity and configuration information is not displayed.
Command Modes
Privileged EXEC
Command History
12.1(2)XH This command was introduced.
Release
Modification
Usage Guidelines
Each call managed by Call Tracker is assigned a unique call handle. This handle is provided to users via SNMP, CLI, or SYSLOG for all forms of data transfers. Thus, it becomes easier to display the information desired for a given call knowing its call handle than manually searching through all Call Tracker Database Tables for latest updates.
Examples
5300# show call calltracker handle 30 -------------------------- call handle=0000000030 -------------------------- status=History, service=None, origin=Answer, category=Other DS0 slot/cntr/chan=0/0/22, called=71071, calling=6669999 userid=(n/a), ip=0.0.0.0, mask=0.0.0.0 setup=10/16/1999 18:29:20, conn=0.00, phys=0.00, service=0.00, authen=0.00 init rx/tx b-rate=0/0, rx/tx chars=0/0 resource slot/port=(n/a)/(n/a), mp bundle=0, charged units=0, account id=0 duration(sec)=0.00, disc subsys=CSM, disc code=0x1A disc text=Failed to find DSP resource ----------------------------------------------------------------------------
Related Commands
Displays all of the information stored within the Call Tracker Active Database for all active calls. Displays all the information stored within the Call Tracker History Database Table for the most recent disconnected calls.
Command
Description
To display all the information stored within the Call Tracker History Database Table for most recent disconnected calls, use the show call calltracker history command.
show call calltracker history [category <isdn | modem | other | v110 | v120>]
Syntax Description
category <isdn | modem | other | v110 | v120> (Optional) Displays Call Tracker data for a certain type of call. The default is to show all calls, regardless of type. By specifying the category, Call Tracker will only show calls whose records indicate that category.
Defaults
The activity and configuration information is not displayed. The command show call calltracker history will show all calls, regardless of type, unless specified by the category option field.
Command Modes
Privileged EXEC
Command History
12.1(2)XH This command was introduced.
Release
Modification
Examples
5300# show call calltracker history
-------------------------- call handle=0000000030 --------------------------
status=History, service=None, origin=Answer, category=Other
DS0 slot/cntr/chan=0/0/22, called=71071, calling=6669999
userid=(n/a), ip=0.0.0.0, mask=0.0.0.0
setup=10/16/1999 18:29:15, conn=0.00, phys=0.00, service=0.00, authen=0.00
init rx/tx b-rate=0/0, rx/tx chars=0/0
resource slot/port=(n/a)/(n/a), mp bundle=0, charged units=0, account id=0
duration(sec)=0.00, disc subsys=CSM, disc code=0x1A
disc text=Failed to find DSP resource
----------------------------------------------------------------------------
-------------------------- call handle=0000000031 --------------------------
status=History, service=PPP, origin=Answer, category=Modem
DS0 slot/cntr/chan=0/1/2, called=71071, calling=(n/a)
userid=testme, ip=0.0.0.0, mask=0.0.0.0
setup=10/16/1999 18:29:20, conn=3.12, phys=20.63, service=22.74, authen=0.00
init rx/tx b-rate=31200/31200, rx/tx chars=221/120
resource slot/port=1/1, mp bundle=0, charged units=0, account id=0
duration(sec)=27.95, disc subsys=PPP, disc code=0x12
disc text=Invalid Username
----------------------------------------------------------------------------
protocol: last=LAP-M, attempted=LAP-M
compression: last=V.42bis-Both, supported= V.42bis-RX V.42bis-TX
standard: last=V.34+, attempted=V.34+, initial=V.34+
snr=36 dB, sq=3, rx/tx level=-17/-14 dBm
phase jitter: freq=0 Hz, level=0 degrees
far end echo level=-77 dBm, freq offset=0 Hz
phase roll=-98 degrees, round-trip delay=2 msecs
digital pad=None dB, digital pad comp=0
rbs pattern=0, constellation=16 point
rx/tx: symbol rate=3429/3429, carrier freq=1959/1959
rx/tx: trellis code=0/0, preemphasis index=6/3
rx/tx: constellation shape=Off/On, nonlinear encode=Off/On
rx/tx: precode=Off/On, xmit level reduct=2/1 dBm
rx/tx: chars=221/120, general info=0x0
rx/tx: link layer chars=242/167, NAKs=0/0
error corrected: rx/tx=19/9, rx bad=32
ec retransmissions=0, retransmitted frames=0
rx/tx ppp slip=4/5, bad ppp slip=0
rx/tx b-rate: last=31200/31200, lowest=31200/31200, highest=31200/31200
phase 2 projected max rx b-rate: client=19200, host=24000
phase 4 desired rx/tx b-rate: client=31200/31200, host=31200/33600
retrains: local=0, remote=0, failed=0
speedshift: local up/down=0/0, remote up/down=0/0, failed=0
v110: rx good=0, rx bad=0, tx=0, sync lost=0
SS7/COT status=0x00
v90: status=No Attempt, client=(n/a), failure=None
rx/tx: max neg I frame=128/128, neg window=15/15
v42bis size: dictionary=1024, string=64
T401 timeouts=0, tx window closures=0, rx overruns=0
test err=0, reset=0, v0 synch loss=0
mail lost: host=0, sp=0
duration(sec)=24, disc reason=0xDF03
disc text= Tx (host to line) data flushing - OK/Requested by host/DTR dropped
--------5---------10--------15--------20--------25--------30
line shape : 0x1920212120202120202020202020202020202020201F1D191100
v8bis capab : 0x00000000000000000000000000000000000000000000
v8bis mod sl: 0x00000000000000000000000000000000000000000000
v8 jnt menu : 0x01E0C14513942A000000000000000000000000000000
v8 call menu: 0x01C14513942A00000000000000000000000000000000
v90 training: 0x00000000
v90 sgn ptrn: 0x00000000
state trnsn : 0x00010203041020FF00000000000000000000000000000000000000000000
0000
portwre diag: 0x00000000000000000000000000000000
phase 2 info: 0x010000F4EF321FE3FF0001E4EFA21FF2E30001A4EF980101B7CF98003C00
00000014EF48002512D66AE1B0E1FFFE2207A707A70D650D6500
phase 4 info: 0x01834079E079E079E000
----------------------------------------------------------------------------
Related Commands
Displays all of the information stored within the Call Tracker Active Database for all active calls. Displays the detailed data stored within Call Tracker for specific call having specified unique call handle identifier.
Command
Description
To display Call Tracker activity and configuration information such as the number of active calls and the history table attributes, use the show call calltracker summary privileged EXEC command.
show call calltracker summarySyntax Description
This command has no keywords or arguments.
Defaults
The activity and configuration information is not displayed.
Command Modes
Privileged EXEC
Command History
12.1(2)XH This command was introduced.
Release
Modification
Examples
The following is sample output from the show call calltracker summary command:
5300# show call calltracker summary
Call Tracker Status:
Active Table:
- 7 call(s)
- 4473 bytes used (639 average, 639 maximum)
History Table:
- 50 of a maximum of 240 call(s) (20% full)
- 45157 bytes used (903 average, 921 maximum)
- 260000 minute(s) call retain time
API Front-end:
- event elements:512 total, 512 free, 0 in-use
- free event elements' low watermark:467
- events dropped due to unavailability of free elts:0
Table 1 describes the fields shown in the show call calltracker summary display.
| Field | Description |
|---|---|
| Active Table: |
|
call(s) | Number of active calls. |
n bytes used (m average, o maximum) | n=total memory used for all active calls m=average memory usage per call (n/calls) o=highest single memory usage for a call |
| History Table: |
|
x of a maximum of n calls (o% full) | Number of calls in the history table, the maximum allowed (as defined by the calltracker history max-size command), and the percentage of the history table that these calls consume. |
n bytes used (m average, o maximum) | n=total memory used for all active calls m=average memory usage per call (n/calls) o=highest single memory usage for a call |
minute(s) call retain time | Number of minutes calls are retained in the history table. This parameter is configured using the calltracker history retain-mins command. |
| API Front-end: |
|
event elements | For Cisco internal use only. |
free event elements' low watermark | For Cisco internal use only. |
events dropped because of unavailability of free elements | For Cisco internal use only. |
Related Commands
Displays all of the information stored within the Call Tracker Active Database for all active calls. Displays all the information stored within the Call Tracker History Database Table for the most recent disconnected calls.
Command
Description
To display all of the information stored within the Call Tracker Active or History Database for latest call assigned to specified modem, use the show modem calltracker command. This command allows you to display all the Call Tracker data for a given modem when one does not have the call handle readily available and does not want to search the Call Tracker database.
show modem calltracker [slot/port]
Syntax Description
slot/port (Optional) Specifies the location of a slot and modem port. Remember to include the forward slash(/) when entering this variable.
Defaults
The activity and configuration information is not displayed.
Command Modes
Privileged EXEC
Command History
12.1(2)XH This command was introduced.
Release
Modification
Examples
5300# show modem calltracker 1/1
-------------------------- call handle=0000000058 --------------------------
status=Active, service=PPP, origin=Answer, category=Modem
DS0 slot/cntr/chan=0/0/22, called=71071, calling=6669999
userid=maverick5200, ip=192.9.4.2, mask=255.255.255.0
setup=10/16/1999 18:29:20, conn=0.10, phys=17.00, service=24.71, authen=24.71
init rx/tx b-rate=28800/33600, rx/tx chars=0/0
resource slot/port=1/1, mp bundle=0, charged units=0, account id=75
idb handle=0x6185B968, tty handle=0x612F8598, tcb handle=0x0
----------------------------------------------------------------------------
protocol: last=LAP-M, attempted=LAP-M
compression: last=V.42bis-Both, supported= V.42bis-RX V.42bis-TX
standard: last=V.34+, attempted=V.34+, initial=V.34+
snr=35 dB, sq=3, rx/tx level=-16/-15 dBm
phase jitter: freq=0 Hz, level=0 degrees
far end echo level=-83 dBm, freq offset=0 Hz
phase roll=-99 degrees, round-trip delay=1 msecs
digital pad=None dB, digital pad comp=0
rbs pattern=0, constellation=16 point
rx/tx: symbol rate=3429/3429, carrier freq=1959/1959
rx/tx: trellis code=0/0, preemphasis index=6/0
rx/tx: constellation shape=Off/On, nonlinear encode=Off/On
rx/tx: precode=Off/On, xmit level reduct=2/2 dBm
rx/tx: chars=0/0, general info=0x0
rx/tx: link layer chars=0/0, NAKs=0/0
error corrected: rx/tx=0/0, rx bad=0
ec retransmissions=0, retransmitted frames=0
rx/tx ppp slip=0/0, bad ppp slip=0
rx/tx b-rate: last=28800/33600, lowest=28800/33600, highest=28800/33600
phase 2 projected max rx b-rate: client=19200, host=24000
phase 4 desired rx/tx b-rate: client=28800/33600, host=28800/33600
retrains: local=0, remote=0, failed=0
speedshift: local up/down=0/0, remote up/down=0/0, failed=0
v110: rx good=0, rx bad=0, tx=0, sync lost=0
SS7/COT status=0x00
v90: status=No Attempt, client=(n/a), failure=None
rx/tx: max neg I frame=128/128, neg window=15/15
v42bis size: dictionary=1024, string=64
T401 timeouts=0, tx window closures=0, rx overruns=0
test err=0, reset=0, v0 synch loss=0
mail lost: host=0, sp=0
duration(sec)=16, disc reason=0x0
disc text=(n/a)
--------5---------10--------15--------20--------25--------30
line shape : 0x1920212120202120202021202020202020202020201F1D191100
v8bis capab : 0x00000000000000000000000000000000000000000000
v8bis mod sl: 0x00000000000000000000000000000000000000000000
v8 jnt menu : 0x01E0C14513942A000000000000000000000000000000
v8 call menu: 0x01C14513942A00000000000000000000000000000000
v90 training: 0x00000000
v90 sgn ptrn: 0x00000000
state trnsn : 0x00010203041020404243FF00000000000000000000000000000000000000
0000
portwre diag: 0x00000000000000000000000000000000
phase 2 info: 0x010000F4EF221FF37E0001E4EFA21FF2E30001A4EF980101B7CF98003C00
00000024EF40000502160AE0304DFFFECE07A707A70D650D6500
phase 4 info: 0x01834070808340708000
----------------------------------------------------------------------------
Related Commands
Displays all of the information stored within the Call Tracker Active Database for all active calls. Displays all the information stored within the Call Tracker History Database Table for the most recent disconnected calls. Displays the detailed data stored within Call Tracker for specific call having specified unique call handle identifier.
Command
Description
To enable the router to send SNMP traps, use the snmp-server enable traps command. Use the no form of this command to disable SNMP traps. The calltracker trap type was added for Cisco IOS Release 12.1(2)XH.
snmp-server enable traps [trap-type] [trap-option]Syntax Description
trap-type | (Optional) Type of trap to enable. If no type is specified, all traps are sent (including the envmon and repeater traps). The trap type can be one of the following keywords:
|
trap-option | (Optional) When the envmon keyword is used, you can enable a specific environmental trap type, or accept all trap types from the environmental monitor system. If no option is specified, all environmental types are enabled. The option can be one or more of the following keywords: voltage, shutdown, supply, fan, and temperature. When the isdn keyword is used on Cisco 1600 series routers, you can specify the call-information keyword to enable an SNMP ISDN call information trap for the ISDN MIB subsystem, or you can specify the isdnu-interface keyword to enable an SNMP ISDN U interface trap for the ISDN U interface MIB subsystem. When the repeater keyword is used, you can specify the repeater option. If no option is specified, all repeater types are enabled. The option can be one or more of the following keywords:
When the snmp keyword is used, you can specify the authentication option to enable SNMP Authentication Failure traps. (The snmp-server enable traps snmp authentication command replaces the snmp-server trap-authentication command.) If no option is specified, all SNMP traps are enabled. When the voice keyword is used, you can enable poor quality of voice traps by using the qov option. |
Defaults
This command is disabled by default. No traps are enabled.
If you enter this command with no keywords, the default is to enable all trap types.
Some trap types cannot be controlled with this command. These traps are either always enabled or enabled by some other means. For example, the linkUpDown messages are disabled by the no snmp trap link-status command.
Command Modes
Global configuration
Command History
11.1 This command was introduced. 11.3(1) MA The voice trap type was added. 12.1(2)XH The calltracker trap type was added.
Release
Modification
Usage Guidelines
This command is useful for disabling traps that are generating a large amount of uninteresting or useless noise.
If you do not enter an snmp-server enable traps command, no traps controlled by this command are sent. In order to configure the router to send these SNMP traps, you must enter at least one snmp-server enable traps command. If you enter the command with no keywords, all trap types are enabled. If you enter the command with a keyword, only the trap type related to that keyword is enabled. To enable multiple types of traps, you must issue a separate snmp-server enable traps command for each trap type and option.
The snmp-server enable traps command is used in conjunction with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP traps. To send traps, you must configure at least one snmp-server host command.
For a host to receive a trap controlled by this command, both the snmp-server enable traps command and the snmp-server host command for that host must be enabled. If the trap type is not controlled by this command, only the appropriate snmp-server host command must be enabled.
The trap types used in this command all have an associated MIB object that allows them to be globally enabled or disabled. Not all of the trap types available in the snmp-server host command have notificationEnable MIB objects, so some of these cannot be controlled using the snmp-server enable traps command.
Examples
The following example enables the router to send Call Tracker traps:
configure terminal snmp-server enable traps calltracker
The following example enables the router to send poor quality of voice traps:
configure terminal snmp-server enable traps voice poor-qov
The following example enables the router to send all traps to the myhost.cisco.com host using the public community string:
snmp-server enable traps snmp-server host myhost.cisco.com public
The following example enables the router to send Frame Relay and environmental monitor traps to the myhost.cisco.com host using the public community string:
snmp-server enable traps frame-relay snmp-server enable traps envmon temperature snmp-server host myhost.cisco.com public
The following example will not send traps to any host. The BGP traps are enabled for all hosts, but the only traps enabled to be sent to a host are ISDN traps.
snmp-server enable traps bgp snmp-server host bob public isdn
Related Commands
snmp enable peer-trap poor-qov Generates poor quality of voice notification for applicable calls associated with VoIP dial peers. Specifies the recipient of an SNMP notification operation. snmp-server trap-source Specifies the interface (and hence the corresponding IP address) from where an SNMP trap should originate. snmp trap illegal-address Issues an SNMP trap when a MAC address violation is detected on an Ethernet hub port. snmp trap link-status Enables SNMP link trap generation.
Command
Description
To specify the recipient of an SNMP notification operation, use the snmp-server host command. Use the no form of this command to remove the specified host. The calltracker notification type was added for Cisco IOS Release c5300-is-mz.redwood.beta.mmddyy.
snmp-server host host [traps | informs] [version {1 | 2c}] community-string [udp-port port]
Syntax Description
host Name or Internet address of the host. traps (Optional) Send SNMP traps to this host. This is the default. informs (Optional) Send SNMP informs to this host. version (Optional) Version of the Simple Network Management Protocol (SNMP) used to send the traps. community-string Password-like community string sent with the notification operation. udp-port port UDP port of the host to use. The default is 162. notification-type (Optional) Type of notification to be sent to the host. If no type is specified, all notifications are sent. The notification type can be one or more of the following keywords:
Defaults
This command is disabled by default. No notifications are sent.
If you enter this command with no keywords, the default is to send all trap types to the host. No informs will be sent to this host.
If no version keyword is present, the default is version 1. If no traps or informs keyword is present, traps are enabled.
The no snmp-server host command with no keywords will disable traps, but not informs, to the host. In order to disable informs, use the no snmp-server host informs command.
Command Modes
Global configuration
Command History
10.0 This command was introduced. 11.3(1) MA The voice trap type was added. 12.1(2)XH The calltracker notification type was added.
Release
Modification
Usage Guidelines
SNMP notifications can be sent as traps or inform requests. Traps are unreliable because the receiver does not send acknowledgments when it receives traps. The sender cannot determine if the traps were received. However, an SNMP entity that receives an inform request acknowledges the message with an SNMP response PDU. If the sender never receives the response, the inform request can be sent again. Thus, informs are more likely to reach their intended destination.
However, informs consume more resources in the agent and in the network. Unlike a trap, which is discarded as soon as it is sent, an inform request must be held in memory until a response is received or the request times out. Also, traps are sent only once, while an inform may be retried several times. The retries increase traffic and contribute to a higher overhead on the network.
If you do not enter an snmp-server host command, no notifications are sent. In order to configure the router to send SNMP notifications, you must enter at least one snmp-server host command. If you enter the command with no keywords, all trap types are enabled for the host. In order to enable multiple hosts, you must issue a separate snmp-server host command for each host. You can specify multiple notification types in the command for each host.
When multiple snmp-server host commands are given for the same host and kind of notification (trap or inform), each succeeding command overwrites the previous command. Only the last snmp-server host command will be in effect. For example, if you enter an snmp-server host inform command for a host and then enter another snmp-server host inform command for the same host, the second command will replace the first.
The snmp-server host command is used in conjunction with the snmp-server enable command. Use the snmp-server enable command to specify which SNMP notifications are sent globally. For a host to receive most notifications, at least one snmp-server enable command and the snmp-server host command for that host must be enabled.
However, some notification types cannot be controlled with the snmp-server enable command. For example, some notification types are always enabled. Other notification types are enabled by a different command. For example, the linkUpDown notifications are controlled by the snmp trap link-status command. These notification types do not require an snmp-server enable command.
A notification-type option's availability depends on the router and Cisco IOS software features supported on the router. For example, the envmon notification-type is available only if the environmental monitor is part of the system.
Examples
The following example sends Call Tracker traps to the host address 172.30.2.160 using the community string public:
snmp-server enable traps calltracker snmp-server host 172.30.2.160 public calltracker
The following example sends the SNMP and Cisco environmental monitor enterprise-specific traps to address 172.30.2.160:
snmp-server enable traps snmp-server host 172.30.2.160 public snmp envmon
The following example sends all traps to the host myhost.cisco.com using the community string public:
snmp-server enable traps snmp-server host myhost.cisco.com public
The following example does not send traps to any host. The BGP traps are enabled for all hosts, but only the ISDN traps are enabled to be sent to a host.
snmp-server enable traps bgp snmp-server host bob public isdn
The following example enables the router to send all inform requests to the host myhost.cisco.com using the public community string:
snmp-server enable traps snmp-server host myhost.cisco.com informs version 2c public
Related Commands
Displays all of the information stored within the Call Tracker Active Database for all active calls. snmp-server informs Specifies inform request options. snmp-server trap-source Specifies the interface (and hence the corresponding IP address) from where an SNMP trap should originate. snmp-server trap-timeout Defines how often to try resending trap messages on the retransmission queue.
Command
Description
This section describes new debug commands. All other commands used with these features are documented in the Cisco IOS Release 12.1 command references.
To display debug messages related to POD packets, use the debug aaa pod command. Use the no form of this command to disable debugging output.
debug aaa podSyntax Description
This command has no keywords or arguments.
Defaults
Debugging for POD packets is not enabled.
Command History
12.1(2)XH This command was introduced.
Release
Modification
Examples
The following example shows output from a successful POD request, when using the show debug command.
5300# debug aaa pod AAA POD packet processing debugging is on 5300# show debug General OS: AAA POD packet processing debugging is on 5300# *Jul 9 16:04:32.271:POD:10.100.1.34 request queued *Jul 9 16:04:32.271:POD:10.100.1.34 user 0.0.0.0 sessid 0x0 key 0xA5AFA004 *Jul 9 16:04:32.271:POD: Line User IDB Session Id Key *Jul 9 16:04:32.271:POD:Skip Se0:21 meklund 0.0.0.0 0x0 0x0 *Jul 9 16:04:32.271:POD:KILL Se0:22 meklund 0.0.0.0 0x60000020 0xA5AFA004 *Jul 9 16:04:32.271:POD:Sending ACK to 10.100.1.34/1812 --- Interface Se0:22 was killed because the pod request contained a key of 0xA5AFA004 and pod was configured with the command aaa pod server port 1812 auth-type any server-key mykey
Related Commands
Enables the POD feature.
Command
Description
To display debug messages tracing the Call Tracker processing flow, use the debug calltracker command. Use the no form of this command to disable debugging output.
debug calltrackerSyntax Description
This command has no keywords or arguments.
Defaults
Call Tracker debugging is not enabled.
Command History
12.1(2)XH This command was introduced.
Release
Modification
Examples
The following example shows output for a call coming up, when using the show debug command:
5300# debug calltracker 5300# sh debug Call Tracker: Call Tracker's Registry API debugging is on Call Tracker's MIB API debugging is on Call Tracker's data base debugging is on 5300# *Jan 1 17:33:00.195: CT:find_actv_by_ct_hndl:node (hndl=416) not in active table *Jan 1 17:33:00.195:Posting 19 event ../call-mgmt/calltrkr_api_frontend.c:801 CT:reading new event(s) from API front-end *Jan 1 17:33:00.195: CT:find_actv_by_ct_hndl:node (hndl=416) not in active table CT:node (hndl=416) found in history table CT:actv-->hist ok:node (hndl=416) is now (or already was) in history table *Jan 1 17:33:00.319:ISDN Se0:23:calltrkr_disconnect hndl=416 *Jan 1 17:33:00.319: SWAT-5300-UUT# CT:find_actv_by_ct_hndl:node (hndl=416) not in active table *Jan 1 17:33:00.319:Posting 19 event ../call-mgmt/calltrkr_api_frontend.c:801 CT:reading new event(s) from API front-end *Jan 1 17:33:00.319: CT:find_actv_by_ct_hndl:node (hndl=416) not in active table CT:node (hndl=416) found in history table CT:actv-->hist ok:node (hndl=416) is now (or already was) in history table *Jan 1 17:33:00.331:%LINK-3-UPDOWN:Interface Serial0:20, changed state to down *Jan 1 17:33:00.331:Se0:20 PPP/CT/disconnect:zero handle detected, idb=0x61C25A84, code=3 *Jan 1 17:33:02.183:%LINK-5-CHANGED:Interface Async8, changed state to reset 5300# *Jan 1 17:33:02.183:As8 PPP/CT/disconnect:ct_hndl=416, idb=0x62235310 *Jan 1 17:33:02.183: CT:find_actv_by_ct_hndl:node (hndl=416) not in active table *Jan 1 17:33:02.183:Posting 19 event ../call-mgmt/calltrkr_api_frontend.c:801 CT:reading new event(s) from API front-end *Jan 1 17:33:02.187: CT:find_actv_by_ct_hndl:node (hndl=416) not in active table CT:node (hndl=416) found in history table CT:actv-->hist ok:node (hndl=416) is now (or already was) in history table *Jan 1 17:33:03.191:%LINEPROTO-5-UPDOWN:Line protocol on Interface Async8, changed state to down 5300# *Jan 1 17:33:05.131:Posting 18 event ../call-mgmt/calltrkr_api_frontend.c:764 CT:reading new event(s) from API front-end CT:calltrkr_dspbytecount(): ct_hndl=416, tx/rx=426/647349 CT:node (hndl=416) found in history table 5300# *Jan 1 17:33:07.183:%LINK-3-UPDOWN:Interface Async8, changed state to down
|
Note The above output is an example only. The fields and type of information that is displayed in your output may vary when using the debug calltracker command. |
Related Commands
Displays Call Tracker activity and configuration information.
Command
Description
To monitor the action of the heartbeat trap, use the debug ip mhbeat command. Use the no form of this command to disable debugging output.
debug ip mhbeatSyntax Description
This command has no keywords or arguments.
Defaults
Debugging is not enabled.
Command History
12.1(2)XH This command was introduced.
Release
Modification
Examples
5300#debug ip mhbeat
IP multicast heartbeat debugging is on
5300#debug snmp packets
SNMP packet debugging is on
router(config)#ip multicast heartbeat intervals-of 10
Dec 23 13:34:21.132: MHBEAT: ip multicast-heartbeat group 224.0.1.53 port 0
source 0.0.0.0 0.0.0.0 at-least 3 in 5 intervals-of 10 secondsd
5300#
Dec 23 13:34:23: %SYS-5-CONFIG_I: Configured from console by console
Dec 23 13:34:31.136: MHBEAT: timer ticked, t=1,i=1,c=0
Dec 23 13:34:41.136: MHBEAT: timer ticked, t=2,i=2,c=0
Dec 23 13:34:51.136: MHBEAT: timer ticked, t=3,i=3,c=0
Dec 23 13:35:01.136: MHBEAT: timer ticked, t=4,i=4,c=0
Dec 23 13:35:11.136: MHBEAT: timer ticked, t=5,i=0,c=0
Dec 23 13:35:21.135: Send SNMP Trap for missing heartbeat
Dec 23 13:35:21.135: SNMP: Queuing packet to 171.69.55.12
Dec 23 13:35:21.135: SNMP: V1 Trap, ent ciscoExperiment.2.3.1, addr 4.4.4.4, gentrap 6, spectrap 1
ciscoIpMRouteHeartBeat.1.0 = 224.0.1.53
ciscoIpMRouteHeartBeat.2.0 = 0.0.0.0
ciscoIpMRouteHeartBeat.3.0 = 10
ciscoIpMRouteHeartBeat.4.0 = 5
ciscoIpMRouteHeartBeat.5.0 = 0
ciscoIpMRouteHeartBeat.6.0 = 3
Related Commands
Monitors the health of multicast delivery and be alerted when the delivery fails to meet certain parameters.
Command
Description
AAA---The services of authentication, authorization, and accounting
Access-Accept---A response packet from the RADIUS server notifying the access server that the user is authenticated. This packet contains the user profile, which defines the specific AAA functions assigned to the user.
Access-Challenge---A response packet from the RADIUS server requesting that the user supply additional information before being authenticated.
Access-Request---A request packet sent to the RADIUS server by the access server requesting authentication of the user.
accounting---The process of recording what a user is doing.
authentication---The process of determining who a user is.
authorization---The process of determining what a user can do.
B channel---bearer channel. In ISDN, a full-duplex, 64-kbps channel used to send user data.
CAS---channel associated signaling. Call signaling that enables the access server to send or receive analog calls.
cause codes---(defined by ITU Series Q Recommendation 850) Code that indicates the reason for ISDN call failure or completion.
DNIS---Dialed Number Identification Service, also known as the called party number. The telephone number of the called party after translation occurs in the Public Switched Telephone Network. A given destination may have a different DNIS number based on how the call is placed (for example, 800 or direct dial).
DS0---Digital signal level 0. Framing specification used in transmitting digital signals over a single channel at 64-kbps on a T1 facility.
ISDN---Integrated Services Digital Network. Communication protocol offered by telephone companies that permits telephone networks to carry data, voice, and other source traffic.
MIB---Management Information Base. Database of network management information that is used and maintained by a network management protocol such as SNMP. The value of a MIB object can be changed or retrieved using SNMP commands, usually through a GUI network management system.
NOC---network operations center. Organization responsible for maintaining a network.
POD---Packet of disconnect. A process that allows a PPP session to be verified and then terminated by the network access server.
PPP---Point-to-Point Protocol. Successor to SLIP that provides router-to-router and host-to-network connections over synchronous and asynchronous circuits.
PRI---Primary Rate Interface. ISDN interface to primary rate access. Primary rate access consists of a single 64-kbps D channel plus 23 (T1) or 30 (E1) B channels for voice or data.
RADIUS---Remote Authentication Dial-In User Service. RADIUS is a distributed client/server system that secures networks against unauthorized access. RADIUS clients run on Cisco routers and send authentication requests to a central RADIUS server containing all user authentication and network-service access information.
SNMP---Simple Network Management Protocol. Network management protocol used almost exclusively in TCP/IP networks. SNMP provides a means to monitor and control network devices, and to manage configurations, statistics collection, performance, and security.
switch---Network device that filters, forwards, and floods frames based on the destination address of each frame. The switch operates at the data link layer of the OSI model.
TACACS+---Terminal Access Controller Access Control System Plus. Authentication protocol, developed by the DDN community, that provides remote access authentication and related services, such as event logging. User passwords are administered in a central database rather than in individual routers, providing an easily scalable network security solution.
TCP-Clear---A raw TCP dialup connection, not using the Telnet protocol. It allows a direct connection from the user's termination point on the network access server to the destination specified by the Login-IP-Host and Login-TCP-Port.
|
Note For a list of other internetworking terms, see Internetworking Terms and Acronyms, available on the Documentation CD-ROM and Cisco Connection Online (CCO) at the following URL: http://www.cisco.com/univercd/cc/td/doc/cisintwk/ita/index.htm. |
Posted: Wed Jun 21 10:02:31 PDT 2000
Copyright 1989 - 2000©Cisco Systems Inc.