[lucene-solr] branch branch_8x updated: SOLR-15145: Fix up changes.txt for 8.8.1 release

[th...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

thelabdude pushed a commit to branch branch_8x
in repository https://gitbox.apache.org/repos/asf/lucene-solr.git


The following commit(s) were added to refs/heads/branch_8x by this push:
     new 650b037  SOLR-15145: Fix up changes.txt for 8.8.1 release
650b037 is described below

commit 650b03752850c80a0bd3eb33fb2cdafc417b4ecc
Author: Timothy Potter <th...@gmail.com>
AuthorDate: Thu Feb 11 13:53:46 2021 -0700

    SOLR-15145: Fix up changes.txt for 8.8.1 release
---
 solr/CHANGES.txt                                | 13 +++++++++----
 solr/solr-ref-guide/src/solr-upgrade-notes.adoc | 10 ++++++++++
 2 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/solr/CHANGES.txt b/solr/CHANGES.txt
index db4aa67..daab4f0 100644
--- a/solr/CHANGES.txt
+++ b/solr/CHANGES.txt
@@ -33,16 +33,21 @@ Bug Fixes
 ---------------------
 * SOLR-15078: Fix ExpandComponent behavior when expanding on numeric fields to differentiate '0' group from null group (hossman)
 
+Other Changes
+---------------------
+* SOLR-15118: Deprecate CollectionAdminRequest.getV2Request(). (Jason Gerlowski)
+
+==================  8.8.1 ==================
+
+Bug Fixes
+---------------------
+
 * SOLR-15145: System property to control whether base_url is stored in state.json to enable back-compat with older SolrJ versions.
   (Timothy Potter)
 
 * SOLR-15114: Fix bug that caused WAND optimization to be disabled in cases where the max score is requested (such as
   multi-shard requests in SolrCloud) (Naoto Minami via Tomás Fernández Löbbe)
 
-Other Changes
----------------------
-* SOLR-15118: Deprecate CollectionAdminRequest.getV2Request(). (Jason Gerlowski)
-
 ==================  8.8.0 ==================
 
 Consult the LUCENE_CHANGES.txt file for additional, low level, changes in this release.
diff --git a/solr/solr-ref-guide/src/solr-upgrade-notes.adoc b/solr/solr-ref-guide/src/solr-upgrade-notes.adoc
index 7729625..06423e0 100644
--- a/solr/solr-ref-guide/src/solr-upgrade-notes.adoc
+++ b/solr/solr-ref-guide/src/solr-upgrade-notes.adoc
@@ -96,6 +96,16 @@ The default Prometheus Exporter configuration includes metrics like queries-per-
 Plugin developers using `SolrPaths.locateSolrHome()` or 'new `SolrResourceLoader`' should check deprecation warnings as existing some existing functionality will be removed in 9.0.
 https://issues.apache.org/jira/browse/SOLR-14934[SOLR-14934] has more technical details about this change for those concerned.
 
+base_url removed from stored state*
+
+As of Solr 8.8.0, the `base_url` property was removed from the stored state for replicas (SOLR-12182). If you're able to upgrade SolrJ to 8.8.x
+for all of your client applications, then you can set `-Dsolr.storeBaseUrl=false` (introduced in Solr 8.8.1) to better align the stored state
+in Zookeeper with future versions of Solr. However, if you are not able to upgrade SolrJ to 8.8.x for all client applications,
+then leave the default `-Dsolr.storeBaseUrl=true` so that Solr will continue to store the `base_url` in Zookeeper.
+
+You may also see some NPE in collection state updates during a rolling upgrade to 8.8.0 from a previous version of Solr. After upgrading all nodes in your cluster
+to 8.8.0, collections should fully recover. Trigger another rolling restart if there are any replicas that do not recover after the upgrade to re-elect leaders.
+
 === Solr 8.7
 
 See the https://cwiki.apache.org/confluence/display/SOLR/ReleaseNote87[8.7 Release Notes^]