From cbee3d2762266fce816e748277034830380d2f10 Mon Sep 17 00:00:00 2001
From: Saman Ghannadzadeh <saman.ghannadzadeh@tokamakenergy.co.uk>
Date: Fri, 28 Mar 2025 16:16:47 +0000
Subject: [PATCH] Make solr-config-9.xml compatible with Solr 9.8.0

Changes:

  * remove `numVersionBuckets` which is obsolete and ignored'
  * remove `<lib ..>`, and instead leave a comment for user to enable modules
---
 doc/solr-config-9.xml | 59 ++++++-------------------------------------
 1 file changed, 8 insertions(+), 51 deletions(-)

diff --git a/doc/solr-config-9.xml b/doc/solr-config-9.xml
index 8b001aebaea..ef4b9f3f0c9 100644
--- a/doc/solr-config-9.xml
+++ b/doc/solr-config-9.xml
@@ -37,53 +37,17 @@
   -->
   <luceneMatchVersion>9.8</luceneMatchVersion>
 
-  <!-- <lib/> directives can be used to instruct Solr to load any Jars
-       identified and use them to resolve any "plugins" specified in
-       your solrconfig.xml or schema.xml (ie: Analyzers, Request
-       Handlers, etc...).
+  <!-- You need to add enable the use of the `analysis-extras` module, by either:
 
-       All directories and paths are resolved relative to the
-       instanceDir.
+       * modifying the "solr.modules" parameter in solr.xml to include "analysis-extras",
+         e.g. set: <str name="modules">${solr.modules:analysis-extras}</str>
+       * adding "-Dsolr.modules=analysis-extras" to the solr start command line;
+       * setting the "SOLR_MODULES=analysis-extras" environment variable before starting
+         solr.
 
-       Please note that <lib/> directives are processed in the order
-       that they appear in your solrconfig.xml file, and are "stacked"
-       on top of each other when building a ClassLoader - so if you have
-       plugin jars with dependencies on other jars, the "lower level"
-       dependency jars should be loaded first.
-
-       If a "./lib" directory exists in your instanceDir, all files
-       found in it are included as if you had used the following
-       syntax...
-
-              <lib dir="./lib" />
-    -->
-
-  <!-- A 'dir' option by itself adds any files found in the directory
-       to the classpath, this is useful for including all jars in a
-       directory.
-
-       When a 'regex' is specified in addition to a 'dir', only the
-       files in that directory which completely match the regex
-       (anchored on both ends) will be included.
-
-       If a 'dir' option (with or without a regex) is used and nothing
-       is found that matches, a warning will be logged.
-
-       The example below can be used to load a Solr Module along
-       with their external dependencies.
-    -->
-    <!-- <lib dir="${solr.install.dir:../../../..}/modules/ltr/lib" regex=".*\.jar" /> -->
-
-    <!-- Load ICU analyser -->
-    <lib dir="${solr.install.dir:../../../..}/modules/analysis-extras/lib" regex="icu4j-.*\.jar"/>
-    <lib dir="${solr.install.dir:../../../..}/modules/analysis-extras/lib" regex="lucene-analysis-icu-.*\.jar"/>
-  <!-- an exact 'path' can be used instead of a 'dir' to specify a
-       specific jar file.  This will cause a serious error to be logged
-       if it can't be loaded.
+       If there are other modules that need be listed, you can use a comma-delimeted list
+       (e.g. "analysis-extras,<other module>").
     -->
-  <!--
-     <lib path="../a-jar-that-does-not-exist.jar" />
-  -->
 
   <!-- Data Directory
 
@@ -259,16 +223,9 @@
          is recommended (see below).
          "dir" - the target directory for transaction logs, defaults to the
                 solr data directory.
-         "numVersionBuckets" - sets the number of buckets used to keep
-                track of max version values when checking for re-ordered
-                updates; increase this value to reduce the cost of
-                synchronizing access to version buckets during high-volume
-                indexing, this requires 8 bytes (long) * numVersionBuckets
-                of heap space per Solr core.
     -->
     <updateLog>
       <str name="dir">${solr.ulog.dir:}</str>
-      <int name="numVersionBuckets">${solr.ulog.numVersionBuckets:65536}</int>
     </updateLog>
 
     <!-- AutoCommit