Apache
/
lucene
mirror of https://github.com/apache/lucene.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

SOLR-12523: Improve error reporting and docs regarding Collection backup feature shared-fs requirement

This commit is contained in:
Jan Høydahl 2018-08-15 13:38:05 +02:00
parent 4f1c0aab1c
commit f3339d14c9
4 changed files with 8 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
solr/CHANGES.txt
View File

@ -272,6 +272,8 @@ Other Changes
* SOLR-12208: Renamed the autoscaling variable 'INDEX.sizeInBytes' to 'INDEX.sizeInGB' (noble) * SOLR-12208: Renamed the autoscaling variable 'INDEX.sizeInBytes' to 'INDEX.sizeInGB' (noble)
* SOLR-12523: Improve error reporting and docs regarding Collection backup feature shared-fs requirement (janhoy)
* SOLR-12468: Upgrade Jetty to 9.4.11.v20180605 (Michael Braun, shalin) * SOLR-12468: Upgrade Jetty to 9.4.11.v20180605 (Michael Braun, shalin)
* SOLR-12527: factor out a test-framework/ConfigRequest class (Christine Poerschke) * SOLR-12527: factor out a test-framework/ConfigRequest class (Christine Poerschke)

2
solr/core/src/java/org/apache/solr/cloud/api/collections/BackupCmd.java
View File

@ -221,6 +221,6 @@ public class BackupCmd implements OverseerCollectionMessageHandler.Cmd {
} }
log.debug("Sent backup requests to all shard leaders for backupName={}", backupName); log.debug("Sent backup requests to all shard leaders for backupName={}", backupName);
ocmh.processResponses(results, shardHandler, true, "Could not backup all replicas", asyncId, requestMap); ocmh.processResponses(results, shardHandler, true, "Could not backup all shards", asyncId, requestMap);
} }
} }

4
solr/core/src/java/org/apache/solr/handler/admin/BackupCoreOp.java
View File

@ -60,7 +60,9 @@ class BackupCoreOp implements CoreAdminHandler.CoreAdminOp {
// file system. Otherwise, perhaps the FS location isn't shared -- we want an error. // file system. Otherwise, perhaps the FS location isn't shared -- we want an error.
if (!snapShooter.getBackupRepository().exists(snapShooter.getLocation())) { if (!snapShooter.getBackupRepository().exists(snapShooter.getLocation())) {
throw new SolrException(SolrException.ErrorCode.BAD_REQUEST, throw new SolrException(SolrException.ErrorCode.BAD_REQUEST,
"Directory to contain snapshots doesn't exist: " + snapShooter.getLocation()); "Directory to contain snapshots doesn't exist: " + snapShooter.getLocation() + ". " +
"Note that Backup/Restore of a SolrCloud collection " +
"requires a shared file system mounted at the same path on all nodes!");
} }
snapShooter.validateCreateSnapshot(); snapShooter.validateCreateSnapshot();
snapShooter.createSnapshot(); snapShooter.createSnapshot();

2
solr/solr-ref-guide/src/making-and-restoring-backups.adoc
View File

@ -24,6 +24,8 @@ Solr provides two approaches to backing up and restoring Solr cores or collectio
Support for backups when running SolrCloud is provided with the <<collections-api.adoc#collections-api,Collections API>>. This allows the backups to be generated across multiple shards, and restored to the same number of shards and replicas as the original collection. Support for backups when running SolrCloud is provided with the <<collections-api.adoc#collections-api,Collections API>>. This allows the backups to be generated across multiple shards, and restored to the same number of shards and replicas as the original collection.
NOTE: SolrCloud Backup/Restore requires a shared file system mounted at the same path on all nodes, or HDFS.
Two commands are available: Two commands are available:
* `action=BACKUP`: This command backs up Solr indexes and configurations. More information is available in the section <<collections-api.adoc#backup,Backup Collection>>. * `action=BACKUP`: This command backs up Solr indexes and configurations. More information is available in the section <<collections-api.adoc#backup,Backup Collection>>.