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-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-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);
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.
if (!snapShooter.getBackupRepository().exists(snapShooter.getLocation())) {
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.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.
NOTE: SolrCloud Backup/Restore requires a shared file system mounted at the same path on all nodes, or HDFS.
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>>.