SolrCloud分布式集群部署步骤

• Solr及SolrCloud简介

　　　　Solr是一个独立的企业级搜索应用服务器，它对外提供类似于Web-service的API接口。用户可以通过http请求，向搜索引擎服务器提交一定格式的XML文件，生成索引；也可以通过Http Get操作提出查找请求，并得到XML格式的返回结果。

　　　   SolrCloud是Solr4.0版本以后基于Solr和Zookeeper的分布式搜索方案，它的主要思想是使用Zookeeper作为集群的配置信息中心。它有以下几个特点：

1. 1. 集中式的配置信息管理。
   2. 自动容错。
   3. 近实时搜索。
   4. 查询时自动负载均衡。
   5. 将索引存储在HDFS上。
   6. 通过MR批量创建索引。

　　　　更多关于SolrCloud的相关介绍可参考以下链接：

1. 1. http://www.chepoo.com/solrcloud-introduction.html
   2. http://www.cnblogs.com/phinecos/archive/2012/02/10/2345634.html
   3. https://cwiki.apache.org/confluence/display/solr/SolrCloud

• 软件包准备

1. jdk-7u79-linux-x64.tar.gz
2. apache-tomcat-7.0.62.tar.gz
3. solr-5.2.1.tgz
4. zookeeper-3.4.6.tar.gz

• 服务器准备

　　　　准备三台服务器：

1. 1. 192.168.1.131
   2. 192.168.1.141
   3. 192.168.1.146

• SolrCloud集群搭建步骤
  • 服务器环境配置

1. 1. 1. 配置主机名和IP映射，在3台服务器的/etc/hosts文件中添加以下几行：
         192.168.1.131 solr-cloud-master
         192.168.1.141 solr-cloud-slave1
         192.168.1.146 solr-cloud-slave2
         

         将文件同步到其它机器上。　　

         scp /etc/hosts  solr-cloud-slave1:/etc/
         scp /ect/hosts  solr-cloud-slave2:/etc/

      2. 关闭防火墙，在生产环境中需要开放相应的端口。

         service     iptables stop
         chkconfig iptables off

         

• • 安装文件目录规划

1. 1. 1. JDK安装目录：/usr/local/lib
      2. Solr安装目录：/opt/SolrCloud/Solr/solr
      3. Solr配置文件目录：/opt/SolrCloud/Solr/solr-config
      4. Solr数据文件目录：/apps/data/solr-cores
      5. Zookeeper安装目录：/opt/SolrCloud/Zookeeper
      6. Zookeeper数据文件目录：/apps/data/zookeeper/data
      7. Tomcat安装目录：/opt/SolrCloud/Tomcat
         除了安装JDK的目录不需要创建，其它目录都需要进行创建。

• • 安装JDK

1. 1. 1. 解压 jdk-7u79-linux-x64.tar.gz 到 /usr/local/lib/ 目录下并重命名
         
      2. 在/etc/profile.d/ 目录下创建一个shell脚本文件并添加一下内容：

         

         配置立即生效：

         source /etc/profile.d/jdk_env.sh

         输入 java -version 检测是否安装成功
         
         也可以直接修改/etc/profile文件，添加的内容都是一样的。

         同步配置到其它机器：

         scp -r /usr/local/lib/jdk  solr-cloud-slave1:/usr/local/lib/
         scp  /etc/profile.d/jdk_env.sh  solr-cloud-slave1:/ect/profile.d/
         source  /etc/profile.d/jdk_env.sh
         
         scp -r /usr/local/lib/jdk  solr-cloud-slave2:/usr/local/lib/
         scp  /ect/profile.d/jdk_env.sh  solr-cloud-slave2:/etc/profile.d/
         source /etc/profile.d/jdk_env.sh

• • 安装配置Zookeeper

