You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@knox.apache.org by km...@apache.org on 2016/03/01 15:26:56 UTC

svn commit: r1733079 [1/10] - in /knox: site/ site/books/knox-0-8-0/ site/books/knox-0-9-0/ trunk/ trunk/books/0.8.0/ trunk/books/0.8.0/dev-guide/ trunk/books/0.9.0/ trunk/books/0.9.0/dev-guide/

Author: kminder
Date: Tue Mar  1 14:26:55 2016
New Revision: 1733079

URL: http://svn.apache.org/viewvc?rev=1733079&view=rev
Log:
[KNOX-674] - Expose Jetty's SSL cipher suite configuration via gateway-site.xml

Added:
    knox/site/books/knox-0-9-0/
    knox/site/books/knox-0-9-0/apache-incubator-logo.png   (with props)
    knox/site/books/knox-0-9-0/apache-logo.gif   (with props)
    knox/site/books/knox-0-9-0/arrow.png   (with props)
    knox/site/books/knox-0-9-0/book.css
    knox/site/books/knox-0-9-0/bulb.png   (with props)
    knox/site/books/knox-0-9-0/check.png   (with props)
    knox/site/books/knox-0-9-0/deployment-overview.png   (with props)
    knox/site/books/knox-0-9-0/deployment-provider.png   (with props)
    knox/site/books/knox-0-9-0/deployment-service.png   (with props)
    knox/site/books/knox-0-9-0/dev-guide.html
    knox/site/books/knox-0-9-0/earth.png   (with props)
    knox/site/books/knox-0-9-0/error.png   (with props)
    knox/site/books/knox-0-9-0/general_saml_flow.png   (with props)
    knox/site/books/knox-0-9-0/info.png   (with props)
    knox/site/books/knox-0-9-0/invalid.png   (with props)
    knox/site/books/knox-0-9-0/knox-logo.gif   (with props)
    knox/site/books/knox-0-9-0/knoxsso_integration.html
    knox/site/books/knox-0-9-0/markbook-section-link.png   (with props)
    knox/site/books/knox-0-9-0/plus.png   (with props)
    knox/site/books/knox-0-9-0/question.png   (with props)
    knox/site/books/knox-0-9-0/runtime-overview.png   (with props)
    knox/site/books/knox-0-9-0/runtime-request-processing.png   (with props)
    knox/site/books/knox-0-9-0/star.png   (with props)
    knox/site/books/knox-0-9-0/stop.png   (with props)
    knox/site/books/knox-0-9-0/user-guide.html
    knox/site/books/knox-0-9-0/warning.png   (with props)
    knox/site/books/knox-0-9-0/workflow-configuration.xml
    knox/site/books/knox-0-9-0/workflow-definition.xml
    knox/trunk/books/0.9.0/
    knox/trunk/books/0.9.0/admin_api.md
    knox/trunk/books/0.9.0/book.md
    knox/trunk/books/0.9.0/book.md.orig
    knox/trunk/books/0.9.0/book_client-details.md
    knox/trunk/books/0.9.0/book_gateway-details.md
    knox/trunk/books/0.9.0/book_gateway-details.md.orig
    knox/trunk/books/0.9.0/book_getting-started.md
    knox/trunk/books/0.9.0/book_knox-samples.md
    knox/trunk/books/0.9.0/book_limitations.md
    knox/trunk/books/0.9.0/book_service-details.md
    knox/trunk/books/0.9.0/book_troubleshooting.md
    knox/trunk/books/0.9.0/book_ui_service_details.md
    knox/trunk/books/0.9.0/config.md
    knox/trunk/books/0.9.0/config_advanced_ldap.md
    knox/trunk/books/0.9.0/config_audit.md
    knox/trunk/books/0.9.0/config_authn.md
    knox/trunk/books/0.9.0/config_authz.md
    knox/trunk/books/0.9.0/config_ha.md
    knox/trunk/books/0.9.0/config_id_assertion.md
    knox/trunk/books/0.9.0/config_kerberos.md
    knox/trunk/books/0.9.0/config_knox_sso.md
    knox/trunk/books/0.9.0/config_ldap_authc_cache.md
    knox/trunk/books/0.9.0/config_ldap_group_lookup.md
    knox/trunk/books/0.9.0/config_mutual_authentication_ssl.md
    knox/trunk/books/0.9.0/config_pac4j_provider.md
    knox/trunk/books/0.9.0/config_preauth_sso_provider.md
    knox/trunk/books/0.9.0/config_sandbox.md
    knox/trunk/books/0.9.0/config_webappsec_provider.md
    knox/trunk/books/0.9.0/dev-guide/
    knox/trunk/books/0.9.0/dev-guide/book.md
    knox/trunk/books/0.9.0/dev-guide/deployment-overview.puml
    knox/trunk/books/0.9.0/dev-guide/deployment-provider-simple.puml
    knox/trunk/books/0.9.0/dev-guide/deployment-provider.puml
    knox/trunk/books/0.9.0/dev-guide/deployment-service-simple.puml
    knox/trunk/books/0.9.0/dev-guide/deployment-service.puml
    knox/trunk/books/0.9.0/dev-guide/general_saml_flow.puml
    knox/trunk/books/0.9.0/dev-guide/knoxsso_integration.md
    knox/trunk/books/0.9.0/dev-guide/runtime-overview.puml
    knox/trunk/books/0.9.0/dev-guide/runtime-request-processing.puml
    knox/trunk/books/0.9.0/knox_cli.md
    knox/trunk/books/0.9.0/likeised
    knox/trunk/books/0.9.0/quick_start.md
    knox/trunk/books/0.9.0/service_default_ha.md
    knox/trunk/books/0.9.0/service_hbase.md
    knox/trunk/books/0.9.0/service_hive.md
    knox/trunk/books/0.9.0/service_oozie.md
    knox/trunk/books/0.9.0/service_service_test.md
    knox/trunk/books/0.9.0/service_storm.md
    knox/trunk/books/0.9.0/service_webhcat.md
    knox/trunk/books/0.9.0/service_webhdfs.md
    knox/trunk/books/0.9.0/service_yarn.md
    knox/trunk/books/0.9.0/x-forwarded-headers.md
