eDirectory 8.8 SP8 Patch 6 Release Notes for Windows

September 2015

eDirectory 8.8.8 Patch 6 includes new features, improves usability, and resolves several previous issues. Many of these improvements were made in direct response to suggestions from our customers. We thank you for your time and valuable inputs. We hope you continue to help us ensure our products meet all your needs.

For a full list of all issues resolved in eDirectory 8.8, including all patches, refer to TID 3426981, “History of Issues Resolved in eDirectory 8.8.x”.

For the list of software fixes and enhancements in the previous releases, see eDirectory 8.8.8 Patch 5 Release Notes.

To download this product, see the NetIQ Downloads Web site. For more information on eDirectory, see the eDirectory documentation Web site.

For information about security services that are bundled with eDirectory and other components used with eDirectory, see Section 9.0, Additional Documentation.

9.2 NMAS

1.0 What’s New

eDirectory 8.8.8 Patch 6 provides the following key features, enhancements, and fixes in this release:

1.1 New Features

This release introduces the following new feature:

Support for LDAP Password Modify Extended Operation

This release introduces the support for configuring and using the LDAP password modify extended operation. For more information, see Configuring and Using the LDAP Password Modify Extended Operation in the NetIQ eDirectory 8.8 SP8 Administration Guide.

1.2 Updates for Dependent Components

In this release, the Java version has been updated to 1.8.0_60. There are no manual steps required to update the version of Java. After upgrading, the Java version is 1.8.0_60.

For more information on other Oracle critical patch updates, see http://www.oracle.com/technetwork/topics/security/cpujul2015-2367936.html.

1.3 Browser Support for iMonitor

This release adds support to the following browsers, in addition to the browsers introduced in eDirectory 8.8.8 Patch 5 or earlier releases:

  • Internet Explorer 11

  • Mozilla Firefox 40

1.4 Support for LDAP Password Modify Extended Operation

This release introduces the support for configuring and using the LDAP password modify extended operation. For more information, see Configuring and Using the LDAP Password Modify Extended Operation in the NetIQ eDirectory 8.8 SP8 Administration Guide.

1.5 Software Fixes

eDirectory 8.8.8 Patch 6 includes the following software fixes that resolve several previous issues.

Resolves an Issue with Increased Memory Consumption When XDAS is Used

Issue: If you enable XDAS on your eDirectory, it results in increased memory consumption and slows the response time. (Bug 916049)

Fix: This patch updates the eDirectory code to avoid memory build up when XDAS is enabled.

xdasauditds.dlm Fails to Initialize Completely when eDirectory is Initially Started

Issue: After upgrading eDirectory, xdasauditds.dlm fails to initialize completely when eDirectory is started. (Bug 783040)

Fix: This patch updates the XDAS code to ensure that xdasauditds.dlm reads the xdasconfig.properties configuration file and starts logging the events after the directory service starts running.

Resolves an Issue Where the eDirectory Patch Installation Program Does Not Clean Old Registry Entries

Issue: The eDirectory patch installation program does not clean old registry entries. (Bug 924555)

Fix: This patch updates the eDirectory installer code to ensure that it removes old registry entries during eDiirectory upgrade.

The ICE Wizard Displays java.lang.NullPointerException Error Message

Issue: eDirectory records java.lang.NullPointerException exception and displays a 239 error code when you try to import or export objects by using the ICE plug-in. (Bug 921636)

Fix: You can now successfully import and export objects by using the ICE plug-in.

Resolves an Issue with Inconsistent Usage of SSL CertificateDNS as a Certificate For the http Server httpkeymaterialobject Attribute

Issue: eDirectory does not consistently use SSL CertificateDNS as the certificate for http server httpkeymaterialobject attribute. (Bug 924300)

Fix: With this patch, eDirectory automatically provides the SSL Certificate DNS for the httpkeymaterialobject attribute of the http server object.

Resolves an Issue with NDSD Memory Consumption

Issue: eDirectory triggers the LDAP server refresh code every 10 seconds. The NDSD memory consumption increases when the LDAP server is not associated with a proper certificate. (Bug 938608)

