Troubleshooting Guide for Cisco CallManager, Release 4.0(1)
Directory Issues

Table Of Contents

Directory Issues

Replication Issues

DC Directory Stability

DCD Instability

Symptom

Probable Cause

Corrective Action

Verification

Application Profiles Are Not Shown for User Configuration with the DC Directory

Symptom

Probable Cause

Corrective Action

Verification

Add a New User Does Not Work and You Cannot Access the DC Directory Administrator

Symptom

Probable Cause

Corrective Action

Verification

Related Information


Directory Issues


This chapter covers the solutions for the most common issues related to a Cisco CallManager DC Directory (DCD), which uses a Lightweight Directory Access Protocol (LDAP) directory, and the Microsoft Active Directory (AD).

This chapter covers the following directory issues:

DC Directory Stability

Application Profiles Are Not Shown for User Configuration with the DC Directory

Add a New User Does Not Work and You Cannot Access the DC Directory Administrator

If the following procedures do not solve your directory issues, contact TAC for a more detailed investigation.


Caution Using Katakana, Cyrillic, or other double-byte character sets with DC Directory, Netscape Directory, or Active Directory can cause directory database errors. This release of Cisco CallManager does not support using any double-byte character set with any directory.

For IP phone directory issues, refer to the following URL for detailed information:

http://www.cisco.com/univercd/cc/td/doc/product/voice/c_ipphon/index.htm

Replication Issues

For replication issues, see "Cisco CallManager System Issues" and the section Replication Fails Between the Publisher and the Subscriber.

DC Directory Stability

The DCD Instability procedure is valid for Cisco CallManager servers running versions 3.0(5a) - 3.3(2c).


Note Do not use this procedure for Cisco CallManager 3.3(3) and above.


DCD Instability

Symptom

The following issues relate to the instability of the DCD:

Cisco CallManager publisher server has correct user data and one or more Cisco CallManager subscriber servers either do not have user data or the user data is out of date with the Publisher's database.

DC Directory Service on the Cisco CallManager publisher server takes a long time to start-up (appears to stall/hang on startup).

DC Directory Replication errors are logged to the Cisco CallManager publisher and/or subscriber server(s) in the Application Event Viewer.

Probable Cause

Examination of C:\dcdsrvr\run\dcx500\dcx500.out shows duplicate and/or invalid replication agreements.

The presence of invalid replication agreements causes the DC Directory database (files in C:\dcdsrvr\run\dcx500\database) to grow extremely large (over 100 MB), which results in the DC Directory to taking a large amount of time to shutdown and startup.

These duplicate and invalid agreements are caused by one of the following:

The customer reinstalling the Cisco Customer Response Application (CRA) server (or a Cisco CallManager subscriber) one or more times (each reinstall of CRA server/Cisco CallManager server will cause the publisher to have a new replication agreement to the subscriber).

Decommissioning an existing CRA server (or a Cisco CallManager subscriber) without performing the DC Directory reconfiguration procedure in the Cisco CallManager cluster.


Note When removing a directory node from a Cisco CallManager cluster, the DC Directory replication agreements to the removed subscriber are not automatically cleaned up.


Manually running the avvid_scfg command on the subscriber more than once (for instance, a partial DC Directory reconfiguration procedure was attempted).


Warning Never perform a partial DC Directory reconfiguration procedure, (for example, run avvid_scfg without a preceding cleandsa on the publisher and the CRA server and/or Cisco CallManager subscriber).


The root cause of the database growing to such large sizes is that DC Directory tries to save state for each and every replication operation that it fails to perform. Over a period of time this saved state information for the invalid replication agreements causes the database to grow to several hundred MBs.

DcDirectory replication should not be confused with SQLServer replication. They are two completely independent processes.

If you perform a reinstallation of a Cisco CallManager subscriber or CRA server 2.2(4) and earlier or CRA server 3.0(1) you must perform the DC Directory reconfiguration procedure on all of the nodes in the cluster, including the standalone CRA servers, starting with the DC Directory publisher.

Corrective Action

While performing these tasks, it is required to be either directly at the console of the Media Convergence Server (MCS) servers, connected through a Keyboard/Video/Mouse (KVM) switch, or connected via Telnet to the servers. Performing these specific tasks while connected through a Terminal Services Client connection has not been fully tested and may produce unexpected results.


Note Cisco recommends that you schedule a downtime to run the procedure.


The two steps involved are:

Installation

Reconfiguration

Installation


Step 1 Download DCDScripts.1-0-5.exe from the Cisco CallManager Version 3.2 ( registered customers only) website.

Step 2 Copy and run DCDScripts.1-0-5.exe on all the nodes in the Cisco CallManager cluster and on the CRA/CRS application servers. Accept the default settings when prompted to do so and click Unzip.


Reconfiguration

There are two possible scenarios when you go to reconfigure your DC Directory after installation.


