diff --git a/src/docbkx/troubleshooting.xml b/src/docbkx/troubleshooting.xml
index 6ffb942bf93..e7517fbf7b2 100644
--- a/src/docbkx/troubleshooting.xml
+++ b/src/docbkx/troubleshooting.xml
@@ -244,6 +244,37 @@ export HBASE_OPTS="-XX:NewSize=64m -XX:MaxNewSize=64m <cms options from above
See for more information in metric definitions.
+
+ zkcli
+ zkcli is a very useful tool for investigating ZooKeeper-related issues. To invoke:
+
+./hbase zkcli -server host:port <cmd> <args>
+
+ The commands (and arguments) are:
+
+ connect host:port
+ get path [watch]
+ ls path [watch]
+ set path data [version]
+ 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
+
+
+ External Tools
@@ -541,7 +572,8 @@ hadoop 17789 155 35.2 9067824 8604364 ? S<l Mar04 9855:48 /usr/java/j
... are either due to ZooKeeper being down, or unreachable due to network issues.
-
+ The utility may help investigate ZooKeeper issues.
+ Client running out of memory though heap size seems to be stable (but the off-heap/direct heap keeps growing)
@@ -900,6 +932,8 @@ ERROR org.apache.hadoop.hbase.regionserver.HRegionServer: ZooKeeper session expi
See the ZooKeeper Operating Environment Troubleshooting page. It has suggestions and tools for checking disk and networking performance; i.e. the operating environment your ZooKeeper and HBase are running in.
+ Additionally, the utility may help investigate ZooKeeper issues.
+