Cisco Systems OL-21852-01 User Manual

CHAP T E R

101

IP Phone Services Configuration

Using Cisco Unified Communications Manager Administration, you can define and/or maintain IP phone services that can display on supported Cisco Unified IP Phones models. IP phone services comprise XML applications or Cisco-signed Java MIDlets that enable the display of interactive content with text and graphics on some Cisco Unified IP Phones models.

Cisco Unified Communications Manager provides Cisco-provided default IP phone services, which install automatically with Cisco Unified Communications Manager. You can also create customized Cisco Unified IP Phone applications for your site.

After you configure the services, you can add services to the phones in the database, that is, if they are not classified as enterprise subscriptions, and you can assign the services to the Services, Directory, or Messages buttons/options, if the phone model supports these buttons/options. Users can log in to Cisco Unified CM User Options and subscribe to these services for their Cisco Unified IP Phones; that is, if these IP phone services are not classified as enterprise subscriptions.

This section covers the following topics:

• IP Phone Service Configuration Settings, page 101-1

• IP Phone Service Parameter Settings, page 101-5

• Finding an IP Phone Service, page 101-6

• Configuring an IP Phone Service, page 101-9

• Deleting an IP Phone Service, page 101-10

• Configuring an IP Phone Service Parameter, page 101-11

• Deleting an IP Phone Service Parameter, page 101-12

• Adding an IP Phone Service to a Phone Button, page 101-13

• Related Topics, page 101-14

IP Phone Service Configuration Settings

Using Cisco Unified Communications Manager Administration, you define and maintain the list of IP phone services that can display on supported Cisco Unified IP Phones models. IP phone services comprise XML applications or Cisco-signed Java MIDlets that enable the display of interactive content with text and graphics on some Cisco Unified IP Phones models.

Cisco Unified Communications Manager Administration Guide

OL-21852-01

101-1

IP Phone Service Configuration Settings

After you configure the services, you can add services to the phones in the database, that is, if they are not classified as enterprise subscriptions, and you can assign the services to the Services, Directory, or Messages buttons, if the phone model supports these buttons/options. Users can log in to Cisco Unified CM User Options and subscribe to these services for their Cisco Unified IP Phones; that is, if these IP phone services are not classified as enterprise subscriptions.

Table 101-1 describes the IP phone service configuration settings that display in the IP Phone Services

Configuration window in Cisco Unified Communications Manager Administration. See Table 101-2 for information about the IP phone service parameter settings. For more information about related procedures, see the “Related Topics” section on page 101-14.

Table 101-1 IP Phone Servi ce Confi guration Se tt ings

Field Description

Service Information

Service Name Enter the name of the service. If the service is not marked as an

ASCII Service Name Enter the name of the service to display if the phone cannot display

Service Description Enter a description of the content that the service provides. The

Service URL Enter the URL of the server where the IP phone services application

Chapter 101 IP Phone Services Configuration

enterprise subscription, the service name will display in areas where you can subscribe to a service; for example, under Cisco Unified CM User Options. Enter up to 32 characters for the service name.

For Java MIDlet services, the service name must exactly match the name that is defined in the Java Application Descriptor (JAD) file.

Unicode.

description can include up to 50 characters in any language, but it cannot include double-quotes (“), or single-quotes (‘).

is located. Make sure that this server remains independent of the servers in your Cisco Unified Communications Manager cluster. Do not specify a Cisco Unified Communications Manager server or any server that is associated with Cisco Unified Communications Manager (such as a TFTP server or directory database publisher server).

101-2

For the services to be available, the phones in the Cisco Unified Communications Manager cluster must have network connectivity to the server.

For Cisco-signed Java MIDlets, enter the location where the JAD file can be downloaded; for example, a web server or the backend application server to which the Java MIDlet communicates.

For Cisco-provided default services, the service URL displays as Application:Cisco/<name of service> by default; for example, Application:Cisco/CorporateDirectory. If you modify the service URL for Cisco-provided default services, verify that you configured Both for the Service Provisioning setting, which displays in the Phone, Enterprise Parameter, and Common Phone Profile Configuration windows. For example, you use a custom corporate directory, so you change Application:Cisco/CorporateDirectory to the external service URL for your custom directory; in this case, change the Service Provisioning setting to Both.

Cisco Unified Communications Manager Administration Guide

OL-21852-01

Chapter 101 IP Phone Services Configuration

Table 101-1 IP Phone Servi ce Confi guration Se tt ings (continued)

Field Description

Secure-Service URL Enter the secure URL of the server where the Cisco Unified IP Phone

Service Category Select a service application type (XML or Java MIDlet).

Service Type Choose whether the service is provisioned to the Services,

Service Vendor This field allows you to specify the vendor/manufacturer for the

IP Phone Service Configuration Settings

services application is located. Make sure that this server remains independent of the servers in your Cisco Unified Communications Manager cluster. Do not specify a Cisco Unified Communications Manager server or any server that is associated with Cisco Unified Communications Manager (such as a TFTP server or publisher database server).