Step 1 When the DC Directory database is larger than 100 Mb, refer to the Reconfiguring DC Directory on Cisco CallManager Publisher (database more than 100 Mb) section.

Step 2 When the DCD database is less than 100 Mb, refer to the Reconfiguring DC Directory on Cisco CallManager Publisher (database less than 100 Mb) section.


Reconfiguring DC Directory on Cisco CallManager Publisher (database more than 100 Mb)

These steps ensure that your user data in DC Directory on the publisher Cisco CallManager server is backed up in case of a failure during these steps or otherwise when the DC Directory database is larger than 100 Mb (C:\dcdsrvr\run\dcx500\database).


Step 1 Backup your current directory information by either using the MCS backup utility or running the dcbckdib /y backup C:\dcdsrvr\backup command from a DOS command prompt.


Note The C:\dcdsrvr\backup folder must exist prior to running the preceding command.


Step 2 On the Publisher server, while logged in as the Administrator, open a command prompt by selecting Start > Run and entering cmd.

Step 3 Type the command avvid_migrate_save.cmd <servername><password> and press any key when prompted.

The output of this command will look similar to the following:

C:\>avvid_migrate_save jayas-w2k ciscocisco
A subdirectory or file C:\dcdsrvr\log already exists.

****************************************
*                                      *
* -- CISCO User Preferences Support -- *
*                                      *
****************************************

A subdirectory or file C:\dcdsrvr\suspense already exists.

Run the perl script avvid_migrate_save.pl
A subdirectory or file C:\dcdsrvr\log already exists.
A subdirectory or file 
C:\dcdsrvr\run\DCX500\config\Migration-Backup already
exi
sts.
Saving User Information...
Saving Profile Information...
Saving Apps20 Information...
Saving Admin Information...
Saving PA node Information...
Saving E911 node Information...
Saving systemProfile...
Saving MITRA data...
Saving Groups data...


C:\>

Step 4 Stop the DC Directory service by entering net stop dcdirectory from the command prompt.

Step 5 Run cleandsa.cmd or run deletedib.cmd if cleandsa.cmd reports that it is not supported.

Step 6 Run avvid_migrate_cfg.exe. (Usage: avvid_migrate_cfg "<password>")

Step 7 Run avvid_migrate_restore.cmd. (Usage: avvid_migrate_restore <Server Name> <DCDpassword>)

Step 8 Run reconfig_cluster.cmd. (Usage: reconfig_cluster <DCDAdminPassword>)

This command establishes replication agreements to all Cisco CallManager subscribers; there is no need to perform any tasks on any of the Cisco CallManager subscribers.


Reconfiguring DC Directory on Cisco CallManager Publisher (database less than 100 Mb)

Use the following procedure to reconfigure DC Directory in the Cisco CallManager publisher when the DCD database is less than 100 Mb (C:\dcdsrvr\run\dcx500\database).

Procedure


Step 1 Run reconfig_cluster.cmd.

Step 2 This command establishes replication agreements to all Cisco CallManager subscriber servers; no additional steps need to be performed on any of the Cisco CallManager subscribers.


Reconfiguring DC Directory on the CRA/CRS Server

Use the following procedure to reconfigure the DC Directory on the CRA/CRS server.

Procedure


Step 1 Stop DC Directory service.

Step 2 Run cleandsa.cmd or run deletedib.cmd if cleandsa.cmd reports that it is not supported.

Step 3 Run avvid_scfg.cmd. (Usage: reconfig_cluster <DCDAdminPassword>)


Note If the network has a single Cisco CallManager server with or without co-located CRA/CRS, run reconfig_cluster.cmd. In this case, do not run the steps listed for the Cisco CRA/CRS server.



Note If you upgrade, reinstall, or add a new Cisco CallManager server 3.2(2c) and earlier, or CRA 2.2(4) or earlier, and CRA 3.0(1), you must copy and run DCDScripts.1-0-5.exe as described in the Installation section.



Verification

Use the following procedure to verify that the DCD is stable and efficiently running.

Procedure


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

Step 2 Search for users.


Application Profiles Are Not Shown for User Configuration with the DC Directory

Symptom

When you are adding a user to the directory, the Application Profiles (such as AutoAttendant, Softphone, and Extension Mobility) do not display, and a user cannot be linked to those profiles.

Probable Cause

The Application Profiles were configured incorrectly.

Corrective Action

Use the following procedure to configure the application profile, so you can add or view users in the DC Directory.

Procedure


Step 1 Connect to the DC Directory Administrator.

Step 2 Choose Directory > cisco.com > CCN.

Step 3 Click systemProfile.

Step 4 Right-click systemProfile and choose Properties.

Step 5 Click the Application Install Status tab.

Step 6 Check the values for the applications. If the values for "AA Installed," "Softphone Installed," "ASR Installed," and "Hotelling Installed" are blank, go to Step 7.

Otherwise, proceed to Step 11.

Step 7 Choose Modify.

