From 67eda7badbee278e8948c7678e65d9a792446913 Mon Sep 17 00:00:00 2001 From: Rahul Goswami Date: Fri, 16 Oct 2026 18:16:39 -0400 Subject: [PATCH 1/6] SOLR-18556: Document that cuVS GPU vector indexing is broken in Solr 10.1 cuvs-lucene 25.12 is not compatible with Lucene 10.4, which Solr 10.1 uses. Advise GPU users to skip 10.1 and stay on 10.0.x until a later 10.x release fixes it. Co-Authored-By: Claude Opus 5.5 --- .../query-guide/pages/dense-vector-search.adoc | 8 ++++++++ .../pages/major-changes-in-solr-10.adoc | 12 ++++++++++++ 2 files changed, 20 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 283a219cca45..cc34497b2270 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 @@ -1042,6 +1042,14 @@ 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 (SOLR-18556), because the bundled cuVS-Lucene library (25.12) is not compatible with Lucene 10.4. +If you use GPU acceleration, skip Solr 10.1 and stay on Solr 10.0.x. +This will be fixed in a subsequent 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.nvidia.com/cuda-downloads[CUDA 13.0+] and https://jdk.java.net/archive/[JDK 22] are required to use this feature. 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 d8450340a57b..d2ab02021719 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 @@ -52,6 +52,18 @@ The default command line interface is not changed. == Solr 10.1 +[#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 (SOLR-18556). +Solr 10.1 upgrades to Lucene 10.4, and the bundled cuVS-Lucene library (25.12) is not compatible with Lucene 10.4. + +If you use GPU acceleration for vector search, skip Solr 10.1 and stay on Solr 10.0.x. +This will be fixed in a subsequent 10.x release. +==== + === Misc For SSL (https), it's no longer necessary to set the "urlScheme" cluster property since the `SOLR_SSL_ENABLED` env var (or `solr.ssl.enabled` sys-prop) suffices. From c33d25b777fc15a7a83810b584a2c9be3b758d71 Mon Sep 17 00:00:00 2001 From: Rahul Goswami Date: Sun, 18 Oct 2026 21:28:49 -0400 Subject: [PATCH 2/6] Move the note in major-changes-in-solr-10.adoc further down --- .../pages/major-changes-in-solr-10.adoc | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) 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 d2ab02021719..2cb3693efe60 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 @@ -52,18 +52,6 @@ The default command line interface is not changed. == Solr 10.1 -[#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 (SOLR-18556). -Solr 10.1 upgrades to Lucene 10.4, and the bundled cuVS-Lucene library (25.12) is not compatible with Lucene 10.4. - -If you use GPU acceleration for vector search, skip Solr 10.1 and stay on Solr 10.0.x. -This will be fixed in a subsequent 10.x release. -==== - === Misc For SSL (https), it's no longer necessary to set the "urlScheme" cluster property since the `SOLR_SSL_ENABLED` env var (or `solr.ssl.enabled` sys-prop) suffices. @@ -104,6 +92,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 (SOLR-18556). +Solr 10.1 upgrades to Lucene 10.4, and the bundled cuVS-Lucene library (25.12) is not compatible with Lucene 10.4. + +If you use GPU acceleration for vector search, skip Solr 10.1 and stay on Solr 10.0.x. +This will be fixed in a subsequent 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. From 5a01f60da30c9bb56566eff3ce30257c0bc0d778 Mon Sep 17 00:00:00 2001 From: Rahul Goswami Date: Mon, 19 Oct 2026 12:05:29 -0400 Subject: [PATCH 3/6] reword and eliminate note duplication --- .../modules/query-guide/pages/dense-vector-search.adoc | 4 +--- .../upgrade-notes/pages/major-changes-in-solr-10.adoc | 6 +++--- 2 files changed, 4 insertions(+), 6 deletions(-) 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 cc34497b2270..7978a5fe723f 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 @@ -1044,9 +1044,7 @@ This is feature is currently experimental. [WARNING] ==== -Vector indexing with GPU acceleration does not work in Solr 10.1 (SOLR-18556), because the bundled cuVS-Lucene library (25.12) is not compatible with Lucene 10.4. -If you use GPU acceleration, skip Solr 10.1 and stay on Solr 10.0.x. -This will be fixed in a subsequent 10.x release. +Vector indexing with GPU acceleration does not work in Solr 10.1 (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. ==== 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 2cb3693efe60..e4566383e5cb 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 @@ -98,10 +98,10 @@ If you use these features to query another cluster, add its connection details t [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 (SOLR-18556). -Solr 10.1 upgrades to Lucene 10.4, and the bundled cuVS-Lucene library (25.12) is not compatible with Lucene 10.4. +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 search, skip Solr 10.1 and stay on Solr 10.0.x. -This will be fixed in a subsequent 10.x release. +If you use GPU acceleration for vector indexing, skip Solr 10.1 and stay on Solr 10.0.x. +This will be fixed in a subsequent Solr 10.x release. ==== === v2 API From cfc20184bf1baefb7e1bfc42a6a685398c688df5 Mon Sep 17 00:00:00 2001 From: Rahul Goswami Date: Mon, 19 Oct 2026 12:21:58 -0400 Subject: [PATCH 4/6] reword --- .../modules/upgrade-notes/pages/major-changes-in-solr-10.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 e4566383e5cb..7d2062bcd6a5 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 @@ -101,7 +101,7 @@ Vector indexing with the xref:query-guide:dense-vector-search.adoc#gpu-accelerat 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 will be fixed in a subsequent Solr 10.x release. +This is expected to be fixed in a subsequent Solr 10.x release. ==== === v2 API From e46b53f747d4e9e86cf456accf7dff1d7bb78e57 Mon Sep 17 00:00:00 2001 From: Rahul Goswami Date: Mon, 19 Oct 2026 12:29:09 -0400 Subject: [PATCH 5/6] add the language to reference JIRA for updates --- .../modules/upgrade-notes/pages/major-changes-in-solr-10.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 7d2062bcd6a5..a4c92703870b 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 @@ -97,7 +97,7 @@ If you use these features to query another cluster, add its connection details t [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 (SOLR-18556). +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. From 4ce719d74b13fc3969683a2dcf9cd0d8eb4aa233 Mon Sep 17 00:00:00 2001 From: Rahul Goswami Date: Mon, 19 Oct 2026 13:22:34 -0400 Subject: [PATCH 6/6] add 'see' to reference JIRA --- .../modules/query-guide/pages/dense-vector-search.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 7978a5fe723f..878f38a1b695 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 @@ -1044,7 +1044,7 @@ This is feature is currently experimental. [WARNING] ==== -Vector indexing with GPU acceleration does not work in Solr 10.1 (SOLR-18556), and is expected to be fixed in a subsequent Solr 10.x release. +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. ====