JBoss.orgCommunity Documentation

Chapter 34. Searching index backup

34.1. Manual backup (file copy)
34.2. Consistency Requirements
34.3. JCR Backup Service

It can be useful for some reasons. The backup may be performed manually or using third part software.

You can make a copy of the search index ($AS_HOME/temp/jcrlucenedb) and use it to replace the current index by this copy in case of an index damaged or lost.

All repository changes that are applied between the index backup and the point of time when the backup index is restored, are not in the index and those modifications will not be found when searching. The modifications exist in the repository, but do not exist in the search index. And those changes will not be automatically reindexed.

For example: You have configured the workspace index to be in the "/index/workspace" directory.

If you want to find changes made after updating, you have to reindex the whole workspace content. The way to do this is to stop the repository container and delete the "/index/workspace" folder. The workspace database content will be reindexed on repository startup.

To have the workspace content consistent with the search index, the workspace database and the index directory should correspond to the same state. In case of an external (manual) backup the database backup and the index directory backup should be performed on a stopped/unmodifiable repository.

Only in that case the repository content and the search index will be consistent.

To get a hot-backup, which is executed on the fly, it's possible to use the Backup service which is available as a JCR Extension.

Note

Backup service supports full and incremental backup types. A Scheduler is available.