Modified:
    knox/site/books/knox-0-8-0/dev-guide.html
    knox/site/books/knox-0-8-0/user-guide.html
    knox/site/index.html
    knox/site/issue-tracking.html
    knox/site/license.html
    knox/site/mail-lists.html
    knox/site/project-info.html
    knox/site/team-list.html
    knox/trunk/books/0.8.0/admin_api.md
    knox/trunk/books/0.8.0/book_client-details.md
    knox/trunk/books/0.8.0/book_getting-started.md
    knox/trunk/books/0.8.0/dev-guide/book.md
    knox/trunk/books/0.8.0/quick_start.md
    knox/trunk/build.xml

Modified: knox/site/books/knox-0-8-0/dev-guide.html
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-8-0/dev-guide.html?rev=1733079&r1=1733078&r2=1733079&view=diff
==============================================================================
--- knox/site/books/knox-0-8-0/dev-guide.html (original)
+++ knox/site/books/knox-0-8-0/dev-guide.html Tue Mar  1 14:26:55 2016
@@ -219,7 +219,7 @@
 </table><h3><a id="Development+Processes">Development Processes</a> <a href="#Development+Processes"><img src="markbook-section-link.png"/></a></h3><p>The project uses Maven in general with a few convenience Ant targets.</p><p>Building the project can be built via Maven or Ant. The two commands below are equivalent.</p>
 <pre><code>mvn clean install
 ant
-</code></pre><p>A more complete build can be done that builds and generates the unsigned ZIP release artifacts. You will find these in the target/{version} directory (e.g. target/0.7.0-SNAPSHOT).</p>
+</code></pre><p>A more complete build can be done that builds and generates the unsigned ZIP release artifacts. You will find these in the target/{version} directory (e.g. target/0.8.0-SNAPSHOT).</p>
 <pre><code>mvn -Prelease clean install
 ant release
 </code></pre><p>There are a few other Ant targets that are especially convenient for testing.</p><p>This command installs the gateway into the {{{install}}} directory of the project. Note that this command does not first build the project.</p>
@@ -491,7 +491,7 @@ public interface ServiceDeploymentContri
     &lt;parent&gt;
         &lt;groupId&gt;org.apache.hadoop&lt;/groupId&gt;
         &lt;artifactId&gt;gateway&lt;/artifactId&gt;
-        &lt;version&gt;0.7.0-SNAPSHOT&lt;/version&gt;
+        &lt;version&gt;0.8.0-SNAPSHOT&lt;/version&gt;
     &lt;/parent&gt;
 
     &lt;artifactId&gt;gateway-service-weather&lt;/artifactId&gt;
@@ -631,7 +631,7 @@ rewrite.xml
     &lt;parent&gt;
         &lt;groupId&gt;org.apache.hadoop&lt;/groupId&gt;
         &lt;artifactId&gt;gateway&lt;/artifactId&gt;
-        &lt;version&gt;0.7.0-SNAPSHOT&lt;/version&gt;
+        &lt;version&gt;0.8.0-SNAPSHOT&lt;/version&gt;
     &lt;/parent&gt;
 
     &lt;artifactId&gt;gateway-provider-security-authn-sample&lt;/artifactId&gt;

