Cisco IP Phone 7905G Administration Guide for H.323 - Configuring the Cisco IP Phone 7905G [Cisco Unified IP Phone 7900 Series]

Table Of Contents

Configuring the Cisco IP Phone 7905G

Setting Up IP Addresses on the Cisco IP Phone 7905G

Setting the IP Address with a DHCP Server

Using DHCP with TFTP Configuration

Setting the IP Address Through the Phone Menu

Setting the IP Address Through the Web Interface

Configuring the Cisco IP Phone 7905G

Using TFTP to Configure the Cisco IP Phone 7905G

Obtaining the Phone Profile

Converting the Text Version of Profile to a Binary File

Usages of cfgfmt.exe Tool

Using Encrypted Profiles

Setting the Encrypt Key Using TFTP servers.

Using the Web Interface to Configure the Cisco IP Phone 7905G

Setting Parameters and Values

Device Information

Network Configuration

Network Statistics

Device Logs

Network Parameters

H.323 Parameters

Tone Parameters

Audio Parameters

Restoring Factory Default Settings

Configuring the Cisco IP Phone 7905G

This chapter provides information on how to configure the Cisco IP Phone 7905G. It contains the following sections:

•Setting Up IP Addresses on the Cisco IP Phone 7905G

•Configuring the Cisco IP Phone 7905G

•Setting Parameters and Values

•Restoring Factory Default Settings

You can configure Cisco IP Phone 7905G by specifying parameter values on the phone or in a file known as a profile. Parameter values provide the phone with instructions on such things as ringing frequency and cadence, type of codec to use, where to find the H.323 gatekeeper, and so forth. A reference for parameter values is provided in "Parameters and Defaults for Cisco IP Phone 7905G."

You can store profiles for all the phones on your network on a Trivial File Transfer Protocol (TFTP) server. The profile instructs the phone to download the correct firmware image. You can configure the phones to download their profiles periodically. Alternatively, you can enter parameter values using a web interface. Both methods are described in this chapter.

Caution You must use a TFTP server to download the initial profile and phone firmware.

If you are not using a Dynamic Host Configuration Protocol (DHCP) server, you must first manually define IP addresses and gateways for the phones.

Setting Up IP Addresses on the Cisco IP Phone 7905G

Enter the following minimum settings on the Cisco IP Phone 7905G for network connectivity:

•IP address

•Subnet mask

•Network route address (IP gateway)

These settings can be configured in one of three ways, as described in the following sections:

•Setting the IP Address with a DHCP Server

•Setting the IP Address Through the Phone Menu

•Setting the IP Address Through the Web Interface

Setting the IP Address with a DHCP Server

When DHCP is enabled on the Cisco IP Phone 7905G, the DHCP server assigns the Cisco IP Phone 7905G an IP address, subnet mask, and network gateway. You can enable DHCP on the phone by using the following procedure

Step 1 Press the Services key to access the services menu.

Step 2 In the services menu, use the navigation button to select Settings, and then press the Select softkey.

Step 3 In the settings menu, use the navigation key to select Network Configuration, and then press the Select softkey.

Step 4 In the network configuration menu, use the navigation button to select DHCP Enabled, and then press the Edit softkey.

Step 5 Use the arrow (<--) softkey to move the cursor over the character that you want to change. Press the keypad digit 1 to enable DHCP, and then press the Accept softkey.

Step 6 Press the Back softkey to return to the next-higher-level menu until you see the Exit softkey. Press the Exit softkey to leave the services menu.

Using DHCP with TFTP Configuration

After an optional DHCP request at power up, the Cisco IP Phone 7905G contacts the TFTP server for a specific profile to download. The profile contains a list of triplets tag, length, and value (TLVs) representing some of the Cisco IP Phone 7905G configuration parameters. The profile is in a binary format and can also be optionally encrypted with a shared secret key using RC4 cipher algorithm. The Cisco IP Phone 7905G has an internal local nonvolatile cache of its configuration parameters. If Cisco IP Phone 7905G cannot reach the TFTP server after three attempts, it continues normal operation using its own locally cached profile.

