Differences between revisions 8 and 9
Revision 8 as of 2009-06-18 10:27:39
Size: 3014
Editor: 206-223-186-119
Comment: Added "JBoss Logging" section and added properties-service to Solr-home.
Revision 9 as of 2009-06-18 10:30:02
Size: 3058
Editor: 206-223-186-119
Comment: Sections were at wrong levels.
Deletions are marked like this. Additions are marked like this.
Line 25: Line 25:
==== Solr Home Configuration ==== ==== Solr Home via web.xml ====
Line 35: Line 35:
==== Solr Home via properties-service.xml ====
Line 45: Line 46:
==== JBoss Logging ==== === JBoss Logging ===

Solr with JBoss

  • Solr runs fine with [http://www.jboss.org/ JBoss], see the instructions in the generic [wiki:SolrInstall Solr installation] page

  • The latest version of JBoss is recommended

Optional Configuration

URI Charset Config

If you are going to query Solr using international characters (>127) using HTTP-GET, you must configure JBoss to conform to the URI standard by accepting percent-encoded UTF-8.

Edit JBoss's server/default/deploy/jbossweb-tomcat55.sar/server.xml and add the following attribute to the correct Connector element: URIEncoding="UTF-8". If you're using JBoss v4.0 or above, then the file is located at: server/default/deploy/jboss-web-deployer/server.xml

<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.

Configuring Solr Home

You can configure the Solr home directory globally via -Dsolr.solr.home in the file bin/run.bat. But that is often not desired because you potentially want more than one Solr installation deployed.

Solr Home via web.xml

You can configure the Solr home directory to use per webapp in Solr's web.xml file. Add following snippet to the web.xml:

  <env-entry>
    <env-entry-name>solr/home</env-entry-name>
    <env-entry-type>java.lang.String</env-entry-type>
    <env-entry-value>C:\Projects\solr-trunk\example\solr</env-entry-value>
  </env-entry>

Solr Home via properties-service.xml

You can also configure it (and other Solr variables, such as the Solr-data-dir) in properties-service.xml like so:

<mbean code="org.jboss.varia.property.SystemPropertiesService" name="jboss:type=Service,name=SystemProperties">
  <attribute name="Properties">
    solr.solr.home=C:/jboss-X/server/default/conf/solr
    solr.data.dir=C:/solr/data
  </attribute>
</mbean>

JBoss Logging

By default JBoss uses Log4J for its logging, while the default Solr installation uses the [http://www.slf4j.org/manual.html#binding SLF4J binding] to log via the JDK1.4 logging system. In order to get Solr to log via Log4J, you must replace the slf4j-jdk*.jar binding with the slf4j-log4j*.jar binding. From that point on, logging can be configured via the log4j.xml configuration file.

For example, this can be used to silence all the INFO messages from Solr:

<category name="org.apache.solr"> 
  <priority value="WARN"/>
</category>

Troubleshooting

If you encounter the error "statements are only available if source level is 5.0" then you have to edit the file server/default/deploy/jbossweb-tomcat55.sar/conf/web.xml.

Comment in the block

<init-param>
   <param-name>compilerSourceVM</param-name>
   <param-value>1.5</param-value>
</init-param>

SolrJBoss (last edited 2013-01-06 15:52:56 by UweSchindler)