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:
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.
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 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.
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.
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.
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 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. |
Restart the Directory Server instance.
$ dsadm restart instance-path |
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 |
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.
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:
cn=monitor
cn=monitor, cn=ldbm database, cn=plugins, cn=config
cn=monitor,cn=dbName,cn=ldbm database,cn=plugins,cn=config
dbName is the database name of the suffix that you want to monitor. Note that except for information about each connection, by default, the cn=monitor entry is readable by anyone, including clients bound anonymously.
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 ServerMonitoring Attributes in Sun Java System Directory Server Enterprise Edition 6.2 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 Java System Directory Server Enterprise Edition 6.2 Man Page Reference.