1. 1. 1. 解压 zookeeper-3.4.6.tar.gz  到 /opt/SolrCloud/Zookeeper/ 目录，并修改目录所有者。
         
      2. 配置zookeeper

         cd /opt/SolrCloud/Zookeeper/zookeeper-3.4./conf
         cp zoo_sample.cfg zoo.cfg

      3. 修改zoo.cfg
         
      4. 参数详解
         tickTime：该参数有默认值：3000，单位是毫秒(ms)，可以不配置，不支持系统属性方式配置，参数tickTime用于配置Zookeeper中最小时间单元的长度，
         很多运行时的时间间隔都是使用tickTime的倍数来表示的。例如，Zookeeper中会话的最小超时时间默认是2*tickTime。

         initLimit：该参数有默认值：10，即表示是参数tickTime值的10倍，必须配置，且需要配置一个正整数，不支持系统属性方式设置。该参数用于配置Leader服务器等待Follower启动，
         并完成数据同步的时间。Follower服务器启动过程中，会与Leader建立连接并完成数据的同步，从而确定自己对外提供服务的起始状态。Leader服务器允许Follower在inittLimit时间内完成这个工作。通常情况下，运维人员不用太在意这个参数的配置，使用其默认值即可。但如果随着Zookeeper集群管理的数据量增大，Follower服务器在启动的时候，从Leader上进行同步数据的时间也会相应变长，于是无法在较短的时间完成数据同步。因此，在这种情况下，有必要适当调大这个参数。

         syncLimit：该参数有默认值：5，即表示tickTime值得5倍，必须配置，且需要配置一个正整数，不支持系统属性设置。该参数用于配置Leader服务器和Follower之间进行心跳检测的最大延迟时间。在Zookeeper集群运行过程中，Leader服务器会与所有Follower进行心跳检测来确定该服务器是否存活。如果Leader服务器在syncLimit时间内无法获取到Follower的心跳检测响应，那么Leader就会认为该Follower已经脱离了和自己的同步。

         dataDir：该参数无默认值，必须配置，不支持系统属性方式设置，参数dataDir用于配置Zookeeper服务器存储快照文件的目录。默认情况下，如果没有配置参数dataLogDir，那么事务日志也会存储在这个目录中。考虑到事务日志的写性能直接影响Zookeeper整体的服务能力，因此建议同时通过参数dataLogDir来配置Zookeeper事务日志的存储目录。

         dataLogDir：该参数有默认值，dataDir，可以不配置，不支持系统属性方式设置。参数dataLogDir用于配置Zookeeper服务器存储事务日志文件的目录。默认情况下，Zookeeper会将事务日志文件和快照数据存储在同一个目录中，应尽量将这两者的目录区分开来，另外，如果条件允许，可以将事务日志的存储配置在一个单独的磁盘上。事务日志记录对于磁盘的性能要求非常高，为了保证数据的一致性，Zookeeper在返回客户端事务请求响应之前，必须将本次请求对应的事务日志写入到磁盘中。因此，事务日志写入的性能直接决定了Zookeeper在处理事务请求是的吞吐。

         clientPort：参数clientPort用于配置当前服务器对外的服务端口，客户端会通过该端口和Zookeeper服务器建立连接，一般设置为2181。每台Zookeeper服务器都可以配置任意可以的端口，同时，集群中的所以服务器不需要保持clientPort端口一致。

         server.id=host:port:port ：该参数没有默认值，在单机模式下可以不配置，不支持系统属性方式设置。该参数用于配置组成Zookeeper集群的机器列表，其中id即为Server ID，与每台服务器myid文件中的数字相对应。同时，在该参数中，会配置两个端口：第一个端口用于指定Follower服务器与Leader进行运行时通信和数据同步是所使用的端口，第二个端口则专门用于Leader选举过程中的投票通信。在Zookeeper服务器启动的时候，其会根据myid文件中配置的Server ID来确定自己是哪台服务器，并使用对于配置的端口来进行启动。

      5. 同步Zookeeper的配置及相关目录到其它两台机器：

         scp -r /opt/SolrCloud/Zookeeper/zookeeper-3.4./  solr-cloud-slave1:/opt/SolrCloud/Zookeeper/
         scp -r /apps/data/zookeeper/  solr-cloud-slave1:/apps/data/
         
         scp -r /opt/SolrCloud/Zookeeper/zookeeper-3.4./  solr-cloud-slave2:/opt/SolrCloud/Zookeeper/
         scp -r /apps/data/zookeeper/  solr-cloud-slave2:/apps/data/

      6. 创建myid文件，并写入zoo.cfg中对于的Server ID：

         solr-cloud-master：
         

         solr-cloud-slave1：
         

         solr-cloud-slave2：
         

      7. 分别启动三台Zookeeper服务器：

         cd /opt/SolrCloud/Zookeeper/zookeeper-3.4./bin/
         ./zkServer.sh  start 

         

      8. 查看Zookeeper状态

         solr-cloud-master：
         

         solr-cloud-slave1：
         

         solr-cloud-slave2：
         

      9. Zookeeper其它参考信息：
         Zookeeper官网：
         http://zookeeper.apache.org/doc/
         Zookeeper维基百科：
         https://cwiki.apache.org/confluence/display/ZOOKEEPER/Index;jsessionid=0B5F772DCFF3506613D26E3752F7D415
         Zookeeper技术博客：
         http://nileader.blog.51cto.com/1381108/d-16

