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

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