[doc] Adding ZooKeeper

docs/user-guide/index.md

@@ -1,13 +1,13 @@
 
 <link rel="stylesheet" href="docbook.css" type="text/css" media="screen" title="no title" charset="utf-8"></link>
 
-Hue 2 User Guide
-================
+Hue User Guide
+==============
 
 -   [Introducing Hue](introducing.html)
 -   [About Hue](about.html)
--   [Beeswax](beeswax.html)
--   [Cloudera Impala Query UI](impala.html)
+-   [Beeswax Hive Editor](beeswax.html)
+-   [Impala Query UI](impala.html)
 -   [Pig Editor](pig.html)
 -   [File Browser](filebrowser.html)
 -   [Metastore Manager](metastore_manager.html)
@@ -16,7 +16,7 @@ Hue 2 User Guide
 -   [Job Designer](jobdesigner.html)
 -   [Oozie Editor and Dashboard](oozie.html)
 -   [Solr Search](search.html)
--   [Hue Shell](shell.html)
+-   [ZooKeeper Browser](zookeeper.html)
 -   [HBase Browser](hbase.html)
 -   [User Admin](admin.html)
 

docs/user-guide/introducing.md

@@ -4,10 +4,11 @@
 Introducing Hue
 ===============
 
-Hue is a set of web applications that enable you to interact with a CDH
-cluster. Hue applications let you browse HDFS, manage a Hive metastore,
-and run Hive and Cloudera Impala queries, HBase and Sqoop commands, Pig
-scripts, MapReduce jobs, and Oozie workflows.
+Hue is a set of web applications that enable you to interact with a Hadoop
+cluster. Hue applications let you browse HDFS and jobs, manage a Hive metastore,
+run Hive, Cloudera Impala queries and Pig scripts, browse HBase,
+export data with Sqoop, submit MapReduce programs, build custom search engines
+with Solr, and schedule repetitive workflows with Oozie.
 
 Hue Architecture
 ----------------

docs/user-guide/zookeeper.md

@@ -0,0 +1,59 @@
+
+<link rel="stylesheet" href="docbook.css" type="text/css" media="screen" title="no title" charset="utf-8"></link>
+
+ZooKeeper Browser
+=================
+
+The main two features are:
+
+- Listing of the ZooKeeper cluster stats and clients
+- Browsing and edition of the ZNode hierarchy
+
+
+ZooKeeper Browser requires the [ZooKeeper
+REST](https://github.com/apache/zookeeper/tree/trunk/src/contrib/rest)
+service to be running. Here is how to setup this one:
+
+First get and build ZooKeeper:
+
+<pre>
+git clone https://github.com/apache/zookeeper
+cd zookeeper
+ant
+Buildfile: /home/hue/Development/zookeeper/build.xml
+
+init:
+       [mkdir] Created dir: /home/hue/Development/zookeeper/build/classes
+       [mkdir] Created dir: /home/hue/Development/zookeeper/build/lib
+       [mkdir] Created dir: /home/hue/Development/zookeeper/build/package/lib
+       [mkdir] Created dir: /home/hue/Development/zookeeper/build/test/lib
+
+   ...
+</pre>
+
+And start the REST service:
+
+<pre>
+cd src/contrib/rest
+nohup ant run&
+</pre>
+
+If ZooKeeper and the REST service are not on the same machine as Hue, go
+update the [Hue
+settings](https://github.com/cloudera/hue/blob/master/desktop/conf.dist/hue.ini#L581)
+and specify the correct hostnames and ports:
+
+<pre>
+    [zookeeper]
+
+      [[clusters]]
+
+        [[[default]]]
+          # Zookeeper ensemble. Comma separated list of Host/Port.
+          # e.g. localhost:2181,localhost:2182,localhost:2183
+          ## host_ports=localhost:2181
+
+          # The URL of the REST contrib service
+          ## rest_url=http://localhost:9998
+</pre>
+