test

Sun Java System Directory Server Enterprise Edition 6.2 Administration Guide

Chapter 15 Directory Server Monitoring

Directory Server can be monitored using a variety of methods. These methods are described in Chapter 3, Directory Server Monitoring, in Sun Java System Directory Server Enterprise Edition 6.2 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 Java System Directory Server Enterprise Edition 6.2 Reference.

ProcedureTo 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.

  1. Enable the Java ES Management 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.

  2. 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 Management 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 Monitoring Guide.

ProcedureTo 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.

  1. Initialize and register the Java ES Monitoring Framework.


    $ dsccsetup mfwk-reg

    For the location of this command, see Command Locations.

  2. Enable the Java ES Management 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.

  3. Restart the Directory Server instance.


    $ dsadm restart instance-path

  4. Verify that the Java ES Management 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/SUNWdsee/ds6/lib/mf-plugin.so
type              :  object
vendor            :  Sun Microsystems, Inc.
version           :  6.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 6.2, in Sun Java System Directory Server Enterprise Edition 6.2 Installation Guide.

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

Monitoring a Server Using cn=monitor

Server status, replication status, resource usage, and other monitoring information is available through DSCC.

Alternatively, you can monitor the Directory Server’s current activities from any LDAP client by performing a search operation on the following entries: