This document describes how to troubleshoot Unified Messaging Services and Unified Messaging Accounts. Cisco Unity Connection Version 8.5 and later supports single inbox (SIB), which is also referred to as Unified Messaging. In versions before Version 8.5, Unity Connection had the capability to accept only and to relay the voicemails to external email addresses.
Cisco recommends that you have knowledge of these topics:
The information in this document is based on these software and hardware versions:
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.
SIB, one of the Unified Messaging features in Cisco Unity Connection Version 8.5, synchronizes voice messages in Connection and Exchange mailboxes. When a user is enabled for SIB, all Connection voice messages that are sent to the user, which includes those sent from Cisco Unity Connection VMO, are first stored in Connection and are immediately replicated to the user's Exchange mailbox. In addition, status changes (for example, from unread to read), changes to the subject line, and changes to the priority are replicated from Connection to Exchange and vice versa. The Message Waiting Indicator (MWI) turns off when the message is read - either via phone or email client.
Refer to Task List for Configuring Cisco Unity Connection 8.5 and Later and Exchange for Unified Messaging for information on how to configure SIB.
These two main sections must be configured for SIB on Unity Connection:
This section provides tips used in order to troubleshoot Unified Messaging Service and Unified Messaging Accounts.
Problem: Scenario 1
Under Unified Messaging Service, if Specify an Exchange Server is selected instead of Search for Exchange Servers, the test succeeds. If Search for Exchange Servers is selected, this error displays when the Test button on the page is clicked:
Searching the network Failed to locate a Domain Controller via DNS.
Searching the network Failed to locate an Exchange 2003 server.
Connection will not be able to Locate Exchange 2003 subscribers.
Here are sample Tomcat logs (set the CsExMbxLocator micro trace, Level 10-13):
CsExMbxLocator,13,AutoDiscoverURLS not found in cache
CsExMbxLocator,13,[CsExMbxLocator/CsExMbxLocator.cpp:331]:
Run DNS query for: _ldap._tcp.dc._msdcs.xxx.xxx
CsExMbxLocator,13,[CsExMbxLocator/CCsDNSResolver.cpp:168]:
querying dns for _ldap._tcp.dc._msdcs.xxx.xxx question type 33
CsExMbxLocator,13,[CsExMbxLocator/CCsDNSResolver.cpp:186]
Length of returned DNS response is -1
CsExMbxLocator,10,[CsExMbxLocator/CCsDNSResolver.cpp:190]
failed to get dns results for _ldap._tcp.dc._msdcs.xxx.xxx question type 33
CsExMbxLocator,11,[CsExMbxLocator/CsExMbxLocator.cpp:359]:
DNS query for: _ldap._tcp.dc._msdcs.xxx.xxx didn't return results
CsExMbxLocator,13,[CsExMbxLocator/CsExMbxLocator.cpp:192]
Test Button result: Failed to locate a Domain Controller via DNS.
CsExMbxLocator,13,[CsExMbxLocator/CsExMbxLocator.cpp:192]
Test Button result: Failed to locate an Exchange 2003 server.
Connection will not be able to Locate Exchange 2003 subscribers.
CsExMbxLocator,11,Failed to find DC required for 2003 support
For additional troubleshooting steps, refer to Cisco bug ID CSCtq10780 and Granting Permissions to the Unified Messaging Services Account for Cisco Unity Connection 8.5 and Later (Exchange 2003 Only).
Problem: Scenario 2
This error displays when the Test button on the page is clicked:
Could not connect to Domain Controller (dc1.xxx.xxx) from DNS
Could not connect to Domain Controller (dc2.xxx.xxx) from DNS
Could not connect to Domain Controller (dc3.xxx.xxx) from DNS
Here are sample Tomcat logs (set the CsExMbxLocator micro trace, Level 10-13):
CsExMbxLocator,10,LDAP initialize non-SSL Return Code (0)
CsExMbxLocator,10,LDAP authentication bind failed: INVALID_CREDENTIALS
CsExMbxLocator,10,CCsLDAPHelper::Init():exit AUTH_NOT_INITIALIZED
CsExMbxLocator,13,[CsExMbxLocator/CsExMbxLocator.cpp:192] Test Button result:
Could not connect to Domain Controller (dc1.xxx.xxx) from DNS
Solution
This problem might be caused as a result of an expired password or an incorrect password that is entered in Unity Connection (account locked in Active Directory). In order to fix this problem, change the password in Active Directory, and enter it again in Unity Connection.
Problem: Scenario 3
This error displays when the Test button on the page is clicked:
Searching the network Could not connect to Domain Controller (dc1.xxx.xxx) from DNS
Searching the network Could not connect to Domain Controller (dc2.xxx.xxx) from DNS
Searching the network Failed to locate a Domain Controller via DNS.
Searching the network Failed connected to Exchange CAS server at
(https://xxx.xxx/autodiscover/autodiscover.xml)
Searching the network Failed connected to Exchange CAS server at
(https://autodiscover.xxx.xxx/autodiscover/autodiscover.xml)
Searching the network Could not find an Exchange CAS server via Autodiscover
DNS SRV record
Searching the network Failed to locate an Exchange CAS server. Connection will
not be able to Locate Exchange 2007/2010 subscribers.
Possible Solutions
From logs, a similar trace entry is seen as mentioned in Scenario 2. If Unity Connection is unable to connect to a domain controller, the issue is most likely an incorrect password. If Unity Connection is able to connect to a domain controller and still receives the remaining errors, check Scenario 5.
Here are sample Tomcat logs (set the CsExMbxLocator micro trace, level 10-13):
CsExMbxLocator,10,[CsExMbxLocator/CsExMbxLocator.cpp:1173]:
HTTP request failed with error: Couldn't connect to server
-- couldn't connect to host, HTTP status code: 503, for
Autodiscovery URL: http://autodiscover.xxxxxxxxx.xxx/
autodiscover/autodiscover.xml, verb: GET, query:
CsExMbxLocator,13,[CsExMbxLocator/CsExMbxLocator.cpp:192]
Test Button result: Failed connected to Exchange CAS
server at (http://autodiscover.xxxxxxxxx.xxx/autodiscover/autodiscover.xml)
CsExMbxLocator,13,[CsExMbxLocator/CCsDNSResolver.cpp:168]:
querying dns for_autodiscover._tcp.xxxxxxxxx.xxx question type 33
CsExMbxLocator,13,[CsExMbxLocator/CCsDNSResolver.cpp:186]
Length of returned DNS response is -1
CsExMbxLocator,10,[CsExMbxLocator/CCsDNSResolver.cpp:190]
failed to get dns results for_autodiscover._tcp.xxxxxxxxx.xxx
question type 33
CsExMbxLocator,13,[CsExMbxLocator/CsExMbxLocator.cpp:192]
Test Button result: Could not find an Exchange CAS server via
Autodiscover DNS SRV record
CsExMbxLocator,11,[CsExMbxLocator/CsExMbxLocator.cpp:636]:
DNS query for: _autodiscover._tcp.xxxxxxxxx.xxx didn't return results
CsExMbxLocator,13,[CsExMbxLocator/CsExMbxLocator.cpp:192]
Test Button result: Failed to locate an Exchange CAS server.
Connection will not be able to Locate Exchange 2007/2010 subscribers.
If these traces are seen in the log, navigate to Unified Messaging > Unified Messaging Services > Exchange Servers > Search for Exchange Servers > Active Directory DNS Domain Name, and make sure the domain name is correct.
Problem: Scenario 4
This error displays when the Test button on the page is clicked:
Peer certificate cannot be authenticated with known CA certificates
- SSL certification problem, verify that the CA cert is OK.
Details: error:14090086SL routinesSL3_GET_SERVER_CERTIFICATE:
certificate verify failed
The certificate can be uploaded successfully to Connection-Trust; however, this error is received when you upload the same certificate to Tomcat-Trust:
Error reading the certificate
Possible Solutions
Root Certificate
----------------------
Here the Issuer Name and Subject Name will be the same.
Issuer Name: CN=ABC, OU=XXXX, OU=XXX, O=XXXXX, C=XX
Validity From: Tue Nov 07 16:00:00 PST 2006
To: Wed Jul 16 16:59:59 PDT 2036
Subject Name: CN=ABC, OU=XXXX, OU=XXX, O=XXXXX, C=XX
Intermediate Certificate
----------------------------
Here the Issuer Name will be that of the Root Certificate and Suject
Name will have information about the Intermediate Certificate.
Issuer Name: CN=ABC, OU=XXXX, OU=XXX, O=XXXXX, C=XX
Validity From: Sun Feb 07 16:00:00 PST 2010
To: Fri Feb 07 15:59:59 PST 2020
Subject Name: CN=XYZ, OU=XXXXXXXXXXXXXXXXX, OU=XXXXXXXXXXXXXXX,
O=XXXXXXXX, C=XX
Server Certificate
--------------------------
Here the Issuer name will be that of the Intermediate certificate and the
Subject Name will contain information about the Exchange server
Issuer Name: CN=XYZ, OU=XXXXXXXXXXXXXXXXX, OU=XXXXXXXXXXXXXXX,
O=XXXXXXXX, C=XX
Validity From: Thu Aug 01 17:00:00 PDT 2013
To: Thu Aug 17 16:59:59 PDT 2017
Subject Name: CN=mail.abc.lab, OU=XXXX, OU=XX, O=XXXXXXX, L=XXXX, ST=XXXX, C=XX
Problem: Scenario 5
This error displays when the Test button on the page is clicked:
Searching the network Successfully connected to Domain Controller (dc1.xxx.xxx)
from DNS
Searching the network Could not connect to Exchange CAS server
(https://EX2010-1.xxx.xxx/Autodiscover/Autodiscover.xml) from Active Directory
Searching the network Could not find an Exchange CAS server via Active Directory
Searching the network Successfully connected to Exchange 2003 server (EX2003.xxx.xxx)
from Active Directory
Searching the network Failed connected to Exchange CAS server at
(https://xxx.xxx/autodiscover/autodiscover.xml)
Searching the network Failed connected to Exchange CAS server at
(https://autodiscover.xxx.xxx/autodiscover/autodiscover.xml)
Searching the network Could not find an Exchange CAS server via Autodiscover DNS
SRV record
Searching the network Failed to locate an Exchange CAS server. Connection will not be able
to Locate Exchange 2007/2010 subscribers.
Possible Solution
Check whether Exchange 2010 Central Authentication Service (CAS) is set in order to require HTTPS, and the Exchange 2003 server is set to HTTP only. Set the CAS in order to allow HTTP or HTTPS.
Here is a similar scenario:
Searching the network Successfully connected to Domain Controller (dc1.xxx.xxx)
from DNS
Searching the network Could not connect to Exchange CAS server
(https://EX2010-1.xxx.xxx/Autodiscover/Autodiscover.xml) from Active Directory
Searching the network Could not find an Exchange CAS server via Active Directory
Searching the network Failed to locate an Exchange 2003 server. Connection will
not be able to locate Exchange 2003 subscribers.
Searching the network Failed connected to Exchange CAS server at
(https://xxx.xxx/autodiscover/autodiscover.xml)
Searching the network Failed connected to Exchange CAS server at
(https://autodiscover.xxx.xxx/autodiscover/autodiscover.xml)
Searching the network Could not find an Exchange CAS server via Autodiscover DNS
SRV record
Searching the network Failed to locate an Exchange CAS server. Connection will
not be able to Locate Exchange 2007/2010 subscribers.
Possible Solutions
Problem: Scenario 6
This error displays when the Test button on the page is clicked:
Could not connect to Exchange 2003 server (ncacn_ip_tcp:
<exchangemailboxserver1.example.com>) from Active Directory
Could not connect to Exchange 2003 server (ncacn_ip_tcp:
<exchangemailboxserver2.example.com>) from Active Directory
Could not connect to Exchange 2003 server (ncacn_ip_tcp:
<exchangemailboxserver3.example.com>) from Active Directory
For additional troubleshooting steps, refer to Cisco bug ID CSCto35509.
Problem: Scenario 1
This error displays when the Test button on the page is clicked:
The system failed to perform an IMAP operation.
Refer to other warnings and errors generated by the tool, and check the Tomcat
log file for details.
The system failed while trying to make an API call.
Here are sample CuImapSvr logs (set CuImapSvr Micro Trace - All Levels):
CML,19,Connection attempt to IMAP server at
{10.xxx.xxx.xx:143/imap/notls/user="xxx/um/TestUser"}INBOX failed.
CML,19,E_CML_IMAP_CONNECT_FAILED (0x80046410)
Connection failed on IMAP request. Logged from HRESULT
CCsCmlImapDriver::ExecuteRequest(TCsAutoPtr<CCsCmlImapRequest>&)
in CsCml/CsCmlImapDriver.cpp at line 355.
CML,19,E_CML_IMAP_CONNECT_FAILED (0x80046410)
Unable to count messages using search-term ALL on
imapfolder[login={10.xxx.xxx.xx:143/imap/notls/user="xxx/um/TestUser"}INBOX]
in imapmbx[store=10.xxx.xxx.xx login=xxx/um/TestUser in
session[id=5 alias=TestUser].
Logged from virtual HRESULT
CCsCmlImapFolder::GetMessageCount(const CCsCmlSearchTerm&, int&) in
CsCml/CsCmlImapFolder.cpp at line 258.
CML,11,E_CML_IMAP_CONNECT_FAILED (0x80046410) Unable to get a message
count from the External inbox for subscriber TestUser. Logged from HRESULT
<unnamed>::VerifyMailbox(CCsCdlSubscriber&, CCsCmlMailbox&) in
CsCml/CsCmlSession.cpp at line 486.
Possible Solutions
Problem: Scenario 2
This error displays when the Test button on the page is clicked:
The system failed to perform a typical calendar operation.
Possible Solutions
Problem: Scenario 3
This error displays when the Test button on the page is clicked:
Failed accessing xxx@ayz.com Diagnostic=[Timeout was reached --
operation timed out after 1000 milliseconds with 0 bytes recieved]
Possible Solutions
Problem: Scenario 4
This error displays when the Test button on the page is clicked:
Failed accessing xxx@ayz.com Diagnostic=[] Verb =[] url=[] request=[] response[]
Possible Solutions
Sample logs:
HTTP request failed with error: Bad response from server, HTTP code returned:
401, HTTP status code: 401
Sample logs:
HTTP request failed with error: Couldn't connect to server -- couldn't connect
to host, HTTP status code: 503
Problem: Scenario 5
This error displays when the Test button on the page is clicked:
The error is error:0200206F:system library:connect:Connection refused.
Refer to the tomcat log
Here are sample Tomcat logs:
HTTP 503 ERRORS:
HTTP request failed with error: Couldn't connect to server --
couldn't connect to host, HTTP status code: 503, for ews
URL: https://xxxxxxxx.outlook.com/EWS/Exchange.ASMX, verb: POST
HTTP 401 ERRORS:
HTTP request failed with error: Bad response from server, HTTP code returned:
401, HTTP status code: 401, for ews URL:
https://xxxxxxxxxx.outlook.com/EWS/Exchange.ASMX, verb: POST
HTTP 404 ERRORS:
HTTP request failed with error: Bad response from server, HTTP code returned:
404, HTTP status code: 404, for Autodiscovery URL:
https://xxxx.com/autodiscover/autodiscover.xml, verb: GET, query:
Possible Solutions
Problem: Scenario 6
This error displays when the Test button on the page is clicked:
Diagnostic=[SSL connect error -- error:1408F119:SSL routines:SSL3_GET_RECORD:
decryption failed or bad record mac] Verb=[POST]
Solution
This is due to corrupt certificates. From the OS Administration page, regenerate tomcat.pem certificate. Restart Tomcat Service.
Error codes
Here are some error codes that you might encounter:
Log Name: Application
Source: MSExchange Web Services
Date: 9/7/2013 7:59:16 PM
Event ID: 24
Task Category: Core
Level: Error
Keywords: Classic
User: N/A
Computer: XXX.XXXXXXXXX.com
Description:
The Exchange certificate [Subject]
CN=XXX.XXXXXXXXX.com, OU=XXXXXXXXX, OU=XX, O=XXXXXXXXXXXX, L=XXXXXX,
S=XXXXXXX, C=XX
[Issuer]
CN=XXXXXXXXXXX, OU=XXXXXXXXXXX, OU=XXXXXXXXX, O=XXXXXXXXX, C=XX
[Serial Number]
XXXXXXXXXXXXXXXXXXXXXXXXX
[Not Before]
8/9/2012 5:00:00 PM
[Not After]
8/17/2013 4:59:59 PM
[Thumbprint]
XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
expired on 8/17/2013 4:59:59 PM.
Some of these error codes are also mentioned in this document: Single Inbox Is Not Working for Users Associated with a Unified Messaging Service.
If the Exchange server response is slow, increase Time to Wait for a Response (In Seconds) in Cisco Unity Connection (under System Settings > Advanced > Unified Messaging Services).
Other Issues
In scenarios where the Test is successful on both the Unified Messaging Account and Unified Messaging Services page, enable these traces:
Problem: Scenario
Unity Connection is configured in order to connect with Exchange 2003.
This is from the logs:
01:10:20.300 |6549,mail.xxxxxx.com,{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx},
CsWebDav,14,[CsWebDav/CsWebDavMbxClient.cpp:3340]: HTTP Status code: 500,
WEBDAV response headers: HTTP/1.1 500 Internal Server Error
This is from the Exchange logs:
Event ID: 9667
Type: Error
Category: General
Source: msgidNamedPropsQuotaError
Description: Failed to create a new named property for database "<databasename>"
because the number of named properties reached the quota limit (<configured quota>).
User attempting to create the named property: <user name>. Named property
GUID: <GUID of named property>.
Named property name/id: <name of named property>.
Solution
These events are logged when a database on an Exchange server with the Mailbox server role installed approaches or reaches the maximum limit of named properties or replica identifiers.
A registry change is required in order to fix this issue as mentioned in this Microsoft Technet article - How to Configure Named Properties and Replica Identifier Quotas.
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSExchangeIS\
<ServerName>\<Database Type-GUID>
Change the DWORD - NonMAPI Named Props Quota value. It is normally set to 8,192. Modify this to 16,384.
Refer to these documents for more information on this:
Revision | Publish Date | Comments |
---|---|---|
2.0 |
15-Mar-2023 |
March 15 |
1.0 |
01-Mar-2013 |
Initial Release |