NAME

vdadm - command line interface to do administrative tasks on Verdad


SYNOPSIS

 vdadm [command] [command-options]
   [command] is one of: index


DESCRIPTION

The following commands are supported:

index { is | tag }

Rebuilds the index tables used to do lookups on items by the is hierarchy, and lookups by tag name.

If the argument is "is", then only the inheritance relationships will be rebuilt. If the argument is "tag", then the tag index will be rebuilt. The default is to rebuild both.

The main time this operation used to be necessary was when some items had been added which had is tags that referenced items that did not exist. However, as of version 1.0.8, Verdad automatically adds items that are referred to by an is tag if they do not already exist. The stub item has a comment in it explaining where it came from.

This tool is still available for use in cases of index corruption.

During the index rebuild, other transactions, both read and write, will hang. This is a consequence of the way transaction control is handled with MySql.

The reindex operation is not atomic, and must not be interrupted once it begins. The first thing it does it wipe out the old index, so if it does not complete, inheritance will not work correctly until it has been run completely once. Making this operation safer is on the todo list, but for now please be careful not to stop it halfway.


AUTHOR

Jeff R. Allen <jra@nella.org>