Logo
Tech Note 2196: Error message: NM_LDAP_DIRECTORY_MISMATCH

NM_LDAP_DIRECTORY_MISMATCH and Other Warehouse Connectivity Problems

Technical Note 2196

Last Reviewed 03-Sep-2009
Applies To
Mobility XE server and warehouse

 Printer-friendly version

Summary

The Mobility warehouse is a Sun Java™ System Directory Server used to store Mobility XE configuration settings and client policies. Under certain circumstances a Mobility server may have difficulty connecting to the warehouse. In some cases the message "NM_LDAP_DIRECTORY_MISMATCH" may appear on the Warehouse tab of the Startup Settings utility. (On the Mobility server machine, Startup Settings can be found in Start->Program Files->NetMotion->Startup Settings).

The fix for this issue varies depending on the version of the warehouse. If your warehouse is Sun Java™ System Directory Server 5.2.4, refer to Section 1 below for instructions on resolving this problem. If your warehouse is Sun Java™ System Directory Server 6.3.1 (installs with version 9.0 of Mobility XE), refer to Section 2 below.


Section 1: Sun Java™ System Directory Server 5.2.4

If your warehouse was installed with Mobility XE version 6.00 through 6.7, then it was originally Sun ONE Directory Server version 5.2. There is a patch for the 5.2 Directory Server - Patch 4 - that contains some bug fixes and a fix for a security flaw that can permit an unauthenticated attacker to remotely compromise the Directory server.


Important: If Patch 4 has already been applied, you should not apply it again. The warehouse that ships with Mobility XE version 7.0 and higher has already had Patch 4 applied. To determine if Patch 4 has been applied to your warehouse, do the following:

  1. Open the Sun ONE Directory Server console: on the Start menu, click Programs -> Sun ONE Server Products (or Sun Java™) System Server Products) -> Sun ONE Server Console 5.2 (or Sun Java™ System Server Console 5.2). Log on with the user ID and password you created during warehouse setup. The default user ID is admin.

  2. On the Servers and Applications tab, expand the tree in the lefthand pane until you see the Directory Server listing.


  3. Select (highlight) Directory Server.


  4. In the righthand pane, look at the Version: line.


  5. A warehouse that has had Sun Patch 4 applied will read "Version: 5.2_Patch_4". See Part 2 below.

    Note: If you are running version 7.20 or higher of the Mobility server, you can determine if your primary warehouse has been patched by clicking on the Warehouse link on the Server Status page of the Mobility Console. To determine if any standby warehouses have been patched, follow the guidelines above.


  6. If your warehouse is not version 5.2.4, follow the instructions in http://www.netmotionwireless.com/support/technotes/2195.aspx to apply Patch 4. If, after applying the patch, you receive the "NM_LDAP_DIRECTORY_MISMATCH" error, follow the instructions below.


  7. If your warehouse is already version 5.2.4, you need to reinitialize it. See http://www.netmotionwireless.com/support/technotes/2222.aspx.


If you receive the "NM_LDAP_DIRECTORY_MISMATCH" error immediately after applying Patch 4:

There is a Mobility XE server setting you must add to the registry of your server machine. The setting is called CompatibleLDAPDirectory. Set the value for this key to "Sun" so that the Mobility server will not accidentally connect to a non-Sun LDAP server. Otherwise you will see the error message "NM_LDAP_DIRECTORY_MISMATCH".


To set the value to "Sun", download and run nms_Sun_LDAP.reg. The key that will be added to the registry looks like this:

Registry key

Name

HKEY_LOCAL_MACHINE\SOFTWARE\NetMotion\Mobility Server\MMS\Settings

Value

"CompatibleLDAPDirectory"="Sun"

Section 2: Sun Java™ System Directory Server 6.3.1

Only follow the instructions in this section if all three of the following conditions are met:

  1. Your Mobility server (or pool) is version 8.5. You are not planning to immediately upgrade your Mobility server(s) to version 9.0.

  2. Your Mobility warehouse is version 6.3.1. You installed the new version of the warehouse from Mobility version 9.0.

  3. You received a popup message directing you to install Sun Patch 4 even though your warehouse already has the patch. When you run Startup Settings and open the Mobility Warehouse tab, the message reads Mobility server cannot communicate with the Mobility warehouse.

There is a Mobility XE server setting you must add to the registry of your server machine. The setting is called CompatibleLDAPVersion. Set the value for this key to "6.3".


To set the value to 6.3, download and run nms_Sun_LDAP_63.reg. Or, you can add the setting manually by using regedit to navigate to HKEY_LOCAL_MACHINE\SOFTWARE\NetMotion\Mobility Server\MMS\Settings and creating a new String value named CompatibleLDAPVersion with a value of 6.3. Note: Always make a backup copy of the registry before you edit it. Be sure you spell the setting correctly.


The key that will be added to the registry looks like this:

Registry key

Name

HKEY_LOCAL_MACHINE\SOFTWARE\NetMotion\Mobility Server\MMS\Settings

Value

"CompatibleLDAPVersion"="6.3"

Related Information

2195

How to Install Sun Patch 4 on a Mobility XE Warehouse

2222

Reinitializing the Mobility XE Warehouse

9979

NetMotion Mobility Technical Notes

Please comment on this technical note.

When a Mobility server is added to a pool of servers and pointed to a patched warehouse, the administrator may see the error "NM_LDAP_DIRECTORY_MISMATCH". This technical note explains how to resolve that issue.