Cisco Unity Troubleshooting Guide (With Lotus Domino), Release 4.0(2)
Subscriber and Administrator Access

Table Of Contents

Subscriber and Administrator Access

About Access Problems

Subscribers Logging On to Cisco Unity Hear the Opening Greeting Instead of the Subscriber Conversation

Cisco Unity Does Not Respond to Touchtones

Task List for Troubleshooting Problems with Touchtones

DTMF Signal Is Not Being Sent (Cisco CallManager Only)

DTMF Signal Is Not Being Sent (Circuit-Switched Phone Systems Only)

DTMF Values in Cisco Unity Are Inconsistent with the Values in the Phone System (Circuit-Switched Phone Systems Only)

Cisco Personal Communications Assistant Pages Cannot Be Opened or Have Been Defaced

Subscribers Cannot Access Cisco Personal Communications Assistant Pages

Subscribers Cannot Access the Cisco Unity Assistant from the Cisco PCA

No Sounds Play on the Multimedia System After Installing the Cisco CallManager Software

Subscribers Cannot Be Located in a New or Updated Directory Handler

Cisco Unity Tray Icon Is Missing from the Status Bar

Cisco Unity Administrator or Status Monitor Pages Cannot Be Opened or Have Been Defaced


Subscriber and Administrator Access


About Access Problems

Subscriber access problems are usually related to a problem with the phone system integration. Subscriber access problems may include:

Problems that prevent subscribers from using Cisco Unity

See the following sections:

The "Subscribers Logging On to Cisco Unity Hear the Opening Greeting Instead of the Subscriber Conversation" section.

The "Cisco Unity Does Not Respond to Touchtones" section.

Problems that prevent subscribers from fully utilizing the features of Cisco Unity and the phone system

See the following sections:

The "Cisco Personal Communications Assistant Pages Cannot Be Opened or Have Been Defaced" section.

The "Subscribers Cannot Access Cisco Personal Communications Assistant Pages" section.

The "Subscribers Cannot Access the Cisco Unity Assistant from the Cisco PCA" section.

The "No Sounds Play on the Multimedia System After Installing the Cisco CallManager Software" section.

The "Subscribers Cannot Be Located in a New or Updated Directory Handler" section.


Administrator access problems can include a missing tray icon, and missing or defaced web pages. See the "Cisco Unity Tray Icon Is Missing from the Status Bar" section, and the "Cisco Unity Administrator or Status Monitor Pages Cannot Be Opened or Have Been Defaced" section.

If you encounter a subscriber or administrator access problem that is not described in these two chapters, contact the Cisco Technical Assistance Center (TAC).

Subscribers Logging On to Cisco Unity Hear the Opening Greeting Instead of the Subscriber Conversation

Confirm that the integration is enabled and that the phone system settings are correct.

To Verify the Phone System Settings in the Cisco Unity Administrator


Step 1 On the Cisco Unity server, browse to the CommServer\Utilities\Utim directory and double-click Utim.exe. The Cisco Unity Telephony Integration Manager (UTIM) appears.

Step 2 Confirm that the settings match those indicated in the integration guide for your phone system.

Step 3 Correct any incorrect values for the phone system.

Step 4 If you changed values in Step 3, click Save.

Step 5 If prompted, restart the Cisco Unity server.

Step 6 If you have confirmed that the integration is enabled and that the phone system settings are correct, and subscribers still hear the opening greeting instead of the subscriber conversation, contact Cisco TAC.


Cisco Unity Does Not Respond to Touchtones

There are several possible reasons that Cisco Unity may not respond to touchtones. Use the "Task List for Troubleshooting Problems with Touchtones" to troubleshoot the possible causes.

Task List for Troubleshooting Problems with Touchtones

1. (Cisco CallManager only) Confirm that DTMF relay is enabled through VoIP dial-peer gateways. See the "DTMF Signal Is Not Being Sent (Cisco CallManager Only)" section.

2. (Circuit-switched phone systems only) Confirm that the DTMF signal is being sent. See the "DTMF Signal Is Not Being Sent (Circuit-Switched Phone Systems Only)" section.

