HP-UX Directory Server Administrator Guide HP-UX Directory Server Version 8.1 (5900-3098, May 2013)

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 “LDAP URLs” (page 570).
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.3.1 Creating smart referrals using the Directory Server Console
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.
88 Configuring Directory Databases