Red Hat Directory Server 8.0 Configuration, Command, and File Reference

3.1.76. nsslapd-referral (Referral)
This multi-valued attribute specifies the LDAP URLs to be returned by the suffix when the server
receives a request for an entry not belonging to the local tree; that is, an entry whose suffix
does not match the value specified on any of the suffix attributes. For example, assume the
server contains only entries:
ou=People,dc=example,dc=com
but the request is for this entry:
ou=Groups,dc=example,dc=com
In this case, the referral would be passed back to the client in an attempt to allow the LDAP
client to locate a server that contains the requested entry. Although only one referral is allowed
per Directory Server instance, this referral can have multiple values.
NOTE
To use SSL and TLS communications, the referral attribute should be in the form
ldaps://server-location.
Start TLS does not support referrals.
For more information on managing referrals, see the "Configuring Directory Databases" chapter
in the Directory Server Administrator's Guide.
Parameter Description
Entry DN cn=config
Valid Values Any valid LDAP URL in the form
ldap://server-location
Default Value
Syntax DirectoryString
Example nsslapd-referral: ldap://ldap.example.com
3.1.77. nsslapd-referralmode (Referral Mode)
When set, this attribute sends back the referral for any request on any suffix.
Chapter 2. Core Server Configuration Reference
50