2003-04-09 07:46:56 +08:00
|
|
|
.TH SLAPD-MONITOR 5 "RELEASEDATE" "OpenLDAP LDVERSION"
|
|
|
|
|
.\" Copyright 1998-2003 The OpenLDAP Foundation All Rights Reserved.
|
|
|
|
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
|
|
|
|
|
.\" $OpenLDAP$
|
|
|
|
|
.SH NAME
|
|
|
|
|
slapd-monitor \- Monitor backend to slapd
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
ETCDIR/slapd.conf
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The monitor backend to
|
|
|
|
|
.BR slapd (8)
|
|
|
|
|
is not an actual database; if enabled, it is automatically generated
|
2003-05-19 07:26:30 +08:00
|
|
|
and dynamically maintained by slapd with information about the running
|
|
|
|
|
status of the daemon.
|
2003-04-09 07:46:56 +08:00
|
|
|
|
|
|
|
|
.SH CONFIGURATION
|
|
|
|
|
These
|
|
|
|
|
.B slapd.conf
|
|
|
|
|
options apply to the monitor backend database.
|
|
|
|
|
That is, they must follow a "database monitor" line and come before any
|
|
|
|
|
subsequent "backend" or "database" lines.
|
|
|
|
|
As opposed to most databases, the monitor database can be instantiated
|
|
|
|
|
only once, i.e. only one occurrence of "database monitor" can occur
|
|
|
|
|
in the
|
|
|
|
|
.BR slapd.conf (5)
|
|
|
|
|
file.
|
|
|
|
|
Moreover, the suffix of the database cannot be explicitly set by means
|
|
|
|
|
of the
|
|
|
|
|
.B suffix
|
2003-05-19 07:26:30 +08:00
|
|
|
directive; on the contrary, the suffix is automatically set
|
|
|
|
|
to "\fIcn=Monitor\fP".
|
|
|
|
|
.LP
|
2003-04-09 07:46:56 +08:00
|
|
|
The
|
|
|
|
|
.B monitor
|
|
|
|
|
database honors the
|
|
|
|
|
.B rootdn
|
|
|
|
|
and the
|
|
|
|
|
.B rootpw
|
|
|
|
|
directives, and the usual ACL directives, e.g. the
|
|
|
|
|
.B access
|
|
|
|
|
directive.
|
2003-05-19 07:26:30 +08:00
|
|
|
.LP
|
|
|
|
|
The following directives can be used:
|
|
|
|
|
.TP
|
|
|
|
|
.B l <locality>
|
|
|
|
|
The
|
|
|
|
|
.B <locality>
|
|
|
|
|
string is added to the "\fIcn=Monitor\fP" entry as value of the
|
|
|
|
|
.B l
|
|
|
|
|
attribute (Note: this may be subjected to changes).
|
|
|
|
|
.LP
|
2003-04-09 07:46:56 +08:00
|
|
|
Other database options are described in the
|
|
|
|
|
.BR slapd.conf (5)
|
|
|
|
|
manual page.
|
|
|
|
|
.SH USAGE
|
|
|
|
|
The usage is:
|
2003-05-19 07:26:30 +08:00
|
|
|
.TP
|
2003-04-09 07:46:56 +08:00
|
|
|
1) enable the monitor backend at configure:
|
|
|
|
|
.LP
|
|
|
|
|
.RS
|
|
|
|
|
.nf
|
|
|
|
|
configure --enable-monitor
|
|
|
|
|
.fi
|
|
|
|
|
.RE
|
2003-05-19 07:26:30 +08:00
|
|
|
.TP
|
2003-04-09 07:46:56 +08:00
|
|
|
2) activate the monitor database in the
|
|
|
|
|
.BR slapd.conf (5)
|
|
|
|
|
file:
|
|
|
|
|
.LP
|
|
|
|
|
.RS
|
|
|
|
|
.nf
|
|
|
|
|
database monitor
|
|
|
|
|
.fi
|
|
|
|
|
.RE
|
2003-05-19 07:26:30 +08:00
|
|
|
.TP
|
2003-04-09 07:46:56 +08:00
|
|
|
3) add ACLs as detailed in
|
|
|
|
|
.BR slapd.access (5)
|
2003-05-19 07:26:30 +08:00
|
|
|
to control access to the database, e.g.:
|
2003-04-09 07:46:56 +08:00
|
|
|
.LP
|
|
|
|
|
.RS
|
|
|
|
|
.nf
|
|
|
|
|
access to dn.subtree="cn=Monitor"
|
|
|
|
|
by dn.exact="uid=Admin,dc=my,dc=org" write
|
|
|
|
|
by users read
|
|
|
|
|
by * none
|
|
|
|
|
.fi
|
|
|
|
|
.RE
|
2003-05-19 07:26:30 +08:00
|
|
|
.TP
|
|
|
|
|
4) ensure that the \fBcore.schema\fP file is loaded.
|
|
|
|
|
The monitor backend relies on some standard track attributeTypes
|
|
|
|
|
that must be already defined when the backend is started.
|
|
|
|
|
.SH KNOWN LIMITATIONS
|
|
|
|
|
The monitor backend does not honor size/time limits in search operations.
|
2003-04-09 07:46:56 +08:00
|
|
|
.SH FILES
|
|
|
|
|
.TP
|
|
|
|
|
ETCDIR/slapd.conf
|
|
|
|
|
default slapd configuration file
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
.BR slapd.conf (5),
|
|
|
|
|
.BR slapd.access (5),
|
|
|
|
|
.BR slapd (8),
|
|
|
|
|
.BR ldap (3).
|
|
|
|
|
|