• • SolrCloud分布式集群搭建

1. 1. 1. 解压 apache-tomcat-7.0.62.tar.gz ，解压部署后的目录为：/opt/SolrCloud/Tomcat/apache-tomcat-7.0.62
      2. 解压 solr-5.2.1.tgz ，并把solr.war解压到/opt/SolrCloud/Solr/solr 目录下。
         
      3. 将 solr-5.2.1/server/lib/ext/ 目录下的jar包拷贝到 /opt/SolrCloud/Solr/solr/WEB-INF/lib/ 目录下。

         cp /home/software/solr-5.2./server/lib/ext/*.jar /opt/SolrCloud/Solr/solr/WEB-INF/lib/

      4. 将 solr-5.2.1/server/solr/configsets/basic_configs/conf/ 目录下的文件拷贝到 /opt/SolrCloud/Solr/solr-config/
         
      5. 将 solr-5.2.1/example/files/conf/ 目录下的文件夹拷贝到 /opt/SolrCloud/Solr/solr-config/
         
      6. 将 /opt/SolrCloud/Solr/solr 目录拷贝到 /opt/SolrCloud/Tomcat/apache-tomcat-7.0.62/webapps/ 目录下。
         
      7. 将 solr-5.2.1/server/solr/ 目录下的solr.xml文件拷贝到 /apps/data/solr-cores/ 目录下，这是solr的核心配置文件。
         
      8. 修改 /apps/data/solr-cores/  目录下的solr.xml，修改hostPort和Tomcat端口一致：
         

         同步配置到其它机器：

         scp /apps/data/solr-cores/solr.xml solr-cloud-slave1:/apps/data/solr-cores/
         scp /apps/data/solr-cores/solr.xml solr-cloud-slave2:/apps/data/solr-cores/

      9. 在 /opt/SolrCloud/Tomcat/apache-tomcat-7.0.62/conf/ 目录下创建Catalina和localhost目录。

          mkdir -p /opt/SolrCloud/Tomcat/apache-tomcat-7.0./conf/Catalina/localhost

      10. 在 /opt/SolrCloud/Tomcat/apache-tomcat-7.0.62/conf/Catalina/localhost/ 目录下创建solr.xml，此为Solr/home的配置文件。

          <?xml version="1.0" encoding="UTF-8"?>
          <Context docBase="/opt/SolrCloud/Tomcat/apache-tomcat-7.0.62/webapps/solr" debug="0" crossContext="true">
          <Environment name="solr/home" type="java.lang.String" value="/apps/data/solr-cores/" override="true"/>
          </Context>

      11. 修改 /opt/SolrCloud/Tomcat/apache-tomcat-7.0.62/bin/catalina.sh 加入以下内容：
          

      12. 将以上配置同步到其它服务器

          scp -r /opt/SolrCloud/Tomcat/apache-tomcat-7.0./  solr-cloud-slave1:/opt/SolrCloud/Tomcat/
          scp -r /opt/SolrCloud/Solr/   solr-cloud-slave1:/opt/SolrCloud/
          scp -r /apps/data/solr-cores/  solr-cloud-slave1:/apps/data/
          
          scp -r /opt/SolrCloud/Tomcat/apache-tomcat-7.0./  solr-cloud-slave2:/opt/SolrCloud/Tomcat/
          scp -r /opt/SolrCloud/Solr/   solr-cloud-slave2:/opt/SolrCloud/
          scp -r /apps/data/solr-cores/  solr-cloud-slave2:/apps/data/

      13. 上传配置到Zookeeper：
          SolrCloud是通过Zookeeper集群来保证配置文件的变更及时同步到各个节点上，所以，需要将配置文件上传到Zookeeper集群。
          solr配置文件目录：/opt/SolrCloud/Solr/solr-config/
          执行以下操作：

           java -classpath .:/opt/SolrCloud/Tomcat/apache-tomcat-7.0./webapps/solr/WEB-INF/lib/* org.apache.solr.cloud.ZkCLI -cmd upconfig -zkhost solr-cloud-master:2181,solr-cloud-slave1:2181,solr-cloud-slave2:2181 -confdir /opt/SolrCloud/Solr/solr-config/ -confname solrconfig

      14. 校验Zookeeper配置文件

          cd /opt/SolrCloud/Zookeeper/zookeeper-3.4./bin/
          ./zkCli.sh -server solr-cloud-master:

          

      15. 启动Tomcat，先启动solr-cloud-master机器上的tomcat:

          cd /opt/SolrCloud/Tomcat/apache-tomcat-7.0./bin/
          ./startup.sh

          启动solr-cloud-slave1和solr-cloud-slave2机器上的Tomcat。

      16. 访问http://solr-cloud-master:8080/solr/可以看到下图：
          
      17. 创建Collection及初始化Shard

          curl 'http://solr-cloud-master:8080/solr/admin/collections?action=CREATE&name=collection_1&numShards=3&replicationFactor=1'

          
          查看  /apps/data/solr-cores/  目录：

          

      18. SolrCloud测试

          import java.io.IOException;
          import java.util.ArrayList;
          import java.util.Collection;
          import org.apache.commons.logging.Log;
          import org.apache.commons.logging.LogFactory;
          import org.apache.solr.client.solrj.SolrClient;
          import org.apache.solr.client.solrj.SolrQuery;
          import org.apache.solr.client.solrj.SolrServerException;
          import org.apache.solr.client.solrj.impl.CloudSolrClient;
          import org.apache.solr.client.solrj.impl.LBHttpSolrClient;
          import org.apache.solr.client.solrj.response.QueryResponse;
          import org.apache.solr.client.solrj.response.UpdateResponse;
          import org.apache.solr.common.SolrDocument;
          import org.apache.solr.common.SolrDocumentList;
          import org.apache.solr.common.SolrInputDocument;
          
          public class SolrCloudTest {
              public static final Log LOG = LogFactory.getLog(SolrCloudTest.class);
              private static CloudSolrClient cloudSolrClient;
              private  static LBHttpSolrClient solrClient;
          
              private static synchronized CloudSolrClient getCloudSolrServer(final String zkHost) {
                  LOG.info("connection to : " + zkHost + "\n");
                  if (cloudSolrClient == null) {
                      cloudSolrClient = new CloudSolrClient(zkHost);
                  }
                  return cloudSolrClient;
              }
          
              private void addIndex(SolrClient solrClient) {
                  try {
                      Collection<SolrInputDocument> docs = new ArrayList<SolrInputDocument>();
                      for (int i = 0; i <= 200; i++) {
                          SolrInputDocument doc = new SolrInputDocument();
                          String key = "";
                          key = String.valueOf(i);
                          doc.addField("id", key);
                          doc.addField("test_s", key + "value");
                          docs.add(doc);
                      }
                      LOG.info("docs info:" + docs + "\n");
                      solrClient.add(docs);
                      solrClient.commit();
                  } catch (SolrServerException e) {
                      System.out.println("Add docs Exception !!!");
                      e.printStackTrace();
                  } catch (IOException e) {
                      e.printStackTrace();
                  } catch (Exception e) {
                      System.out.println("Unknowned Exception!!!!!");
                      e.printStackTrace();
                  }
              }
          
              public void search(CloudSolrClient cloudSolrClient, String Str) {
                    SolrQuery query = new SolrQuery();
                    query.setRows(20);
                    query.setQuery(Str);
                    try {
                         LOG.info("query string: "+ Str);
                         System.out.println("query string: "+ Str);
                      QueryResponse response = cloudSolrClient.query(query);
                      SolrDocumentList docs = response.getResults();
                      System.out.println(docs);
                      System.out.println(docs.size());
                      System.out.println("doc num:" + docs.getNumFound());
                      System.out.println("elapse time:" + response.getQTime());
                      for (SolrDocument doc : docs) {
                        String area = (String) doc.getFieldValue("test_s");
                        String id = (String) doc.getFieldValue("id");
                        System.out.println("id: " + id);
                        System.out.println("tt_s: " + area);
                        System.out.println();
                      }
                    } catch (SolrServerException e) {
                      e.printStackTrace();
                    } catch(Exception e) {
                      e.printStackTrace();
                    }
                  } 
          
              public  void deleteSolrData(String solrUrl) {
                  try {
                      solrClient = new LBHttpSolrClient(solrUrl);
                      UpdateResponse res = solrClient.deleteByQuery("*:*");
                      System.out.println(res.getStatus());
                      solrClient.commit();
                      LOG.info("Delete Success!");
                  } catch (SolrServerException e) {
                      e.printStackTrace();
                  } catch (IOException e) {
                      e.printStackTrace();
                  }
              }
          
               public static void main(String[] args) throws IOException {
                       final String solrUrl = "http://solr-cloud-master:8080/solr/collection_1";
                      final String zkHost = "192.168.1.131:2181";
                      final String  defaultCollection = "collection_1";
                      final int  zkClientTimeout = 10000;
                      final int zkConnectTimeout = 10000;
                      CloudSolrClient cloudSolrClient  = getCloudSolrServer(zkHost);
                      cloudSolrClient.setDefaultCollection(defaultCollection);
                      cloudSolrClient.setZkClientTimeout(zkClientTimeout);
                      cloudSolrClient.setZkConnectTimeout(zkConnectTimeout);
                      try{
                          cloudSolrClient.connect();
                        System.out.println("connect solr cloud zk sucess");
                      } catch (Exception e){
                         LOG.error("connect to collection "+defaultCollection+" error\n");
                         System.out.println("error message is:"+e);
                         e.printStackTrace();
                         System.exit(1);
                      }
                      SolrCloudTest solrCloudTest = new SolrCloudTest();
                      try{
                          solrCloudTest.addIndex(cloudSolrClient);
                      } catch(Exception e){
                         e.printStackTrace();
                      }
                      solrCloudTest.search(cloudSolrClient, "id:*");
          //            solrCloudTest.deleteSolrData(solrUrl);
                      cloudSolrClient.close();
                  }
          }

• 总结

　　　Solr5.x版本和Solr4.x的版本在安装上发生了比较大的变化，另外API操作上也发生了比较大的变化，安装相对来说比较简单，最大的难点在于对其进行性能方面的优化，在进行压力测试中发现，持续对solr集群进行操作会出现服务不可用的异常，原因目前还没有找到，有时还会出现Zookeeper集群服务异常导致数据插入失败。针对这些问题都需要后续不断地进行深入的研究后，才能得出结论或解决方案。

　　　　本文参考了：http://www.tuicool.com/articles/AJR3Mv