HP-UX Directory Server 8.1 administrator guide

15.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, see the Net-SNMP website, http://www.net-snmp.org.
15.3 Configuring the subagent
The Directory Server SNMP subagent is installed with the Directory Server tools in /opt/
dirsrv/bin/ldap-agent.
15.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, log file location, and which Directory Server instances to monitor.
15.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 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 host name and port number. For example:
agentx-master localhost:705
15.3.1.2 agent-logdir
The agent-logdir setting specifies the directory where the subagent will write its log file. For
example:
agent-logdir /var/log
If this parameter is not specified, the agent will write its log file to the same location as your
subagent configuration file. The log file will be named ldap-agent.log.
Make sure that the user as whom your subagent is running has write permission to this directory.
15.3.1.3 server
The server setting specifies a Directory Server instance that you want to monitor. You must use
one server setting for each Directory Server instance. The subagent requires at least one server
setting to be specified in its configuration file. The server setting should be set to the name of the
Directory Server instance you would like to monitor. For example:
server slapd-phonebook
530 Monitoring Directory Server using SNMP