Modified: knox/site/books/knox-0-8-0/user-guide.html
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-8-0/user-guide.html?rev=1733079&r1=1733078&r2=1733079&view=diff
==============================================================================
--- knox/site/books/knox-0-8-0/user-guide.html (original)
+++ knox/site/books/knox-0-8-0/user-guide.html Tue Mar  1 14:26:55 2016
@@ -86,20 +86,20 @@
   <li>Do Hadoop with Knox</li>
 </ol><h3><a id="1+-+Requirements">1 - Requirements</a> <a href="#1+-+Requirements"><img src="markbook-section-link.png"/></a></h3><h4><a id="Java">Java</a> <a href="#Java"><img src="markbook-section-link.png"/></a></h4><p>Java 1.6 or later is required for the Knox Gateway runtime. Use the command below to check the version of Java installed on the system where Knox will be running.</p>
 <pre><code>java -version
-</code></pre><h4><a id="Hadoop">Hadoop</a> <a href="#Hadoop"><img src="markbook-section-link.png"/></a></h4><p>Knox 0.7.0 supports Hadoop 2.x, the quick start instructions assume a Hadoop 2.x virtual machine based environment.</p><h3><a id="2+-+Download+Hadoop+2.x+VM">2 - Download Hadoop 2.x VM</a> <a href="#2+-+Download+Hadoop+2.x+VM"><img src="markbook-section-link.png"/></a></h3><p>The quick start provides a link to download Hadoop 2.0 based Hortonworks virtual machine <a href="http://hortonworks.com/products/hdp-2/#install">Sandbox</a>. Please note Knox supports other Hadoop distributions and is configurable against a full-blown Hadoop cluster. Configuring Knox for Hadoop 2.x version, or Hadoop deployed in EC2 or a custom Hadoop cluster is documented in advance deployment guide.</p><h3><a id="3+-+Download+Apache+Knox+Gateway">3 - Download Apache Knox Gateway</a> <a href="#3+-+Download+Apache+Knox+Gateway"><img src="markbook-section-link.png"/></a></h3><p>Download one of the dist
 ributions below from the <a href="http://www.apache.org/dyn/closer.cgi/knox">Apache mirrors</a>.</p>
+</code></pre><h4><a id="Hadoop">Hadoop</a> <a href="#Hadoop"><img src="markbook-section-link.png"/></a></h4><p>Knox 0.8.0 supports Hadoop 2.x, the quick start instructions assume a Hadoop 2.x virtual machine based environment.</p><h3><a id="2+-+Download+Hadoop+2.x+VM">2 - Download Hadoop 2.x VM</a> <a href="#2+-+Download+Hadoop+2.x+VM"><img src="markbook-section-link.png"/></a></h3><p>The quick start provides a link to download Hadoop 2.0 based Hortonworks virtual machine <a href="http://hortonworks.com/products/hdp-2/#install">Sandbox</a>. Please note Knox supports other Hadoop distributions and is configurable against a full-blown Hadoop cluster. Configuring Knox for Hadoop 2.x version, or Hadoop deployed in EC2 or a custom Hadoop cluster is documented in advance deployment guide.</p><h3><a id="3+-+Download+Apache+Knox+Gateway">3 - Download Apache Knox Gateway</a> <a href="#3+-+Download+Apache+Knox+Gateway"><img src="markbook-section-link.png"/></a></h3><p>Download one of the dist
 ributions below from the <a href="http://www.apache.org/dyn/closer.cgi/knox">Apache mirrors</a>.</p>
 <ul>
