NetIQ eDirectory 8.8 SP8 Patch 5 for Linux

March 2015
5.2 NMAS

1.0 Documentation

NetIQ eDirectory 8.8 SP8 Patch 5 includes new features and resolves several previous issues. The installation program provides the ability to upgrade from eDirectory 8.8 SP8 onwards or perform a new installation.

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

For information about what’s new in previous releases, see the “Previous Releases” section in the NetIQ eDirectory online documentation Web site.

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 5.0, Additional Documentation.

2.0 What’s New

This section lists the following new functionalities and features for this release:

2.1 Browser Support for iMonitor

iMonitor supports the following browers:

  • Internet Explorer 11

  • Mozilla Firefox 34.0.5

3.0 Installation

3.1 Prerequisites

NOTE:Check the currently installed NetIQ and third-party applications to determine if eDirectory 8.8 SP8 is supported before upgrading your existing eDirectory environment. NetIQ Corporation recommends that you back up eDirectory before performing any upgrades.

Linux

You can install eDirectory on any of the platforms listed below.

  • SLES 12 (64-bit)

  • SLES 11 SP1, SP2, and SP3 (64-bit)

  • SLES 10 SP4 (64-bit)

  • RHEL 5.10, 5.9, 5.8, and 5.7 (64-bit)

  • RHEL 6.6, 6.5, 6.4, 6.3, and 6.2 (64-bit)

  • RHEL 7 (64-bit)

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

You can run the above operating systems in a virtual mode on the following hypervisors:

  • Xen

  • VMware ESXi

  • Windows Server 2008 R2 Virtualization with Hyper-V

NOTE:You can upgrade from eDirectory 8.8 SP8 onwards to eDirectory 8.8 SP8 Patch 5.

Using eDirectory 8.8 SP8 with a Firewall Enabled

On SLES, if you add an eDirectory 8.8 SP8 server from a SLES host to an existing tree running on different host, the process might fail if the firewall is enabled.

Enable SLP services and an NCP port (the default is 524) in the firewall to allow the secondary server addition.

On an RHEL system, if you add a secondary server to an eDirectory tree, ndsconfig hangs during schema synchronization. However, you can add it if you open port 524 in the firewall.

3.2 iManager Plug-In Installation

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

Install the NPM as directed in the NetIQ iManager 2.7.7 Administration Guide.

3.3 Default Listeners for New Network Interface

On Linux, eDirectory doesn't listen on all interfaces on the computer, but on the specific IP mentioned in nds.conf only. Adding a new network interface address to the computer should not have any impact on the referrals, until corresponding protocol interface entry in nds.conf is modified to specify the new address, listener for that would not be started.

4.0 Known Issues

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

4.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.

eDirectory Dumps the Core on Loading xdasauditds When the Syslog Appender Is Disabled

ndsd dumps the core when it attempts to load the xdasconfig.properties file in which the layout definition for Syslog is not defined correctly.

eDirectory 8.8 SP8 SNMP Fails on RHEL Version 6.2 and Above

This is because of an issue with the SNMP modules that Redhat provides.

To overcome this issue, install the latest RHEL patch from the Red Hat update service. For more information about this workaround, see TID 7011659.

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.

eDirectory Dumps the Core on Loading the SNMP Subagent on RHEL 7 with NET-SNMP Version 5.7.2

RHEL 7 provides NET-SNMP version 5.7.2 and installs the following versions of SSL libraries:

  • *)openssl-1.0.1e-34.el7.x86_64

  • *)openssl098e-0.9.8e-29.el7.x86_64

When NET-SNMP is loaded with a newer version, the openssl-1.0.1e-34.el7.x86_64 library causes missing of symbols and dumps the core.

To workaround this issue, perform the following actions:

  1. Load the "LD_PRELOAD" libssl.so.0.9.8* library before loading ndssnmpsa by using the /etc/init.d/ndssnmpsa script.

  2. Modify the line that loads ndssnmpsa to look like the following:

    LD_PRELOAD="/usr/lib64/libssl.so.0.9.8*"

    /opt/novell/eDirectory/bin/ndssnmpsa

  3. Restart ndsd.

eDirectory Configuration Fails on SLES12 and RHEL 7 If the Configuration File Path Contains a Hyphen

Currently, there is no fix for this issue.

eDirectory Utilities Require Users to Authenticate Using ndspassword

If Universal Password is being used, then it must be synced to the ndspassword in order for all eDirectory command line tools to authenticate.

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.

A Non-Root User Cannot Start Services On RHEL 7

If you log in as a non-root user, RHEL 7 does not allow you to start the services. Therefore, eDirectory does not support a non-root user on this platform.

There is no workaround at this time.

Installation Fails On RHEL Servers Installed With pprof Package From RedHat

If your RHEL server is installed with the pprof package provided by RedHat, the eDirectory installation program installs a majority of the packages until it detects this package and fails to install eDirectory.

When you re-run the installation script regardless of a new installation or an upgrade, the installation script fails again because it encounters the RPMs laid down by the earlier installation attempt.

To workaround this issue: Uninstall the pprof package from RedHat before starting the eDirectory installation.

IMPORTANT: In case of a failed upgrade, manually install the novell-ncpenc-1.2.2.0-0.x86_64 package before resuming the upgrade process by using the ndsconfig upgrade command.

SLPD Provided with SLES 12 and RHEL 7 Platforms Does Not Work

To get the SLPD working, either build your own version of SLPD after downloading it from the OpenSLP web site on your platform or contact NTS for further assistance.

