|
|
Table Of Contents
Modifying Cisco Unified IP Phone Options
Information About Cisco Unified IP Phone Options
Customized Background Images for Cisco Unified IP Phone 7970
Fixed Line/Feature Buttons for Cisco Unified IP Phone 7931G
Programmable Vendor Parameters for Phones
URL Provisioning for Feature Buttons
How to Configure Cisco Unified IP Phone Options
SCCP: Selecting Button Layout for a Cisco Unified IP Phone 7931G
SCCP: Modifying Header Bar Display
SIP: Modifying Header Bar Display
Troubleshooting Header Bar Display
SCCP: Creating Labels for Directory Numbers
SIP: Creating Labels for Directory Numbers
SCCP: Modifying System Message Display
Verifying System Message Display
Troubleshooting System Message Display
SCCP: Provisioning URLs for Feature Buttons
SIP: Provisioning URLs for Feature Buttons
Troubleshooting URL Provisioning for Feature Buttons
SCCP: Modifying Vendor Parameters for All Phones
SCCP: Modifying Vendor Parameters For a Specific Phone
Troubleshooting Vendor Parameter Configuration
Configuration Examples for Cisco Unified IP Phone Options
Text Labels for Ephone-dns: Example
Phone Header Bar Display: Example
System Text Message Display: Example
URL Provisioning for Directories, Services, and Messages Buttons: Example
Programmable VendorConfig Parameters: Example
Feature Information for Cisco Unified IP Phone Options
Modifying Cisco Unified IP Phone Options
Last Updated: May 22, 2007This chapter describes the screen and button features available for Cisco Unified IP phones connected to Cisco Unified Communications Manager Express (Cisco Unified CME).
Finding Feature Information in This Module
Your Cisco Unified CME version may not support all of the features documented in this module. For a list of the versions in which each feature is supported, see the "Feature Information for Cisco Unified IP Phone Options" section.
Contents
•
Information About Cisco Unified IP Phone Options
•
•
•
Information About Cisco Unified IP Phone Options
To enable IP phone options, you should understand the following concepts:
•
•
•
•
Customized Background Images for Cisco Unified IP Phone 7970
The Cisco Unified IP Phone 7970 and 7971 support customized background images on the phone screen. To enable your Cisco Unified IP Phone 7970 or 7971 to display a customized background image, follow the procedure in the technical note at http://www.cisco.com/en/US/products/sw/voicesw/ps4625/products_tech_note09186a008062495a.shtml
Sample background images are available in the 7970-backgrounds.tar file at http://www.cisco.com/cgi-bin/tablebuild.pl/ip-iostsp
Fixed Line/Feature Buttons for Cisco Unified IP Phone 7931G
In Cisco Unified CME 4.0(2) and later versions, you can select from two fixed button-layout formats to assign functionality to certain line buttons on a Cisco Unified IP Phone 7931G to support key system phone behavior. If you do not select a button set, no fixed set of feature/line buttons are defined.
The line button layout for the Cisco Unified IP Phone 7931G is a bottom-up array. Button 1 is at the bottom right of the array and button 24 is at the top left of the array.
Button set 1 includes two predefined feature buttons: button 24 is Menu and button 23 is Headset.
Button set 2 includes four predefined feature buttons: button 24 is Menu; button 23 is Headset; button 22 is Directories; and button 21 is Messages.
For configuration, see the "SCCP: Selecting Button Layout for a Cisco Unified IP Phone 7931G" section.
Header Bar Display
You can customize the content of an IP phone header bar, which is the top line of the IP phone display.
The IP phone header bar, or top line, of a Cisco Unified IP Phone normally replicates the text that appears next to the first line button. The header bar is shown in Figure 52. The header bar can, however, contain a user-definable message instead of the extension number. For example, the header bar can be used to display a name or the full E.164 number of the phone. If no description is specified, the header bar replicates the extension number that appears next to the first button on the phone.
Figure 52 Cisco Unified IP Phone Display
Phone Labels
Pone labels are configurable text strings that can be displayed instead of extension numbers next to line buttons on a Cisco Unified IP phone. By default, the number that is associated to a directory number, and assigned to a phone, is displayed next to the applicable button. The label feature allows you to enter a meaningful text string for each directory number so that a phone user with multiple lines can select a line by label instead of by phone number, thus eliminating the need to consult in-house phone directories. For configuration information, see the "SCCP: Creating Labels for Directory Numbers" section or the "SIP: Creating Labels for Directory Numbers" section.
Programmable Vendor Parameters for Phones
The vendorConfig section of the configuration file contains phone and display parameters that are read and implemented by a phone's firmware when that phone is booted. Only the parameters supported by the currently loaded firmware are available. The number and type of parameters may vary from one firmware version to the next.
The IP phone that downloads the configuration file will implement only those parameters that it can support and ignore configured parameters that it cannot implement. For example, a Cisco Unified IP Phone 7970G does not have a backlit display and cannot implement Backlight parameters regardless of whether they are configured. The following text shows the format of an entry in the configuration file:
<vendorConfig><parameter-name>parameter-value</parameter-name></vendorConfig>For configuration information at the system level, see the "SCCP: Modifying Vendor Parameters for All Phones" section. For configuration information for individual phones, see the "SCCP: Modifying Vendor Parameters For a Specific Phone" section.
System Message Display
The System Message Display feature allows you to specify a custom text or display message to appear in the lower part of the display window on display-capable IP phones. If you do not set a custom text or display message, the default message "Cisco Unified CME" is displayed.
When you specify a text message, the number of characters that can be displayed is not fixed because IP phones typically use a proportional (as opposed to fixed-width) font. There is room for approximately 30 alphanumeric characters.
The display message is refreshed with a new message after one of the following events occurs:
•
•
•
The file-display feature allows you to specify a file to display on display-capable IP phones when they are not in use. You can use this feature to provide the phone display with a system message that is refreshed at configurable intervals, similar to the way that the text message feature provides a message. The difference between the two is that the system text message feature displays a single line of text at the bottom of the phone display, whereas the system display message feature can use the entire display area and contain graphic images.
URL Provisioning for Feature Buttons
URL provisioning for customized feature buttons allows you to specify alternative XML files to access using the feature buttons on IP phones.
The Cisco Unified IP Phones 7940, 7940G, 7960, and 7960G have customized feature buttons that invoke noncall-related programmable services. The four buttons—Services, Directories, Messages, and Information (the i button)—are linked to appropriate feature operations through programmable URLs. The fifth button—Settings—is managed entirely by the phone. Operation of these services is determined by the IP phone capabilities and the content of the referenced URL.
The feature buttons are provisioned with specific URLs. The URLs link to XML web pages formatted with XML tags that the Cisco Unified IP phone understands and uses. When you press a feature button, the Cisco Unified IP phone uses the configured URL to access the appropriate XML web page for instructions. The web page sends instructions to the Cisco Unified IP phone to display information on the screen for users to navigate. Phone users can select options and enter information by using soft keys and the scroll button.
How to Configure Cisco Unified IP Phone Options
This section contains the following tasks:
Button Layout for Cisco Unified IP Phone 7931G
•
Header Bar Display
•
•
•
•
Labels for Directory Numbers
•
•
•
System Message Display
•
•
•
URLs for Feature Buttons
•
•
•
Programmable VendorConfig Parameters
•
•
•
SCCP: Selecting Button Layout for a Cisco Unified IP Phone 7931G
To select a fixed-button layout for a Cisco Unified IP Phone 7931G, perform the following steps.
Prerequisites
Cisco Unified CME 4.0(2) or a later version.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
8.
DETAILED STEPS
What to Do Next
If you are done modifying parameters for phones in Cisco Unified CME, generate a new configuration file and restart the phones. See "Generating Configuration Files for Phones" on page 265.
SCCP: Modifying Header Bar Display
To modify the phone header bar display, perform the following steps.
Prerequisites
Directory number to be modified is already configured. For configuration information, see "SCCP: Creating Directory Numbers" on page 177.
SUMMARY STEPS
1.
2.
3.
4.
5.
DETAILED STEPS
What to Do Next
If you are done modifying parameters for phones in Cisco Unified CME, generate a new configuration file and restart the phones. See "Generating Configuration Files for Phones" on page 265.
SIP: Modifying Header Bar Display
To modify the phone header bar display on supported SIP phones, perform the following steps.
Prerequisites
•
Restrictions
•
SUMMARY STEPS
1.
2.
3.
4.
5.
DETAILED STEPS
What to Do Next
If you are done modifying parameters for phones in Cisco Unified CME, generate a new configuration file and restart the phones. See the "SIP: Generating Configuration Profiles for SIP Phones" on page 270.
Verifying Header Bar Display
Step 1
Router# show running-config
ephone-dn 1 dual-line
number 150 secondary 151
description 555-0150
call-forward busy 160
call-forward noan 160 timeout 10
huntstop channel
no huntstop
!
!
!
voice-register dn 1
number 1101
description 555-0101
Troubleshooting Header Bar Display
Step 1
Use this command to ensure that the ephone-dn to which you applied the description appears on the first button on the ephone. In the example below, ephone-dn 22 has the description in the phone display header bar.
Router# show telephony-service ephone
ephone-dn 22
number 2149
description 408-555-0149
ephone 34
mac-address 0030.94C3.F96A
button 1:22 2:23 3:24
speed-dial 1 5004
speed-dial 2 5001
SCCP: Creating Labels for Directory Numbers
To create a label to display in place of the number next to a line button, perform the following steps.
Prerequisites
Directory number for which the label is to be created is already configured. For configuration information, see "SCCP: Creating Directory Numbers" on page 177.
SUMMARY STEPS
1.
2.
3.
4.
5.
DETAILED STEPS
What to Do Next
If you are done modifying parameters for phones in Cisco Unified CME, generate a new configuration file and restart the phones. See the "Generating Configuration Files for Phones" on page 265.
SIP: Creating Labels for Directory Numbers
To create label to be displayed in place of a directory number for a SIP phone, intercom line, voice port, or a message-waiting indicator (MWI), perform the following steps for each label to be created.
Prerequisites
•
•
Restrictions
•
SUMMARY STEPS
1.
2.
3.
4.
5.
DETAILED STEPS
What to Do Next
If you are done modifying parameters for phones in Cisco Unified CME, generate a new configuration file and restart the phones. See the "SIP: Generating Configuration Profiles for SIP Phones" on page 270.
Verifying Labels
Step 1
Router# show running-config
ephone-dn 1 dual-line
number 150 secondary 151
label MyLine
call-forward busy 160
call-forward noan 160 timeout 10
huntstop channel
no huntstop
!
!
!
voice-register dn 1
number 1101
label MyLine
SCCP: Modifying System Message Display
To modify the system message display on phone screen, perform the following steps.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
DETAILED STEPS
What to Do Next
After configuring the url idle command, you must reset phones. See "SCCP: Using the reset Command" on page 279.
Verifying System Message Display
Step 1
Router# show running-config
telephony-service
fxo hook-flash
load 7960-7940 P00307020300
load 7914 S00104000100
max-ephones 100
max-dn 500
ip source-address 10.153.13.121 port 2000
max-redirect 20
timeouts ringing 100
system message XYZ Company
voicemail 7189
max-conferences 8 gain -6
call-forward pattern .T
moh flash:music-on-hold.au
multicast moh 239.10.10.1 port 2000
web admin system name server1 password server1
dn-webedit
time-webedit
transfer-system full-consult
transfer-pattern 92......
transfer-pattern 91..........
transfer-pattern 93......
transfer-pattern 94......
transfer-pattern 95......
transfer-pattern 96......
transfer-pattern 97......
transfer-pattern 98......
transfer-pattern 99......
transfer-pattern .T
secondary-dialtone 9
create cnf-files version-stamp Jan 01 2002 00:00:00
Troubleshooting System Message Display
Step 1
SCCP: Provisioning URLs for Feature Buttons
To customize URLs for feature buttons in the Sep*.conf.xml configuration file for SCCP IP phones, perform the following steps.
Restrictions
•
•
•
SUMMARY STEPS
1.
2.
3.
4.
5.
DETAILED STEPS
What to Do Next
If you are done modifying parameters for phones in Cisco Unified CME, generate a new configuration file and restart the phones. See the "Generating Configuration Files for Phones" on page 265.
SIP: Provisioning URLs for Feature Buttons
To customize URLs for feature buttons SEPDEFAULT.cnf configuration profile for SIP IP phones, perform the following steps.
Prerequisites
•
Restrictions
•
•
•
•
SUMMARY STEPS
1.
2.
3.
4.
5.
DETAILED STEPS
What to Do Next
If you are done modifying parameters for phones in Cisco Unified CME, generate a new configuration file and restart the phones. See the "SIP: Generating Configuration Profiles for SIP Phones" on page 270.
Troubleshooting URL Provisioning for Feature Buttons
Step 1
SCCP: Modifying Vendor Parameters for All Phones
To configure programmable phone and display parameters in the vendorConfig section of the SepDefault.conf.xml configuration file for all phones, perform the following steps.
Restrictions
•
•
•
SUMMARY STEPS
1.
2.
3.
4.
5.
DETAILED STEPS
Step 1
enable
Example:Router> enable
Enables privileged EXEC mode.
•
Step 2
configure terminal
Example:Router# configure terminal
Enters global configuration mode.
Step 3
telephony-service
Example:Router(config)# telephony-service
Enters telephony-service configuration mode.
Step 4
service phone parameter-name parameter-value
Example:Router(config-telephony)# service phone daysBacklightNotActive 1,2,3,4,5,6,7
Router(config-telephony)# service phone backlightOnTime 07:30
Router(config-telephony)# service phone backlightOnDuration 10:00
Router(config-telephony)# service phone backlightIdleTimeout 00.01
Sets display and phone functionality for all IP phones that support the configured parameters and to which this template is applied.
•
•
Step 5
end
Example:Router(config-telephony)# end
Returns to privileged EXEC mode.
What to Do Next
If you are done modifying parameters for phones in Cisco Unified CME, generate a new configuration file and restart the phones. See the "Generating Configuration Files for Phones" on page 265.
SCCP: Modifying Vendor Parameters For a Specific Phone
To configure parameters in the vendorConfig section of the Sep*.conf.xml configuration file for an individual SCCP phone, perform the following steps.
Restrictions
•
•
•
•
•
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
8.
DETAILED STEPS
Step 1
enable
Example:Router> enable
Enables privileged EXEC mode.
•
Step 2
configure terminal
Example:Router# configure terminal
Enters global configuration mode.
Step 3
ephone-template template-tag
Example:Router (config)# ephone-template 15
Enters ephone-template configuration mode to create an ephone template.
Step 4
service phone parameter-name parameter-value
Example:Router(config-ephone-template)# service phone daysBacklightNotActive 1,2,3,4,5,6,7
Router(config-ephone-template)# service phone backlightOnTime 07:30
Router(config-ephone-template)# service phone backlightOnDuration 10:00
Router(config-ephone-template)# service phone backlightIdleTimeout 00.01
Sets parameters for all IP phones that support the configured functionality and to which this template is applied.
•
•
Step 5
exit
Example:Router(config-ephone-template)# exit
Exits from this command mode to the next highest mode in the configuration mode hierarchy.
Step 6
ephone phone-tag
Example:Router(config)#
ephone 1Enters ephone configuration mode.
Step 7
ephone-template template-tag
Example:Router(config-ephone)# ephone-template 15
Applies an ephone template to the ephone that is being configured.
Step 8
end
Example:Router(config-ephone)# end
Exits configuration mode and enters privileged EXEC mode.
What to Do Next
If you are done modifying parameters for phones in Cisco Unified CME, generate a new configuration file and restart the phones. See the "Generating Configuration Files for Phones" on page 265.
Troubleshooting Vendor Parameter Configuration
Step 1
Step 2
Step 3
Router# show telephony-service tftp-binding
tftp-server system:/its/SEPDEFAULT.cnf
tftp-server system:/its/SEPDEFAULT.cnf alias SEPDefault.cnf
tftp-server system:/its/XMLDefault.cnf.xml alias XMLDefault.cnf.xml
tftp-server system:/its/ATADefault.cnf.xml
tftp-server system:/its/XMLDefault7960.cnf.xml alias SEP00036B54BB15.cnf.xml
tftp-server system:/its/germany/7960-font.xml alias German_Germany/7960-font.xml
tftp-server system:/its/germany/7960-dictionary.xml alias German_Germany/7960-dictionary.xml
tftp-server system:/its/germany/7960-kate.xml alias German_Germany/7960-kate.xml
tftp-server system:/its/germany/SCCP-dictionary.xml alias German_Germany/SCCP-dictionary.xml
tftp-server system:/its/germany/7960-tones.xml alias Germany/7960-tones.xml
Step 4
Configuration Examples for Cisco Unified IP Phone Options
This section contains the following examples:
•
•
•
•
•
•
Text Labels for Ephone-dns: Example
The following example creates text labels for two ephone-dns:
ephone-dn 1
number 2001
label Sales
ephone-dn 2
number 2002
label Engineering
Phone Header Bar Display: Example
The following example provides the full E.164 number for a phone line in the phone header bar:
ephone-dn 55
number 2149
description 408-555-0149
ephone-dn 56
number 2150
ephone 12
button 1:55 2:56
System Text Message Display: Example
The following example specifies text that should display on IP phones when they are not in use:
telephony-service
system message ABC Company
System File Display: Example
The following example specifies that a file called logo.htm should be displayed on IP phones when they are not in use:
telephony-service
url idle http://www.abcwrecking.com/public/logo.htm idle-timeout 35
URL Provisioning for Directories, Services, and Messages Buttons: Example
The following example provisions the Directories, Services, and Messages buttons.
telephony-service
url directories http://10.4.212.4/localdirectory
url services http://10.4.212.4/CCMUser/123456/urltest.html
url messages http://10.4.212.4/Voicemail/MessageSummary.asp
Programmable VendorConfig Parameters: Example
The following partial output shows a template in which programmable parameters for phone and display functionality have been configured by using the service phone command.
ephone-template 1
button-layout 7931 1
service phone daysBacklightNotActive 1,2,3,4,5,6,7
service phone backlightOnTime 07:30
service phone backlightOnDuration 10:00
service phone backlightIdleTimeout 00.01
In the following example, the PC port is disabled on phones 26 and 27. All other phones have the PC port enabled.
ephone-template 8
service phone pcPort 1
!
!
ephone 26
mac-address 1111.1111.1001
ephone-template 8
type 7960
button 1:26
!
!
ephone 27
mac-address 1111.2222.2002
ephone-template 8
type 7960
button 1:27
Additional References
The following sections provide references related to Cisco Unified CME features.
Related Documents
Cisco Unified CME configuration
•
Cisco IOS commands
•
Cisco IOS configuration
•
Phone documentation for Cisco Unified CME
Technical Assistance
Feature Information for Cisco Unified IP Phone Options
Table 62 lists the features in this module and enhancements to the features by version.
To determine the correct Cisco IOS release to support a specific Cisco Unified CME version, see the Cisco Unified CME and Cisco IOS Software Version Compatibility Matrix at http://www.cisco.com/en/US/products/sw/voicesw/ps4625/products_documentation_roadmap09186a0080189132.html.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note
Posted: Wed Aug 15 14:06:06 PDT 2007
All contents are Copyright © 1992--2007 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.
