[jira] [Created] (SOLR-4434) Developer Curb Appeal: Better options than the manual copy step, and doc changes

["Mark Bennett (JIRA)" <ji...@apache.org>]

Mark Bennett created SOLR-4434:
----------------------------------

             Summary: Developer Curb Appeal: Better options than the manual copy step, and doc changes
                 Key: SOLR-4434
                 URL: https://issues.apache.org/jira/browse/SOLR-4434
             Project: Solr
          Issue Type: Improvement
          Components: SolrCloud
    Affects Versions: 4.1
            Reporter: Mark Bennett
             Fix For: 4.2


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.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org