Page 43
Chapter 3 Configuring the Cisco ATA for MGCP
Configuring the Cisco ATA Using a TFTP Server
For an example of how to configure parameters for the TFTP Server configuration method, see the “Creating Unique and Common Cisco ATA Configuration Files” section on page 3-9.
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 MGCP parameters in the examples. See Chapter 4, “Cisco ATA-Supported MGCP Services,” for complete listings and descriptions of required parameters and additional configurable features. Also, refer back to Table 3-3 on page 3-6for all main configuration steps.
Procedure
Step 1 Use the mgcp_example.txt file as a template for creating a text file of values that are common to one group of Cisco ATAs. The mgcp_example.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 mgcp_example.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 the following parameters:
UseTftp:1
DHCP:1
TFtpURL:10.10.10.1
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 for MGCP (version 3.0)
Contents
Text Part Number OL-4803-01
Corporate Headquarters
Copyright 2003, Cisco Systems, Inc All rights reserved
Iii
N T E N T S
Safety Recommendations
Dhcp
CA0UID CA1UID
Vii
NPrintf TraceFlags
Viii
Installation and Upgrade Issues
Audience
Objectives
This preface includes the following sections
Chapter Description
Organization and Use
Conventions
Organization
Bewaar Deze Instructies
Avvertenza Importanti Istruzioni Sulla Sicurezza
Warnung Wichtige Sicherheitshinweise
Xii
Xiii
Aviso Instruções Importantes DE Segurança
Use this guide in conjunction with these documents
Related Documentation
Xiv
Ordering Documentation
Obtaining Documentation
Cisco.com
Documentation CD-ROM
Xvi
Obtaining Technical Assistance
Documentation Feedback
You can order Cisco documentation in these ways
Xvii
Technical Assistance Center
Cisco TAC Website
Cisco TAC Escalation Center
Xviii
Obtaining Additional Publications and Information
Cisco Analog Telephone Adaptor Overview
Pstn
Overview of Media Gateway Control Protocol
Link LED
Hardware Overview
Function Button
Voice Codecs Supported
Software Features
Cisco ATA supports the following protocols and services
Mgcp Versions
729A 729B 729.AB
Additional Supported Signaling Protocols
Cisco ATA Mgcp Services
Other Supported Protocols
Supplementary Services that the Cisco ATA Provides
Fax Services
Service Parameter
Supplementary Services that the Call Agent Provides
Action Reference
Installation and Configuration Overview
Signaling image by using the Tftp server-upgrade method or
Manual-upgrade method
OL-4803-01
Installing the Cisco ATA
Network Requirements
Safety Recommendations
What the Cisco ATA Package Includes
5V power adaptor Power cord
Installation Procedure
What You Need
Cisco ATA 186 Rear Panel Connections
Procedure
Installing the Cisco ATA Installation Procedure
Power-Down Procedure
Configuring the Cisco ATA for Mgcp
Default Boot Load Behavior
Page
Bits
VLANSetting
Feature
Parameter and Bits Reference
Basic Configuration Steps in a Tftp Server Environment
Steps Needed to Configure the Cisco ATA
Hexadecimal format, this value is 0x01cc002b
Action Reference
Tftp server at boot up time
Action
Basic Configuration Steps in a Non-TFTP Server Environment
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
Syntax
Save this file of Cisco ATA-specific parameters as
Cfgfmt -mgcp -tptag.datata0a141e28323c.txt ata0a141e28323c
Using atapname.exe Tool to Obtain MAC Address
Command Example
Using Encryption With the cfgfmt Tool
Command Output
Non-zero
Total Binary Output Size
Syntax Definitions-Options
Syntax of the cfgfmt tool follows
Syntax Definitions-Required Parameters
Syntax examples
Examples of Upgrading to Stronger Encryption Key
Ata102030405060 is unencrypted
Atadefault.cfg Configuration File
Using a Dhcp Server,
Using a Dhcp Server
Other Dhcp Options You Can Set
Without Using a Dhcp Server
Voice Configuration Menu
Voice Menu Number Features
Using the Voice Configuration Menu
Voice Menu Number
Entering Alphanumeric Values
Resetting the Cisco ATA to Factory Default Values
Cisco ATA Web Configuration
Key Alphanumeric Characters
Cisco ATA Web Configuration
Refreshing or Resetting the Cisco ATA
Procedure to Refresh the Cisco ATA
Upgrading the Mgcp Signaling Image
Procedure to Reset the Cisco ATA
Cisco ATA-Supported Mgcp Services
Required Parameters
Important Basic Mgcp Services
Setting the Codec
Configuring Refresh Interval
Endpoints and Connections
Additional Mgcp Services
Syntax Type
Call Agent Redundancy with Configuration Parameters
Mgcp Endpoint Device Type
Cisco ATA Registration Process with Mgcp
Rsip Message for Disconnect State
Complete Reference Table of all Cisco ATA Mgcp Services
Configurable Feature Related Parameter
Related CIsco ATA Parameter
Supported Signals and Events
Supported Mgcp Connection Modes
Supported Local Connection Options
NCS 1.0 L-Package Supported by the Cisco ATA with Mgcp
Intermittent dial tone Timer Dtmf input
Code Description Type
Mgcp 0.1-1.0 G-Package Supported by the Cisco ATA with Mgcp
Mgcp 0.1-1.0 L-Package Supported by the Cisco ATA with Mgcp
Wt1, wt2, wt3, wt4 Call-waiting tone Dtmf tones wildcard
Mgcp 0.1-1.0 D-Package Supported by the Cisco ATA with Mgcp
Commands Supported with Mgcp
Operation failed Rbk### Rt@connection id
Parameters in Responses Sent to the Call Agent
Parameters in Commands Sent to the Call Agent
Parameter Usage
Mgcp Embedded Events
Example HdA, ESdl, Roc, 0-9#TD, D1xxxxxxxxxx9011x.T
OL-4803-01
Parameters and Defaults
IP address e.g Integer 32-bit integer Numeric digit string
Configuration Text File Template
Range
UIPassword
User Interface UI Security Parameter
Value Type
UseTFTP
Parameters for Configuration Method and Encryption
905
TftpURL
CfgInterval
Maximum 31 characters
EncryptKey
EncryptKeyEx
Range Default
Network Configuration Parameters
Not applicable for this parameter
IP address
Voice Configuration Menu Access Code Related Parameters
StaticIp
StaticRoute
255.255.255.0
StaticNetMask
916
Related parameter
Vlan Setting
CA0orCM0
Mgcp Configuration Parameters
Examples
Specify the ID of the primary Call Agent in this parameter
CA1orCM1
EPID0orSID0 and EPID1orSID1
Voice Configuration Menu Access Codes
Value Types
LBRCodec
PrfCodec
Integer
201
MGCPPort
300
2427
RetxIntvl
MediaPort
RetxLim
Alphanumeric
MGCPVer
Domain
205
CodecName
Audio Configuration Parameters
931
AudioMode
Default Names
Bit Number Definition
NumTxFrames
Operational Parameters
CallerIdMethod
Parameters and Defaults Operational Parameters
FXSOutputLevel
FXSInputLevel
311
ConnectMode
371
0x90000400
Bit Number
SigTimer
0x2
OpFlags
Bit Number Definition
0x000068B8
Tone Configuration Parameters
255
Each tone is specified by nine integers, as follows
Tone Parameter Syntax-Basic Format
Extended Format a
Tone Parameter Syntax-Extended Formats
Each tone is specified by 11 integers, as follows
Cadence With Two On-Off Pairs
Extended Format B
Cadence with Three On-Off Pairs
ReorderTone Parameter Example1
Component Setting Explanation
ReorderTone Parameter Example
DialTone
Default values using the Basic format
Recommended Values
Specific Tone Parameter Information
ReorderTone
BusyTone
923
RingbackTone
CallWaitTone
922
925
AlertTone
OffTime-2400 TotalToneTime-4800
924
NPrintf
Diagnostic Parameters
Default Recommended Values
RingCadence
0x00000000
TraceFlags
SyslogIP
Extended IP address
Bit Number Type of Messages to Trace
SyslogCtrl
RTP statistics messages Reserved
CFGID-Version Parameter for Cisco ATA Configuration File
OL-4803-01
Using Fax Pass-through Mode
Configuring and Debugging Fax Services
AudioMode
Configuring the Cisco ATA for Fax Pass-through mode
Fax Pass-through mode requires configuring two parameters
This setting translates to the following bitmap
ConnectMode
Configuring Cisco IOS Gateways to Enable Fax Pass-through
Recommended Setting
This setting translates to the bitmap
Run the following command
Enable Fax Pass-through Mode
Perform the command
Disable Fax Relay Feature
Configuring the Cisco ATA for Fax Mode
Using FAX Mode
Problem Action
Debugging the Cisco ATA 186/188 Fax Services
Configuring the Cisco IOS Gateway for Fax Mode
Common Problems When Using IOS Gateways
Port
Using prserv for Diagnosing Fax Problems
Cisco ATA, and 0x0012XXXX for the Phone 2 port
For fax pass-through mode, AudioMode should be set to
Analyzing prserv Output for Fax Sessions
Prserv Overview
Encoded for channel
Log event Description
Decoding timestamp was set to timestamp2
That the first RTP packet that the Cisco ATA received was
Possible Reasons for Failure
Originating-Gateway Example
Rtpcatch Overview
Using rtpcatch for Diagnosing Fax Problems
To use rtpcatch, follow these steps
Output Files
Example of rtpcatch
Explanation
CED tone Detected
Both sides use G.711 for the entire fax session
Fax relay mode Cisco fax relay mode
Analyzing rtpcatch Output for Fax Sessions
Analysis
Example 6-3 Fax Pass-through Mode
Using rtpcatch to Analyze Common Causes of Failure
Possible Causes for Failure
Cisco fax relay option is not disabled on the gateway
Possible Cause for Failure
Example 6-9 Fax Pass-through Mode Failure
Rtpcatch Limitations
Syntax of upgradecode Parameter
Upgrading the Signaling Image from a Tftp Server
Definitions
Upgradecode parameter value could be
Upgrading the Signaling Image Manually
Process
Syntax
Upgrade Requirements
Preliminary Steps
Running the Executable File
To perform the upgrade, follow these steps
Upgrade Procedure
Using a Web Browser
Confirming a Successful Signaling Image Upgrade
OL-4803-01
General Troubleshooting Tips
Troubleshooting
Symptoms and Actions
Installation and Upgrade Issues
Debugging
2* 1 1* 2* 8* 1 1* 7* 8* 1 1* 9* 0* 1 1* 9* 0* 0
You should also have access to a sniffer or LAN analyzer
Syntax Definitions
Using System Diagnostics
Message Syntax
PriorityTimeOffset Ataip tag chMessage
Example-DHCP Messages
Example-ARP Message
Example-TFTP messages
Example-System Reboot Message
Example-Cisco ATA Configuration Update Message
Example-Cisco ATA Event Messages
Example-Fax Event Messages
Local Tone Playout Reporting
Example-RTP Statistic Messages
Tone Type ID Description
Bit Number Description
Obtaining Network Status After Getting IP Connectivity
Bit Number Description Boolean Value
Checksum error for configuration file
Cisco ATA failed to upgrade to the downloaded image file
Configuration file is not found
Bad configuration file
Real-Time Transport Protocol RTP Statistics Reporting
Dhcp Status Html
Resetting Cisco ATA counters
Frequently Asked Questions
Ring Load per RJ-11 FXS Port Maximum Distance
Contacting TAC
OL-4803-01
Voice Menu Option Code Description
Table A-1lists codes to return basic Cisco ATA information
DNS 2 IP
916 IP address of the primary DNS server
Tftp URL
OL-4803-01
Specification
Physical Specifications
This section describes Cisco ATA specifications
Dimensions Weight
Physical Interfaces
Electrical Specifications for Cisco ATA
Environmental Specifications
Description Specification
Software Specifications
Ringing Characteristics
Tip/ring interfaces for each RJ-11 FXS port Slic
Appendix B Cisco ATA Specifications Software Specifications
Sccp
OL-4803-01
Mgcp Call Flows
Appendix C Mgcp Call Flows
Step Action Log
OK-Cisco ATA 2 to Call Agent
Cisco ATA 1 dials 6-Cisco ATA 1 to Call Agent
Cisco ATA 2 phone rings and displays Cisco ATA 1 ID on CID
Device-Call Agent to Cisco ATA
Ringback stops on Cisco ATA 1-Call Agent to Cisco ATA
Routing Update Protocol RTP Media stream is now enabled on
RTP Media stream is now enabled on Cisco ATA 1. Both
Cisco ATA 2-Call Agent to Cisco ATA
Agent to Cisco ATA
ATA 2 Connection mode changes to receive-only-Call Agent to
Cisco ATA 2 hangs up-Cisco ATA 2 to Call Agent
Cisco ATA 2 Connection is deleted-Call Agent to Cisco ATA
Recommended Cisco ATA Tone Parameter Values by Country
OL-4803-01
Table D-1 Argentina
Table D-5 Brazil
Table D-9 Czech Republic
Table D-13 France
Table D-17 Hungary
Table D-21 Ireland
Table D-25 Korea
Table D-29 Netherlands
Table D-33 Panama
Table D-37 Portugal
Table D-41 Slovakia
Table D-45 Sweden
Parameter Recommended Values
OL-4803-01
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
GL-7
Business-class services for Internet telephony
Traffic
Allow you to define your own customized markup language
GL-8
IN-1
Bootload
Codec negotiation in sending fax
Codecs Cabling requirements LBRCodec Call Agent Supported
EncryptKey
CallerIdMethod CfgInterval CodecName ConnectMode Dhcp
IN-2
IN-3
IN-4
Debugging Services
Fax mode 6-1,6-6 Configuration
Fax relay disabling
IN-5
RTP payload type RTP statistics reporting
Cisco ATA RSIP*@ipaddress syntax setting
IN-6
IN-7
IN-8