HP-UX Directory Server 8.1 administrator guide

Enter multiple referral URLs separated by spaces and in quotes:
"ldap://dir1.example.com:389/dc=example,dc=com"
"ldap://dir2.example.com/"
For more information about LDAP URLs, see Appendix C “LDAP URLs”.
2.5.2.2 Setting a default referral from the command line
The ldapmodify command can add a default referral to the cn=config entry in the directory's
configuration file. For example, to add a new default referral from one Directory Server,
dir1.example.com, to a server named dir2.example.com, add a new line to the cn=config
entry.
1. Run the ldapmodify utility:
ldapmodify -D "cn=directory manager" -w secret -p 389 -h server.example.com
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.
2.5.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.
2.5 Using referrals 91