Page 141
Chapter 7 Upgrading the Cisco ATA Signaling Image
Upgrading the Signaling Image Manually
Preliminary Steps
Before you run the executable file, be sure to complete the following procedure:
Procedure
Step 1 If you are a registered CCO user. go to the following URL:
http://www.cisco.com/cgi-bin/tablebuild.pl/ata186
Step 2 Locate the zip file that contains the software for the applicable release and signaling image you are using. The contents of each file are described next to the file name. Extract the signaling image file (this file has an extension of .zup—For example, ata186-v2-15-020723a.zup) and store it on the PC that has connectivity with the Cisco ATA.
Step 3 Set the Cisco ATA parameter UseTftp to 0.
Note Remember to set this parameter back to 1 before you use the TFTP upgrade method at a later time.
Step 4 Follow the instructions in the “Running the Executable File” section on page 7-3.
Running the Executable File
This section includes the procedure for running the executable file and using the voice configuration menu to complete the upgrade process. First check to make sure the upgrade requirements are met and determine the syntax to use when running the program.
This section contains the following topics:
•“Upgrade Requirements” section on page 7-3
•“Syntax” section on page 7-3
•“Upgrade Procedure” section on page 7-4
Upgrade Requirements
The following list contains the requirements for using the ata186us.exe file and the voice configuration menu to upgrade the Cisco ATA to the latest signaling image:
•A network connection between the PC from which you will invoke the executable file and the Cisco ATA
•A PC running Microsoft Windows 9X/ME/NT/2000
Syntax
ata186us [-any]{-h[host_ip]} {-p[port]} {-quiet} [-d1 -d2 -d3] <image file>
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
Objectives
Audience
This preface includes the following sections
Conventions
Organization and Use
Organization
Chapter Description
Bewaar Deze Instructies
Warnung Wichtige Sicherheitshinweise
Avvertenza Importanti Istruzioni Sulla Sicurezza
Xii
Xiii
Aviso Instruções Importantes DE Segurança
Related Documentation
Use this guide in conjunction with these documents
Xiv
Cisco.com
Obtaining Documentation
Documentation CD-ROM
Ordering Documentation
Documentation Feedback
Obtaining Technical Assistance
You can order Cisco documentation in these ways
Xvi
Cisco TAC Website
Technical Assistance Center
Cisco TAC Escalation Center
Xvii
Xviii
Obtaining Additional Publications and Information
Cisco Analog Telephone Adaptor Overview
Pstn
Overview of Media Gateway Control Protocol
Link LED
Hardware Overview
Function Button
Cisco ATA supports the following protocols and services
Software Features
Mgcp Versions
Voice Codecs Supported
Cisco ATA Mgcp Services
Additional Supported Signaling Protocols
Other Supported Protocols
729A 729B 729.AB
Fax Services
Supplementary Services that the Cisco ATA Provides
Service Parameter
Supplementary Services that the Call Agent Provides
Signaling image by using the Tftp server-upgrade method or
Installation and Configuration Overview
Manual-upgrade method
Action Reference
OL-4803-01
Installing the Cisco ATA
Safety Recommendations
Network Requirements
What the Cisco ATA Package Includes
Installation Procedure
5V power adaptor Power cord
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
Feature
VLANSetting
Parameter and Bits Reference
Bits
Steps Needed to Configure the Cisco ATA
Basic Configuration Steps in a Tftp Server Environment
Hexadecimal format, this value is 0x01cc002b
Action Reference
Tftp server at boot up time
Action
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
Syntax
Save this file of Cisco ATA-specific parameters as
Cfgfmt -mgcp -tptag.datata0a141e28323c.txt ata0a141e28323c
Using atapname.exe Tool to Obtain MAC Address
Using Encryption With the cfgfmt Tool
Command Example
Command Output
Non-zero
Total Binary Output Size
Syntax of the cfgfmt tool follows
Syntax Definitions-Options
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
Cisco ATA Web Configuration
Resetting the Cisco ATA to Factory Default Values
Key Alphanumeric Characters
Cisco ATA Web Configuration
Refreshing or Resetting the Cisco ATA
Upgrading the Mgcp Signaling Image
Procedure to Refresh the Cisco ATA
Procedure to Reset the Cisco ATA
Cisco ATA-Supported Mgcp Services
Setting the Codec
Important Basic Mgcp Services
Configuring Refresh Interval
Required Parameters
Endpoints and Connections
Additional Mgcp Services
Mgcp Endpoint Device Type
Call Agent Redundancy with Configuration Parameters
Cisco ATA Registration Process with Mgcp
Syntax Type
Rsip Message for Disconnect State
Complete Reference Table of all Cisco ATA Mgcp Services
Configurable Feature Related Parameter
Supported Mgcp Connection Modes
Supported Signals and Events
Supported Local Connection Options
Related CIsco ATA Parameter
Intermittent dial tone Timer Dtmf input
NCS 1.0 L-Package Supported by the Cisco ATA with Mgcp
Code Description Type
Mgcp 0.1-1.0 L-Package Supported by the Cisco ATA with Mgcp
Mgcp 0.1-1.0 G-Package Supported by the Cisco ATA with Mgcp
Wt1, wt2, wt3, wt4 Call-waiting tone Dtmf tones wildcard
Commands Supported with Mgcp
Mgcp 0.1-1.0 D-Package Supported by the Cisco ATA with Mgcp
Operation failed Rbk### Rt@connection id
Parameters in Commands Sent to the Call Agent
Parameters in Responses 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
User Interface UI Security Parameter
UIPassword
Value Type
Range
UseTFTP
Parameters for Configuration Method and Encryption
CfgInterval
TftpURL
Maximum 31 characters
905
EncryptKey
EncryptKeyEx
Network Configuration Parameters
Range Default
Not applicable for this parameter
StaticIp
Voice Configuration Menu Access Code Related Parameters
StaticRoute
IP address
StaticNetMask
255.255.255.0
916
Related parameter
Vlan Setting
Mgcp Configuration Parameters
CA0orCM0
Examples
Specify the ID of the primary Call Agent in this parameter
CA1orCM1
Voice Configuration Menu Access Codes
EPID0orSID0 and EPID1orSID1
Value Types
PrfCodec
LBRCodec
Integer
300
MGCPPort
2427
201
MediaPort
RetxIntvl
RetxLim
Domain
MGCPVer
205
Alphanumeric
Audio Configuration Parameters
CodecName
931
Default Names
AudioMode
Bit Number Definition
Operational Parameters
NumTxFrames
CallerIdMethod
Parameters and Defaults Operational Parameters
FXSOutputLevel
FXSInputLevel
371
ConnectMode
0x90000400
311
Bit Number
SigTimer
0x2
OpFlags
Bit Number Definition
Tone Configuration Parameters
0x000068B8
255
Each tone is specified by nine integers, as follows
Tone Parameter Syntax-Basic Format
Tone Parameter Syntax-Extended Formats
Extended Format a
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
Recommended Values
Default values using the Basic format
Specific Tone Parameter Information
DialTone
ReorderTone
BusyTone
CallWaitTone
RingbackTone
922
923
OffTime-2400 TotalToneTime-4800
AlertTone
924
925
Default Recommended Values
Diagnostic Parameters
RingCadence
NPrintf
SyslogIP
TraceFlags
Extended IP address
0x00000000
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
Fax Pass-through mode requires configuring two parameters
Configuring the Cisco ATA for Fax Pass-through mode
This setting translates to the following bitmap
AudioMode
Recommended Setting
Configuring Cisco IOS Gateways to Enable Fax Pass-through
This setting translates to the bitmap
ConnectMode
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
Configuring the Cisco IOS Gateway for Fax Mode
Debugging the Cisco ATA 186/188 Fax Services
Common Problems When Using IOS Gateways
Problem Action
Cisco ATA, and 0x0012XXXX for the Phone 2 port
Using prserv for Diagnosing Fax Problems
For fax pass-through mode, AudioMode should be set to
Port
Analyzing prserv Output for Fax Sessions
Prserv Overview
Decoding timestamp was set to timestamp2
Log event Description
That the first RTP packet that the Cisco ATA received was
Encoded for channel
Possible Reasons for Failure
Originating-Gateway Example
Using rtpcatch for Diagnosing Fax Problems
Rtpcatch Overview
To use rtpcatch, follow these steps
Output Files
Example of rtpcatch
Explanation
CED tone Detected
Analyzing rtpcatch Output for Fax Sessions
Fax relay mode Cisco fax relay mode
Analysis
Both sides use G.711 for the entire fax session
Example 6-3 Fax Pass-through Mode
Using rtpcatch to Analyze Common Causes of Failure
Cisco fax relay option is not disabled on the gateway
Possible Causes for Failure
Possible Cause for Failure
Example 6-9 Fax Pass-through Mode Failure
Rtpcatch Limitations
Upgrading the Signaling Image from a Tftp Server
Syntax of upgradecode Parameter
Definitions
Upgrading the Signaling Image Manually
Upgradecode parameter value could be
Process
Preliminary Steps
Upgrade Requirements
Running the Executable File
Syntax
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
Message Syntax
Using System Diagnostics
PriorityTimeOffset Ataip tag chMessage
Syntax Definitions
Example-ARP Message
Example-DHCP Messages
Example-TFTP messages
Example-Cisco ATA Configuration Update Message
Example-System Reboot Message
Example-Cisco ATA Event Messages
Local Tone Playout Reporting
Example-Fax Event Messages
Example-RTP Statistic Messages
Tone Type ID Description
Obtaining Network Status After Getting IP Connectivity
Bit Number Description
Bit Number Description Boolean Value
Configuration file is not found
Cisco ATA failed to upgrade to the downloaded image file
Bad configuration file
Checksum error for configuration file
Real-Time Transport Protocol RTP Statistics Reporting
Dhcp Status Html
Frequently Asked Questions
Resetting Cisco ATA counters
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
This section describes Cisco ATA specifications
Physical Specifications
Dimensions Weight
Specification
Environmental Specifications
Electrical Specifications for Cisco ATA
Description Specification
Physical Interfaces
Ringing Characteristics
Software Specifications
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
Cisco ATA 2 phone rings and displays Cisco ATA 1 ID on CID
Cisco ATA 1 dials 6-Cisco ATA 1 to Call Agent
Device-Call Agent to Cisco ATA
OK-Cisco ATA 2 to Call Agent
RTP Media stream is now enabled on Cisco ATA 1. Both
Routing Update Protocol RTP Media stream is now enabled on
Cisco ATA 2-Call Agent to Cisco ATA
Ringback stops on Cisco ATA 1-Call Agent to Cisco ATA
Cisco ATA 2 hangs up-Cisco ATA 2 to Call Agent
ATA 2 Connection mode changes to receive-only-Call Agent to
Cisco ATA 2 Connection is deleted-Call Agent to Cisco ATA
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
Signaling connection control part
Messages can be part of Sgcp and Mgcp messages
GL-5
GL-6
Traffic
Business-class services for Internet telephony
Allow you to define your own customized markup language
GL-7
GL-8
Codec negotiation in sending fax
Bootload
Codecs Cabling requirements LBRCodec Call Agent Supported
IN-1
CallerIdMethod CfgInterval CodecName ConnectMode Dhcp
EncryptKey
IN-2
IN-3
Fax mode 6-1,6-6 Configuration
Debugging Services
Fax relay disabling
IN-4
IN-5
Cisco ATA RSIP*@ipaddress syntax setting
RTP payload type RTP statistics reporting
IN-6
IN-7
IN-8