-  <li>Source archive: <a href="http://www.apache.org/dyn/closer.cgi/knox/0.7.0/knox-0.7.0-src.zip">knox-0.7.0-src.zip</a> (<a href="http://www.apache.org/dist/knox/0.7.0/knox-0.7.0-src.zip.asc">PGP signature</a>, <a href="http://www.apache.org/dist/knox/0.7.0/knox-0.7.0-src.zip.sha">SHA1 digest</a>, <a href="http://www.apache.org/dist/knox/0.7.0/knox-0.7.0-src.zip.md5">MD5 digest</a>)</li>
-  <li>Binary archive: <a href="http://www.apache.org/dyn/closer.cgi/knox/0.7.0/knox-0.7.0.zip">knox-0.7.0.zip</a> (<a href="http://www.apache.org/dist/knox/0.7.0/knox-0.7.0.zip.asc">PGP signature</a>, <a href="http://www.apache.org/dist/knox/0.7.0/knox-0.7.0.zip.sha">SHA1 digest</a>, <a href="http://www.apache.org/dist/knox/0.7.0/knox-0.7.0.zip.md5">MD5 digest</a>)</li>
+  <li>Source archive: <a href="http://www.apache.org/dyn/closer.cgi/knox/0.8.0/knox-0.8.0-src.zip">knox-0.8.0-src.zip</a> (<a href="http://www.apache.org/dist/knox/0.8.0/knox-0.8.0-src.zip.asc">PGP signature</a>, <a href="http://www.apache.org/dist/knox/0.8.0/knox-0.8.0-src.zip.sha">SHA1 digest</a>, <a href="http://www.apache.org/dist/knox/0.8.0/knox-0.8.0-src.zip.md5">MD5 digest</a>)</li>
+  <li>Binary archive: <a href="http://www.apache.org/dyn/closer.cgi/knox/0.8.0/knox-0.8.0.zip">knox-0.8.0.zip</a> (<a href="http://www.apache.org/dist/knox/0.8.0/knox-0.8.0.zip.asc">PGP signature</a>, <a href="http://www.apache.org/dist/knox/0.8.0/knox-0.8.0.zip.sha">SHA1 digest</a>, <a href="http://www.apache.org/dist/knox/0.8.0/knox-0.8.0.zip.md5">MD5 digest</a>)</li>
 </ul><p>Apache Knox Gateway releases are available under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>. See the NOTICE file contained in each release artifact for applicable copyright attribution notices.</p><h3><a id="Verify">Verify</a> <a href="#Verify"><img src="markbook-section-link.png"/></a></h3><p>While recommended, verify is an optional step. You can verify the integrity of any downloaded files using the PGP signatures. Please read <a href="http://httpd.apache.org/dev/verification.html">Verifying Apache HTTP Server Releases</a> for more information on why you should verify our releases.</p><p>The PGP signatures can be verified using PGP or GPG. First download the <a href="https://dist.apache.org/repos/dist/release/knox/KEYS">KEYS</a> file as well as the .asc signature files for the relevant release packages. Make sure you get these files from the main distribution directory linked above, rather than from a mirror. Then verify the si
 gnatures using one of the methods below.</p>
 <pre><code>% pgpk -a KEYS
-% pgpv knox-0.7.0.zip.asc
+% pgpv knox-0.8.0.zip.asc
 </code></pre><p>or</p>
 <pre><code>% pgp -ka KEYS
-% pgp knox-0.7.0.zip.asc
+% pgp knox-0.8.0.zip.asc
 </code></pre><p>or</p>
 <pre><code>% gpg --import KEYS
-% gpg --verify knox-0.7.0.zip.asc
-</code></pre><h3><a id="4+-+Start+Hadoop+virtual+machine">4 - Start Hadoop virtual machine</a> <a href="#4+-+Start+Hadoop+virtual+machine"><img src="markbook-section-link.png"/></a></h3><p>Start the Hadoop virtual machine.</p><h3><a id="5+-+Install+Knox">5 - Install Knox</a> <a href="#5+-+Install+Knox"><img src="markbook-section-link.png"/></a></h3><p>The steps required to install the gateway will vary depending upon which distribution format (zip | rpm) was downloaded. In either case you will end up with a directory where the gateway is installed. This directory will be referred to as your <code>{GATEWAY_HOME}</code> throughout this document.</p><h4><a id="ZIP">ZIP</a> <a href="#ZIP"><img src="markbook-section-link.png"/></a></h4><p>If you downloaded the Zip distribution you can simply extract the contents into a directory. The example below provides a command that can be executed to do this. Note the <code>{VERSION}</code> portion of the command must be replaced with an actual Apa
 che Knox Gateway version number. This might be 0.7.0 for example.</p>
+% gpg --verify knox-0.8.0.zip.asc
+</code></pre><h3><a id="4+-+Start+Hadoop+virtual+machine">4 - Start Hadoop virtual machine</a> <a href="#4+-+Start+Hadoop+virtual+machine"><img src="markbook-section-link.png"/></a></h3><p>Start the Hadoop virtual machine.</p><h3><a id="5+-+Install+Knox">5 - Install Knox</a> <a href="#5+-+Install+Knox"><img src="markbook-section-link.png"/></a></h3><p>The steps required to install the gateway will vary depending upon which distribution format (zip | rpm) was downloaded. In either case you will end up with a directory where the gateway is installed. This directory will be referred to as your <code>{GATEWAY_HOME}</code> throughout this document.</p><h4><a id="ZIP">ZIP</a> <a href="#ZIP"><img src="markbook-section-link.png"/></a></h4><p>If you downloaded the Zip distribution you can simply extract the contents into a directory. The example below provides a command that can be executed to do this. Note the <code>{VERSION}</code> portion of the command must be replaced with an actual Apa
 che Knox Gateway version number. This might be 0.8.0 for example.</p>
 <pre><code>unzip knox-{VERSION}.zip
 </code></pre><p>This will create a directory <code>knox-{VERSION}</code> in your current directory. The directory <code>knox-{VERSION}</code> will considered your <code>{GATEWAY_HOME}</code></p><h3><a id="6+-+Start+LDAP+embedded+in+Knox">6 - Start LDAP embedded in Knox</a> <a href="#6+-+Start+LDAP+embedded+in+Knox"><img src="markbook-section-link.png"/></a></h3><p>Knox comes with an LDAP server for demonstration purposes. Note: If the tool used to extract the contents of the Tar or tar.gz file was not capable of making the files in the bin directory executable</p>
 <pre><code>cd {GATEWAY_HOME}
