SolrCloud4.9+zookeeper在CentOS上的搭建与安装

Apache SolrCloud安装

SolrCloud通过ZooKeeper集群来进行协调，使一个索引进行分片，各个分片可以分布在不同的物理节点上，多个物理分片组成一个完成的索引Collection。SolrCloud自动支持Solr Replication，可以同时对分片进行复制，冗余存储。下面，我们基于Solr最新的4.9.0版本进行安装配置SolrCloud集群。

1. 安装环境

我使用的安装程序各版本如下：

Solr: Apache Solr-4.9.0

Tomcat: Apache Tomcat 7

ZooKeeper: Apache ZooKeeper 3.4.5

各个目录说明：

所有的程序安装在/home目录下，你可以依照你的实际情况下修改安装目录。

ZooKeeper的数据目录在:/home/zookeeper/data

solrhome设置在:/home/solrcloud/solrhome

2. 规划SolrCloud

单一SolrCloud数据集合:mycollection

ZooKeeper集群:2台

SolrCloud实例:2节点

索引分片：2

复制因子：2

手动将2个索引分片(Shard)的复本(Replica)分布在2个SolrCloud节点上

三个节点：

192.168.56.121

192.168.56.122

192.168.56.123

3. 安装ZooKeeper集群

由于需要用到ZooKeeper，故我们先安装好ZooKeeper集群

首先，在第一个节点上将zookeeper-3.4.5.tar.gz解压到/home目录：

$ tar zxvf zookeeper-3.4.5.tar.gz -C /home/

创建zookeeper配置文件zookeeper-3.4.5/conf/zoo.cfg,内容如下：

tickTime=2000 initLimit=10 syncLimit=5 dataDir=/data/zookeeper/data clientPort=2181 server.1=192.168.56.121:2888:3888 server.2=192.168.56.122:2888:3888 server.3=192.168.56.123:2888:3888

zookeeper的数据目录指定在/home/zookeeper/data，你也可以使用其他目录，通过下面命令进行创建该目录：

$ mkdir /home/zookeeper/data -p

然后，初始化myid，三个节点编号依次为1,2,3，在其余节点上分别执行命令（注意修改编号）。

$ echo "1" >/home/zookeeper/data/myid

然后，在第二个和第三个节点上依次重复上面的操作。这样第一个节点中myid内容为1,第二个节点为2,第三个节点为3。

最后，启动ZooKeeper集群，在每个节点上分别启动ZooKeeper服务：

$ cd /home $ sh zookeeper-3.4.5/bin/zkServer.sh start

可以查看ZooKeeper集群的状态，保证集群启动没有问题：

[root@192.168.56.121 opt]# sh zookeeper-3.4.5/bin/zkServer.sh status
JMX enabled by default
Using config: /home/zookeeper-3.4.5/bin/../conf/zoo.cfg
Mode: follower

4. 安装Solr

简单来说，执行以下命令：

步骤如下：

首先，在执行如下操作之前建立三个文件：(1):/home/solrcloud/solrhome   (2):/home/solrcloud/solr-lib  (3)/home/solrcloud/solr-config
mkdir -p /home/solrcloud/solrhome
mkdir -p /home/solrcloud/solr-lib
mkdir -p /home/solrcloud/solr-config

然后进行如下操作：

