ZooKeeper配置与使用

ZooKeeper Server是一个Java语言实现的分布式协调服务框架,因此需要JDK6+的支持。为了确保ZooKeeper服务的稳定与可靠性,通常是搭建成一个ZK集群来对外提供服务。ZK有一个重要的特性:集群中只要有过半的机器是正常工作的,那么整个集群对外就是可用的,所以建议集群的机器数量为奇数。

1、安装JDK6+

2、去官网选择一个合适的版本下载。

#官网 http://www.apache.org/dyn/closer.cgi/zookeeper/

wget http://mirrors.cnnic.cn/apache/zookeeper/zookeeper-3.4.6/zookeeper-3.4.6.tar.gz
tar zxf zookeeper-3.4.6.tar.gz
cd zookeeper-3.4.6

3、配置

mv conf/zoo_sample.cfg  conf/zoo.cfg 

#创建数据存储路径
mkdir -p /ROOT/data/zookeeper/

#修改dataDir
vi conf/zoo.cfg

修改一下内容:
tickTime=2000
dataDir=/ROOT/data/zookeeper/ 
clientPort=2181
initLimit=5
syncLimit=2
server.1=zk1:2888:3888
server.2=zk2:2888:3888
server.3=zk3:2888:3888

server.id=host:port:port 关于id,我们称之为Server ID,用来标识该host在集群中的机器序号,id的取值范围是1~255。

注意:集群中所有节点的配置文件必须保持一致

4、启动

bin/zkServer.sh start 

5、检查是否安装成功

bin/zkCli.shecho stat|nc localhost 2181

关于带GUI管理工具

  • TaoKeeper

淘宝开源的ZK监控与报表系统,看上去很久不更新的样子。如果自己下载源码进行编译,可能会出现依赖,需要手动安装JAR到本地maven库,使用不是特别方便。

  • Node_Zookeeper_Admin

用NodeJs开发,没用过,看界面还不错,由于需要安装nodejs环境,还是不试了。

zoo.cfg文件参数详解