@@ -143,7 +143,7 @@ curl -i -k -u guest:guest-password -T LI
 
 curl -i -k -u guest:guest-password -X GET \
     &#39;{Value of Location header from command response above}&#39;
-</code></pre><h2><a id="Apache+Knox+Details">Apache Knox Details</a> <a href="#Apache+Knox+Details"><img src="markbook-section-link.png"/></a></h2><p>This section provides everything you need to know to get the Knox gateway up and running against a Hadoop cluster.</p><h4><a id="Hadoop">Hadoop</a> <a href="#Hadoop"><img src="markbook-section-link.png"/></a></h4><p>An existing Hadoop 2.x cluster is required for Knox 0.7.0 to sit in front of and protect. It is possible to use a Hadoop cluster deployed on EC2 but this will require additional configuration not covered here. It is also possible to protect access to a services of a Hadoop cluster that is secured with Kerberos. This too requires additional configuration that is described in other sections of this guide. See <a href="#Supported+Services">Supported Services</a> for details on what is supported for this release.</p><p>The Hadoop cluster should be ensured to have at least WebHDFS, WebHCat (i.e. Templeton) and Oozie configured, 
 deployed and running. HBase/Stargate and Hive can also be accessed via the Knox Gateway given the proper versions and configuration.</p><p>The instructions that follow assume a few things:</p>
+</code></pre><h2><a id="Apache+Knox+Details">Apache Knox Details</a> <a href="#Apache+Knox+Details"><img src="markbook-section-link.png"/></a></h2><p>This section provides everything you need to know to get the Knox gateway up and running against a Hadoop cluster.</p><h4><a id="Hadoop">Hadoop</a> <a href="#Hadoop"><img src="markbook-section-link.png"/></a></h4><p>An existing Hadoop 2.x cluster is required for Knox 0.8.0 to sit in front of and protect. It is possible to use a Hadoop cluster deployed on EC2 but this will require additional configuration not covered here. It is also possible to protect access to a services of a Hadoop cluster that is secured with Kerberos. This too requires additional configuration that is described in other sections of this guide. See <a href="#Supported+Services">Supported Services</a> for details on what is supported for this release.</p><p>The Hadoop cluster should be ensured to have at least WebHDFS, WebHCat (i.e. Templeton) and Oozie configured, 
 deployed and running. HBase/Stargate and Hive can also be accessed via the Knox Gateway given the proper versions and configuration.</p><p>The instructions that follow assume a few things:</p>
 <ol>
   <li>The gateway is <em>not</em> collocated with the Hadoop clusters themselves.</li>
   <li>The host names and IP addresses of the cluster services are accessible by the gateway where ever it happens to be running.</li>
@@ -903,7 +903,7 @@ keytool -keystore gateway.jks -storepass
   <li><h6>HTTP DELETE</h6></li>
 </ul><h5><a id="Server+Version">Server Version</a> <a href="#Server+Version"><img src="markbook-section-link.png"/></a></h5><h6><a id="Description">Description</a> <a href="#Description"><img src="markbook-section-link.png"/></a></h6><p>Calls to Knox and returns the gateway&rsquo;s current version and the version hash inside of a JSON object. </p><h6><a id="Example+Request+URL">Example Request URL</a> <a href="#Example+Request+URL"><img src="markbook-section-link.png"/></a></h6><p><code>https://{gateway-host}:{gateway-port}/{gateway-path}/admin/api/v1/version</code> </p><h6><a id="Example+cURL+Request">Example cURL Request</a> <a href="#Example+cURL+Request"><img src="markbook-section-link.png"/></a></h6><p><code>curl -u admin:admin-password -i -k https://{gateway-host}:{gateway-port}/{gateway-path}/admin/api/v1/version</code></p><h6><a id="Response">Response</a> <a href="#Response"><img src="markbook-section-link.png"/></a></h6>
 <pre><code>&lt;ServerVersion&gt;
