Creating Suffix Referrals From The Command-Line - Red Hat DIRECTORY SERVER 7.1 - ADMINISTRATOR Administrator's Manual

Using Referrals
Click Add to add the referral to the list.
5.
You can enter multiple referrals. The directory will return the entire list of
referrals in response to requests from client applications.
Click Save.
6.

Creating Suffix Referrals from the Command-Line

Use the
your directory configuration file. The suffix referral information is added to the
root or sub suffix entry under the
For example, to add a new suffix referral to the
root suffix, you run
directory containing the utility:
cd serverRoot/shared/bin
Then, run
ldapmodify -a -h example.com -p 389 -D "cn=directory manager" -w
secret
The
ldapmodify
the configuration file.
Next, you add a suffix referral to the
as follows:
dn: cn="ou=people,dc=example,dc=com",cn=mapping tree,cn=config
objectclass: extensibleObject
objectclasss: nsmappingtree
nsslapd-state: referral
nsslapd-referral: ldap://zanzibar.com/
The
nsslapd-state
returned for requests made to this suffix. The
contains the LDAP URL of the referral returned by the suffix, in this case a referral
to the
You can also set the
means that the database is used for all operations except update requests. When a
client application makes an update request to a suffix set to
the client receives a referral.
For more information about the suffix configuration attributes, refer to Table 3-1,
on page 85.
148 Red Hat Directory Server Administrator's Guide • May 2005
command-line utility to add a suffix referral to an entry in
ldapmodify
ldapmodify
, as follows:
ldapmodify
utility binds to the server and prepares it to add information to
attribute is set to
server.
zanzibar.com
nsslapd-state
cn=mapping tree,cn=config
ou=people,dc=example,dc=com
. First, type the following to change to the
ou=people,dc=example,dc=com
, meaning that a referral is
referral
nsslapd-referral
attribute to
referral on update
branch.
root suffix,
attribute
. This
referral on update
,