参数 说明
clientPort 客户端连接server的端口,即对外服务端口,一般设置为2181吧。
dataDir 存储快照文件snapshot的目录。默认情况下,事务日志也会存储在这里。建议同时配置参数dataLogDir, 事务日志的写性能直接影响zk性能。
tickTime ZK中的一个时间单元。ZK中所有时间都是以这个时间单元为基础,进行整数倍配置的。例如,session的最小超时时间是2*tickTime。
dataLogDir 事务日志输出目录。尽量给事务日志的输出配置单独的磁盘或是挂载点,这将极大的提升ZK性能。(No Java system property)
globalOutstandingLimit 最大请求堆积数。默认是1000。ZK运行的时候, 尽管server已经没有空闲来处理更多的客户端请求了,但是还是允许客户端将请求提交到服务器上来,以提高吞吐性能。当然,为了防止Server内存溢出,这个请求堆积数还是需要限制下的。(Java system property:zookeeper.globalOutstandingLimit.)
preAllocSize 预先开辟磁盘空间,用于后续写入事务日志。默认是64M,每个事务日志大小就是64M。如果ZK的快照频率较大的话,建议适当减小这个参数。(Java system property:zookeeper.preAllocSize)
snapCount 每进行snapCount次事务日志输出后,触发一次快照(snapshot), 此时,ZK会生成一个snapshot.文件,同时创建一个新的事务日志文件log.。默认是100000.(真正的代码实现中,会进行一定的随机数处理,以避免所有服务器在同一时间进行快照而影响性能)(Java system property:zookeeper.snapCount)
traceFile 用于记录所有请求的log,一般调试过程中可以使用,但是生产环境不建议使用,会严重影响性能。(Java system property:?requestTraceFile)
maxClientCnxns 单个客户端与单台服务器之间的连接数的限制,是ip级别的,默认是60(3.4.0开始,默认值调整为60,之前的默认值是10),如果设置为0,那么表明不作任何限制。请注意这个限制的使用范围,仅仅是单台客户端机器与单台ZK服务器之间的连接数限制,不是针对指定客户端IP,也不是ZK集群的连接数限制,也不是单台ZK对所有客户端的连接数限制。指定客户端IP的限制策略,这里有一个patch,可以尝试一下:http://rdc.taobao.com/team/jm/archives/1334(No Java system property)
clientPortAddress 对于多网卡的机器,可以为每个IP指定不同的监听端口。默认情况是所有IP都监听clientPort指定的端口。New in 3.3.0
minSessionTimeoutmaxSessionTimeout Session超时时间限制,如果客户端设置的超时时间不在这个范围,那么会被强制设置为最大或最小时间。默认的Session超时时间是在2 tickTime ~ 20 tickTime这个范围 New in 3.3.0
fsync.warningthresholdms 事务日志输出时,如果调用fsync方法超过指定的超时时间,那么会在日志中输出警告信息。默认是1000ms。(Java system property:fsync.warningthresholdms) New in 3.3.4
autopurge.purgeInterval 在上文中已经提到,3.4.0及之后版本,ZK提供了自动清理事务日志和快照文件的功能,这个参数指定了清理频率,单位是小时,需要配置一个1或更大的整数,默认是0,表示不开启自动清理功能。(No Java system property) New in 3.4.0
autopurge.snapRetainCount 这个参数和上面的参数搭配使用,这个参数指定了需要保留的文件数目。默认是保留3个。(No Java system property) New in 3.4.0
electionAlg 在之前的版本中, 这个参数配置是允许我们选择leader选举算法,但是由于在以后的版本中,只会留下一种“TCP-based version of fast leader election”算法,所以这个参数目前看来没有用了,这里也不详细展开说了。(No Java system property)
initLimit Follower在启动过程中,会从Leader同步所有最新数据,然后确定自己能够对外服务的起始状态。Leader允许F在initLimit时间内完成这个工作。通常情况下,我们不用太在意这个参数的设置。如果ZK集群的数据量确实很大了,F在启动的时候,从Leader上同步数据的时间也会相应变长,因此在这种情况下,有必要适当调大这个参数了。(No Java system property)
syncLimit 在运行过程中,Leader负责与ZK集群中所有机器进行通信,例如通过一些心跳检测机制,来检测机器的存活状态。如果L发出心跳包在syncLimit之后,还没有从F那里收到响应,那么就认为这个F已经不在线了。注意:不要把这个参数设置得过大,否则可能会掩盖一些问题。(No Java system property)
leaderServes 默认情况下,Leader是会接受客户端连接,并提供正常的读写服务。但是,如果你想让Leader专注于集群中机器的协调,那么可以将这个参数设置为no,这样一来,会大大提高写操作的性能。(Java system property: zookeeper.leaderServes)。
server.x=[hostname]:nnnnn[:nnnnn] 这里的x是一个数字,与myid文件中的id是一致的。右边可以配置两个端口,第一个端口用于F和L之间的数据同步和其它通信,第二个端口用于Leader选举过程中投票通信。(No Java system property)
group.x=nnnnn[:nnnnn]weight.x=nnnnn 对机器分组和权重设置,可以 参见这里(No Java system property)
cnxTimeout Leader选举过程中,打开一次连接的超时时间,默认是5s。(Java system property: zookeeper.cnxTimeout)
zookeeper.DigestAuthenticationProvider.superDigest ZK权限设置相关,具体参见《使用super身份对有权限的节点进行操作》《ZooKeeper权限控制》
skipACL 对所有客户端请求都不作ACL检查。如果之前节点上设置有权限限制,一旦服务器上打开这个开头,那么也将失效。(Java system property:zookeeper.skipACL)
forceSync 这个参数确定了是否需要在事务日志提交的时候调用FileChannel.force来保证数据完全同步到磁盘。(Java system property:zookeeper.forceSync)
jute.maxbuffer 每个节点最大数据量,是默认是1M。这个限制必须在server和client端都进行设置才会生效。(Java system property:jute.maxbuffer)

常用命令

conf

# 输出server的详细配置信息
$ echo conf|nc localhost 2181

cons

#输出指定server上所有客户端连接的详细信息,包括客户端IP,会话ID等
$ echo cons|nc localhost 2181

crst

#功能性命令。重置所有连接的统计信息。

dump

#这个命令针对Leader执行,用于输出所有等待队列中的会话和临时节点的信息。 

envi

#用于输出server的环境变量。包括操作系统环境和Java环境。

ruok

#用于测试server是否处于无错状态。如果正常,则返回“imok”,否则没有任何响应。

注意:
ruok不是一个特别有用的命令,它不能反映一个server是否处于正常工作。“stat”命令更靠谱。

stat

#输出server简要状态和连接的客户端信息。

srvr

#和stat类似

$ echo stat|nc localhost 2181

$ echo srvr|nc localhost 2181

srst

#重置server的统计信息。

wchs

#列出所有watcher信息概要信息,数量等。

wchc

#列出所有watcher信息,以watcher的session为归组单元排列,列出该会话订阅了哪些path

$ echo wchc|nc localhost 2181

wchp

#列出所有watcher信息,以watcher的path为归组单元排列,列出该path被哪些会话订阅着

$ echo wchp|nc localhost 2181

mntr

#输出一些ZK运行时信息,通过对这些返回结果的解析,可以达到监控的效果。

$ echo mntr | nc localhost 2185