Solr快速入门第二讲——Solr的安装及配置

淡淡的烟草味﹌ 2023-07-21 08:40 11阅读 0赞

# Solr的下载 #

首先，咱们得明确一点，在本系列教程中所使用的Solr是`Apache Solr 8.4.0`这个版本。大家可以从Solr官方网站（[http://lucene.apache.org/solr/][http_lucene.apache.org_solr]）下载Solr 8.4.0，根据Solr的运行环境，Linux下需要下载solr-8.4.0.tgz，Windows下需要下载solr-8.4.0.zip。

# Solr的目录结构 #

将下载下来的`solr-8.4.0.zip`文件进行解压，这时你就会看到如下图所示的Solr的目录结构。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70]  
下面我会对上图所展示的Solr目录结构挨个进行介绍。

*  bin：该目录包括一些能够让Solr用起来更容易的重要的运行脚本，和普通的bin目录的作用是一样的；
 *  contrib：该目录中有Solr的一些贡献软件/插件，它们可用于增强Solr的功能；
 *  dist：该目录包含编译过程中所产生的jar文件以及相关的依赖文件。用更官方的话语来说，就是编译打包后的存放目录，即构建后的输出产物存放的目录。其中，要特别注意`solr-solrj-8.4.0.jar`这个jar包，因为这个jar包在后续编写代码的时候就会用到；
 *  docs：该目录放的是Solr的API文档；
 *  example：该目录放的是一些Solr工程的示范例子，而且这里还展示了DIH，即数据导入处理的例子；
 *  licenses：该目录包含Solr所用到的第三方库的许可证；
 *  server：这是最重要的一个目录，它里面包含运行Solr实例而安装好的Jetty Servlet容器，而且该目录里面有三个重要的目录是必须记住的，因为当你搭建一个Solr服务器时，就需要用到这三个目录。
    
     *  server/lib：这个目录里面存放的是一些Jetty服务器的jar包和其他第三方的jar包。打开该目录，你就会发现有一堆Jetty内置小服务器的jar包（但这些我们用不到）。其中，lib/ext目录里面的jar包是Solr独有的jar包，也就是说当我们在搭建Solr服务器时，这几个jar包可别忘了导进去，至于导到哪里去，一会搭建的时候就知道了；
     *  server/solr：这个目录就是Solr的家。你可能要问，什么是家啊？能持久化数据的地方就是家，放在这里就是索引库存放地，也就是说新建的collection（核，每一个核就相当于一个数据库）的默认保存目录，而且该目录里面必须要包含solr.xml文件（Solr服务器的配置文件）；
     *  server/solr-webapp：这个目录存放的是Solr的web工程。

# 搭建单机版Solr服务器 #

## 运行环境 ##

Solr需要运行在一个Servlet容器中，Solr 8.4.0要求jdk使用1.7以上（现在基本上都使用的是Java 8了吧！还有用jdk 1.7的吗？），Solr默认提供Jetty（一个用Java写的Servlet容器），但本系列教程将使用Tocmat作为Servlet容器。在这里，我还得说明一点，本系列教程搭建单机版Solr服务器的运行环境是下面这样子的，所以，你得确保你的运行环境是不是下面这样子的？

*  Solr：Solr 8.4.0
 *  jdk：jdk1.8.0\_181
 *  Tomcat：apache-tomcat-8.5.38

## Solr 8.4.0整合Tomcat 8.5.38 ##

第一步，创建一个空的文件夹，例如`D:\solr`，创建该空文件夹的目的是为了方便管理Tomcat、Solr以及Solr的数据源。然后，分别解压一份Tomcat和Solr到该空文件夹中。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 1]  
第二步，创建一个空的文件夹，例如solrHome（Solr的数据源），该空文件夹可随意位置创建，不过在这里我是创建在了`D:\solr`文件夹下。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 2]  
第三步，将`D:\solr\solr-8.4.0\server\solr-webapp`文件夹下的webapp文件拷贝一份复制到`D:\solr\apache-tomcat-8.5.38\webapps`文件夹下，并改名为solr（名字无所谓主要是用于区分）。这里得说明一点，这一步的目的是为了将Solr的应用程序放入到Tomcat服务器中。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 3]  
第四步，将`D:\solr\solr-8.4.0\server\lib\ext`文件夹下的全部jar包、`D:\solr\solr-8.4.0\server\lib`文件夹下以`metrics`开头和`http2`开头的jar包全部拷贝到`D:\solr\apache-tomcat-8.5.38\webapps\solr\WEB-INF\lib`文件夹中。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 4]  
第五步，修改`D:\solr\apache-tomcat-8.5.38\webapps\solr\WEB-INF`文件夹下的web.xml配置文件。那如何修改该配置文件呢？大家可以按照以下两点来进行修改。

*  添加如下配置（web.xml配置文件中默认是没有的），即指定Solr数据源的位置。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 5]
 *  注释以下配置（默认是打开的），即取消权限控制。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 6]  
    若不注释掉则会有权限问题，带来的相应后果就是在访问Solr主页时，你会看到Tomcat显示403的错误，如下图所示。  
    ![在这里插入图片描述][20200412235045455.png]

第六步，把solr-8.4.0安装包中的`server\resources`文件夹下的所有配置文件拷贝到`D:\solr\apache-tomcat-8.5.38\webapps\solr\WEB-INF\classes`文件夹下（若没有classes文件夹，则请先创建）。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 7]  
然后，需要修改一下log4j2.xml配置文件，即把所有的`${sys:solr.log.dir}`修改为自己指定的真实路径（这里，我是在`D:\solr`下创建了一个logs文件夹）。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 8]  
第七步，把solr-8.4.0安装包中的`server\solr`下的所有文件拷贝到之前创建的solrHome文件夹里。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 9]  
第八步，启动Tomcat，访问`http://localhost:8080/solr/index.html`即可验证搭建单机版Solr服务器是否成功。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 10]  
如果你能看到上图所示的效果，那么说明单机版Solr服务器搭建成功了！

[http_lucene.apache.org_solr]: http://lucene.apache.org/solr/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70]: /images/20230528/d5fbd6674a824c32b2432acb2513edab.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 1]: /images/20230528/324efcf8ea7741f0b6c2508338e78051.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 2]: /images/20230528/9dc0692eb5134e66890521ca9b0e74c5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 3]: /images/20230528/9970a3035e474a6f8d16c949d1b069c0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 4]: /images/20230528/d4af5454a6a24ec8b3b4e7ee70416481.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 5]: /images/20230528/21c542016d2043448bbe0cbb584eee8c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 6]: /images/20230528/fb493037eefc45d7948bfb8d7a039bda.png
[20200412235045455.png]: /images/20230528/77111ab0bb3848598bc469fd9864f5e6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 7]: /images/20230528/77cf588545f9455ab273308e98bb08d5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 8]: /images/20230528/674a12f144f14e9c91364d8f67bc9bd0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 9]: /images/20230528/e9d407c9488a49dd93e791ad671e59fc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3llcmVueXVhbl9wa3U_size_16_color_FFFFFF_t_70 10]: /images/20230528/c4571c2113b847298fb17ba929f0c523.png