[lucene-solr] branch master updated: SOLR-13256: Add ref-guide upgrade notes for 7.7

[ge...@apache.org]

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

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


The following commit(s) were added to refs/heads/master by this push:
     new 3b326e6  SOLR-13256: Add ref-guide upgrade notes for 7.7
3b326e6 is described below

commit 3b326e6244937b58dcb6a500f9b59f34bf6d3ce7
Author: Jason Gerlowski <ge...@apache.org>
AuthorDate: Mon Mar 4 09:32:07 2019 -0500

    SOLR-13256: Add ref-guide upgrade notes for 7.7
---
 solr/solr-ref-guide/src/solr-upgrade-notes.adoc | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/solr/solr-ref-guide/src/solr-upgrade-notes.adoc b/solr/solr-ref-guide/src/solr-upgrade-notes.adoc
index 1b46a06..eb0aa3d 100644
--- a/solr/solr-ref-guide/src/solr-upgrade-notes.adoc
+++ b/solr/solr-ref-guide/src/solr-upgrade-notes.adoc
@@ -38,6 +38,26 @@ If even this slight risk is unacceptable, the log4j configuration file ../server
 
 == Upgrading to 7.x Releases
 
+=== Solr 7.7
+
+See the https://wiki.apache.org/solr/ReleaseNote77[7.7 Release Notes] for an overview of the main new features in Solr 7.7.
+
+When upgrading to Solr 7.7.x, users should be aware of the following major changes from v7.6:
+
+*Admin UI*
+
+* The Admin UI now presents a login screen for any users with authentication enabled on their cluster.  Clusters with <<basic-authentication-plugin.adoc#basic-authentication-plugin,Basic Authentication>> will prompt users to enter a username and password.  On clusters configured to use <<kerberos-authentication-plugin.adoc#kerberos-authentication-plugin,Kerberos Authentication>>, users will be directed to configure their browser to provide an appropriate Kerberos ticket.
++
+The login screen's purpose is cosmetic only - Admin UI-triggered Solr requests were subject to authentication prior to 7.7 and still are today.  The login screen changes only the user experience of providing this authentication.
+
+*Distributed Requests*
+
+* The `shards` parameter, used to manually select the shards and replicas that receive distributed requests, now checks nodes against a whitelist of acceptable values for security reasons.
++
+In SolrCloud mode this whitelist is automatically configured to contain all live nodes.  In standalone mode the whitelist is empty by default.  Upgrading users who use the `shards` parameter in standalone mode can correct this value by setting the `shardsWhitelist` property in any `shardHandler` configurations in their `solrconfig.xml` file.
++
+For more information, see the <<distributed-requests.adoc#configuring-the-shardhandlerfactory,Distributed Request>> documentation.
+
 === Solr 7.6
 
 See the https://wiki.apache.org/solr/ReleaseNote76[7.6 Release Notes] for an overview of the main new features in Solr 7.6.