ilariapet created SOLR-18100:
--------------------------------
Summary: Improve Combined Query Feature Documentation
Key: SOLR-18100
URL: https://issues.apache.org/jira/browse/SOLR-18100
Project: Solr
Issue Type: Improvement
Components: vector-search
Reporter: ilariapet
I investigated the Combined Query feature to write a blog post about it, and I
found a few aspects of the documentation that, in my opinion, are unclear and
should be improved (I can take care of addressing them).
In particular:
*- Configuration section*
The part that explains the configuration is not very clear.
{{maxCombinerQueries}} is a parameter that must be specified in the
{{{}searchComponent{}}}, not in the handler.
The search component is shown only to explain the custom algorithm part, so it
is not obvious that it is mandatory even when using the default algorithm.
Otherwise, a {{NullPointerException}} is thrown.
*- Solr Standalone - Distributed Search*
As explained
[here|[https://solr.apache.org/guide/solr/latest/deployment-guide/user-managed-distributed-search.html#allowurls-parameter]]:
{{allowUrls}} is automatically configured for SolrCloud, but it requires
explicit configuration for user-managed setups.
Therefore, when executing the combined query *without* starting Solr with:
{code:java}
--jvm-opts "-Dsolr.security.allow.urls=http://localhost:8983/solr/"; {code}
the following error is returned:
"errorClass": "org.apache.solr.common.SolrException",
"msg": "The 'shards' parameter value 'http://localhost:8983/solr/test'
contained value(s) not allowed: URL http://localhost:8983/solr/test is neither
a live node of the cluster nor in the configured 'allowUrls' []. Set
-Dsolr.security.allow.urls.enabled=false to disable URL allow-list checks."
This should be explicitly mentioned in the documentation.
*- Custom plugin section*
The section about the custom plugin is not detailed enough to clearly explain
how it should be used, especially for users who are not experienced with Solr
and do not want to dig into the internal implementation.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
