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 2013/10/28 14:03:10 UTC
svn commit: r1536345 - in /incubator/knox:
site/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html site/index.html
site/issue-tracking.html site/license.html site/mail-lists.html
site/project-info.html site/team-list.html trunk/src/site/site.xml
Author: kminder
Date: Mon Oct 28 13:03:09 2013
New Revision: 1536345
URL: http://svn.apache.org/r1536345
Log:
Update for 0.3.0 release.
Modified:
incubator/knox/site/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html
incubator/knox/site/index.html
incubator/knox/site/issue-tracking.html
incubator/knox/site/license.html
incubator/knox/site/mail-lists.html
incubator/knox/site/project-info.html
incubator/knox/site/team-list.html
incubator/knox/trunk/src/site/site.xml
Modified: incubator/knox/site/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html?rev=1536345&r1=1536344&r2=1536345&view=diff
==============================================================================
--- incubator/knox/site/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html (original)
+++ incubator/knox/site/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html Mon Oct 28 13:03:09 2013
@@ -19,15 +19,12 @@
</div><p><br> <img src="knox-logo.gif" alt="Knox"/> <img src="apache-incubator-logo.png" align="right" alt="Incubator"/></p><h1><a id="Apache+Knox+Gateway+0.3.0+(Incubator)+User's+Guide"></a>Apache Knox Gateway 0.3.0 (Incubator) User’s Guide</h1><h2><a id="Table+Of+Contents"></a>Table Of Contents</h2>
<ul>
<li><a href="#Introduction">Introduction</a></li>
- <li><a href="#Getting+Started">Getting Started</a>
+ <li><a href="#Quick+Start">Quick Start</a></li>
+ <li><a href="#Apache+Knox+Details">Apache Knox Details</a>
<ul>
- <li><a href="#Requirements">Requirements</a></li>
- <li><a href="#Download">Download</a></li>
- <li><a href="#Verify">Verify</a></li>
- <li><a href="#Install">Install</a></li>
+ <li><a href="#Layout">Layout</a></li>
<li><a href="#Supported+Services">Supported Services</a></li>
<li><a href="#Sandbox+Configuration">Sandbox Configuration</a></li>
- <li><a href="#Basic+Usage">Basic Usage</a></li>
</ul></li>
<li><a href="#Gateway+Details">Gateway Details</a>
<ul>
@@ -62,18 +59,24 @@
<li>Limit the network endpoints (and therefore firewall holes) required to access a Hadoop cluster</li>
<li>Hide the internal Hadoop cluster topology from potential attackers</li>
</ul></li>
-</ul><h2><a id="Getting+Started"></a>Getting Started</h2><p>This section provides everything you need to know to get the gateway up and running against a Sandbox VM Hadoop cluster.</p><h3><a id="Requirements"></a>Requirements</h3><h4><a id="Java"></a>Java</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"></a>Hadoop</h4><p>An an existing Hadoop 1.x or 2.x cluster is required for Knox sit in front of and protect. One of the easiest ways to ensure this it to utilize a Hortonworks Sandbox VM. 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 use a limited set of services in Hadoop cluster secured with Kerberos. This too required additional configuration that is not described here. 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>
+</ul><h2><a id="Quick+Start"></a>Quick Start</h2><p>Here are the steps to have Apache Knox up and running against a Hadoop Cluster:</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>
-</ol><p>All of the instructions and samples provided here are tailored and tested to work “out of the box” against a <a href="http://hortonworks.com/products/hortonworks-sandbox">Hortonworks Sandbox 2.x VM</a>.</p><h3><a id="Download"></a>Download</h3><p>Download one of the distributions below from the <a href="http://www.apache.org/dyn/closer.cgi/incubator/knox">Apache mirrors</a>.</p>
+ <li>Verify system requirements</li>
+ <li>Download a virtual machine (VM) with Hadoop</li>
+ <li>Download Apache Knox Gateway</li>
+ <li>Start the virtual machine with Hadoop</li>
+ <li>Install Knox</li>
+ <li>Start the LDAP embedded within Knox</li>
+ <li>Start the Knox Gateway</li>
+ <li>Do Hadoop with Knox</li>
+</ol><h3><a id="1+-+Requirements"></a>1 - Requirements</h3><h4><a id="Java"></a>Java</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"></a>Hadoop</h4><p>Knox supports Hadoop 1.x or 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"></a>2 - Download Hadoop 2.x VM</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 1.x/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"></a>3 - Download Apache Knox Gateway</h3><p>Download one of the distributions below from the <a href="http://www.apache.org/dyn/closer.cgi/incubator/knox">Apache mirrors</a>.</p>
<ul>
<li>Source archive: <a href="http://www.apache.org/dyn/closer.cgi/incubator/knox/0.3.0/knox-incubating-0.3.0-src.zip">knox-incubating-0.3.0-src.zip</a> (<a href="http://www.apache.org/dist/incubator/knox/0.3.0/knox-0.3.0-incubating-src.zip.asc">PGP signature</a>, <a href="http://www.apache.org/dist/incubator/knox/0.3.0/knox-incubating-0.3.0-src.zip.sha">SHA1 digest</a>, <a href="http://www.apache.org/dist/incubator/knox/0.3.0/knox-incubating-0.3.0-src.zip.md5">MD5 digest</a>)</li>
<li>Binary archive: <a href="http://www.apache.org/dyn/closer.cgi/incubator/knox/0.3.0/knox-incubating-0.3.0.zip">knox-incubating-0.3.0.zip</a> (<a href="http://www.apache.org/dist/incubator/knox/0.3.0/knox-incubating-0.3.0.zip.asc">PGP signature</a>, <a href="http://www.apache.org/dist/incubator/knox/0.3.0/knox-incubating-0.3.0.zip.sha">SHA1 digest</a>, <a href="http://www.apache.org/dist/incubator/knox/0.3.0/knox-incubating-0.3.0.zip.md5">MD5 digest</a>)</li>
<li>RPM package: <a href="http://www.apache.org/dyn/closer.cgi/incubator/knox/0.3.0/knox-incubating-0.3.0.rpm">knox-incubating-0.3.0.rpm</a> (<a href="http://www.apache.org/dist/incubator/knox/0.3.0/knox-0.3.0-incubating.rpm.asc">PGP signature</a>, <a href="http://www.apache.org/dist/incubator/knox/0.3.0/knox-incubating-0.3.0.rpm.sha">SHA1 digest</a>, <a href="http://www.apache.org/dist/incubator/knox/0.3.0/knox-incubating-0.3.0.rpm.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"></a>Verify</h3><p>It is essential that you 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 KEYS 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 signatures using one of the methods below.</p>
+</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"></a>Verify</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 KEYS 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 signatures using one of the methods below.</p>
<pre><code>% pgpk -a KEYS
% pgpv knox-incubating-0.3.0.zip.asc
</code></pre><p>or</p>
@@ -82,17 +85,48 @@
</code></pre><p>or</p>
<pre><code>% gpg --import KEYS
% gpg --verify knox-incubating-0.3.0.zip.asc
-</code></pre><h3><a id="Install"></a>Install</h3><p>The steps required to install the gateway will vary depending upon which distribution format 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"></a>ZIP</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 Apache Knox Gateway version number. This might be 0.3.0 for example and must patch the value in the file downloaded.</p>
+</code></pre><h3><a id="4+-+Start+Hadoop+virtual+machine"></a>4 - Start Hadoop virtual machine</h3><p>Start the Hadoop virtual machine.</p><h3><a id="5+-+Install+Knox"></a>5 - Install Knox</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"></a>ZIP</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 Apache Knox Gateway version number. This might be 0.3.0 for example and must patch the value in the file downloaded.</p>
<pre><code>jar xf knox-incubating-{VERSION}.zip
</code></pre><p>This will create a directory <code>knox-incubating-{VERSION}</code> in your current directory. The directory <code>knox-incubating-{VERSION}</code> will considered your <code>{GATEWAY_HOME}</code></p><h4><a id="RPM"></a>RPM</h4><p>If you downloaded the RPM distribution you can install it using normal RPM package tools. It is important that the user that will be running the gateway server is used to install. This is because several directories are created that are owned by this user.</p>
<pre><code>sudo yum localinstall knox-incubating-{VERSION}.rpm
</code></pre><p>or</p>
<pre><code>sudo rpm -ihv knox-incubating-{VERSION}.rpm
-</code></pre><p>This will create several directories.</p>
+</code></pre><h3><a id="6+-+Start+LDAP+embedded+in+Knox"></a>6 - Start LDAP embedded in Knox</h3><p>Knox comes with an LDAP server for demonstration purposes.</p>
+<pre><code>java -jar {GATEWAY_HOME}/bin/ldap.jar conf &
+</code></pre><h3><a id="7+-+Start+Knox"></a>7 - Start Knox</h3><p>The gateway can be started in one of two ways, as java -jar or with a shell script.</p><h6><a id="Starting+via+Java"></a>Starting via Java</h6><p>This is the simplest way to start the gateway. Starting this way will result in all logging being written directly to standard output.</p>
+<pre><code>java -jar {GATEWAY_HOME}/bin/gateway.jar
+</code></pre><p>Upon start, Knox server will prompt you for the master secret (i.e. password). This secret is used to secure artifacts used by the gateway server for things like SSL and credential/password aliasing. This secret will have to be entered at startup unless you choose to persist it.</p><h6><a id="Starting+via+script+(*nix+only)"></a>Starting via script (*nix only)</h6><p>Run the setup command with root privileges.</p>
+<pre><code>sudo {GATEWAY_HOME}/bin/gateway.sh setup
+</code></pre><p>The server will prompt you for the master secret (i.e. password).</p><p>The server can then be started without root privileges using this command.</p>
+<pre><code>{GATEWAY_HOME}/bin/gateway.sh start
+</code></pre><p>When starting the gateway this way the process will be run in the backgroud. The log output is written into the directory /var/log/knox. In addition a PID (process ID) is written into /var/run/knox.</p><p>In order to stop a gateway that was started with the script use this command.</p>
+<pre><code>{GATEWAY_HOME}/bin/gateway.sh stop
+</code></pre><p>If for some reason the gateway is stopped other than by using the command above you may need to clear the tracking PID.</p>
+<pre><code>{GATEWAY_HOME}/bin/gateway.sh clean
+</code></pre><p><strong>NOTE: This command will also clear any log output in /var/log/knox so use this with caution.</strong></p><h3><a id="8+-+Do+Hadoop+with+Knox"></a>8 - Do Hadoop with Knox</h3><h4><a id="Put+a+file+in+HDFS+via+Knox."></a>Put a file in HDFS via Knox.</h4><h4><a id="CAT+a+file+in+HDFS+via+Knox."></a>CAT a file in HDFS via Knox.</h4><h4><a id="Invoke+the+LISTSATUS+operation+on+WebHDFS+via+the+gateway."></a>Invoke the LISTSATUS operation on WebHDFS via the gateway.</h4><p>This will return a directory listing of the root (i.e. /) directory of HDFS.</p>
+<pre><code>curl -i -k -u guest:guest-password -X GET \
+ 'https://localhost:8443/gateway/sandbox/webhdfs/v1/?op=LISTSTATUS'
+</code></pre><p>The results of the above command should result in something to along the lines of the output below. The exact information returned is subject to the content within HDFS in your Hadoop cluster. Successfully executing this command at a minimum proves that the gateway is properly configured to provide access to WebHDFS. It does not necessarily provide that any of the other services are correct configured to be accessible. To validate that see the sections for the individual services in <a href="#Service+Details">Service Details</a>.</p>
+<pre><code>HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 760
+Server: Jetty(6.1.26)
+
+{"FileStatuses":{"FileStatus":[
+{"accessTime":0,"blockSize":0,"group":"hdfs","length":0,"modificationTime":1350595859762,"owner":"hdfs","pathSuffix":"apps","permission":"755","replication":0,"type":"DIRECTORY"},
+{"accessTime":0,"blockSize":0,"group":"mapred","length":0,"modificationTime":1350595874024,"owner":"mapred","pathSuffix":"mapred","permission":"755","replication":0,"type":"DIRECTORY"},
+{"accessTime":0,"blockSize":0,"group":"hdfs","length":0,"modificationTime":1350596040075,"owner":"hdfs","pathSuffix":"tmp","permission":"777","replication":0,"type":"DIRECTORY"},
+{"accessTime":0,"blockSize":0,"group":"hdfs","length":0,"modificationTime":1350595857178,"owner":"hdfs","pathSuffix":"user","permission":"755","replication":0,"type":"DIRECTORY"}
+]}}
+</code></pre><h4><a id="Submit+a+MR+job+via+Knox."></a>Submit a MR job via Knox.</h4><h4><a id="Get+status+of+a+MR+job+via+Knox."></a>Get status of a MR job via Knox.</h4><h4><a id="Cancel+a+MR+job+via+Knox."></a>Cancel a MR job via Knox.</h4><h3><a id="More+Examples"></a>More Examples</h3><h2><a id="Apache+Knox+Details"></a>Apache Knox Details</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"></a>Hadoop</h4><p>An an existing Hadoop 1.x or 2.x cluster is required for Knox 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 use a limited set of services in Hadoop cluster secured with Kerberos. This too required additional configuration that is not described here. 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>
+</ol><p>All of the instructions and samples provided here are tailored and tested to work “out of the box” against a <a href="http://hortonworks.com/products/hortonworks-sandbox">Hortonworks Sandbox 2.x VM</a>.</p><h4><a id="Apache+Knox+Directory+Layout"></a>Apache Knox Directory Layout</h4><p>Knox can be installed by expanding the zip file or with rpm. With rpm based install the following directories are created in addition to those described in this section.</p>
<pre><code>/usr/lib/knox
/var/log/knox
/var/run/knox
-</code></pre><p>The directory <code>/usr/lib/knox</code> is considered your <code>{GATEWAY_HOME}</code> and will adhere to the layout described below. The directory <code>/var/log/knox</code> will contain the output files from the server. The directory <code>/var/run/knox</code> will contain the process ID for a currently running gateway server.</p><h4><a id="Layout"></a>Layout</h4><p>Regardless of the installation method used the layout and content of the <code>{GATEWAY_HOME}</code> will be identical. The table below provides a brief explanation of the important files and directories within <code>{GATEWWAY_HOME}</code></p>
+</code></pre><p>The directory <code>/usr/lib/knox</code> is considered your <code>{GATEWAY_HOME}</code> and will adhere to the layout described below. The directory <code>/var/log/knox</code> will contain the output files from the server. The directory <code>/var/run/knox</code> will contain the process ID for a currently running gateway server.</p><p>Regardless of the installation method used the layout and content of the <code>{GATEWAY_HOME}</code> will be identical. The table below provides a brief explanation of the important files and directories within <code>{GATEWWAY_HOME}</code></p>
<table>
<thead>
<tr>
@@ -230,42 +264,7 @@
<td><img src="question.png" alt="?"/> </td>
</tr>
</tbody>
-</table><h3><a id="Sandbox+Configuration"></a>Sandbox Configuration</h3><p>TODO</p><h3><a id="Basic+Usage"></a>Basic Usage</h3><p>The steps described below are intended to get the Knox Gateway server up and running in its default configuration. Once that is accomplished a very simple example of using the gateway to interact with a Hadoop cluster is provided. More detailed configuration information is provided in the <a href="#Gateway+Details">Gateway Details</a> section. More detailed examples for using each Hadoop service can be found in the <a href="#Service+Details">Service Details</a> section.</p><p>Note that *nix conventions are used throughout this section but in general the Windows alternative should be obvious. In situations where this is not the case a Windows alternative will be provided.</p><h4><a id="Starting+Servers"></a>Starting Servers</h4><h5><a id="1.+Enter+the+`{GATEWAY_HOME}`+directory"></a>1. Enter the <code>{GATEWAY_HOME}</code> directory</h5>
-<pre><code>cd knox-incubation-{VERSION}
-</code></pre><p>The fully qualified name of this directory will be referenced as <code>{GATEWAY_HOME}</code> throughout this document.</p><h5><a id="2.+Start+the+demo+LDAP+server+(ApacheDS)"></a>2. Start the demo LDAP server (ApacheDS)</h5><p>First, understand that the LDAP server provided here is for demonstration purposes. You may configure the gateway to utilize other LDAP systems via the topology descriptor. This is described in step 5 below. The assumption is that most users will leverage the demo LDAP server while evaluating this release and should therefore continue with the instructions here in step 3.</p><p>Edit <code>{GATEWAY_HOME}/conf/users.ldif</code> if required and add any desired users and groups to the file. A sample end user “guest” has been already included. Note that the passwords in this file are “fictitious” and have nothing to do with the actual accounts on the Hadoop cluster you are using. There is also a copy of this file in the templ
ates directory that you can use to start over if necessary. This file is only used by the demo LDAP server.</p><p>Start the LDAP server - pointing it to the config dir where it will find the <code>users.ldif</code> file in the conf directory.</p>
-<pre><code>java -jar bin/ldap.jar conf &
-</code></pre><p><em>On windows this command can be run in its own command window instead of running it in the background via <code>&</code>.</em></p><p>There are a number of log messages of the form <code>Created null.</code> that can safely be ignored. Take note of the port on which it was started as this needs to match later configuration.</p><h5><a id="3.+Start+the+gateway+server"></a>3. Start the gateway server</h5><p>The gateway can be started in one of two ways depending upon your preferences. The first way is to start the gateway directly using the Java’s java -jar command line. The script bin/gateway.sh can also be used to start the gateway. Both options are detailed below.</p><h6><a id="Starting+via+Java"></a>Starting via Java</h6><p>This is the simplest way to start the gateway. Starting this way will result in all logging being written directly to standard output.</p>
-<pre><code>java -jar bin/gateway.jar
-</code></pre><p>The server will prompt you for the master secret (i.e. password). This secret is used to secure artifacts used by the gateway server for things like SSL and credential/password aliasing. This secret will have to be entered at startup unless you choose to persist it. See the Persisting the Master section for more information. Remember this secret and keep it safe. It represents the keys to the kingdom.</p><p>Take note of the port identified in the logging output as you will need this for accessing the gateway.</p><h6><a id="Starting+via+script+(*nix+only)"></a>Starting via script (*nix only)</h6><p>Starting the gateway using the script is a bit more in line with how other Hadoop components are started. Before actually starting the server this way a setup step needs to be performed. This step is required because directories are created in /var/log and /var/run if required. These directories can only be created by the root user so the setup command must be run with root
privileges.</p>
-<pre><code>sudo bin/gateway.sh setup
-</code></pre><p>The server will prompt you for the master secret (i.e. password). This secret is used to secure artifacts used by the gateway server for things like SSL and credential/password aliasing. This secret will have to be entered at startup unless you choose to persist it. See the Persisting the Master section for more information. Remember this secret and keep it safe. It represents the keys to the kingdom.</p><p>The server can then be started without root privileges using this command.</p>
-<pre><code>bin/gateway.sh start
-</code></pre><p>When starting the gateway this way the process will be run in the backgroud. The log output is written into the directory /var/log/knox. In addition a PID (process ID) is written into /var/run/knox.</p><p>In order to stop a gateway that was started with the script use this command.</p>
-<pre><code>bin/gateway.sh stop
-</code></pre><p>If for some reason the gateway is stopped other than by using the command above you may need to clear the tracking PID.</p>
-<pre><code>bin/gateway.sh clean
-</code></pre><p><strong>CAUTION: This command will also clear any log output in /var/log/knox so use this with caution.</strong></p><h5><a id="4.+Configure+the+Gateway+with+the+topology+of+your+Hadoop+cluster"></a>4. Configure the Gateway with the topology of your Hadoop cluster</h5><p>Edit the file <code>{GATEWAY_HOME}/deployments/sandbox.xml</code></p><p>Change the host and port in the urls of the <code><service></code> elements for WEBHDFS, WEBHCAT, OOZIE, WEBHBASE and HIVE services to match your Hadoop cluster deployment.</p><p>The default configuration contains the LDAP URL for a LDAP server. By default that file is configured to access the demo ApacheDS based LDAP server and its default configuration. The ApacheDS based LDAP server listens on port 33389 by default. Optionally, you can change the LDAP URL for the LDAP server to be used for authentication. This is set via the <code>main.ldapRealm.contextFactory.url</code> property in the <code><gateway><provider&g
t;<authentication></code> section. If you use an LDAP system other than the demo LDAP server you may need to change additional configuration as well.</p><p>Save the file. The directory <code>{GATEWAY_HOME}/deployments</code> is monitored by the gateway server. When a new or changed cluster topology descriptor is detected, it will provision the endpoints for the services described in the topology descriptor. Note that the name of the file excluding the extension is also used as the path for that cluster in the URL. For example the <code>sandbox.xml</code> file will result in gateway URLs of the form <code>http://{gateway-host}:{gateway-port}/gateway/sandbox/webhdfs</code>.</p><h5><a id="5.+Test+the+installation"></a>5. Test the installation</h5><p>Invoke the LISTSATUS operation on WebHDFS via the gateway. This will return a directory listing of the root (i.e. /) directory of HDFS.</p>
-<pre><code>curl -i -k -u guest:guest-password -X GET \
- 'https://localhost:8443/gateway/sandbox/webhdfs/v1/?op=LISTSTATUS'
-</code></pre><p>The results of the above command should result in something to along the lines of the output below. The exact information returned is subject to the content within HDFS in your Hadoop cluster. Successfully executing this command at a minimum proves that the gateway is properly configured to provide access to WebHDFS. It does not necessarily provide that any of the other services are correct configured to be accessible. To validate that see the sections for the individual services in <a href="#Service+Details">Service Details</a>.</p>
-<pre><code>HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 760
-Server: Jetty(6.1.26)
-
-{"FileStatuses":{"FileStatus":[
-{"accessTime":0,"blockSize":0,"group":"hdfs","length":0,"modificationTime":1350595859762,"owner":"hdfs","pathSuffix":"apps","permission":"755","replication":0,"type":"DIRECTORY"},
-{"accessTime":0,"blockSize":0,"group":"mapred","length":0,"modificationTime":1350595874024,"owner":"mapred","pathSuffix":"mapred","permission":"755","replication":0,"type":"DIRECTORY"},
-{"accessTime":0,"blockSize":0,"group":"hdfs","length":0,"modificationTime":1350596040075,"owner":"hdfs","pathSuffix":"tmp","permission":"777","replication":0,"type":"DIRECTORY"},
-{"accessTime":0,"blockSize":0,"group":"hdfs","length":0,"modificationTime":1350595857178,"owner":"hdfs","pathSuffix":"user","permission":"755","replication":0,"type":"DIRECTORY"}
-]}}
-</code></pre><p>For additional information on WebHDFS, WebHCat/Templeton, Oozie and HBase/Stargate REST APIs, see the following URLs respectively:</p>
-<ul>
- <li>WebHDFS - <a href="http://hadoop.apache.org/docs/current/hadoop-project-dist/hadoop-hdfs/WebHDFS.html">http://hadoop.apache.org/docs/current/hadoop-project-dist/hadoop-hdfs/WebHDFS.html</a></li>
- <li>WebHCat (Templeton) - <a href="http://people.apache.org/~thejas/templeton_doc_v1">http://people.apache.org/~thejas/templeton_doc_v1</a></li>
- <li>Oozie - <a href="http://oozie.apache.org/docs/3.3.1/WebServicesAPI.html">http://oozie.apache.org/docs/3.3.1/WebServicesAPI.html</a></li>
- <li>Stargate (HBase) - <a href="http://wiki.apache.org/hadoop/Hbase/Stargate">http://wiki.apache.org/hadoop/Hbase/Stargate</a></li>
-</ul><h3><a id="More+Examples"></a>More Examples</h3><p>These examples provide more detail about how to access various Apache Hadoop services via the Apache Knox Gateway.</p>
+</table><h3><a id="Sandbox+Configuration"></a>Sandbox Configuration</h3><p>TODO</p><h3><a id="More+Examples"></a>More Examples</h3><p>These examples provide more detail about how to access various Apache Hadoop services via the Apache Knox Gateway.</p>
<ul>
<li><a href="#WebHDFS+Examples">WebHDFS Examples</a></li>
<li><a href="#WebHCat+Examples">WebHCat Examples</a></li>
Modified: incubator/knox/site/index.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/index.html?rev=1536345&r1=1536344&r2=1536345&view=diff
==============================================================================
--- incubator/knox/site/index.html (original)
+++ incubator/knox/site/index.html Mon Oct 28 13:03:09 2013
@@ -1,5 +1,5 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 9, 2013 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 28, 2013 -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
@import url("./css/site.css");
</style>
<link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
- <meta name="Date-Revision-yyyymmdd" content="20131009" />
+ <meta name="Date-Revision-yyyymmdd" content="20131028" />
<meta http-equiv="Content-Language" content="en" />
<script type="text/javascript">var _gaq = _gaq || [];
@@ -57,7 +57,7 @@
<a href="https://cwiki.apache.org/confluence/display/KNOX/Index" class="externalLink" title="Wiki">Wiki</a>
- | <span id="publishDate">Last Published: 2013-10-09</span>
+ | <span id="publishDate">Last Published: 2013-10-28</span>
| <span id="projectVersion">Version: 0.0.0-SNAPSHOT</span>
</div>
<div class="clear">
@@ -83,16 +83,10 @@
<h5>Documentation</h5>
<ul>
<li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Getting+Started" class="externalLink" title="Getting Started">Getting Started</a>
+ <a href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html" class="externalLink" title="User's Guide">User's Guide</a>
</li>
<li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Examples" class="externalLink" title="Usage Examples">Usage Examples</a>
- </li>
- <li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Client+Usage" class="externalLink" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
- </li>
- <li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Sandbox+Configuration" class="externalLink" title="Sandbox Configuration">Sandbox Configuration</a>
+ <a href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html#Getting+Started" class="externalLink" title="Getting Started">Getting Started</a>
</li>
<li class="none">
<a href="https://cwiki.apache.org/confluence/display/KNOX/Dependencies" class="externalLink" title="Dependencies">Dependencies</a>
@@ -104,6 +98,9 @@
<h5>Releases</h5>
<ul>
<li class="none">
+ <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.3.0" class="externalLink" title="0.3.0">0.3.0</a>
+ </li>
+ <li class="none">
<a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.2.0" class="externalLink" title="0.2.0">0.2.0</a>
</li>
<li class="none">
Modified: incubator/knox/site/issue-tracking.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/issue-tracking.html?rev=1536345&r1=1536344&r2=1536345&view=diff
==============================================================================
--- incubator/knox/site/issue-tracking.html (original)
+++ incubator/knox/site/issue-tracking.html Mon Oct 28 13:03:09 2013
@@ -1,5 +1,5 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 9, 2013 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 28, 2013 -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
@import url("./css/site.css");
</style>
<link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
- <meta name="Date-Revision-yyyymmdd" content="20131009" />
+ <meta name="Date-Revision-yyyymmdd" content="20131028" />
<meta http-equiv="Content-Language" content="en" />
<script type="text/javascript">var _gaq = _gaq || [];
@@ -57,7 +57,7 @@
<a href="https://cwiki.apache.org/confluence/display/KNOX/Index" class="externalLink" title="Wiki">Wiki</a>
- | <span id="publishDate">Last Published: 2013-10-09</span>
+ | <span id="publishDate">Last Published: 2013-10-28</span>
| <span id="projectVersion">Version: 0.0.0-SNAPSHOT</span>
</div>
<div class="clear">
@@ -83,16 +83,10 @@
<h5>Documentation</h5>
<ul>
<li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Getting+Started" class="externalLink" title="Getting Started">Getting Started</a>
+ <a href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html" class="externalLink" title="User's Guide">User's Guide</a>
</li>
<li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Examples" class="externalLink" title="Usage Examples">Usage Examples</a>
- </li>
- <li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Client+Usage" class="externalLink" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
- </li>
- <li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Sandbox+Configuration" class="externalLink" title="Sandbox Configuration">Sandbox Configuration</a>
+ <a href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html#Getting+Started" class="externalLink" title="Getting Started">Getting Started</a>
</li>
<li class="none">
<a href="https://cwiki.apache.org/confluence/display/KNOX/Dependencies" class="externalLink" title="Dependencies">Dependencies</a>
@@ -104,6 +98,9 @@
<h5>Releases</h5>
<ul>
<li class="none">
+ <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.3.0" class="externalLink" title="0.3.0">0.3.0</a>
+ </li>
+ <li class="none">
<a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.2.0" class="externalLink" title="0.2.0">0.2.0</a>
</li>
<li class="none">
Modified: incubator/knox/site/license.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/license.html?rev=1536345&r1=1536344&r2=1536345&view=diff
==============================================================================
--- incubator/knox/site/license.html (original)
+++ incubator/knox/site/license.html Mon Oct 28 13:03:09 2013
@@ -1,5 +1,5 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 9, 2013 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 28, 2013 -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
@import url("./css/site.css");
</style>
<link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
- <meta name="Date-Revision-yyyymmdd" content="20131009" />
+ <meta name="Date-Revision-yyyymmdd" content="20131028" />
<meta http-equiv="Content-Language" content="en" />
<script type="text/javascript">var _gaq = _gaq || [];
@@ -57,7 +57,7 @@
<a href="https://cwiki.apache.org/confluence/display/KNOX/Index" class="externalLink" title="Wiki">Wiki</a>
- | <span id="publishDate">Last Published: 2013-10-09</span>
+ | <span id="publishDate">Last Published: 2013-10-28</span>
| <span id="projectVersion">Version: 0.0.0-SNAPSHOT</span>
</div>
<div class="clear">
@@ -83,16 +83,10 @@
<h5>Documentation</h5>
<ul>
<li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Getting+Started" class="externalLink" title="Getting Started">Getting Started</a>
+ <a href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html" class="externalLink" title="User's Guide">User's Guide</a>
</li>
<li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Examples" class="externalLink" title="Usage Examples">Usage Examples</a>
- </li>
- <li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Client+Usage" class="externalLink" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
- </li>
- <li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Sandbox+Configuration" class="externalLink" title="Sandbox Configuration">Sandbox Configuration</a>
+ <a href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html#Getting+Started" class="externalLink" title="Getting Started">Getting Started</a>
</li>
<li class="none">
<a href="https://cwiki.apache.org/confluence/display/KNOX/Dependencies" class="externalLink" title="Dependencies">Dependencies</a>
@@ -104,6 +98,9 @@
<h5>Releases</h5>
<ul>
<li class="none">
+ <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.3.0" class="externalLink" title="0.3.0">0.3.0</a>
+ </li>
+ <li class="none">
<a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.2.0" class="externalLink" title="0.2.0">0.2.0</a>
</li>
<li class="none">
Modified: incubator/knox/site/mail-lists.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/mail-lists.html?rev=1536345&r1=1536344&r2=1536345&view=diff
==============================================================================
--- incubator/knox/site/mail-lists.html (original)
+++ incubator/knox/site/mail-lists.html Mon Oct 28 13:03:09 2013
@@ -1,5 +1,5 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 9, 2013 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 28, 2013 -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
@import url("./css/site.css");
</style>
<link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
- <meta name="Date-Revision-yyyymmdd" content="20131009" />
+ <meta name="Date-Revision-yyyymmdd" content="20131028" />
<meta http-equiv="Content-Language" content="en" />
<script type="text/javascript">var _gaq = _gaq || [];
@@ -57,7 +57,7 @@
<a href="https://cwiki.apache.org/confluence/display/KNOX/Index" class="externalLink" title="Wiki">Wiki</a>
- | <span id="publishDate">Last Published: 2013-10-09</span>
+ | <span id="publishDate">Last Published: 2013-10-28</span>
| <span id="projectVersion">Version: 0.0.0-SNAPSHOT</span>
</div>
<div class="clear">
@@ -83,16 +83,10 @@
<h5>Documentation</h5>
<ul>
<li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Getting+Started" class="externalLink" title="Getting Started">Getting Started</a>
+ <a href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html" class="externalLink" title="User's Guide">User's Guide</a>
</li>
<li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Examples" class="externalLink" title="Usage Examples">Usage Examples</a>
- </li>
- <li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Client+Usage" class="externalLink" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
- </li>
- <li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Sandbox+Configuration" class="externalLink" title="Sandbox Configuration">Sandbox Configuration</a>
+ <a href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html#Getting+Started" class="externalLink" title="Getting Started">Getting Started</a>
</li>
<li class="none">
<a href="https://cwiki.apache.org/confluence/display/KNOX/Dependencies" class="externalLink" title="Dependencies">Dependencies</a>
@@ -104,6 +98,9 @@
<h5>Releases</h5>
<ul>
<li class="none">
+ <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.3.0" class="externalLink" title="0.3.0">0.3.0</a>
+ </li>
+ <li class="none">
<a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.2.0" class="externalLink" title="0.2.0">0.2.0</a>
</li>
<li class="none">
Modified: incubator/knox/site/project-info.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/project-info.html?rev=1536345&r1=1536344&r2=1536345&view=diff
==============================================================================
--- incubator/knox/site/project-info.html (original)
+++ incubator/knox/site/project-info.html Mon Oct 28 13:03:09 2013
@@ -1,5 +1,5 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 9, 2013 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 28, 2013 -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
@import url("./css/site.css");
</style>
<link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
- <meta name="Date-Revision-yyyymmdd" content="20131009" />
+ <meta name="Date-Revision-yyyymmdd" content="20131028" />
<meta http-equiv="Content-Language" content="en" />
<script type="text/javascript">var _gaq = _gaq || [];
@@ -57,7 +57,7 @@
<a href="https://cwiki.apache.org/confluence/display/KNOX/Index" class="externalLink" title="Wiki">Wiki</a>
- | <span id="publishDate">Last Published: 2013-10-09</span>
+ | <span id="publishDate">Last Published: 2013-10-28</span>
| <span id="projectVersion">Version: 0.0.0-SNAPSHOT</span>
</div>
<div class="clear">
@@ -83,16 +83,10 @@
<h5>Documentation</h5>
<ul>
<li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Getting+Started" class="externalLink" title="Getting Started">Getting Started</a>
+ <a href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html" class="externalLink" title="User's Guide">User's Guide</a>
</li>
<li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Examples" class="externalLink" title="Usage Examples">Usage Examples</a>
- </li>
- <li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Client+Usage" class="externalLink" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
- </li>
- <li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Sandbox+Configuration" class="externalLink" title="Sandbox Configuration">Sandbox Configuration</a>
+ <a href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html#Getting+Started" class="externalLink" title="Getting Started">Getting Started</a>
</li>
<li class="none">
<a href="https://cwiki.apache.org/confluence/display/KNOX/Dependencies" class="externalLink" title="Dependencies">Dependencies</a>
@@ -104,6 +98,9 @@
<h5>Releases</h5>
<ul>
<li class="none">
+ <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.3.0" class="externalLink" title="0.3.0">0.3.0</a>
+ </li>
+ <li class="none">
<a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.2.0" class="externalLink" title="0.2.0">0.2.0</a>
</li>
<li class="none">
Modified: incubator/knox/site/team-list.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/team-list.html?rev=1536345&r1=1536344&r2=1536345&view=diff
==============================================================================
--- incubator/knox/site/team-list.html (original)
+++ incubator/knox/site/team-list.html Mon Oct 28 13:03:09 2013
@@ -1,5 +1,5 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 9, 2013 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Oct 28, 2013 -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
@import url("./css/site.css");
</style>
<link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
- <meta name="Date-Revision-yyyymmdd" content="20131009" />
+ <meta name="Date-Revision-yyyymmdd" content="20131028" />
<meta http-equiv="Content-Language" content="en" />
<script type="text/javascript">var _gaq = _gaq || [];
@@ -57,7 +57,7 @@
<a href="https://cwiki.apache.org/confluence/display/KNOX/Index" class="externalLink" title="Wiki">Wiki</a>
- | <span id="publishDate">Last Published: 2013-10-09</span>
+ | <span id="publishDate">Last Published: 2013-10-28</span>
| <span id="projectVersion">Version: 0.0.0-SNAPSHOT</span>
</div>
<div class="clear">
@@ -83,16 +83,10 @@
<h5>Documentation</h5>
<ul>
<li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Getting+Started" class="externalLink" title="Getting Started">Getting Started</a>
+ <a href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html" class="externalLink" title="User's Guide">User's Guide</a>
</li>
<li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Examples" class="externalLink" title="Usage Examples">Usage Examples</a>
- </li>
- <li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Client+Usage" class="externalLink" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
- </li>
- <li class="none">
- <a href="https://cwiki.apache.org/confluence/display/KNOX/Sandbox+Configuration" class="externalLink" title="Sandbox Configuration">Sandbox Configuration</a>
+ <a href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html#Getting+Started" class="externalLink" title="Getting Started">Getting Started</a>
</li>
<li class="none">
<a href="https://cwiki.apache.org/confluence/display/KNOX/Dependencies" class="externalLink" title="Dependencies">Dependencies</a>
@@ -104,6 +98,9 @@
<h5>Releases</h5>
<ul>
<li class="none">
+ <a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.3.0" class="externalLink" title="0.3.0">0.3.0</a>
+ </li>
+ <li class="none">
<a href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.2.0" class="externalLink" title="0.2.0">0.2.0</a>
</li>
<li class="none">
Modified: incubator/knox/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/incubator/knox/trunk/src/site/site.xml?rev=1536345&r1=1536344&r2=1536345&view=diff
==============================================================================
--- incubator/knox/trunk/src/site/site.xml (original)
+++ incubator/knox/trunk/src/site/site.xml Mon Oct 28 13:03:09 2013
@@ -92,14 +92,9 @@
</menu>
<menu name="Documentation">
+ <item name="User's Guide" href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html"/>
<!-- item name="Getting Started" href="https://cwiki.apache.org/KNOX/getting-started.html"/ -->
- <item name="Getting Started" href="https://cwiki.apache.org/confluence/display/KNOX/Getting+Started"/>
- <!--item name="Usage Examples" href="https://cwiki.apache.org/KNOX/examples.html"/ -->
- <item name="Usage Examples" href="https://cwiki.apache.org/confluence/display/KNOX/Examples"/>
- <!-- item name="Client (KnoxShell DSL)" href="https://cwiki.apache.org/KNOX/client-usage.html"/ -->
- <item name="Client (KnoxShell DSL)" href="https://cwiki.apache.org/confluence/display/KNOX/Client+Usage"/>
- <!-- item name="Sandbox Configuration" href="https://cwiki.apache.org/KNOX/sandbox-configuration.html"/ -->
- <item name="Sandbox Configuration" href="https://cwiki.apache.org/confluence/display/KNOX/Sandbox+Configuration"/>
+ <item name="Getting Started" href="http://knox.incubator.apache.org/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html#Getting+Started"/>
<!-- item name="Dependencies" href="https://cwiki.apache.org/KNOX/dependencies.html"/ -->
<item name="Dependencies" href="https://cwiki.apache.org/confluence/display/KNOX/Dependencies"/>
<!-- item name="Wiki" href="https://cwiki.apache.org/confluence/display/KNOX/Index"/ -->
@@ -107,6 +102,7 @@
</menu>
<menu name="Releases">
+ <item name="0.3.0" href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.3.0"/>
<!-- item name="0.2.0" href="https://cwiki.apache.org/KNOX/release-020.html"/ -->
<item name="0.2.0" href="https://cwiki.apache.org/confluence/display/KNOX/Release+0.2.0"/>
<!-- item name="Roadmap" href="https://cwiki.apache.org/KNOX/roadmap.html"/ -->