Uploaded image for project: 'Solr'
  1. Solr
  2. SOLR-4434

Developer Curb Appeal: Better options than the manual copy step, and doc changes

    XMLWordPrintableJSON

Details

    • Improvement
    • Status: Closed
    • Major
    • Resolution: Fixed
    • 4.1
    • None
    • SolrCloud
    • 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

          Activity

            People

              Unassigned Unassigned
              mbennett Mark Bennett
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: