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

2.5.1 Starting the server in referral mode
Referrals are used to redirect client applications to another server while the current server is
unavailable or when the client requests information that is not held on the current server. For
example, starting Directory Server in referral mode while there are configuration changes being
made to the Directory Server will refer all clients to another supplier while that server is unavailable.
Starting the Directory Server in referral mode is done with the refer option.
Run ns-slapd with the refer option.
/opt/dirsrv/sbin/ns-slapd refer -D /opt/dirsrv/slapd-instance_name [-p port] -r referral_url
• /opt/dirsrv/slapd-instance_name is the directory where the Directory Server
configuration files reside.
• port is the optional port number of the Directory Server to start in referral mode.
• referral_url is the referral returned to clients. The format of an LDAP URL is covered in
“LDAP URLs” (page 570).
2.5.2 Setting default referrals
Default referrals are returned to client applications that submit operations on a DN not contained
within any of the suffixes maintained by the directory. The following procedures describes setting
a default referral for the directory using the console and the command line utilities.
2.5.2.1 Setting a default referral using the console
1. In the Directory Server Console, select the Configuration tab.
2. Select the top entry in the navigation tree in the left pane.
3. Select the Settings tab in the right pane.
4. Enter an LDAP URL for the referral.
2.5 Using Referrals 87