The DHCP server uses option 60 (vendor class identifier) to identify Cisco IP Phone 7905G devices on the network. You can set the TFTP file to be download in the DHCP header. This field is limited to 31 characters on Cisco IP Phone 7905G. See the "Using TFTP to Configure the Cisco IP Phone 7905G" section.

Phone configuration parameters that can be configured using DHCP are the following:

•Client IP address

•DHCP option 1: Client Subnet mask

•DHCP option 3: Routers on the client's subnet

•DHCP option 6: Domain name servers (Cisco IP Phone 7905G only allows two DNS servers)

•DHCP option 42: Network time protocol (NTP) servers (Cisco IP Phone 7905G only allows two NTP servers)

•DHCP option 150: TFTP server name.

•DHCP option 66: TFTP server name (use only if 150 does not have a valid value).

•DHCP option 67: TFTP boot file name

The values for DNS server, NTP server, and TFTP server can be overwritten by values in the corresponding parameters in the phone profile (DNS1IP, DNS2IP, NTPIP, AltNTPIP, and TftpURL). If these parameters are not set to 0, their values are used in place of those corresponding values that are supplied by the DHCP options.

Setting the IP Address Through the Phone Menu

When you manually define values for the IP address, subnet mask, and network gateway, you must first enter a value to disable DHCP. You can set these values with the services menu on the Cisco IP Phone 7905G by using the following steps:

Step 1 Press the Services key to access the services menu.

Step 2 In the services menu, use the navigation button to select Settings, and then press the Select softkey.

Step 3 In the settings menu, use the navigation key to select Network Configuration, and then press the Select softkey.

Step 4 In the network configuration menu, use the navigation button to select DHCP Enabled, and then press the Edit softkey.

Step 5 Use the arrow (<--) softkey to move the cursor over the character that you want to change. Press the keypad digit 0 to disable DHCP, and then press the Accept softkey.

Step 6 In the network configuration menu, use the navigation button to select Static IP Address, and then press the Edit softkey.

Step 7 The current value for the phone's IP address is shown in two fields: "Old Value" and "New Value." The four softkeys help you enter a new IP address in the "New Value" field. Use the asterisk character (*) in place of the period (.) in the IP address. Use the arrow (<--) softkey to move the cursor to the character that you want to change. Enter the IP address, and then press the Accept softkey.

Note When the cursor moves over a character, the character is deleted and a new character must be entered. You cannot cancel individual character deletions, but you can use the Cancel softkey to back out of the screen without saving your changes.

Step 8 In the network configuration menu, use the navigation button to select Static Subnet Mask, and then press the Edit softkey.

Step 9 Enter the subnet mask, and then press the Accept softkey.

Step 10 In the network configuration menu, use the navigation button to select Static Default Router, and then press the Edit softkey.

Step 11 Enter the default router IP address, and then press the Accept softkey.

Step 12 Press the Back softkey to return to the next-higher-level menu until you see the Exit softkey. Press the Exit softkey to leave the services menu.

Setting the IP Address Through the Web Interface

You can also input the phone's IP address, subnet mask, and default gateway manually using the web interface. See the instructions in the "Using the Web Interface to Configure the Cisco IP Phone 7905G" section.

Configuring the Cisco IP Phone 7905G

After you have defined initial IP addresses using one of the procedures in the "Setting Up IP Addresses on the Cisco IP Phone 7905G" section, you can configure or provision the Cisco IP Phone 7905G using a profile stored on the TFTP server. Once the phone has downloaded its initial profile and firmware image, you can use the web interface to configure Cisco IP Phone 7905G. These methods are described in the following sections:

•Using TFTP to Configure the Cisco IP Phone 7905G

•Converting the Text Version of Profile to a Binary File

•Using the Web Interface to Configure the Cisco IP Phone 7905G

Using TFTP to Configure the Cisco IP Phone 7905G

