ZooKeeper命令列

ZooKeeper客戶端有C語言和Java兩個版本。

ZooKeeper的命令在/usr/lib/zookeeper/bin資料夾下。

執行Java版本的客戶端使用bash zkCli.sh -server IP:port ，執行C語言版本的使用./cli_mt IP:port，下面介紹Java版本的，C語言版差不多。

檢視具體結點資訊

bash zkServer.sh status
[email protected]:/usr/lib/zookeeper/bin# bash zkServer.sh status
JMX enabled by default
Using config: /usr/lib/zookeeper/bin/../conf/zoo.cfg
Mode: standalone


檢視哪個結點被選作leader或者follower
echo stat|nc 127.0.0.1 2181
[email protected]:/usr/lib/zookeeper/bin# echo stat|nc 127.0.0.1 2181 
Zookeeper version: 3.4.5-cdh4.4.0--1, built on 09/04/2013 01:46 GMT
Clients:
 /127.0.0.1:57736[0](queued=0,recved=1,sent=0)


Latency min/avg/max: 0/0/0
Received: 1
Sent: 0
Connections: 1
Outstanding: 0
Zxid: 0x0
Mode: standalone
Node count: 4


測試是否啟動了該Server，若回覆imok表示已經啟動
echo ruok|nc 127.0.0.1 2181
[email protected]:/usr/lib/zookeeper/bin# echo ruok|nc 127.0.0.1 2181
imok


ZooKeeper命令列類似於shell。
當啟動 ZooKeeper 服務成功之後，輸入下述命令，連線到 ZooKeeper 服務：
bash zkCli.sh –server 192.168.255.133:2181


