svn commit: r1082717 [3/3] - in /sites/solr/guide: sitemap.xml solr/9_2/upgrade-notes/major-changes-in-solr-9.html solr/9_2/upgrade-notes/solr-upgrade-notes.html

[sv...@apache.org]

Modified: sites/solr/guide/solr/9_2/upgrade-notes/major-changes-in-solr-9.html
URL: http://svn.apache.org/viewvc/sites/solr/guide/solr/9_2/upgrade-notes/major-changes-in-solr-9.html?rev=1082717&r1=1082716&r2=1082717&view=diff
==============================================================================
--- sites/solr/guide/solr/9_2/upgrade-notes/major-changes-in-solr-9.html (original)
+++ sites/solr/guide/solr/9_2/upgrade-notes/major-changes-in-solr-9.html Fri Mar 24 15:20:13 2023
@@ -1180,12 +1180,6 @@ Due to changes in Lucene 9, that isn&#82
 <li>
 <p>Solr upgraded to Jetty 10.x from 9.x due to Jetty 9.x is now end of life. Jetty 10.x has a Java 11 minimum and matches Solr 9 minimum Java version. Jetty logging has been replaced with slf4j again matching Solr. See <a href="https://webtide.com/jetty-10-and-11-have-arrived/" class="bare">https://webtide.com/jetty-10-and-11-have-arrived/</a> for additional Jetty 10.x highlights.</p>
 </li>
-<li>
-<p>Loading solr.xml from Zookeeper is deprecated. See <a href="../configuration-guide/configuring-solr-xml.html" class="xref page">Configuring solr.xml</a>.</p>
-</li>
-<li>
-<p>The <a href="../query-guide/analytics.html" class="xref page">Analytics Component</a> has been deprecated. Consider using <a href="../query-guide/json-facet-api.html" class="xref page">JSON Facet API</a> as a substitute. Please notify the project if there&#8217;s functionality you need that isn&#8217;t currently covered by JSON facets.</p>
-</li>
 </ul>
 </div>
 </div>
@@ -1220,9 +1214,7 @@ This is what has been documented in <a h
 <div class="ulist">
 <ul>
 <li>
-<p>A new <code>opentelemetry</code> module is added, with support for OTEL tracing in <code>OTLP</code> format using gRPC.
-At the same time, the <code>jaegertracer-configurator</code> module is deprecated for removal in Solr 10.
-Users should start migrating to the new module to prepare for a smooth transition.</p>
+<p>A new <code>opentelemetry</code> module is added, with support for OTEL tracing in <code>OTLP</code> format using gRPC.</p>
 </li>
 </ul>
 </div>
@@ -1251,6 +1243,22 @@ the <code>solrj-streaming</code> artifac
 </ul>
 </div>
 </div>
+<div class="sect2">
+<h3 id="deprecations"><a class="anchor" href="#deprecations"></a>Deprecations</h3>
+<div class="ulist">
+<ul>
+<li>
+<p>Loading solr.xml from Zookeeper is deprecated. See <a href="../configuration-guide/configuring-solr-xml.html" class="xref page">Configuring solr.xml</a>.</p>
+</li>
+<li>
+<p>The <a href="../query-guide/analytics.html" class="xref page">Analytics Component</a> has been deprecated. Consider using <a href="../query-guide/json-facet-api.html" class="xref page">JSON Facet API</a> as a substitute. Please notify the project if there&#8217;s functionality you need that isn&#8217;t currently covered by JSON facets.</p>
+</li>
+<li>
+<p>The <code>jaegertracer-configurator</code> module is deprecated for removal in Solr 10. Users should start migrating to the new <code>opentelemetry</code> module.</p>
+</li>
+</ul>
+</div>
+</div>
 </div>
 </div>
 <div class="sect1">
@@ -1288,6 +1296,15 @@ Instead of depending on ZooKeeper, consi
 Not only does this reduce dependencies, but it improves security by being able to limit ZooKeeper access.</p>
 </div>
 </div>
+<div class="sect2">
+<h3 id="zookeeper"><a class="anchor" href="#zookeeper"></a>Zookeeper</h3>
+<div class="paragraph">
+<p>Zookeeper Credentials support now follows a new paradigm.
+Old classes, such as <code>VMParamsAllAndReadonlyDigestZkACLProvider</code> and <code>VMParamsSingleSetCredentialsDigestZkCredentialsProvider</code>, are deprecated but still supported until at least <code>10.0</code>.
+Users are encouraged to upgrade to the non-deprecated classes before the next major version release.
+Please refer to <a href="../deployment-guide/zookeeper-access-control.html#solr-to-zookeeper-acls-workflow" class="xref page">deployment-guide:zookeeper-access-control.adoc#solr-to-zookeeper-acls-workflow</a> for more information.</p>
+</div>
+</div>
 </div>
 </div>
 <div class="sect1">