For the services to be available, the phones in the Cisco Unified Communications Manager cluster must have network connectivity to the server.

Note If you do not provide a Secure-Service URL, the device uses

the nonsecure URL. If you provide both a secure URL and a nonsecure URL, the device chooses the appropriate URL, based on its capabilities.

If you choose Java MIDlet, when the phone receives the updated configuration file, the phone retrieves the Cisco-signed MIDlet application (JAD and JAR) from the specified Service URL and installs the application.

Directories, or Messages button/option on the phone; that is, if the phone has these buttons/options. To determine whether your phone these buttons/options, refer to the Cisco Unified IP Phone Administration Guide that supports your phone model.

service. This field is optional for XML applications, but it is required for Cisco-signed Java MIDlets.

OL-21852-01

For Cisco-signed Java MIDlets, the value that you enter in this field must exactly match the vendor that is defined in the MIDlet JAD file.

This field displays as blank for Cisco-provided default services.

You can enter up to 64 characters.

Cisco Unified Communications Manager Administration Guide

101-3

IP Phone Service Configuration Settings

Table 101-1 IP Phone Servi ce Confi guration Se tt ings (continued)

Field Description

Service Version Enter the version number for the application.

Chapter 101 IP Phone Services Configuration

For XML applications, this field is optional and is informational only. For Cisco-signed Java MIDlets, consider the following information:

• If you enter a version, the service version must exactly match the

version that is defined in the JAD file. If you enter a version, the phone attempts to upgrade or downgrade the MIDlet if the version is different than what is installed on the phone.

• If the field is blank, the version gets retrieved from the Service

URL. Leaving the field blank ensures that the phone attempts to download the JAD file every time that the phone reregisters to Cisco Unified Communications Manager as well as every time that the Cisco-signed Java MIDlet is launched; this ensures that the phone always runs the latest version of the Cisco-signed Java MIDlet without you having to manually update the Service Version field.

This field displays as blank for Cisco-provided default services.

You can enter numbers and periods in this field (up to 16 ASCII characters).

Enable This check box allows you to enable or disable the service without

removing the configuration from Cisco Unified Communications Manager Administration (and without removing the service from the database).

Unchecking the check box removes the service from the phone configuration file and the phone.

Enterprise Subscription This check box allows you to automatically provision the service to

all devices in the cluster that can support the service. If you check this check box, you (or an end user) cannot subscribe to the service.

If this check box is unchecked, you must manually subscribe to the service for it to display on the phone (either in the Phone Configuration window, in BAT, or in the Cisco Unified CM User Options).

Tip This setting displays only when you configure a service for the

first time. After you save the service, the check box does not display in the window.

To identify whether the service is provisioned to all devices in the cluster that can support the service, go to the Find and List IP Phone Services window and display the services. If true displays in the Enterprise Subscription column, you cannot manually subscribe to the service. If false displays, you can manually subscribe to the service; for example, an end user can subscribe to the service through the Cisco Unified CM User Options.

101-4

Cisco Unified Communications Manager Administration Guide

OL-21852-01

Chapter 101 IP Phone Services Configuration

Table 101-1 IP Phone Servi ce Confi guration Se tt ings (continued)

Field Description

Service Parameter Information

Parameters This pane lists the service parameters that apply to this IP Phone

IP Phone Service Parameter Settings

service. Use the following buttons to configure service parameters for this pane:

• New Parameter—Click this button to display the Configure

Cisco Unified IP Phone Service Parameter window, where you configure a new service parameter for this IP phone service.

• Edit Parameter—Highlight a service parameter that displays in

the Parameters pane, then click this button to display the Configure Cisco Unified IP Phone Service Parameter window, where you can edit the selected service parameter for this IP phone service.

• Delete Parameter—Highlight a service parameter that displays

in the Parameters pane, then click this button to delete a service parameter for this IP phone service. A popup window asks you to confirm deletion.

Refer to the “IP Phone Service Parameter Settings” section on

page 101-5 for details of configuring service parameters for an IP

phone service.

IP Phone Service Parameter Settings

Add the phone service before you configure IP phone service parameters. Refer to the documentation for the individual IP phone service for specific information about whether the service uses parameters, how those parameters should be configured, and whether you should provide optional parameter definitions.

Tip If you remove an IP phone service parameter or change the parameter name of a phone service for a

phone service to which users are subscribed, be sure to click Update Subscriptions to update all currently subscribed users with the changes. If you do not do so, users must resubscribe to the service to rebuild the URL correctly.

When you subscribe devices to the IP phone service, an error results if you click Update Subscriptions more than once. When you update many phones, it can take some time for the changes to propagate to all devices. Click Update Subscriptions only once and wait for this propagation to complete.

Table 101-2 describes the IP phone service parameter settings. For more information about related

procedures, see the “Related Topics” section on page 101-14.

OL-21852-01

Cisco Unified Communications Manager Administration Guide

101-5

+ 9 hidden pages