H.1 Troubleshooting SNMP

Traps Might Not Get Generated As Expected

Traps are sent only if the corresponding verb request is received by the server. They are not sent in any other cases. For example, ndsDeleteAttribute is sent only when the ndsRemoveEntry (trap number 108) request is sent. But an application can always read the ACLs and decide to check whether the user has sufficient rights to perform the delete operation. In this case, the ndsDeleteAttribute trap is not generated. However, you can use OpenText iMonitor to view the verb statistics on a particular server.

To get the traps for all occurrences, set the time interval to zero.

You can enable traps to send only on failure conditions. You can enable traps to get them under all conditions.

ndssnmpsa must be restarted when the master agent is restarted

To restart ndssnmpsa, stop ndssnmpsa and then start it again.

To stop ndssnmpsa, enter the following:

Linux: /etc/init.d/ndssnmpsa stop

To start ndssnmpsa, enter the following:

Linux: /etc/init.d/ndssnmpsa start

SNMP Group Object

If the installation of the SNMP Group object fails, you can rectify this problem by executing the following command on the server console:

ndsconfig add -m snmp

SNMP Object Creation Error on Windows Server

While installing OpenText eDirectory on any supported Windows platform server, if you get an SNMP group object creation error, you need to manually create the SNMP group object. For information on the steps to manually create an SNMP object, see Section 18.0, SNMP Support for OpenText eDirectory.

OpenText eDirectory SNMP initialization component. Error code: -255or Initialization failure. Error code: -255

The possible cause could be that you have not specified hostname:port or IP_address:port as a paramater to the SERVER command in OpenText eDirectory SNMP configuration file.

The OpenText eDirectory SNMP configuration file is ndssnmp.cfg. It is located in the following directories:

  • Linux: /etc/opt/novell/eDirectory/conf/ndssnmp/

  • Windows: install_directory\SNMP\

LDAP SNMP Statistics Not Report

When anonymous bind is disabled, LDAP SNMP statistics are not reported.

To resolve this issue:

  1. Allow anonymous bind.

  2. Start the subagent.

  3. Disable/disallow anonymous bind.

Segmentation Fault Error while Accessing the Subagent

When a user tries to start the subagent (ndssnmpsa) by using an incorrect OpenText eDirectory password, a segmentation fault error occurs.

To avoid getting this error, ensure that you use the correct OpenText eDirectory password while starting the subagent.

Issues After Upgrading from OpenText eDirectory 8.7.3 to OpenText eDirectory 9.0

After upgrading from eOpenText Directory 8.7.3 to OpenText eDirectory 9.0, you might get the following error:

%%% Attempting to restart the NetIQ eDirectory SNMP subagent (ndssnmpsa)...
Starting NDS SNMP Subagent ...
Initialization failure. Error code : -255
Please Wait...
Done

%%% Unable to start ndssnmpsa... Please try starting it manually...

This error occurs because with OpenText eDirectory 9.0, OpenText eDirectory does not listen on the localhost. Earlier the ndssnmp.cfg file had SERVER localhost set by default.

To resolve this error, you need to manually edit the ndssnmp.cfg file and include the host name of the OpenText eDirectory server, which needs to be monitored.

For example, type the following in the ndssnmp.cfg file:

SERVER test-server

test-server is the hostname on which OpenText eDirectory is running on the default NCP port (that is 524). If OpenText eDirectory is running on a different port (for ex: 1524), the entry should be as follows:

SERVER test-server:1524

Errors While Starting the NDS Subagent

The subagent can fail with the following message:

Unable to load library: libnetsnmp.so

To resolve this, export the environment variable SNMP_MAJOR_VERSION with the net-snmp library’s (libnetsnmp.so) major version number. For example, you might use the following command:

export SNMP_MAJOR_VERSION=10

Restarting ndssnmpsa

When the master agent is restarted on Linux, ndssnmpsa needs to be restarted.

To restart ndssnmpsa, stop ndssnmpsa and then start it again.

To stop ndssnmpsa, enter the following command:

/etc/init.d/ndssnmpsa stop

To start ndssnmpsa, enter the following:

/etc/init.d/ndssnmpsa start

Compiling edir.mib

The OpenText eDirectory MIB file (<eDirectoryInstallRootDir>\snmp\edir.mib) on Windows compiles with some errors and warnings on HP OpenView. You can ignore these errors.

Modifying the SNMP Configuration File

If LDAP is not configured to run in clear text mode, the name of the trusted root certificate file must be given in the SNMP configuration file (for example, SSLKEY C:\Novell\nds\trust.der) before bringing up the OpenText eDirectory SNMP subagent.

ndssnmp.cfg is found in C:\novell\nds\snmp on Windows.

Using SNMP After a New Tree Installation

When you install OpenText eDirectory 9.0 for the first time (creating a new tree), if the Windows SNMP Service is installed on the server, and the SNMP Service has one or more dependent services, OpenText eDirectory cannot shut down the SNMP Service. If this happens, SNMP is not ready to use after the OpenText eDirectory installation.

Follow these steps to restart the SNMP service:

  1. Click Start > Settings > Control Panel > Administrative Tools > Services.

  2. Right-click SNMP Service in the Name list, then click Stop.

  3. Click Yes to All.

  4. Right-click SNMP Service in the Name list, then click Start.

Uninstalling SNMP with OpenText eDirectory Uninstallation

If the Windows SNMP Service is installed on a server, and the SNMP Service has one or more dependent services, the OpenText eDirectory uninstall does not delete all the SNMP files in the C:\novell\nds folder. However, the other uninstallation processes complete successfully, including the deletion of the SNMP registry entries, and the deconfiguration process that the OpenText SNMP agent does with DS and the SNMP Service.

To complete the uninstallation:

  1. Click Start > Settings > Control Panel > Administrative Tools > Services.

  2. Right-click SNMP Service in the Name list, then click Stop.

  3. Click Yes to All.

  4. Right-click SNMP Service in the Name list, then click Start.

  5. Manually delete the remaining SNMP files in the C:\novell\nds folder.

Installing OpenText eDirectory Stops SNMP on Windows 2012

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

SNMP subagent error -672

Workaround:

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

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

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

SNMP Subagent Fails to Load when EBA is Enabled

On a server where EBA is enabled, the SNMP agent fails to load. This happens after entering the command to load the SNMP agent (/etc/init.d/ndssnmpsa start) and providing the credentials. The error message returned depends on the value defined for the SERVER parameter in ndssnmp.cfg.

To workaround the issue:

  • Disable FIPS mode on your OpenText eDirectory server by setting n4u.server.fips_tls to 0.

  • Restart OpenText eDirectory.

The SERVER parameter must point to the server's hostname or IP address. The SERVER parameter is located in the ndssnmp.cfg file, which is found in /etc/opt/novell/eDirectory/conf/ndssnmp directory. By default, it is set to localhost, but it should be changed to either the IP address or hostname of the OpenText eDirectory server.