- What's in This Guide
- Configuring Cisco Unified Communications Manager for the Cisco TelePresence System
- Configuring Cisco TelePresence Features
- Loading Cisco Options Package (COP) Files on the Cisco TelePresence System
- Verifying and Troubleshooting the Cisco TelePresence System Configuration
- Configuring and Managing the Cisco Unified IP Phone
- Satellite Licenses for the Cisco TelePresence System
- Glossary
- Index
- Contents
- Important Notes
- Configuring the Cisco Unified IP Phone
Configuring and Managing the Cisco Unified IP Phone
Revised: June 9, 2015, OL-21851-01

Note This chapter does not apply to systems that use a Touch 12 device for call control or that use software release 6.0.0 or later. Midlets are only used for systems that use a Cisco Unified IP Phone for call control.
Contents
This chapter describes how to configure and manage the Cisco Unified IP Phone and the Enhanced Phone User Interface that uses Java MIDlets on the Cisco Unified IP phone.
Important Notes
See the following advisories and important notes that may affect system behavior:
The supported MIDlets version is embedded in the software files that are available on the
Cisco Unified Communications Manager Support
page at the following URL:
http://www.cisco.com/en/US/products/sw/voicesw/ps556/tsd_products_support_series_home.html
Adding a New Phone with MIDlets Capability
If you are using Unified CM release 8.0 and wish to enable MIDlets features on new phone installations, you must first enable Web Access. Web Access is not enabled by default; it must be enabled manually in the Web Access field of the Product Specific Configuration Layout window.
Configuring the Cisco Unified IP Phone
Use the information in this section to perform the following tasks:

Note The Cisco Unified IP Phone is connected to the Cisco TelePresence device with an Ethernet cable. See the cabling chapters in the Cisco TelePresence Assembly guides for more detailed cabling instructions. Go to the Cisco Support Pages to find installation documentation for your Cisco TelePresence System:
Support > Cisco TelePresence > Cisco TelePresence System
Adding a New Phone
Step 1 Log in to the Cisco Unified CM Administration interface.
Step 2 From the Device drop-down menu, choose Phone. The Find and List Phones Page appears.
Step 3 Choose the type of Cisco Unified IP Phone you have (Cisco 7970, Cisco 7971, or Cisco 7975) from the Phone Type drop-down menu.
Step 4 Click Next. The Phone Configuration window appears.
Step 5 Choose SIP from the Select the Device Protocol drop-down menu.
Step 6 Click Next . The Phone Configuration window is updated with the following configuration fields:
- Device Information
- Protocol Specific Information
- Certification Authority Proxy Function (CAPF) Information
- Expansion Module Information
- External Data Locations Information
- Extension Information
- MLPP Information
- Do Not Disturb
- Secure Shell Information
- Product Specific Configuration Layout
Step 7 Proceed to “Managing Cisco Unified IP Phones” section to configure the fields found in the Phone Configuration window.
Managing Cisco Unified IP Phones
Before starting the following procedure, note the MAC address of the Cisco TelePresence phone device. See the Before You Begin section for information about determining the MAC address.

Note You must restart your system after you have completed the configuration tasks in this section.
Use the tasks in this section to configure the Cisco Unified IP Phone for MIDlets. When you are finished configuring your settings, click Save and follow the prompts to restart the system.
To configure the Cisco Unified IP phone:
Step 1 Log in to the Cisco Unified CM Administration interface.
Step 2 From the Device drop-down menu, choose Phone. The Find and List Phones Page appears.
Step 3 Search for a phone using the fields provided or choose a phone from the drop-down menu.

Tip Search for a device type that contains “7970” or “7975.”
Step 4 Click Find. A list of devices appears.
Step 5 Click on a device in the Device Name (Line) column. The Phone Configuration page for that device appears.
Step 6 In the Phone Type box, verify the following requirements:
Step 7 Enter information in the following sections found on the Phone Configuration page to configure the Cisco IP Phone 7970 Series:
Device Information
Enter the settings to configure the Cisco Unified IP Phone 7970 Series using the information in Table 5-1 as a guide.

Note Assign the same directory number that is assigned to the Cisco TelePresence device to the
Cisco Unified IP Phone 7970 Series.

Note The “Required” column in the table reflects fields marked with an asterisk ( * ) in the administration interface, which are required entries for basic configuration.
Protocol Specific Information
Link the Cisco TelePresence device to Cisco Unified Communications Manager phone profiles for the presence group and security-related SIP phone settings using the information in Table 5-2 as a guide.

