This document describes the possible causes and their resolution when desktop login fails because of JAVA Telephony API (JTAPI) issues.
These error messages are seen while logging into Cisco Agent Desktop (CAD) and Finesse, as shown in these images
Error Message on CAD
Error message on Finesse
These are the most common errors that are encountered during the desktop login on CAD/Finesse and there are multiple reasons for this.
Causes and Workarounds
1. Phone's MAC is not associated with RMCM application user on the CUCM
The MAC address of the phones in which the IP Contact Center (IPCC) extension resides must be selected under Controlled Devices on Resource Manager Contact Manager (RMCM) application user.
Resolution: Associate the MAC address with the RMCM application user. On the Cisco Unified Communications Manager (CUCM), navigate to User Management > Application User
If the MAC of the phone is already associated, then
Disassociate the MAC.
Click on Save.
Re-associate the MAC.
Click on Save.
.You can also try to stop and then start the Cisco Computer Telephony Integration (CTI) manager service on all the JTAPI providers.
2. Extension Mobility (EM) profile is not associated with RMCM user
If you use EM together with CUCM 8.0 or later, associate the Device Profile instead of the MAC of the device with the RMCM application user.
Irrespective of the Device Profile, you associate the application user with, set the Intra-Cluster multiple Login Behavior Extension Mobility Service parameter in CUCM to Auto Logout.
This action helps to overcome the design limitation in CTI/JTAPI noticed in the scenarios, which occur when the Intra-Cluster Multiple Login Behavior Extension Mobility Service parameter is set to Multiple Logins Allowed.
Agent logs into EM on a phone and also logged in to CAD.
If a phone unregisters from CUCM, while the agent is still logged into EM, the phone does not re-register. This failure to register may happen when the agent closes the phone without logging out of EM or when the network is severed.
Agent logs into EM from a different device.
When agents attempt to login to CAD, the system displays the error message - Login failed due to a configuration error with your phone and JTAPI or Unified CM. Contact your administrator.
There is no proper workaround to this issue, but resetting the phone device after logging in to EM has been known to work in some cases.However, this is intermittent.
You can also try to
Disable the Recording option
Remove the Recording Profile from the Directory Number (DN)
Reset the phone
The permanent fix is to upgrade the CUCM to a version that has the bugs already resolved.
4. Shared line
The IPCC extension should not be a shared line.
You can check on the CUCM by going Call Routing > Route Plan Report. Please make sure that the IPCC Extension is unique. See the image below, there should be no other instance of the DN.
Also the IPCC Extension must not be part of a Hunt Group.
5. IPCC extension must be on the first 4 lines
The IPCC extension must be on the first 4 lines on the agent device. UCCX allows more than 4 lines to be configured on the agent device, but monitors only the first four lines, provided these lines are not shared.
6. Allow Control Of Device from CTI
Ensure that Allow Control of Device from CTI check box is checked on the IPCC extension, the phone and on the end user as shown in this imahe. If it is already associated, try unchecking and checking it back.
7. RMCM Roles
The RMCM application user should have the group Standard CTI Enabled and, if you are using SIP phone, Standard CTI Allow Control of Phones supporting Connected Xfer and Conf.
8. Common Device Configuration Profile has IPV6 enabled
If the agent phone has Common Device Configuration Profile assigned to it, ensure that IP Addressing Mode field has IPV4 Only assigned to it. To check on the CUCM, navigate to Device > Device Settings > Common Device Configuration.
9. RMCM Subsystem stuck in Initializing
When RMCM Subsystem is stuck in Initializing, while opening the CAD application, you get the Initialization failed, restart the application error.
If the CAD is already open and you enter the credentials to login, you get the Login failed due to a configuration error with your phone and JTAPI or Unified CM. Contact your administrator error.
After theJMX logs deleted as per the defect CSCul18667, you need to contact the Technical Assistance Center (TAC) to perform the workaround of the defect CSCun54915 mandatorily. If workaround of CSCun54915 is not performed then after the server reboot, UCCX engine does not comes up.
If you are on CCX 8.5 SU1 or below, RMCM can be stuck in initializing state when no agents are created as depicted by the bug CSCtq84602.
You can always restart the CTI-Manager on all the CUCM nodes. Deleting the Indentity Trust List (ITL)/Certificate Trust List (CTL) files of the phone helps.
If the above workarounds are not useful, please open a TAC case.