ldif2index8

Overview

These programs are used to convert a database in text LDIF LDAP Directory Interchange Format (LDIF) to an LDBM database suitable for use by slapd(8). Normally, only ldif2ldbm is invoked by you. It will invoke the other programs as necessary. Occasionally, it may be necessary to invoke them by hand. For example, to create a new index file for an existing database, the ldif2index program can be invoked. The ldbmcat(8) program is used to do the reverse conversion.

See "The SLAPD and SLURPD Administrator's Guide" for more details on using these programs.

Options

The first three options apply to all four programs. The -j option is only for the ldif2ldbm program.

-i ldif-input-file

This option specifies the location of the LDIF input file containing the database to convert. It is required.

-d debug-level

Turn on debugging as defined by debug-level. Some general operation and status messages are printed for any value of debug-level. debug-level is taken as a bit string, with each bit corresponding to a different kind of debugging information. See <ldap.h> for details.

-f slapd-config-file

This option specifies the slapd configuration file. The default is /etc/openldap/slapd.conf.

-n database#

This option specifies the database number within slapd configuration file to build. The default is the 1, the first.

-s sbindir

This option specifies the location of dependent tools. The default is /usr/sbin.

-j number-of-jobs

This option only applies to the ldif2ldbm program. It specifies the level of parallelism to use when doing the conversion. ldif2ldbm invokes several other programs during the conversion process, most notably one invocation of ldif2index for each indexed attribute that appears in the LDIF input file. The -j option tells ldif2ldbm how many of these other programs it should run in parallel. This can speed up the conversion, but beware of starting too many processes in parallel, all competing for disk, memory, and cpu resources. The default is one.

Examples

To convert the file ldif.input into an LDBM database with indexes as described in the slapd config file /etc/openldap/slapd.conf, give the command:

	/usr/sbin/ldif2index -i ldif.input -f /etc/openldap/slapd.conf

To build the second database listed in /etc/openldap/slapd.conf, and to use three conversion sub-processes at a time, give this command:

	/usr/sbin/ldif2index -i ldif.input -f /etc/openldap/slapd.conf -n 2 -j 3 

Acknowledgements

OpenLDAP is developed and maintained by The OpenLDAP Project (http://www.openldap.org/). OpenLDAP is derived from University of Michigan LDAP 3.3 Release.