Note The “Required” column in the table reflects fields marked with an asterisk ( * ) in the administration interface, which are required entries for basic configuration.
Note For more information about configuring Cisco Unified CM security features, refer to the Cisco Unified Communications Manager Security Guide, Release 7.1(2). |
||
Information in this field reflects SIP profiles that have been created on this Unified CM. See “Configuring the BFCP over UDP Collaboration Feature” in Chapter2, “Configuring Cisco TelePresence Features” |
||
Note When you are finished making changes, click Save to save your settings. |
Certification Authority Proxy Function (CAPF) Information
Table 5-3 describes fields found in the Certification Authority Proxy Function (CAPF) Information section on the Phone Configuration page. Leave all fields unchanged.
Note Security Profile Contains Additional CAPF Settings. See the “Phone Security Profile CAPF Information” section. |
Expansion Module Information
Table 5-4 describes fields found in the Expansion Module Information section on the Phone Configuration page. Leave all fields unchanged.
External Data Locations Information
Define the server locations for external data using the information in the following sections as a guide:

Note Observe the Following—The server designation can be either the IP address or the hostname of the Cisco TelePresence device that is associated with this phone.
If a server hostname is used, it must be resolvable by the Cisco Unified IP Phone 7970 Series DNS.
- The format for each required field is http://server hostname: or IP address: Followed by the 8080 port address, then a slash and one of the following, depending on the field:
– authenticate.html - For CTS release 1.6 systems with MIDlets and earlier (only allowable option)

Tip Be careful when typing URLs to avoid typos.
External Data Location Settings for CTS Release 1.7 and Later

Note CTS Release 1.7 and later releases require that your system be running MIDlets.
Extension Information
Table 5-6 describes fields found in the Extension Information section on the Phone Configuration page.

Note Leave all fields unchanged.
MLPP Information
Leave the multilevel precedence and preemption information (MLPP) Domain field as <None>.
Do Not Disturb
Table 5-7 describes fields found in the Do Not Disturb (DND) section on the Phone Configuration page.
Secure Shell Information
Table 5-8 describes fields found in the Secure Shell Information section on the Phone Configuration page. Leave all fields unchanged.
Product Specific Configuration Layout
Table 5-9 describes fields found in the Product Specific Configuration Layout section on the Phone Configuration page. Leave all fields unchanged. To access this information from the administration interface, click the question mark icon (online help) located at the top of the Product Specific Configuration Layout Area box.

Configuring MIDlets
To use the Enhanced Phone User Interface (MIDlets), your Cisco Unified IP Phone 7970 Series must be configured to run a new application service. This section explains how to implement the MIDlets interface, which is available in Cisco TelePresence System (CTS) Release 1.5 and later releases.
The Cisco Unified IP Phone auto-configures the IP address of the CTS. The CTS obtains the phone IP address using CDP data and CTS sends the command to the Cisco Unified IP Phone to start the MIDlet. The launch command specifies the IP address of the CTS.
If you are upgrading from an older XML specification identifier (XSI) user interface to MIDlets, you must reset the phone and reset the CTS to allow the Java MIDlets application to work with the Cisco Unified IP Phone. See the “Managing Phone Reset and Codec Connectivity” section for reset information.
This section contains the following configuration tasks:
- Creating MIDlets IP Phone Service in Unified CM
- Configuring the MIDlets IP Phone Interface
- Setting Phone URL Parameters for MIDlets
Creating MIDlets IP Phone Service in Unified CM
To create IP Phone Service in Unified CM:
Step 1 Log in to the Cisco Unified CM Administration interface.
Step 2 From the Navigation drop-down menu in the upper right corner, choose Cisco Unified CM Administration and click Go .
Step 3 From the Device drop-down menu, go to Device Settings and click on Phone Services . The Find and List IP Phone Services window appears.
Step 4 Click the Add New button. The IP Phone Services Configuration screen appears.
Step 5 Fill in the following fields:
a. Service Name—Required. The Service Name must match the filename of the .jad file.