You can configure or provision many different parameters on the Cisco IP Phone 7905G using a profile stored on the TFTP server. A profile is a text file with parameters and values for various phone and network settings. You must convert the text-based profile into a binary file for the phone to download.

Obtaining the Phone Profile

The TFTP server stores a binary file representation of each Cisco IP Phone 7905G profile on the network. The filename has the format ldxxxxxxxxxxxx, where each xx is the two-digit lowercase hexadecimal representation for each integer in the phone MAC address. The filename must be exactly14 characters. For example, if the MAC address is 1.2.3.4.5.6, the filename is ld010203040506. You can use the supplied prototype profile named H323example.txt.

Note Profile names begin with "ld," which is a lowercase "L" followed by a lowercase "D."

The text file can be edited on the TFTP server. A parameter is entered using the format "Parameter:value." For example, to indicate that a phone has been configured, include the entry "ToConfig:0" in all profiles that you configure. See Parameters and Defaults for Cisco IP Phone 7905G for more information on parameter values.

When the Cisco IP Phone 7905G powers up, contacts the TFTP server to download its profile. The profile is a list of triplet TLVs (tag/length/values) that can be encrypted with a shared secret key using RC4 cipher. The Cisco IP Phone 7905G stores the profile locally in an internal nonvolatile cache, so that the phone can continue to operate even when the TFTP server is unavailable. The phone periodically refreshes its cached profile from the TFTP server. The interval between refresh attempts is specified by the CfgInterval parameter.

If the IP phone cannot find this file, it will look for the lddefault.cfg file. If the Cisco IP Phone 7905G cannot reach the TFTP server after three attempts or if the profile cannot be found on the server, it will use the profile from the previous provisioning.

You can force the phone to update its profile by opening the refresh web page on the Cisco IP Phone 7905G at http://<IP-address>/refresh where <IP address> is the IP address of the Cisco IP Phone 7905G.

Converting the Text Version of Profile to a Binary File

Use the H323example.txt file as a template for creating the text based profile for your Cisco IP Phone 7905G. You can obtain the latest version of this file from the CCO Web site. A profile text example can be found in the "Sample Parameter Profile" section. The Cisco IP Phone 7905G can only download and store the profile when it is in a binary format. You must convert the text based profile into a binary file.

The following procedure describes how to generate the binary file for the Cisco IP Phone 7905G.

Procedure

Step 1 Edit your ldxxxxxxxxxxxx.txt file with the changes you need for your profile-specific Cisco IP Phone 7905G file with any text editor, such as Notepad.

Step 2 Run the cfgfmt.exe tool on the text file to generate the binary profile. For example:
cfgfmt ld00012d020a14.txt ld00012d020a14 produces the binary file 
ld00012d020a14.
The cfgfmt.exe tool and the file ptag.dat, which cfgfmt uses, are bundled with the Cisco IP Phone 7905G software. The cfgfmt program uses the following syntax:
cfgfmt [-E] [-eRC4Password] [-tpTagFile] input-text-file 
output-binary-file
•RC4Password is the optional RC 4key to encrypt the binary TFTP file provided by the cfgfmt program (up to eight alphanumeric characters).

•pTagFile is the optional command used to specify a ptag file other than the one provided (ptag.dat). The ptag.dat file is used by cfgfmt.exe to format a text input representation of the parameter/value pairs to its output binary representation of the TLV value.

•input-text-file is the input text file representation of the Cisco IP Phone 7905G profile.

•output-binary-file is the final output binary text file that Cisco IP Phone 7905G uses as the TFTP provisioning profile.

The cfgfmt.exe syntax affects the EncryptKey parameter, as shown in the "Usages of cfgfmt.exe Tool" section.

Step 3 Place the binary file on the TFTP server.

Note If you are updating the phone firmware, it must also be on the TFTP server.

Usages of cfgfmt.exe Tool

There are two ways to encrypt the binary profile. You can use the EncryptKey parameter within the profile or you can choose a key when you are converting the profile to a binary file. The different usages are described below:

