git.sur5r.net Git - openldap/blob - doc/man/man5/slapo-glue.5

   1 .TH SLAPO-GLUE 5 "RELEASEDATE" "OpenLDAP LDVERSION"
   2 .\" Copyright 2004-2005 The OpenLDAP Foundation All Rights Reserved.
   3 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   4 .\" $OpenLDAP$
   5 .SH NAME
   6 slapo-glue \- Backend Glue overlay
   7 .SH SYNOPSIS
   8 ETCDIR/slapd.conf
   9 .SH DESCRIPTION
  10 The Backend Glue overlay can be used to glue multiple databases into a
  11 single namingContext. The overlay must be configured on the root database
  12 of the context, and any other databases must be explicitly configured
  13 as subordinates of the root database. All of the participating databases
  14 should have identical rootdns.
  15
  16 All search and write operations will be intercepted by this overlay. Searches
  17 against the root database will be propagated to all the subordinates. Write
  18 operations will pass unaltered to the relevant target database. Note that
  19 any overlays on the root database configured before this overlay will fail
  20 to execute. As such, the glue overlay should always be the first overlay
  21 configured on the root database.
  22
  23 .SH CONFIGURATION
  24 These
  25 .B slapd.conf
  26 options apply to the Backend Glue overlay.
  27 They should appear after the
  28 .B overlay
  29 directive and before any subsequent
  30 .B database
  31 directive.
  32 .TP
  33 .B glue-sub <suffix-DN> [async] [advertise]
  34 Specify the suffix of a database to attach as a subordinate to the root
  35 database. The specified database must have already been configured. If the
  36 optional \fBasync\fP keyword is supplied, searches against this database may
  37 be spawned in a separate thread to run concurrently with other operations
  38 (currently not implemented).  If the optional \fBadvertise\fI flag
  39 is supplied, the naming context is advertised in the rootDSE.
  40 .SH FILES
  41 .TP
  42 ETCDIR/slapd.conf
  43 default slapd configuration file
  44 .SH SEE ALSO
  45 .BR slapd.conf (5).