Note Your filename must not contain the .jad extension. The .jad extension is appended automatically when you name the file.
b. ASCII Service Name—Required. The ASCII service name must match the configured service name.
c. Service Description—MIDlet UI.
d. Service URL—Required. IP address of the Service URL must be that of the Unified CM and in the following format:
http://xx.xx.xx.xx:6970/TSPM-y-y-y-YY.jad
The following describes the necessary Service URL content:
– xx.xx.xx.xx is the IP address of the Unified CM server.
– y-y-y- is the version of the MIDlet application being added to Unified CM.
– YY is the build version of the MIDlet application being added to Unified CM.
e. Service Category—Required. Choose Java MIDlet from the drop-down menu.
f. Service Type—Required. Choose Standard IP Phone Service.
g. Service Vendor Name—Must be exactly “Cisco” (case-sensitive).
h. Service Version—Leave blank.
Step 6 Click the Enable check box.
Step 7 Click Save to save your changes.
Configuring the MIDlets IP Phone Interface
The Cisco Unified IP Phone auto-configures the IP address of the CTS; the CTS obtains the phone IP address using CDP data and the CTS sends the command to the Cisco Unified IP Phone to start the MIDlet. The system launch command specifies the IP address of the CTS.
To configure each Cisco Unified IP Phone 7970 Series to run the MIDlet IP phone interface:
Step 1 Log in to the Cisco Unified CM Administration interface.
Step 2 From the Navigation drop-down menu in the upper right corner, choose Cisco Unified CM Administration and click Go .
Step 3 From the Device drop-down menu, choose Phone. The Find and List Phones Page appears.
Step 4 Search for a phone using the fields provided or choose a phone from the drop-down menu and click Find. A list of devices appears.
Step 5 Click on a device in the Device Name (Line) column. The Phone Configuration page for that device appears.
Step 6 From the Related Links drop-down menu in the upper right corner, choose Subscribe/Unsubscribe Services and then click Go . The Subscribed Cisco IP Phone Services window for that device appears.
Step 7 In the Service Information box, choose MIDlet IP phone service from the Select a Service drop-down list and click Next. The Subscribed Cisco IP Phone Services window is updated with configurable Service Name and ASCII Service Name fields.
Step 8 Click Subscribe to save your settings or Back to return to the original Subscribed Cisco IP Phone Services window.
If the phone is already subscribed to an older MIDlet version:
a. Unsubscribe the phone from the older service.
b. Subscribe the phone to the new IP phone service that you created in the “Creating MIDlets IP Phone Service in Unified CM” section.
Step 9 Click Save to save your settings.

Note If you are upgrading from an older XML specification identifier (XSI) user interface to MIDlets, you must reset the phone and reset the CTS to allow the Java MIDlets application to work with the Cisco Unified IP Phone. See the “Managing Phone Reset and Codec Connectivity” section for reset information.
Setting Phone URL Parameters for MIDlets
Make sure the default services URL is set for MIDlets. To override default settings:
Step 1 Log in to the Cisco Unified CM Administration interface.
Step 2 Choose System > Enterprise Parameters Configuration.
Step 3 In the Phone URL Parameters box, set the URL Services in the following format:
http://xx.xx.xx.xx:8080/ccmcip/getservicesmenu.jsp
Where xx.xx.xx.xx is the IP address of the Unified CM server.

Note You may use a hostname providing the CTS and the phone is provisioned with a DNS name server.
Step 4 Click Save to save your settings.
MIDlets Troubleshooting Tips
- If the MIDlet does not come up at all, verify that the Unified CM is subscribed. Reset the phone.
- Verify that the phone has the correct firmware for that MIDlet.
- Verify that the CTS has the correct image for that MIDlet.
- If the MIDlet comes up with a blank white screen, verify that the Service URL for the phone is blank.
- If the phone fails to register, verify that phone type is set correctly. For example, Cisco Unified IP Phone 7970 should not be set as 7975.
- If the phone is stuck in the initializing phase, restart TSPS on the CTS. If after the restart the phone shows “phoneui=xsi,” reboot the CTS.
- Check the Service URL. If it ends with “services.html,” make it blank and apply changes. Reboot the CTS.
- If no services appear on the phone, even though subscribed to a valid service, check the “Services Provisioning” field to make sure it is set to Default.
- If the MIDlet fails to start, make sure that the Enable box checked.
- Make sure the service that you are using to subscribe your phone is pointing to the correct JAD file.
Assigning a Directory Number for the Shared-Line Cisco Unified IP Phone
To assign a directory number to a shared-line Cisco Unified IP phone, perform the following tasks using the Cisco Unified Communications Manager Administration interface.
Adding a New Directory Number
To add a new directory number:
Step 1 Log in to the Cisco Unified CM Administration interface.
Step 2 From the Device drop-down menu, choose Phone. The Find and List Phones Page appears.
Step 3 Locate and click the highlighted Cisco Unified IP phone device that you created in the “Adding a Cisco TelePresence Image to the Cisco Unified Communications Manager Server” section. The Association Information window appears.
Step 4 In the Association Information window, click Line [1] - Add a new DN . The Directory Number Configuration window appears.