Modified: sites/solr/guide/solr/9_2/upgrade-notes/solr-upgrade-notes.html
URL: http://svn.apache.org/viewvc/sites/solr/guide/solr/9_2/upgrade-notes/solr-upgrade-notes.html?rev=1082717&r1=1082716&r2=1082717&view=diff
==============================================================================
--- sites/solr/guide/solr/9_2/upgrade-notes/solr-upgrade-notes.html (original)
+++ sites/solr/guide/solr/9_2/upgrade-notes/solr-upgrade-notes.html Fri Mar 24 15:20:13 2023
@@ -1088,10 +1088,8 @@
 <div id="preamble">
 <div class="sectionbody">
 <div class="paragraph">
-<p>The following notes describe changes to Solr in recent releases that you should be aware of before upgrading.</p>
-</div>
-<div class="paragraph">
-<p>These notes highlight the important changes that may impact the largest number of implementations.
+<p>This section provides changes to Solr in recent releases that you should be aware of before upgrading.
+These notes highlight the important changes that may impact the largest number of implementations.
 It is not a comprehensive list of all changes to Solr in any release.</p>
 </div>
 <div class="paragraph">
@@ -1104,21 +1102,46 @@ that may affect your existing implementa
 <div class="paragraph">
 <p>Detailed steps for upgrading a Solr cluster are in the section <a href="../deployment-guide/upgrading-a-solr-cluster.html" class="xref page">Upgrading a Solr Cluster</a>.</p>
 </div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="how-to-use-the-major-changes-pages"><a class="anchor" href="#how-to-use-the-major-changes-pages"></a>How to use the Major Changes pages</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The Major Changes pages are grouped in two ways:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>For Solr versions <code>9.y+</code>:
+The <code>Major Changes in Solr <em>x</em></code> (e.g. <a href="major-changes-in-solr-9.html" class="xref page">Major Changes in Solr 9</a>) pages include all changes included in any <code>x.y</code> release.
+Therefore <a href="major-changes-in-solr-9.html" class="xref page">Major Changes in Solr 9</a> includes all changes in any Solr <code>9.x</code> release.</p>
+</li>
+<li>
+<p>For Solr versions <code>6.y</code>-<code>8.y</code>:
+The <code>Major Changes in Solr <em>x</em></code> (e.g. <a href="major-changes-in-solr-8.html" class="xref page">Major Changes in Solr 8</a>) pages include all changes from Solr <code><em>(x-1)</em>.0</code> to Solr <code><em>x</em>.0</code>.
+Therefore <a href="major-changes-in-solr-8.html" class="xref page">Major Changes in Solr 8</a> includes all changes from Solr <code>7.0</code> to Solr <code>8.0</code>, starting with Solr <code>7.1</code>.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>In these pages, the first section describes planning for an upgrade to that major version from the previous major version,
+including system requirements, rolling upgrade concerns and re-indexing recommendations.
+All other sections are version-specific and include relevant changes in each minor version.</p>
+</div>
 <div class="paragraph">
-<p>Zookeeper Credentials support now follows a new paradigm.
-Old classes, such as <code>VMParamsAllAndReadonlyDigestZkACLProvider</code> and <code>VMParamsSingleSetCredentialsDigestZkCredentialsProvider</code>, are deprecated but still supported until at least <code>10.0</code>.
-Users are encouraged to upgrade to the non-deprecated classes before the next major version release.
-Please refer to <a href="../deployment-guide/zookeeper-access-control.html#solr-to-zookeeper-acls-workflow" class="xref page">deployment-guide:zookeeper-access-control.adoc#solr-to-zookeeper-acls-workflow</a> for more information.</p>
+<p>It is imperative to carefully review each section for the versions preceding and including the version you are upgrading to.
+(i.e. If you are upgrading from Solr 8.9 to 9.2, you will need to read the upgrade notes for 8.10, 8.11, 9.0, 9.1 and 9.2)</p>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="upgrading-to-9-0-from-8-x-releases"><a class="anchor" href="#upgrading-to-9-0-from-8-x-releases"></a>Upgrading to 9.0 from 8.x Releases</h2>
+<h2 id="upgrading-to-9-x-from-8-x-releases"><a class="anchor" href="#upgrading-to-9-x-from-8-x-releases"></a>Upgrading to 9.x from 8.x Releases</h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>The upgrade from 8.x to Solr 9.0 introduces several <strong>major</strong> changes that you should be aware of before upgrading.
-These changes are described in the section <a href="major-changes-in-solr-9.html" class="xref page">Major Changes in Solr 9</a>.
-It&#8217;s strongly recommended that you thoroughly review that section before starting your upgrade.</p>
+<p>The upgrade from 8.x to Solr 9.x introduces several <strong>major</strong> changes that you should be aware of before upgrading.
+These changes are described in the <a href="major-changes-in-solr-9.html" class="xref page">Major Changes in Solr 9</a> page.
+It&#8217;s strongly recommended that you thoroughly review that page before starting your upgrade.</p>
 </div>
 <div class="admonitionblock note">
 <table>