Adding Multiple Databases For A Single Suffix - Red Hat DIRECTORY SERVER 8.0 - ADMINISTRATION Administration Manual

3.2.1.2. Creating a New Database for a Single Suffix from the Command
Line
Use the ldapmodify command-line utility to add a new database to the directory
configuration file. The database configuration information is stored in the cn=ldbm
database,cn=plugins,cn=config entry.
For example, add a new database to the server example1:
1. Run ldapmodify:
ldapmodify -a -h example1 -p 389 -D "cn=directory manager" -w secret
The ldapmodify utility binds to the server and prepares it to add an entry to the configuration file.
2. Create the entry for the new database.
dn: cn=UserData,cn=ldbm database,cn=plugins,cn=config
objectclass: extensibleObject
objectclass: nsBackendInstance
nsslapd-suffix: ou=people,dc=example,dc=com
The entry added corresponds to a database named UserData that contains the data for the root
or sub suffix ou=people,dc=example,dc=com.
3. Create a root or sub suffix, as described in
the Command Line". The database name, given in the DN attribute, must correspond with the
value in the nsslapd-backend attribute of the suffix entry.

3.2.1.3. Adding Multiple Databases for a Single Suffix

A single suffix can be distributed across multiple databases. However, to distribute the suffix, a custom
distribution function has to be created to extend the directory. For more information on creating a
custom distribution function, contact Red Hat Professional Services.
NOTE
Once entries have been distributed, they cannot be redistributed. The following restrictions
apply:
• The distribution function cannot be changed once entry distribution has been deployed.
• The LDAP modrdn operation cannot be used to rename entries if that would cause
them to be distributed into a different database.
• Distributed local databases cannot be replicated.
• The ldapmodify operation cannot be used to change entries if that would cause them
to be distributed into a different database.
Violating these restrictions prevents Directory Server from correctly locating and returning
entries.
After creating a custom distribution logic plug-in, add it to the directory.
1
Section 3.1.1.3, "Creating Root and Sub Suffixes from
Creating Databases
49