Note Use the device MAC address to help you determine which line to select. The MAC address is also used as a device number (represented by X in this document) for the settings in the Directory Number Configuration window.
Step 5 Proceed to the “Configuring the Directory Number for a Shared Line” section to configure the directory number for a shared line in the Directory Number Configuration window.
Configuring the Directory Number for a Shared Line

Note You must restart your system after you have completed the configuration tasks in this section.
To configure the directory number for a shared line, perform the tasks in the following sections. When you are finished configuring your settings, click Save and follow the prompts to restart the system.
Configuring Directory Number Information
To configure directory number information:
Step 1 Enter the directory number settings for the shared Cisco Unified IP Phone line using the information in Table 5-10 as a guide.
Step 2 Make sure that the following check box at the bottom of the Directory Number Information window is marked as indicated:
Step 3 Click Save to save your settings.
Enabling Auto Answer Option
To enable the Auto Answer option:
Step 1 Choose Auto Answer with Speakerphone in the Auto Answer drop-down menu. Use default settings for all other selections. See the “Directory Number Settings” section.
Step 2 Click Save to save your settings.
Call Forward and Call Pickup Settings
Leave all fields unchanged. See the “Call Forward and Call Pickup Settings” section.
Line X on Device X
Leave all fields unchanged. See the “Line X on Device X” section.
Multiple Call/Call Waiting Settings on Device X
See the Multiple Call/Call Waiting Settings on Device SEPXXXXXXXXXXXX.
Verifying and Troubleshooting IP Phone Configuration
The following sections describe how to verify your Cisco TelePresence System (CTS) with Cisco Unified Communications Manager (Unified CM) configuration:
- Verifying Your Configuration
- Troubleshooting Your IP Phone Configuration
- Managing Phone Reset and Codec Connectivity
Verifying Your Configuration
To verify that your Cisco TelePresence System is configured successfully:
Step 1 Log in to the Cisco Unified CM Administration interface.
Step 2 From the Device drop-down menu, choose Phone. The Find and List Phones Page appears.
Step 3 Search for a phone using the fields provided or choose a phone from the drop-down menu.

Tip Search for a device type that contains “7970” or “7975.”
Step 4 Click Find. A list of devices appears.
Step 5 Click on a device in the Device Name (Line) column. The Phone Configuration page for that device appears.
Step 6 Verify that the following devices are registered:
Troubleshooting Your IP Phone Configuration
Use the information in Table 5-11 to help you troubleshoot your configuration.
Verify Phone Registration—Log in to the Cisco Unified CM Administration interface. Click on the IP address and verify phone registration. |
||
The phone does not display the Cisco TelePresence idle screen. |
– Unified CM does not know about it. – CTS is not registered because it is unplugged. |
1. Verify Phone Registration—Log in to the Cisco Unified CM Administration interface. Click on the IP address and verify phone registration. 2. Verify Phone in the System—Log in to the Cisco TelePresence System Administration interface to verify that the system can detect the phone. 3. Correct Typos in URL—See Managing Cisco Unified IP Phones for information about configuring external URLs. |
The CTS rings and auto-answers a call based on how these features were configured in Unified CM. If the call is connected as audio only, check your IP phone configuration and make sure the “Disable Speaker/Headset” box is checked. To disable the IP phone speaker/headset: 1. Log on to the Cisco Unified CM Administration interface. 2. Search for your directory number (DN). Two devices are displayed: CTS and IP Phone 3. Click on the IP_Phone device. 4. Scroll down to the Product Specific Configuration Layout Area window. 5. Verify that the following check-boxes are checked in the Product Specific Configuration Layout window: – Disable Speakerphone and Headset 6. Apply and Save the configuration. 7. Reset the device. See the “Managing Phone Reset and Codec Connectivity” section for reset information. |
||
MIDlet fails to start up properly, shows the following message: |
MIDlet cannot establish TCP connections with the CTS. Possible incorrect CTS IP address is assigned to the phone profile authentication server URL. |
1. Ensure that the correct CTS IP address is in the Authentication Server URL for the phone device in Unified CM. See Managing Cisco Unified IP Phones for information about configuring external URLs. See also the “Managing Phone Reset and Codec Connectivity” section for reset information. |
The phone firmware is unable to uninstall the older version cleanly to make way for the new version. The issue happens during upgrade of the MIDlet if the phone is not reset after the upgrade. |
Reset the phone after upgrade. See the “Managing Phone Reset and Codec Connectivity” section for reset information. See also Managing Cisco Unified IP Phones for information about configuring external URLs. |
|
MIDlet fails to initialize properly, showing the following message: |
The MIDlet does not find Authentication Server URL or it does not recognize its format. |
1. Properly configure the Authentication Server URL for the phone See Managing Cisco Unified IP Phones for information about configuring external URLs. See also the “Managing Phone Reset and Codec Connectivity” section for reset information. |
Cisco Unified IP Phone 7970 Series goes dead during CTS endpoint or MIDlet upgrade. |
Occasionally, an unexpected phone power cycle can occur during a CTS endpoint or MIDlet version upgrade. During CTS endpoint upgrades, the CTS briefly powers off the phone then brings it back up when upgrade is complete. But if the phone power cycle is occurring at the same time, the phone's firmware image can be damaged and the phone will not power back on. |
To avoid this problem, unplug the phone before upgrading the CTS endpoint. When upgrade is complete, plug the phone back in and upgrade the MIDlet. If you encounter a phone that will not power back on after a CTS endpoint or MIDlet upgrade, perform a phone factory reset to restore the firmware image. See Resetting the Cisco Unified IP Phone 7970 Series Factory Image. |
On some CTS 500 installations, the Cisco Unified IP Phone rejects a direct firmware upgrade. |
During installation, Cisco Unified Communications Manager will automatically upgrade the firmware on Cisco Unified IP Phone 7970 Series to the minimum version required. But if the firmware on the IP phone is outdated, the phone may reject the direct firmware upgrade. |
Upgrade the IP Phone 7970 Series to an intermediate unsigned firmware version before upgrading to the final firmware required by the endpoint. See Adding a Cisco TelePresence Image to the Cisco Unified Communications Manager Server for download instructions. See also the Cisco Unified Communications Operating System Administration Guide for complete software upgrade instructions. |
Managing Phone Reset and Codec Connectivity
The following sections contain information about managing the following system components:
Information About Phone Reset
If a device is not registered with Cisco Unified Communications Manager, you cannot reset or restart it. If a device is registered, to restart a device without shutting it down, click the Restart button. To shut down a device and bring it back up, click the Reset button. To return to the previous window without resetting or restarting the device, click Close.

