CUACA Troubleshooting Guide
CUACA Troubleshooting Guide
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCBs public
domain version of the UNIX operating system. All rights reserved. Copyright 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED AS IS WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco Ironport, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect, Cisco Stackpower,
Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flip Video, Flip Video (Design),
Flipshare (Design), Flip Ultra, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Store, and Flip Gift Card are
service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the
Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without
Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study,
IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar,
PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath,
WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship
between Cisco and any other company. (0907R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display
output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in
illustrative content is unintentional and coincidental.
Preface v
Configuration Database (ATTCFG) Creation Hangs During Cisco Unified Attendant Console Advanced
Installation 2-3
Model Database Initially Too Small 2-3
Changing SQL Server Host Name, Login and Password 2-3
Before Running the Batch Files 2-4
Running the Batch Files 2-5
Running SqlCfgChange.bat 2-5
Running ServerChange.bat 2-5
After Changing the Servers 2-6
If the Conversion Fails 2-6
CTI Device Problems 2-7
Cisco Unified Attendant Console Advanced Administration Web Pages Do Not Display Properly 3-1
Unable to Navigate Cisco Unified Attendant Console Advanced Administration and Menus Stop
Working 3-1
Unable to Create Queues or Operators 3-2
Logging In to Cisco Unified Attendant Console Advanced Administration Causes "DB Error" Message 3-3
Deleting All Directory Entries from Cisco Unified Attendant Console Advanced 3-3
CHAPTER 4 Cisco Unified Attendant Console Advanced Client Software Issues 4-1
This document is intended for anyone involved in the troubleshooting and support of Cisco Unified
Attendant Console Advanced. It assumes basic understanding of the Cisco Unified Attendant Console
Advanced system and Cisco Unified Communications Manager, and it should be used in conjunction
with the following documents:
Cisco Unified Attendant Console Advanced Administration and Installation Guide
Cisco Unified Attendant Console Advanced Design Guide
This chapter describes how to use Cisco Unified Attendant Console Advanced Logging functionality to
troubleshooting your system.
To configure logging, run Cisco Unified Attendant Console Advanced Administration and choose
Engineering > Logging Management.
Location Use
\Database Logging Yes enables Contact Directory and search logging, No disables it.
\Full Logging Yes enables full logging. No enables default logging.
\General Log File The logging files base name. Default is OPRlog.txt.
\General Log Location The path to the log files folder.
By default, this is C:\Program Files\Cisco\Logging.
\Host CTI Service Logging Yes enables phone status icons logging. No disables it.
\Logging On Yes turns logging on. No turns logging off.
\Maximum Log Files The maximum number of log files to save before overwriting the oldest.
\Maximum Log Lines Number of lines written in each log file
Key Setting
\API Clients Level 262 decimal (106 hex)
\Clients Level 7 decimal/hex
\Data Objects Process YES
\Data Objects Level 7 decimal/hex
\API External APIs Level 519 decimal (207 hex)
\Internal Objects Level 7 decimal/hex
\Internal Objects Process YES
\Management Level 263 decimal (107 hex)
\Request Response Level 7 decimal/hex
\System Level 263 decimal (107 hex)
Step 1 If you have not already done so, create the folder, C:\Program Files\Cisco\Logging\TSP.
Step 2 In Control Panel, select Phone and Modem.
Step 3 Click the Advanced tab, select CiscoTSP001.tsp, and then click Configure.
Step 4 In the Cisco Unified Communications Manager TSP dialog box, click the Trace tab and then change the
Directory to C:\Program Files\Cisco\Logging\TSP.
Step 5 Optionally, select CTI Trace and TSPI Trace, and select Detailed.
Step 6 Click OK.
This chapter describes problems that can arise during installation. It also covers problems cause by the
connection between the Cisco Unified Attendant Console Advanced and external resources, such as the
Cisco Unified Communications Manager or LDAP sources.
Step 1 Ensure the Application User username and password are correct by logging into the Cisco Unified
Communications Manager with the same credentials.
Step 2 Ensure that the user is added to the Standard Cisco Unified Communications Manager Super Users
Group.
Step 3 Ensure users have the following roles assigned:
Standard AXL API Access
Standard CTI Allow Calling Number Modification
Standard CTI Allow Call Park Monitoring
Standard CTI Allow Control of All Devices
Standard CTI Allow Control of Phones supporting Connected Xfer and conf*
Standard CTI Allow Control of Phones supporting Rollover Mode*
Standard CTI Allow Reception of SRTP Key Material
Standard CTI Enabled
Note * These are relevant only if you are using phone models 69xx, 7931, 7965, 89xx and 99xx on Cisco
Unified Communications Manager 7.1.2 or greater.
Step 4 Ensure that the AXL Service is activated on the Cisco Unified Communications Manager.
Note The procedure in this link works for all Windows environments.
Step 1 Launch Microsoft SQL Server Management Studio and Connect to Server.
Step 2 In the navigation bar, expand Databases > System Databases.
Step 3 Right click model, and then select Properties.
Step 4 Under Select a page, select Files.
Step 5 For the database file modeldev, change the Initial Size to 3 (MB), and then click OK.
Step 6 Close Microsoft SQL Server Management Studio.
Step 7 Relaunch the Cisco Unified Attendant Console Advanced installation wizard and continue with the
installation.
Note If you are only changing the SQL server login name and password, run SqlCfgChange.bat only;
otherwise run both batch files, one after the other, in any order.
The batch files are in the folder: \<installation_folder>\Utility\Server and SQL Change Tool
The default <installation_folder> is Cisco.
Note If you have a resilient system, you need to do steps 1. and 2. below on both servers, even if you only
want to change one server.
Running SqlCfgChange.bat
To change the SQL Server user name and password, do the following:
Note The new user must have the necessary privileges and access rights as mentioned in the Cisco Unified
Attendant Console Advanced installation instructions.
Running ServerChange.bat
To change the server host name, do the following:
Step 1 On the Cisco Unified Attendant Console Advanced server, click the Start button, and then, on the Start
menu, click Run, and then type dialer.
Step 2 In the Phone Dialer, choose Tools > Connect Using and check that the Synchronized CTI devices are
listed
If the devices are in the list, start the Cisco Unified Attendant Console Advanced Administration,
choose Engineering > Service Management, and ensure that the Cisco Unified Attendant Console
Advanced Server service is running.
If the devices are not in the list, the TSP is not working correctly. Ensure that the TSP Configuration
is correct and then reboot the machine to re-establish the TAPI connection.
Installing the TSP or Wave Driver via an RDP connection can cause the TSP to malfunction. For more
information on this, see the Install and Upgrade Guides at
http://www.cisco.com/en/US/products/ps7282/prod_installation_guides_list.html.
If the TSP and Wave Driver were installed via a session-based access method, you will have to reinstall
them. If you need to uninstall the Cisco TSP follow the instructions in the C:\Program
Files\Ciscociscotsp.txt file, which is created when the TSP is installed.
Here is another check you can perform:
Verify that CTI devices are not associated with any other End or Application Users in the cluster.
Step 1 Click the Start button. In the search box, type Device Manager, and then, in the list of results, click
Device Manager.
Step 2 Expand Sound, video and game controllers.
Step 3 Right-click Cisco Unified Communications Manager TSP Wave Driver, and then click Uninstall.
Step 4 Repeat this process for each instance of the Wave Driver installed.
Step 5 Reboot the machine and reinstall the TSP and Wave Driver as described in the installation guide at
http://www.cisco.com/en/US/products/ps7282/prod_installation_guides_list.html.
Caution If the Cisco Unified Communications Manager is upgraded, you must also upgrade the Cisco Unified
Attendant Console Advanced Server's TSP Installation.
Note If you are using Cisco Unified Communications Manager 8.x, this is done automatically by the Cisco
Unified Attendant Console Advanced Installation Wizard, and the new Cisco Media Driver is used
instead of the TAPI Wave Driver.
If CTI Devices are not synchronizing to Cisco Unified Communications Manager, do the following:
Step 1 In Cisco Unified Attendant Console Advanced Administration, choose System Configuration >
Synchronize with CUCM and select the Synchronize with CUCM.
Step 2 If the devices fail to synchronize there will be an error code, for example 8500. Reference this code in
the Cisco Unified Attendant Console Advanced Administration and Installation Guide, located at
http://www.cisco.com/en/US/products/ps7282/prod_installation_guides_list.html.
Step 1 In Cisco Unified Attendant Console Advanced Administration choose Engineering > Service
Management and select the information icon for the LDAP Service.
The LDAP Status window appears, containing the number of active connections and active synchs, as
well as the connectivity status. For example:
Step 1 If the number in the directory is correct, in Cisco Unified Attendant Console Advanced Administration
choose User Settings > General Settings and ensure that the maximum internal extension length is
sufficient to cover all the digits in the number dialed by the operator (including the voicemail prefix if
configured).
If the number dialed exceeds the configured maximum internal extension length, the prefix will be added
to that number.
Step 2 If step 1 does not resolve the issue, the problem is most likely to be with the Calling Search Space. To
check this, ensure that the Service Queue CTI Ports have the necessary CSS to reach the intended
destination:
a. With Cisco Unified Attendant Console Advanced Server shut down, click the Start button, and then,
in the Start menu, click Run, and then type dialer.
b. Connect to one of the Service Queue devices.
c. Dial the number the operator is attempting to transfer calls to.
d. If the number does not ring, the CSS on the CTI Port needs to be updated to allow sending calls to
the destination Partition.
e. If the call is successful, determine whether the transfer problem occurs only with external calls by
placing a call from an internal extension directly to the CTI Route Point associated with the queue.
If Direct Transfers are enabled (see Enabling Direct Transfers, page 4-5) and the operator can
transfer the internal call, the issue is with the CSS on the gateway. As Cisco Unified Attendant
Console Advanced uses TSP and CTI to move calls, the function of CTI Redirect performed on the
call forces it to inherit the CSS of the gateway which does not always allow calls to all phones.
Modify the gateway CSS to accommodate this and resolve the problem.
Step 1 Use Windows Server Manager to stop the Cisco Unified Attendant Console Advanced LDAP Plug-in and
Cisco Unified Attendant Console Advanced Server Services.
Step 2 Update the following registry keys with the Cisco Unified Attendant Console Advanced server IP
address or hostname (recommended).
HKEY_LOCAL_MACHINE\SOFTWARE\Arc Solutions\Call Connect\Configuration\Defaults
Web Server
HKEY_LOCAL_MACHINE\SOFTWARE\Arc Solutions\Call Connect\Configuration Database
Server
HKey_Local_Machine\SOFTWARE\Arc Solutions\Call Connect\Defaults
CTI Server Name
Last Connected Server
Presence Server Name
Server Name
HKEY_LOCAL_MACHINE\SOFTWARE\Arc Solutions\Call Connect\LDAP Synchronize
Server\CT Connection\Primary
Server Name
HKEY_LOCAL_MACHINE\SOFTWARE\Arc Solutions\Call Connect\LDAP Synchronize
Server\Defaults
Server Name
HKEY_LOCAL_MACHINE\SOFTWARE\Arc Solutions\Call Connect\Logging Database
Server
CTI Server
The CTI Server configuration file C:\Program Files\Cisco\CTI Server\CTI Server.exe contains the key:
<add key="ServerIP" value="xxx"/ >
Update this with the new IP Address/hostname of the Cisco Unified Attendant Console Advanced Server.
Note The location may vary slightly in different versions of the Cisco Unified Attendant Console Advanced
Server.
CUP Server
The CUP Server configuration file C:\Program Files\Cisco\CUPS\Cisco Presence Server Plug-in.exe
contains the key:
<add key='ServerIP' value='xxx'/ >
Update this with the new IP Address/hostname of the Cisco Unified Attendant Console Advanced Server.
Note The location may vary slightly in different versions of the Cisco Unified Attendant Console Advanced
Server.
Step 1 Open this file using a text editor and locate the following lines:
ATTCFG,Configuration DB,xxx.xxx.xxx.xxx,sa,)hh > (j]n]j)
ATTLOG,Logging DB,xxx.xxx.xxx.xxx,sa,)hh > (j]n]j)
where xxx.xxx.xxx.xxx is the IP address.
Step 2 Change the IP address above to the new IP Address/hostname.
Step 3 Save the file.
Clients
You also need to update the Cisco Unified Attendant Console Advanced clients with the correct Cisco
Unified Attendant Console Advanced Server IP Address/hostname.
Note Log out and close the client before making any changes.
Note If the ActiveMQ service fails to start this is probably because the latest version of Java is not installed.
To install the latest version of Java, visit java.com and follow the instructions.
This chapter describes problems that can occur with Cisco Unified Attendant Console Advanced
Administration.
Add more operator licenses to allow for the creation of more operator usernames and queues.
Step 1 Check Windows Services and ensure that the Cisco Unified Attendant Console Advanced Server service
is started.
If the service is stopped, start it and ensure that it is set to start automatically.
Step 2 If the service is started, check the log file: C:\Program Files\Cisco\Logging\SRV\Log\icdinit.log. This
file logs each server start and will contain error messages describing why the Cisco Unified Attendant
Console Advanced server cannot start.
Step 3 If the error messages are Unable connect to database ATTCFG and Unable to connect to database
ATTLOG ensure that the Microsoft SQL Server service is started and set to automatically start.
Step 4 Sometimes SQL does not allow the Cisco Unified Attendant Console Advanced service to log onto the
databases.
Step 5 Using Microsoft SQL Server Studio Management ensure the following:
BUILTIN\ADMINISTRATORS and the sa username have system administrator permissions
assigned.
The account is not locked out.
Step 3 Once the deletion has worked successfully, use Cisco Unified Attendant Console Advanced
Administration to:
a. Delete the Rule Filter created in Step 1.
b. Stop and then start the Cisco Unified Attendant Console Advanced LDAP Plug-in.
To prevent these invalid contacts from being copied, run Cisco Unified Attendant Console Advanced
Administration, and then create a filter against each Directory Rule to synchronize only those contacts
that have their tkuserprofile parameter equal to 1, as shown below.
This chapter describes the following Cisco Unified Attendant Console Advanced client software issues:
Directory Issues
Contact Phone Status Shows Out Of Service
Client Preferences Are Not Saved
Remove Call Park Window
Enabling Direct Transfers
Directory Issues
This section describes the following directory issues:
Directory Does Not Display and Console Shows Database not connected
Contact Phone Status Not Displayed
Contact Phone Status Shows Out Of Service
Directory Does Not Display and Console Shows Database not connected
If the directory does not display and console shows Database not connected, log on to the Cisco Unified
Attendant Console Advanced client PC and do the following:
Step 1 Verify that the Windows User has Full Control access to the HKEY_LOCAL_MACHINE\Software\Arc
Solutions registry key. For instructions on how to grant this access level, see Client Preferences Are Not
Saved, page 4-3.
Note If the Cisco Unified Attendant Console Advanced version is earlier than 8.0.3 verify that
HKEY_LOCAL_MACHINE\Software\Borland has this access as well.
Step 2 Verify that the Cisco Unified Attendant Console Advanced Server can be pinged from the command line
by both IP Address and Hostname. If it cannot be reached using Hostname, have this added to DNS or
to the host file on the machine.
Step 3 On the Cisco Unified Attendant Console Advanced Server, ensure that the contact database is populated:
a. Open a synchronization log file in C:\Program Files\Cisco\Logging\LDAP\Log\SSLog_xxxx.txt.
b. Check that the following lines show in the logs:
Step 1 On the Cisco Unified Attendant Console Advanced client PC, log in as Local Administrator.
Step 2 Ensure that all Cisco applications are closed.
Step 3 Click the Start button, and then, from the Start menu, select Run.
Step 4 In the Run dialog box, type Regedit.
The Windows Registry Editor opens.
Step 5 Browse to HKLM > Software > Arc Solutions.
Step 6 Right-click the Arc Solutions registry key, and select Permissions.
Step 7 The Permissions for Arc Solutions dialog box appears. For example:
Step 12 Click Advanced and then select the Replace all existing inheritable permissions on all descendants
with in heritable permissions from this object check box.
Step 13 Click Apply, and then click OK.
The access rights have now been granted and Cisco Unified Attendant Console Advanced will now save
settings.
Step 1 On the Cisco Unified Attendant Console Advanced client PC, log in to the machine as Local
Administrator.
Step 2 Ensure that all Cisco applications are closed.
Step 3 Select Start > Run, and type Regedit in Open.
Note If Direct Transfer is enabled, a prerequisite is that the gateway is configured with the relevant CSS to
enable calls to be redirected back out to an external number. However not all Cisco Unified
Communications Manager customers are willing to make changes to their CSS or Gateway
configuration.
If you wish to enable Direct Transfers you must accept that the gateways CSS MUST be configured to
allow calls in to be redirected back to an external location.
Procedure
To enable direct transfers:
Step 1 On the Cisco Unified Attendant Console Advanced client PC, log in to the machine as Local
Administrator
Step 2 Ensure that all Cisco applications are closed
Step 3 Select Start > Run, and type Regedit in Open.