Guest

Support

Troubleshooting Phone Designer

Hierarchical Navigation

  • Viewing Options

  • PDF (104.1 KB)
  • Feedback
Troubleshooting Phone Designer

Table Of Contents

Troubleshooting Phone Designer

Phone Designer Configuration Files

Phone Designer Log Files

Error Messages

Known Issue


Troubleshooting Phone Designer


August 14, 2008

Phone Designer Configuration Files

Phone Designer Log Files

Error Messages

Known Issue

Phone Designer Configuration Files

The Phone Designer configuration files are located in the following folder:

Windows XP - C:\Documents and Settings\[Windows User Account Name]\Application Data\Cisco\Cisco Unified Phone Application

Windows Vista - C:\Users\[Windows User Account Name]\AppData\Roaming\Cisco\Cisco Unified Phone Application

Table 4-1 describes the Phone Designer configuration folders and files.

Table 4-1

Configuration Files and Folders
Description

\Data\Ringtone

Ringtone collection for the end user.

\Data\Wallpaper

Wallpaper collection for the end user.

\Data\Cache

Current cached ringtone and wallpaper for the Cisco Unified IP Phone.

Log

Not used.

Temp

Temporary ringtone and wallpaper files.

Cupas.xml file

The application settings for the end user, for example, the Cisco Unified Communications Manager server information, user credentials and device information.

Userphones.xml file

This file contains Cisco Unified IP Phone information for the user. The file can be refreshed from the application via the menu path Edit > Settings > Save.

Phonemodels.xml file

This file contains the supported Cisco Unified IP Phone models. The Phonemodels.xml file is generated the first time the Phone Designer application runs after installation. The Phonemodels.xml file is stored in the Application Data folder.


Phone Designer Configuration File and Folder Descriptions

Related Topics

Phone Designer Log Files

Phone Designer Log Files

The Phone Designer log files are located in C:\Program Files\Cisco Systems\Cisco Unified Phone Application\LogFiles. The most recent log file is called phonePersonalization.log. This file rolls over to phonePersonalization.log.1, phonePersonalization.log.2 and so on when the maximum file size is reached. The maximum number of log files is ten. Each log file stores up to 100KB of logged data.

The Phone Designer installer log file is called install.log and is located in the C:\Program Files\Cisco Systems\Cisco Unified Phone Application folder.

Related Topics

Phone Designer Configuration Files

Error Messages

Table 4-2 shows the error messages that can be displayed on the Phone Designer application, and describes a recommended action for each error message.

Table 4-2

Error Displayed
Recommended Action

Unable to connect to the server

This error can occur during login, or if the IP address of the Cisco Unified Communications Manager is entered incorrectly in the Settings screen. Provide your end users with the IP addresses of their Cisco Unified Communications Manager server, and request that they manually enter the (correct) IP address for their Cisco Unified Communications Manager in the server address field on the Settings screen.

Invalid username/password

Provide your end user with the correct username and password for the Cisco Unified Communications Manager server.

The URL is invalid

Provide your end user with the server name of the Cisco Unified Communications Manager server.

An unknown error occurred on your Cisco IP Phone

Verify that personalization is enabled for the Cisco Unified IP Phone on the Cisco Unified Communications Manager server.

Verify that the Cisco Unified IP Phone is registered to the user account on the Cisco Unified Communications Manager server.

Check the log files for the end user.

Invalid device listing received from server

Verify that the Cisco Unified IP Phone is registered to the user account on the Cisco Unified Communications Manager server.

Request that your end user refresh the settings on the application (via the menu path Edit > Settings > Save).

Check the log files for the end user.

If problem persists, send the log files to your Cisco Support representative.

There are no phones assigned to this user

Assign the Cisco Unified IP Phone to the user account on the Cisco Unified Communications Manager server.

The server is currently unavailable

Request that the end user refresh the settings on the application (via the menu path Edit >Settings > Save).

Request that the end user close and re-open the application.

If problem persists, the server may still be busy processing the request. Request that the user try again later.

Personalization is disabled on the selected device

Enable personalization for the Cisco Unified IP Phone on the Cisco Unified Communications Manager server.

The server encountered an internal error

Request that the end user re-enter their user ID on the Settings screen. Point out to the user that this value is case sensitive.

Check the log files for the end user.

If problem persists, send the log files to your Cisco Support representative.

Your Cisco Unified IP Phone is currently unavailable

Check that the Cisco Unified IP Phone is connected and registered.

Request that the end user refresh their settings on the application (via the menu path Edit >Settings > Save).

A communications failure occurred

Verify that the Cisco Unified IP Phone is registered with the Cisco Unified Communications Manager server.

Verify that the Cisco Unified IP Phone is registered to the user account on the Cisco Unified Communications Manager server.

An unknown error occurred

Check the log files for the end user.

If problem persists, send the log files to your Cisco Support representative.


Phone Designer error messages and recommended actions

Known Issue

Problem: On initial launch of the application one of these errors is displayed:

"This is a known operating system issue and a possible workaround is available in the Phone Designer help."

"Phone Designer has encountered a problem and needs to close."

Solution: There may be an issue with the cultural settings on the client PC. Provide your end users with the workaround applicable to their operating system:

(Microsoft Windows XP)


Step 1 Under the Start menu, select Regional and Language Options in the Control Panel.

Step 2 Change the locale from English (United States) to a different locale, such as English (United Kingdom).

Step 3 Click OK.

Step 4 Change the locale back to English (United States).

Step 5 Click OK.


(Microsoft Windows Vista)


Step 1 Under the Start menu, select Regional and Language Options in the Control Panel.

Step 2 Select the Formats tab.

Step 3 Change the locale from English (United States) to a different locale, such as English (United Kingdom), in the Current Format drop down menu.

Step 4 Click OK.

Step 5 Change the locale back to English (United States).

Step 6 Click OK.