On 10/25/2013 8:18 AM, Cassandra Targett wrote:
In terms of adding or fixing documentation, the "Installing Solr" page
(https://cwiki.apache.org/confluence/display/solr/Installing+Solr)
includes a yellow box that says:
"Solr ships with a working Jetty server, with optimized settings for
Solr, inside the example directory. It is recommended that you use the
provided Jetty server for optimal performance. If you absolutely must
use a different servlet container then continue to the next section on
how to install Solr."
So, it's stated, but maybe not in a way that makes it clear to most
users. And maybe it needs to be repeated in another section.
Suggestions?
I did find this page,
https://cwiki.apache.org/confluence/display/solr/Running+Solr+on+Jetty,
which pretty much contradicts the previous text. I'll fix that now.
Other recommendations for where doc could be more clear are welcome.
Here are a couple of suggestions:
<http://wiki.apache.org/solr/SolrJetty>
Under section captioned "Init script to run the Solr example", it
describes init scripts based on whether you are running Jetty 6 or 7.
The problem is, if you use the custom version of Jetty (start.jar)
provided with the distribution (apparently the recommended one to use
based on earlier ports in this thread) you don't know which version of
Jetty this is. Of course, some users might know that running:
java -jar /var/solr/start.jar --version
will tell them which version of Jetty start.jar is based on. This may
not be obvious to everyone, however.
The other problem, of course, is that the latest versions of Solr (4.5.1
in particular) are based on Jetty 8, and there is no init script
provided for that version. If the Jetty 7 script still works for Jetty
8, then a note to the effect may help avoid confusion.
Thanks.
