You can enable search indexing by selecting Search under System Settings, and then toggling Enable search.
When using Whoosh, the Search index directory field must be filled
out to specify the desired directory where the search index will be stored.
This must be writable by the web server. We recommend creating this within your
Elasticsearch requires a running server to connect to. After selecting Elasticsearch, you can enter the Elasticsearch URL and Elasticsearch index name in the search settings form.
This currently requires a version of Elasticsearch prior to 5.0. Elasticsearch 5+ introduced some non-trivial changes which are not yet supported by the framework that Review Board uses for search.
Scheduled Indexing vs. On-The-Fly Indexing¶
Whichever configuration you use, you will need to set up indexing. This can be done either with a scheduled crontab or on-the-fly.
Enabling on-the-fly indexing will cause Review Board to update the search index whenever a relevant change is made. Because of performance concerns, we recommend only using this with the Elasticsearch backend.
If you want to use scheduled indexes, you will need to set up a scheduled
command to run periodically to update the search index. On Linux or other
Unix-based systems with cron, you can install the provided
crontab file. This is available at
conf/cron.conf under your site
directory. For example, to install the crontab for the current user, type:
$ crontab /path/to/site/conf/cron.conf
We recommend doing this as the web server user, to ensure that permissions are correct to write to the index directory.
The default crontab will perform an index update every 10 minutes.
Whether you are using scheduled indexing or on-the-fly, you will need to perform one full index when you first enable search. To do this, type the following (as the web server user, if using Whoosh):
$ rb-site manage /path/to/site rebuild_index
For more information on generating search indexes, see the section on the Search Indexing management command.
Users should now be able to use the search box located on any page. See the documentation on Full-Text Search to see what types of things you can search for.