epugh commented on a change in pull request #769: URL: https://github.com/apache/solr/pull/769#discussion_r840782892
########## File path: solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-9.adoc ########## @@ -347,4 +373,818 @@ where they really belong: /admin/threads, /admin/properties, /admin/logging * Atomic/partial updates to nested documents now _require_ the `\_root_` field to clearly show the document isn't a root document. Solr 8 would fallback on the `\_route_` param but no longer. -* SolrJ: The project is migrating away from the Apache HttpClient dependency in favor of Jetty's client (supporting HTTP/2), to occur over the 9x releases. We deprecated HttpSolrClient and friends in favor of Http2SolrClient and equivalents. For SolrCloud, the former CloudSolrClient was renamed CloudLegacySolrClient (deprecated), and instead BaseCloudSolrClient was renamed to CloudSolrClient and given a Builder for the Jetty based HTTP/2 client. \ No newline at end of file +* SolrJ: The project is migrating away from the Apache HttpClient dependency in favor of Jetty's client (supporting HTTP/2), to occur over the 9x releases. We deprecated HttpSolrClient and friends in favor of Http2SolrClient and equivalents. For SolrCloud, the former CloudSolrClient was renamed CloudLegacySolrClient (deprecated), and instead BaseCloudSolrClient was renamed to CloudSolrClient and given a Builder for the Jetty based HTTP/2 client. + +=== Solr Binary Release `dist/` Directory + +The `dist/` directory in the Solr binary release has been removed as of Solr 9.0. + +* The `solr-core` and `solr-solrj` jars can be found under `server/solr-webapp/webapp/WEB-INF/lib/`. +* The Solr module jars can be found in `modules/<module-name>/lib`, packaged individually for each module. +* The `solrj-deps` (SolrJ Dependencies) are no longer separated out from the other Server jars. +Please refer to the SolrJ Maven artifact to see the exact dependencies you need to include from `server/solr-webapp/webapp/WEB-INF/lib/` and `server/lib/ext/` if you are loading in SolrJ manually. +If you plan on using SolrJ as a JDBC driver, please refer to the xref:query-guide:sql-query.adoc#generic-clients[JDBC documentation] + +[#major-changes-in-earlier-8-x-versions] +== Major Changes in Earlier 8.x Versions + +The following is a list of major changes released between Solr 8.1 and 8.11. + +Please be sure to review this list so you understand what may have changed between the version of Solr you are currently running and Solr 9.0. + +=== Solr 8.11 + +See the https://cwiki.apache.org/confluence/display/SOLR/Release+Notes+8.11[8.11 Release Notes^] +for an overview of the main new features of Solr 8.11. + +When upgrading to 8.11.x users should be aware of the following major changes from 8.10. + +*Support for Multiple Authentication Schemes* + +Two new authentication and authorization plugins provide support for configuring multiple authentication schemes. + +The `MultiAuthPlugin` allows combining two or more authentication approaches, such as JWT and Basic authentication. + +The `MultiAuthRuleBasedAuthorizationPlugin` is used when the `MultiAuthPlugin` is also in use, and combines the various roles defined for all plugins to determine the proper role assignment for the user account. + +For information on configuring these plugins, see the following sections: + +* xref:deployment-guide:basic-authentication-plugin.adoc#combining-basic-authentication-with-other-schemes[Combining Basic Authentication with Other Schemes] +* xref:deployment-guide:rule-based-authorization-plugin.adoc#multiple-authorization-plugins[Multiple Authorization Plugins] + + +*ZooKeeper chroot* + +It's now possible to create the ZooKeeper chroot at startup if it does not already exist. +See the section xref:deployment-guide:zookeeper-ensemble.adoc#using-the-z-parameter-with-binsolr[Using the -z Parameter with bin/solr] for an example. + +*Other Changes* + +A few other minor changes are worth noting: + +* The `config-read` pre-defined permission now correctly governs access for various configuration-related APIs. +See also xref:deployment-guide:rule-based-authorization-plugin.adoc#predefined-permissions[Predefined Permissions]. +* The S3BackupRepository supports configuring the AWS Profile, if necessary. See also xref:deployment-guide:backup-restore.adoc#s3backuprepository[S3BackupRepository]. +* Additionally, backups will now properly succeed after SPLITSHARD operations, and will correctly handle incremental backup purges. +* SolrJ now supports uploading configsets. + + + +=== Solr 8.10 + +See the https://cwiki.apache.org/confluence/display/SOLR/ReleaseNote8_10[8.10 Release Notes^] +for an overview of the main new features of Solr 8.10. + +When upgrading to 8.10.x users should be aware of the following major changes from 8.9. + +*Schema Designer UI* + +A new screen has been added to the Admin UI that allows you to interactively design a Solr schema using your documents. + +The designer screen provides a safe environment for you to: + +* Upload or paste sample documents to identify fields. +* Get a "first" guess at what Solr thinks the field types in the fields should be. +* Edit fields, field types, dynamic fields, and supporting files. +* See how a field's analysis will impact your text. +* Test how schema changes will impact query-time behavior. +* Save your changes to a configset to use with a new collection. + +See the section xref:indexing-guide:schema-designer.adoc[] for full details. + +*Backups in S3* + +Following the redesign of backups in Solr 8.8 that allowed storage of incremental backups in Google Cloud environments, Solr 8.10 provides support for storing backups in Amazon S3 buckets. + +See the section xref:deployment-guide:backup-restore.adoc#s3backuprepository[S3BackupRepository] for how to configure. + +*Security Admin UI* + +Solr's Admin UI also got a new screen to support management of users, roles, and permissions. + +The new UI works when authentication and/or authorization has been enabled with `bin/solr auth` or by manually installing a `security.json` file. +Before this, it provides a warning that your Solr instance is unsecured. + +See the section xref:deployment-guide:security-ui.adoc[] for details. + +*Solr SQL Improvements* Review comment: Never mind, I see that this is the chronological time line... -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org For additional commands, e-mail: issues-h...@solr.apache.org