Page 142
Chapter 7 Configuring and Debugging Fax Services
Debugging the Cisco ATA 186/188 Fax Services
If the numeric codes for the G.711 codecs do not appear in the log, you need to check your AudioMode parameter setting on the Cisco ATA.
If the correct G.711 codecs appear in the log but your fax sessions still fail, check that the following conditions are true:
•The Cisco ATA software image version is 2.14 or above.
•The Cisco ATA model number is ATA186-I1, ATA186-I2, ATA 188-I1, or ATA188-I2.
•The fax relay option for the remote gateways has been disabled.
Using rtpcatch for Diagnosing Fax Problems
This section contains the following topics:
•rtpcatch Overview, page 7-12
•Example of rtpcatch, page 7-13
•Analyzing rtpcatch Output for Fax Sessions, page 7-16
•Using rtpcatch to Analyze Common Causes of Failure, page 7-18
•rtpcatch Limitations, page 7-20
rtpcatch Overview
rtpcatch is a tool that provides comprehensive information for a VoIP connection. The tool runs on a Microsoft Windows-based PC and is capable of parsing an output capture file from Network Associates (NAI) Sniffer Pro and identifies significant fax pass-through and fax relay events.
Major functions
rtpcatch includes the following major functions:
•Reads session data from Sniffer Pro capture files.
•Analyzes media streams.
•Stores media streams to files.
•Reports RTP statistics such as the number of RTP packets, the number of RTP frames, the number of lost packets, the number of filler packets during silence suppression periods, and the number of erased packets.
How to Use
To use rtpcatch, follow these steps:
Procedure
Step 1 Create a working directory for rtpcatch and place the executable file rtpcatch.exe in this directory.
Step 2 Copy your Network Associates Sniffer Pro capture files into this directory.
Step 3 At the DOS prompt of this directory, enter the following command:
:>rtpcatch <cap_file> [<prefix>] [options]
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
Chapter Description
Organization
Conventions
Xii
Xiii
Related Documentation
Xiv
Documentation CD-ROM
Obtaining Documentation
World Wide Web
Ordering Documentation
Technical Assistance Center
Obtaining Technical Assistance
Cisco.com
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
Voice Codecs Supported
Software Features
Additional Supported Signaling Protocols
Other Supported Protocols
Cisco ATA H.323 Services
Supplementary Services
Installation and Configuration Overview
Fax Services
Action Reference
Manual-upgrade method
Upgrading the Cisco ATA Signaling
Image by using the Tftp server-upgrade method or
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
OpFlags
VLANSetting,
Parameter and Bits Reference
OpFlags,
Bits
VLANSetting
Feature
Example
Atadefault.cfg Configuration File,
Steps Needed to Configure the Cisco ATA
Basic Configuration Steps in a Tftp Server Environment
Upgrading the Signaling Image from a Tftp Server
Configuration File from the Tftp Server,
Basic Configuration Steps in a Non-TFTP Server Environment
Configuring the Cisco ATA to Obtain its
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
Related Parameter
Web Interface Access-Control Configuration
Refreshing or Resetting the Cisco ATA
OpFlags, page 5-33-Bit
Http Procedure to Reset the Cisco ATA
Upgrading the H.323 Signaling Image
Http Procedure to Refresh 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
Related Configuration Parameters
Setting Up User IDs for the Cisco ATA
Using the Cisco ATA with an H.323 Gatekeeper
UID0, UID1,
LoginID0, LoginID1, UID0, UID1,
Setting Up Gatekeeper Time-To-Live Value
Setting Up an Alternate H.323 Gatekeeper
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,
IPDialPlan,
Additional H.323 Services
Setting the Audio Codecs
LBRCodec, AudioMode,
Configuring Audio Packet Settings
Configuring Billable Features
Configuring Hook Flash Timing
Configuring the Call Waiting Permanent Default Setting
Configuring the Cisco ATA Refresh Interval
Configuring the Mixing of Call Waiting Tone and Audio
Configuring Supplementary Service Behavior and Parameters
Configuring On-hook delay
Configuring Reverse Audio Cut-Through Behavior
Debugging Diagnostics
Progress Tones
Polarity Settings
Network Timing
Selecting Dtmf and Hookflash Transmission Methods
ConnectMode, page 5-28-Bits 0
Setting Dial Plans
Selecting H.323 Connection and H.245 Transmission Methods
DialPlan,
Configurable Features Related Parameters
OL-4008-01
Parameters and Defaults
Configuration Text File Template
User Interface UI Parameter
UIPassword
This section contains only one parameter-UIPassword
Sections that follow describe these parameters
Parameters for Configuration Method and Encryption
Configuration-Complete Parameter
ToConfig
UseTFTP
Settings
Range Default Voice Configuration Menu Access Code
TftpURL
UseTFTP, CfgInterval,
CfgInterval
EncryptKey
UseTFTP, TftpURL,
320
Network Parameters
DHCP, StaticIp, StaticRoute, StaticNetMask,
StaticRoute
Voice Configuration Menu Access Code Related Parameters
StaticIp
DHCP, StaticRoute, StaticNetMask,
DHCP, StaticIp, StaticNetMask,
Account Information Parameters
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,
AutMethod
LoginID1
LoginID0, PWD0, PWD1, UseLoginID, AutMethod,
Bitmap
AltGk, AltGkTimeOut, GkTimeToLive, GkId,
LoginID0, LoginID1, PWD0, PWD1, NTPIP, AltNTPIP,
GkOrProxy, AltGk, AltGkTimeOut, GkTimeToLive, GkId,
Gatekeeper Parameters
Integer
AltGkTimeOut
AltGk
30 to 4294967295 seconds
GkId
Default Range
GkTimeToLive
Not specified
Operating Parameters
Mode Parameter
Use H.323 mode -Use SIP mode
UseSIP
MediaPort
DNS2IP, UDPTOS, SigTimer, OpFlags, VLANSetting,
UDPTOS, VLANSetting,
LBRCodec
AudioMode, page 5-20-Bits 1 TxCodec, RxCodec, NumTxFrames,
AudioMode
RxCodec, TxCodec,
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
141
AltNTPIP
NTPIP, AltNTPIP,
AltNTPIP, TimeZone,
916
NTPIP, TimeZone,
917
SigTimer
TftpURL, DHCP, VLANSetting,
OpFlags
VLANSetting
0x0000002b
Optional Feature Parameters
NPrintf
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
Tone Parameter Syntax
Call-Progress Tone Parameters
List of Call-Progress Tone Parameters
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
Identifier Input Sequence
Input Sequence Identifiers
Action Identifiers
Identifier Action
Call Command Example
Hook-flash Cancel-the-call-attempt Retrieve-the-waiting-call
Sweden Call Command Default
Call Command Behavior
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
AudioMode
Configuring the Cisco ATA for Fax Pass-through mode
This setting translates to the following bitmap
AudioMode, ConnectMode,
This setting translates to the bitmap
Configuring Cisco IOS Gateways to Enable Fax Pass-through
Recommended Setting
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
Configuring the Cisco IOS Gateway for Fax Mode
Debugging the Cisco ATA 186/188 Fax Services
Configuring the Cisco ATA for Fax Mode on a Per-Call Basis
Common Problems When Using IOS Gateways
For fax pass-through mode, AudioMode should be set to
Problem Action
Cisco ATA, and 0x0012XXXX for the Phone 2 port
Port
Analyzing prserv Output for Fax Sessions
Using prserv for Diagnosing Fax Problems
Prserv Overview
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
Analysis
Fax relay mode Cisco fax relay mode
Analyzing rtpcatch Output for Fax Sessions
Both sides use G.711 for the entire fax session
Example 7-4 T38 Fax Relay Mode
Possible Causes for Failure
Using rtpcatch to Analyze Common Causes of Failure
Cisco fax relay option is not disabled on the gateway
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
Process
Upgrading the Signaling Image Manually
Upgradecode parameter value could be
Preliminary Steps, Running the Executable File,
Preliminary Steps
Upgrade Requirements
Running the Executable File
Procedure to Upgrade Signaling Image
Upgrade Procedure and Verification
To perform the upgrade, follow these steps
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
Call Waiting in Sweden
Making a Conference Call in Sweden
Call Waiting in the United States
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
UID0 or LoginID0
Table B-2lists configuration codes
Password associated with the primary phone line
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
Dimensions Weight
Physical Specifications
This section describes Cisco ATA specifications
Specification
Immunity Specifications
Electrical Specifications
Environmental 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
Allow you to define your own customized markup language
Business-class services for Internet telephony
Traffic
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