git.sur5r.net Git - openldap/blob - doc/guide/admin/referrals.sdf

   1 # $OpenLDAP$
   2 # Copyright 1999-2000, The OpenLDAP Foundation, All Rights Reserved.
   3 # COPYING RESTRICTIONS APPLY, see COPYRIGHT.
   4 H1: Distributing {{I: slapd}} DATA
   5
   6 For many sites, running one or more {{I: slapds}} that hold an
   7 entire subtree of data is sufficient. But sometimes it may be
   8 desirable to have one slapd refer to other {{I: slapds}} for a
   9 certain part of the tree. This can be accomplished by
  10 creating a referral entry in one {{I:slapd}}'s database pointing
  11 to another {{I: slapd}}. For those familiar with X.500, a {{I:slapd}}
  12 {{I: referral}} entry is similar to an X.500 knowledge reference.
  13
  14 The referral entry acts as a mount point, glueing two slapd
  15 databases together. A referral entry has an {{I: objectclass}} of
  16 "referral" and is named by a {{I: ref}} attribute containing a URL
  17 pointing to the slapd holding the data below the mount
  18 point. This mechanism is very general and allows slapd
  19 databases that are not normally hierarchical to be grafted
  20 together.
  21
  22 An example should help illustrate things. Suppose your
  23 company is running a slapd and just purchased a new
  24 company, also running a slapd. You can easily connect
  25 the two databases by creating an entry like this in your
  26 slapd's database.
  27
  28 E: dn: ref="ldap://new.host/o=New Company,c=US", o=Your
  29
  30 company, c=US
  31
  32 E: objectclass: referral
  33
  34 Now any subtree search that has this entry in its scope
  35 will return a referral to the new company, in addition to any
  36 entries matched in your database. Referral-aware clients
  37 will continue the search at the new company's server.
  38
  39 A mechanism similar to this is used to support distributed
  40 indexing, described in Appendix C.
  41