verify-index — check index for consistency or errors


verify-index {options}


This utility ensures that index data is consistent within an indexed backend database. Stop the server before running this tool.


The verify-index command takes the following options:

Command options:

-b | --baseDn {baseDN}

Base DN of a backend supporting indexing. Verification is performed on indexes within the scope of the given base DN.

-c | --clean

Specifies that a single index should be verified to ensure it is clean. An index is clean if each index value references only entries containing that value. Only one index at a time may be verified in this way.

Default: false


Count the number of errors found during the verification and return that value as the exit code (values > 255 will be reduced to 255 due to exit code restrictions).

Default: false

-i | --index {index}

Name of an index to be verified. For an attribute index this is simply an attribute name. Multiple indexes may be verified for completeness, or all indexes if no indexes are specified. An index is complete if each index value references all entries containing that value.

General options:

-V | --version

Display Directory Server version information.

Default: false

-H | --help

Display this usage information.

Default: false

Exit Codes


The command completed successfully.


The command was run in non-interactive mode, but could not complete because confirmation was required to run a long or critical task.

See the error message or the log for details.


The number of errors in the index, as indicated for the --countErrors option.


The following example shows how to verify the sn (surname) index for completeness and for errors:

$ verify-index --baseDn dc=example,dc=com --index sn --clean --countErrors
... msg=Maximum number of entries referenced by any record is 32
Read a different version of :