Setting A Default Referral From The Command-Line; Creating Smart Referrals - Red Hat DIRECTORY SERVER 7.1 - ADMINISTRATOR Administrator's Manual

Using Referrals

Setting a Default Referral from the Command-Line

Use the
cn=config
For example, to add a new default referral from your Directory Server,
dir1.example.com
cn=config
the utility:
cd serverRoot/shared/bin
Then, run the
ldapmodify -h dir1.example.com -p 389 -D "cn=directory manager"
-w secret
The
ldapmodify
the configuration file.
Next, you add the default referral to the
dn: cn=config
changetype: modify
replace: nsslapd-referral
nsslapd-referral: ldap://dir2.example.com/
Once you have added the default referral to the
directory, the directory will return the default referral in response to requests
made by client applications. You do not need to restart the server.

Creating Smart Referrals

Smart referrals allow you to map a directory entry or directory tree to a specific
LDAP URL. Using smart referrals, you can refer client applications to a specific
server or a specific entry on a specific server.
For example, a client application requests the directory entry
uid=jdoe,ou=people,dc=example,dc=com
client which points to the entry
doe,o=people,l=europe,dc=example,dc=com
directory.europe.example.com
The way the directory uses smart referrals conforms to the standard specified in
RFC 2251 section 4.1.11. For more information, go to
http://www.ietf.org/rfc/rfc2251.txt
144 Red Hat Directory Server Administrator's Guide • May 2005
command-line utility to add a default referral to the
ldapmodify
entry in your directory's configuration file.
, to a server named
entry. First, type the following to change to the directory containing
utility, as follows:
ldapmodify
utility binds to the server and prepares it to change an entry in
dir2.example.com
dir2.example.com
cn=config
. You return a smart referral to the
cn=john
on the server
.
to read the RFC.
, add a new line to the
server:
entry of your