Fix: eDirectory is updated to frequently execute the LDAP refresh code when a proper certificate is not associated with the LDAP server. This resolves the memory leak issue that existed in the LDAP refresh code in the previous version.

Reading Members of a Dynamic Group Causes an Endless Loop

Issue: Reading the members of a dynamic group causes an endless loop when the group has 480 members. (Bug 927868)

Fix: eDirectory now successfully sends all the attributes of the dynamic group members to the client without any looping issues.

LDAP Search Returns Error on Invalid Assertion Values

Issue: When an LDAP search filter contains an invalid assertion value, eDirectory returns Invalid DN Syntax error, which may cause inconvenience to certain LDAP applications. (Bug 923392)

Fix: To handle invalid assertion values in compliance with RFC4511, eDirectory provides a configuration option in the LDAP server. By using the configuration option, eDirectory can now return proper search results to the LDAP client.

NMAS Ignores Validation for Some Characters in Passwords

Issue: NMAS does not correctly recognize a password with uppercase or lowercase characters and characters exceeding the 0x7f hexadecimal number. (Bug 944055)

Fix: If the password contains uppercase, lowercase, and extended characters, NMAS removes the character from the extended character list and treats it as uppercase or lowercase character.

Issue with Case Sensitivity of sadmin User Name

Issue: The eDirectory utilities treat sadmin user name as case sensitive. (Bug 909247)

Fix: This patch updates the utilities code, so they uniformly treat the sadmin user name as case insensitive.

2.0 Other Considerations Before Installing the Patch

2.1 Manually Extending the Schema Before Installation

In some cases, schema extensions do not synchronize fast enough to the lower levels of a tree where the first new eDirectory 8.8 SP8 server is being installed, so some features are not completely installed.

This problem can be avoided by manually extending the schema in your tree before you install eDirectory 8.8 SP8, using the eDirectory 8.8 SP8 schema files located in the <Unzip Location>\Novell\NDS\x64 folder.

For more information on extending the schema, refer to the “Extending the Schema on Windows” section in the NetIQ eDirectory 8.8 SP8 Administration Guide.

2.2 Specifying eDirectory Information During the Installation

When specifying the eDirectory information during the installation, if an invalid Server object container type is specified, the installation does not detect the error until later, and the eDirectory installation fails with a -611 or -634 error.

The valid Server object container types are:

  • Organization (O)

  • Organizational Unit (OU)

  • Domain (DC)

2.3 Removing the Novell Client after eDirectory Installation

When eDirectory 8.8 SP8 is installed on a Windows computer already containing the Novell Client, eDirectory installs an SLP service, but sets the service to manual mode so that it does not run when the server is booted. eDirectory then uses the SLP service from the Novell Client. If the Novell Client is removed, leaving no SLP service for eDirectory to use, you must manually start the SLP service, or change it to start automatically when the server boots.

2.4 Default Listeners for New Network Interface

eDirectory listens on all interfaces configured on the computer for NCP, HTTP, HTTPS, LDAP and LDAPS by default. Adding a new network interface address to the computer, and restarting eDirectory will make it start listening on that address automatically, and have referrals also added correspondingly.

2.5 Using eDirectory 8.8 SP8 with a Firewall Enabled

When you try to add an eDirectory 8.8 SP8 server from a Windows host to an existing tree running on a different host, it might fail if the firewall is enabled.

To work around this issue, enable SLP services and an NCP port (default 524) in the firewall to allow the secondary server addition.

3.0 System Requirements

For a detailed list of prerequisites for installing eDirectory, see the NetIQ eDirectory 8.8 SP8 Installation Guide.

4.0 Installing or Upgrading

To upgrade to eDirectory 8.8.8 Patch 6, go to the NetIQ Downloads page and follow the link that allows you to download the software.

5.0 Supported Upgrade Paths

The installation program provides the ability to upgrade from eDirectory 8.8 SP8 onwards or perform a new installation.