Note The decryption key is the same as the encryption key.

•cfgfmt input-text-file output-binary-file

If input-text-file sets the EncryptKey to 0, then output-binary-file is not encrypted. If the input-text-file sets EncryptKey to a non-zero value, then the output-binary-file is encrypted with that value.

•cfgfmt -eSecret input-text-file output-binary-file

If input-text-file sets EncryptKey to a non-zero value and the -e option is used, output-binary-file is encrypted with the EncryptKey parameter set in input-text. Secret is ignored. If the EncryptKey value is 0, Secret is used to encrypt the output-binary-file.

•cfgfmt -E input-text-file output-binary-file

The EncryptKey value in input-text-file is ignored and output-binary-file is not encrypted. However, the parameter/value pair of the EncryptKey parameter, if present, is included in the output-binary-file.

•cfgfmt -E -eSecret input-text-file output-binary-file

The EncryptKey value in input-text-file is ignored and output-binary-file is encrypted with the Secret key. However, the parameter/value pair of the EncryptKey parameter, if present, is included in the output-binary-file. Use this to set or change the encrypt key when you are using two TFTP servers.

Using Encrypted Profiles

The Cisco IP Phone 7905G must have the encrypt key in its configuration before it can decrypt an encrypted profile. This can be preprogrammed on the phone before it is shipped to the end user, or it can be performed by the end user when the phone is installed. See Manual Configuration After Installation.

Setting the Encrypt Key Using TFTP servers.

You can set the encrypt key by using two TFTP servers. The general steps are as follows:

Step 1 Set DHCP to direct the phone to the first TFTP server.

Step 2 Create an unencrypted profile with the encrypt key value and the IP address of the second TFTP server. Use the -E option followed by a space when you run the cfgfmt.exe tool. For example,
cfgfmt -E ld00012d020a14.txt ld00012d020a14
Step 3 Place the unencrypted profile on the first TFTP server.

Step 4 Create a encrypted profile using the encryptkey. The cfgfmt.exe tool will use the encrypt key value to encrypt the binary profile if you do not use the -E option.

Step 5 Place the encrypted profile on the second TFTP server.

Step 6 Install the phone. See Installing the Cisco IP Phone 7905G for H.323.

When the phone powers up, it is directed by the DHCP server to the TFTP server. The phone downloads the unencrypted profile with the encrypt key and the IP address of the second TFTP server. The phone stores the encrypt key in its configuration. After the phone reboots, it downloads the encrypted profile and uses the encrypt key to decrypt its new profile.

Note You can also change the encrypt key on a phone, by creating a profile using the -E -eSecret option and placing the binary profile on the first TFTP server.

Using the Web Interface to Configure the Cisco IP Phone 7905G

You can display and configure device and network information for the phone by accessing the web configuration page on the Cisco IP Phone 7905G. You can access the web configuration page using any graphically capable browser, such as Microsoft Internet Explorer or Netscape Navigator.

Follow these steps to access the web configuration page.

Step 1 From a web browser, enter the IP address of the phone plus "/dev." For example, if the IP address of the phone is 192.168.3.225, the URL for its configuration page is 192.168.3.225/dev.

Step 2 If you set a password for the web interface, enter the UI password and click Apply.

Step 3 Select the screen with the parameters that you wish to view or set. The different screens are described in "Setting Parameters and Values" section.

Step 4 (optional) Enter the new or changed information and click Apply.

The phone reboots when the configuration has been changed.

Step 5 Close your web browser.

Caution Cisco recommends that you take care to not allow the web interface to be available over the public Internet to prevent unauthorized access. We also recommend that you set a password, up to 9 alphanumeric characters, in the UIPassword parameter to increase security. After a password is set on the web interface, subsequent changes to the password must be made from this interface.

Setting Parameters and Values

This section describes the Cisco IP Phone 7905G web-interface screens, including those that display information and those on which you set parameters. Although this section groups parameters by the screens on which they are configured, these same parameters are used in the profile for the phone, in the form of parameter:value pairs. The following screens are described:

