Home » Cisco Manuals » Telephony » Cisco ATA188-I2-A » Manual Viewer

Cisco ATA188-I2-A Administration Guide - Page 162

Analyzing prserv Output for Fax Sessions, Log event, Description

Get Cisco ATA188-I2-A PDF manuals and user guides

Add to My Manuals
Save this manual to your list of manuals

Page 162 highlights

Debugging the Cisco ATA 186/188 Fax Services Chapter 7 Configuring and Debugging Fax Services As prserv receives debug information from the Cisco ATA, it displays the information on the DOS screen and saves it to the output file .log. Once you are finished capturing debug information, you can stop prserv by entering Ctrl-C at the DOS prompt. If you restart the process without changing the name of the log file, any new debug information is appended to the end of the original file. Analyzing prserv Output for Fax Sessions The debug log obtained from prserv is for detecting simple configuration problems. Note A comprehensive understanding of the fax events requires the use of the rtpcatch tool (see the "Using rtpcatch for Diagnosing Fax Problems" section on page 7-12). Table 7-2 lists log events relevant to analyzing a fax session. Table 7-2 Debug Log Examples Log event Description [ch] Enable encoder Voice encoder type pt is enabled for the channel ch, where pt can be 0 for G.711µ-law, 4 for G.723.1, 8 for G.711A-law, and 18 for G.729. For example, [0]Enable encoder 4 indicates that the Cisco ATA transmitted G.723.1-encoded voice packets. [ch] DPKT 1st: , pt The first voice packet that the Cisco ATA received was of RTP payload type pt for the channel ch with timestamp of timestamp1, and the local decoding timestamp was set to timestamp2. For example, [0]DPKT 1st: 1491513359 1491512639, pt 4 indicates that the first RTP packet that the Cisco ATA received was G.723.1-encoded for channel 0. [ch] codec: => Voice codec switchover occurred. The voice encoder type switched from pt1 to pt2 for the channel ch. For example, [0]codec: 4 => 0 indicates that the local voice encoder on the Cisco ATA switched from G.723.1 to G.711µ-law. [ch] Rx MPT PT= Channel ch received an NSE packet of event with payload type of NSE pkt NSEpt. For event, c0XXXXXX indicates a CED tone event, and c1XXXXXX indicates a phase reversal event. For example, [0]Rx MPT PT=100 NSE pkt c0000000 indicates that the Cisco ATA received a CED tone event NSE packet with payload type of 100. [ch] Tx MPT PT= NSE Channel ch transmitted an NSE packet of event with payload type of pkt NSEpt. For event, c0XXXXXX indicates a CED tone event, and c1XXXXXX indicates a phase reversal event. For example, [0]Tx MPT PT=100 NSE pkt c0000000 indicates that the ATA transmitted a CED tone event NSE packet with payload type of 100. 7-10 Cisco ATA 186 and Cisco ATA 188 Analog Telephone Adaptor Administrator's Guide for H.323 (version 3.0) OL-4804-01