Ensure that you are currently on any one of the following eDirectory versions, before upgrading to eDirectory 8.8.8 Patch 6:

  • 8.8.8

  • 8.8.8 Patch 1

  • 8.8.8 Patch 2

  • 8.8.8 Patch 3

  • 8.8.8 Patch 4

  • 8.8.8 Patch 5

For more details, see Installing or Upgrading eDirectory in the NetIQ eDirectory 8.8 SP8 Installation Guide.

NOTE:If you have eDirectory 8.5.x or 8.6.x, you must first upgrade to eDirectory 8.7.x, then upgrade to eDirectory 8.8 SP8 and later.

6.0 Installing iManager Plug-Ins

  1. Download the iManager plug-in (eDir_88_iMan27_Plugins.npm) from the Downloads Web site.

  2. Install the NPM. For installation instructions, see NetIQ iManager 2.7.7 Installation Guide.

7.0 Additions to Documentation

The following topic has been added to the eDirectory documentation:

7.1 Updating Passwords Through LDAP Password Modify Extended Operation

eDirectory provides a way for LDAP clients to update user passwords using the LDAP Password Modify Extended Operation and allows the extended operation through a secure channel (LDAPS or LDAP Start TLS). For more information, see Configuring and Using the LDAP Password Modify Extended Operation in the NetIQ eDirectory 8.8 SP8 Administration Guide.

8.0 Known Issues

The following sections provide information on known issues at the time of the product release.

8.1 Installation and Configuration Issues

Valid Version of NMAS Not Found

If you install NetIQ Identity Manager 4.0.2 on a computer running eDirectory 8.8 SP8, the setup program displays the following error:

Valid version of NMAS not found

The error message states NMAS 8.8.8 is not a valid version and asks if you want to proceed with the installation process. Ignore the error, and click Yes. The installation process completes successfully.

Help Files Are Not Launched for Some Utilities

This is observed for utilities such as DSRepair, DSMerge, and DSBrowse.

To view the help files for these utilities, open them directly by double-clicking them in the folder they are located in. For example, C:/Novell/NDS/NLS/Nihongo for the Japanese help file.

Login Fails During Installation of the Secondary Server

If the login fails during the secondary server installation, click the Browse button next to the Administrator Login Name dialog box. After this, you might see an error message and a dialog box prompting you to enter an IP address. Enter the IP address of any server in the tree, preferably the Master server of the partition to which the server is being added.

If the server is running on a port number other than 524, enter the port number as well such as 1.2.3.4:1524. This connects to the server, displays the tree name, and prompts for a login name and password. Follow the dialog boxes to continue with the installation. Ensure that the time between the primary and secondary servers is synchronized.

Replication Issues After an Upgrade

When you upgrade to eDirectory 8.8 SP8 and enable encrypted replication, replication fails in rare scenarios.

To work around this issue:

  1. In NetIQ iManager, select Modify Object, then select the NCP Server object.

  2. Under the General tab, select Other.

  3. Add NCPKeyMaterialName from Unvalued Attributes to Valued Attributes with the certificate name. For example, SSL CertificateDNS.

  4. Run Limber on the server where the attribute changed in Step 3. For information about using Limber, see the NetIQ eDirectory 8.8 SP8 Administration Guide.

eDirectory Installation Fails From a Path Containing Non-ASCII Characters

eDirectory installation fails when the install files are run from a path that contains double-byte or extended ASCII characters.

Missing rt.jar File Causes eDirectory Installation to Fail

The installer fails to find the correct path to load the rt.jar file. This issue does not occur if the eDirectory installation folder has a relatively short path. For example, eDirectory installation can fail if the length of the folder path is more than 115 characters.

Installing eDirectory Stops SNMP

SNMP stops working after installing eDirectory and displays the following error message:

SNMP subagent error -672

To workaround this issue, perform the following steps:

  1. Install and configure SNMP service after eDirectory is installed.

  2. Run the dssnmpsupport.exe on your eDirectory server.

NOTE:Apply dssnmpsupport.exe only if MpsSvc service is running on the eDirectory server.

eDirectory Does Not Log an Event For a Failed Login

