Cisco CallManager Features and Services Guide, Release 4.0(1)
Troubleshooting Features and Services

Table Of Contents

Troubleshooting Features and Services

Troubleshooting Cisco CallManager Extension Mobility

Troubleshooting General Problems with Cisco CallManager Extension Mobility

Troubleshooting Cisco CallManager Extension Mobility Error Messages

Troubleshooting Cisco IP Manager Assistant

IPMAConsoleInstall.jsp Displays Error: Exception While Getting Service Parameters

Symptom

Probable Cause

Corrective Action

IPMAConsoleInstall.jsp Displays Error: No Page Found Error

Symptom

Probable Cause

Corrective Action

Symptom

Probable Cause

Corrective Action

Symptom

Probable Cause

Corrective Action

Symptom

Probable Cause

Corrective Action

Exception: java.lang.ClassNotFoundException: InstallerApplet.class

Symptom

Probable Cause

Corrective Action

Automatic Installation of MS Virtual Machine Is No Longer Provided for Download

Symptom

Probable Cause

Corrective Action

User Authentication Fails

Symptom

Probable Cause

Corrective Action

Assistant Console Displays Error: Cisco IPMA Service Unreachable

Symptom

Probable Cause

Corrective Action

Symptom

Probable Cause

Corrective Action

Symptom

Probable Cause

Corrective Action

New Manager Is Not Created As Expected

Symptom

Probable Cause

Corrective Action

Assistant Assignment Does Not Change As Expected

Symptom

Probable Cause

Corrective Action

Assistant Proxy Lines Contain Blank Fields for Manager

Symptom

Probable Cause

Corrective Action

Manager Or Assistant Search Is Slow

Symptom

Probable Cause

Corrective Action

Calls Do Not Get Routed When Filtering Is On Or Off

Symptom

Probable Cause

Corrective Action

Symptom

Probable Cause

Corrective Action

Symptom

Probable Cause

Corrective Action

Symptom

Probable Cause

Corrective Action

Updated User Information Is Lost

Symptom

Probable Cause

Corrective Action

Symptom

Probable Cause

Corrective Action

Symptom

Probable Cause

Corrective Action

Manager Is Logged Out While the Service Is Still Running

Symptom

Probable Cause

Corrective Action

Manager Cannot Intercept the Calls That Are Ringing on the Assistant Proxy Line

Symptom

Probable Cause

Corrective Action

Troubleshooting Cisco CallManager AutoAttendant

No Matches for an Existing User

Symptom

Probable Cause

Corrective Action

Cisco CallManager AutoAttendant Prompt Is Not Found

Symptom

Probable Cause

Corrective Action

IP IVR Server Does Not Start After Cisco CallManager Upgrade

Symptom

Probable Cause

Corrective Action

JTAPI Subsystem Is in Partial Service

Symptom

Probably Cause

Corrective Action

Cisco CallManager Automated Attendant Prompt Is Not Played

Symptom

Possible Cause

Corrective Action

Dial By Name Does Not Find the Specified User

Symptom

Probable Cause

Corrective Action

Uploaded the Spoken Name, But it Keeps Spelling the Name

Symptom

Probable Cause

Corrective Action

Digits Entered, But Announcement Continues When Calling From an IOS Voice Gateway

Symptom

Probably Cause

Corrective Action