1.解压缩apache-tomcat7.zip 到/home/solrcloud/tomcat7 文件中
unzip apache-tomcat7.zip -d /home/solrcloud/tomcat7
2.解压缩solr-4.9.0.zip到/home/solr-4.9.0文件
unzip solr-4.9.0.zip -d /home/solr-4.9.0
3.首先把solr-4.9.0/example/webapps/solr.war解压缩，然后复制到tomcat7的webapps下面
$ cp solr-4.9.0/example/webapps/solr.war apache-tomcat7/webapps/
4.把solr-4.9.0/example/lib/ext/下所有jar文件copy到apache-tomcat7/webapps/solr/WEB-INF/lib/下
$ cp solr-4.9.0/example/lib/ext/* apache-tomcat-6.0.36/webapps/solr/WEB-INF/lib/
5.把solr-4.9.0/example/resources/log4j.properties 复制 apache-tomcat7/lib/ 下
$ cp solr-4.9.0/example/resources/log4j.properties apache-tomcat7/lib/
6.把solr-4.9.0/example/solr/solr.xml复制到/home/solrcloud/solrhome中
$ cp solr-4.9.0/example/solr/solr.xml /home/solrcloud/solrhome
7.在/home/solrcloud/solr-config下面建立一个core目录，比如叫mycollection/conf
mkdir -p /home/solrcloud/solr-config/mycollection/conf
8.复制solr-4.9.0/example/solr/collection1/conf 到/home/solrcloud/solr-config/mycollection/conf
$ cp solr-4.9.0/example/solr/collection1/conf /home/solrcloud/solr-config/mycollection/conf
9.修改/home/solrcloud/solrhome/solr.xml的 hostPort 节点的端口号为tomcat的端口号
<int name="hostPort">${jetty.port:8080}</int>

在其他节点上重复以上操作完成所有节点的solr的安装。

5. Tomcat配置与启动

自动创建Collection及初始Shard，不需要通过zookeeper手动上传配置文件并关联collection。

1、在第一个节点修改tomcat启动参数

JAVA_OPTS='-Djetty.port=8080 -Dsolr.solr.home=/home/solrcloud/solrhome -DzkHost=192.168.56.121:2181,192.168.56.122:2181,192.168.56.123:2181 -DnumShards=3 -Dbootstrap_confdir=/home/solrcloud/solr-config/mycollection/conf -Dcollection.configName=myconf'

然后启动tomcat。这个步骤上传了集群的相关配置信息(/home/solrcloud/solr-config/mycollectin/conf)到ZooKeeper中去，所以启动下一个节点时不用再指定配置文件了。

2、在第二个和第三个节点修改tomcat启动参数

JAVA_OPTS='-Djetty.port=8080 -Dsolr.solr.home=/home/solrcloud/solrhome -DzkHost=192.168.56.122:2181,192.168.56.122:2181,192.168.56.123:2181 -DnumShards=3'

然后启动tomcat。

这样就会创建3个shard分别分布在三个节点上，如果你在增加一个节点，这节点会附加到一个shard上成为一个replica，而不会创建新的shard。

6. 建立core跟share的一些命令

curl 'http://192.168.56.121:8080/solr/admin/collections?action=CREATE&name=mycollection&numShards=3&replicationFactor=1'

上面链接中的几个参数的含义，说明如下：

name 待创建Collection的名称

numShards 分片的数量

replicationFactor 复制副本的数量

可以通过Web管理页面，访问http://192.168.56.121:8888/solr/#/~cloud，查看SolrCloud集群的分片信息。

7.手动创建Replication

下面对已经创建的初始分片进行复制。 shard1已经在192.168.56.123上，我们复制分片到192.168.56.121和192.168.56.122上，执行如下命令：

$ curl 'http://192.168.56.121:8080/solr/admin/cores?action=CREATE&collection=primary&name=primary_shard1_replica_2&shard=shard1'
$ curl 'http://192.168.56.122:8080/solr/admin/cores?action=CREATE&collection=primary&name=primary_shard1_replica_3&shard=shard1'

最后的结果是，192.168.56.123上的shard1，在192.168.56.121节点上有1个副本，名称为primary_shard1_replica_2，在192.168.56.122节点上有一个副本，名称为primary_shard1_replica_3。也可以通过查看192.168.56.121和192.168.56.122上的目录变化，如下所示：

$  ll /usr/local/solrhome/
total 16
drwxr-xr-x 3 root root 4096 Mar 10 17:11 primary_shard1_replica2
drwxr-xr-x 3 root root 4096 Mar 10 17:02 primary_shard2_replica1
-rw-r--r-- 1 root root  444 Mar 10 17:16 solr.xml

你还可以对shard2和shard3添加副本。

其他：下面是手动上传zookeeper的方法

手动设置SolrCloud配置文件

安装ZooKeeper集群之前，请确保每台机器上配置/etc/hosts文件，使每个节点都能通过机器名访问。

1、 创建一个SolrCloud目录，并将solr的lib文件拷贝到这个目录：

$ mkdir -p /home/solrcloud/solr-lib/
$ cp apache-tomcat7/webapps/solr/WEB-INF/lib/* /home/solrcloud/solr-lib/

2、 通过bootstrap设置solrhome：

$ java -classpath .:/home/solrcloud/solr-lib/* org.apache.solr.cloud.ZkCLI -zkhost 192.168.56.121:2181,192.168.56.122:2181,192.168.56.123:2181 -cmd bootstrap -solrhome /home/solrcloud/solrhome

SolrCloud集群的所有的配置存储在ZooKeeper.一旦SolrCloud节点启动时配置了-Dbootstrap_confdir参数, 该节点的配置信息将发送到ZooKeeper上存储。基它节点启动时会应用ZooKeeper上的配置信息,这样当我们改动配置时就不用一个个机子去更改了。

3、SolrCloud是通过ZooKeeper集群来保证配置文件的变更及时同步到各个节点上，所以，需要将配置文件上传到ZooKeeper集群中：

$ java -classpath .:/home/solrcloud/solr-lib/* org.apache.solr.cloud.ZkCLI -zkhost 192.168.56.121:2181,192.168.56.122:2181,192.168.56.123:2181 -cmd upconfig -confdir /home/solrcloud/solr-config/mycollectioin/conf -confname myconf

说明：

zkhost指定ZooKeeper地址，逗号分割

/home/solrcloud/solr-config/mycollectin/conf目录下存在schema.xml和solrconfig.xml两个配置文件，你可以修改为你自己的目录。

myconf为在ZooKeeper上的配置文件名称。

4、把配置文件和目标collection联系起来：

$ java -classpath .:/home/solrcloud/solr-lib/* org.apache.solr.cloud.ZkCLI -zkhost 192.168.56.121:2181,192.168.56.122:2181,192.168.56.123:2181 -cmd linkconfig -collection mycollection-confname myconf

说明：

创建的collection叫做mycollection，并指定和myconf连接

5、查看ZooKeeper上状态

在任意一个节点的/opt目录下执行如下命令：

$  zookeeper-3.4.5/bin/zkCli.sh
[zk: localhost:2181(CONNECTED) 0] ls /
[configs, zookeeper, clusterstate.json, aliases.json, live_nodes, overseer, collections, overseer_elect]
[zk: localhost:2181(CONNECTED) 1] ls /configs
[myconf]
[zk: localhost:2181(CONNECTED) 1] ls /collections
[mycollection]

查看/configs和/collections目录均有值，说明配置文件已经上传到ZooKeeper上了，接下来启动solr。

几个常用的命令：

/admin/collections?action=CREATE: create a
collection

/admin/collections?action=RELOAD: reload a
collection

/admin/collections?action=SPLITSHARD: split a
shard into two new shards

/admin/collections?action=CREATESHARD: create a
new shard

/admin/collections?action=DELETESHARD: delete an
inactive shard

/admin/collections?action=CREATEALIAS: create
or modify an alias for a collection

/admin/collections?action=DELETEALIAS: delete
an alias for a collection

/admin/collections?action=DELETE: delete a
collection

/admin/collections?action=DELETEREPLICA: delete
a replica of a shard

/admin/collections?action=ADDREPLICA: add
a replica of a shard

/admin/collections?action=CLUSTERPROP: Add/edit/delete
a cluster-wide property

/admin/collections?action=MIGRATE: Migrate
documents to another collection

/admin/collections?action=ADDROLE: Add
a specific role to a node in the cluster

/admin/collections?action=REMOVEROLE: Remove
an assigned role

/admin/collections?action=OVERSEERSTATUS: Get
status and statistics of the overseer

/admin/collections?action=CLUSTERSTATUS: Get
cluster status

/admin/collections?action=REQUESTSTATUS: Get
the status of a previous asynchronous request

/admin/collections?action=LIST: List
all collections

===========================================================================

大体过程：

<--设置solrHome-->

java -classpath .:/home/solrcloud/solr-lib/* org.apache.solr.cloud.ZkCLI -zkhost 192.168.56.121:2181,192.168.56.122:2181,192.168.56.123:2181 -cmd bootstrap -solrhome

/home/solrcloud/solrhome

<-- 上传配置文件到zookeeper-->

java -classpath .:/home/solrcloud/solr-lib/* org.apache.solr.cloud.ZkCLI -zkhost 192.168.56.121:2181,192.168.56.122:2181,192.168.56.123:2181 -cmd upconfig -confdir

/home/solrcloud/solr-config/mycollectioin/conf -confname myconf

<!--关联配置文件与collection-->

java -classpath .:/home/solrcloud/solr-lib/* org.apache.solr.cloud.ZkCLI -zkhost 192.168.120.222:2181,192.168.120.223:21811 -cmd linkconfig -collection ebop -confname ebop

<!--建立collection-->

curl 'http://192.168.120.223:8080/solr/admin/collections?action=CREATE&name=ebop&numShards=2&replicationFactor=1'

<!--建立副本-->

curl 'http://192.168.120.222:8080/solr/admin/cores?action=CREATE&collection=ebop&name=ebop_shard1_replica_2&shard=shard1'

curl 'http://192.168.120.223:8080/solr/admin/cores?action=CREATE&collection=ebop&name=ebop_shard2_replica_2&shard=shard2'

参考：http://blog.javachen.com/2014/03/10/how-to-install-solrcloud/