4.2 Upgrade Issues

Duplicate Files Are Created after Upgrading from eDirectory 8.8 SP2 to eDirectory 8.8 SP8

After upgrading eDirectory, the new configuration files have a .new extension. If there are any changes to these files, you can merge them in the new files.

Upgrading Simple Password Bind from an Older Version to a 64-Bit eDirectory 8.8 SP8 Version

After upgrading eDirectory to 64-bit, ensure you update the NMAS Simple Password method for simple password binds to work.

Instrumentation RPM Upgrade Issues While Upgrading eDirectory

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

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.

Issue with ConsoleOne after Upgrading to eDirectory 8.8 SP8

After you upgrade to eDirectory 8.8 SP8 in an environment where ConsoleOne is installed, ConsoleOne displays an error. ConsoleOne requires a 32-bit package included in eDirectory 8.7.3 but removed in eDirectory 8.8 SP8. This issue only occurs on 64-bit installations of eDirectory.

To work around this issue, after upgrading eDirectory, reinstall ConsoleOne. The ConsoleOne installer installs the eDirectory 8.7.3 package and starts properly.

Prompting for Password Multiple Times While Upgrading to eDirectory 8.8 SP8

While upgrading from eDirectoy 8.8 SP6 and lower versions to eDirectory 8.8 SP8, you are prompted for password several times. It is safe to ignore the prompts.

eDirectory 8.8 SP8 Patch 1 Does Not Upgrade on Identity Manager Remote Loader

eDirectory 8.8 SP8 Patch 1 fails to upgrade on an Identity Manager remote loader machine.

To work around this issue:

  1. Stop eDirectory.

  2. Go to the \Linux64 folder of patch directory.

  3. Upgrade the following 8.8.7 rpms, by using the -Uvh option:

    • novell-edirectory-expat-32bit-8.8.7-1.x86_64

    • novell-edirectory-expat-8.8.7-1.x86_64

    • novell-edirectory-xdaslog-conf-8.8.7-1.noarch

    • novell-edirectory-xdaslog-32bit-8.8.7-1.x86_64

    • novell-edirectory-xdaslog-8.8.7-1.x86_64

  4. Apply eDirectory 8.8 SP8 Patch 1.

  5. Start eDirectory.

On SLES 12 Platform After Upgrading to the Latest Patch the eDirectory Variables are Lost

After upgrading to the latest patch, the eDirectory related environment variables in the env file located in /etc/opt/novell/eDirectory/conf directory needs to be re-entered.

NOTE:To avoid this issue , before upgrading to Patch 5 backup the environment file.

4.3 Default Instance Path for Multiple Instances

While you configure the second instance of eDirectory on your host, you are prompted for the default path. Select a different path and proceed.

4.4 Localhost Issues in /etc/hosts

If you have a loopback address alias to the hostname of the system in an /etc/hosts entry, it must be changed to the hostname or IP address. That is, if you have an entry similar to the one below in your /etc/hosts file, it needs to be changed to the correct entry given in second example below.

The following example has problems when any utility tries to resolve to the ndsd server:

127.0.0.1 test-system localhost.localdomain localhost

The following is a correct example entry in /etc/hosts:

127.0.0.1 localhost.localdomain localhost
10.77.11.10 test-system

If any third-party tool or utility resolves through localhost, it needs to be changed to resolve through a hostname or IP address and not through the localhost address.

4.5 LDAP, TCP, and TLS Ports Issue with Large DIBs

When the DIB is large, the DS takes time to come up and wrongly displays the following errors:

LDAP TCP Port is not listening
LDAP TLS Port is not listening

In this scenario, the ports are not disabled but eDirectory services are slow to come up. To check the status of LDAP, refer to the ndsd.log file or enter the following command and grep for the LDAP TCP/TLS ports:

netstat -na

4.6 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.

4.7 ldapInterfaces Behaves Differently in SLES10 SP4

In SLES10-SP4, while setting the LDAP interface address, you must set the assigned IP address in the beginning followed by unassigned address, if any. Else, ldapInterfaces does not behave as expected.

The following is an example of how you must set the LDAP interface address in SLES10 SP4:

ldapInterfaces:
ldap://<IPv4 address>:389,ldaps://<IPv4 address>:636,ldap://<IPv6 address>:389,ldaps://<IPv6 address>:636,ldap://:389,ldaps://:636

4.8 Uninstallation Issues

Uninstallation Fails if Installation Was Not Successfully Completed

If eDirectory installation fails, nds-uninstall cannot remove eDirectory.

To resolve this, install eDirectory again in the same location and then uninstall it.

The nds-uninstall -s Option Fails to Retain Configuration and DIB Files

You must not use the -s option to retain the nds.conf and the DIB. Ensure that you back them up before performing the nds-uninstall operation.

4.9 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.

4.10 Kerberos iManager Plug-In Issues

For managing Kerberos Principals, use Kerberos Administration programs from MIT. For managing a Kerberos realm, use the Kerberos iManager plug-ins.

4.11 eDirectory Does Not Starts Automatically After Rebooting the system.

To workaround this issue, after reboot, manually restart the eDirectory server.

5.0 Additional Documentation

5.1 iManager

For iManager information, refer to the iManager online documentation.

5.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.

5.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.

5.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.

5.5 Novell International Cryptographic Infrastructure (NICI)

For NICI information, refer to the NICI online documentation.

5.6 eDirectory Issues on Open Enterprise Server

For more information on eDirectory issues on Open Enterprise Server (OES), refer to the OES Readme.