[email protected]:/usr/lib/zookeeper/bin# bash zkCli.sh -server 192.168.255.133:2181
Connecting to 192.168.255.133:2181
2013-09-12 15:38:39,654 [myid:] - INFO  [main:

[email protected]] - Client environment:zookeeper.version=3.4.5-cdh4.4.0--1, built on 09/04/2013 01:46 GMT
2013-09-12 15:38:39,657 [myid:] - INFO  [main:[email protected]] - Client environment:host.name=ubuntu
2013-09-12 15:38:39,659 [myid:] - INFO  [main:[email protected]] - Client environment:java.version=1.6.0_43
2013-09-12 15:38:39,660 [myid:] - INFO  [main:[email protected]] - Client environment:java.vendor=Sun Microsystems Inc.
2013-09-12 15:38:39,662 [myid:] - INFO  [main:[email protected]] - Client environment:java.home=/usr/local/jdk1.6.0_43/jre
2013-09-12 15:38:39,664 [myid:] - INFO  [main:[email protected]] - Client environment:java.class.path=/usr/lib/zookeeper/bin/../build/classes:/usr/lib/zookeeper/bin/../build/lib/*.jar:/usr/lib/zookeeper/bin/../lib/slf4j-log4j12-1.6.1.jar:/usr/lib/zookeeper/bin/../lib/slf4j-api-1.6.1.jar:/usr/lib/zookeeper/bin/../lib/netty-3.2.2.Final.jar:/usr/lib/zookeeper/bin/../lib/log4j-1.2.15.jar:/usr/lib/zookeeper/bin/../lib/jline-0.9.94.jar:/usr/lib/zookeeper/bin/../zookeeper-3.4.5-cdh4.4.0.jar:/usr/lib/zookeeper/bin/../src/java/lib/*.jar:/usr/lib/zookeeper/bin/../conf:
2013-09-12 15:38:39,665 [myid:] - INFO  [main:[email protected]] - Client environment:java.library.path=/usr/local/jdk1.6.0_43/jre/lib/amd64/server:/usr/local/jdk1.6.0_43/jre/lib/amd64:/usr/local/jdk1.6.0_43/jre/../lib/amd64:/usr/java/packages/lib/amd64:/usr/lib64:/lib64:/lib:/usr/lib
2013-09-12 15:38:39,667 [myid:] - INFO  [main:[email protected]] - Client environment:java.io.tmpdir=/tmp
2013-09-12 15:38:39,668 [myid:] - INFO  [main:[email protected]] - Client environment:java.compiler=<NA>
2013-09-12 15:38:39,669 [myid:] - INFO  [main:[email protected]] - Client environment:os.name=Linux
2013-09-12 15:38:39,670 [myid:] - INFO  [main:[email protected]] - Client environment:os.arch=amd64
2013-09-12 15:38:39,670 [myid:] - INFO  [main:[email protected]] - Client environment:os.version=3.2.0-51-generic
2013-09-12 15:38:39,672 [myid:] - INFO  [main:[email protected]] - Client environment:user.name=root
2013-09-12 15:38:39,672 [myid:] - INFO  [main:[email protected]] - Client environment:user.home=/root
2013-09-12 15:38:39,673 [myid:] - INFO  [main:[email protected]] - Client environment:user.dir=/usr/lib/zookeeper/bin
2013-09-12 15:38:39,674 [myid:] - INFO  [main:[email protected]] - Initiating client connection, connectString=192.168.255.133:2181 sessionTimeout=30000 [email protected]
Welcome to ZooKeeper!
JLine support is enabled
2013-09-12 15:38:39,720 [myid:] - INFO  [main-SendThread(192.168.255.133:2181):[email protected]] - Opening socket connection to server 192.168.255.133/192.168.255.133:2181. Will not attempt to authenticate using SASL (Unable to locate a login configuration)
2013-09-12 15:38:39,729 [myid:] - INFO  [main-SendThread(192.168.255.133:2181):[email protected]] - Socket connection established to 192.168.255.133/192.168.255.133:2181, initiating session
[zk: 192.168.255.133:2181(CONNECTING) 0] 2013-09-12 15:38:39,748 [myid:] - INFO  [main-SendThread(192.168.255.133:2181):[email protected]] - Session establishment complete on server 192.168.255.133/192.168.255.133:2181, sessionid = 0x141102059a70001, negotiated timeout = 30000


WATCHER::


WatchedEvent state:SyncConnected type:None path:null


輸入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
[zk: 192.168.255.133:2181(CONNECTED) 1] 

連線成功後，系統會輸出 ZooKeeper 的相關環境以及配置資訊，並在螢幕輸出“ Welcome to ZooKeeper ”等資訊。

命令列工具的一些簡單操作如下：

1 ）使用 ls 命令來檢視當前 ZooKeeper 中所包含的內容：
[zk: 202.115.36.251:2181(CONNECTED) 1] ls /
[zookeeper]

2 ）建立一個新的 znode ，使用 create /zk myData 。這個命令建立了一個新的 znode 節點“ zk ”以及與它關聯的字串：
[zk: 202.115.36.251:2181(CONNECTED) 2] create /zk "myData"
Created /zk 

3 ）我們執行 get 命令來確認 znode 是否包含我們所建立的字串：
[zk: 202.115.36.251:2181(CONNECTED) 3] get /zk
cZxid = 0x6
ctime = Thu Sep 12 15:49:16 CST 2013
mZxid = 0x7
mtime = Thu Sep 12 15:49:38 CST 2013
pZxid = 0x6
cversion = 0
dataVersion = 1
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 10
numChildren = 0

4 ）下面我們通過 set 命令來對 zk 所關聯的字串進行設定：
[zk: 202.115.36.251:2181(CONNECTED) 4] set /zk "zsl"
"myData"
cZxid = 0x4
ctime = Thu Sep 12 15:46:37 CST 2013
mZxid = 0x4
mtime = Thu Sep 12 15:46:37 CST 2013
pZxid = 0x4
cversion = 0
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 8
numChildren = 0

5 ）下面我們將剛才建立的 znode 刪除：
[zk: 202.115.36.251:2181(CONNECTED) 5] delete /zk

當然，我們還可以建立有曾次的目錄，比如使用create /zk/node1在zk目錄下建立新的目錄node1
[zk: 192.168.255.133:2181(CONNECTED) 18] create /zk/node1 "node1"
Created /zk/node1
[zk: 192.168.255.133:2181(CONNECTED) 19] ls /zk
[node1]


使用ZooKeeper四字命令

傳遞四個字母的字串給ZooKeeper，ZooKeeper會返回一些有用的資訊。

ZooKeeper 四字命令	功能描述
conf	輸出相關服務配置的詳細資訊。
cons	列出所有連線到伺服器的客戶端的完全的連線 / 會話的詳細資訊。包括“接受 / 傳送”的包數量、會話 id 、操作延遲、最後的操作執行等等資訊。
dump	列出未經處理的會話和臨時節點。
envi	輸出關於服務環境的詳細資訊（區別於 conf 命令）。
reqs	列出未經處理的請求
ruok	測試服務是否處於正確狀態。如果確實如此，那麼服務返回“imok ”，否則不做任何相應。
stat	輸出關於效能和連線的客戶端的列表。
wchs	列出伺服器 watch 的詳細資訊。
wchc	通過 session 列出伺服器 watch 的詳細資訊，它的輸出是一個與watch 相關的會話的列表。
wchp	通過路徑列出伺服器 watch 的詳細資訊。它輸出一個與 session相關的路徑。

例如：

[email protected]:/usr/lib/zookeeper/bin# echo conf |nc 192.168.255.133 2181    
clientPort=2181
dataDir=/var/lib/zookeeper/version-2
dataLogDir=/var/log/zookeeper/version-2
tickTime=2000
maxClientCnxns=50
minSessionTimeout=4000
maxSessionTimeout=40000
serverId=0