Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 150 / 612

Adding the Distribution Function to Your Directory
150 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
You can create the root entry in two ways:
• Import the same LDIF file into each database using the
ldif2db
command-line
utility.
This LDIF file should contain the root entry as well as data that you want to
distribute across the databases. Only the data determined by the distribution
function to be appropriate for each database will be imported.
• Create an LDIF file that contains the root entry. You can do this by exporting
the root entry (for example,
o=example.com
) in LDIF format using the
ldapsearch
command-line utility.
Then, import the LDIF file into each database using the
ldif2db
command-line
utility. If you have three databases for a single suffix, you need to import the
suffix entry three times.
When a subtree search is performed above a suffix that is distributed among
several databases, the search will be performed on all databases. This means that
the shared suffix entry that you create on each database (in the example,
o=example.com
) can be returned multiple times.
Adding the Distribution Function to Your Directory
To declare the distribution function to your directory, your need to add multiple
databases to a single suffix and then declare the distribution function in the suffix.
These procedures assume you have already created a suffix and associated it with a
single database. For the procedure on creating a new suffix and database, refer to
Chapter 2, “Creating Directory Entries,” in the Netscape Directory Server
Administrator’s Guide.
NOTE You need to add all of the databases required for your distribution
algorithm before you deploy entry distribution. You cannot add
more databases later without changing the algorithm.
Whenever you install new distribution functions, be sure to restart
the Directory Server. Otherwise, the new libraries will not get
loaded properly.