Skip to content

armgit / solr

Public Imported from GitHub
0

Apache Solr open-source search software

Ref Guide: Upgrade notes for 8.9 part 2

Cassandra Targetta44ff778b541
diff --git a/solr/solr-ref-guide/src/solr-upgrade-notes.adoc b/solr/solr-ref-guide/src/solr-upgrade-notes.adoc
index c78b39e1762..ac0e3064acf 100644
--- a/solr/solr-ref-guide/src/solr-upgrade-notes.adoc
+++ b/solr/solr-ref-guide/src/solr-upgrade-notes.adoc
@@ -50,10 +50,11 @@ When upgrading to 8.9.x users should be aware of the following major changes fro
Solr 8.9 introduces extensive changes to Solr's backup and restore support.
A new backup format has been introduced in Solr 8.9 which replaces the previous snapshot-based backup.
-The new backup format supports incremental backups.
+This new format enables ‘incremental’ backups.
+Repeated backups to a given location will take advantage of the data stored by their predecessors and will only operate on files that have changed since the previous backup.
This is supported by default, simply by storing each backup file in the same location.
-The old and new formats are not compatible, although backups in the old format can still be used to restore to Solr for the time-being.
+The old and new formats are not compatible, although backups in the old format, a full snapshot of all files, can still be used to restore to Solr for the time-being.
The old format is officially deprecated, and support for it is likely to be removed in Solr 9.0.
For the time-being the old format can be created by defining a parameter `incremental=false`.
@@ -62,6 +63,7 @@ Again, though, this support is likely to be removed in Solr 9.0.
More documentation on backups is available at <<making-and-restoring-backups.adoc#,Making and Restoring Backups>>.
New Collections API commands for backups:
+
* LISTBACKUP: Lists information about each backup stored at the specified repository location.
See <<collection-management.adoc#listbackup,List Backups>> for more details.
* DELETEBACKUP: Deletes specified backups from the repository. See <<collection-management.adoc#deletebackup,Delete Backups>> for more details.
@@ -71,13 +73,9 @@ This is a contrib (located in `contrib/gcs-repository`).
See <<making-and-restoring-backups.adoc#gcsbackuprepository,GCSBackupRepository>> for configuration details.
The Solr community is working to add support for S3 buckets in the near future.
-*Embedded Solr Server*
-
-* When using EmbeddedSolrServer, it will no longer close CoreContainer instances that were passed to it.
-
*Nested Docs*
-* Child Doc Transformer's `childFilter` param no longer applies query syntax
+Child Doc Transformer's `childFilter` param no longer applies query syntax
escaping because it's inconsistent with the rest of Solr and was limiting. This refers to `[child childFilter='field:value']`.
There was no escaping here prior to 8.0 either.
@@ -98,6 +96,10 @@ See also <<updating-parts-of-documents.adoc#in-place-updates,In-Place Updates>>.
The Metrics History feature, which allowed long-term storage and aggregation of Solr's metrics, has been deprecated and will be removed in 9.0.
+*Embedded Solr Server*
+
+When using EmbeddedSolrServer, it will no longer close CoreContainer instances that were passed to it.
+
=== Solr 8.8
See the https://cwiki.apache.org/confluence/display/SOLR/ReleaseNote88[8.8 Release Notes^]