liusheng / zookeeper-util

Zookeeper management helpers for importing, exporting and purging of zk data

The Zookeeper Utilities

The zookeeper utilities are meant to help automating some administrative tasks with zookeeper test instances.
All operations implicitly exclude the /zookeeper path. Please try not to use with production instances.

• export (read) data from a running zk instance into a file
  • keep the data editable
• import (write) a full (or partial) export off of another zk instance
• purge (delete) all data from a running zk instance

There is only one executable (zkutil) that understands the three commands specified above with the following options:

Usage: zkutil <dump|import|purge> -c host:port [options]

dump

zkutil dump -h
Usage: zk_dump.rb [options] -c <host:port>
    -c, --connectstring host:port    the server to connect to
    -s, --separator sep              separator /path[::]data
    -p, --start_path path            path to dump, defaults to '/'
    -v, --verbose                    Output more information
    -h, --help                       Display this screen

Will print a text representation to STDOUT (which you can redirect into a dump file) looking like this:

/
/conf
/conf/entries
/conf/entries/00
/conf/entries/00/host1::192.168.1.211
/conf/entries/00/host2::192.168.1.213
...

import

Can either import from a file or take alternatively path + data as parameters

zkutil import -h
Usage: zk_import.rb [options] -c <host:port> -p /some/path -n somedata
       or
       zk_import.rb -c <host:port> -f </some/file/name>
    -c, --connectstring host:port    defaults to 
    -s, --separator sep              separator /path[::]data
    -p, --path path                  path to create or delete
    -n, --node_data <data>           data to add to the node, if creating
    -d, --delete                     Output more information
    -f, --file FILE                  the import file to read from
    -v, --verbose                    Output more information
    -h, --help                       Display this screen

purge

Delete all data from the path.

zkutil purge -h
Usage: zk_purge.rb [options] -c <host:port>
    -c, --connectstring host:port    defaults to 
    -p, --path path                  path to purge, defaults to '/'
    -v, --verbose                    Output more information
    -h, --help                       Display this screen