工作中使用到了ZooKeeper做集群的管理工具，把ZooKeeper的安装和配置简单记录一下。
首先是下载ZooKeeper，本来没什么好说的，只是自己疏忽犯了个低级错误，应该下载可执行文件的压缩包apache-zookeeper-x.x.x-bin.tar.gz，我下载成了源码的apache-zookeeper-x.x.x.tar.gz，结果导致启动时报错，找到不主类。
下载完成压缩之后就可以进行配置了。也可以先建个软链接，如果以后ZooKeeper版本有变化，只要修改软链接即可。
使用%ZK_HOME%来代表ZooKeeper的安装目录。
tar -xzvf apache-zookeeper-3.5.6-bin.tar.gz
ZooKeeper有两种运行模式，一个是集群模式，一个是单机模式。分别配置如下。
1. 集群模式
假设用三台机器来搭建ZooKeeper集群，IP地址为IP1，IP2，IP3
（1） 配置zoo.cfg文件
初次使用ZooKeeper，需要将%ZOO_HOME%/conf目录下的zoo_sample.cfg文件重命名为zoo.cfg，并且按照如下代码进行简单配置：
tickTime=2000 initLimit=10 syncLimit=5 dataDir=/home/zs/zookeeper/zookeeper1/data dataLogDir=/home/zs/zookeeper/zookeeper1/log clientPort=2181 server.1=IP1:2888:3888 server.2=IP2:2888:3888 server.3=IP3:2888:3888
配置参数解释如下：
a). tickTime：该参数单位是毫秒ms，用于配置ZooKeeper中最小时间单元的长度，很多运行时的时间间隔都是使用tickTime的倍数来表示的。
b). initLimit：该参数要配置一个正整数N，表示tickTime的N倍。用于配置Leader服务器等待Follower启动，并完成数据同步的时间。Follower服务器在启动过程中，会与Leader建立连接并完成对数据的同步，从而确定自己对外提供服务的起始状态。Leader服务器允许Follower在initLimit时间内完成这个工作。
c). syncLimit：该参数要配置一个正整数N，表示tickTime的N倍。用于配置Leader服务器和Follower之间进行心跳检测的最大延时时间。如果Leader服务器在syncLimit时间内无法获取到Follower的心跳检测响应，那么Leader就会认为该Follower已经脱离了和自己的同步。
d). dataDir：用于配置ZooKeeper服务器存储快照文件的目录。默认情况下，如果没有配置参数dataLogDir，那么事务日志也会存储在这个目录中。考虑到事务日志的写性能直接影响ZooKeeper整体的服务能力，因此建议同时通过参数dataLogDir来配置ZooKeeper的事务日志的存储目录。
e). dataLogDir：用于配置ZooKeeper服务器存储事务日志文件的目录。dataDir和dataLogDir都要确保有读写权限。
f). clientPort：用于配置当前服务器对外的服务端口，客户端会通过该端口和ZooKeeper服务器创建连接。
g). server.id=host:port:port：该参数用于配置组成ZooKeeper集群的机器列表，其中id即为ServerID，与每台服务器myid文件中的数字相对应。同时，在该参数中，会配置两个端口：第一个端口用于指定Follower服务器与Leader进行运行时通信和数据同步时所使用的端口，第二个端口则专门用于进行Leader选举过程中的投票通信。在ZooKeeper服务器启动的时候，其会根据myid文件中配置的ServerID来确定自己是哪台服务器，并使用对应配置的端口来时行启动。如果在实际使用过程中，需要在同一台服务器上部署多个ZooKeeper实例来构成伪集群的话，那么这些端口都需要配置成不同。
（2） 创建myid文件
在dataDir所配置的目录下，创建一个名为myid的文件，在该文件的第一行写上一个数字，即ServerID，和zoo.cfg中当前机器的编号对应上。例如，server.1的myid文件内容就是“1”。要确保每个服务器的myid文件中的数字不同，并且和自己所在机器的zoo.cfg中的server.id=host:port:port的id值一致。id的范围是1~255。
（3） 重复（1）和（2）步，为所有机器配置zoo.cfg和myid文件。
（4） 启动ZooKeeper。
bin/zkServer.sh start
有时虽然执行完启动命令后，显示STARTED，但ZooKeeper并没有真正运行，可以对应状态进行检测。在执行启动命令的目录下会生成Logs目录，记录启动的日志，若未成功启动，可在Logs目录查找原因。
（5） 验证服务器
要验证服务器有没有启动成功，可以telnet到ZooKeeper的端口，然后发送stat命令来验证
如果出现以下输出信息，服务器就启动成功了。
还可以使用zkServer.sh status 命令，查看ZooKeeper服务器的状态，如下图所示，说明该服务器是个follower。
验证服务器时可能出现的问题如下：
a). 如果使用telnet加stat命令验证，出现“stat is not executed because it is not in the whitelist.”报错，可以修改一下启动脚本，把ZooKeeper的指使添加到白名单。
打开zkServer.sh脚本，在 if [ "x$SERVER_JVMFLAGS" != "x" ] 语句上方添加一条语句，把ZooKeeper的指使添加到白名单。
ZOOMAIN="-Dzookeeper.4lw.commands.whitelist=* ${ZOOMAIN}"
b). 如果使用telnet加stat命令验证，出现“This ZooKeeper instance is not currently serving requests”报错，其原因就是集群没有选出来leader，当集群里的结点只剩下一台，或者不足半数时，就会出现这个错误提示。 可以把配置集群里其他ZooKeeper服务器启动，或者查看各服务器之间网络是否不通。
c). 如果使用zkServer.sh status命令，出现It is probably not running. 有可能是集群中其他服务器没有开启。要整个集群都开启再执行status命令，只开启一台服务器并验证会报错。也有可能是服务器真没启来，看查看一下输出日志。
（6） 关闭服务器
bin/zkServer.sh stop
2. 伪集群模式
ZooKeeper支持在一台服务器上启动多个ZooKeeper的实例，相互组成一个集群。不需要拷贝多个ZooKeeper的目录，就是同一个程序目录下，配置多个zoo.cfg文件即可。
（1） 配置文件
可以在conf目录下，创建三个配置文件，分别命名为zoo1.cfg、zoo2.cfg、zoo3.cfg，内容分别如下。注意，dataDir和dataLogDir配置不同的目录，IP地址均为本机的IP地址，但端口各不相同。
tickTime=2000 initLimit=10 syncLimit=5 dataDir=/home/zs/zookeeper/zookeeper1/data dataLogDir=/home/zs/zookeeper/zookeeper1/log clientPort=2181 server.1=IP1:2887:3887 server.2=IP1:2888:3888 server.3=IP1:2889:3889
tickTime=2000 initLimit=10 syncLimit=5 dataDir=/home/zs/zookeeper/zookeeper2/data dataLogDir=/home/zs/zookeeper/zookeeper2/log clientPort=2182 server.1=IP1:2887:3887 server.2=IP1:2888:3888 server.3=IP1:2889:3889
tickTime=2000 initLimit=10 syncLimit=5 dataDir=/home/zs/zookeeper/zookeeper3/data dataLogDir=/home/zs/zookeeper/zookeeper3/log clientPort=2183 server.1=IP1:2887:3887 server.2=IP1:2888:3888 server.3=IP1:2889:3889
（2） 创建myid文件
在每个dataDir所配置的目录下，创建一个名为myid的文件，在该文件的第一行写上一个数字，即ServerID，和zoo1.cfg、zoo2.cfg、zoo3.cfg中当前机器的编号对应上。
（3） 启动服务器
因为只有一个ZooKeeper程序目录，在启动不同的实例时，要指定各自的配置文件，启动命令如下所示
bin/zkServer.sh start conf/zoo1.cfg bin/zkServer.sh start conf/zoo2.cfg bin/zkServer.sh start conf/zoo3.cfg
（4） 验证服务器
bin/zkServer.sh status conf/zoo1.cfg bin/zkServer.sh status conf/zoo2.cfg bin/zkServer.sh status conf/zoo3.cfg
（5） 关闭服务器
bin/zkServer.sh stop conf/zoo1.cfg bin/zkServer.sh stop conf/zoo2.cfg bin/zkServer.sh stop conf/zoo3.cfg
3. 单机模式
ZooKeeper也支持单机部署，单机模式可以看做一种特殊的集群模式，整体配置流程与集群部署一致，不同的地方在于，zoo.cfg配置文件中，只需要配置一个server地址，而且不需要在dataDir目录下配置myid文件。
（1） 配置cfg文件
tickTime=2000 initLimit=10 syncLimit=5 dataDir=/home/zs/zookeeper/zookeeper/data dataLogDir=/home/zs/zookeeper/zookeeper/log clientPort=2181 server.1=IP1:2888:3888
（2） 启动服务器
bin/zkServer.sh start
（3） 验证服务器
可以使用telnet 加stat命令验证，也可以使用zkServer.sh status 命令验证
使用telnet 加stat命令验证，可以看到单机模式下服务器的Mode为standalone，集群模式下是Leader和Follower。
使用zkServer.sh status 命令验证
（4） 关闭服务器
bin/zkServer.sh stop
以上就是ZooKeeper的安装和配置过程。