By default, eDirectory disables logging for a failed login event. To enable this, configure the Nsure Audit settings for eDirectory to log the Add Value events in the NCP server object. You also need to enable the intruder detection on containers where auditing of these events is required. For more information, see TID 10092488.

Identity Manager Fails to Start After Updating Non-Root eDirectory 8.8.8 with eDirectory 8.8.8 Patch 4

The non-root eDirectory 8.8.8 Patch 4 comes with an empty <eDirectroy install path>/sbin/pre_ndsd_start script that does not allow to set the paths for Identity Manager. As the paths are not set, Identity Manager. is not able to start.

To workaround this issue, set the correct path of eDirectory installation as mentioned in TID 7016136.

Identity Manager 3.6 and 4.0.x Engine Fails to Start After Upgrading to eDirectory 8.8 SP8 Patch 4

This issue occurs because of the mismatch in the Java versions supported by the latest eDirectory patch and Identity Manager. Earlier versions of Identity Manager supported Java 1.6 while eDirectory 8.8.8 Patch 4 shipped with Java 1.7.

To workaround this issue, upgrade Identity Manager 3.6.1 or 4.0.x to Identity Manager 4.0.2 or 4.5 including the latest engine patch. For more information, see TID 7016009 or TID 7016010.

8.2 Upgrade Issues

eDirectory Upgrade Fails with an Error

The following error is displayed:

Admin user does not have enough rights to modify the tree schema.

To resolve this issue, complete the following steps:

  1. From the Administrator Login page of eDirectory installation, browse to and select the admin user.

  2. Specify the password, then click Next to continue.

Instrumentation Upgrade Issues While Upgrading eDirectory

If you upgrade an eDirectory server on which the eDirectory instrumentation is installed, the eDirectory instrumentation files are not upgraded automatically. Therefore, you must manually upgrade the eDirectory instrumentation files.

NOTE:eDirectory instrumentation is automatically installed with Identity Manager 4.0.

For more information on upgrading the instrumentation, refer to the NetIQ eDirectory 8.8 SP8 Installation Guide.

8.3 DHost Crashes When the Admin Logs Off

DHost crashes if the administrator logs off when a repair window is still open. When you run a repair utility, all the repair windows must be closed before logging out of the Windows session.

8.4 Issue while Invoking NDS Utilities

When you invoke any of the eDirectory utilities except DSTrace, the Interactive dialog box appears.

To launch and continue using the invoked utility, click the Show me the message option in the Interactive dialog box.

Windows Server 2012 and Windows Server 2012 R2 do not allow interactive services by default. To allow interactive services, go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Windows and change NoInteractiveServices from 1 to 0. Reboot the computer to start the interactive services detection service.

NOTE:When configuring the Directory Agent for eDirectory module (ds.dlm), ensure that you exit the ds.dlm dialog box to continue using the eDirectory services.

8.5 Localization Issues

eMBox Does Not Handle Double-Byte Characters

The NetIQ eDirectory Management Toolbox (eMBox) does not handle double-byte characters for setting a roll-forward directory through the eMBox client and iManager. This can still be done by using DSBK.

Dsclusterconfig.exe Utility Does Not Accept All French Terminal Options

In a French localized Windows environment, if you try to run the utility for configuring eDirectory on a cluster (dsclusterconfig.exe), the localized O option does not work. You must provide the corresponding English Y option for the utility to run.

Dsclusterconfig.exe Utility Does Not Support Japanese Locale

If you use the dsclusterconfig.exe utility in a Japanese localized Windows environment, the utility displays corrupted Japanese characters in the Windows terminal. You must change the localization settings for the utility to use English in order to properly configure eDirectory.

8.6 IPv6 Issues

Symantec Network Threat Protection Conflicts with IPv6

Symantec Network Threat Protection conflicts with IPv6 addresses. If you want to use IPv6 addresses in iManager 2.7.7, and your computer is running Network Threat Protection, you must disable Network Threat Protection.

8.7 Preventing POODLE Attack by Disabling SSLv3

