Cisco Systems ATA 186 manual cfgfmt Tool Syntax and Examples, Syntax Definitions-Options, 3-14

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