•Device Information

•Network Configuration

•Network Statistics

•Device Logs

•Network Parameters

•H.323 Parameters

•Tone Parameters

•Audio Parameters

Note You can access each screen directly from the web browser as described in the following sections. The URL is case-sensitive, however, so type the command exactly as shown.

Note To learn more about each parameter, including allowed and default values, see "Parameters and Defaults for Cisco IP Phone 7905G."

Device Information

The device information screen displays the following information about your Cisco IP Phone 7905G:

•MAC address

•Software version

•Hardware revision

•Serial number

•Product ID

•Hardware features

•BTXML cards version

Note To access this screen directly from the web browser, enter ip-address/DeviceInformation where ip-address is the IP address of your phone.

Network Configuration

The network configuration screen displays the following information about your Cisco IP Phone 7905G:

• DHCP server

• BOOTP server

• MAC address

• Host name

• Domain name

• IP address

• Default gateway

• Subnet mask

• TFTP server 1

• NTP server 1 and server 2

• DNS server 1 and server 2

• Alternate NTP server 1 and server 2

Note To access this screen directly from the web browser, enter ip-address/NetworkConfiguration where ip-address is the IP address of your phone.

Network Statistics

This screen displays the following:

•Elapsed time

•Receive and transmit packets

•Broadcast

•Multicast

•Receive and transmit errors

•Receive overflow

Note To access this screen directly from the web browser, enter ip-address/EthernetInformation where ip-address is the IP address of your phone.

Device Logs

This screen is not operational at this time.

Note You can access this screen directly from the web browser by entering ip-address/DeviceLog where ip-address is the IP address of your phone.

Network Parameters

This group of parameters specifies the network configuration to the Cisco IP Phone 7905G.

Note To access this screen directly from the web browser, enter ip-address/NetCfg where ip-address is the IP address of your phone. This screen is also displayed by default when you enter ip-address/dev.

Table 3-1 describes parameter:value pairs. See "Parameters and Defaults for Cisco IP Phone 7905G," for more details.

Table 3-1 Network Parameters

Parameter

Description

ToConfig

Specifies whether the phone has been configured.

UseTftp

Specifies whether to contact the TFTP server to download the phone profile. If you turn this on and subsequently make changes via the web interface, you must turn it off before saving those changes; otherwise, the changes are overwritten by the TFTP server.

TftpURL

Specifies the URL or IP address of the TFTP server where phone profiles are stored or that the DHCP server should provide the TFTP URL.

CfgInterval

Specifies the time interval between refreshes of the phone profile from the TFTP server.

EncryptKey

Specifies the key to use for decrypting the configuration profile that is downloaded from the TFTP server.

DHCP

Specifies whether to contact the DHCP server to obtain values for network-related parameters such as IP address, router IP address, subnet mask, NTP, TFTP, domain name, DNS, VLAN ID, and more.

StaticIP, StaticRoute, StaticNetMask

If DHCP is not enabled, specify the static IP address, network router, and subnet mask for the phone.

Domain

Specifies the domain name on the network in which the phone operates.

DNS1IP, DNS2IP

Specifies the IP addresses of the primary and secondary DNS.

NTPIP, AltNTPIP

Specifies the IP address of the primary Network Time Protocol (NTP) server and to the alternate backup server. NTP is a protocol built on top of TCP that ensures accurate local time-keeping with reference to radio and atomic clocks located on the Internet. The NTP server provides the UTC time used to time-stamp incoming calls.

OpFlags

Specifies whether to use the phone's own internally generated filename and whether to suppress probing at boot time.

VLANSetting

Specifies various VLAN settings.

NPrintf

Specifies the IP address and port of a host to which all phone debug messages are to be sent. The host must be running the prserv.exe application at the corresponding port.

TraceFlags

Specifies whether to enable logging of debug information.

H.323 Parameters

This group of parameters specifies aspects of the H.323 network which the Cisco IP Phone 7905G is a part of.

