Cisco Systems ATA 186, ATA 188 manual Syntax of the cfgfmt tool follows, Syntax Definitions-Options

Page 48

Chapter 3 Configuring the Cisco ATA for MGCP

Configuring the Cisco ATA Using a TFTP Server

cfgfmt Tool Syntax and Examples

The syntax of the cfgfmt tool follows:

Syntax

cfgfmt [options] input output

Syntax Definitions—Options

-eRc4Passwd—This option directs the Cisco ATA to use Rc4Passwd as the key (up to eight hexadecimal characters) to encrypt or decrypt the input text file. However, if the Cisco ATA EncryptKey parameter in the input text file is not 0, then the value of that parameter is used to encrypt the output binary file, and Rc4Passwd is ignored. The -eportion of this option means that the Cisco ATA will use the weaker encryption method.

-E—This option directs the Cisco ATA to not use the value of the EncryptKey parameter, as set in the input text file, to encrypt the output binary configuration file.

-xRc4Passwd—This option directs the Cisco ATA to use Rc4Passwd, which must be a hexadecimal string of as many as 64 characters, as the key to encrypt or decrypt the input text file. However, if the Cisco ATA EncryptKeyEx parameter in the input text file is not 0, then the value of that parameter is used to encrypt the output binary file, and Rc4Passwd is ignored. The -xportion of this option means that the Cisco ATA will use the stronger encryption method.

-X—This option directs the Cisco ATA to not use the value of the EncryptKeyEx parameter, as set in the input text file, to encrypt the output binary configuration file.

-tPtag.dat—This file, provided with the Cisco ATA software version you are running, is used by the cfgfmt tool to format a text input representation of the parameter/value pairs to its output binary representation. Be sure this file resides in the same directory from which you are running the cfgfmt program.

-sip—Specify this tag if you are using the SIP protocol so that the cfgfmt tool will include only the SIP protocol parameters in the converted output binary file.

-h323—Specify this tag if you are using the H.323 protocol so that the cfgfmt tool will include only the H.323 protocol parameters in the converted output binary file.

-mgcp—Specify this tag if you are using the MGCP protocol so that the cfgfmt tool will include only the MGCP protocol parameters in the converted output binary file.

-sccp—Specify this tag if you are using the SCCP protocol so that the cfgfmt tool will include only the SCCP protocol parameters in the converted output binary file.

-g—This tag omits sensitive parameters in an ata<macaddress> file that was created with a version of the cfgfmt tool prior to version 2.3.

Some parameters, specified in the ptag.dat file used by the cfgfmt tool, are marked as sensitive information (these parameters could include UIPassword, UID, PWD0). These parameters are not included in the output binary file if the -g switch is specified in the cfgfmt syntax.

Syntax Definitions—Required Parameters

Input—This is the input text file representation of the Cisco ATA configuration file.

Output—This is the final output binary file that Cisco ATA uses as the TFTP configuration file.

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

3-14

OL-4803-01

 

 