3. (Circuit-switched phone systems only) Confirm that the DTMF values are consistent with Cisco Unity and the phone system. See the "DTMF Values in Cisco Unity Are Inconsistent with the Values in the Phone System (Circuit-Switched Phone Systems Only)" section.

DTMF Signal Is Not Being Sent (Cisco CallManager Only)

In certain situations, DTMF digits are not recognized when processed through VoIP dial-peer gateways. To avoid this problem, certain gateways must be configured to enable DTMF relay. The DTMF relay feature is available in Cisco IOS software version 12.0(5) and later.

Cisco IOS software-based gateways that use H.245 out-of-band signaling must be configured to enable DTMF relay.

The Catalyst 6000 T1/PRI and FXS gateways enable DTMF relay by default and do not need additional configuration to enable this feature.

To Enable DTMF Relay


Step 1 On a VoIP dial-peer servicing Cisco Unity, use the following command:

dtmf-relay h245-alphanumeric

Step 2 Create a destination pattern that matches the Cisco CallManager voice mail port numbers. For example, if the system has voice mail ports 1001 through 1016, enter the dial-peer destination pattern 10xx.

Step 3 Repeat Step 1 and Step 2 for all remaining VoIP dial-peers servicing Cisco Unity.


DTMF Signal Is Not Being Sent (Circuit-Switched Phone Systems Only)

The first procedure in this section is used only for feature-set phones, because feature-set phones rely on the phone system to generate touchtones, while analog phones generate their own touchtones. For feature-set phones, you may need to enable touchtones on the phone system.

If you are having trouble only with the operator console, skip to the procedure To Test Manual DTMF Signaling on the Operator Console.

If you are using only analog phones to access Cisco Unity and are having trouble with response to touchtones, contact Cisco TAC.

To Test Manual DTMF Signaling on Feature-Set Phones

Do this procedure for each type of feature-set phone that you use to access Cisco Unity.


Step 1 Set up a test phone (Phone 1) for single-line testing. For more information, see the "Preparations for Troubleshooting the Phone System" section on page 1-1.

Step 2 On a feature-set phone that is connected to the phone system but that is not connected to Cisco Unity (Phone 2), call Phone 1. For Phone 2, use a phone that is the same type that subscribers use to access Cisco Unity.

Step 3 Answer Phone 1.

Step 4 On Phone 2, press touchtone keys.

If you hear touchtones on Phone 1, the type of phone you are using for Phone 2 is sending DTMF signals to Cisco Unity. Continue with Step 5.

If you do not hear touchtones, reprogram the phone system to provide station-to-station DTMF signaling on that line, and repeat the test. If you still do not hear touchtones, contact the phone system vendor.

Step 5 Connect a line-monitoring device (for example, a ZiadLinemaster) to Phone 1, and test the duration and volume of the touchtones Phone 2 is generating. Write down the values, and contact Cisco TAC to determine whether touchtone durations in the phone system template file need to be changed. For information on setting up the line-monitoring device, refer to the documentation from the manufacturer.


To Test Manual DTMF Signaling on the Operator Console


Step 1 Do the procedure To Test Manual DTMF Signaling on Feature-Set Phones, but use the operator console for Phone 2.

Step 2 If you hear touchtones on Phone 1, the operator console is sending DTMF signals to Cisco Unity. The reason Cisco Unity is not responding to touchtones is most likely related to the Cisco Unity setup. Contact Cisco TAC.

If you cannot hear touchtones on Phone 1, the operator console is not generating touchtones. Add a tone dialer that generates DTMF tones, and repeat the test.

If you still cannot hear touchtones, contact Cisco TAC.


DTMF Values in Cisco Unity Are Inconsistent with the Values in the Phone System (Circuit-Switched Phone Systems Only)

To Compare Phone System and Cisco Unity Values for DTMF Duration and Delay Between Digits


Step 1 In the phone system documentation or programming, locate the duration of DTMF tones and the delay between digits that the phone system expects from Cisco Unity.

Step 2 On the Cisco Unity server, on the Windows Start menu, click Programs > Cisco Unity > Edit Switch Utility. The Switch Configuration Editor window appears.


