Cisco Systems ATA 188 Debugging

9-4

Cisco ATA 186 and Cisco ATA 188 Analog Telephone Adaptor Administrator’s Guide (H.323)

OL-4008-01

Chapter9 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, preser v.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 CiscoATA 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 ente ring the * key after every character entered. To

enter the "." character, you must enter the sequence 1 1#.

Contents

Main Page CONTENTS Page Page Page Page Page Page Page Preface Overview Audience Organization Conventions Page xiv Related Documentation Obtaining Documentation World Wide Web Documentation CD-ROM Ordering Documentation Documentation Feedback Obtaining Technical Assistance Cisco.com Technical Assistance Center Cisco TAC Web Site Cisco TAC Escalation Center Page Cisco Analog Telephone Adaptor Overview H.323 Overview H.323 Terminals H.323 Gateways H.323 Gatekeepers H.323 MCUs H.323 Proxy Server Hardware Overview Page Software Features Voice Codecs Supported Additional Supported Signaling Protocols Other Supported Protocols Cisco ATA H.323 Services Fax Services Supplementary Services Installation and Configuration Overview Page Installing the Cisco ATA Safety Recommendations What the Cisco ATA Package Includes What You Need Installation Procedure 2-3 Procedure Connect the other end to an analog telephone set. Page Power-Down Procedure Page Configuring the Cisco ATA for H.323 Default Boot Load Behavior Specifying a Preconfigured VLAN ID or Disabling VLAN IP Encapsulation Page Steps Needed to Configure the Cisco ATA Basic Configuration Steps in a TFTP Server Environment Basic Configuration Steps in a Non-TFTP Server Environment Configuring the Cisco ATA Using a TFTP Server Setting Up the TFTP Server with Cisco ATA Software Configurable Features and Related Parameters Creating Unique and Common Cisco ATA Configuration Files Page Using atapname.exe Tool to Obtain MAC Address Using the EncryptKey Parameter and cfgfmt Tool atadefault.cfg Configuration File Configuring the Cisco ATA to Obtain its Configuration File from the TFTP Server Using a DHCP Server Procedure if DHCP Server is Under Control of CiscoATA Administrator Procedure if DHCP Server is not Under Control of CiscoATA Administrator Other DHCP Options You Can Set Without Using a DHCP Server Voice Configuration Menu Using the Voice Configuration Menu Entering Alphanumeric Values Resetting the Cisco ATA to Factory Default Values Cisco ATA Web Configuration Page 3-19 Figure3-1 CiscoATA Web Configuration Page 1 Web Interface Access-Control Configuration Refreshing or Resetting the Cisco ATA HTTP Procedure to Refresh the Cisco ATA HTTP Procedure to Reset the Cisco ATA HTTP Refresh and Reset Access-Control Configuration Upgrading the H.323 Signaling Image Page Basic and Additional H.323 Services 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 Choosing Cisco ATA Registration Mode with an H.323 Gatekeeper Setting Up Gatekeeper Time-To-Live Value Setting Up an Alternate H.323 Gatekeeper Establishing Authentication with Cisco H.323 Gatekeeper Using the Cisco ATA Without an H.323 Gatekeeper Using the Cisco ATA With an H.323 Gateway but Without an H.323 Gatekeeper Using Multiple Cisco ATAs Without an H.323 Gatekeeper Setting the Audio Codecs Additional H.323 Services 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 Network Ringback Tone Configuring On-hook delay Configuring Reverse Audio Cut-Through Behavior Configuring Supplementary Service Behavior and Parameters Debugging Diagnostics Hardware Information Display Network Timing Polarity Settings Progress Tones Selecting DTMF and Hookflash Transmission Methods Selecting H.323 Connection and H.245 Transmission Methods Complete Reference Table of all Cisco ATA H.323 Services Page Page Parameters and Defaults Configuration Text File Template User Interface (UI) Parameter UIPassword Configuration-Complete Parameter ToConfig Parameters for Configuration Method and Encryption UseTFTP TftpURL CfgInterval EncryptKey Network Parameters DHCP StaticIp StaticRoute StaticNetMask Account Information Parameters UID0 PWD0 UID1 PWD1 Gateway UseLoginID LoginID0 LoginID1 AutMethod Gatekeeper Parameters GkOrProxy AltGk AltGkTimeOut GkTimeToLive GkId H.323 Mode Parameter UseSIP Operating Parameters MediaPort LBRCodec AudioMode RxCodec TxCodec NumTxFrames CallFeatures PaidFeatures CallerIdMethod Polarity ConnectMode TimeZone NTPIP AltNTPIP DNS1IP DNS2IP UDPTOS SigTimer OpFlags VLANSetting Optional Feature Parameters NPrintf RingOnOffTime IPDialPlan DialPlan About Dial Plan Commands Dial Plan Example 1 (Default Dial Plan) Dial Plan Example 2 Dial Plan Blocking (In Rule) 'H' Rule to Support Hotline/Warmline 'P' Rule to Support Dial Prefix Call-Progress Tone Parameters List of Call-Progress Tone Parameters Tone Parameter Syntax How to Calculate Scaling Factors Recommended Values Specific Call-Progress Tone Parameter Information DialTone BusyTone ReorderTone RingbackTone CallWaitTone AlertTone CallCmd Page Page Call Commands Call Command Structure Syntax Context-Identifiers Input Sequence Identifiers Action Identifiers Call Command Example 6-6 Call Command Behavior Page Page Page Page Page Configuring and Debugging Fax Services Using Fax Pass-through Mode Configuring the Cisco ATA for Fax Pass-through mode AudioMode ConnectMode Configuring Cisco IOS Gateways to Enable Fax Pass-through Enable Fax Pass-through Mode System Level commands Dial-Peer Level Commands Disable Fax Relay Feature Using FAX Mode Configuring the Cisco ATA for Fax Mode Configuring the Cisco ATA for Fax Mode on a Per-Call Basis Configuring the Cisco IOS Gateway for Fax Mode Debugging the Cisco ATA 186/188 Fax Services Common Problems When Using IOS Gateways Page Using prserv for Diagnosing Fax Problems prserv Overview Analyzing prserv Output for Fax Sessions Debugging FAX Pass-through Mode Debugging FAX Mode Using rtpcatch for Diagnosing Fax Problems rtpcatch Overview Major functions How to Use Output Files Example of rtpcatch Output Explanation Page Analyzing rtpcatch Output for Fax Sessions Page Using rtpcatch to Analyze Common Causes of Failure Page rtpcatch Limitations Upgrading the Cisco ATA Signaling Image Upgrading the Signaling Image from a TFTP Server Upgrading the Signaling Image Manually Preliminary Steps Running the Executable File Upgrade Requirements Syntax Upgrade Procedure and Verification Confirming a Successful Signaling Image Upgrade Using a Web Browser Using the Voice Configuration Menu Troubleshooting General Troubleshooting Tips Symptoms and Actions Installation and Upgrade Issues Debugging Frequently Asked Questions Page Contacting TAC Page A Using H.323 Supplementary Services Changing Call Commands Cancelling a Supplementary Service Common Supplementary Services Caller ID Call-Waiting 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 Page B Voice Menu Codes Page Page Page C Cisco ATA Specifications Physical Specifications Electrical Specifications Environmental Specifications Immunity Specifications Physical Interfaces Ringing Characteristics Software Specifications Page Page Page D H.323 Signaling Supported H.323 Messages H.323 Signaling Scenarios H.323 Endpoint-to-Gatekeeper Registration D-3 TableD-2 Log Listings 1. 2. D-4 TableD-2 Log Listings (continued) 3. 4. H.323 Endpoint-to-Endpoint Call Setup with a Common Gatekeeper Page Page D-8 Cisco ATA 186 and Cisco ATA 188 Analog Telephone Adaptor Administrators Guide (H.323) 3. 4. D-9 5. 6. D-10 Cisco ATA 186 and Cisco ATA 188 Analog Telephone Adaptor Administrators Guide (H.323) 7. 8. 9. D-11 10. 11. 12. D-12 13. D-13 14. 15. 16. D-14 H.323 Call Setup from H.323 Network to Circuit Switched Network capability. 17. 18. V Page D-17 TableD-6 Log Listings 1. 2. D-18 3. 4. D-19 5. 6. D-20 7. 8. 9. D-21 10. D-22 11. D-23 12. 13. D-24 14. D-25 15. D-26 16. D-27 D-28 D-29 D-30 D-31 17. 18. 19. 20. D-32 24. 25. 26. D-33 27. 28. 29. 30. 31. D-34 32. 33. GLOSSARY Numerics A C D E F G H I L M N P Q R S T U V X Page INDEX Numerics A B Page D E F G H I L M N O P R S T U V W