14 Directory Server Monitoring

Directory Server can be monitored using SNMP or using cn=monitor. These methods are described in Chapter 6, Directory Server Monitoring, in the Reference for Oracle Directory Server Enterprise Edition.

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

This chapter covers the following topics:

• Setting Up and Enabling SNMP for Directory Server

• Monitoring a Server Using cn=monitor

14.1 Setting Up and Enabling SNMP for Directory Server

For a description of SNMP implementation in Directory Server, see Directory Server and SNMP in the Reference for Oracle Directory Server Enterprise Edition.

14.1.1 To Set Up SNMP

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.txt and http://www.ietf.org/rfc/rfc2788.txt. Copies of these files exist in the directory install-path/resources/mibs.

14.1.2 Enabling SNMP Monitoring

Before You Begin. You must create and register a DSCC agent before you can enable SNMP. See "Set Up the Administration (DSCC) Host" in the Installation Guide for Oracle Directory Server Enterprise Edition.

Create an SNMP agent, and configure Directory Server instances to use the SNMP agent. You cannot use the web interface Directory Service Control Center (DSCC) to perform this task.

1. Run the following command to create the SNMP agent and enable SNMP monitoring.

   # install-path/bin/dsccagent enable-snmp 
   

2. Configure all Directory Server instances you want to monitor through SNMP.

   1. Run the following command to obtain the Directory Server port number for an instance you want to monitor through SNMP:

      # install-path/bin/dsccagent info
      Instance Path         :   install-dir/dsee7/var/dcc/agent
      Owner                 :   root
      JMX port              :   3997
      SNMP port             :   3996
      DS port               :   3995
      State                 :   Stopped
      PID                   :   -
      DSCC hostname         :   host2
      DSCC non-secure port  :   3998
      DSCC secure port      :   3999
      SNMP v3               :   Disabled
      Instance version      :   A-A00 
      

   2. To set the port number argument, run the following command using the Directory Server port number obtained in the previous step. In this example, the default DS port number 3995 was returned from the dsscagent info command:

      # install-patch/bin/set-plugin-prop dssnmp argument:on argument:3995
      

14.2 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 the Reference for Oracle Directory Server Enterprise Edition.

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 the Man Page Reference for Oracle Directory Server Enterprise Edition.