eas restoring an index

Maintaining the index can be done by using the EAS command line tool eas. For all details eas, see the corresponding manual. In this howto, recommonded settings and maintenance operations are explained.

Rebuilding the index can be invoked as follows:

$ eas -c /path/to/store.ini -v --rebuild-index

Attention: Use these options carefully, as the data in existing indexes will be deleted completely:

• --rebuild-index: Resets the whole index and index all records and attachments again.
• --reset-index: Resets the whole index. Afterwards the index is empty and has to be rebuilt.
• --force-reset-index: As --reset-index, but allows also to reset corrupted indexes.

Recommended settings

Recommended settings for rebuilding/updating an index. For a complete list see the eas documentation:

• --no-attachments: Index the records first. Indexing the records is faster than indexing the attachments. As in the most cases, users search for data in the records, indexing the records first allows to reduce the downtime of the store significantly. Indexing the attachments can be done in a regular maintenance window or outside the business hours.
• --only-newest-version: The index contains all versions of a record. But in the default, search results only contains the newest version. So, if records have many versions, indexing the newest version first will also reduce the time for rebuilding the index. Indexing the earlier version can be done afterwards in a regular maintenance window or outside the business hours. Not needed, if the indexingMode=newestVersion is used. In this case, older versions will not be indexed by default.
• --threads: Specifies the number of threads for indexing. The more threads the faster the indexing. But depends on the amount of CPU cores available. Usually, one thread per CPU core will show an increase in the indexing performance. Depending on the environment, more threads will also result in an increased performance, but at some point the disk I/O becomes the bottleneck and adding more threads will show no effect.
• --exclusive-index-access: Opens the index exclusively. Increases the performance, as no coordination with other processes writing into the index is needed. But needs to stop the archive server.
• --stop-at-time: Sets the time (as ISO 8601 string) when the reindexing should be stopped. Allows to limit the reindexing to non-business hours.

Bsp. Aufruf zum updaten des Index:

eas -c /etc/eas/store1.ini --update-index