Sun Directory Server Enterprise Edition 7.0 Administration Guide

Chapter 15 Directory Server Monitoring

Directory Server can be monitored using a variety of methods. These methods are described in Chapter 6, Directory Server Monitoring, in Sun Directory Server Enterprise Edition 7.0 Reference.

This chapter describes how to set up and administer monitoring in Directory Server.

This chapter covers the following topics:

Setting Up SNMP for Directory Server

This section describes how to set up your server to be monitored through SNMP.

For a description of SNMP implementation in Directory Server, see Directory Server and SNMP in Sun Directory Server Enterprise Edition 7.0 Reference.

To Set Up SNMP

For parts of this procedure, you can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help. Other parts of the procedure can only be done using the command line.

Enable the Java ES Monitoring Framework plug-in.

Use the procedure Enabling Java ES MF Monitoring. This procedure also enables the Common Agent Container, which is part of the Java ES MF.

Access the SNMP-managed objects defined by the MIB and exposed through the agents.

The tasks required for this step are entirely dependent on your SNMP management system. See your SNMP management system documentation for instructions.

When exposing the MIB, you might want to use the RFC text files for this MIB. These files are available at http://www.ietf.org/rfc/rfc2605.txtand http://www.ietf.org/rfc/rfc2788.txt.

Enabling Java ES MF Monitoring

If you want to use the Sun Java ES Monitoring Framework (Java ES MF) for monitoring, you must enable the Java ES MF plug-in.

For more information about administering the Java ES MF, see the Sun Java Enterprise System 5 Update 1 Monitoring Guide.

To Enable Java ES MF Monitoring

You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.

Initialize and register the Java ES Monitoring Framework.
$ dsccsetup mfwk-reg
For the location of this command, see Command Locations.

Enable the Java ES Monitoring Framework plug-in.

$ dsconf enable-plugin -h host -p port "Monitoring Plugin"
Enter "cn=Directory Manager" password:
Directory Server must be restarted for changes to take effect.

Restart the Directory Server instance.
$ dsadm restart instance-path

Verify that the Java ES Monitoring Framework plug-in is enabled.

$ dsconf get-plugin-prop -h host -p port -v "Monitoring Plugin"
Enter "cn=Directory Manager" password:
Reading property values of the plugin "Monitoring Plugin"...
argument          :
depends-on-named  :
depends-on-type   :  database
desc              :  Monitoring plugin
enabled           :  on
feature           :  Monitoring
init-func         :  mf_init
lib-path          :  /opt/SUNWdsee7/lib/sparcv9/mf-plugin.so
type              :  object
vendor            :  Sun Microsystems, Inc.
version           :  7.0

Troubleshooting Java ES MF Monitoring

If Java ES MF monitoring does not work, ensure that you have correctly installed the Common Agent Container, as described in Chapter 2, Installing Directory Server Enterprise Edition, in Sun Directory Server Enterprise Edition 7.0 Installation Guide.

If you are still experiencing problems, see the Sun Java Enterprise System 5 Update 1 Monitoring Guide.

Monitoring a Server Using `cn=monitor`

The following example shows how to view the general server statistics:

$ ldapsearch -h host -p port -D cn=admin,cn=Administrators,cn=config -w - \
 -s base -b "cn=monitor" "(objectclass=*)"

For a description of all monitoring attributes that are available in these entries, see Directory Server Monitoring Attributes in Sun Directory Server Enterprise Edition 7.0 Reference.

Many of the parameters that can be monitored reflect Directory Server performance, and are influenced by configuration and tuning. For more information about each of the configurable attributes, see the attribute man pages in Sun Directory Server Enterprise Edition 7.0 Man Page Reference.