Note Resetting a gateway/trunk/media devices drops any calls in progress that are using that gateway/trunk/media devices. Restarting a gateway/media devices tries to preserve the calls in progress that are using that gateway/media devices, if possible. Other devices wait until calls are complete before restarting or resetting. Resetting/restarting a H323 device does not physically reset/restart the hardware; it only reinitializes the configuration loaded by Cisco Unified Communications Manager.
Resetting the Cisco Unified IP Phone 7970 Series
Reset a Cisco Unified IP Phone at any time by following these steps:

Note If a call is in progress, the phone does not reset until the call completes.
Step 1 Choose Device > Phone. The Find and List Phones window appears.
Step 2 To locate a specific phone, enter search criteria and click Find. A list of phones that match the search criteria displays.
Step 3 Click the check boxes next to the phones that you want to reset. To choose all the phones in the window, click Select All.
Step 4 Click Reset Selected. The Device Reset window appears.
Step 5 Choose Reset from the listed options in the Device Reset window.
This shuts down the chosen devices and brings them back up (performs a complete shutdown and reinitialization of the phones).

Note See the “Synchronizing a Phone” section for instructions on updating the phone with the latest configuration changes by using the least-intrusive method.
Synchronizing a Phone
To synchronize a phone with the most recent configuration changes, perform the following procedure, which applies any outstanding configuration settings in the least-intrusive manner possible. (For example, a reset/restart may not be required on some affected devices.).
Step 1 Choose Device > Phone . The Find and List Phones window appears.
Step 2 Choose the search criteria to use and Click Find . The window displays a list of phones that match the search criteria.
Step 3 Check the check boxes next to the phones that you want to synchronize. To choose all phones in the window, check the check box in the matching records title bar.
Step 4 Click Apply Config to Selected . The Apply Configuration Information dialog displays.
Resetting the Cisco Unified IP Phone 7970 Series Factory Image
To reset the phone to the factory image:
Step 1 Disconnect the power from the phone.
Step 2 While holding down the “#” key, reconnect the power.
Step 3 As soon as you see the line button lights to the right side of the display cycling yellow, release the “#” key.
Step 4 Press the following buttons in sequence: 3, 4, 9, 1, 6, 7, 2, 8, 5, 0, *, #.
The cycling line button lights then change from yellow to red. Within a few minutes the phone will begin booting.