Configuring an LDBM database

After choosing to create an LDBM database, and clicking on the Configure button from the ``Add new backend database'' screen (see ``Specifying a database type''), the ``LDBM Database configuration'' screen appears. This supplies a number of data entry fields, and the following menu options:

• Index

  • Add ...

  • Modify ...

  • Delete

• Database

  • Generate database from LDIF file

  • Generate LDIF file from database

  • Delete all database entries

  • Rebuild all indexes

The ``In memory cache size'' field specifies a value for the cachesize option: similarly, the ``Database cache size'' field specifies a value for the dbcachesize option. See ``The entry cache'' and ``The DB cache'' for details of these options, and how they can promote system performance.

The ``Directory'' field is used to specify the pathname of the LDBM files containing the database and its accompanying indexes. Note that if the database directory is changed, a new LDBM database must be generated, unless one occupies the new directory already.

The ``File protection mode'' field specifies the file protection mode with which database index files are created. Refer to ``LDBM backend-specific options'' for details of the configuration file's mode option.

The ``Min ids'' field is used to specify a minimum number of entry IDs that an index entry will contain before it becomes an AllIDs entry. See ``The allIDs threshold'' for a description of this feature and its impact on performance. The value is stored in the min_maxids option of the configuration file (see ``LDBM backend-specific options'').

Managing LDBM database indexes

Indexes can be generated for particular attributes of the directory. Existing indexes are displayed (by attribute) in the ``Indexes'' field.

To add an index, select the Index Add menu option. The resulting screen prompts for the attribute to be indexed. Enter an attribute name or click on Select, which displays a list of attributes and accompanying descriptions. Click on OK and the selected attribute appears in the ``Add index data'' screen.

From the list, select the All option. The other options, such as Equal, are present for historical reasons only.

Click on the ``LDBM database configuration'' screen's OK button to generate the index.

Existing indexes can be reconfigured. Highlight the index, then select the Index Modify menu option. The resulting screen is the same as that supplied for the creation of new indexes.

Delete an index by selecting the Index Delete menu option.

The database menu options

The LDAP Manager supplies a range of LDBM database options via the Database menu.

To generate an LDBM database from an LDIF file, select the Database Generate database from LDIF file menu option, and enter the path and name of the file to be used. This operation is equivalent to using the ldif2ldbm(1Mldap) utility on the command line. Note that any existing database entries will be lost.

To generate a text file from an existing LDBM database (as a database backup, for example), select the Database Generate LDIF file from database menu option. This operation is equivalent to using ldbmcat(1Mldap).

The Database Delete all database entries menu option creates an empty LDBM database, while Database Rebuild all indexes option reconstructs all the database indexes.