If your eDirectory uses LDAPS protocol with SSLv3 for a secure communication, be aware that SSLv3 is vulnerable to POODLE attack as per CVE-2014-3566.

To disable SSLv3 in the LDAPS protocol, perform the following steps:

  1. Download and install the latest iManager plug-in for eDirectory from the NetIQ Downloads Web site.

  2. Launch iManager and click Roles and Tasks.

  3. Click LDAP>LDAP Options>View LDAP Server, select LDAP Server.

  4. Click the Connections tab.

  5. Enable the Disable SSLv3 and click Apply.

    NOTE:In non-English environment you cannot access the Disable SSLv3 option. To access this option change the preferred display language to English.

  6. Unload and load the LDAP Services for eDirectory.

    For more information, see Loading and Unloading LDAP Services for eDirectory.

For other protocols that eDirectory uses, SSLv3 is disabled by default.

8.8 Issues while Configuring Predicate Statistics

NetIQ recommends that you do not try to configure the predicate statistics in this version of the product. There is no workaround at this time.

9.0 Additional Documentation

9.1 iManager

For iManager information, refer to the iManager online documentation.

9.2 NMAS

For NMAS information, refer to the eDirectory online documentation page. This documentation is available as a zip file at the end of this page.

9.3 Password Management

For Password Management information, refer to the eDirectory online documentation page. This documentation is available as a zip file at the end of this page.

9.4 Certificate Server

For Certificate Server information, refer to the eDirectory online documentation page. This documentation is available as a zip file at the end of this page.

9.5 Novell International Cryptographic Infrastructure (NICI)

For NICI information, refer to the NICI online documentation.

10.0 Legal Notices

NetIQ Corporation, and its affiliates, have intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more U.S. patents and one or more additional patents or pending patent applications in the U.S. and in other countries.

THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT ARE FURNISHED UNDER AND ARE SUBJECT TO THE TERMS OF A LICENSE AGREEMENT OR A NON-DISCLOSURE AGREEMENT. EXCEPT AS EXPRESSLY SET FORTH IN SUCH LICENSE AGREEMENT OR NON-DISCLOSURE AGREEMENT, NETIQ CORPORATION PROVIDES THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SOME STATES DO NOT ALLOW DISCLAIMERS OF EXPRESS OR IMPLIED WARRANTIES IN CERTAIN TRANSACTIONS; THEREFORE, THIS STATEMENT MAY NOT APPLY TO YOU.

For purposes of clarity, any module, adapter or other similar material (“Module”) is licensed under the terms and conditions of the End User License Agreement for the applicable version of the NetIQ product or software to which it relates or interoperates with, and by accessing, copying or using a Module you agree to be bound by such terms. If you do not agree to the terms of the End User License Agreement you are not authorized to use, access or copy a Module and you must destroy all copies of the Module and contact NetIQ for further instructions.

This document and the software described in this document may not be lent, sold, or given away without the prior written permission of NetIQ Corporation, except as otherwise permitted by law. Except as expressly set forth in such license agreement or non-disclosure agreement, no part of this document or the software described in this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, or otherwise, without the prior written consent of NetIQ Corporation. Some companies, names, and data in this document are used for illustration purposes and may not represent real companies, individuals, or data.

This document could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein. These changes may be incorporated in new editions of this document. NetIQ Corporation may make improvements in or changes to the software described in this document at any time.

U.S. Government Restricted Rights: If the software and documentation are being acquired by or on behalf of the U.S. Government or by a U.S. Government prime contractor or subcontractor (at any tier), in accordance with 48 C.F.R. 227.7202-4 (for Department of Defense (DOD) acquisitions) and 48 C.F.R. 2.101 and 12.212 (for non-DOD acquisitions), the government's rights in the software and documentation, including its rights to use, modify, reproduce, release, perform, display or disclose the software or documentation, will be subject in all respects to the commercial license rights and restrictions provided in the license agreement.

© 2015 NetIQ Corporation. All Rights Reserved.

For information about NetIQ trademarks, see http://www.netiq.com/company/legal/.