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发布包中找到examplesolr目录
这个目录可以用来作为配置solr的模板使用
将examplesolr目录复制到其他路径,如C:softsolr,以后这个目录就将作为solr home使用
注意有个文件需要修改一下,$SOLR_HOME/conf/solrconfig.xml,找到dataDir设置:
默认为<dataDir>${solr.data.dir:./solr}</dataDir>,用的是相对路径,这个需要修改为完整路径:
<dataDir>${solr.data.dir:C:softsolrdata}</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:softsolr
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. 增加tomcatconfCatalinalocalhostsolr.xml文件
内容为:
<?xml version="1.0" encoding="utf-8"?>
<Context docBase="C:softsolrapache-solr-1.4.1.war" debug="0" crossContext="true">
<Environment name="solr/home" type="java.lang.String" value="C:softsolr" override="true"/>
</Context>
步骤4就完成了,使用的tomcat版本为6.28。
5) 安装于jetty
以下内容参考官网文档 http://wiki.apache.org/solr/SolrJetty, 但是坦白说,这个文档的内容有点凌乱。
jetty安装完成后,只需一个步骤,增加文件jettycontextssolr.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:softsolrapache-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:softsolr</Arg>
<Arg type="java.lang.Boolean">true</Arg>
</New>
</Configure>
主要是指定contextPath/war, 另外设置"/solr/home",注意jetty下是"/solr/home",不是"solr/home"。这里有点奇怪。
时间有限,其他webcontainer就不一一测试了,相信原理都是一样的。
补充:以上为windows上的安装过程,linux系统应该也是相同的。我在SUSE 11上验证通过,安装成功。