-    &lt;version&gt;0.7.0&lt;/version&gt;
+    &lt;version&gt;{version-number}&lt;/version&gt;
     &lt;hash&gt;{version-hash}&lt;/hash&gt;
 &lt;/ServerVersion&gt;
 </code></pre><h5><a id="Topology+Collection">Topology Collection</a> <a href="#Topology+Collection"><img src="markbook-section-link.png"/></a></h5><h6><a id="Description">Description</a> <a href="#Description"><img src="markbook-section-link.png"/></a></h6><p>Calls to Knox and return an array of JSON objects that represent the list of deployed topologies currently inside of the gateway. </p><h6><a id="Example+Request+URL">Example Request URL</a> <a href="#Example+Request+URL"><img src="markbook-section-link.png"/></a></h6><p><code>https://{gateway-host}:{gateway-port}/{gateway-path}/admin/api/{api-version}/topologies</code> </p><h6><a id="Example+cURL+Request">Example cURL Request</a> <a href="#Example+cURL+Request"><img src="markbook-section-link.png"/></a></h6><p><code>curl -u admin:admin-password -i -k -H Accept:application/json https://{gateway-host}:{gateway-port}/{gateway-path}/admin/api/v1/topologies</code></p><h6><a id="Response">Response</a> <a href="#Response"><img src="ma
 rkbook-section-link.png"/></a></h6>
@@ -2767,9 +2767,9 @@ dep/httpcore-4.3.3.jar
 dep/commons-lang3-3.4.jar
 dep/commons-codec-1.7.jar
 </code></pre><p>So on Linux/MacOS you would need this command</p>
-<pre><code>groovy -cp lib/gateway-shell-0.7.0.jar:dep/httpclient-4.3.6.jar:dep/httpcore-4.3.3.jar:dep/commons-lang3-3.4.jar:dep/commons-codec-1.7.jar samples/ExampleWebHdfsPutGet.groovy
+<pre><code>groovy -cp lib/gateway-shell-0.8.0.jar:dep/httpclient-4.3.6.jar:dep/httpcore-4.3.3.jar:dep/commons-lang3-3.4.jar:dep/commons-codec-1.7.jar samples/ExampleWebHdfsPutGet.groovy
 </code></pre><p>and on Windows you would need this command</p>
-<pre><code>groovy -cp lib/gateway-shell-0.7.0.jar;dep/httpclient-4.3.6.jar;dep/httpcore-4.3.3.jar;dep/commons-lang3-3.4.jar;dep/commons-codec-1.7.jar samples/ExampleWebHdfsPutGet.groovy
+<pre><code>groovy -cp lib/gateway-shell-0.8.0.jar;dep/httpclient-4.3.6.jar;dep/httpcore-4.3.3.jar;dep/commons-lang3-3.4.jar;dep/commons-codec-1.7.jar samples/ExampleWebHdfsPutGet.groovy
 </code></pre><p>The exact list of required JARs is likely to change from release to release so it is recommended that you utilize the wrapper <code>bin/shell.jar</code>.</p><p>In addition because the DSL can be used via standard Groovy, the Groovy integrations in many popular IDEs (e.g. IntelliJ, Eclipse) can also be used. This makes it particularly nice to develop and execute scripts to interact with Hadoop. The code-completion features in modern IDEs in particular provides immense value. All that is required is to add the <code>gateway-shell-{GATEWAY_VERSION}.jar</code> to the projects class path.</p><p>There are a variety of Groovy tools that make it very easy to work with the standard interchange formats (i.e. JSON and XML). In Groovy the creation of XML or JSON is typically done via a &ldquo;builder&rdquo; and parsing done via a &ldquo;slurper&rdquo;. In addition once JSON or XML is &ldquo;slurped&rdquo; the GPath, an XPath like feature build into Groovy can be used to access d
 ata.</p>
 <ul>
   <li>XML

Added: knox/site/books/knox-0-9-0/apache-incubator-logo.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-9-0/apache-incubator-logo.png?rev=1733079&view=auto
==============================================================================
Binary file - no diff available.

Propchange: knox/site/books/knox-0-9-0/apache-incubator-logo.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: knox/site/books/knox-0-9-0/apache-logo.gif
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-9-0/apache-logo.gif?rev=1733079&view=auto
==============================================================================
Binary file - no diff available.

Propchange: knox/site/books/knox-0-9-0/apache-logo.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: knox/site/books/knox-0-9-0/arrow.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-9-0/arrow.png?rev=1733079&view=auto
==============================================================================
Binary file - no diff available.

