This is an automated email from the ASF dual-hosted git repository.
rahulgoswami pushed a commit to branch branch_10_1
in repository https://gitbox.apache.org/repos/asf/solr.git
The following commit(s) were added to refs/heads/branch_10_1 by this push:
new bafa4eb93b1 Document cuvs module breakage in Solr 10.1 (#5182)
bafa4eb93b1 is described below
commit bafa4eb93b164c8200bc4932d6ab9c50646208b2
Author: Rahul Goswami <[email protected]>
AuthorDate: Tue Oct 20 15:14:14 2026 -0400
Document cuvs module breakage in Solr 10.1 (#5182)
Co-authored-by: Claude Opus 5.5 <[email protected]>
(cherry picked from commit 1bd538700363db2045e670b8e49912d27095029a)
---
.../modules/query-guide/pages/dense-vector-search.adoc | 6 ++++++
.../upgrade-notes/pages/major-changes-in-solr-10.adoc | 12 ++++++++++++
2 files changed, 18 insertions(+)
diff --git
a/solr/solr-ref-guide/modules/query-guide/pages/dense-vector-search.adoc
b/solr/solr-ref-guide/modules/query-guide/pages/dense-vector-search.adoc
index 4a42f97cbe3..b7c90aabe8a 100644
--- a/solr/solr-ref-guide/modules/query-guide/pages/dense-vector-search.adoc
+++ b/solr/solr-ref-guide/modules/query-guide/pages/dense-vector-search.adoc
@@ -1033,6 +1033,12 @@ Details about using the ReRank Query Parser can be found
in the xref:query-guide
[NOTE]
This is feature is currently experimental.
+[WARNING]
+====
+Vector indexing with GPU acceleration does not work in Solr 10.1 (see
SOLR-18556), and is expected to be fixed in a subsequent Solr 10.x release.
+See
xref:upgrade-notes:major-changes-in-solr-10.adoc#cuvs-gpu-acceleration-broken[Major
Changes in Solr 10] for details.
+====
+
Building HNSW graphs, esp. with high dimensions and cardinality, is usually
slow. If you have a NVIDIA GPU, then building HNSW based indexes can be sped up
manifold. This is powered by the
https://github.com/rapidsai/cuvs-lucene[cuVS-Lucene] library, a pluggable
vectors format for Apache Lucene. It uses the state of the art
https://arxiv.org/abs/2308.15136[CAGRA algorithm] for quickly building a fixed
degree connected graph, which is then serialized into a HNSW graph.
https://developer.n [...]
You can know more about Nvidia's cuVS library here:
https://developer.nvidia.com/cuvs
diff --git
a/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-10.adoc
b/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-10.adoc
index 27b459f593a..f845e32ce1b 100644
---
a/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-10.adoc
+++
b/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-10.adoc
@@ -76,6 +76,18 @@ Streaming expressions and the cross-collection join query
parser now restrict wh
If you use these features to query another cluster, add its connection details
to the corresponding setting before upgrading.
+[#cuvs-gpu-acceleration-broken]
+=== GPU Acceleration (cuVS) Does Not Work in Solr 10.1
+
+[WARNING]
+====
+Vector indexing with the
xref:query-guide:dense-vector-search.adoc#gpu-acceleration[GPU Acceleration]
(cuVS) module (`CuVSCodecFactory` with `knnAlgorithm="cagra_hnsw"`) does not
work in Solr 10.1 (refer SOLR-18556 for updates).
+Solr 10.1 upgrades to Lucene 10.4, and a cuVS-lucene (library which powers the
GPU accelertion) library version compatible with Lucene 10.4 is not available
as of Solr 10.1 release.
+
+If you use GPU acceleration for vector indexing, skip Solr 10.1 and stay on
Solr 10.0.x.
+This is expected to be fixed in a subsequent Solr 10.x release.
+====
+
=== v2 API
Starting in Solr 10.1 it is no longer possible for users to disable the v2 API
by use of the `solr.api.v2.enabled` system property, and the Solr server and
tooling (`bin/solr`, Admin UI, etc.) will start using these APIs internally.
