The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This document serves as a collection of various troubleshooting notes for Cisco Unified Contact Center Express (UCCX), Cisco Agent Desktop (CAD), and Cisco Supervisor Desktop (CSD) issues. This document assumes that the user has basic knowledge of UCCX and CAD/CSD and can navigate and collect traces.
Cisco recommends that you have knowledge of these topics:
The information in this document is based on UCCX Version 8.x and later, CUCM Vesrion 8.x and later, and CUPS Version 8.x and later.
This section covers several issues you might encounter and how you can resolve them.
Note: Set tracing on the server and agent side, recreate the issue, and then collect the logs.
In order to set traces, navigate to Cisco Unified CCX Serviceability > Trace > Configuration > Cisco Unified CCX Desktop Services and set the Cisco Desktop Agent Email Service to Debugging 4.
In order to collect logs, open the Real-Time Monitoring Tool (RTMT) > Trace & Log Central > Collect logs > Select all Cisco Desktop services and EEM Server service.
In order to set traces, navigate to C:\Program Files(x86)\Cisco\Desktop\ and open the Agent.cfg file. Under the [Debug Log] category, set the threshold to trace and save the file. The file should now read similar to this:
[Debug Log]
Size=10MB
Files=10
# Threshold may be one of the following OFF, DEBUG, CALL, TRACE, DUMP
# Each level provides successively more debug info, DEBUG should be sufficient for
# most debugging needs, set to OFF when debugging is not required.
Threshold=TRACE
Also open the EemUi.cfg file and remove the pound sign (#) from the line that references TRACE (should be first line) and add a pound sign to the line that references DEBUG (should be third line). It should look like this:
log4j.rootLogger=TRACE,LOG,DBG,CONSOLE
#log4j.rootLogger=CALL#com.calabrio.util.log.SplkLevel,LOG,DBG,CONSOLE
#log4j.rootLogger=DEBUG,LOG,DBG,CONSOLE
#log4j.rootLogger=INFO,LOG,DBG,CONSOLE
#log4j.rootLogger=DUMP#com.calabrio.util.log.SplkLevel,LOG,DBG,
A Microsoft Exchange administrator should be engaged to obtain the Microsoft Exchange mailbox audit logs.
Note: Cisco is not responsible for troubleshooting the Microsoft Exchange server. If there are any questions, you could request that a Microsoft Exchange administrator obtain and analyze the mailbox audit logs before you continue with the troubleshoot.
You should also gather this information before you contact TAC for assistance.
While you troubleshoot CAD, you must often quickly find the ports and services from CAD/CSD that are connected to UCCX.
Use the show network status search <ip address of CAD machine> command.
Example:
admin:show network status search 10.201.227.238
tcp 0 0 pavdave-uccx105.pavdav:hbci 10.201.227.238:51450
ESTABLISHED
tcp 0 0 pavdave-uccx105.pavdav:3001 10.201.227.238:51461
ESTABLISHED
tcp 0 0 pavdave-uccx105.pavda:52135 10.201.227.238:51460
ESTABLISHED
tcp 0 0 pavdave-uccx105:notify_srvr 10.201.227.238:51449
ESTABLISHED
tcp 0 0 pavdave-uccx105.pavda:12028 ::ffff:10.201.227.238:51453
ESTABLISHED
This output can be used in order to show the connected/established local port and the remote port on the CAD/CSD machine. Most CAD services use TCP connections, and these can be matched with the functional service ports on the port utilization guide.
After an upgrade of UCCX, CAD users receive this error message every time they log in.
Unable to download file. Could not open request.
However, after they click the ok button, they can log in successfully.
Whenever the CAD application is launched, it checks for the availability of a newer version. CAD makes use of True Update, which is located at C:\Program Files\Cisco\Desktop\bin\update.exe.
In order to avoid this error, perform these steps before the upgrade:
This error occurs when UCCX is integrated with Cisco Unified Presence Server (CUPS).
Runtime error!
Program:C:\program files\cisco\desktop\bin\agent.exe
This application has requested the runtime to terminate it in an unusual way
please contact the application support team for more information.
This error can be seen on UCCX CDA upon integration with CUPS. If you log into CUPS when launch fails, you observe this error:
CDAUI2034 Invalid Cisco Unified Presence Cluster user
credentials. Configured user must be able to run SOAP
queries. Users cannot login to CUPS while launching CAD.
Verify that the user is an end user on CUPS. After this is done, check the CAD Client Type configuration in CUPS.
Note: The CAD Client Type setting must be configured if your system uses CUPS Version 8.6 or later. In order for CAD agents to be able to log in, the CAD client type must be added to the Unified Presence Administration.
Type: CAD
Description: CAD
Minimum Version: 0.0.0.0
Group: Standard CCM End Users
When you launch CAD, the compatibility is checked with the Microsoft Windows operating system. If there are any issues, CAD fails to launch and you receive one of these errors:
C:Program Files\Cisco\Desktop\bin\agent.exe
A referral was returned from the server
or
C:Program Files(x86)\Cisco\Desktop\bin\agent.exe
A referral was returned from the server
When agents log into CAD, the login fails with this error:
You cannot log in because your phone is IPv6 enabled.
This can happen when Extension Mobility (EM) is enabled or disabled and can happen because CAD does not support IPv6 or there is IPv6 enabled.
If it still does not work, complete these steps:
This issue can be tracked under Cisco bug ID CSCti18636.
When CAD login fails and EM is not in use, restart the UCCX Engine and try to log in again.
This issue can be tracked under Cisco bug ID CSCtk00173.
You receive an error message when you try to log into CAD.
This computer cannot connect to all CAD services because at least one CAD service
IP address has changed
This error appears mostly in scenarios where a secondary node has been installed and the IP address of the node is absent from the postinstall.exe file.
When you install CAD, you receive this error:
Error 1310: error writing to file...
This error is often received when the CAD Client Configuration Tool runs on a PC with anti-virus or security software. Download and rerun the client configuration tool on a machine that does not have anti-virus or security software installed.
When you call in, the remote monitoring works fine; but as soon as an extension of the agent is input, this message is heard.
System is experiencing server connectivity problems
Examination of the UCCX Engine logs (MIVR) shows this:
227530655: Jan 03 10:06:21.829 EDT %MIVR-SS_VOIPMON_SRV-7-UNK:Extension <2100>
MAC address <SEPABC123DEF456>
227530664: Jan 03 10:06:21.840 EDT %MIVR-LIB_LDAP-3-EXCEPTION:javax.naming.
NameNotFoundException: [LDAP: error code 32 - No Such Object]; remaining name
'sectName=Configurations,appName=Setup,ou=VoIP Monitor Devices,lcc=Call Center
1,ou=Company,o=Spanlink Communications'
Cisco001MIVR113.log 6888 227530679: Jan 03 10:06:21.841 EDT
%MIVR-LIB_LDAP-3-EXCEPTION: at com.spanlink.VOIPMonitor.subsystem.SplkSubsystem.
getVoipServerCorbaObject(SplkSubsystem.java:1059)
Cisco001MIVR113.log 6912 227530703: Jan 03 10:06:21.842 EDT %MIVR-SS_
VOIPMON_SRV-3-EXCEPTION: at com.spanlink.VOIPMonitor.subsystem.SplkSubsystem.
getVoipServerCorbaObject(SplkSubsystem.java:1059)
Cisco001MIVR113.log 6923 227530714: Jan 03 10:06:21.842 EDT %MIVR-SS_
VOIPMON_SRV-3-EXCEPTION: at com.spanlink.VOIPMonitor.subsystem.SplkSubsystem.
getVoipServerCorbaObject(SplkSubsystem.java:1059)
Cisco001MIVR113.log 6932 227530723: Jan 03 10:06:21.843 EDT %MIVR-SS_
VOIPMON_SRV-3-CORBA_INVOKE_ERROR:Fail to invoke corba call: Module Name=splkSubsystem.
startSimultaneousMonitoring,A specific description for a trace=Cann't get server
object, quit,Exception=
227530727: Jan 03 10:06:21.857 EDT %MIVR-SS_RM-3-UNABLE_TO_START_MONITORING:VoIP
Monitor server is unable to start monitoring: Module Name=RM component,A description
for the nature of the error=startSimultaneousMonitor returned 0
227530728: Jan 03 10:06:21.857 EDT %MIVR-SS_RM-7-UNK:startMonitor returns status: -5
Open CDA and navigate to Settings > Service Configuration > Multiline, Monitoring & Recording > VoIP Monitoring Device. Check and make sure under Default VoIP Monitor Service that there is a server selected.
CSD startup is stuck at the initial screen with no error messages or progress and the login screen fails to display.
The CSD logs show this:
SplkException.cpp[147] splk_socket_internal::SocketOperations::close:com.spanlink.
util.socket.SplkSocketException: Failed to shutdown socket descriptor:10093:Either
the application has not called WSAStartup, or WSAStartup failed. Stack trace<>.
The error logs show that WSAStartup failed and thus CSD also failed to start. This is due to an incompatible Java version on the Agent PC (or the terminal server if this is a thin-client environment).
In a thin-client environment, no agent or supervisor logs are found on the server. This happens because the user-specific home folder was not mapped.
Map user to the home folder. This can be done if you access the User Properties Dialog box, map the drive under the Terminal Services Profile lab, and ensure the mapping is in the format: \\servername\sharename\%username%.
Here is an example from the CAD thin-client guide:
CAD fails to pop into focus in the foreground when a new call arrives.
In some cases, the application might not meet the required conditions to pop to the foreground, or is pre-empted by another application that takes over the foreground.
The criteria that a process has to meet to become the foreground window is described here:
There are three situations where the CAD window would not maximize.
There is a registry modification that immediately times out the ForegroundLockTimeout and removes that as a potential cause: