Page 160
Chapter 9 Troubleshooting
Debugging
Symptom Voice prompt returns Upgrade not available message. This can only occur if you are using the executable-file upgrade method.
Possible Cause You are attempting to upgrade to the existing version.
Recommended Action You do not need to upgrade.
Symptom Voice prompt returns Upgrade failed message. This can only occur if you are using the executable-file upgrade method.
Possible Cause You have entered an incorrect IP address.
Recommended Action Enter the correct IP address.
Possible Cause Software image is corrupted.
Recommended Action Upgrade software image.
Symptom No dial tone.
Possible Cause No user ID was entered.
Recommended Action Enter the correct user ID.
Symptom Incorrect dial tone.
Possible Cause Check the web interface for your DialTone setting. The default is U.S.
Recommended Action Set the correct country DialTone value.
Debugging
The MS-DOS Windows-based debugging program tool, preserv.exe, is included in every software upgrade package. The tool is also available from Cisco TAC. The prserv program is used in conjunction with the NPrintf configuration parameter. This file serves as an upgrade server that captures debug information sent by the Cisco ATA software to your PC’s IP address and port number. This debug file (prserv.exe) compiles the information from the Cisco ATA into a readable log file. To capture this "NPRINTF" information, you must know the IP address of the PC using the prserv program, illustrated as follows:
IP address.port
where IP address is the IP address of your PC, and port is 9001. If another process on your PC already uses port 9001, you may use some other value (legal values are from 1024 to 65535). If no port value is entered, the default value is 9001.
To enter the IP address and port number, use voice menu option 81#. You must enter the IP address and port number in alphanumeric format, which requires entering the * key after every character entered. To enter the "." character, you must enter the sequence 1 1#.
Cisco ATA 186 and Cisco ATA 188 Analog Telephone Adaptor Administrator’s Guide (H.323)
Contents
Corporate Headquarters
Customer Order Number OL-4008-01
Copyright 2003, Cisco Systems, Inc All rights reserved
N T E N T S
Iii
Safety Recommendations
ToConfig
Dhcp
DNS1IP DNS2IP
Vii
Using FAX Mode
Viii
Contacting TAC
OL-4008-01
Audience
Overview
This preface includes the following sections
Organization
Conventions
Chapter Description
Xii
Xiii
Related Documentation
Xiv
Obtaining Documentation
World Wide Web
Documentation CD-ROM
Ordering Documentation
Obtaining Technical Assistance
Cisco.com
Technical Assistance Center
We appreciate your comments
Cisco TAC Escalation Center
Cisco TAC Web Site
Xvii
Xviii
Cisco Analog Telephone Adaptor Overview
Cisco ATA 186 as Endpoint in an H.323 Network
Terminals
Gateways
MCUs
Gatekeepers
Proxy Server
Hardware Overview
Cisco ATA 186-Rear View
Function Button
Software Features
Additional Supported Signaling Protocols
Voice Codecs Supported
Other Supported Protocols
Cisco ATA H.323 Services
Installation and Configuration Overview
Fax Services
Supplementary Services
Action Reference
Upgrading the Cisco ATA Signaling
Image by using the Tftp server-upgrade method or
Manual-upgrade method
Image
Installing the Cisco ATA
Safety Recommendations
What the Cisco ATA Package Includes
Installation Procedure
What You Need
Procedure
Cisco ATA 186 Rear Panel Connections
Installing the Cisco ATA Installation Procedure
Power-Down Procedure
OL-4008-01
Configuring the Cisco ATA for H.323
Default Boot Load Behavior
VLANSetting,
Parameter and Bits Reference
OpFlags
OpFlags,
VLANSetting
Feature
Bits
Example
Steps Needed to Configure the Cisco ATA
Basic Configuration Steps in a Tftp Server Environment
Atadefault.cfg Configuration File,
Upgrading the Signaling Image from a Tftp Server
Basic Configuration Steps in a Non-TFTP Server Environment
Configuring the Cisco ATA to Obtain its
Configuration File from the Tftp Server,
Refreshing or Resetting the Cisco ATA,
Setting Up the Tftp Server with Cisco ATA Software
Configuring the Cisco ATA Using a Tftp Server
Configurable Features and Related Parameters
Creating Unique and Common Cisco ATA Configuration Files
Save this file of Cisco ATA-specific parameters as
Syntax
Command Example
Using atapname.exe Tool to Obtain MAC Address
Command Output
Using the EncryptKey Parameter and cfgfmt Tool
Syntax examples
Using a Dhcp Server,
Atadefault.cfg Configuration File
Without Using a Dhcp Server,
Using a Dhcp Server
Without Using a Dhcp Server
Other Dhcp Options You Can Set
Voice Configuration Menu
DNS1IP DNS2IP Ntpip
Using the Voice Configuration Menu
Voice Menu Number Features
Entering Alphanumeric Values
Key Alphanumeric Characters
Resetting the Cisco ATA to Factory Default Values
Cisco ATA Web Configuration
Where ipaddress is the IP address of the Cisco ATA
UID0
Web Interface Access-Control Configuration
Refreshing or Resetting the Cisco ATA
Related Parameter
OpFlags, page 5-33-Bit
Upgrading the H.323 Signaling Image
Http Procedure to Refresh the Cisco ATA
Http Procedure to Reset the Cisco ATA
Http Refresh and Reset Access-Control Configuration
OL-4008-01
Important Basic H.323 Services
Required Parameters
Setting the Signaling Image to H.323 Mode
Setting Up User IDs for the Cisco ATA
Using the Cisco ATA with an H.323 Gatekeeper
Related Configuration Parameters
UID0, UID1,
Setting Up Gatekeeper Time-To-Live Value
Setting Up an Alternate H.323 Gatekeeper
LoginID0, LoginID1, UID0, UID1,
AltGk, AltGkTimeOut, ConnectMode,
Establishing Authentication with Cisco H.323 Gatekeeper
Using Multiple Cisco ATAs Without an H.323 Gatekeeper
Using the Cisco ATA Without an H.323 Gatekeeper
Gateway, GkOrProxy,
Additional H.323 Services
Setting the Audio Codecs
IPDialPlan,
LBRCodec, AudioMode,
Configuring Audio Packet Settings
Configuring Billable Features
Configuring the Call Waiting Permanent Default Setting
Configuring the Cisco ATA Refresh Interval
Configuring Hook Flash Timing
Configuring the Mixing of Call Waiting Tone and Audio
Configuring On-hook delay
Configuring Reverse Audio Cut-Through Behavior
Configuring Supplementary Service Behavior and Parameters
Debugging Diagnostics
Polarity Settings
Network Timing
Progress Tones
Selecting Dtmf and Hookflash Transmission Methods
Setting Dial Plans
Selecting H.323 Connection and H.245 Transmission Methods
ConnectMode, page 5-28-Bits 0
DialPlan,
Configurable Features Related Parameters
OL-4008-01
Parameters and Defaults
Configuration Text File Template
UIPassword
This section contains only one parameter-UIPassword
User Interface UI Parameter
Sections that follow describe these parameters
Parameters for Configuration Method and Encryption
Configuration-Complete Parameter
ToConfig
Settings
Range Default Voice Configuration Menu Access Code
UseTFTP
TftpURL
CfgInterval
EncryptKey
UseTFTP, CfgInterval,
UseTFTP, TftpURL,
320
Network Parameters
DHCP, StaticIp, StaticRoute, StaticNetMask,
Voice Configuration Menu Access Code Related Parameters
StaticIp
StaticRoute
DHCP, StaticRoute, StaticNetMask,
Account Information Parameters
StaticNetMask
DHCP, StaticIp, StaticNetMask,
255.255.255.0
UID1, PWD0, PWD1, UseLoginID, LoginID0, LoginID1,
This parameter is the password for the Phone 1 port
UID0, UID1, PWD1, UseLoginID, LoginID0, LoginID1, AutMethod,
UID0, PWD0, PWD1, UseLoginID, LoginID0, LoginID1,
This parameter is the password for the Phone 2 port
Gateway
LoginID0
UseLoginID
LoginID1, PWD0, PWD1, UseLoginID, AutMethod,
LoginID1
LoginID0, PWD0, PWD1, UseLoginID, AutMethod,
AutMethod
Bitmap
LoginID0, LoginID1, PWD0, PWD1, NTPIP, AltNTPIP,
GkOrProxy, AltGk, AltGkTimeOut, GkTimeToLive, GkId,
AltGk, AltGkTimeOut, GkTimeToLive, GkId,
Gatekeeper Parameters
AltGkTimeOut
AltGk
Integer
30 to 4294967295 seconds
Default Range
GkTimeToLive
GkId
Not specified
Mode Parameter
Use H.323 mode -Use SIP mode
Operating Parameters
UseSIP
DNS2IP, UDPTOS, SigTimer, OpFlags, VLANSetting,
UDPTOS, VLANSetting,
MediaPort
LBRCodec
AudioMode
RxCodec, TxCodec,
AudioMode, page 5-20-Bits 1 TxCodec, RxCodec, NumTxFrames,
LBRCodec, ConnectMode, RxCodec,
RxCodec
Bit Number Definition
LBRCodec, NumTxFrames, TxCodec, AudioMode,
TxCodec
LBRCodec, NumTxFrames, RxCodec, AudioMode,
Examples
NumTxFrames
LBRCodec, RxCodec, TxCodec,
CallFeatures
Bit Number
CallFeatures, CallCmd, CallerIdMethod, SigTimer,
PaidFeatures
315
CallerIdMethod
0x00019e60
Polarity
316
ConnectMode
Use G.711µ-law for fax pass-through codec
TimeZone
Use G.711A-law for fax pass-through codec
AltNTPIP
NTPIP, AltNTPIP,
141
AltNTPIP, TimeZone,
916
NTPIP, TimeZone,
917
SigTimer
TftpURL, DHCP, VLANSetting,
OpFlags
VLANSetting
Optional Feature Parameters
NPrintf
0x0000002b
324
RingOnOffTime
Default Recommended Values
IPDialPlan
DialPlan
Additional DialPlan Information
About Dial Plan Commands
Following dial plan
Dial Plan Blocking In Rule
Following dial plans
Rule to Support Hotline/Warmline
Rule to Support Dial Prefix
Call-Progress Tone Parameters
List of Call-Progress Tone Parameters
Tone Parameter Syntax
Each tone is specified by nine integers, as follows
Recommended Values
How to Calculate Scaling Factors
Use the following formula to calculate the scaling factor a
Specific Call-Progress Tone Parameter Information
Default values for the nine-integer array
920
921
Cisco ATA plays the busy tone when the callee is busy
922
923
924
925
CallCmd
Maximum of 248 characters
CallFeatures, PaidFeatures, CallerIdMethod, SigTimer,
930
OL-4008-01
Call Commands
Call Command Structure
Syntax
CallCmd string has the following structure
Context-Identifiers
Identifier Context State of Cisco ATA
Input Sequence Identifiers
Action Identifiers
Identifier Input Sequence
Identifier Action
Call Command Example
Hook-flash Cancel-the-call-attempt Retrieve-the-waiting-call
Call Command Behavior
Call Command Default
Sweden Call Command Default
Table Notations
Call Command Behavior
WFE cancels the call-Stop CWT and revert to Connected state
CWT
Call Command Behavior
Call Command Behavior
OL-4008-01
Configuring and Debugging Fax Services
Using Fax Pass-through Mode
Configuring the Cisco ATA for Fax Pass-through mode
This setting translates to the following bitmap
AudioMode
AudioMode, ConnectMode,
Configuring Cisco IOS Gateways to Enable Fax Pass-through
Recommended Setting
This setting translates to the bitmap
Enable Fax Pass-through Mode, Disable Fax Relay Feature,
Enable Fax Pass-through Mode
Run the following command
Disable Fax Relay Feature
Perform the command
Using FAX Mode
Configuring the Cisco ATA for Fax Mode
Debugging the Cisco ATA 186/188 Fax Services
Configuring the Cisco ATA for Fax Mode on a Per-Call Basis
Configuring the Cisco IOS Gateway for Fax Mode
Common Problems When Using IOS Gateways
Problem Action
Cisco ATA, and 0x0012XXXX for the Phone 2 port
For fax pass-through mode, AudioMode should be set to
Port
Using prserv for Diagnosing Fax Problems
Prserv Overview
Analyzing prserv Output for Fax Sessions
Prserv Overview, Analyzing prserv Output for Fax Sessions,
Log event Description
Terminating-Gateway Example
Originating-Gateway Example
Possible Reasons for Failure
Rtpcatch Overview
Using rtpcatch for Diagnosing Fax Problems
To use rtpcatch, follow these steps
Example of rtpcatch
Output Files
Explanation
CED tone Detected
Fax relay mode Cisco fax relay mode
Analyzing rtpcatch Output for Fax Sessions
Analysis
Both sides use G.711 for the entire fax session
Example 7-4 T38 Fax Relay Mode
Using rtpcatch to Analyze Common Causes of Failure
Cisco fax relay option is not disabled on the gateway
Possible Causes for Failure
Possible Cause for Failure
Example 7-9 Fax Pass-through Mode Failure
Rtpcatch Limitations
Syntax of upgradecode Parameter
Upgrading the Signaling Image from a Tftp Server
Definitions
Upgrading the Signaling Image Manually
Upgradecode parameter value could be
Process
Preliminary Steps, Running the Executable File,
Preliminary Steps
Upgrade Requirements
Running the Executable File
Upgrade Procedure and Verification
To perform the upgrade, follow these steps
Procedure to Upgrade Signaling Image
Syntax
Using a Web Browser
Confirming a Successful Signaling Image Upgrade
Using a Web Browser, Using the Voice Configuration Menu,
Using the Voice Configuration Menu
Troubleshooting
General Troubleshooting Tips
Symptoms and Actions
Installation and Upgrade Issues
Debugging
Frequently Asked Questions
Ring Load per RJ-11 FXS Port Maximum Distance
Feet 762 m
Feet 975 m
Contacting TAC
OL-4008-01
Cancelling a Supplementary Service
Changing Call Commands
Common Supplementary Services
Call-Waiting Caller ID
Caller ID
Making a Conference Call in the United States
Making a Conference Call in Sweden
Call Waiting in the United States
Call Waiting in Sweden
Calling Line Identification Presentation
About Calling Line Identification Restriction
Calling Line Identification Restriction in Sweden
Table B-1lists codes to return basic Cisco ATA information
Voice Menu Option Code Description
Table B-2lists configuration codes
Password associated with the primary phone line
UID0 or LoginID0
Password associated with the secondary phone line
User ID telephone number for the Phone 1 port
User ID telephone number for the Phone 2 port
Option Code Description
Physical Specifications
This section describes Cisco ATA specifications
Dimensions Weight
Specification
Electrical Specifications
Environmental Specifications
Immunity Specifications
Description Specification
Software Specifications
Ringing Characteristics
Physical Interfaces
Appendix C Cisco ATA Specifications Software Specifications
Sccp
OL-4008-01
Signaling
Supported H.323 Messages
Endpoint-to-Gatekeeper Registration
Signaling Scenarios
Step Action Description
Table D-2 Log Listings
Table D-2 Log Listings
Endpoint-to-Endpoint Call Setup with a Common Gatekeeper
Step
Table D-4 Log Listings
Table D-4 Log Listings
Table D-4 Log Listings
Table D-4 Log Listings
Table D-4 Log Listings
Table D-4 Log Listings
Table D-4 Log Listings
Call Setup from H.323 Network to Circuit Switched Network
Action Description
CSN/PSTN
Step
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Table D-6 Log Listings
Null
Table D-6 Log Listings
GL-1
GL-2
GL-3
GL-4
Messages can be part of Sgcp and Mgcp messages
Signaling connection control part
GL-5
GL-6
Business-class services for Internet telephony
Traffic
Allow you to define your own customized markup language
GL-7
GL-8
Numerics
IN-1
IN-2
Ethernet ports Example configuration text file
Environmental specifications C-2
IN-3
Hotline/warmline Http refresh
Http reset
IN-4
Plar
IN-5
RJ-45 LED
IN-6
Troubleshooting
IN-7
IN-8