Step 8 Change the values from true to false and those that are false to true.

Step 9 Click Apply.

Step 10 Click OK.

Step 11 Repeat Step 4 and Step 5.

Step 12 Click Modify.

All values should be visible.

Step 13 Change the value of the installed applications to true.

Step 14 Click Apply.

Step 15 Click OK.

Step 16 Click Services.

Step 17 In the right panel, choose World Wide Web Publishing Service.

Step 18 Click the Restart Service icon.

Step 19 Repeat all steps for all servers in the cluster in which you experienced the problem.


Verification

The Application Profiles display in the DC Directory.

Add a New User Does Not Work and You Cannot Access the DC Directory Administrator

Symptom

You cannot add a user from Cisco CallManager Administration. Also, cannot log in to the DC Directory Administrator.

Adding a new user returns the following error.

Error Message    Sorry your session object has timed out. Click here 
to Begin a New search.

Searching for a new user results in the page refreshing and waiting for input.

Probable Cause

The Directory Manager user password contains special characters, such as "^".

Corrective Action

Use the following procedure to change the DC Directory password to one that does not contain special characters.


Note You must have superuser account privileges before you can change the DC Directory Manager password.



Note When you have a publisher server and one or more subscriber servers in a cluster, you must perform the steps in the following procedures on all Cisco CallManagers within the cluster.


Procedure


Step 1 From Cisco CallManager Administration, choose Start > Programs > DC Directory Administrator.

Step 2 Click Next.

Step 3 In the Password field, enter the default password, cisco, and click Finish.

The DC Directory Administrator window displays.

Step 4 From the Tools menu, choose Change Password.

The Change User Password window appears.

Step 5 In the Old Value field, enter cisco.

Step 6 In the New Value field, enter a new password, without special characters.

Step 7 In the Confirm New Value field, reenter your new password.

Step 8 Click OK.

The DC Directory password is changed.

Step 9 Continue with Configuring the Windows Registry.


Cisco CallManager Administration also uses the Directory Manager account to perform add, remove, or update operations on the DC Directory LDAP server.

Configuring the Windows Registry

Use the following procedure to update the information that is stored in the registry to ensure that the registry is pointing to the correct directory.

Procedure


Step 1 Open a command line and enter c:\dcdsrvr\bin.

Step 2 Enter the passwordutils.exe password.

passwordutils.exe password

Step 3 Press Enter.

You need the Encrypted Password value information for the registry.

Step 4 Choose Start > Run.

Step 5 In the Open field, enter regedit.

The Registry Editor window displays.

Step 6 Go to My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\Directory Configuration.

LDAPURL must point to the correct directory.

ldap://host:port

Step 7 Double-click DCDMGRPW.

The Edit String window appears.

Step 8 In the Value Data field, enter the Encrypted Password value that you obtained in
Step 3.

Step 9 Click OK.

Step 10 From the Registry Editor window, double-click MGRPW.

The Edit String window appears.

Step 11 In the Value Data field, enter the Encrypted Password value that you obtained in
Step 3.

Step 12 Click OK.

You have successfully changed the password in the registry.


Note After changing the registry entries, you must restart the WWW and IIS services on the Cisco CallManager node to pick up the latest settings from the registry.


Step 13 Choose Control Panel > Administrative Tools.

Step 14 Double-click Services.

The Services window displays.

Step 15 Choose Worldwide Web Publishing Service.

Step 16 Click Stop.

Step 17 Click Start.

Step 18 Choose DC Directory Server.

Step 19 Click Stop.

Step 20 Click Start.

If you use CRA 2.x that connects to the DC Directory, you must update the password in the Application Administration pages. Continue with Reconfiguring the Directory Manager Password for CRA and E-services.


Reconfiguring the Directory Manager Password for CRA and E-services

If you use CRA 2.x that connects to the DC Directory, use the following procedure to update the password in the Application Administration pages.

Procedure


Step 1 Enter http://servername/AppAdmin where servername is the DNS name or IP address of your application server.

Step 2 When prompted, enter the network user name and password.

Step 3 Choose Directory Configuration.

The Directory Configuration window appears.

Step 4 In the Directory Password field, enter your new password.

Step 5 Click OK.


Verification

To verify that you successfully changed the Cisco CallManager DC Directory Manager password, use the following procedure.

Procedure


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

The User Information window appears.

Step 2 Click Search.

Step 3 If you can view the users that are configured in the system, the configuration was successful.


If you cannot view the users that are configured in the system, verify the following information:

The new password is effective: Log in to the DC Directory with the new password.

The encrypted password was entered correctly into the registry.

The directory is pointing to the correct directory and not another directory (such as AD or an old directory which could be empty).

The Worldwide Web Publishing and DC Directory services are restarted and running after the restart.

Related Information

For directory installation and configuration information, go to the following URL:

http://www.cisco.com/univercd/cc/td/doc/product/voice/c_callmg/4_0/install