Caution Do not use the Edit Switch utility to change values without contacting Cisco TAC for assistance.

Step 3 Confirm that the phone system Cisco Unity is integrated with appears in the fields, then click Edit This Switch Configuration.

Step 4 In the Switch Configuration dialog box, click the Outdial tab.

Step 5 Compare values in the Dialed DTMF Duration and Delay Between Dialed DTMF Digits fields with the the phone system values. If the values do not match, contact Cisco TAC.


Cisco Personal Communications Assistant Pages Cannot Be Opened or Have Been Defaced

If the Cisco Personal Communications Assistant (PCA) installation fails, or if someone inadvertently deletes some or all of the Cisco PCA files from the Cisco Unity server after installation, the Cisco PCA web pages may be defaced or become unusable. Virus incidents and attacks from hackers can cause the same problems.

If you have the Cisco Unity installation disks, you can restore corrupt or missing Cisco PCA files and applications by running an installation script at a command prompt. When you restore the Cisco PCA, the installation script removes any existing Cisco PCA-related files and applications, including the Tomcat service and its integration to the IIS server. In addition, cscoserv_script.log is created (or updated) and stored in the current user temporary file directory. The log file contains information about the restored installation.


Caution Do not use Add/Remove Programs to remove or repair the Cisco PCA files and applications.

To Restore the Cisco PCA Files and Applications


Step 1 On the Cisco Unity server, insert the Cisco Unity DVD or the Cisco Unity CD that contains the cscoserv directory. For example, for the Cisco Unity 4.0(1) release, the cscoserv directory is on Disk 2.

Step 2 Open a command prompt, and change to your DVD or CD-ROM drive.

Step 3 Enter cd cscoserv.

Step 4 Enter setup.js source="<DVD or CD drive>:\cscoserv\setup.msi" target="<Cisco Unity drive>:\commserver".

For example, if your DVD or CD-ROM drive is drive D and Cisco Unity is installed on drive C, enter:

setup.js source="d:\cscoserv\setup.msi" target="c:\commserver" 

Step 5 When the script has finished running, on the Windows Start menu, click Programs > Administrative Tools > Services.

Step 6 Confirm that Tomcat and the World Wide Web Publishing Service are started. If not, restart them.

You do not need to restart the Cisco Unity server to implement your changes.


Subscribers Cannot Access Cisco Personal Communications Assistant Pages

Subscribers use the Cisco PCA website to access the Cisco Unity Assistant. (Note that in version 3.1 and earlier, the Cisco Unity Assistant was known as the ActiveAssistant, or AA.)

When a subscriber cannot access the Cisco Personal Communications Assistant (PCA) pages, consider the following possible causes:

URL Is Case-Sensitive

Subscribers can access the Cisco PCA at the following URL: http://<Cisco Unity server>/ciscopca. Note, however, that the URL is case-sensitive.

Browser Configuration Is Not Correct

When a subscriber cannot access any of the Cisco PCA pages, it may be that the subscriber browser is not configured properly. Make sure that the subscriber browser is configured to:

Enable Active scripting.

Download and run ActiveX controls.

Enable Java scripting.

Accept all cookies.

For a list of supported versions of Cisco Unity combined with the supported versions of the software on client workstations, see the Compatibility Matrix: Cisco Unity and the Software on Subscriber Workstations, available on Cisco.com at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_pre_installation_guides_list.html.

Cisco Unity Uses SSL but the Certificate Has Not Been Distributed to the Trusted Root Store

When Cisco Unity is set up to use SSL, the browser displays a message to alert the subscriber that the authenticity of the Cisco PCA site cannot be verified and therefore, its content cannot be trusted. Subscribers will see this message even if they add the Cisco PCA website to their list of trusted sites for the browser.

To prevent the browser from displaying the security alert, you can:

Distribute the certificate to the trusted root store for all users in the domain by adding it to the Group Policy. Refer to the "Setting Up Cisco Unity to Use SSL" chapter in the Cisco Unity System Administration Guide.

Tell subscribers how to add the certificate to the trusted root store on their own computers. Refer to the "Setting Up Client Applications" chapter in the Cisco Unity System Administration Guide.

