silverstripe-fulltextsearch/docs/en/06_troubleshooting.md
Ingo Schommer 8876a47f0d NEW Ensure commits are visible to seachers (fixes #274)
This is required in situations where autoCommit.openSearcher is set to "false",
and you don't want to rely on core restarts to make committed index updates available to new searches.
It's already configured like this in the Common Web Platform environments,
so this change will mainly affect other environments (such as Silverstripe Platform).
To opt out of this new behaviour, set up a custom solrconfig.xml.

More details in https://github.com/silverstripe/silverstripe-fulltextsearch/issues/274
2020-04-07 17:22:43 +12:00

1.2 KiB
Raw Blame History

Troubleshooting

Newly indexed content only shows in searches after a delay

First, check how you're running index operations. In many cases where the queuedjobs module is installed, saving or publishing a record will create a new index job which needs to complete first. Solr also distinguishes between adding documents to the indexing, committing them, and making them available to new searches. In most cases this happens within a few seconds, but in sometimes it can take up to a minute due to the autoSoftCommit configuration setting defaults in your solrconfig.xml. To find out more detail, read about soft vs. hard commits.

Common gotchas

  • By default number-letter boundaries are treated as a word boundary. For example, A1 is two words - a and 1 - when Solr parses the search term.
  • Special characters and operators are not correctly escaped
  • Multi-word synonym issues
  • When Solr indexes are reconfigured and reindexed, their content is trashed and rebuilt

CWP-specific

  • solrconfig.xml customisations fail silently
  • Developers arent able to test raw queries or see output via the Solr admin interface