Table Of Contents
Troubleshooting Cisco Unified Personal Communicator
How to Use Diagnostic Tools
Capturing Detailed Logs for Other Application Problems
Capturing Logs Automatically When the Applications Crashes
Capturing Call Statistics for Audio and Video Problems
Events That Cause Call Statistics Collection
Call Statistics Refresh Rate and Log Format
Statistics for Calls Involving IP Phones
Audio Call Statistics Field Information
Video Call Statistics Field Information
Capturing Server Connection Status Information
Diagnosing Problems by Using the TAC Case Collection Tool
How to Resolve Audio Problems
One-Way Audio Problems
User on Hears Robotic Sounds While Connected Through a Low-Bandwidth Link
How to Resolve Starting Calls and Sending E-Mail Problems
Button and Menu Item Are Not Selectable When Making a Call or Sending an E-mail
How to Resolve Contact List Problems
Cannot Add a Contact to Any Existing Group or to Any New Group
How to Resolve Desk-Phone Problems
Cisco Unified Personal Communicator Remains in No Phone Mode (Disabled) After Launching
Cisco Unified Personal Communicator Changes to Disabled Mode After Logging In and Selecting Desk-Phone Mode
How to Resolve Directory Problems
Directory Search Returns No Results, Incorrect Results, or Unexpected Results
Cannot Connect to LDAP Server to Resolve Names
User Experiences Slow LDAP Directory Searches
Single-Character or Group-Character Searches Provide Users Whose Names Are Blank Or Whose Phone Numbers Are Shown As Unknown
Wrong Picture Is Displayed When Dialing a Contact in the Corporate Directory
Phone Number Does Not Resolve to a Name
How to Resolve Instant Messaging Problems
Send Instant Message Option is Disabled
User Has Unknown State and Cannot Receive Messages
How to Resolve Log In and Network Connection Problems
Login to Cisco Unified Personal Communicator Fails After Entering Correct Information
How to Resolve Online Help Problems
User Unable to View Online Help
How to Resolve Reachability Status Problems
User in Contact List Shows Offline Status Even When Logged In to Cisco Unified Personal Communicator
Reachability Status of Contacts in the Contact List Is Incorrect or Missing
Reachability Status Does Not Change from Available to Busy
Reachability Information for Contacts in the Contact List Is Not Available for Large Contact Lists
How to Resolve Soft-Phone Problems
Cisco Unified Personal Communicator Does Not Connect the Phone
Cisco Unified Personal Communicator Changes to Desk Phone or to Disabled After Selecting Soft-Phone Mode
How to Resolve Video Problems
Supported Video Telephony Camera Does Not Function
Full-Screen Overlaid on Second Monitor When Calling a Cisco Unified Video Advantage Endpoint
Incoming Video is Black
Video Merge Does Not Create a Video Conference
How to Resolve Voice-Mail Problems
Voice Mail Does Not Appear in the Recent Pane
Voice-Mail Server Is Up, User Credentials Are Correct, But Voice-Mail Messages Are Not Downloaded
Send to Voicemail Option Is Not Selectable
How to Resolve Cisco Unified MeetingPlace Express Web Conferencing Problems
Web Conferencing Button Is Not Selectable in Cisco Unified Personal Communicator
Conference Is Initiated on Host But Meeting Room Does Not Launch for Other Participants
Slow Performance When Escalating to a Web Conference from Within a Cisco Unified Personal Communicator Conversation
Unable to Start or End a Web Conferencing Session
Unable to Start or End a Web Conferencing Session; Error Communicating with the Server
Unable to Start or End a Web Conferencing Session; Could Not Contact Server
System Attempted to Schedule a Web Conference Without a Preferred Language
Web Conferencing Server Has Reached Its Licensed Capacity
Unable to Log In to the Web Conferencing Server; Internal Error; Login Module Exception
User Login ID or Password for Web Conferencing Server Is Invalid or Has Expired
User Password Has Expired on Cisco Unified MeetingPlace Express
User Profile Is Locked or Inactive
Web Conference That You Attempted to End No Longer Exists
Web Conference That You Attempted to End Has an Invalid Meeting Type
System Attempted to Schedule a Web Conference with an Invalid Length
System Attempted to Schedule a Web Conference with a Duration That Exceeds the Maximum
System Attempted to Schedule a Web Conference for an Invalid Number of Parties
System Attempted to End a Web Conference Without Specifying a Meeting ID
Password for the Web Conferencing Server Is Missing
Web Conferencing Server Cannot Schedule the Meeting; Internal Scheduling Error
Web Conferencing Server Is Not Ready to Accept Requests
Login ID for Web Conferencing Server Is Missing
How to Resolve Cisco Unified MeetingPlace Web Conferencing Problems
Web Conferencing Button Is Not Selectable in Cisco Unified Personal Communicator
Conference Is Initiated on Host But Meeting Room Does Not Launch for Other Participants
User Profile Is Locked or Inactive
User Password Has Expired on Cisco Unified MeetingPlace
User Can Access Cisco Unified MeetingPlace from a Browser But Cisco Unified Personal Communicator Reports the Credentials Are Wrong
Password for the Web Conferencing Server Is Missing
User Does Not Have Permission to Start or End a Meeting
Web Conferencing Session Will Not Start or End
Unable to Start or End Web Conferencing Session; Web Server Is Not Connected
Meeting No Longer Exists on the Cisco Unified MeetingPlace Server
Cisco Unified MeetingPlace Host Name Is Not Resolving
Proxy Server Host Name Is Not Resolving
Web Server Does Not Respond Within Timeout Interval
Web Server Returns an Empty Response
Security Certificate Is Not Verifiable
Security Certificate Is Invalid
Security Certificate Is Invalid or Not Readable
Security Certificate Does Not Match Target Host Name
Troubleshooting Cisco Unified Personal Communicator
This chapter provides troubleshooting information for common Cisco Unified Personal Communicator issues.
•
How to Use Diagnostic Tools
•
How to Resolve Audio Problems
•
How to Resolve Starting Calls and Sending E-Mail Problems
•
How to Resolve Contact List Problems
•
How to Resolve Desk-Phone Problems
•
How to Resolve Directory Problems
•
How to Resolve Instant Messaging Problems
•
How to Resolve Log In and Network Connection Problems
•
How to Resolve Online Help Problems
•
How to Resolve Reachability Status Problems
•
How to Resolve Soft-Phone Problems
•
How to Resolve Video Problems
•
How to Resolve Voice-Mail Problems
•
How to Resolve Cisco Unified MeetingPlace Express Web Conferencing Problems
•
How to Resolve Cisco Unified MeetingPlace Web Conferencing Problems
Note
The Cisco Unified Personal Communicator online help also contains troubleshooting information that end users can use to solve many problems. You can access this information at this URL:
http://www.cisco.com/en/US/products/ps6844/products_user_guide_list.html
For Cisco Unified Presence troubleshooting information, see the serviceability administration guide at this URL:
http://www.cisco.com/en/US/products/ps6837/tsd_products_support_series_home.html
How to Use Diagnostic Tools
•
Capturing Detailed Logs for Other Application Problems
•
Capturing Logs Automatically When the Applications Crashes
•
Capturing Call Statistics for Audio and Video Problems
•
Capturing Server Connection Status Information
•
Diagnosing Problems by Using the TAC Case Collection Tool
Capturing Detailed Logs for Other Application Problems
Sometimes, you need detailed log files to help troubleshoot problems with Cisco Unified Personal Communicator. Detailed logs have these characteristics:
•
By default, detailed logging is disabled, and logs are collected at the information level (3).
•
When enabled, detailed logging applies only to the client computer on which Cisco Unified Personal Communicator is running when users enabled it.
•
Detailed logs are collected at the verbose level (5).
•
Detailed logs remains enabled until the user changes the setting.
Restrictions
Caution 
You should ask users to enable detailed logging only when you are trying to resolve a specific issue. Detailed logging will cause degraded performance especially in lower-end computers. Make sure to instruct users to disable detailed logging when your troubleshooting activities are completed.
Procedure
Step 1
Tell users to follow the user guide instructions for capturing log files:
•
Enable detailed logging on their computers (Help > Enable Detailed Logging).
•
If possible, restart Cisco Unified Personal Communicator to clear the logs and to put the application in a known state. If the problem is intermittent or unexpected, capture the logs without restarting the application.
•
Recreate the problem, if possible.
•
Manually launch the Problem Reporting Tool (Problem Reporting Assistant on Mac) and send the report to you.
Step 2
Provide the Zip file to the Cisco Technical Assistance Center (TAC) representative, if requested.
Capturing Logs Automatically When the Applications Crashes
If Cisco Unified Personal Communicator unexpectedly crashes, the Problem Reporting Tool (Problem Reporting Assistant on Mac) automatically collects installation, application, and client computer system information to automate the trace and crash-dump collection process on the client computer. It also creates a dump file.
Before You Begin
Users who roam from one computer to another must generate the problem report on the computer from which the problem occurred so that the correct logs are attached. By design, log files do not roam with a user from computer to computer.
Procedure
Step 1
Tell users to follow the user guide instructions for capturing log files:
•
Locate the automatically generated Zip file on their desktop.
•
Send the Zip file from their desktop to you through e-mail.
Step 2
Provide the Zip file to the Cisco Technical Assistance Center (TAC) representative, if requested.
Troubleshooting Tips
•
If a blue screen failure occurs, the Problem Reporting Tool (Problem Reporting Assistant on Mac) does not generate an application crash dump even if the cause of the blue screen might be attributed to an interoperability issue between Cisco Unified Personal Communicator and the operating system.
•
The tool uses GMT so the date stamp in the filename of the generated report (for example) could appear incorrect.
Capturing Call Statistics for Audio and Video Problems
Cisco Unified Personal Communicator provides call statistics to help you diagnose and resolve audio and video quality issues. The application generates audio call statistics information; video call statistics information is generated only when a call is escalated to video or originated with video. Statistics are generated when a call is streaming (active) but not when the call is held.
When detailed logging is enabled, call statistics are logged on all significant call events. At the end of each call, call statistics information is saved to the log file.
•
If the user has the Call Statistics window open, information is logged in abbreviated form on a consistent basis for as long as the window is opened, providing data that you can plot over time to track trends.
•
If the user clicks Save to Log, the application dumps a full version of the statistics to the log file in a tabular format.
Procedure
Step 1
Tell users to follow the user guide instructions to enable detailed logging, capture log files, and send the log through the Problem Reporting Tool (Problem Reporting Assistant on Mac).
Step 2
Provide this information to the Cisco Technical Assistance Center (TAC) representative, if requested.
Related Topics
•
Events That Cause Call Statistics Collection
•
Call Statistics Refresh Rate and Log Format
•
Statistics for Calls Involving IP Phones
•
Audio Call Statistics Field Information
•
Video Call Statistics Field Information
Events That Cause Call Statistics Collection
Call statistics are collected when these significant events occur:
•
When a call is suspended or held, video is paused, or audio is muted
•
When a call is over (hung up or otherwise terminated)
•
Shortly after a call is established (5 to 10 seconds)
•
Shortly after any media renegotiation (when video is added or when a call is held and resumed)
•
When an I-Frame is requested
•
When a significant stream error occurs
Related Topics
•
Call Statistics Refresh Rate and Log Format
Call Statistics Refresh Rate and Log Format
Call statistics are saved to the log under these conditions:
•
Call statistics are saved to the log in full format whenever one of the significant call events occur, including the end of a call. Therefore, each call has at least one full dump in table format of the calls statistics in the log.
•
Call statistics are saved to the log in abbreviated format for each Audio RTCP Receiver Report that is sent or received (about every 5 seconds). Because the Audio RTCP Receiver Report triggers the log capture, the log contains data from all RTCP reports: audio and video, send and receive, and incoming and outgoing.
•
If the user has the Call Statistics window open, statistics are refreshed once a second. These statistics are shown in the window and are also saved to the log in abbreviated format (short, comma-delimited form).
Note
Because the statistics that come from RTCP reports occur about every 5 seconds, the statistics in the Call Statistics window might not change once a second even though the check for new statistics occurs every second. Other statistics, such as some of those for video, change each second.
Statistics for Calls Involving IP Phones
Many IP phones, including Cisco Unified IP Phones, do not support sending RTP Control Protocol (RTCP) reports. Therefore, for calls involving these phones, RTCP-derived statistics are not available and display as 0 in the call statistics.
Related Topics
•
Audio Call Statistics Field Information
•
Video Call Statistics Field Information
Audio Call Statistics Field Information
Table 1-1 describes the fields on the Help > Show Call Statistics > Audio Statistics tab (on Windows) and on the Help > Show Call Statistics > Audio tab (on Mac).
The Audio Transmit column shows statistics on outgoing data and local information.
The Audio Receive column shows statistics on incoming data and remote information.
Table 1-1 Audio Call Statistics (Transmitted and Received)
Field
|
Description
|
Codec
|
Current audio codec
|
Bitrate
|
Current audio bit rate of the codec in kbps
|
Total Packets
|
Number of audio packets
|
Packets Lost
|
Number of packets lost
|
Average Jitter
|
Interarrival jitter in milliseconds
|
Maximum Jitter
|
Maximum observed jitter in milliseconds
|
Total Bytes
|
Number of bytes sent and received
|
These RTCP-derived statistics display as 0 when RTCP reports are not available:
•
Received Total Packets
•
Received Packets Lost
•
Received Total Bytes
•
Transmitted Average Jitter
•
Transmitted Maximum Jitter
If you make Cisco Unified Personal Communicator-to-Cisco Unified Personal Communicator calls, RTCP reports are available in both directions and all fields are populated.
Video Call Statistics Field Information
Table 1-2 describes the fields on the Help > Show Call Statistics > Video Statistics tab (on Windows) and on the Help > Show Call Statistics > Video tab (on Mac). For audio-only calls, the fields display zero or --. If Cisco Unified Personal Communicator is only sending or only receiving video, half the values are zero or --.
The Video Transmit column shows statistics on outgoing data and local information.
The Video Receive column shows statistics on incoming data and remote information.
Table 1-2 Video Call Statistics (Transmitted and Received)
Field
|
Description
|
Codec
|
Current video codec
|
Bitrate
|
Current video bit rate in kbps
|
Resolution
|
Reported resolution (CIF, QVGA, and so forth)
|
Total Packets
|
Number of video packets
|
Packets Lost
|
Number of packets lost
|
Average Jitter
|
Interarrival jitter in milliseconds
|
Maximum Jitter
|
Maximum observed jitter in milliseconds
|
Frame Rate
|
Current frame rate in frames per second (fps)
|
Total Frames
|
Total frames sent and received
|
Total Partial Frames
|
Number of partial frames
|
Partial Frame Lost
|
Number of partial frames lost
|
Total i-Frame Requests
|
Number of i-Frames requested
|
Total Frame Errors
|
Number of frame errors
|
Total Bytes
|
Number of bytes sent and received
|
These RTCP-derived statistics display as 0 when RTCP reports are not available:
•
Received Total Packets
•
Received Packets Lost
•
Transmitted Average Jitter
•
Transmitted Maximum Jitter
If you make Cisco Unified Personal Communicator-to-Cisco Unified Personal Communicator calls, RTCP reports are available in both directions and all fields are populated.
Capturing Server Connection Status Information
The server health window (Help > Show Server Health on Windows and Help > Show System Diagnostics on Mac) provides this information:
•
Client configuration information such as server addresses, protocols used to connect to servers, user IDs, and other server-specific configuration information
•
Status of the connected state of the server that is updated in real time
–
For LDAP and web conferencing servers (Cisco Unified MeetingPlace or Cisco Unified MeetingPlace Express) that do not maintain constant connections to Cisco Unified Personal Communicator, the status shows the result of the most recent interaction; no polling or heartbeat mechanism is implemented.
–
At start up, Cisco Unified Personal Communicator checks the connection to the web conferencing server and shows the connection status as successful in the server health window even though the user might have entered invalid user credentials. User credentials are checked when the user launches the web conferencing session from within Cisco Unified Personal Communicator. If the credentials are invalid, a message is displayed in the server health window.
Procedure
Step 1
Tell users to follow the troubleshooting instructions in the user guide to access the server health window (Help > Show Server Health on Windows and Help > Show System Diagnostics on Mac) and to provide that information to you.
Note
Status transitions are logged and provided in the Problem Reporting Tool (Problem Reporting Assistant on Mac); users do not need to note this information or provide it with the Zip file.
Step 2
Provide the information to the Cisco Technical Assistance Center (TAC) representative, if requested.
Related Topics
•
How to Resolve Log In and Network Connection Problems
Diagnosing Problems by Using the TAC Case Collection Tool
By using the Cisco Technical Assistance Center (TAC) Case Collection tool, you can interactively diagnose common problems involving hardware, configuration, and performance issues with solutions provided by Cisco TAC engineers.
Restriction
This tool is available only to registered Cisco.com users with a Cisco service contract.
Procedure
Step 1
Log in to Cisco.com.
Step 2
Choose Support > Tools and Resources, and select TAC Case Collection.
Step 3
Select a technology or product area to begin troubleshooting.
For example, if you select Voice, you access a knowledge base for voice-over-data networks and IP telephony:
•
Voice applications, Cisco Unified Communications Manager, Cisco Unity Connection, and so forth
•
Voice quality (with diagnostic sound samples)
•
Voice gateways
•
Other voice-related issues
For details, click the TAC Case Collection link at this URL:
http://www.cisco.com/en/US/support/tsd_most_requested_tools.html
How to Resolve Audio Problems
•
One-Way Audio Problems
•
User on Hears Robotic Sounds While Connected Through a Low-Bandwidth Link
One-Way Audio Problems
Problem
The user reports very low volume or one-way audio problems.
Solution
Try these solutions:
•
Verify that the user has correctly identified and established the audio device and tried the troubleshooting solutions described in the Cisco Unified Personal Communicator user guide.
•
If the one-way audio problem occurs over a Cisco VPN client (for Windows), make sure the Stateful Firewall setting is disabled on the client computer.
•
If the user experiences no audio or one-way audio problems, check the firewall configuration on the client computer or on the network. Verify that the correct network ports for Cisco Unified Personal Communicator operation are open. For details, see the release notes as this URL:
http://www.cisco.com/en/US/products/ps6844/prod_release_notes_list.html
Related Topics
•
How to Resolve Reachability Status Problems
User on Hears Robotic Sounds While Connected Through a Low-Bandwidth Link
Problem
The user experiences hearing robotic sounds with another caller while connected through a low-bandwidth link, such as a broadband connection or a low-bandwidth interoffice trunk.
Solution
In Cisco Unified Communications Manager Administration, change the Cisco Unified Personal Communicator soft-phone device configuration to use a low bitrate codec. This selection helps reduce the upstream bandwidth consumption and improve voice quality.
Step 1
In Cisco Unified Communications Manager Administration, if you do not have a predefined device pool, create a region (System > Region).
Step 2
Change the audio codec selection to iLBC (preferred) or to G.729 (alternatively).
Step 3
Create the device pool (System > Device Pool), and select the region just created that has the G.729 codec configuration.
Step 4
Click Save.
Step 5
Choose Phone > Device.
Step 6
Search for the Cisco Unified Personal Communicator soft-phone device that needs to be altered.
Step 7
On the Phone Configuration page, change the Device Pool field to a predefined pool that you configured with codec in Step 2.
Step 8
Click Save.
How to Resolve Starting Calls and Sending E-Mail Problems
•
Button and Menu Item Are Not Selectable When Making a Call or Sending an E-mail
Button and Menu Item Are Not Selectable When Making a Call or Sending an E-mail
Problem
The user reports the button and menu item are not selectable (grayed out) when trying to place a call or place a video call, and when sending an e-mail.
Solution
Try these solutions:
•
Ask users to try the solutions described in the troubleshooting section of the user guide.
•
Check the LDAP directory server, and make sure that the contact information is complete (valid e-mail address or phone number).
•
Confirm that you added Cisco Unified Personal Communicator as a phone type to Cisco Unified Communications Manager Administration for this user to create the soft-phone audio and video capability.
•
Confirm that Cisco Unified Personal Communicator is properly integrated with the voice-mail server.
For details, see the Cisco Unified Personal Communicator installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
How to Resolve Contact List Problems
•
Cannot Add a Contact to Any Existing Group or to Any New Group
Cannot Add a Contact to Any Existing Group or to Any New Group
Problem
The user reports not being able to add a contact to any existing group or to any new group. The Add Contact to Group option is greyed out on the right-click menu, and the Actions > Add Contact to Group menu does not add the contact to the group.
Solution
Try these solutions:
•
The UserID attribute in the LDAP Attribute Mapping table might be incorrectly configured in Cisco Unified Presence Administration (Application > Unified Personal Communicator > Settings). For details about configuring the Cisco Unified Presence LDAP settings, see the Cisco Unified Personal Communicator installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
•
Make sure the contact to be added is in the Cisco Unified Communications Manager and in the Cisco Unified Presence databases.
How to Resolve Desk-Phone Problems
•
Cisco Unified Personal Communicator Remains in No Phone Mode (Disabled) After Launching
•
Cisco Unified Personal Communicator Changes to Disabled Mode After Logging In and Selecting Desk-Phone Mode
Cisco Unified Personal Communicator Remains in No Phone Mode (Disabled) After Launching
Problem
The user reports that when Cisco Unified Personal Communicator is launched, it remains in the No Phone mode (Disabled mode on Mac).
Solution
Try these solutions:
•
Ask the user to access the server health window (Help > Show Server Health on Windows and Help > Show System Diagnostics on Mac) and to provide that information to you. The window provides status information that helps you resolve connection and configuration problems.
•
Instruct the user to try switching to soft-phone mode to see if the phone registers. If the application returns to No Phone (or to Disabled on Mac) mode, check the configuration in Cisco Unified Communications Manager Administration and in Cisco Unified Presence Administration.
•
Instruct the user to choose the phone to control through the Cisco Unified Personal Communicator interface. For details, see the user guide at this URL:
http://www.cisco.com/en/US/products/ps6844/products_user_guide_list.html
•
The Cisco Unified IP Phone is not configured in Cisco Unified Communications Manager Administration.
Configure the Cisco Unified IP Phone to be controlled through CTI.
In Cisco Unified Communications Manager Administration, perform these steps:
a.
Add the Cisco Unified IP Phone to the database, and configure it to be controlled from CTI.
b.
Associate the phone to the end user.
c.
Add the end user to the CTI users group (Standard CTI Enabled).
d.
Add the end user to a user group (Standard CCM End Users).
e.
Add Cisco Unified Personal Communicator as a soft-phone device, and configure a shared line between the soft-phone and the phone.
f.
Set up the user account, and associate the directory number (primary extension) to the user.
For detailed Cisco Unified Communications Manager Administration steps, see the Cisco Unified Personal Communicator installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
•
The CTI gateway is not correctly configured in Cisco Unified Presence Administration. Choose Application > Unified Personal Communicator > CTI Gateway Server and Application > Unified Personal Communicator > CTI Gateway Profile.
For detailed Cisco Unified Presence Administration steps, see the Cisco Unified Personal Communicator installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
Cisco Unified Personal Communicator Changes to Disabled Mode After Logging In and Selecting Desk-Phone Mode
Problem
The user reports that after logging in to Cisco Unified Personal Communicator and selecting desk-phone mode, the application automatically changes to the disabled mode after a few seconds.
Solution
One or more servers are incorrectly configured.
Step 1
In Cisco Unified Communications Manager Administration, perform these steps:
a.
Add the Cisco Unified IP Phone to the database, and configure it to be controlled from CTI.
b.
Set up the user account, and associate the directory number (primary extension) to the user.
c.
Associate the phone to the end user.
d.
Add the end user to the CTI users group (Standard CTI Enabled).
e.
Add the end user to a user group (Standard CCM End Users).
f.
Add Cisco Unified Personal Communicator as a soft-phone device, and configure a shared line between the soft phone and the desk phone.
g.
Assign capabilities to users.
For detailed Cisco Unified Communications Manager Administration steps, see the Cisco Unified Personal Communicator installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
Step 2
In Cisco Unified Presence Administration, perform these steps:
a.
Verify that the configuration of the CTI gateway server and the CTI gateway profile are correct by choosing Application > Unified Personal Communicator > CTI Gateway Server and Application > Unified Personal Communicator > CTI Gateway Profile.
b.
Restart the Cisco Unified Presence synchronization agent.
From Cisco Unified Presence Administration, select Cisco Unified Serviceability in the navigation window, and click Go. Then choose Tools > Control Center - Network Services, and select the presence server. In the CUPS Services section, select Cisco UPS Sync Agent, and click Restart.
c.
Restart the Cisco CTIManager service.
From Cisco Unified Communications Manager Administration, select Cisco Unified Communications Manager Serviceability in the navigation window, and click Go. Then choose Tools > Control Center - Feature Services, and select the server. In the CM Services section, select Cisco CTIManager, and click Restart.
Note
You can start, stop, or restart only feature services that are activated. Go to the Tools > Service Activation menu to do this.
For detailed Cisco Unified Presence Administration steps, see the Cisco Unified Personal Communicator installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
How to Resolve Directory Problems
•
Directory Search Returns No Results, Incorrect Results, or Unexpected Results
•
Cannot Connect to LDAP Server to Resolve Names
•
User Experiences Slow LDAP Directory Searches
•
Single-Character or Group-Character Searches Provide Users Whose Names Are Blank Or Whose Phone Numbers Are Shown As Unknown
•
Wrong Picture Is Displayed When Dialing a Contact in the Corporate Directory
•
Phone Number Does Not Resolve to a Name
Directory Search Returns No Results, Incorrect Results, or Unexpected Results
Problem
The user reports that a directory search returns no results, incorrect results, or unexpected results. The Cisco Unified Personal Communicator log file contains little or no indication of failure.
Solution
Try these solutions:
•
Instead of using anonymous bind in Cisco Unified Presence Administration (Application > Unified Personal Communicator > LDAP Profile), create a search account just for Cisco Unified Personal Communicator use with read-only privileges over the directory.
•
Verify that the directory server is reachable from the client (ping or use Telnet to port 389 or whatever is configured in Cisco Unified Presence).
•
Check the searchbase. It should be in canonical form (for example, cn=Users,dc=cisco,dc=com).
•
Verify that the bind credentials refer to a user that has permissions to read the search base.
•
Use a third-party LDAP tool to bind as the user specified and search for all objects in the search base. Make sure that user account objects appear.
Cannot Connect to LDAP Server to Resolve Names
Problem
The user cannot connect to the LDAP server to resolve names.
Possible Cause The LDAP server or the network is down.
Solution
If the error is a network error (such as a bad address or a bad port), examine the Cisco Unified Personal Communicator log file for details. Ask the user to access the server health window (Help > Show Server Health on Windows and Help > Show System Diagnostics on Mac) and to provide that information to you. The window provides status information that helps you determine connection and configuration problems.
Possible Cause Anonymous bind failed.
Solution
For anonymous bind failure messages, configure the LDAP server to allow anonymous bind.
User Experiences Slow LDAP Directory Searches
Problem
The user experiences slow LDAP directory searches.
Solution
Try these solutions:
•
Narrow the search to containers where users, not other objects, reside.
•
For Active Directory environments, make sure the configuration points to the AD Global Catalog server port. You configure the port number to 3268 in Cisco Unified Presence Administration (Application > Cisco Unified Personal Communicator > LDAP Server).
•
This problem might be the result of not having the proper fields indexed on the LDAP server. Cisco Unified Personal Communicator requires fields to be indexed for maximum performance. The style of index (initial versus medial versus final versus equal) should be:
–
FirstName: contains/medial
–
LastName: contains/medial
–
Nickname: contains/medial
–
UserID: contains/medial AND exact/equals
–
BusinessEmail: contains/medial AND exact/equals
–
BusinessPhoneNumber: contains/medial AND exact/equals
Only the fields that are actually mapped in Cisco Unified Presence matter; for example if Nickname is not mapped, then there is nothing to index for it.
For details about indexing, see your LDAP server documentation and this URL:
http://msdn2.microsoft.com/en-us/library/ms676931.aspx
Single-Character or Group-Character Searches Provide Users Whose Names Are Blank Or Whose Phone Numbers Are Shown As Unknown
Problem
The user reports that while searching for a single character or a group of characters, the search displays user names that match the search criteria and displays users whose name are blank (does not contain any characters) and whose phone number is shown as Unknown.
Solution
Try these solutions:
•
Check for objects beneath your LDAP directory base that are not users. Isolate your users in one subtree.
•
Modify your search base through Cisco Unified Presence Administration under Application > Unified Personal Communicator > LDAP Profile. Only search under users, not under the whole tree.
Wrong Picture Is Displayed When Dialing a Contact in the Corporate Directory
Problem
The user reports that when dialing a number for a contact in the corporate directory, the wrong picture is displayed.
Solution
Check the dialing rules in Cisco Unified Communications Manager Administration by choosing Call Routing > Dial Rules > Application Dial Rules. Based on the dialed number from Cisco Unified Personal Communicator, the application checks the dialed number against the directory, matches it, and displays the matched name and picture. For detailed conceptual and task-based information on dial rules, see the Cisco Unified Communications Manager Administration online help or the Cisco Unified Communications Manager Administration Guide at this URL:
http://www.cisco.com/en/US/products/sw/voicesw/ps556/tsd_products_support_series_home.html
Phone Number Does Not Resolve to a Name
Problem
The user reports that when double-clicking a contact to call, the conversation window shows the phone number instead of the name.
Solution
Check the dialing rules in Cisco Unified Communications Manager Administration by choosing Call Routing > Dial Rules > Application Dial Rules. Based on the dialed number from Cisco Unified Personal Communicator, the application checks the dialed number against the directory, matches it, and displays the matched name and picture. For detailed conceptual and task-based information on dial rules, see the Cisco Unified Communications Manager Administration online help or the Cisco Unified Communications Manager Administration Guide at this URL:
http://www.cisco.com/en/US/products/sw/voicesw/ps556/tsd_products_support_series_home.html
How to Resolve Instant Messaging Problems
•
Send Instant Message Option is Disabled
•
User Has Unknown State and Cannot Receive Messages
Send Instant Message Option is Disabled
Problem
The user reports that the Send Instant Message option is not selectable (disabled).
Solution
Try these solutions:
•
Verify that the user tried to send an instant message to only one user at a time.
•
Make sure the selected remote user is in the Cisco Unified Presence database. Choose Bulk Administration > Cisco Unified Presence > Cisco Unified Presence User Update, and follow the instructions in the online help.
•
Make sure the instant messaging is enabled for the cluster. In Cisco Unified Presence choose Cisco Unified Presence > Settings, select Enable Instant Messaging, and click Save.
•
Verify that there is no network outage that is impacting connectivity.
•
Verify that the instant message target user is in a known state.
User Has Unknown State and Cannot Receive Messages
Problem
The user reports receiving the message "Remote user has an unknown state and may not be able to receive messages" after sending an instant message to this remote user.
Solution
In some situations, Cisco Unified Personal Communicator might not be able to determine whether the remote user has a valid user ID in the Cisco Unified Presence database. For example, if the user searches the LDAP directory and the search returns a userID field that is not empty, Cisco Unified Personal Communicator allows the user to compose an instant message. After sending the message, the error message is returned.
When the LDAP search returns an empty userID field, Cisco Unified Personal Communicator disables the Send Instant Message button.
Try these solutions:
•
Tell the user to contact the remote user by some other means.
•
If possible, add the remote user to the Cisco Unified Presence database. Make sure this user is a Cisco Unified Personal Communicator or an IP Phone Messenger user and on the same cluster as the local user.
How to Resolve Log In and Network Connection Problems
•
Login to Cisco Unified Personal Communicator Fails After Entering Correct Information
Login to Cisco Unified Personal Communicator Fails After Entering Correct Information
Problem
The user reports receiving an error message during initial Cisco Unified Personal Communicator login but has entered the correct username, password, and the Cisco Unified Presence IP address or hostname.
Solution
Try these solutions:
•
Ask the user to access the server health window (Help > Show Server Health on Windows and Help > Show System Diagnostics on Mac) and to provide that information to you. The window provides status information that helps you determine connection and configuration problems.
Note
For the Mac, server status information is not enabled until the login is successful.
•
Check the Cisco Unified Presence server, and make sure it is up.
•
Verify that the Cisco Unified Communications Manager server is up.
•
Check the Cisco Unified Communications Manager credential policy (User Management > Credential Policy Default). If you checked User Must Change at Next Login, tell users to change their credentials through the Cisco Unified Communications Manager user web pages. Cisco Unified Personal Communicator does not detect expired credentials in Cisco Unified Communications Manager and does not allow the user to change the credentials through Cisco Unified Personal Communicator.
If you checked Does Not Expire, users might need to occasionally reset their credentials through Cisco Unified Communications Manager user web pages.
•
Verify that the Cisco Unified Personal Communicator-specific configuration in Cisco Unified Communications Manager Administration and in Cisco Unified Presence Administration is correct. For details, see the Cisco Unified Personal Communicator installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
•
Verify that the Cisco Unified Personal Communicator installation complies with the server and network requirements as described in the release notes at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_release_notes_list.html
How to Resolve Online Help Problems
•
User Unable to View Online Help
User Unable to View Online Help
Problem
The user is unable to view the online help.
Solution
Try these solutions:
•
Set the browser to allow blocked content. For example, with Internet Explorer 6, an alert directs them to the Information Bar, where they must click and choose Allow Blocked Content.
•
Tell users the location of the user guide PDF:
–
On the Cisco website:
http://www.cisco.com/en/US/products/ps6844/products_user_guide_list.html
–
From the application folder on the local hard disk:
C:\Program Files\Cisco Systems\Cisco Unified Personal Communicator\resources\XXX\help\CUPC-help, where XXXX represents the numbered folder that holds the documentation in your language. For example, the 1033 directory holds English-language documentation.
How to Resolve Reachability Status Problems
•
User in Contact List Shows Offline Status Even When Logged In to Cisco Unified Personal Communicator
•
Reachability Status of Contacts in the Contact List Is Incorrect or Missing
•
Reachability Status Does Not Change from Available to Busy
•
Reachability Information for Contacts in the Contact List Is Not Available for Large Contact Lists
User in Contact List Shows Offline Status Even When Logged In to Cisco Unified Personal Communicator
Problem
The user reports that another user in the contact list shows offline status (grey circle) even though that user is logged in to Cisco Unified Personal Communicator.
Solution
Try these solutions:
•
Verify that Cisco Unified Personal Communicator is enabled for the user in Cisco Unified Communications Manager Administration. Choose System > Licensing > Capabilities Assignment, and check Enable UPC.
•
Verify that the user is on the same Cisco Unified Communications Manager cluster to which the Cisco Unified Presence server is connected.
•
Tell the user to check their Cisco Unified PresenceUser Options page and make sure that the user with the offline status is not in a blocked user list. The user with the offline status might have selected to hide their presence status by device, changed their default presence rules, or created a user-defined policy that could cause this problem.
Possible Cause The Enterprise Presence Server Contact Name is not correctly configured.
Solution
Step 1
In Cisco Unified Presence Administration, choose System > Service Parameters.
Step 2
Select a server and the Cisco UPS Presence Engine service from the drop-down lists.
The Enterprise Presence Server Contact Name specifies the string that is inserted into the Contact header field of the SIP message. The format is:
Cisco Unified Presence IP address:5070;transport=tcp
For example: 172.27.13.111:5070;transport=tcp
Possible Cause The Proxy Domain parameter is incorrectly configured in Cisco Unified Presence
Administration. In a non-DNS environment, the proxy domain must be the IP address of the
Cisco Unified Presence server. In a DNS environment that supports name-to-IP address resolution
(without a DNS SRV), a domain name such as cisco.com is valid, and Cisco Unified
Personal Communicator takes advantage of domain name resolution in this case.
Cisco Unified Personal Communicator derives the name of the Cisco Unified Presence SIP Proxy server from the name in the Proxy Profile, which appears in the Cisco Unified Personal Communicator log as Presence.Primary.Address and the Proxy Domain as Presence.Domain. If the former is in dotted-decimal notation, it is used as is; otherwise, the proxy name and domain are concatenated to form the fully qualified domain name (unless the name is found to already include the domain).
An example of a configuration that does not work is a non-decimal proxy name (for example, gigantic-75) used with a dotted-decimal domain (10.32.134.75). These erroneously combine as gigantic-75.10.32.134.75, which does not resolve.
Solution
Step 1
In Cisco Unified Presence Administration, choose System > Service Parameters.
Step 2
For Server, select the Cisco Unified Presence server.
Step 3
For Service, select Cisco UP SIP Proxy.
Step 4
Scroll down and enter the IP address of the Cisco Unified Presence server into the Proxy Domain field.
Step 5
Click Save.
Possible Cause Method/Event-Based Routing Configuration is not correctly configured.
Solution
Step 1
In Cisco Unified Presence Administration, choose Cisco Unified Presence > Proxy Server > Method/Event Routing).
Step 2
Add four method/event routes listed in Table 1-3:
Table 1-3 Method/Event-Based Routing Configuration
Field
|
1
|
2
|
3
|
4
|
Name
|
DBChange_Route
|
Login_Route
|
PUBLISH_TCP
|
SUBSCRIBE_TCP
|
Description
|
DBChange_Route
|
Login_Route
|
PUBLISH_TCP
|
SUBSCRIBE_TCP
|
Content Token
|
DBChangePkg
|
LoginPkg
|
PUBLISH
|
SUBSCRIBE
|
Content Category
|
Event Type-Based
|
Event Type-Based
|
Method-Based
|
Method-Based
|
Destination Address1
|
Cisco Unified Presence IP address or FQN
|
Cisco Unified Presence IP address or FQN
|
Cisco Unified Presence IP address or FQN
|
Cisco Unified Presence IP address or FQN
|
Destination Port
|
5065
|
5065
|
5070
|
5070
|
Protocol Type
|
UDP
|
UDP
|
TCP
|
TCP
|
Reachability Status of Contacts in the Contact List Is Incorrect or Missing
Problem
The user reports that the reachability status of contacts in the Contacts list is incorrect or missing.
Solution
Try these solutions:
•
If the user is connected through Cisco Systems VPN Client software, make sure it is version 4.0.5 or later. When the VPN client software is launched, from the Options menu, deselect (uncheck) Stateful Firewall. For Mac OS X, verify that the system firewall is not blocking incoming traffic. For details about configuring a computer for network ports used by Cisco Unified Personal Communicator details, see the release notes at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_release_notes_list.html
•
In Cisco Unified Presence Administration, choose System > Troubleshooter. If any errors are displayed for the presence engine or the proxy server, follow the instructions to resolve these issues.
•
If the reachability issue is for users in a Cisco Unified Presence intercluster configuration, make sure that the users in question are not defined as valid users on both clusters.
•
Verify that you selected TCP as the Proxy Listener in Cisco Unified Presence Administration (Application > Unified Personal Communicator > Proxy Profile). Do not use the UDP setting for the Proxy Listener. For installation information, see the installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
After making these changes, test to see if the reachability status information is correct by logging into Cisco Unified Personal Communicator.
If the problem is not resolved or if disabling the firewall is not acceptable, verify that firewalls on the client computer or on the network are configured to pass Cisco Unified Personal Communicator traffic to avoid blocking reachability status information. For details about the network ports used by Cisco Unified Personal Communicator, see the release notes at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_release_notes_list.html
Related Topics
•
How to Resolve Contact List Problems
Reachability Status Does Not Change from Available to Busy
Problem
The user reports that while in a call with another Cisco Unified Personal Communicator user, the reachability status does not change from available to busy for either one of them.
Solution
Try these solutions:
•
Make sure the users have Cisco Unified Personal Communicator set to Available mode on the Windows client or the Automatically Change Status for Activity on the Mac client. Follow the instructions in the user guide at this URL:
http://www.cisco.com/en/US/products/ps6844/products_user_guide_list.html
•
Make sure there is a presence gateway configured:
–
In Cisco Unified Presence Administration, choose Cisco Unified Presence > Presence Engine > Presence Gateways. Make sure that the Cisco Unified Presence gateway is set to the IP address of the correct Cisco Unified Communications Manager server.
–
In Cisco Unified Presence Administration, choose Cisco Unified Presence > Presence Engine > User-Agent Configuration. Make sure there is an entry called Cisco-UCModel01/x.x.x, where x.x.x corresponds to the Cisco Unified Personal Communicator release number. Click this link, and view the User-Agent Configuration information. Verify that the Reachability Version is set to RFC 4479 for Cisco Unified Personal Communicator Release 1.2(1).
–
If the reachability issue is for users in a Cisco Unified Presence intercluster configuration, make sure that the users in question are not defined as valid users on both clusters.
•
Make sure the configuration in Cisco Unified Communications Manager Administration is correct:
–
Choose System > Service Parameter, and select the Cisco Unified Communications Manager server and service. Find the Clusterwide Parameters (System-Presence) section and set Default Inter-Presence Group Subscription to Allow Subscription.
–
Configure a presence SIP trunk. Choose System > Security Profile > SIP Trunk Security Profile. Find the trunk security profile for your system, and make sure Accept Presence Subscription is checked. Also check Accept Out-of-Dialing REFER, Accept Unsolicited Notifications, and Accept Replaces Header.
–
Make sure there is an association between the line configured for the user and the user in Cisco Unified Communications Manager. Choose Device > Phone, and find the directory number. In the Association Information section on the left side of the window, click the link for the line, and on the Directory Number Configuration window, scroll to the bottom of the page and make sure the user is associated with the line. Make sure you associate the line and user for all the phones using that directory number.
–
Make sure the user has a primary extension assigned in Cisco Unified Communications Manager Administration. Choose User Management > End User.
–
Restart the SIP trunk. Choose Device > Trunk. Select the SIP trunk, and click Reset Selected.
•
Check that the user has not selected a Privacy setting (for example, created a blocked list, configured user-defined policies, or modified default reachability status settings) in the Cisco Unified Presence User Options web pages. For details, see the troubleshooting section in the Cisco Unified Personal Communicator user guide at this URL:
http://www.cisco.com/en/US/products/ps6844/products_user_guide_list.html
Reachability Information for Contacts in the Contact List Is Not Available for Large Contact Lists
Problem
The user reports that reachability information for contacts in the contact list is not available for large contact lists or when connected through a moderately lossy network (such as VPN over the Internet).
Solution
You might have configured Cisco Unified Personal Communicator to use UDP signaling with the Cisco Unified Presence SIP proxy server. Instead, you should select TCP as the Proxy Listener in Cisco Unified Presence Administration (Application > Unified Personal Communicator > Proxy Profile). Do not use the UDP setting for the Proxy Listener. For details about creating SIP proxy server profiles, see the installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
How to Resolve Soft-Phone Problems
•
Cisco Unified Personal Communicator Does Not Connect the Phone
•
Cisco Unified Personal Communicator Changes to Desk Phone or to Disabled After Selecting Soft-Phone Mode
Cisco Unified Personal Communicator Does Not Connect the Phone
Problem
The user reports that on the Windows client, the application does not connect to the phone. On the Mac client, the icon within the application continuously spins without connecting the phone. The server health window (Help > Show Server Health on Windows and Help > Show System Diagnostics on the Mac) shows that Cisco Unified Personal Communicator correctly connects to the Logon and Presence servers. For the Phone Configuration (TFTP) server, it shows an unreachable error for UDP.
Solution
Check the firewall configuration on the affected client computer, and make sure that UDP traffic is not blocked. For details about network ports used by the application, see the Cisco Unified Personal Communicator release notes at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_release_notes_list.html
Cisco Unified Personal Communicator Changes to Desk Phone or to Disabled After Selecting Soft-Phone Mode
Problem
The user reports that after logging in to Cisco Unified Personal Communicator and selecting soft-phone mode, the application automatically changes to either Desk Phone or to Disabled after a few seconds.
Possible Cause The soft phone could not register at that time.
Solution
Try these solutions:
•
Ask the user to access the server health window (Help > Show Server Health on Windows and Help > Show System Diagnostics on Mac) and to provide that information to you. The window provides status information that helps you determine connection and configuration problems.
•
Instruct the user to try switching to soft-phone mode to see if the phone registers. If the application returns to No Phone (or to Disabled on Mac) mode, you should check the configuration in Cisco Unified Communications Manager Administration and in Cisco Unified Presence Administration.
•
Verify that the TFTP server configuration in Cisco Unified Presence Administration (Application > Cisco Unified Personal Communicator > Settings) is correct. Verify that the a firewall is not blocking the soft-phone configuration file. For details about network ports used by Cisco Unified Personal Communicator, see the release notes at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_release_notes_list.html
Possible Cause The user is not correctly configured for soft-phone use in Cisco Unified
Communications Manager Administration.
Solution
For details about adding Cisco Unified Personal Communicator as a phone type in Cisco Unified Communications Manager Administration and specifying the soft-phone device name, see the Cisco Unified Personal Communicator installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
How to Resolve Video Problems
•
Supported Video Telephony Camera Does Not Function
•
Full-Screen Overlaid on Second Monitor When Calling a Cisco Unified Video Advantage Endpoint
•
Incoming Video is Black
•
Video Merge Does Not Create a Video Conference
Supported Video Telephony Camera Does Not Function
Problem
The user reports that a supported video telephony camera does not function.
Solution
Disconnect the camera from the client computer and then reconnect it.
The Windows OS should automatically identify and locate the correct driver. If it does not, you can point it to this location (depending on the camera type):
drive:\Program Files\Cisco Systems\Cisco Unified Personal Communicator\CameraDriver
drive:\Program Files\Cisco Systems\Cisco Unified Personal Communicator\CameraDriver2
Full-Screen Overlaid on Second Monitor When Calling a Cisco Unified Video Advantage Endpoint
Problem
When a Cisco Unified Personal Communicator user calls another user who is using Cisco Unified Video Advantage 2.0(2), the remote user sees a full screen video on the second monitor with both local and remote video overlaid on one another. This produces a flickering effect. The remote user is using a Dell computer with an NVIDIA NVS, 120 ms, 512 MB video card with driver version 6.14.10.8469. There is no problem when using other video cards.
Solution
Some dual video cards have an option to automatically select any display, which is not currently playing in a window (hardware overlay), to play video in a full-screen mode. This option is enabled by default, which causes the problem.
Step 1
Right click on desktop, choose Properties > Settings tab> Advanced.
Step 2
Select the Quadro NVS 110M tab.
Step 3
Click on the icon for the external monitor (or on the green button on the left).
Step 4
From the View Display Settings menu, select the full screen video option.
Step 5
For Full Screen Device, select Disable to disable the auto-select setting.
Incoming Video is Black
Problem
The user reports that the call connects, but the incoming video is black and there is no incoming audio.
Solution
Try these solutions:
•
Check the firewall configuration on the client computer or on the network. Verify that the correct network ports for Cisco Unified Personal Communicator operation are open. For details, see the release notes as this URL:
http://www.cisco.com/en/US/products/ps6844/prod_release_notes_list.html
•
Tell the user to click Hold/Resume. If this resolves the problem, suspect that Cisco Unified Communications Manager is experiencing a problem with different types of video endpoints.
Video Merge Does Not Create a Video Conference
Problem
The user reports that a video merge does not create a video conference, and an audio-only conference is established instead.
Solution
Verify that a video conference bridge is available to be allocated and is available in the media resource group in Cisco Unified Communications Manager Administration for the originating Cisco Unified Personal Communicator device. Follow the video conferencing configuration steps in the Cisco Unified Personal Communicator installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
How to Resolve Voice-Mail Problems
•
Voice Mail Does Not Appear in the Recent Pane
•
Voice-Mail Server Is Up, User Credentials Are Correct, But Voice-Mail Messages Are Not Downloaded
•
Send to Voicemail Option Is Not Selectable
Voice Mail Does Not Appear in the Recent Pane
Problem
The user reports that voice mail does not appear in the Recent pane. The Cisco Unified Personal Communicator log file contains this entry:
[4044] WARN LCVoiceMail - %Logon failure: unknown user name or bad password
Possible Cause The voice-mail server or the network is down.
Solution
Try these solutions:
•
Ask the user to access the server health window (Help > Show Server Health on Windows and Help > Show System Diagnostics on Mac) and to provide the information to you. The window provides status information that helps you determine connection and configuration problems.
•
If the server cannot be contacted, the application attempts to reconnect at regular intervals. When the connection succeeds, the server downloads the voice-mail messages. Check the voice-mail server and network, and resolve the problem.
Possible Cause The user supplied incorrect voice-mail server credentials in Cisco Unified
Personal Communicator (File > Preferences > Accounts).
Solution
If the connection to the server fails because the user credentials are incorrect, the application does not attempt to reconnect. The user must log out and then log in with the correct credentials so that the application can try to reconnect.
Possible Cause The password expired, or multiple failed login attempts caused the account to lock.
Solution
Unlock the Cisco Unity (with Microsoft Exchange) account password. In Cisco Unity Administration, choose Subscribers > Subscribers > Account for the subscriber, and uncheck Cisco Unity Account Status.
Solution
Unlock the Cisco Unity Connection account password:
Step 1
From Cisco Unity Connection Administration, navigate to the individual user configuration page.
Step 2
From the navigation pane on the left, choose Users > Users, search for the user, and click the user name.
Step 3
From the menu, choose Edit > Password Settings.
Step 4
On the Edit Passwords Settings (Voicemail) window, for the Choose Password option, choose Web Application.
You should see the message: Password is locked due to too many failed logon attempts.
Step 5
Click Unlock Password.
Tip
You can periodically run a User Lockout report on Cisco Unity Connection to see which accounts are locked. For details about generating user-specific reports, see the Cisco Unity Connection User Moves, Adds, and Changes Guide at this URL:
http://www.cisco.com/en/US/products/ps6509/prod_maintenance_guides_list.html
Possible Cause The password needs to be reset.
Solution
Reset the Cisco Unity Connection account password:
Step 1
From Cisco Unity Connection Administration, navigate to the individual user configuration page. From the navigation pane on the left, choose Users > Users, search for the user, and click the user name.
Step 2
From the menu, choose Edit > Change Password.
Step 3
On the Change Password (Voicemail) window, for the Choose Password option, choose Web Application.
Step 4
Enter a new password in the Password and Confirm Password fields.
Step 5
Communicate this new password to the user, provide the URL (Cisco Unity Connection address or hostname) to the user to log in, and instruct the user to change this default password to their own.
Step 6
Tell the user to enter the personalized password in Cisco Unified Personal Communicator Account > Preferences > Unity window.
Possible Cause Full IMAP (headers and body) access is not enabled on Cisco Unity Connection.
Solution
The application connects to the server by using the Internet Mail Access Protocol (IMAP) to retrieve the voice-mail headers and to download the voice-mail message contents upon user request. In Cisco Unity Connection Administration, select Allow Users to Access Voice Mail Using an IMAP Client.
Possible Cause The IMAP is not properly configured for Cisco Unity with Exchange.
Solution
Verify the IMAP configuration on the Exchange server. For configuration details, see the Cisco Unified Personal Communicator installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
Voice-Mail Server Is Up, User Credentials Are Correct, But Voice-Mail Messages Are Not Downloaded
Problem
The user reports that the server can be contacted and the user credentials are correct, but voice-mail messages are not downloaded.
Solution
Try these solutions:
•
Ask the user to access the server health window (Help > Show Server Health on Windows and Help > Show System Diagnostics on Mac) and to provide that information to you. The window provides status information that helps you determine connection and configuration problems.
If the status for voice mail is OK (green) and existing voicemail are missing, delete the voice-mail cache by deleting all the files in these directories:
–
For Windows XP—C:\Documents and Settings\<USERID>\Local Settings\Application Data\Cisco\Unified Personal Communicator\VoiceMail
–
For Windows Vista—C:\Users\<user>\AppData\Local\Cisco\Unified Personal Communicator\VoiceMail
–
For Mac—HOME/Library/Caches/Cisco/UnifiedPersonalCommunicator/VoiceMail
This causes Cisco Unified Personal Communicator to download all the voice mails again.
•
Check the server configuration to ensure that IMAP is enabled. For details about configuring the voice-mail server, see the Cisco Unified Personal Communicator installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
•
With Cisco Unity Connection, if you configured port 7993, make sure you enabled free licensing. In Cisco Unity Connection Administration, expand Class of Service in the left pane, and then click Class of Service. In the Search Results table, click the display name of the applicable class of service. Check Allows Users to Use Unified Client to Access Voice Mail.
–
On the Cisco Unity Connection server, type netstat -a -b and look for this information:
TCP shibui-unity:7993 shibui-unity:0 LISTENING 3920
[CuIMAPSvr.exe].
This response verifies that Cisco Unified Personal Communicator is listening on port 7993.
–
Check the firewall configuration. On a remote computer, use Telnet to access Cisco Unified Personal Communicator port 7993. For example, if the IP address of the computer running Cisco Unified Personal Communicator is 10.77.27.178, enter telnet 10.77.27.178 7993. You should see a message similar to this:
* OK UMSS IMAP4rev1 Server Completed.
If the connection attempt fails, add port 7993 to your firewall. For details about the network ports used by Cisco Unified Personal Communicator, see the release notes at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_release_notes_list.html
Send to Voicemail Option Is Not Selectable
Problem
The user reports that the Send to Voicemail option is not selectable (grayed out).
Solution
Try these solutions:
•
Verify that the VoiceMail.PilotNumber in the Cisco Unified Personal Communicator log file is valid.
•
Make sure that the voice-mail server profile is configured in Cisco Unified Presence Administration by choosing Application > Unified Personal Communicator > Unity Profile.
–
For the Voice Messaging Pilot drop-down list, select the number that the user dials to access their voice messages.
–
Make sure that the user is a member of this profile by choosing Application > Unified Personal Communicator > User Settings.
•
Verify that the Cisco Unified Communications Manager configuration is correct; verify that a voice-mail pilot number is configured in the Voice Mail > Voice Mail Pilot menu. Follow the online help instructions for this page.
How to Resolve Cisco Unified MeetingPlace Express Web Conferencing Problems
Note
In this section, messages that refer to Cisco Unified MeetingPlace Express also apply to Cisco Unified MeetingPlace Express VT unless stated otherwise.
•
Web Conferencing Button Is Not Selectable in Cisco Unified Personal Communicator
•
Conference Is Initiated on Host But Meeting Room Does Not Launch for Other Participants
•
Slow Performance When Escalating to a Web Conference from Within a Cisco Unified Personal Communicator Conversation
•
Unable to Start or End a Web Conferencing Session
•
Unable to Start or End a Web Conferencing Session; Error Communicating with the Server
•
Unable to Start or End a Web Conferencing Session; Could Not Contact Server
•
System Attempted to Schedule a Web Conference Without a Preferred Language
•
Web Conferencing Server Has Reached Its Licensed Capacity
•
Unable to Log In to the Web Conferencing Server; Internal Error; Login Module Exception
•
User Login ID or Password for Web Conferencing Server Is Invalid or Has Expired
•
User Profile Is Locked or Inactive
•
Web Conference That You Attempted to End No Longer Exists
•
Web Conference That You Attempted to End Has an Invalid Meeting Type
•
System Attempted to Schedule a Web Conference with an Invalid Length
•
System Attempted to Schedule a Web Conference with a Duration That Exceeds the Maximum
•
System Attempted to Schedule a Web Conference for an Invalid Number of Parties
•
System Attempted to End a Web Conference Without Specifying a Meeting ID
•
Password for the Web Conferencing Server Is Missing
•
Web Conferencing Server Cannot Schedule the Meeting; Internal Scheduling Error
•
Web Conferencing Server Is Not Ready to Accept Requests
•
Login ID for Web Conferencing Server Is Missing
Web Conferencing Button Is Not Selectable in Cisco Unified Personal Communicator
Problem
The user reports that the Web Conferencing escalation button is not selectable (grayed out) in Cisco Unified Personal Communicator.
Solution
Try these solutions:
•
Verify that you configured a web conferencing server through the Cisco Unified Presence Administration web application under the Application > Unified Personal Communicator > MeetingPlace Server menu. The server name or IP address fields cannot be blank.
•
Ask the user to access the server health window (Help > Show Server Health on Windows and Help > Show System Diagnostics on Mac) and to provide that information to you. The window provides status information that helps you determine connection and configuration problems.
•
Verify that the user entered a username for this account in Cisco Unified Personal Communicator (File > Preferences > Accounts) as described in the Cisco Unified Personal Communicator user guide. The Username field cannot be blank.
Conference Is Initiated on Host But Meeting Room Does Not Launch for Other Participants
Problem
The user reports that after clicking the Web Conferencing escalation button, the conference is initiated only on the host, but the meeting room does not launch for the other Cisco Unified Personal Communicator clients in the call.
Solution
The two most common causes of this problem are both configuration issues:
•
Your dial plan rules in Cisco Unified Communications Manager Administration are not correct or are not complete. The phone number used to call the other party needs to be able to match with an LDAP directory entry using the dial rules.
•
Your LDAP attribute mappings are incorrect. There must be a mapping between the Cisco Unified Personal Communicator UserID attribute and a similar field in the LDAP attribute map. Check the settings in the LDAP Attribute Mapping table in Cisco Unified Presence Administration (Application > Unified Personal Communicator > Settings).
For details, see the Cisco Unified Personal Communicator installation guide at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_installation_guides_list.html
If these actions do not resolve the problem, gather the Cisco Unified Personal Communicator log file. Obtain a snapshot of the Cisco Unified MeetingPlace Express System Information Capture log, and send it to the Cisco TAC for assistance. For details about this log, see the troubleshooting information in the Cisco Unified MeetingPlace Express administrator configuration and maintenance guide at this URL:
http://www.cisco.com/en/US/products/ps6533/prod_maintenance_guides_list.html
Ask the user to capture the Cisco Unified Personal Communicator logs by using the Problem Reporting Tool (Problem Reporting Assistant on Mac) and to submit them to you.
Slow Performance When Escalating to a Web Conference from Within a Cisco Unified Personal Communicator Conversation
Problem
The user reports slow performance when escalating to a web conference from within a Cisco Unified Personal Communicator conversation.
Solution
Try these solutions:
•
If you are using Cisco Unified MeetingPlace Express Release 1.1.4 or later, reboot the server.
•
If you are using Cisco Unified MeetingPlace Express Release 1.1.1 or 1.1.2, apply the hotfix attached to CSCsd22143. For details about accessing the Bug Toolkit, see the release notes at this URL:
http://www.cisco.com/en/US/products/ps6844/prod_release_notes_list.html
Unable to Start or End a Web Conferencing Session
Problem
The user receives the message "Unable to start a web conferencing session" or the message "Unable to end the web conferencing session."
Solution
Try these solutions:
•
Check the Cisco Unified MeetingPlace Express server, and make sure it is up.
•
Verify that the URL being used by the user (found by clicking the Invite Participants button or by looking in the Cisco Unified Personal Communicator log file) is valid and can be reached from the client computer.
•
Make sure the Cisco Unified MeetingPlace Express server and Cisco Unified Personal Communicator are using the same protocol (for example, HTTP versus HTTPS).
•
Obtain a snapshot of the Cisco Unified MeetingPlace Express System Information Capture log, and send it to the Cisco TAC for assistance. For details about this log, see the troubleshooting information in the Cisco Unified MeetingPlace Express administrator configuration and maintenance guide at this URL:
http://www.cisco.com/en/US/products/ps6533/prod_maintenance_guides_list.html
If these actions do not resolve the problem, obtain a snapshot of the Cisco Unified MeetingPlace Express System Information Capture log, and send it to the Cisco TAC for assistance. For details about this log, see the troubleshooting information in the Cisco Unified MeetingPlace Express administrator configuration and maintenance guide at this URL:
http://www.cisco.com/en/US/products/ps6533/prod_maintenance_guides_list.html
Ask the user to capture the Cisco Unified Personal Communicator logs by using the Problem Reporting Tool (Problem Reporting Assistant on Mac) and to submit them to you.
Unable to Start or End a Web Conferencing Session; Error Communicating with the Server
Problem
The user receives the message "Unable to start a web conferencing session. Error communicating with the web conferencing server" or the message "Unable to end the web conferencing session. Error communicating with the web conferencing server."
Solution
Try these solutions:
•
Check the Cisco Unified MeetingPlace Express server, and make sure it is up.
•
Verify that the URL being used by the user (found by clicking the Invite Participants button or by looking in the Cisco Unified Personal Communicator log file) is valid and can be reached from the client computer.
•
Make sure the Cisco Unified MeetingPlace Express server and Cisco Unified Personal Communicator are using the same protocol (for example, HTTP versus HTTPS).
If these actions do not resolve the problem, obtain a snapshot of the Cisco Unified MeetingPlace Express System Information Capture log, and send it to the Cisco TAC for assistance. For details about this log, see the troubleshooting information in the Cisco Unified MeetingPlace Express administrator configuration and maintenance guide at this URL:
http://www.cisco.com/en/US/products/ps6533/prod_maintenance_guides_list.html
Ask the user to capture the Cisco Unified Personal Communicator logs by using the Problem Reporting Tool (Problem Reporting Assistant on Mac) and to submit them to you.
Unable to Start or End a Web Conferencing Session; Could Not Contact Server
Problem
The user receives the message "Unable to start a web conferencing session. Could not contact the web conferencing server" or the message "Unable to end the web conferencing session. Could not contact the web conferencing server."
Solution
Try these solutions:
•
Check the Cisco Unified MeetingPlace Express server, and make sure it is up.
•
Verify that the URL (found by clicking the Invite Participants button or by looking in the Cisco Unified Personal Communicator log file) being used by the user is valid and can be reached from the client computer.
•
Make sure the Cisco Unified MeetingPlace Express server and Cisco Unified Personal Communicator are using the same protocol (for example, HTTP versus HTTPS).
If these actions do not resolve the problem, obtain a snapshot of the Cisco Unified MeetingPlace Express System Information Capture log, and send it to the Cisco TAC for assistance. For details about this log, see the troubleshooting information in the Cisco Unified MeetingPlace Express administrator configuration and maintenance guide at this URL:
http://www.cisco.com/en/US/products/ps6533/prod_maintenance_guides_list.html
Ask the user to capture the Cisco Unified Personal Communicator logs by using the Problem Reporting Tool (Problem Reporting Assistant on Mac) and to submit them to you.
System Attempted to Schedule a Web Conference Without a Preferred Language
Problem
The user receives the message "The system attempted to schedule a web conference without a preferred language. Please contact your administrator for assistance."
Solution
Try these solutions:
•
Check the Cisco Unified Personal Communicator log file to see what value was used for the language as shown in this example:
INFO LCMiddleware - ((CUPC5402 - MWMSG_WEBCONF_SCHEDULINGCONF)) Scheduling a web conf
[[HOST:http://<server URL>]], [[USER:<userid>]], duration=60, ports=3, lang=en
•
Check Cisco Unified MeetingPlace Express, and make sure the language licenses were purchased, downloaded, installed, and enabled.
•
Configure language preferences in the user groups or the user profiles. Follow the instructions in the basic operations section of the Cisco Unified MeetingPlace Express administrator configuration and maintenance guide at this URL:
http://www.cisco.com/en/US/products/ps6533/prod_maintenance_guides_list.html
Web Conferencing Server Has Reached Its Licensed Capacity
Problem
The user receives the message "The web conferencing server has reached its licensed capacity for the current time. Please try your meeting again later."
Solution
Buy more licenses, or change the Cisco Unified MeetingPlace Express web floater ports or web overbook ports settings or both. For details, see the administrator configuration and maintenance guide for Cisco Unified MeetingPlace Express at this URL:
http://www.cisco.com/en/US/products/ps6533/prod_maintenance_guides_list.html
Unable to Log In to the Web Conferencing Server; Internal Error; Login Module Exception
Problem
The user receives the message "Unable to log into the web conferencing server. Internal error, login module exception. Contact your administrator or try again later."
Solution
Try these solutions:
•
Verify the Cisco Unified MeetingPlace Express user login credentials by having the user log in to the server directly.
•
Check the Cisco Unified MeetingPlace Express server for errors. For details, see the troubleshooting information in the Cisco Unified MeetingPlace Express administrator configuration and maintenance guide at this URL:
http://www.cisco.com/en/US/products/ps6533/prod_maintenance_guides_list.html
•
Obtain a snapshot of the Cisco Unified MeetingPlace Express System Information Capture log, and send it to the Cisco TAC for assistance.
User Login ID or Password for Web Conferencing Server Is Invalid or Has Expired
Problem
The user receives the message "In order to perform this action, please do one or more of the following, as needed. Make sure the Cisco Unified MeetingPlace Express username and password entered in the Account Preferences in Cisco Unified Personal Communicator are correct and not expired. Try to log into Cisco Unified MeetingPlace Express directly. If you cannot, please contact your administrator."
Solution
Try these solutions:
•
To check for an invalid password, have the user check their web conferencing credentials in Cisco Unified Personal Communicator (File > Preferences > Accounts) as described in the Cisco Unified Personal Communicator user guide. Verify the web conferencing user login credentials by having the user log in to the server directly.
•
To solve an expired password or locked account, log in to Cisco Unified MeetingPlace Express, and unlock the account. Then, reset the password to the default for your company. For details about unlocking a user profile and modifying user profiles (resetting the password), see the Cisco Unified MeetingPlace Express configuration and maintenance guide at this URL:
http://www.cisco.com/en/US/products/ps6533/products_installation_and_configuration_guides_list.html
•
Provide the company default Cisco Unified MeetingPlace Express password to the user, ask them to log in to Cisco Unified MeetingPlace Express, access their profile, and personalize their password by following the instructions in the Cisco Unified MeetingPlace Express user guide at this URL:
http://www.cisco.com/en/US/products/ps6533/products_user_guide_list.html
The user must then enter this personalized password as their web conferencing credentials in Cisco Unified Personal Communicator (File > Preferences > Accounts).
User Password Has Expired on Cisco Unified MeetingPlace Express
Problem
The user receives a message that their password has expired on the Cisco Unified MeetingPlace Express server and to log in to Cisco Unified MeetingPlace directly and change their password.
Solution
Provide the user with user guide for Cisco Unified MeetingPlace Express web conferencing server at this URL:
http://www.cisco.com/en/US/products/ps6533/products_user_guide_list.html
It describes how to change passwords.
User Profile Is Locked or Inactive
Problem
The user receives a message that their user profile on Cisco Unified MeetingPlace Express is locked or inactive and that starting a meeting is not possible until this problem is corrected.
Solution
Try these solutions:
•
To solve an expired password or locked account, log in to Cisco Unified MeetingPlace Express, and unlock the account. Then, reset the password to the default for your company. For details about unlocking a user profile and modifying user profiles (resetting the password), see the Cisco Unified MeetingPlace Express configuration and maintenance guide at this URL:
http://www.cisco.com/en/US/products/ps6533/products_installation_and_configuration_guides_list.html
•
Provide the company default Cisco Unified MeetingPlace Express password to the user, ask them to log in to Cisco Unified MeetingPlace Express, access their profile, and personalize their password by following the instructions in the Cisco Unified MeetingPlace Express user guide at this URL:
http://www.cisco.com/en/US/products/ps6533/products_user_guide_list.html
The user must then enter this personalized password as their web conferencing credentials in Cisco Unified Personal Communicator (File > Preferences > Accounts).
Web Conference That You Attempted to End No Longer Exists
Problem
The user receives the message "The web conference you attempted to end no longer exists."
Solution
No action is required. This problem in unlikely to occur, but if it does, it causes no harm.
Web Conference That You Attempted to End Has an Invalid Meeting Type
Problem
The user receives the message "The web conference you attempted to end has an invalid meeting type. Please contact your administrator for assistance."
Solution
This problem is most likely a Cisco Unified Personal Communicator software defect. Ask the user to capture the Cisco Unified Personal Communicator logs by using the Problem Reporting Tool (Problem Reporting Assistant on Mac) and to submit them to you.
Obtain a snapshot of the Cisco Unified MeetingPlace Express System Information Capture log, and send it to the Cisco TAC for assistance. For details about this log, see the troubleshooting information in the Cisco Unified MeetingPlace Express administrator configuration and maintenance guide at this URL:
http://www.cisco.com/en/US/products/ps6533/prod_maintenance_guides_list.html
System Attempted to Schedule a Web Conference with an Invalid Length
Problem
The user receives the message "The system attempted to schedule a web conference with an invalid length. Please contact your administrator for assistance."
Solution
Try these solutions:
•
Check the Cisco Unified Personal Communicator log file to see what value was used for the length (duration) as shown in this example:
INFO LCMiddleware - ((CUPC5402 - MWMSG_WEBCONF_SCHEDULINGCONF)) Scheduling a web conf
[[HOST:http://<server URL>]], [[USER:<userid>]], duration=60, ports=3, lang=en
•
Check the Cisco Unified MeetingPlace Express "Maximum meeting length" setting on the Meeting Configuration page. Meetings can be scheduled for no longer than this number of minutes.
•
Change the conference server setting to be at least as large as the value in the log.
System Attempted to Schedule a Web Conference with a Duration That Exceeds the Maximum
Problem
The user receives the message "The system attempted to schedule a web conference with a duration that exceeds the configured maximum on the web conferencing server. Please contact your administrator for assistance."
Solution
Try these solutions:
•
Check the Cisco Unified Personal Communicator log file to see what value was used for the length.
•
Check the Cisco Unified MeetingPlace Express "Maximum meeting length" value on the Meeting Configuration page. Users cannot schedule meetings longer than this number of minutes. Consider whether the meeting length accurately reflects the typical meeting duration conducted by your company. Most likely, the configured meeting length is too small.
System Attempted to Schedule a Web Conference for an Invalid Number of Parties
Problem
The user receives the message "The system attempted to schedule a web conference for an invalid number of parties. Please contact your administrator for assistance."
Solution
Try these solutions:
•
Check the Cisco Unified Personal Communicator log file to see what value was used for parties (ports) as shown in this sample log file:
INFO LCMiddleware - ((CUPC5402 - MWMSG_WEBCONF_SCHEDULINGCONF)) Scheduling a web conf
[[HOST:http://<server URL>]], [[USER:<userid>]], duration=60, ports=3, lang=en
•
On Cisco Unified MeetingPlace Express, check the "Maximum ports per meeting" setting on the Meeting Configuration page. Compare the conference server setting to the value in the log. If the value in the log is not the number of parties + 1, contact the Cisco TAC.
System Attempted to End a Web Conference Without Specifying a Meeting ID
Problem
The user receives the message "The system attempted to end a web conference without specifying a meeting ID. Please report this problem to your administrator."
Solution
This problem is most likely a Cisco Unified Personal Communicator software defect. Contact the Cisco TAC for assistance.
Password for the Web Conferencing Server Is Missing
Problem
The user receives the message "Your password for the web conferencing server is missing. Please verify your Cisco Unified MeetingPlace credentials as configured in Account Preferences."
Solution
Have the user check their web conferencing credentials in Cisco Unified Personal Communicator (File > Preferences > Accounts) as described in the Cisco Unified Personal Communicator user guide at this URL:
http://www.cisco.com/en/US/products/ps6844/products_user_guide_list.html
Web Conferencing Server Cannot Schedule the Meeting; Internal Scheduling Error
Problem
The user receives the message "The web conferencing server could not schedule the meeting. Internal scheduling error. Please contact your administrator for assistance."
Solution
Test to see if this user can schedule the meeting through the Cisco Unified MeetingPlace Express web user interface. If yes, the problem is most likely the result of a Cisco Unified MeetingPlace Express software bug. Obtain a snapshot of the Cisco Unified MeetingPlace Express System Information Capture log, and send it to the Cisco TAC for assistance. For details about this log, see the troubleshooting information in the Cisco Unified MeetingPlace Express administrator configuration and maintenance guide at this URL:
http://www.cisco.com/en/US/products/ps6533/prod_maintenance_guides_list.html
Web Conferencing Server Is Not Ready to Accept Requests
Problem
The user receives the message "The web conferencing server is not currently ready to accept requests. Please try your request again later, or contact your administrator."
Solution
Try these solutions:
•
Check the Cisco Unified MeetingPlace Express server, and make sure it is up.
•
Verify that the URL being used by the user (found in the Cisco Unified Personal Communicator log file) is valid and can be reached from the client computer.
•
Make sure the Cisco Unified MeetingPlace Express server and Cisco Unified Personal Communicator are using the same protocol (for example, HTTP versus HTTPS).
If these actions do not resolve the problem, obtain a snapshot of the Cisco Unified MeetingPlace Express System Information Capture log, and send it to the Cisco TAC for assistance. For details about this log, see the troubleshooting information in the Cisco Unified MeetingPlace Express administrator configuration and maintenance guide at this URL:
http://www.cisco.com/en/US/products/ps6533/prod_maintenance_guides_list.html
Ask the user to capture the Cisco Unified Personal Communicator logs by using the Problem Reporting Tool (Problem Reporting Assistant on Mac) and to submit them to you.
Login ID for Web Conferencing Server Is Missing
Problem
The user receives the message "Your login ID for the web conferencing server is missing. Please verify your Cisco Unified MeetingPlace credentials as configured in Account Preferences."
Solution
Have the user check the web conferencing credentials in Cisco Unified Personal Communicator (File > Preferences > Accounts) as described in the Cisco Unified Personal Communicator user guide at this URL:
http://www.cisco.com/en/US/products/ps6844/products_user_guide_list.html
How to Resolve Cisco Unified MeetingPlace Web Conferencing Problems
•
Web Conferencing Button Is Not Selectable in Cisco Unified Personal Communicator
•
Conference Is Initiated on Host But Meeting Room Does Not Launch for Other Participants
•
User Profile Is Locked or Inactive
•
User Password Has Expired on Cisco Unified MeetingPlace
•
User Can Access Cisco Unified MeetingPlace from a Browser But Cisco Unified Personal Communicator Reports the Credentials Are Wrong
•
Password for the Web Conferencing Server Is Missing
•
User Does Not Have Permission to Start or End a Meeting
•
Web Conferencing Session Will Not Start or End
•
Unable to Start or End Web Conferencing Session; Web Server Is Not Connected
•
Meeting No Longer Exists on the Cisco Unified MeetingPlace Server
•
Cisco Unified MeetingPlace Host Name Is Not Resolving
•
Proxy Server Host Name Is Not Resolving
•
Web Server Does Not Respond Within Timeout Interval
•
Web Server Returns an Empty Response
•
Security Certificate Is Not Verifiable
•
Security Certificate Is Invalid
•
Security Certificate Is Invalid or Not Readable
•
Security Certificate Does Not Match Target Host Name
Web Conferencing Button Is Not Selectable in Cisco Unified Personal Communicator
Problem
The user reports that the Web Conferencing escalation button is not selectable (grayed out) in Cisco Unified Personal Communicator.
Solution
To resolve this issue, see the "Web Conferencing Button Is Not Selectable in Cisco Unified Personal Communicator" section. The solution applies to web conferencing through Cisco Unified MeetingPlace Express and through Cisco Unified MeetingPlace.
Conference Is Initiated on Host But Meeting Room Does Not Launch for Other Participants
Problem
The user reports that after clicking the Web Conferencing escalation button, the conference is initiated only on the host, but the meeting room does not launch for the other Cisco Unified Personal Communicator clients in the call.
Solution
To resolve this issue, see the "Conference Is Initiated on Host But Meeting Room Does Not Launch for Other Participants" section. The solution applies to web conferencing through Cisco Unified MeetingPlace Express and through Cisco Unified MeetingPlace.
User Profile Is Locked or Inactive
Problem
The user receives the message "Your user profile on Cisco Unified MeetingPlace is locked or inactive. You will not be able to start a meeting until this is corrected. Please contact your administrator for assistance."
Solution
Try these solutions:
•
If the user knows their password, unlock the profile in MeetingTime. From the System tab, select View Locked Profiles. Click Execute. On the Locked Profiles window, select the profile, and click Set to Group.
If the user does not know their password, change the user password in MeetingTime, and unlock the profile. From the Configure tab, select User Profile. Locate the user profile by searching for the user ID. For the User password field, enter a new password. Change Profile active? to Group Dflt (Yes).
•
Change the user password in MeetingTime. From the Configure tab, select User Profile. Locate the user profile by searching for the user ID. For the User password field, enter a new password.
User Password Has Expired on Cisco Unified MeetingPlace
Problem
The user receives the message "Your password has expired on the Cisco Unified MeetingPlace server. Please log into Cisco Unified MeetingPlace directly and change your password, or contact your administrator for assistance."
Solution
Provide the user with user guide for Cisco Unified MeetingPlace web conferencing server at this URL:
http://www.cisco.com/en/US/products/sw/ps5664/ps5669/products_user_guide_list.html
It describes how to change passwords.
User Can Access Cisco Unified MeetingPlace from a Browser But Cisco Unified Personal Communicator Reports the Credentials Are Wrong
Problem
The user reports being able to access Cisco Unified MeetingPlace from a browser, but Cisco Unified Personal Communicator provides a message that the user credentials are wrong.
Solution
Ask the user to verify their Cisco Unified MeetingPlace credentials from a browser. If automatically logged in to Cisco Unified MeetingPlace, ask the user to click the sign-out link in the browser and then try to log in again. If the log-in attempt fails, the credentials in Cisco Unified Personal Communicator are incorrect. If the user does not know their password, change it in MeetingTime. From the Configure tab, select User Profile. Locate the user profile by searching for the user ID. For the User password field, enter a new password.
Password for the Web Conferencing Server Is Missing
Problem
The user receives the message "Your password for the web conferencing server is missing. Please verify your Cisco Unified MeetingPlace credentials as configured in Account Preferences."
Solution
Have the user check their web conferencing credentials in Cisco Unified Personal Communicator (File > Preferences > Accounts) as described in the Cisco Unified Personal Communicator user guide at this URL:
http://www.cisco.com/en/US/products/ps6844/products_user_guide_list.html
User Does Not Have Permission to Start or End a Meeting
Problem
The user receives one of these message:
•
"You do not have permission to start a meeting on the Cisco Unified MeetingPlace server. Please contact your system administrator for assistance."
•
"You do not have permission to end one of these meetings on the Cisco Unified MeetingPlace server."
Solution
Cisco Unified MeetingPlace allows you to create user profiles without providing the ability to schedule (start or end) meetings. Log in to MeetingTime, and make sure the Scheduling Restriction field is not set to Cannot Schedule for this user profile. For other solutions, see the troubleshooting section in Cisco Unified MeetingPlace audio server administration guide at this URL:
http://www.cisco.com/en/US/products/sw/ps5664/ps5669/prod_troubleshooting_guides_list.html
Web Conferencing Session Will Not Start or End
Problem
The user receives the message "Unable to start a web conferencing session" or the message "Unable to end the web conferencing session."
Solution
Try these solutions:
•
Check the Cisco Unified MeetingPlace server, and make sure it is up.
•
If the problem persists, ask the user to capture the Cisco Unified Personal Communicator logs by using the Problem Reporting Tool (Problem Reporting Assistant on Mac) and to submit them to you. Send them to the Cisco TAC for assistance.
Unable to Start or End Web Conferencing Session; Web Server Is Not Connected
Problem
The user receives one of these messages:
•
"Unable to start a web conferencing session. The Cisco Unified MeetingPlace web server is not connected to MeetingPlace. Please wait a few minutes and try again. If the problem persists, please contact your administrator for assistance."
•
"Unable to end a web conferencing session. The Cisco Unified MeetingPlace web server is not connected to MeetingPlace. Please wait a few minutes and try again. If the problem persists, please contact your administrator for assistance."
Solution
This problem could occur if the Cisco Unified MeetingPlace web server is up, but it is not connected to the Cisco Unified MeetingPlace audio server. Resolve any network problems between the two servers. Make sure the audio server is up and is not rebooting.
Meeting No Longer Exists on the Cisco Unified MeetingPlace Server
Problem
The user receives the message "This meeting no longer exists on the Cisco Unified MeetingPlace server."
Solution
No action is required. This problem in unlikely to occur, but if it does, it causes no harm.
Cisco Unified MeetingPlace Host Name Is Not Resolving
Problem
The user receives the message "There was a problem resolving the host name of the Cisco Unified MeetingPlace server. Please contact your administrator for assistance."
Solution
This problem is most likely the result of DNS problems on the client (for example, the client is pointing to the wrong DNS server or there is no DNS entry for the server) where the name of the web server that you configured in Cisco Unified Presence Administration cannot be resolved through a DNS lookup on the client.
Try these solutions:
•
Verify the Cisco Unified MeetingPlace server address, port, and protocol in Cisco Unified Personal Communicator. Choose Help > System Diagnostics, and click Web Conferencing. Ping the server address from the client computer (or put it in a browser) to check the connectivity.
•
Make sure the Cisco Unified MeetingPlace server and Cisco Unified Personal Communicator are using the same protocol (for example, HTTP versus HTTPS).
•
Check the Cisco Unified MeetingPlace server, and make sure it is up.
The web server must be able to connect to itself by using the hostname you configured on the Web Server administrative page. This is also the hostname used by end users to connect to this web server. Connection problems are most likely caused by firewall-related configurations. For details about HTTP connection problems, see the Cisco Unified MeetingPlace web conferencing installation and upgrade guide at this URL:
http://www.cisco.com/en/US/products/sw/ps5664/ps5669/prod_installation_guides_list.html
If these actions do not resolve the problem, obtain a snapshot of the Cisco Unified MeetingPlace log files, and send them to the Cisco TAC for assistance. For details about capturing logs, see the Cisco Unified MeetingPlace documentation at this URL:
http://www.cisco.com/en/US/products/sw/ps5664/ps5669/tsd_products_support_series_home.html
Ask the user to capture the Cisco Unified Personal Communicator logs by using the Problem Reporting Tool (Problem Reporting Assistant on Mac) and to submit them to you.
Proxy Server Host Name Is Not Resolving
Problem
The user receives the message "There was a problem resolving the name of your proxy server while attempting to contact the Cisco Unified MeetingPlace server. Please contact your administrator for assistance."
Solution
Cisco Unified Personal Communicator Release 1.2(1) does not support proxy servers between Cisco Unified Personal Communicator and the web conferencing server.
Web Server Does Not Respond Within Timeout Interval
Problem
The user receives the message "The Cisco Unified MeetingPlace server did not respond within the timeout interval. If the problem persists, please contact your administrator for assistance."
Solution
The problem is likely caused by a network latency problem or by a web server that is extremely busy. Ask the user to try again in a few minutes. If the problem persists, review your network infrastructure to reduce latency and improve traffic patterns.
Web Server Returns an Empty Response
Problem
The user receives the message "The Cisco Unified MeetingPlace server returned an empty response. If the problem persists, please contact your administrator for assistance."
Solution
Try these solutions:
•
Check the Cisco Unified MeetingPlace server, and make sure it is up.
•
Verify that the URL being used by the user is valid and can be reached from the client computer. The URL can be found in Cisco Unified Personal Communicator Help > System Diagnostics, and click Web Conferencing. The display shows server address, ports, and protocols.
•
Make sure the Cisco Unified MeetingPlace server and Cisco Unified Personal Communicator are using the same protocol (for example, HTTP versus HTTPS).
If these actions do not resolve the problem, obtain a snapshot of the Cisco Unified MeetingPlace log files, and send them to the Cisco TAC for assistance. Ask the user to capture the Cisco Unified Personal Communicator logs by using the Problem Reporting Tool (Problem Reporting Assistant on Mac) and to submit them to you.
Security Certificate Is Not Verifiable
Problem
The user receives one of these messages:
•
"There was a problem verifying the authenticity of the SSL security certificate from the Cisco Unified MeetingPlace server. Please contact your administrator for assistance. Would you like to ignore this warning and try to start the web conference anyway?"
•
There was a problem verifying the authenticity of the SSL security certificate from the Cisco Unified MeetingPlace server. Please contact your administrator for assistance. Would you like to ignore this warning and try to end the web conference anyway?"
Solution
This problem occurs only if you configured the web server for HTTPS, and you are using a self-signed SSL certificate on the web server.
Ask the user to access the web server with their browser. When prompted about the certificate, the user should choose the option to import it. The user should also restart Cisco Unified Personal Communicator.
For details, see the Cisco Unified MeetingPlace web conferencing server configuration guide at this URL:
http://www.cisco.com/en/US/products/sw/ps5664/ps5669/products_installation_and_configuration_guides_list.html
Security Certificate Is Invalid
Problem
The user receives one of these message:
•
"The SSL security certificate from the Cisco Unified MeetingPlace server is invalid. Please contact your administrator for assistance. Would you like to ignore this warning and try to start the web conference anyway?"
•
"The SSL security certificate from the Cisco Unified MeetingPlace server is invalid. Please contact your administrator for assistance. Would you like to ignore this warning and try to end the web conference anyway?"
Solution
This problem can occur if there is a problem verifying the SSL certificate or if the certificate has expired. Try these solutions:
•
Verify the certificate installation and configuration on the Cisco Unified MeetingPlace web conferencing server. For details, see the Cisco Unified MeetingPlace web conferencing server configuration guide at this URL:
http://www.cisco.com/en/US/products/sw/ps5664/ps5669/products_installation_and_configuration_guides_list.html
•
Obtain a snapshot of the Cisco Unified MeetingPlace log files, and send them to the Cisco TAC for assistance. For details about capturing logs, see the Cisco Unified MeetingPlace documentation at this URL:
http://www.cisco.com/en/US/products/sw/ps5664/ps5669/tsd_products_support_series_home.html
•
Ask the user to capture the Cisco Unified Personal Communicator logs by using the Problem Reporting Tool (Problem Reporting Assistant on Mac) and to submit them to you. Provide this report to Cisco TAC.
Security Certificate Is Invalid or Not Readable
Problem
The user receives the message "There was a problem verifying the authenticity of the SSL security certificate from the Cisco Unified MeetingPlace server. The CA certificate file is invalid or could not be read. Please contact your administrator for assistance."
Solution
This problem is likely due to a security problem on the client. Try these solutions:
•
Obtain a snapshot of the Cisco Unified MeetingPlace log files, and send them to the Cisco TAC for assistance. For details about capturing logs, see the Cisco Unified MeetingPlace documentation at this URL:
http://www.cisco.com/en/US/products/sw/ps5664/ps5669/tsd_products_support_series_home.html
•
Ask the user to capture the Cisco Unified Personal Communicator logs by using the Problem Reporting Tool (Problem Reporting Assistant on Mac) and to submit them to you. Provide this report to Cisco TAC.
Security Certificate Does Not Match Target Host Name
Problem
The user receives one of these messages:
•
"The name on the Cisco Unified MeetingPlace web server SSL security certificate does not match the target host name. Please contact your administrator to correct the problem. Would you like to ignore this warning and try to start the web conference anyway?"
•
"The name on the Cisco Unified MeetingPlace web server SSL security certificate does not match the target host name. Please contact your administrator to correct the problem. Would you like to ignore this warning and try to end the web conference anyway?"
•
"The name on the Cisco Unified MeetingPlace web server SSL security certificate does not match the target host name. Please contact your administrator to correct the problem."
Solution
The name in the SSL certificate that is installed on the Cisco Unified MeetingPlace web server does not exactly match the name of the server that is configured in Cisco Unified Presence Administration.
Try these solutions:
•
View the name on the SSL certificate. Access the web server from a browser, and when prompted, click the button to view the certificate. Compare the name in the certificate with the name configured in Cisco Unified Presence Administration and in Cisco Unified MeetingPlace.
•
Change the server name in Cisco Unified Presence Administration to match the one in the certificate. Choose Application > Unified Personal Communicator > MeetingPlace Server.
–
Make sure that the web server name in Cisco Unified Presence Administration is a fully qualified domain name.
–
Verify that you did not configure the server name as an IP address.
•
Sign in to Cisco Unified MeetingPlace Web Conferencing with your System Manager-level user ID and password, and choose Admin > Web Server. Verify that you configured the web conferencing server host name with a fully qualified domain name (hostname.domain.com). This host name must match the value in the SSL certificate.