Red Hat Directory Server 8.0 Administrator's Guide

ldapmodify binds to the server and prepares it to change an entry in the configuration file.
2. Add the default referral to the dir2.example.com server:
dn: cn=config
changetype: modify
replace: nsslapd-referral
nsslapd-referral: ldap://dir2.example.com/
After adding the default referral to the cn=config entry of the directory, the directory will return
the default referral in response to requests made by client applications. The Directory Server
does not need to be restarted.
4.3. Creating Smart Referrals
Smart referrals map a directory entry or directory tree to a specific LDAP URL. Using smart
referrals, client applications can be referred 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. A smart referral is returned to the client that points
to the entry cn=john doe,o=people,l=europe,dc=example,dc=com on the server
directory.europe.example.com.
The way the directory uses smart referrals conforms to the standard specified in RFC 2251
section 4.1.11. The RFC can be downloaded at http://www.ietf.org/rfc/rfc2251.txt.
4.3.1. Creating Smart Referrals Using the Directory Server Console
To configure smart referrals, do the following:
1.
In the Directory Server Console, select the Directory tab.
2. Browse through the tree in the left navigation pane, and select the entry for which to add the
referral.
3. Right-click the entry, and select Set Smart Referrals.
The Edit Smart Referrals dialog box opens.
4. Select the Enable Smart Referral option to define smart referrals for the selected entry.
(Unchecking the option removes all smart referrals from the entry and deletes the referral
object class from the entry.)
5. In the Enter a new Smart Referral field, enter a referral in the LDAP URL format, and then
click Add to add the referral to the list. The LDAP URL must be in the following format:
Chapter 3. Configuring Directory Databases
108