Creating Suffix Referrals - Red Hat DIRECTORY SERVER 8.0 - ADMINISTRATION Administration Manual

7. The Smart Referral List lists the referrals currently in place for the selected entry. The entire list
of referrals is returned to client applications in response to a request with the Return Referrals for
All Operations or Return Referrals for Update Operations options in the Suffix Settings tab,
which is available under the Configuration tab.
To modify the list, click Edit to edit the selected referral or Delete to delete the selected referral.
8. Click OK.
3.4.3.2. Creating Smart Referrals from the Command Line
Use the ldapmodify command-line utility
To create a smart referral, create the relevant directory entry, and add the referral object class.
This object class allows a single attribute, ref. The ref attribute must contain an LDAP URL.
For example, add the following to return a smart referral for an existing entry, uid=jdoe:
dn: uid=jdoe,ou=people,dc=example,dc=com
objectclass: referral
ref: ldap://directory.europe.example.com/cn=john%20doe,ou=people,l=europe,dc=example,dc=com
NOTE
Any information after a space in an LDAP URL is ignored by the server. For this reason,
use %20 instead of spaces in any LDAP URL used as a referral.
To add the entry uid=jdoe,ou=people,dc=example,dc=com with a referral to
directory.europe.example.com, include the following in the LDIF file before importing:
dn: uid=jdoe, ou=people,dc=example,dc=com
objectclass: top
objectclass: person
objectclass: organizationalperson
objectclass: inetOrgPerson
objectclass: referral
cn: john doe
sn: doe
uid: jdoe
ref: ldap://directory.europe.example.com/cn=john%20doe,ou=people, l=europe,dc=example,dc=com
Use the -M option with ldapmodify when there is already a referral in the DN path. For information
about the ldapmodify utility, see the Directory Server Configuration, Command, and File Reference.

3.4.4. Creating Suffix Referrals

The following procedure describes creating a referral in a suffix. This means that the suffix processes
operations using a referral rather than a database or database link.
WARNING
When a suffix is configured to return referrals, the ACIs contained by the database
associated with the suffix are ignored.
1
to create smart referrals from the command line.
Creating Suffix Referrals
91