Propchange: knox/site/books/knox-0-9-0/arrow.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: knox/site/books/knox-0-9-0/book.css
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-9-0/book.css?rev=1733079&view=auto
==============================================================================
--- knox/site/books/knox-0-9-0/book.css (added)
+++ knox/site/books/knox-0-9-0/book.css Tue Mar  1 14:26:55 2016
@@ -0,0 +1,376 @@
+/*
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+*/
+
+body {
+   font-family: Helvetica, arial, sans-serif;
+   font-size: 14px;
+   line-height: 1.6;
+   padding-top: 10px;
+   padding-bottom: 10px;
+   background-color: white;
+   padding: 30px; }
+
+body > *:first-child {
+   margin-top: 0 !important; }
+body > *:last-child {
+   margin-bottom: 0 !important; }
+
+a {
+   color: #4183C4; }
+a.absent {
+   color: #cc0000; }
+a.anchor {
+   display: block;
+   padding-left: 30px;
+   margin-left: -30px;
+   cursor: pointer;
+   position: absolute;
+   top: 0;
+   left: 0;
+   bottom: 0; }
+
+h1, h2, h3, h4, h5, h6 {
+   margin: 20px 0 10px;
+   padding: 0;
+   font-weight: bold;
+   -webkit-font-smoothing: antialiased;
+   cursor: text;
+   position: relative; }
+
+h1:hover a.anchor, h2:hover a.anchor, h3:hover a.anchor, h4:hover a.anchor, h5:hover a.anchor, h6:hover a.anchor {
+   text-decoration: none; }
+
+h1 tt, h1 code {
+   font-size: inherit; }
+
+h2 tt, h2 code {
+   font-size: inherit; }
+
+h3 tt, h3 code {
+   font-size: inherit; }
+
+h4 tt, h4 code {
+   font-size: inherit; }
+
+h5 tt, h5 code {
+   font-size: inherit; }
+
+h6 tt, h6 code {
+   font-size: inherit; }
+
+h1 {
+   font-size: 28px;
+   border-bottom: 1px solid #cccccc;
+   color: black; }
+
+h2 {
+   font-size: 24px;
+   border-bottom: 1px solid #cccccc;
+   color: black; }
+
+h3 {
+   font-size: 18px; }
+
+h4 {
+   font-size: 16px; }
+
+h5 {
+   font-size: 14px; }
+
+h6 {
+   color: #777777;
+   font-size: 14px; }
+
+ul {
+   margin: 0px 0; }
+
+#content {
+	margin-left: 200px;
+}
+
+#content div {
+	display: none;
+}
+
+
+#content div:target {
+position: static;
+    top: 100px;
+    right: 200px;
+	display: block;
+	clear: none;
+}
+
+
+#banner {
+	top: -10px;
+	background-color: white;
+}
+
+#sidebar {
+    background-color: #e7e7e7;
+	float: left;
+	width: 180px;
+    border: 1px double #999;
+    padding: 7px 5px;
+    display:block;
+    overflow-y: scroll;
+    top: 200px;
+    bottom: 0;   
+}
+
+#sidebar ul:first-child {
+   list-style-type:none;
+   margin:0;
+   padding:0;
+   border-bottom: 1px none #999;
+}
+
+#sidebar li {
+	list-style-type:none;
+	margin:0;
+	padding:0;
+}
+
+#sidebar a {
+   color:  #000;
+   font-size: 1.1em;
+   border: 1px none #999;
+   padding: 2px 0px;
+   display:block;
+   width:128px;
+   background-color:#e7e7e7;
+}
+
+#sidebar a:hover {
+	font-weight: bold;
+	background-color: #f5f5f5;
+}
+
+#page-wrap { 
+  width: 850px; 
+  position: relative; 
+}
+
+p, blockquote, ol, dl, li, table, pre {
+   margin: 15px 0; }
+
+hr {
+   border: 0 none;
+   color: #cccccc;
+   height: 4px;
+   padding: 0;
+}
+
+body > h2:first-child {
+   margin-top: 0;
+   padding-top: 0; }
+body > h1:first-child {
+   margin-top: 0;
+   padding-top: 0; }
+body > h1:first-child + h2 {
+   margin-top: 0;
+   padding-top: 0; }
+body > h3:first-child, body > h4:first-child, body > h5:first-child, body > h6:first-child {
+   margin-top: 0;
+   padding-top: 0; }
+
+a:first-child h1, a:first-child h2, a:first-child h3, a:first-child h4, a:first-child h5, a:first-child h6 {
+   margin-top: 0;
+   padding-top: 0; }
+
+h1 p, h2 p, h3 p, h4 p, h5 p, h6 p {
+   margin-top: 0; }
+
+li p.first {
+   display: inline-block; }
+li {
+   margin: 0; }
+ul, ol {
+   padding-left: 30px; }
+
+ul :first-child, ol :first-child {
+   margin-top: 0; }
+
+dl {
+   padding: 0; }
+dl dt {
+   font-size: 14px;
+   font-weight: bold;
+   font-style: italic;
+   padding: 0;
+   margin: 15px 0 5px; }
+dl dt:first-child {
+   padding: 0; }
+dl dt > :first-child {
+   margin-top: 0; }
+dl dt > :last-child {
+   margin-bottom: 0; }
+dl dd {
+   margin: 0 0 15px;
+   padding: 0 15px; }
+dl dd > :first-child {
+   margin-top: 0; }
+dl dd > :last-child {
+   margin-bottom: 0; }
+
+blockquote {
+   border-left: 4px solid #dddddd;
+   padding: 0 15px;
+   color: #777777; }
+blockquote > :first-child {
+   margin-top: 0; }
+blockquote > :last-child {
+   margin-bottom: 0; }
+
+table {
+   padding: 0;border-collapse: collapse; }
+table tr {
+   border-top: 1px solid #cccccc;
+   background-color: white;
+   margin: 0;
+   padding: 0; }
+table tr:nth-child(2n) {
+   background-color: #f8f8f8; }
+table tr th {
+   font-weight: bold;
+   border: 1px solid #cccccc;
+   margin: 0;
+   padding: 6px 13px; }
+table tr td {
+   border: 1px solid #cccccc;
+   margin: 0;
+   padding: 6px 13px; }
+table tr th :first-child, table tr td :first-child {
+   margin-top: 0; }
+table tr th :last-child, table tr td :last-child {
+   margin-bottom: 0; }
+
+img {
+   max-width: 100%; }
+
+span.frame {
+   display: block;
+   overflow: hidden; }
+span.frame > span {
+   border: 1px solid #dddddd;
+   display: block;
+   float: left;
+   overflow: hidden;
+   margin: 13px 0 0;
+   padding: 7px;
+   width: auto; }
+span.frame span img {
+   display: block;
+   float: left; }
+span.frame span span {
+   clear: both;
+   color: #333333;
+   display: block;
+   padding: 5px 0 0; }
+span.align-center {
+   display: block;
+   overflow: hidden;
+   clear: both; }
+span.align-center > span {
+   display: block;
+   overflow: hidden;
+   margin: 13px auto 0;
+   text-align: center; }
+span.align-center span img {
+   margin: 0 auto;
+   text-align: center; }
+span.align-right {
+   display: block;
+   overflow: hidden;
+   clear: both; }
+span.align-right > span {
+   display: block;
+   overflow: hidden;
+   margin: 13px 0 0;
+   text-align: right; }
+span.align-right span img {
+   margin: 0;
+   text-align: right; }
+span.float-left {
+   display: block;
+   margin-right: 13px;
+   overflow: hidden;
+   float: left; }
+span.float-left span {
+   margin: 13px 0 0; }
+span.float-right {
+   display: block;
+   margin-left: 13px;
+   overflow: hidden;
+   float: right; }
+span.float-right > span {
+   display: block;
+   overflow: hidden;
+   margin: 13px auto 0;
+   text-align: right; }
+
+code, tt {
+   margin: 0 2px;
+   padding: 0 5px;
+   white-space: nowrap;
+   border: 1px solid #eaeaea;
+   background-color: #f8f8f8;
+   border-radius: 3px; }
+
+pre code {
+   margin: 0;
+   padding: 0;
+   white-space: pre;
+   border: none;
+   background: transparent; }
+
+.highlight pre {
+   background-color: #f8f8f8;
+   border: 1px solid #cccccc;
+   font-size: 13px;
+   line-height: 19px;
+   overflow: auto;
+   padding: 6px 10px;
+   border-radius: 3px; }
+
+pre {
+   background-color: #f8f8f8;
+   border: 1px solid #cccccc;
+   font-size: 13px;
+   line-height: 19px;
+   overflow: auto;
+   padding: 6px 10px;
+   border-radius: 3px; }
+pre code, pre tt {
+   background-color: transparent;
+   border: none; }
+
+sup {
+   font-size: 0.83em;
+   vertical-align: super;
+   line-height: 0;
+}
+* {
+   -webkit-print-color-adjust: exact;
+}
+@media screen and (min-width: 914px) {
+   body {
+      width: 854px;
+      margin:0 auto;
+   }
+}

Added: knox/site/books/knox-0-9-0/bulb.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-9-0/bulb.png?rev=1733079&view=auto
==============================================================================
Binary file - no diff available.

Propchange: knox/site/books/knox-0-9-0/bulb.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: knox/site/books/knox-0-9-0/check.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-9-0/check.png?rev=1733079&view=auto
==============================================================================
Binary file - no diff available.

Propchange: knox/site/books/knox-0-9-0/check.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: knox/site/books/knox-0-9-0/deployment-overview.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-9-0/deployment-overview.png?rev=1733079&view=auto
==============================================================================
Binary file - no diff available.

Propchange: knox/site/books/knox-0-9-0/deployment-overview.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: knox/site/books/knox-0-9-0/deployment-provider.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-9-0/deployment-provider.png?rev=1733079&view=auto
==============================================================================
Binary file - no diff available.

Propchange: knox/site/books/knox-0-9-0/deployment-provider.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: knox/site/books/knox-0-9-0/deployment-service.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-9-0/deployment-service.png?rev=1733079&view=auto
==============================================================================
Binary file - no diff available.

Propchange: knox/site/books/knox-0-9-0/deployment-service.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream