slapo-glue.5 2.62 KB
Newer Older
1
.TH SLAPO-GLUE 5 "RELEASEDATE" "OpenLDAP LDVERSION"
Kurt Zeilenga's avatar
Kurt Zeilenga committed
2
.\" Copyright 2004-2005 The OpenLDAP Foundation All Rights Reserved.
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
.\" $OpenLDAP$
.SH NAME
slapo-glue \- Backend Glue overlay
.SH SYNOPSIS
ETCDIR/slapd.conf
.SH DESCRIPTION
The Backend Glue overlay can be used to glue multiple databases into a
single namingContext. The overlay must be configured on the root database
of the context, and any other databases must be explicitly configured
as subordinates of the root database. All of the participating databases
should have identical rootdns.

All search and write operations will be intercepted by this overlay. Searches
against the root database will be propagated to all the subordinates. Write
Kurt Zeilenga's avatar
Kurt Zeilenga committed
18
19
20
operations will pass unaltered to the relevant target database.

Note that
21
22
23
24
25
26
27
28
29
30
31
32
33
any overlays on the root database configured before this overlay will fail
to execute. As such, the glue overlay should always be the first overlay
configured on the root database.
.SH CONFIGURATION
These
.B slapd.conf
options apply to the Backend Glue overlay.
They should appear after the
.B overlay
directive and before any subsequent
.B database
directive.
.TP
Kurt Zeilenga's avatar
Kurt Zeilenga committed
34
.B glue-sub <suffix-DN> [async] [advertise]
35
36
Specify the suffix of a database to attach as a subordinate to the root
database. The specified database must have already been configured. If the
Kurt Zeilenga's avatar
Kurt Zeilenga committed
37
38
optional \fBasync\fP keyword is supplied, searches against this database may
be spawned in a separate thread to run concurrently with other operations
39
(currently not implemented).  If the optional \fBadvertise\fP flag 
Kurt Zeilenga's avatar
Kurt Zeilenga committed
40
is supplied, the naming context is advertised in the root DSE.
Kurt Zeilenga's avatar
Kurt Zeilenga committed
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
.SH EXAMPLE
The following will cause a search from dc=example,dc=com to search
people as well, but it will not search services.
.LP
.RS
.nf
database  bdb
suffix    "ou=people,dc=example,dc=com"

database  bdb
suffix    "ou=services,dc=example,dc=com"

database  bdb
suffix    "dc=example,dc=com"
overlay   glue
glue-sub  "ou=people,dc=example,dc=com"
.fi
.RE
.SH NOTES
Databases that are glued together should usually be configured with
the same indexes, even for attributes that only exist in some of
these databases.
A search for an attribute which is only indexed in some of the glued
databases must otherwise examine each entry in the search scope in the
other databases, looking for the attribute.

If the extra indexes assist searches one would prefer not to
support, these can be disabled with access controls in some of the
databases.
E.g.:
.RS
access to attrs=cn by * =rcxd
.RE
See
.BR slapd.access (5).
76
77
78
79
80
81
.SH FILES
.TP
ETCDIR/slapd.conf
default slapd configuration file
.SH SEE ALSO
.BR slapd.conf (5).