Red Hat DIRECTORY SERVER 8.0, Administration Manual, Page: 412 / 552

Chapter 14. Monitoring Directory Server Using SNMP
394
14.2. Configuring the Master Agent
To use the subagent, you must have a master agent that supports AgentX. A common agent is
Net-SNMP master agent, which may be available through your operating system vendor or can be
downloaded from the Net-SNMP website,
http://www.net-snmp.org
.
The SNMP subagent included with Directory Server uses the AgentX protocol to communicate with
the SNMP master agent running on your system. You must make sure that you enable AgentX support
on your master agent. For Net-SNMP, add a line containing
agentx master
in the master agent's
snmpd.conf
file. For more details on configuring the master agent for AgentX support, refer to the
Net-SNMP website,
http://www.net-snmp.org
.
14.3. Configuring the Subagent
The Directory Server SNMP subagent is located in installed with the Directory Server tools. On Red
Hat Enterprise Linux and Solaris, this is in
/usr/bin/ldap-agent
. On HP-UX, this is in
/opt/
dirsrv/bin/ldap-agent
.
14.3.1. Subagent Configuration File
To use the subagent, first create a subagent configuration file. This file can be named and located
wherever you like. This configuration file is used to specify how to communicate with your master
agent, logfile location, and which Directory Server instances to monitor.
14.3.1.1. agentx-master
The
agentx-master
setting tells the subagent how to communicate with the SNMP master agent. If
this setting is not specified, the subagent tries to communicate the the master agent through the Unix
domain socket
/var/agentx/master
. This is also where the Net-SNMP master agent listens for
AgentX communications by default. If you configured your master agent to listen on a different Unix
domain socket, you must use the agentx-master setting for your subagent to communicate with your
master agent by setting the new path for the
agentx-master
parameter. For example:
agentx-master /var/snmp/agentx
Make sure that the user as whom you are running the subagent has the appropriate permissions to
write to this socket.
If the master agent is listening for AgentX communications on a TCP port, the
agentx-master
setting has the hostname and port number. For example:
agentx-master localhost:705
14.3.1.2. agent-logdir
The
agent-logdir
setting specifies the directory where the subagent will write its logfile. For
example:
agent-logdir /var/log
If this parameter is not specified, the agent will write its logfile to the same location as your subagent
configuration file. The logfile will be named
ldap-agent.log
.