个人博客地址:Zookeeper单机操作 | 一张假钞的真实世界
下载
从Apache下载镜像站点下载当前稳定发布版。
单机操作
安装单机模式的Zookeeper服务器是简单明了的。服务器包含在一个单独的JAR文件中,因此安装包含创建配置。
下载稳定的ZooKeeper发布版后,解压并切换到包的根目录。
启动ZooKeeper前需要一个配置文件。下面是示例配置文件,创建conf/zoo.cfg
:
# The number of milliseconds of each tick
tickTime=2000
# The number of ticks that the initial
# synchronization phase can take
initLimit=10
# The number of ticks that can pass between
# sending a request and getting an acknowledgement
syncLimit=5
# the directory where the snapshot is stored.
# do not use /tmp for storage, /tmp here is just
# example sakes.
dataDir=/data/zookeeper
# the port at which the clients will connect
clientPort=2181
这个配置文件可以叫任意名字,在此我们叫它conf/zoo.cfg
。创建目录/data/zookeeper
,并修改dataDir为该目录。
tickTime
Zookeeper使用的单位为毫秒的基本时间。用来做心跳,会话超时的最小时间是两次tickTime。
dataDir
目录位置用来保存内存数据库快照及数据库更新的事务日志,除非另有规定。
clientPort
监听客户端连接的端口号。
创建配置文件后就可以启动ZooKeeper了:
bin/zkServer.sh start
ZooKeeper用log4j记录日志消息 – 可以在程序员指导手册中的Logging 一节获取更多详细信息。可以从控制台(默认)并且/或者看到日志信息,这依赖log4j的配置。
这里列出的步骤是运行单机模式ZooKeeper的。单机模式没有副本,因此,如果ZooKeeper进程失败,则服务就会宕掉。这对于大多数开发场景是没问题的,运行副本模式的ZooKeeper,请参见运行副本模式的Zookeeper。
管理ZooKeeper存储
对于长期运行的生产系统,ZooKeeper存储必须从外部进行管理(dataDir和logs)。参见在 maintenance 中的章节获取更多信息。
连接到ZooKeeper
bin/zkCli.sh -server 127.0.0.1:2181
这使你可以执行简单的、像文件一样的操作。
当建立了连接,应该可以看到像下面的一些信息:
Connecting to localhost:2181
log4j:WARN No appenders could be found for logger (org.apache.zookeeper.ZooKeeper).
log4j:WARN Please initialize the log4j system properly.
Welcome to ZooKeeper!
JLine support is enabled
[zkshell: 0]
在shell中,输入help获取可以从客户端执行的命令列表,像下面:
help
ZooKeeper -server host:port cmd args
connect host:port
get path [watch]
ls path [watch]
set path data [version]
rmr path
delquota [-n|-b] path
quit
printwatches on|off
create [-s] [-e] path data acl
stat path [watch]
close
ls2 path [watch]
history
listquota path
setAcl path acl
getAcl path
sync path
redo cmdno
addauth scheme auth
delete path [version]
setquota -n|-b val path
从这里,可以尝试几个简单的命令来体验简单的命令行接口。首先,从命令列表开始,像ls:
[zk: 127.0.0.1:2181(CONNECTED) 1] ls /
[zookeeper]
接下来,通过运行create /zk_test my_data
创建一个新的znode。这会创建一个新的znode并与这个节点关联字符串“my_data”:
[zk: 127.0.0.1:2181(CONNECTED) 2] create /zk_test my_data
Created /zk_test
输入ls /
命令查看目录结构:
[zk: 127.0.0.1:2181(CONNECTED) 3] ls /
[zookeeper, zk_test]
现在zk_test目录被创建了。
接下来,通过get命令确认数据已经与znode关联,像:
[zk: 127.0.0.1:2181(CONNECTED) 4] get /zk_test
my_data
cZxid = 0x2
ctime = Tue Mar 28 23:37:16 CST 2017
mZxid = 0x2
mtime = Tue Mar 28 23:37:16 CST 2017
pZxid = 0x2
cversion = 0
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 7
numChildren = 0
可以输入set命令修改与zk_test关联的数据,像:
[zk: 127.0.0.1:2181(CONNECTED) 5] set /zk_test junk
cZxid = 0x2
ctime = Tue Mar 28 23:37:16 CST 2017
mZxid = 0x3
mtime = Tue Mar 28 23:46:12 CST 2017
pZxid = 0x2
cversion = 0
dataVersion = 1
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 4
numChildren = 0
[zk: 127.0.0.1:2181(CONNECTED) 6] get /zk_test
junk
cZxid = 0x2
ctime = Tue Mar 28 23:37:16 CST 2017
mZxid = 0x3
mtime = Tue Mar 28 23:46:12 CST 2017
pZxid = 0x2
cversion = 0
dataVersion = 1
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 4
numChildren = 0
最后,输入以下命令删除节点:
[zk: 127.0.0.1:2181(CONNECTED) 7] delete /zk_test
[zk: 127.0.0.1:2181(CONNECTED) 8] ls /
[zookeeper]