Page 42
Chapter 3 Configuring the Cisco ATA for H.323
Configuring the Cisco ATA Using a TFTP Server
Note Be sure to configure the UseSIP parameter to the value of 0 (its default) to enable the H.323 protocol.
Creating Unique and Common Cisco ATA Configuration Files
If you have many Cisco ATAs to configure, a good approach is to create two configuration files:
•One file that will contain only parameter values unique to a specific Cisco ATA.
•One file for parameters that will be configured with values common to a group of Cisco ATAs. If this file is updated, all Cisco ATA devices in this common group can obtain the new configuration data in a batch-mode environment.
The following procedure demonstrates the steps needed to create these configuration files.
Note The parameters used in this section help illustrate the process of creating a unique Cisco ATA configuration file, and do not include all required H.323 parameters in the examples. See Chapter 5, “Parameters and Defaults,” for complete listings and descriptions of required parameters and additional configurable features. Also, refer back to Table 3-3 on page 3-5for all main configuration steps.
Procedure
Step 1 Use the example_uprofile.txt file as a template for creating a text file of values that are common to one group of Cisco ATAs. The example_uprofile.txt file is included in the software-release zip file and contains all default values. This file is shown without its annotations in the “Configuration Text File Template” section on page 5-2.
Copy the example_uprofile.txt file and save it with a meaningful name, such as common.txt.
Step 2 Configure all common parameters by editing the text file as desired. For example, you might configure some parameters as follows:
ToConfig:0
UseTftp:1
DHCP:1
TFtpURL:10.10.10.1
UseSIP:0
Tip It is helpful to always include the parameter/value of ToConfig:0 in the Cisco ATA configuration file so that every time this file is downloaded to the Cisco ATA, it will set ToConfig to 0, which the appropriate value for this parameter once the Cisco ATA has been configured. If ToConfig is 1, the Cisco ATA will continue to unnecessarily contact the TFTP server.
The settings in this example indicate that a group of Cisco ATAs is using the TFTP server with an IP address of 10.10.10.1 to obtain their configuration files. These Cisco ATAs will use a DHCP server to obtain their own IP addresses but not to obtain the TFTP server IP address (because the TftpURL parameter has a configured value).
Step 3 Save your changes.
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
Overview
Audience
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 Web Site
Cisco TAC Escalation Center
Xvii
Xviii
Cisco Analog Telephone Adaptor Overview
Cisco ATA 186 as Endpoint in an H.323 Network
Terminals
Gateways
Gatekeepers
MCUs
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
Installation Procedure
What the Cisco ATA Package Includes
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,
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
Save this file of Cisco ATA-specific parameters as
Syntax
Using atapname.exe Tool to Obtain MAC Address
Command Example
Command Output
Using the EncryptKey Parameter and cfgfmt Tool
Syntax examples
Atadefault.cfg Configuration File
Using a Dhcp Server,
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
Cisco ATA Web Configuration
Resetting the Cisco ATA to Factory Default Values
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 the Cisco ATA Without an H.323 Gatekeeper
Using Multiple Cisco ATAs 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
Configuration-Complete Parameter
Parameters for Configuration Method and Encryption
ToConfig
UseTFTP
Settings
Range Default Voice Configuration Menu Access Code
TftpURL
UseTFTP, CfgInterval,
CfgInterval
EncryptKey
UseTFTP, TftpURL,
Network Parameters
320
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
UseLoginID
LoginID0
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
TxCodec
LBRCodec, NumTxFrames, TxCodec, AudioMode,
LBRCodec, NumTxFrames, RxCodec, AudioMode,
NumTxFrames
Examples
LBRCodec, RxCodec, TxCodec,
CallFeatures
Bit Number
PaidFeatures
CallFeatures, CallCmd, CallerIdMethod, SigTimer,
315
CallerIdMethod
Polarity
0x00019e60
316
ConnectMode
TimeZone
Use G.711µ-law for fax pass-through codec
Use G.711A-law for fax pass-through codec
141
AltNTPIP
NTPIP, AltNTPIP,
AltNTPIP, TimeZone,
NTPIP, TimeZone,
916
917
SigTimer
TftpURL, DHCP, VLANSetting,
OpFlags
VLANSetting
0x0000002b
Optional Feature Parameters
NPrintf
324
Default Recommended Values
RingOnOffTime
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
How to Calculate Scaling Factors
Recommended Values
Use the following formula to calculate the scaling factor a
Default values for the nine-integer array
Specific Call-Progress Tone Parameter Information
920
Cisco ATA plays the busy tone when the callee is busy
921
922
923
924
CallCmd
925
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
Using rtpcatch for Diagnosing Fax Problems
Rtpcatch Overview
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
Upgrading the Signaling Image from a Tftp Server
Syntax of upgradecode Parameter
Definitions
Process
Upgrading the Signaling Image Manually
Upgradecode parameter value could be
Preliminary Steps, Running the Executable File,
Upgrade Requirements
Preliminary Steps
Running the Executable File
Procedure to Upgrade Signaling Image
Upgrade Procedure and Verification
To perform the upgrade, follow these steps
Syntax
Confirming a Successful Signaling Image Upgrade
Using a Web Browser
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
Changing Call Commands
Cancelling a Supplementary Service
Common Supplementary Services
Caller ID
Call-Waiting 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
Ringing Characteristics
Software Specifications
Physical Interfaces
Appendix C Cisco ATA Specifications Software Specifications
Sccp
OL-4008-01
Signaling
Supported H.323 Messages
Signaling Scenarios
Endpoint-to-Gatekeeper Registration
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
Signaling connection control part
Messages can be part of Sgcp and Mgcp messages
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
Environmental specifications C-2
Ethernet ports Example configuration text file
IN-3
Http reset
Hotline/warmline Http refresh
IN-4
Plar
IN-5
RJ-45 LED
IN-6
Troubleshooting
IN-7
IN-8