Section	Page
CiscoATA186 and CiscoATA188 Analog Telephone Adaptor Administrator’s Guide for H.323 (version...	1
Contents	3
Preface	11
Overview	11
Audience	11
Organization	12
Conventions	12
Related Documentation	16
Obtaining Documentation	16
World Wide Web	16
Documentation CD-ROM	17
Ordering Documentation	17
Documentation Feedback	17
Obtaining Technical Assistance	17
Cisco.com	18
Technical Assistance Center	18
Cisco TAC Web Site	18
Cisco TAC Escalation Center	19
Cisco Analog Telephone Adaptor Overview	21
H.323 Overview	22
H.323 Terminals	23
H.323 Gateways	23
H.323 Gatekeepers	24
H.323 MCUs	24
H.323 Proxy Server	24
Hardware Overview	25
Software Features	27
Voice Codecs Supported	27
Additional Supported Signaling Protocols	27
Other Supported Protocols	27
CiscoATA H.323 Services	28
Fax Services	29
Supplementary Services	29
Installation and Configuration Overview	29
Installing the CiscoATA	31
Safety Recommendations	31
What the CiscoATA Package Includes	32
What You Need	32
Installation Procedure	33
Power-Down Procedure	35
Configuring the CiscoATA for H.323	37
Default Boot Load Behavior	38
Specifying a Preconfigured VLAN ID or Disabling VLAN IP Encapsulation	39
Steps Needed to Configure the Cisco ATA	41
Basic Configuration Steps in a TFTP Server Environment	41
Basic Configuration Steps in a Non-TFTP Server Environment	43
Configuring the Cisco ATA Using a TFTP Server	44
Setting Up the TFTP Server with CiscoATA Software	44
Configurable Features and Related Parameters	44
Creating Unique and Common CiscoATA Configuration Files	45
Using atapname.exe Tool to Obtain MAC Address	47
Using Encryption With the cfgfmt Tool	48
Examples of Upgrading to Stronger Encryption Key	51
atadefault.cfg Configuration File	53
Configuring the Cisco ATA to Obtain its Configuration File from the TFTP Server	54
Using a DHCP Server	54
Without Using a DHCP Server	56
Voice Configuration Menu	56
Using the Voice Configuration Menu	57
Entering Alphanumeric Values	58
Resetting the CiscoATA to Factory Default Values	59
CiscoATA Web Configuration Page	59
Refreshing or Resetting the CiscoATA	61
Procedure to Refresh the CiscoATA	62
Procedure to Reset the CiscoATA	62
Obtaining CiscoATA Configuration File After Failed Attempt	62
Upgrading the H.323 Signaling Image	62
Basic and Additional H.323 Services	63
Important Basic H.323 Services	63
Required Parameters	63
Setting Up User IDs for the CiscoATA	65
Using the Cisco ATA with an H.323 Gatekeeper	65
Choosing Cisco ATA Registration Mode with an H.323 Gatekeeper	65
Setting Up Gatekeeper Time-To-Live Value	66
Setting Up an Alternate H.323 Gatekeeper	66
Establishing Authentication with Cisco H.323 Gatekeeper	67
Using the Cisco ATA Without an H.323 Gatekeeper	68
Using the Cisco ATA With an H.323 Gateway but Without an H.323 Gatekeeper	68
Using Multiple Cisco ATAs Without an H.323 Gatekeeper	68
Setting the Audio Codecs	69
Additional H.323 Services	69
Configurable Reboot of CiscoATA	70
Configuring Audio Packet Settings	70
Configuring Billable Features	70
Configuring the Call Waiting Permanent Default Setting	71
Configuring the CiscoATA Refresh Interval	71
Configuring Hook Flash Timing	71
Configuring the Mixing of Call Waiting Tone and Audio	71
Configuring Network Ringback Tone	72
Configuring Reverse Audio Cut-Through Behavior	72
Configuring Supplementary Service Behavior and Parameters	72
Debugging Diagnostics	72
Hardware Information Display	72
Network Timing	73
Polarity Settings	73
Progress Tones	73
Selecting DTMF and Hookflash Transmission Methods	73
Selecting H.323 Connection and H.245 Transmission Methods	74
Setting Dial Plans	74
Complete Reference Table of all CiscoATA H.323 Services	74
Parameters and Defaults	77
Configuration Text File Template	78
User Interface (UI) Security Parameter	79
UIPassword	79
Parameters for Configuration Method and Encryption	80
UseTFTP	80
TftpURL	81
CfgInterval	82
EncryptKey	82
EncryptKeyEx	83
Network Configuration Parameters	84
DHCP	84
StaticIp	85
StaticRoute	85
StaticNetMask	86
NTPIP	86
AltNTPIP	87
DNS1IP	87
DNS2IP	88
VLANSetting	88
H.323 Parameters	89
GkOrProxy	89
GkId	90
GkTimeToLive	90
AltGk	90
AltGkTimeOut	91
UID0	92
PWD0	92
UID1	93
PWD1	94
LoginID0	94
LoginID1	95
UseLoginID	95
AutMethod	96
Gateway	96
Audio Configuration Parameters	97
MediaPort	97
RxCodec	98
TxCodec	98
LBRCodec	99
AudioMode	100
NumTxFrames	101
TOS	102
Operational Parameters	102
CallFeatures	103
PaidFeatures	104
CallCmd	105
FeatureTimer	106
FeatureTimer2	107
SigTimer	107
ConnectMode	108
OpFlags	110
TimeZone	112
Telephone Configuration Parameters	113
CallerIdMethod	114
Polarity	115
FXSInputLevel	116
FXSOutputLevel	116
Tone Configuration Parameters	117
Tone Parameter Syntax—Basic Format	117
Tone Parameter Syntax—Extended Formats	119
Extended Format A	119
Extended Format B	120
Recommended Values	124
Specific Tone Parameter Information	124
DialTone	124
BusyTone	125
ReorderTone	125
RingbackTone	126
CallWaitTone	126
AlertTone	127
RingOnOffTime	127
Dial Plan Parameters	128
DialPlan	128
Dial Plan Commands	129
Dial Plan Rules	130
Dial Plan Examples	134
DialPlanEx	136
IPDialPlan	136
Diagnostic Parameters	136
NPrintf	137
SyslogIP	137
SyslogCtrl	138
CFGID—Version Parameter for CiscoATA Configuration File	139
Call Commands	141
Call Command Structure	141
Syntax	142
Context-Identifiers	143
Input Sequence Identifiers	144
Action Identifiers	144
Call Command Example	145
Call Command Behavior	147
Configuring and Debugging Fax Services	153
Using Fax Pass-through Mode	153
Configuring the Cisco ATA for Fax Pass-through mode	154
AudioMode	154
ConnectMode	155
Configuring Cisco IOS Gateways to Enable Fax Pass-through	155
Enable Fax Pass-through Mode	156
Disable Fax Relay Feature	157
Using FAX Mode	158
Configuring the Cisco ATA for Fax Mode	158
Configuring the Cisco ATA for Fax Mode on a Per-Call Basis	159
Configuring the Cisco IOS Gateway for Fax Mode	159
Debugging the Cisco ATA 186/188 Fax Services	159
Common Problems When Using IOS Gateways	159
Using prserv for Diagnosing Fax Problems	161
prserv Overview	161
Analyzing prserv Output for Fax Sessions	162
Using rtpcatch for Diagnosing Fax Problems	164
rtpcatch Overview	164
Example of rtpcatch	166
Analyzing rtpcatch Output for Fax Sessions	168
Using rtpcatch to Analyze Common Causes of Failure	170
rtpcatch Limitations	172
Upgrading the CiscoATA Signaling Image	173
Upgrading the Signaling Image from a TFTP Server	173
Upgrading the Signaling Image Manually	174
Preliminary Steps	175
Running the Executable File	175
Upgrade Requirements	175
Syntax	176
Upgrade Procedure and Verification	176
Confirming a Successful Signaling Image Upgrade	177
Using a Web Browser	177
Using the Voice Configuration Menu	178
Troubleshooting	179
General Troubleshooting Tips	179
Symptoms and Actions	180
Installation and Upgrade Issues	181
Debugging	182
Using System Diagnostics	183
Local Tone Playout Reporting	187
Obtaining Network Status Prior to Getting IP Connectivity	188
Obtaining Network Status After Getting IP Connectivity	189
DHCP Status HTML Page	190
Real-Time Transport Protocol (RTP) Statistics Reporting	190
Frequently Asked Questions	191
Contacting TAC	193
Using H.323 Supplementary Services	195
Changing Call Commands	195
Cancelling a Supplementary Service	195
Common Supplementary Services	195
Caller ID	196
Call-Waiting Caller ID	196
Making a Conference Call in the United States	196
Making a Conference Call in Sweden	197
Call Waiting in the United States	197
Call Waiting in Sweden	197
Calling Line Identification Presentation	197
About Calling Line Identification Restriction	198
Calling Line Identification Restriction in the United States	198
Calling Line Identification Restriction in Sweden	198
Voice Menu Codes	199
CiscoATASpecifications	203
Physical Specifications	203
Electrical Specifications	204
Environmental Specifications	204
Physical Interfaces	204
Ringing Characteristics	205
Software Specifications	205
H.323 Signaling	209
Supported H.323 Messages	209
H.323 Signaling Scenarios	210
H.323 Endpoint-to-Gatekeeper Registration	210
H.323 Endpoint-to-Endpoint Call Setup with a Common Gatekeeper	213
H.323 Call Setup from H.323 Network to Circuit Switched Network	222
Recommended CiscoATATone Parameter Values by Country	243
Glossary	259

Match case Limit results 1 per page

7-10

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

OL-4804-01

Chapter 7

Configuring and Debugging Fax Services

Debugging the Cisco ATA 186/188 Fax Services

As prserv receives debug information from the Cisco

ATA, it displays the information on the DOS screen

and saves it to the output file <port>.log.

Once you are finished capturing debug information, you can stop prserv by entering Ctrl-C at the DOS

prompt. If you restart the process without changing the name of the log file, any new debug information

is appended to the end of the original file.

Analyzing prserv Output for Fax Sessions

The debug log obtained from

prserv

is for detecting simple configuration problems.

Note

A comprehensive understanding of the fax events requires the use of the

rtpcatch

tool (see the

“Using

rtpcatch for Diagnosing Fax Problems” section on page 7-12

Table 7-2

lists log events relevant to analyzing a fax session.

Table 7-2

Debug Log Examples

Log event

Description

[

] Enable encoder <

Voice encoder type

is enabled for the channel

ch,

where

can be

for G.711μ-law, 4 for G.723.1, 8 for G.711A-law, and 18 for G.729.

For example,

[0]Enable encoder 4

indicates that the Cisco ATA

transmitted G.723.1-encoded voice packets.

[

] DPKT 1st:

timestamp1

timestamp2

>, pt <

The first voice packet that the Cisco ATA received was of RTP payload

type

for the channel

with timestamp of

timestamp1,

and the local

decoding timestamp was set to

timestamp2

For example,

[0]DPKT 1st: 1491513359 1491512639, pt 4

indicates

that the first RTP packet that the Cisco ATA received was

G.723.1-encoded for channel 0.

[

] codec: <

pt1

> => <

pt2

Voice codec switchover occurred. The voice encoder type switched

from

pt1

pt2

for the channel

For example,

[0]codec: 4 => 0

indicates that the local voice encoder

on the Cisco ATA switched from G.723.1 to G.711μ-law.

[

] Rx MPT PT=<

NSEpt

NSE pkt <

event

Channel

received an NSE packet of

event

with payload type of

NSEpt

. For

event

, c0XXXXXX indicates a CED tone event, and

c1XXXXXX indicates a phase reversal event.

For example,

[0]Rx MPT PT=100 NSE pkt c0000000

indicates that the

Cisco ATA received a CED tone event NSE packet with payload type of

100.

[

] Tx MPT PT=<

> NSE

pkt <

event

Channel

transmitted an NSE packet of

event

with payload type of

NSEpt

. For

event

, c0XXXXXX indicates a CED tone event, and

c1XXXXXX indicates a phase reversal event.

For example,

[0]Tx MPT PT=100 NSE pkt c0000000

indicates that the

ATA transmitted a CED tone event NSE packet with payload type of

100.