Netscape NETSCAPE DIRECTORY SERVER 6.02, Administrator'S Manual

Page: 133 / 568

Using Referrals
Chapter 3 Configuring Directory Databases 133
Setting a Default Referral From the Command Line
Use the
ldapmodify
command-line utility to add a default referral to the
cn=config
entry in your directory configuration file.
For example, to add a new default referral from your Directory Server,
example.com
, to a server named
zanzibar.com
, add a new line to the
cn=config
entry. First, type the following to change to the directory containing the utility:
cd /usr/netscape/servers/shared/bin
Then, run the
ldapmodify
utility as follows:
ldapmodify -h example.com -p 389 -D "cn=directory manager" -w secret
The
ldapmodify
utility binds to the server and prepares it to change an entry in
the configuration file.
Next, you add the default referral to the
zanzibar.com
server:
dn: cn=config
changetype: modify
replace: nsslapd-referral
nsslapd-referral: ldap://zanzibar.com/
Once you have added the default referral to the
cn=config
entry of your 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 following directory entry:
uid=bjensen,ou=people,dc=example,dc=com
. You return a smart referral to the
client which points to the entry
cn=babs
jensen,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. For more information, go to
http://www.ietf.org/rfc/rfc2251.txt to read the RFC.
The following procedures describe creating smart referrals using both the console
and the command-line utilities.