[Solr Wiki] Update of "SolrTomcat" by YonikSeeley

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Solr Wiki" for change notification.

The following page has been changed by YonikSeeley:
http://wiki.apache.org/solr/SolrTomcat

The comment on the change is:
tomcat and UTF-8 URI encoding

------------------------------------------------------------------------------
  == Solr with Apache Tomcat ==
+  * Solr runs fine with [http://tomcat.apache.org/ Tomcat], see the instructions in the generic [wiki:SolrInstall Solr installation] page
-  * See the instructions in the generic [wiki:SolrInstall Solr installation] page
-  * Solr runs fine with [http://tomcat.apache.org/ Tomcat]
   * The latest version of Tomcat 5.5 - the "Core" Binary Distribution is recommended.
  
+ === Optional Configuration ===
+ ==== URI Charset Config ====
+ If you are going to '''query''' Solr using international characters (>127) using HTTP-GET, you must configure Tomcat to conform to the URI standard by accepting percent-encoded UTF-8.
+ 
+ Edit Tomcat's conf/server.xml and add the following attribute to the correct Connector element: URIEncoding="UTF-8".
+ {{{
+ <Server ...>
+  <Service ...>
+    <Connector ... URIEncoding="UTF-8"/>
+      ...
+    </Connector>
+  </Service>
+ </Server>
+ }}}
+ 
+ This is only an issue when sending non-ascii characters in a query request... no configuration is needed for Solr/Tomcat to return non-ascii chars in a response, or accept non-ascii chars in an HTTP-POST body.
+ 
+ === Example Install ===
  If you are having problems with the setup, try the following sequence of shell commands to download and install both Tomcat and Solr.  Substitute todays date in the Solr download file name.
  
  {{{