User Does Not Hear Announcements: If User Dials 1 and Then Extension Followed by Hash (#), Call Gets Through to User

Symptom

Probable Cause

Corrective Action

Cannot Dial Using G.729 Codec

Symptom

Probable Cause

Corrective Action

Troubleshooting Barge

No Conference Bridge Available

Symptom

Probable Cause

Corrective Action

Troubleshooting Immediate Divert

Key is not active

Symptom

Probable Cause

Corrective Action

Temporary Failure

Symptom

Probable Cause

Corrective Action

Busy

Symptom

Probable Cause

Corrective Action

Troubleshooting Cisco WebDialer

Authentication Error

Probable Cause

Corrective Action

Service Temporarily Unavailable

Probable Cause

Corrective Action

Directory Service Down

Probable Cause

Corrective Action

Cisco CTIManager Down

Probable Causes

Corrective Action

Session Expired, Please Login Again

Probable Cause

Corrective Action

User Not Logged in on Any Device

Probable Cause

Corrective Action

Failed to Open Device/Line

Probable Cause

Corrective Action

Destination Not Reachable

Probable Cause

Corrective Action


Troubleshooting Features and Services


This appendix provides information to help you resolve common issues with Cisco CallManager features and services:

Troubleshooting Cisco CallManager Extension Mobility

Troubleshooting Cisco IP Manager Assistant

Troubleshooting Cisco CallManager AutoAttendant

Troubleshooting Barge

Troubleshooting Immediate Divert

Troubleshooting Cisco WebDialer

Troubleshooting Cisco CallManager Extension Mobility

Cisco CallManager Extension Mobility provides troubleshooting tools for the administrator. These tools include performance counters and alarms that are part of Cisco CallManager Serviceability. For more information about performance counters and alarms, refer to the Cisco CallManager Serviceability System Guide and the Cisco CallManager Serviceability Administration Guide.

This section provides the following information to help you troubleshoot problems with Cisco CallManager Extension Mobility:

Troubleshooting General Problems with Cisco CallManager Extension Mobility

Troubleshooting Cisco CallManager Extension Mobility Error Messages

Troubleshooting General Problems with Cisco CallManager Extension Mobility

If any problems occur with Cisco CallManager Extension Mobility, start with these troubleshooting tips:

Logs are created for both the Cisco Extension Mobility service and the Cisco Extension Mobility application. Locate the trace files at:

C:\ProgramFiles\Cisco\Trace\EM\<xxx>.txt

where <xxx> is the name of the Cisco Extension Mobility service or the Cisco Extension Mobility application.


Note This location specifies the default log file. You can send your trace files to any directory you create.


Configure the Cisco CallManager Extension Mobility trace directory and enable debug tracing by choosing:

Cisco CallManager Administration > Application > Serviceability > Trace > Configuration

Choose Host Server from the left pane of the web page and select Cisco Extension Mobility from the dropdown menu of Configured Services.

Make sure that you entered the correct URL for the Cisco Extension Mobility service. Remember that the URL is case sensitive. See the "Adding the Cisco Extension Mobility Service" section on page 1-22.

Check that you have thoroughly and correctly performed all the configuration procedures in the "Configuring Cisco CallManager Extension Mobility" section on page 1-18.

If a problem occurs with authentication of a Cisco CallManager Extension Mobility user, go to the user pages and verify the PIN.

If you are still having problems, use the troubleshooting solutions in Table A-1.

Table A-1 Troubleshooting Cisco CallManager Extension Mobility 

Problem Description
Recommended Action

After a user logs out and the phone reverts to the default device profile, the user finds that the phone services are no longer available.

1. Check the Enterprise Parameters to make sure that the Synchronization Between Auto Device Profile and Phone Configuration is set to True.

2. Subscribe the phone to the Cisco Extension Mobility service.

After logging in, the user finds that the phone services are not available.

This problem means that the User Profile did not have any services associated with it when the profile was loaded on the phone.

Perform the following steps:

1. Change the User Profile to include the Cisco Extension Mobility service.

2. Change the phone configuration where the user is logged in to include Cisco Extension Mobility. After the phone is updated, the user can access the phone services.

After performing a login or logout, the user finds that the phone resets instead of restarting.

Locale change may provide the basis for reset.

If the User Locale that is associated with the login user or profile is not the same as the locale or device, after a successful login, the phone will perform a restart that is followed by a reset. This occurs because the phone configuration file is being rebuilt.


Troubleshooting Cisco CallManager Extension Mobility Error Messages

Use the information in Table A-2 to troubleshoot the error codes and error messages that display on the phone when Cisco CallManager Extension Mobility is used.

Table A-2 Troubleshooting Error Messages That Display on the Phone 

Error Code or
Error Message
Recommended Action

0

When a user tries to log in to a phone that is configured for Cisco CallManager Extension Mobility and enters UserID and PIN, the phone displays "0."

Verify that all the Cisco CallManager services are running.

2, 3

When a user presses the Services button, the phone displays "2" or "3."

Check the registry entry of the Cisco CallManager Extension Mobility:

HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems Inc.\
Directory Configuration\AppUsers\EMApp.

Make sure that an entry for "Password" exists and that the "UserID" is "EMApp." If these entries are not there, a problem exists with the installation.

6

When a user tries to log in to a phone that is configured for Cisco CallManager Extension Mobility and enters UserID and PIN, the phone displays "6."

This error occurs when the service is not authenticating the user.

A problem may exist with Virtual Directory. Verify that the Virtual Directory Login Password is correct.

9

When a user tries to log in to a phone that is configured for Cisco CallManager Extension Mobility and enters UserID and PIN, the phone displays "9."

A problem exists with the LDAP Directory. Check that the DirUser.jar file is present.

6, 12

When a user tries to log in to a phone that is configured for Cisco CallManager Extension Mobility and enters UserID and PIN, the phone displays "6" or "12."

Make sure that a Device Profile associates with the user. See "Subscribing Cisco IP Phones to Cisco CallManager Extension Mobility" section on page 1-34.

100

When a user presses the Services button, the phone displays "100."

The URL for the Cisco Extension Mobility service does not include the last parameter (shown below in bold):

http://<IPAddressofCallManager>/emapp/EMAppServlet
?device=#DEVICENAME#

where <IPAddressofCallManager> specifies the IP Address of the Cisco CallManager server where Cisco CallManager Extension Mobility is installed.

Make sure that the URL is correct and complete. Be aware that the URL is case sensitive. See the "Adding the Cisco Extension Mobility Service" section on page 1-22.

101

When a user tries to log in to a phone that is configured for Cisco CallManager Extension Mobility and enters UserID and PIN, the phone displays "101."

The IP address of the Cisco CallManager publisher may have changed. Perform the following steps:

1. In the DC Directory (DCD) Administration, go to Cisco.com > CCN > systemProfiles.

2. Choose Hoteling Profile.

3. Verify that the IP address in the URL field is the IP address of the Cisco CallManager publisher.

HTTP error

If this error message displays after a user presses the Services button, a phone load error exists.

To correct this problem, apply the latest phone loads from Cisco.com and reset the phone.

Invalid host

When a user presses the Services button, the phone displays either an "Invalid host" message or a blank screen.

1. Check that the Services URL entry in the Enterprise Parameters is correct. See the "Adding the Cisco Extension Mobility Service" section on page 1-22.

2. If there is still a problem, reset the phone.

No services configured

When a user presses the Services button, the phone displays "No services configured."

Check that the Cisco Extension Mobility service is subscribed to for the phone and that the user device profile is chosen. See the "Subscribing Cisco IP Phones to Cisco CallManager Extension Mobility" section on page 1-34.

Requesting...

After the user presses the Services button and chooses the Cisco Extension Mobility Service, the phone displays "Requesting..."

Check that the Cisco Tomcat Service (on the Cisco CallManager server where Cisco CallManager Extension Mobility is located) has started and is running.

Authentication error

After a user enters UserID and PIN, the phone displays "Requesting..."

The user should check that the correct UserID and PIN were entered; the user should check with the system administrator that the UserID and PIN are correct.

If you are using the Active Directory Plug-in, make sure that the user is shown directly underneath the User Base and not under a Sub-OU of the User Base.

Device does not allow logon

When a user tries to log in to a phone that is configured for Cisco CallManager Extension Mobility and enters UserID and PIN, the phone displays "Device does not allow logon."

Make sure that you have chosen "Enable Extension Mobility Feature" on the phone configuration window. See the "Subscribing Cisco IP Phones to Cisco CallManager Extension Mobility" section on page 1-34.

Device profile unavailable

The Cisco CallManager  Directory may be down.

User logged in elsewhere

This error means that the service parameter that controls multiple logins is set to allow login at a single device, and a user tries to log in at a second device.

Perform one of the following steps:

If the configuration is correct, you can log out the user from the first device and ask the user to log in on the second device. You can also explain the single login policy to the user to prevent this from happening again.

To allow users to log in at multiple devices, on the Service Parameters Configuration window, set the Multiple Login Behavior field to Multiple Logins Allowed. See the "Setting the Service Parameters" section on page 1-24.


Troubleshooting Cisco IP Manager Assistant

This section covers solutions for the most common issues that relate to Cisco IP Manager Assistant (Cisco IPMA). Table A-3 describes troubleshooting tools for Cisco IPMA and the client desktop.

Table A-3 Cisco IPMA Troubleshooting Tools and Client Desktop 

Tool Description
Location

Cisco IPMA server trace files

C:\Program Files\Cisco\Trace\IPMA\IPMA*.txt

Note This URL specifies the default log file. You can send your trace files to any directory that you create.

Configure the IPMA trace directory and enable debug tracing by choosing

Cisco CallManager Administration > Application > Serviceability > Trace > Configuration

Cisco IPMA client trace files

$INSTALL_DIR\logs\ACLog*.txt
on the client desktop in the same location where the Cisco IPMA assistant console resides.

To enable debug tracing, go to the settings dialog box in the assistant console. In the advanced panel, check the Enable Trace check box.

Note This action only enables debug tracing. Error tracing always remains On.

The location and the name of the current trace file display in the dialog box.

Cisco IPMA client install trace files

$INSTALL_DIR\InstallLog.txt
on the client desktop in the same location where the Cisco IPMA assistant console resides.

Cisco IPMA Client AutoUpdater trace files

$INSTALL_DIR\UpdatedLog.txt
on the client desktop in the same location where the Cisco IPMA assistant console resides.

Install directory

By default
C:\Program Files\Cisco\IPMA Assistant Console


The following sections describe Cisco IPMA error and recovery procedures:

IPMAConsoleInstall.jsp Displays Error: Exception While Getting Service Parameters

IPMAConsoleInstall.jsp Displays Error: No Page Found Error

Exception: java.lang.ClassNotFoundException: InstallerApplet.class

Automatic Installation of MS Virtual Machine Is No Longer Provided for Download

User Authentication Fails

Assistant Console Displays Error: Cisco IPMA Service Unreachable

New Manager Is Not Created As Expected

Assistant Assignment Does Not Change As Expected

Assistant Proxy Lines Contain Blank Fields for Manager

Manager Or Assistant Search Is Slow

Calls Do Not Get Routed When Filtering Is On Or Off

Updated User Information Is Lost

Manager Is Logged Out While the Service Is Still Running

Manager Cannot Intercept the Calls That Are Ringing on the Assistant Proxy Line

IPMAConsoleInstall.jsp Displays Error: Exception While Getting Service Parameters

Symptom

http://<server-name>/ma/Install/IPMAConsoleInstall.jsp displays the following error message:

Error Message    Exception While Getting Service Parameters

Probable Cause

An error occurred in the configuration of Cisco IPMA service parameters.

Corrective Action

Configure Cisco IPMA service parameters from

Cisco CallManager Administration > Service > Service Parameters. Choose the server where the Cisco IPMA service resides; then, choose the Cisco IP Manager Assistant service.

IPMAConsoleInstall.jsp Displays Error: No Page Found Error

Symptom

http://<server-name>/ma/Install/IPMAConsoleInstall.jsp displays the following error message:

Error Message    No Page Found Error

Probable Cause

Cisco IPMA service is not running.

Corrective Action

Start the Cisco IP Manager Assistant by using the following procedure.

Procedure


Step 1 Restart the IPMA service by logging in to the Cisco Tomcat manager application at the following address and by using administrative privileges:

http://<ipaddress>/manager/list

Step 2 Click the Reload link next to the Cisco IP Manager Assistant service.

Step 3 The service starts.


Symptom

http://<server-name>/ma/Install/IPMAConsoleInstall.jsp displays the following error message:

Error Message    No Page Found Error

Probable Cause

IIS service is not running.

Corrective Action

Use the following procedure to start the IIS.


Note If the IIS is stopped, the FTP publishing service and the WWW publishing services may also be stopped. Start the FTP and the WWW publishing services first; then, start the IIS by using the following procedure.


Procedure


Step 1 From the Start menu, choose Start > Programs > Administration Tools > IIS Administration Service.

A window displays and lists IIS Administration.

Step 2 Choose IIS Administration Service.

Step 3 Click Start.

Step 4 Click Yes.

The IIS starts.


Symptom

http://<server-name>/ma/Install/IPMAConsoleInstall.jsp displays the following error message:

Error Message    No Page Found Error

Probable Cause

Network problems. For more information on system issues, refer to the Troubleshooting Guide for Cisco CallManager.

Corrective Action

Ensure that the client has connectivity to the server. Ping the server name that is specified in the URL and verify that it is reachable.

Symptom

http://<server-name>/ma/Install/IPMAConsoleInstall.jsp displays the following error message:

Error Message    No Page Found Error

Probable Cause

Misspelled URL.

Corrective Action

Because URLs are case sensitive, ensure that the URL matches exactly what is in the instructions.

Exception: java.lang.ClassNotFoundException: InstallerApplet.class

Symptom

The Assistant Console fails to install from the web. The following error message displays:

Error Message    Exception: java.lang.ClassNotFoundException: 
InstallerApplet.class

Probable Cause

Using the Sun Java plugin virtual machine instead of the Microsoft JVM with the standard IPMA Console install causes failures.

Corrective Action

The administrator directs the user to the following URL, which is a JSP page that supports the Sun Java plugin:

http://<servername>/ma/Install/IPMAConsoleInstallJar.jsp

Automatic Installation of MS Virtual Machine Is No Longer Provided for Download

Symptom

The Assistant Console fails to install from the web when you are trying to install on a computer that is running Microsoft Windows XP. A message displays that all the components for the program are not available. When the user chooses Download Now, the following message displays:

Error Message    Automatic installation of MS Virtual Machine is no 
longer available for download

Probable Cause

Microsoft does not support Microsoft JVM in IE version 6 of Windows XP.


Note This error does not occur if you have the Microsoft JVM with XP Service Pack 1 installed on your system.


Corrective Action

Perform one of the following corrective actions:

Install the Netscape browser (version 4.7x or 6.x) and use Netscape to install the Assistant Console.

Install the Sun Java Virtual Machine plugin for IE from the following URL:

http://java.sun.com/getjava/download.html

When the Sun Java plugin completes installation, point the browser at the following URL:

http://<servername>/ma/Install/IPMAConsoleInstallJar.jsp

Install the Microsoft Java Virtual Machine (JVM) with Windows XP Service Pack 1 before the Assistant Console installation.

User Authentication Fails

Symptom

User authentication fails when you sign in on the login screen from the assistant console.

Probable Cause

The following probable causes can apply:

Incorrect administration of the user in the directory.

Incorrect administration of the user as an assistant or a manager.

Corrective Action

Ensure that the user ID and the password are administered as a Cisco CallManager user through Cisco CallManager Administration.

You must administer the user as an assistant or a manager by associating the Cisco IPMA information, which you access through Cisco CallManager Administration > User.

Assistant Console Displays Error: Cisco IPMA Service Unreachable

Symptom

After launching the Assistant Console, the following message displays:

Error Message    Cisco IPMA Service Unreachable

Probable Cause

Cisco IPMA service may be stopped.

Corrective Action

Start the Cisco IP Manager Assistant by using the following procedure.

Procedure


Step 1 Restart the IPMA service by logging in to the Cisco Tomcat manager application at the following address and by using administrative privileges:

http://<ipaddress>/manager/list

Step 2 Click the Reload link next to the Cisco IP Manager Assistant service.

Step 3 The service starts.


Symptom

After launching the Assistant Console, the following message displays:

Error Message    Cisco IPMA Service Unreachable

Probable Cause

The server address for the Primary and Secondary Cisco IPMA servers may be configured as DNS names, but the DNS names are not configured in the DNS server.

Corrective Action

Use the following procedure to replace the DNS name.

Procedure


Step 1 Choose Cisco CallManager Administration > System > Server.

Step 2 Replace the DNS name of the server with the corresponding IP address.

Step 3 Restart the IPMA service by logging in to the Cisco Tomcat manager application at the following address and by using administrative privileges:

http://<ipaddress>/manager/list

Step 4 Click the Reload link next to the Cisco IP Manager Assistant service.

Step 5 The service starts.


Symptom

After launching the Assistant Console, the following message displays:

Error Message    Cisco IPMA Service Unreachable

Probable Cause

The Cisco CTI Manager service may be stopped.

Corrective Action

Use the following procedure to start the Cisco CTI Manager and Cisco IPMA services.

Procedure


Step 1 From the Start menu, choose Start > Programs > Administration Tools > Services.

Step 2 Right-click the CTI Manager service.

Step 3 Click Start.

Step 4 Click Yes.

Step 5 Restart the IPMA service by logging in to the Cisco Tomcat manager application at the following address and by using administrative privileges:

http://<ipaddress>/manager/list

Step 6 Click the Reload link next to the Cisco IP Manager Assistant service.

Step 7 The service starts.


New Manager Is Not Created As Expected

Symptom

A new manager was not created in Cisco IPMA.

Probable Cause

You did not click Insert on the Cisco CallManager Administration Manager Configuration window.

Corrective Action

Use the following procedure to properly configure the Cisco IPMA manager.

Procedure


Step 1 Choose User > Global Directory.

Step 2 To search for the manager, click Search.

Step 3 Click the manager name.

Step 4 Click the Cisco IPMA link.

Step 5 From Add/Delete Assistants link, assign assistants.

Step 6 Click Update and Close.

Step 7 From Manager Configuration, enter the device, IPMA controlled lines.

Step 8 Click Insert.


For more information about configuring managers and assistants, see the "Configuring a Manager and Assigning an Assistant for Proxy Line Mode" section on page 2-37.

Assistant Assignment Does Not Change As Expected

Symptom

You change the assignment to a different assistant, but the change does not take effect.

Probable Cause

You did not click Update or Update and Close on the Add/Delete Assistant window.

Corrective Action

Use the following procedure to properly configure the Cisco IPMA assistant.

Procedure


Step 1 Choose User > Global Directory.

Step 2 To search for the manager, click Search.

Step 3 Click the manager name.

Step 4 Click the Cisco IPMA link.

Step 5 Click Add/Delete Assistant link.

Step 6 From Add/Delete Assistant window, choose the assistant for the manager.

Step 7 Click Update or Update and Close.


For more information about configuring managers and assistants, see the "Configuring a Manager and Assigning an Assistant for Proxy Line Mode" section on page 2-37.

Assistant Proxy Lines Contain Blank Fields for Manager

Symptom

Assistant Proxy lines contain blank fields.

Probable Cause

Deleting a manager from an assistant may leave a blank line for the assistant.

Corrective Action

From the Assistant Configuration window, reassign the proxy lines.

Manager Or Assistant Search Is Slow

Symptom

You tried to perform a search, and it is taking time for the system to return the results.

Probable Cause

You tried to search for all managers or all assistants or a large number of each.

Corrective Action

Narrow the search to a smaller subset for faster performance.

Calls Do Not Get Routed When Filtering Is On Or Off

Symptom

Calls do not get routed when filtering is on.

Probable Cause

Cisco CTI Manager service may be stopped.

Corrective Action

Use the following procedure to start the Cisco CTI Manager service and Cisco IPMA (by using Cisco Tomcat manager).

Procedure


Step 1 From the Start menu, choose Start > Programs > Administration Tools > Services.

Step 2 Right-click the CTI Manager service.

Step 3 Click Start.

Step 4 Click Yes.

Step 5 Restart the IPMA service by logging in to the Cisco Tomcat manager application at the following address and by using administrative privileges:

http://<ipaddress>/manager/list

Step 6 Click the Reload link next to the Cisco IP Manager Assistant service.

Step 7 The service starts.


Symptom

You cannot obtain a CTI Provider Object, and the following message displays:

Error Message    TimeoutException - Could not get Provider.

Probable Cause

The error occurs in the logs located at

C:\Program Files\Cisco\Trace\IPMA\IPMA*.txt

or any directory that you created by using Cisco CallManager Serviceability Trace Configuration.

Corrective Action

Use the following procedure to start the Cisco CTI Manager and Cisco IPMA services.

Procedure


Step 1 From the Start menu, choose Start > Programs > Administration Tools > Services.

Step 2 Right-click the CTI Manager service.

Step 3 Click Start.

Step 4 Click Yes.

Step 5 Restart the IPMA service by logging in to the Cisco Tomcat manager application at the following address and by using administrative privileges:

http://<ipaddress>/manager/list

Step 6 Click the Reload link next to the Cisco IP Manager Assistant service.

Step 7 The service starts.


Symptom

Calls do not get routed properly.

Probable Cause

The IPMA route point is not configured properly.

Corrective Action

Use wild cards to match the directory number of the IPMA route point and the primary directory numbers of all Cisco IPMA managers.

Symptom

Calls do not get routed properly. The status window on the manager phone displays the message, Filtering Down.

Probable Cause

IPMA CTI route point may be deleted or may not be in service.

Corrective Action

Use the following procedure to configure the CTI route point and restart the Cisco IPMA service.

Procedure


Step 1 From Cisco CallManager Administration, choose Device > CTI Route Point.

Step 2 Find the route point, or add a new route point. See the Cisco CallManager Administration Guide for configuration details.

Step 3 Restart the IPMA service by logging in to the Cisco Tomcat manager application at the following address and by using administrative privileges:

http://<ipaddress>/manager/list

Step 4 Click the Reload link next to the Cisco IP Manager Assistant service.

Step 5 The service starts.


Updated User Information Is Lost

Symptom

After you restart the service, updated user information gets lost.

Probable Cause

Improper CMDBUtilJNI.dll file exists.

Corrective Action

Use the following procedure to replace the CMDBUtilJNI.dll file.

Procedure


Step 1 Look in the file C:\Program files\Cisco\Trace\MA\initTrace**.txt

The file contains

java.lang.UnsatisfiedLinkError: method name

This means that CMDBUtilJNI.dll does not contain that method.

Step 2 Replace CMDBUtilJNI.dll with the required CMDBUtilJNI.dll.


Symptom

After you restart the service, updated user information gets lost.

Probable Cause

Publisher database is not running.

Corrective Action

Start the publisher database.

Symptom

After you restart the service, updated user information gets lost.

Probable Cause

Publisher directory is not running.

Corrective Action

Start the publisher directory. Refer to the Troubleshooting Guide for Cisco CallManager for more directory information.

Manager Is Logged Out While the Service Is Still Running

Symptom

Although the Cisco IPMA manager is logged out of IPMA, the service still runs. The display on the manager IP phone disappears. Calls do not get routed, although filtering is on. To verify that the manager is logged out, view the application log in the Event Viewer on the Cisco IPMA server. Look for a warning from the Cisco Java Applications that indicates that the IPMA service logged out.

Probable Cause

The manager pressed the softkeys more than four times per second (maximum limit allowed).

Corrective Action

The Cisco CallManager administrator must update the IPMA manager configuration by using User Configuration. Perform the following procedure to correct the problem.

Procedure


Step 1 From Cisco CallManager Administration, choose User > Global Directory.

The User Information search window displays.

Step 2 Enter the manager name in the search field and click the Search button.

Step 3 At the User Information window, choose the manager that you want to update.

Step 4 At the User Configuration window, click the Cisco IPMA link.

Step 5 The User Configuration window for the manager displays. Click the Update button.


Manager Cannot Intercept the Calls That Are Ringing on the Assistant Proxy Line

Symptom

The manager cannot intercept the calls that are ringing on the assistant proxy line.

Probable Cause

The calling search space of the proxy line is improperly configured.

Corrective Action

Check the calling search space of the proxy line for the assistant phone. Perform the following procedure to correct the problem.

Procedure


Step 1 From Cisco CallManager Administration, choose Device > Phone.

The Find and List Phones search window displays.

Step 2 Click the assistant phone.

The Phone Configuration window displays.

Step 3 Verify the calling search space configuration for the phone and for the directory number (line) and update as appropriate. For more information, see the "Configuring a Manager and Assigning an Assistant for Proxy Line Mode" section on page 2-37.


Troubleshooting Cisco CallManager AutoAttendant

This section provides information and solutions for the most common issues that relate to Cisco CallManager AutoAttendant.

No Matches for an Existing User

Cisco CallManager AutoAttendant Prompt Is Not Found

IP IVR Server Does Not Start After Cisco CallManager Upgrade

JTAPI Subsystem Is in Partial Service

Cisco CallManager Automated Attendant Prompt Is Not Played

Dial By Name Does Not Find the Specified User

Uploaded the Spoken Name, But it Keeps Spelling the Name

Digits Entered, But Announcement Continues When Calling From an IOS Voice Gateway

User Does Not Hear Announcements: If User Dials 1 and Then Extension Followed by Hash (#), Call Gets Through to User

Cannot Dial Using G.729 Codec

No Matches for an Existing User

Symptom

A search for an existing user fails in Cisco CallManager AutoAttendant.

Probable Cause

The fact that the ccndir.ini file is missing information or the extension is not valid because the user does not have a primary extension that was assigned in Cisco CallManager Administration could cause symptom.

Corrective Action

To resolve the problem

1. Verify that the user has an entry in the Cisco CallManager AA Name dialing field and that the User record has an associated phone and that the primary extension button is chosen.

2. Verify that the ccndir.ini file contains the following lines:

USERBASE "ou=Users, o=cisco.com"
PROFILEBASE "ou=profiles, ou=CCN, o=cisco.com"

3. If you migrated Cisco CallManager from Version 2.4, a possible schema issue exists. In LDAP Directory Administration, verify that the user Owner field is in UserID format, not fullname format.

Cisco CallManager AutoAttendant Prompt Is Not Found

Symptom

The Cisco CallManager AA prompt is not found.

Probable Cause

The media configuration was not initialized properly.

Corrective Action

Choose Media from the main Application Administration page and verify that the prompt directory is listed as C:\Program Files\cisco\wffavvid\Prompts and that the User Datagram Protocol (UDP) start port is 16384.

IP IVR Server Does Not Start After Cisco CallManager Upgrade

Symptom

The IP IVR server does not start after the Cisco CallManager server is upgraded.

Probable Cause

The Java Telephony API (JTAPI) client must be compatible with the existing version of Cisco CallManager.

Corrective Action

Reinstall the JTAPI plugin from the Cisco CallManager plugins window. Go to Cisco CallManager Administration and choose Application > Install Plugins. Download Cisco JTAPI and install on the IP IVR server.

JTAPI Subsystem Is in Partial Service

Symptom

The Engine Status area in the Engine window shows that the JTAPI subsystem is in partial service.

Probably Cause

The JTAPI client was not set up properly. At least one, but not all, of the CTI ports, route points, or dialog channels (CMT or Nuance) could not initialize.

Corrective Action

Perform the following tasks:

1. Refer to the CRA trace files to determine what did not initialize.

2. Verify that all CTI ports and CTI route points associate with the JTAPI user in Cisco CallManager.

3. Verify that the Cisco CallManager and JTAPI configuration IP addresses match.

4. Verify that the Cisco CallManager JTAPI user controls all the CTI ports and CTI route points.

5. Verify that the LDAP directory is running on the computer that is specified in the Directory Host Name field in the Directory Setup window Configuration Setup area.

6. Verify that the application file was uploaded to the repository that is using the Repository Manager.

Cisco CallManager Automated Attendant Prompt Is Not Played

Symptom

The Cisco CallManager Automated Attendant prompt does not play.

Possible Cause

An incorrect welcome prompt is specified in the welcomePrompt field in the Cisco Script Application window.

Corrective Action

From CRA Administration, choose System > System Parameters. Make sure that the following information appears in the User Prompt Directory field:

C:\program files\cisco\wfavvid\Prompts\User

Dial By Name Does Not Find the Specified User

Symptom

The Cisco CallManager Automated Attendant cannot find a user that a caller specifies when dialing by name.

Probable Cause

The extension of the requested user is not valid because the user does not have a primary extension that is assigned in Cisco CallManager, or the ccndir.ini file is missing information.

Corrective Action

Perform the following tasks:

1. In the Cisco CallManager Administration User Information window, verify that the user has an entry in the AutoAttendant Dialing field, that the User record has an associated phone, and that the Primary Extension radio button is chosen.

2. On the CRA server, verify that the ccndir.ini file contains the correct userbase and profilebase information. For example:

USERBASE "ou=Users, o=cisco.com"
PROFILEBASE "ou=profiles, ou=CCN, o=cisco.com"

Uploaded the Spoken Name, But it Keeps Spelling the Name

Symptom

The spoken name is not used after it has been uploaded,

Probable Cause

The file must be in the CCITT mu-Law, 8.000-kHz, 8-Bit, mono format.

Corrective Action

Refer to http://<server_name>/appadmin/PromptInstruct.htm document on your server for more information.

Digits Entered, But Announcement Continues When Calling From an IOS Voice Gateway

Symptom

The announcement continues when calling from an IOS Voice Gateway after digits have been entered.

Probably Cause

DTMF relay is not configured on the IOS gateway.

Corrective Action

Configure dtmf-relay h245-alphanumeric on the VOIP peers that point to the Cisco CallManager.

dial-peer voice 7000 voip
destination-pattern 2...
session target ipv4:10.200.72.36
dtmf-relay h245-alphanumeric

User Does Not Hear Announcements: If User Dials 1 and Then Extension Followed by Hash (#), Call Gets Through to User

Symptom

The user does not receive the Cisco CallManager AutoAttendant prompts.

Probable Cause

The default system locale is most likely set to a locale other than English (United States).

Corrective Action

If you do not receive the AutoAttendant prompts, you might still get connected (and the calls routed) if you have a default system locale other than English (United States). To verify this, go to Control Panel and double-click Regional Options.

Normally, C:\Program Files\wfavvid\Prompts\user\en_US stores AutoAttendant user prompts; C:\Program Files\wfavvid\Prompts\system\en_US stores system prompts.

If your locale is not English (United States), then

Copy all *.wav files from \user\en_US to C:\Program Files\wfavvid\Prompts\user.

Copy all *.wav files from \server\en_US to C:\Program Files\wfavvid\Prompts\system.

Cannot Dial Using G.729 Codec

Symptom

The user cannot dial using G.729 codec.

Probable Cause

The current version of IP IVR server does not support G.729 codec. G.711 mu-law represents the only supported codec.

Corrective Action

No corrective action exists at this time.

Troubleshooting Barge

This section covers solutions for the following most common issues that are related to the Barge feature. See the "No Conference Bridge Available" section.

No Conference Bridge Available

Symptom

When the Barge softkey is pressed, the message No Conference Bridge Available displays on the IP phone.

Probable Cause

Built in Bridge setting in Phone Configuration for the target phone is not set properly.

Corrective Action

To resolve the problem, perform the following steps:

1. Use Cisco CallManager Administration > Device > Phone > Find the phone to find the phone configuration of the phone that is having the problem.

2. Set the Built In Bridge parameter to On.

3. Click Update.

4. Reset the phone.

Troubleshooting Immediate Divert

This section covers solutions for the following most common issues that are related to the Immediate Divert feature.

Key is not active

Temporary Failure

Busy

Key is not active

Symptom

This message displays on the phone when the user presses iDivert.

Probable Cause

The voice-messaging profile of the user who pressed iDivert does not have a voice-messaging pilot.

Corrective Action

Configure a voice-messaging pilot in the user voice-messaging profile.

Temporary Failure

Symptom

This message displays on the phone when the user presses iDivert.

Probable Cause

The voice-messaging system does not work, or a network problem exists.

Corrective Action

Troubleshoot your voice-messaging system. See troubleshooting or voice-messaging documentation.

Busy

Symptom

This message displays on the phone when the user presses iDivert.

Probable Cause

The voice-messaging system is busy.

Corrective Action

Configure more voice-messaging ports or try again.

Troubleshooting Cisco WebDialer

This section covers error messages for the most common issues that relate to Cisco WebDialer.

Authentication Error

Service Temporarily Unavailable

Directory Service Down

Cisco CTIManager Down

Session Expired, Please Login Again

User Not Logged in on Any Device

Failed to Open Device/Line

Destination Not Reachable

Authentication Error

Probable Cause

User entered wrong userID or password

Corrective Action

Check your userID and password. You must log in using your Cisco CallManager userID and password.

Service Temporarily Unavailable

Probable Cause

The Cisco CallManager service got overloaded because it has reached its throttling limit of two concurrent CTI sessions.

Corrective Action

After a short time, retry your connection.

Directory Service Down

Probable Cause

The Cisco CallManager directory service may be down.

Corrective Action

After a short time, retry your connection.

Cisco CTIManager Down

Probable Causes

Cisco CTIManager service that is configured for Cisco WebDialer is down.

An error exists with the Cisco CallManager directory installation. Cisco WebDialer uses the userID and password in the registry that this directory installation populates to connect the Cisco CTIManager as a super provider.

Corrective Action

After a short time, retry your connection.

Session Expired, Please Login Again

Probable Cause

A Cisco WebDialer session expires

After the WebDialer servlet gets configured or

If the Cisco Tomcat Service is restarted.

Corrective Action

Log in by using your Cisco CallManager userID and password.

User Not Logged in on Any Device

Probable Cause

The user chooses to use Cisco CallManager Extension Mobility from the Cisco WebDialer preference page but is not logged into any IP phone.

Corrective Action

Log in to a phone before using Cisco WebDialer.

Choose a device from the Cisco WebDialer preference list in the dialog box instead of choosing the option Use Extension Mobility.

Failed to Open Device/Line

Probable Cause

The Cisco IP Phone that the user chose is not registered with Cisco CallManager. For example, the user chooses a Cisco IP SoftPhone as the preferred device before starting the application.

The user who has a new phone chooses an old phone that is no longer in service.

Corrective Action

Choose a phone that is in service and is registered with Cisco CallManager.

Destination Not Reachable

Probable Cause

User dialed the wrong number.

The correct dial rules did not get applied. For example, the user dials 5550100 instead of 95550100.

Corrective Action

Check the dial rules.