Reindexing #

This page is for developers and administrators who keep the search index in step with the content. Publishing updates the index by itself; you reindex after events that bypass publishing.

Contents #

1. When to reindex
2. The commands
3. Large sites
4. Checking the result

When to reindex #

• After the install (the install command does it unless you pass --skip-indexing).
• After importing content or restoring a database.
• After switching search engines.
• After a content type change that affects searchable fields.
• After composer update when the content model schema may have changed (the guide's update steps include it).

The commands #

exponential:reindex is the primary name; ibexa:reindex is its alias.

php bin/console exponential:reindex                              # everything
php bin/console exponential:reindex --iteration-count=100        # batch size
php bin/console exponential:reindex --content-ids=2,34,68        # only these content items
php bin/console exponential:reindex --content-type=article       # one content type
php bin/console exponential:reindex --subtree=45                 # one subtree

With Solr, the guide forces a commit after indexing:

curl "http://localhost:8983/solr/<your core>/update?commit=true"

Large sites #

• Run it with --env=prod and outside busy hours.
• Lower --iteration-count when memory is tight; raise it when the database is fast and memory is plenty.
• The guide runs it "without memory limit in production" for big indexes; prefer a sensible batch size first.
• Rebuild one content type or subtree at a time when only part of the site changed.

Checking the result #

• Search in /adminui/ for a known recent item.
• With Solr, compare the number of documents with the number of content items.
• "Search results outdated" in Troubleshooting lists the usual causes.

Related pages #

• Search: the database engine and Solr
• Console commands and renames
• Platform console command names
• Free documentation: this page is free to copy, translate and improve under the GNU FDL 1.3.