Configuring Snmp Traps; Configuring The Directory Server For Snmp - Red Hat DIRECTORY SERVER 8.0 - ADMINISTRATION Administration Manual

Chapter 14. Monitoring Directory Server Using SNMP
Each monitored server instance uses its port number as an index to identify that particular Directory
Server instance. For example, querying for the dsEntityName.389 SNMP variable returns the
variable value for a server running on port 389, assuming that instance exists and is being monitored
by the subagent.
For details on configuring and using the Net-SNMP command-line tools, check out the Net-SNMP
website, http://www.net-snmp.org.

14.4. Configuring SNMP Traps

An SNMP trap is essentially a threshold which triggers a notification if it is encountered by the
monitored server. To use traps, the master agent must be configured to accept traps and do something
with them. For example, a trap can trigger an email notification for an administrator of the Directory
Server instance stops.
The subagent is only responsible for sending the traps to the master agent. The master agent and a
trap handler must be configured according to the documentation for the SNMP master agent you are
using.
Traps are accompanied by information from the Entity Table, which contains information specific
to the Directory Server instance, such as its name and version number. The Entity Table is
Section 14.6.3, "Entity
described in
when it receives a trap is flexible, such as sending an email to an email address defined in the
dsEntityContact variable for one instance while sending a notification to a a pager number in the
dsEntityContact variable for another instance.
There are two traps supported by the subagent:
• DirectoryServerDown. This trap is generated whenever the subagent detects the Directory Server
is potentially not running. This trap will be sent with the Directory Server instance description,
version, physical location, and contact information, which are detailed in the dsEntityDescr,
dsEntityVers, dsEntityLocation, and dsEntityContact variables.
• DirectoryServerStart. This trap is generated whenever the subagent detects that the Directory
Server has started or restarted. This trap will be sent with the Directory Server instance description,
version, physical location, and contact information, which are detailed in the dsEntityDescr,
dsEntityVers, dsEntityLocation, and dsEntityContact variables.

14.5. Configuring the Directory Server for SNMP

By default, the Directory Server is ready to be monitored using SNMP as soon as the subagent is
configured. However, there are some useful variables in the Directory Server instances which can be
configured to help identify the Directory Server instance with SNMP. To configure these SNMP settings
from the Directory Server Console, do the following:
1. Select the Configuration tab, and then select the topmost entry in the navigation tree in the left
pane.
2. Select the SNMP tab in the right pane.
3. Enter a description that uniquely describes the directory instance in the Description text box.
4. Type the name the company or organization to which the directory belongs in the Organization
text box.
396
Table". This means that the action the master agent takes