Setting Default Referrals - Red Hat DIRECTORY SERVER 8.0 - ADMINISTRATION Administration Manual

• 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.

3.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.
3.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
5. Click OK.
3.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:
ldapmodify -h dir1.example.com -p 389 -D "cn=directory manager" -w secret
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/
Appendix C, LDAP
1
Setting Default Referrals
Appendix C,
URLs.
89