The Cisco Unity System Administration Guide is available on Cisco.com at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/products_administration_guide_books_list.html.

Discuss the two options with the network administrator for your organization to determine which is best for your site.

Subscribers Cannot Access the Cisco Unity Assistant from the Cisco PCA

When subscribers can access the Cisco PCA, but cannot access the Cisco Unity Assistant, confirm that subscribers have been given the proper class of service rights on the Subscribers > Class of Service > Features Page in the Cisco Unity Administrator.

Finally, note that the Media Master control bar, which appears on the Cisco Unity Assistant pages, is not available across a firewall.

No Sounds Play on the Multimedia System After Installing the Cisco CallManager Software

When a multimedia system is installed on the Cisco Unity server, registry entries for the multimedia system wave driver may be overwritten when you install the Cisco wave driver. If this happens, the multimedia system no longer plays sounds. Contact Cisco TAC.

Subscribers Cannot Be Located in a New or Updated Directory Handler

Subscribers or outside callers may report that they are unable to locate one or more subscribers in a recently created or updated directory handler. When a directory handler is set to search by a distribution list, the membership is synchronized from the IBM Lotus Notes Directory into the Cisco Unity SQL database. Changing the distribution list that the directory handler searches on requires synchronization. The synchronization takes place when the Cisco Unity directory services (AvDSAD and AvDSGlobalCatalog) poll the directory for any changes to be applied to the SQL database, which usually occurs within 15 to 20 minutes after the change is made on the Directory Hander Search Options page in the Cisco Unity Administrator.

To initiate an immediate synchronization, do the following procedure.

To Manually Synchronize the Cisco Unity Database


Step 1 In the Cisco Unity Administrator, go to the System > Configuration > Settings page.

Step 2 In the Replicate Cisco Unity Directory Objects section, click Changed Objects.

The Settings page is refreshed and the database changes will be synchronized in the background.

Step 3 Wait a few minutes, then call in to Cisco Unity to confirm that the subscribers can be located in the directory handler.

Step 4 If the subscribers still can not be located, confirm that they have recorded names. Subscribers must have recorded names to be accessed by using directory handlers.


Another way to update directory handlers is to change the membership of a distribution list by which one or more directory handlers are scoped. Changes made to distribution list membership by using the Cisco Unity Administrator are updated in the Cisco Unity database within a few minutes. However, in complex networked sites, the replication process may take much longer. This is a function of network complexity and varies from site to site. The network replication process time is not a function of Cisco Unity directory synchronization services, and it is not possible to reduce this time by using the previous procedure.

Cisco Unity Tray Icon Is Missing from the Status Bar

To Manually Start the Cisco Unity Tray Icon


Step 1 Browse to the CommServer directory.

Step 2 Run AvCsTrayStatus.exe. The tray icon will be restored.


Cisco Unity Administrator or Status Monitor Pages Cannot Be Opened or Have Been Defaced

Virus incidents and attacks from hackers can cause the Cisco Unity Administrator or Status Monitor pages to be defaced or to become unusable. You can restore these pages by doing one of the following:

Run the Cisco Unity install again. Refer to the Cisco Unity Installation Guide for instructions (this guide is available on Cisco.com at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/products_installation_guides_books_list.html).

Manually restore the applicable files from the Cisco Unity discs by using the following procedure.

For information on restoring defaced or unusable Cisco Personal Communications Assistant (PCA) pages, see the "Subscribers Cannot Access Cisco Personal Communications Assistant Pages" section.

To Manually Restore the Cisco Unity Administrator or Status Monitor Pages


Step 1 From Cisco Unity Disc 1, copy the Web directory to the CommServer directory on the Cisco Unity server. In the Confirm Folder Replace window, click Yes to All.

Step 2 For US English, from Cisco Unity Disc 1, copy the Localize\Web directory to the CommServer directory on the Cisco Unity server. In the Confirm Folder Replace window, click Yes to All.

Step 3 For each additional language, locate the Cisco Unity disc on which the language files are stored. Repeat Step 2. In the Confirm Folder Replace window, click Yes to All.