lucene solr window安装

  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/example 
2. java -jar start.jar 
3. 打开浏览器访问 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\solr 
2. 设置JNDI lookup "java:comp/env/solr/home" 

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="8983" protocol="HTTP/1.1" 
               connectionTimeout="20000" 
               redirectPort="8443" URIEncoding="UTF-8" /> 

    2. 增加tomcat\conf\Catalina\localhost\solr.xml文件 

内容为： 

<?xml version="1.0" encoding="utf-8"?> 
<Context docBase="C:\soft\solr\apache-solr-1.4.1.war" debug="0" crossContext="true"> 
  <Environment name="solr/home" type="java.lang.String" value="C:\soft\solr" override="true"/> 
</Context> 

    步骤4就完成了,使用的tomcat版本为6.28。 


5) 安装于jetty 

    以下内容参考官网文档 http://wiki.apache.org/solr/SolrJetty, 但是坦白说，这个文档的内容有点凌乱。 

    jetty安装完成后，只需一个步骤，增加文件jetty\contexts\solr.xml，内容如下： 


<?xml version="1.0"  encoding="ISO-8859-1"?> 
<!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure//EN" "http://jetty.mortbay.org/configure.dtd"> 

<Configure class="org.mortbay.jetty.webapp.WebAppContext"> 
  <Set name="contextPath">/solr</Set> 
  <Set name="war">C:\soft\solr\apache-solr-1.4.1.war</Set> 

  <Set name="extractWAR">true</Set> 
  <Set name="copyWebDir">false</Set> 
  <Set name="defaultsDescriptor"><SystemProperty name="jetty.home" default="."/>/etc/webdefault.xml</Set> 

  <Array id="plusConfig" type="java.lang.String"> 
    <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="ConfigurationClasses"><Ref id="plusConfig"/></Set> 

  <New class="org.mortbay.jetty.plus.naming.EnvEntry"> 
    <Arg>/solr/home</Arg> 
    <Arg type="java.lang.String">C:\soft\solr</Arg> 
    <Arg type="java.lang.Boolean">true</Arg> 
  </New> 

</Configure> 

    主要是指定contextPath/war, 另外设置"/solr/home"，注意jetty下是"/solr/home"，不是"solr/home"。这里有点奇怪。 

    时间有限，其他webcontainer就不一一测试了，相信原理都是一样的。 

    补充：以上为windows上的安装过程，linux系统应该也是相同的。我在SUSE 11上验证通过，安装成功。