apache solr 标准安装

linf

Solr是一个基于Lucene java库的企业级搜索服务器，本文记录了solr的安装过程，版本为最新的1.4.1。
1) 下载
    从solr的官网http://lucene.apache.org/solr/找到最新的版本1.4.1.
    解开下载的apache-solr-1.4.1.zip或apache-solr-1.4.1.tgz文件到apache-solr-1.4.1目录.

2) 简易安装
    solr的发布包中包含一些example，为了方便的运行这些example，solr的发布包中还额外的附带了jetty以便我们可以快速的搭建一个可运行的solr实例。
    因为一切都是现成的，因此过程就很简单了， 参考solr的教程(http://lucene.apache.org/solr/tutorial.html), 步骤如下：
1. cd apache-solr-1.4.1/example2. java -jar start.jar3. 打开浏览器访问 access http://localhost:8983/solr/admin/
     如果可以看到solr的搜索页面，说明solr正常运行。足够简单吧。
3) 标准安装
    上面的简易安装方式终究不能运用于正式场合，因此还是需要标准安装方式。
    solr的安装其实需要做的事情不多，因为本身就只需要运行起来是一个打包好的war包，只要配置OK就可以运行于各个web container。
    通用的solr安装步骤如下：
1. 准备好web container 如tomcat, jetty, resin等注意安装前先停止web container服务器。
2. 从上面解压好的solr发布包中找到example\solr目录这个目录可以用来作为配置solr的模板使用将example\solr目录复制到其他路径，如C:\soft\solr，以后这个目录就将作为solr home使用
注意有个文件需要修改一下，$SOLR_HOME/conf/solrconfig.xml，找到dataDir设置：
默认为<dataDir>${solr.data.dir:./solr}</dataDir>，用的是相对路径，这个需要修改为完整路径：
<dataDir>${solr.data.dir:C:\soft\solr\data}</dataDir>
3. 从上面解压好的solr发布包中找到solr的war包apache-solr-1.4.1/dist/apache-solr-1.4.1.war可以将这个war复制到solr home目录下
4. 启动web container启动时有两个东西需要做到：
1. 要运行的solr的webapp可以通过直接复制solr的war包到webapp目录，也可以通过其他方式指定这个war的路径总之是让web container启动solr这个应用。
2. 要指明solr home方式有3种：1. 设置java 的系统参数solr.solr.home(应该是solr.home，但是官网就是写成solr.solr.home)如 -Dsolr.solr.home=C:\soft\solr2. 设置JNDI lookup &quot;java:comp/env/solr/home&quot;3. 默认为./solr目录，即当前工作路径下的solr由于工作路径容易造成问题，因此一般不推荐这种方式。

5. 访问solr的管理页面来验证安装是否完成
    上述步骤中其他步骤都简单，只有步骤4需要额外注意。虽然原则上都是这些内容，但是具体到不同的web container会有不同的方法。     下面以tomcat和jetty为例，假定步骤1,2,3都已经完成。
4) 安装于tomcat
    以下内容参考官网文档 http://wiki.apache.org/solr/SolrTomcat.  
    1. 修改tomcat的server.xml文件
主要是修改监听端口，另外需要设置URIEncoding为UTF-8。
    <Connector port=&quot;8983&quot; protocol=&quot;HTTP/1.1&quot;                connectionTimeout=&quot;20000&quot;                redirectPort=&quot;8443&quot; URIEncoding=&quot;UTF-8&quot; />
    2. 增加tomcat\conf\Catalina\localhost\solr.xml文件
内容为：
<?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?><Context docBase=&quot;C:\soft\solr\apache-solr-1.4.1.war&quot; debug=&quot;0&quot; crossContext=&quot;true&quot;>  <Environment name=&quot;solr/home&quot; type=&quot;java.lang.String&quot; value=&quot;C:\soft\solr&quot; override=&quot;true&quot;/></Context>
    步骤4就完成了,使用的tomcat版本为6.28。

5) 安装于jetty
    以下内容参考官网文档 http://wiki.apache.org/solr/SolrJetty, 但是坦白说，这个文档的内容有点凌乱。
    jetty安装完成后，只需一个步骤，增加文件jetty\contexts\solr.xml，内容如下：

<?xml version=&quot;1.0&quot;  encoding=&quot;ISO-8859-1&quot;?><!DOCTYPE Configure PUBLIC &quot;-//Mort Bay Consulting//DTD Configure//EN&quot; &quot;http://jetty.mortbay.org/configure.dtd&quot;>
<Configure class=&quot;org.mortbay.jetty.webapp.WebAppContext&quot;>  <Set name=&quot;contextPath&quot;>/solr</Set>  <Set name=&quot;war&quot;>C:\soft\solr\apache-solr-1.4.1.war</Set>
  <Set name=&quot;extractWAR&quot;>true</Set>  <Set name=&quot;copyWebDir&quot;>false</Set>  <Set name=&quot;defaultsDescriptor&quot;><SystemProperty name=&quot;jetty.home&quot; default=&quot;.&quot;/>/etc/webdefault.xml</Set>
  <Array id=&quot;plusConfig&quot; type=&quot;java.lang.String&quot;>    <Item>org.mortbay.jetty.webapp.WebInfConfiguration</Item>    <Item>org.mortbay.jetty.plus.webapp.EnvConfiguration</Item>    <Item>org.mortbay.jetty.plus.webapp.Configuration</Item>    <Item>org.mortbay.jetty.webapp.JettyWebXmlConfiguration</Item>    <Item>org.mortbay.jetty.webapp.TagLibConfiguration</Item>  </Array>
  <Set name=&quot;ConfigurationClasses&quot;><Ref id=&quot;plusConfig&quot;/></Set>
  <New class=&quot;org.mortbay.jetty.plus.naming.EnvEntry&quot;>    <Arg>/solr/home</Arg>    <Arg type=&quot;java.lang.String&quot;>C:\soft\solr</Arg>    <Arg type=&quot;java.lang.Boolean&quot;>true</Arg>  </New>
</Configure>
    主要是指定contextPath/war, 另外设置&quot;/solr/home&quot;，注意jetty下是&quot;/solr/home&quot;，不是&quot;solr/home&quot;。这里有点奇怪。
    时间有限，其他webcontainer就不一一测试了，相信原理都是一样的。
    补充：以上为windows上的安装过程，linux系统应该也是相同的。我在SUSE 11上验证通过，安装成功。