Red Hat Directory Server 8.0 Administrator's Guide

• 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
Appendix C, LDAP URLs.
4.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.
4.2.1. Setting a Default Referral Using the Console
Set a default referral to the directory, as follows:
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 in the Referrals to text box.
For example:
ldap://directory.example.com:389/dc=example,dc=com
Enter multiple referral URLs separated by spaces and in quotes, as follows:
"ldap://dir1.example.com:389/dc=example,dc=com" "ldap://dir2.example.com/"
For more information about LDAP URLs, see Appendix C, LDAP URLs.
5. Click OK.
4.2.2. Setting a Default Referral from the Command-Line
ldapmodify 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:
1
ldapmodify -h dir1.example.com -p 389 -D "cn=directory manager" -w secret
Setting Default Referrals
107