Details
-
Improvement
-
Status: Closed
-
Major
-
Resolution: Fixed
-
4.1
-
None
-
None
Description
We make developers manually copy the example directory to a named shard directory.
Doc references:
http://lucidworks.lucidimagination.com/display/solr/Getting+Started+with+SolrCloud
http://wiki.apache.org/solr/SolrCloud
Sample commands:
cp -r example shard1
cp -r example shard2
The doc is perhaps geared towards a developer laptop, so in that case you really would need to make sure they have different names.
But if you're running on a more realistic multi-node system, let's say 4 nodes handling 2 shards, the the actual shard allocation (shard1 vs. shard2) will be fixed by the order each node is started in FOR THE FIRST TIME.
At a minimum, we should do a better job of explaining the somewhat arbitrary nature of the destination directories, and that the start order is what really matters.
We should also document that the actual shard assignment will not change, regardless of the name, and where this information is persisted?
Could we have an intelligent guess as to what template directory to use, and do the copy when the node is first started.
It's apparently also possible to startup the first Solr node with no cores and just point it at a template. This would be good to document. There's currently a bug in the Web UI if you do this, but I'll be logging another JIRA for that.
When combined with all the other little details of bringing up Solr Cloud nodes, this is confusing to a newcomer and midly annoying. Other engines don't require this.
Attachments
Issue Links
- is part of
-
SOLR-4430 SolrCloud: (epic) improve "Developer Curb Appeal", cleanup Developer Packaging for new devs
- Open