mosuka/zookeeper-cli

zookeeper-cli

zookeeper-cli is a non-interactive command line interface for ZooKeeper. This CLI outputs JSON format, so it is easy to re-use the data.

How to build this project

Show all targets

$ ant -p
Buildfile: /Users/mosuka/git/zookeeper-cli/build.xml

Main targets:

 clean    Clean project.
 compile  Compile project.
 jar      Create JAR files.
 package  Create package.
 resolve  Resolve dependencies.
 test     Test project.
Default target: compile

Create package

$ ant package

install package

Please extract package/zookeeper-cli-0.1.0.tgz in any directory.

Show help

$ ./bin/zkNiCli.sh -h
usage: java zookeeper-cli.jar [-h] [-s SERVER] [-t TIMEOUT] COMMAND ...

optional arguments:
  -h, --help             show this help message and exit
  -s SERVER, --server SERVER
                         specify ZooKeeper host and port. ex) localhost:2181
  -t TIMEOUT, --timeout TIMEOUT
                         specify session timeout[ms].

Available Commands:
  COMMAND
    ls                   list the znodes.
    stat                 show stats of the znode.
    create               create the znode.
    delete               delete the znodes.
    get                  get the znodes.
    set                  set the znodes.
    sync                 sync the znode.
    getacl               get ACL of the znode.
    setacl               set ACL of the znode.
    addauth              add auth.
    listquota            list quota.
    setquota             set quota.
    delquota             delete quota.

Show help for subcommands

This is an example for ls command help.

$ ./bin/zkNiCli.sh ls -h
usage: java zookeeper-cli.jar ls [-h] [-w] [-s] [PATH]

positional arguments:
  PATH                   specify the znode path.

optional arguments:
  -h, --help             show this help message and exit
  -w, --watch            enable watcher.
  -s, --with-stat        gets the stat along with the data.

How to use this command

This is an example for ls command.

$ ./bin/zkNiCli.sh ls -s /
{"request":{"command":"ls","parameters":{"watch":false,"path":"/","server":"localhost:2181","with_stat":true,"timeout":3000}},"response":{"children":["zookeeper"],"stat":{"cZxid":"0x0","ctime":"Thu Jan 01 09:00:00 JST 1970","mZxid":"0x0","mtime":"Thu Jan 01 09:00:00 JST 1970","pZxid":"0x1b","cversion":1,"dataVersion":0,"aclVersion":0,"ephemeralOwner":"0x0","dataLength":0,"numChildren":1},"status":0,"message":"Success"}}