Note To access this screen directly from the web browser, enter ip-address/H323Configuration where ip-address is the IP address of your phone.

Table 3-2 describes parameter:value pairs. See "Parameters and Defaults for Cisco IP Phone 7905G," for more details.

Table 3-2 H.323 Parameters

Parameter

Value

UID

Specifies the user ID assigned to this phone line, typically an E.164 number.

PWD

Specifies the password for authentication.

UseLoginID

Specifies whether to use LoginID or UID for authentication.

LoginID

Specifies alternate user ID for authentication.

Gk, AltGk

Specifies the IP address of the gatekeeper, and alternate gatekeeper.

Gateway

Specifies the IP address of the gateway if there is no gatekeeper in the network.

AltGkTimeOut

Specifies alternate gatekeeper timeout value.

GkTimeToLive

Specifies gatekeeper time-to-live value.

GkId

Specifies gatekeeper zone identification.

AutMethod

Specifies the authentication method:

Tone Parameters

This group of parameters specifies various tone characteristics as well as dial plans and time zone.

Note To access this screen directly from the web browser, enter ip-address/ToneConfiguration where ip-address is the IP address of your phone.

Table 3-3 describes parameter:value pairs. See "Parameters and Defaults for Cisco IP Phone 7905G,"for more details.

Table 3-3 Tone Parameters

Parameter

Value

SigTimer

Specifies various timeout values for the following signaling events:

•CWT Period: interval during which call-waiting tone is played.

•Reorder Delay: time after the far end hangs up before reorder tone (fast busy) plays.

•Ring Timeout: time after which a ringing phone rejects an incoming call.

•NoAns Timeout: time after which a ringing phone forwards a call.

RingOnOffTime

Specifies the ringer cadence pattern.

Tones

Specifies characteristics associated with the following types of tones:

•DialTone: Played when the phone is ready to accept the first digit of a telephone number or IP address.

•BusyTone: Played when the connection to a called party cannot be completed because the destination phone is busy.

•ReorderTone: Played when the connection to a called party cannot be completed for some reason other than the destination phone being busy.

•RingBackTone: Played while the called party is being alerted by the destination phone.

•CallWaitTone: Played when an incoming call has arrived while you are connected to another call.

•AlertTone: Played to prompt you to enter a phone number when invoking a supplementary service such as call-forwarding or blind transfer.

DialPlan

Specifies dial-plan rules and timeout values, many of which are determined on a country-by-country basis. "Parameters and Defaults for Cisco IP Phone 7905G," gives defaults for the United States.

IPDialPlan

Specifies how the phone is to recognize an IP address.

TimeZone

Specifies the number of hours to add to Greenwich Mean Time (GMT) to determine local time.

Audio Parameters

This group of parameters specifies encoding and other audio characteristics.

Note To access this screen directly from the web browser, enter ip-address/AudioConfiguration where ip-address is the IP address of your phone.

Table 3-4 describes parameter:value pairs. See "Parameters and Defaults for Cisco IP Phone 7905G," for more details.

Table 3-4 Audio Parameters

Parameter

Value

RxCodec, TxCodec

Specifies receiving (decoding) and transmitting (encoding) codecs. Choices include G.711 A-law, G.711 u-law, and G.729a.

AudioMode

Specifies more precise control of the audio component for certain user applications.

ConnectMode

Specifies the connection mode of the selected call-signaling protocol.

NumTxFrames

Specifies the number of frames to transmit per packet.

UDPTOS

Specifies how to control IP precedence and delay of the UDP packets sent.

MediaPort

Specifies the base port that the phone should use to receive RTP media streams.

Restoring Factory Default Settings

Perform the following steps to restore factory default settings. This is particularly useful when you forget the password.

Step 1 Press *, 0, and the 4 softkey simultaneously. The manufacturing test-option screen appears.

Step 2 Type 322873738# and press *.

Step 3 Press *, 0, and the 4 softkey again, or power-cycle the phone. You return to normal operation.