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集群的状态,保证集群启动没有问题:
[[email protected] 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
Migrate documents to another collection
/admin/collections?action=MIGRATE:
Add a specific role to a node in the cluster
/admin/collections?action=ADDROLE:
Remove an assigned role
/admin/collections?action=REMOVEROLE:
Get status and statistics of the overseer
/admin/collections?action=OVERSEERSTATUS:
Get cluster status
/admin/collections?action=CLUSTERSTATUS: /admin/collections?action=REQUESTSTATUS
: Get the status of a previous asynchronous request/admin/collections?action=LIST:
List all collections
参考:http://blog.javachen.com/2014/03/10/how-to-install-solrcloud/