Image 48
Contents Corporate Headquarters Text Part Number OL-4803-01Copyright 2003, Cisco Systems, Inc All rights reserved N T E N T S IiiSafety Recommendations Dhcp CA0UID CA1UID NPrintf TraceFlags ViiInstallation and Upgrade Issues ViiiObjectives AudienceThis preface includes the following sections Organization and Use ConventionsOrganization Chapter DescriptionBewaar Deze Instructies Warnung Wichtige Sicherheitshinweise Avvertenza Importanti Istruzioni Sulla SicurezzaXii Aviso Instruções Importantes DE Segurança XiiiRelated Documentation Use this guide in conjunction with these documentsXiv Obtaining Documentation Cisco.comDocumentation CD-ROM Ordering DocumentationObtaining Technical Assistance Documentation FeedbackYou can order Cisco documentation in these ways XviTechnical Assistance Center Cisco TAC WebsiteCisco TAC Escalation Center XviiObtaining Additional Publications and Information XviiiCisco Analog Telephone Adaptor Overview Overview of Media Gateway Control Protocol PstnHardware Overview Link LEDFunction Button Software Features Cisco ATA supports the following protocols and servicesMgcp Versions Voice Codecs SupportedAdditional Supported Signaling Protocols Cisco ATA Mgcp ServicesOther Supported Protocols 729A 729B 729.ABFax Services Supplementary Services that the Cisco ATA ProvidesService Parameter Supplementary Services that the Call Agent Provides Installation and Configuration Overview Signaling image by using the Tftp server-upgrade method orManual-upgrade method Action ReferenceOL-4803-01 Installing the Cisco ATA Safety Recommendations Network RequirementsWhat the Cisco ATA Package Includes Installation Procedure 5V power adaptor Power cordWhat You Need Procedure Cisco ATA 186 Rear Panel ConnectionsInstalling the Cisco ATA Installation Procedure Power-Down Procedure Configuring the Cisco ATA for Mgcp Default Boot Load Behavior Page VLANSetting FeatureParameter and Bits Reference BitsSteps Needed to Configure the Cisco ATA Basic Configuration Steps in a Tftp Server EnvironmentHexadecimal format, this value is 0x01cc002b Tftp server at boot up time Action ReferenceBasic Configuration Steps in a Non-TFTP Server Environment ActionConfiguring the Cisco ATA Using a Tftp Server Setting Up the Tftp Server with Cisco ATA SoftwareConfigurable 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 Cfgfmt -mgcp -tptag.datata0a141e28323c.txt ata0a141e28323cUsing Encryption With the cfgfmt Tool Command ExampleCommand Output Total Binary Output Size Non-zeroSyntax of the cfgfmt tool follows Syntax Definitions-OptionsSyntax Definitions-Required Parameters Examples of Upgrading to Stronger Encryption Key Syntax examplesAta102030405060 is unencrypted Atadefault.cfg Configuration File Using a Dhcp Server Using a Dhcp Server,Other Dhcp Options You Can Set Voice Configuration Menu Without Using a Dhcp ServerUsing the Voice Configuration Menu Voice Menu Number FeaturesEntering Alphanumeric Values Voice Menu NumberCisco ATA Web Configuration Resetting the Cisco ATA to Factory Default ValuesKey Alphanumeric Characters Cisco ATA Web Configuration Refreshing or Resetting the Cisco ATA Upgrading the Mgcp Signaling Image Procedure to Refresh the Cisco ATAProcedure to Reset the Cisco ATA Cisco ATA-Supported Mgcp Services Important Basic Mgcp Services Setting the CodecConfiguring Refresh Interval Required ParametersAdditional Mgcp Services Endpoints and ConnectionsCall Agent Redundancy with Configuration Parameters Mgcp Endpoint Device TypeCisco ATA Registration Process with Mgcp Syntax TypeComplete Reference Table of all Cisco ATA Mgcp Services Rsip Message for Disconnect StateConfigurable Feature Related Parameter Supported Signals and Events Supported Mgcp Connection ModesSupported Local Connection Options Related CIsco ATA ParameterIntermittent dial tone Timer Dtmf input NCS 1.0 L-Package Supported by the Cisco ATA with MgcpCode 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 MgcpWt1, 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 MgcpOperation failed Rbk### Rt@connection id Parameters in Commands Sent to the Call Agent Parameters in Responses Sent to the Call AgentParameter Usage Mgcp Embedded Events Example HdA, ESdl, Roc, 0-9#TD, D1xxxxxxxxxx9011x.T OL-4803-01 Parameters and Defaults Configuration Text File Template IP address e.g Integer 32-bit integer Numeric digit stringUIPassword User Interface UI Security ParameterValue Type RangeParameters for Configuration Method and Encryption UseTFTPTftpURL CfgIntervalMaximum 31 characters 905EncryptKey EncryptKeyEx Network Configuration Parameters Range DefaultNot applicable for this parameter Voice Configuration Menu Access Code Related Parameters StaticIpStaticRoute IP addressStaticNetMask 255.255.255.0916 Vlan Setting Related parameterMgcp Configuration Parameters CA0orCM0Examples CA1orCM1 Specify the ID of the primary Call Agent in this parameterVoice Configuration Menu Access Codes EPID0orSID0 and EPID1orSID1Value Types PrfCodec LBRCodecInteger MGCPPort 3002427 201MediaPort RetxIntvlRetxLim MGCPVer Domain205 AlphanumericAudio Configuration Parameters CodecName931 Default Names AudioModeBit Number Definition Operational Parameters NumTxFramesCallerIdMethod Parameters and Defaults Operational Parameters FXSInputLevel FXSOutputLevelConnectMode 3710x90000400 311Bit Number SigTimer OpFlags 0x2Bit Number Definition Tone Configuration Parameters 0x000068B8255 Tone Parameter Syntax-Basic Format Each tone is specified by nine integers, as followsTone Parameter Syntax-Extended Formats Extended Format aEach tone is specified by 11 integers, as follows Extended Format B Cadence With Two On-Off PairsCadence with Three On-Off Pairs Component Setting Explanation ReorderTone Parameter Example1ReorderTone Parameter Example Default values using the Basic format Recommended ValuesSpecific Tone Parameter Information DialToneBusyTone ReorderToneRingbackTone CallWaitTone922 923AlertTone OffTime-2400 TotalToneTime-4800924 925Diagnostic Parameters Default Recommended ValuesRingCadence NPrintfTraceFlags SyslogIPExtended IP address 0x00000000SyslogCtrl Bit Number Type of Messages to TraceCFGID-Version Parameter for Cisco ATA Configuration File RTP statistics messages ReservedOL-4803-01 Configuring and Debugging Fax Services Using Fax Pass-through ModeConfiguring the Cisco ATA for Fax Pass-through mode Fax Pass-through mode requires configuring two parametersThis setting translates to the following bitmap AudioModeConfiguring Cisco IOS Gateways to Enable Fax Pass-through Recommended SettingThis setting translates to the bitmap ConnectModeEnable Fax Pass-through Mode Run the following commandDisable Fax Relay Feature Perform the commandUsing FAX Mode Configuring the Cisco ATA for Fax ModeDebugging the Cisco ATA 186/188 Fax Services Configuring the Cisco IOS Gateway for Fax ModeCommon Problems When Using IOS Gateways Problem ActionUsing prserv for Diagnosing Fax Problems Cisco ATA, and 0x0012XXXX for the Phone 2 portFor fax pass-through mode, AudioMode should be set to PortPrserv Overview Analyzing prserv Output for Fax SessionsLog event Description Decoding timestamp was set to timestamp2That the first RTP packet that the Cisco ATA received was Encoded for channelOriginating-Gateway Example Possible Reasons for FailureUsing rtpcatch for Diagnosing Fax Problems Rtpcatch OverviewTo use rtpcatch, follow these steps Example of rtpcatch Output FilesExplanation CED tone Detected Fax relay mode Cisco fax relay mode Analyzing rtpcatch Output for Fax SessionsAnalysis Both sides use G.711 for the entire fax sessionUsing rtpcatch to Analyze Common Causes of Failure Example 6-3 Fax Pass-through ModeCisco fax relay option is not disabled on the gateway Possible Causes for FailurePossible Cause for Failure Example 6-9 Fax Pass-through Mode Failure Rtpcatch Limitations Upgrading the Signaling Image from a Tftp Server Syntax of upgradecode ParameterDefinitions Upgrading the Signaling Image Manually Upgradecode parameter value could beProcess Upgrade Requirements Preliminary StepsRunning the Executable File SyntaxUpgrade Procedure To perform the upgrade, follow these stepsConfirming a Successful Signaling Image Upgrade Using a Web BrowserOL-4803-01 Troubleshooting General Troubleshooting TipsSymptoms and Actions Installation and Upgrade Issues Debugging You should also have access to a sniffer or LAN analyzer 2* 1 1* 2* 8* 1 1* 7* 8* 1 1* 9* 0* 1 1* 9* 0* 0Using System Diagnostics Message SyntaxPriorityTimeOffset Ataip tag chMessage Syntax DefinitionsExample-ARP Message Example-DHCP MessagesExample-TFTP messages Example-Cisco ATA Configuration Update Message Example-System Reboot MessageExample-Cisco ATA Event Messages Local Tone Playout Reporting Example-Fax Event MessagesExample-RTP Statistic Messages Tone Type ID Description Obtaining Network Status After Getting IP Connectivity Bit Number DescriptionBit Number Description Boolean Value Cisco ATA failed to upgrade to the downloaded image file Configuration file is not foundBad configuration file Checksum error for configuration fileDhcp Status Html Real-Time Transport Protocol RTP Statistics ReportingFrequently Asked Questions Resetting Cisco ATA countersRing Load per RJ-11 FXS Port Maximum Distance Contacting TAC OL-4803-01 Table A-1lists codes to return basic Cisco ATA information Voice Menu Option Code Description916 IP address of the primary DNS server DNS 2 IPTftp URL OL-4803-01 Physical Specifications This section describes Cisco ATA specificationsDimensions Weight SpecificationElectrical Specifications for Cisco ATA Environmental SpecificationsDescription Specification Physical InterfacesRinging Characteristics Software SpecificationsTip/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 1 dials 6-Cisco ATA 1 to Call Agent Cisco ATA 2 phone rings and displays Cisco ATA 1 ID on CIDDevice-Call Agent to Cisco ATA OK-Cisco ATA 2 to Call AgentRouting Update Protocol RTP Media stream is now enabled on RTP Media stream is now enabled on Cisco ATA 1. BothCisco ATA 2-Call Agent to Cisco ATA Ringback stops on Cisco ATA 1-Call Agent to Cisco ATAATA 2 Connection mode changes to receive-only-Call Agent to Cisco ATA 2 hangs up-Cisco ATA 2 to Call AgentCisco ATA 2 Connection is deleted-Call Agent to Cisco ATA Agent to Cisco ATARecommended 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 messagesGL-5 GL-6 Business-class services for Internet telephony TrafficAllow you to define your own customized markup language GL-7GL-8 Bootload Codec negotiation in sending faxCodecs Cabling requirements LBRCodec Call Agent Supported IN-1CallerIdMethod CfgInterval CodecName ConnectMode Dhcp EncryptKeyIN-2 IN-3 Debugging Services Fax mode 6-1,6-6 ConfigurationFax relay disabling IN-4IN-5 Cisco ATA RSIP*@ipaddress syntax setting RTP payload type RTP statistics reportingIN-6 IN-7 IN-8
Related manuals
Manual 228 pages 37.51 Kb Manual 64 pages 26.31 Kb Manual 166 pages 49.11 Kb Manual 48 pages 9.1 Kb Manual 208 pages 5.39 Kb Manual 14 pages 13.53 Kb