knox-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From kmin...@apache.org
Subject svn commit: r1459057 - /incubator/knox/site/
Date Wed, 20 Mar 2013 21:11:26 GMT
Author: kminder
Date: Wed Mar 20 21:11:26 2013
New Revision: 1459057

URL: http://svn.apache.org/r1459057
Log:
Publish site from Git repository.

Added:
    incubator/knox/site/sandbox.html
Modified:
    incubator/knox/site/build-process.html
    incubator/knox/site/client.html
    incubator/knox/site/contribute-process.html
    incubator/knox/site/examples.html
    incubator/knox/site/getting-started.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/news.html
    incubator/knox/site/privacy-policy.html
    incubator/knox/site/project-info.html
    incubator/knox/site/project-reports.html
    incubator/knox/site/rat-report.html
    incubator/knox/site/release-0-2-0.html
    incubator/knox/site/release-process.html
    incubator/knox/site/roadmap-0-3-0.html
    incubator/knox/site/site-process.html
    incubator/knox/site/team-list.html
    incubator/knox/site/template.html

Modified: incubator/knox/site/build-process.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/build-process.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/build-process.html (original)
+++ incubator/knox/site/build-process.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/client.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/client.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/client.html (original)
+++ incubator/knox/site/client.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
             <strong>Client (KnoxShell DSL)</strong>
           </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>
@@ -547,7 +550,7 @@ groovy -cp bin/shell-0.2.0-SNAPSHOT.jar 
 </pre></div><p>The interactive shell isnt exactly equivalent. However the only difference is that the shell-0.2.0-SNAPSHOT.jar automatically executes some additional imports that are useful for the KnoxShell DSL. So these two sets of commands should be functionality equivalent. <b><i>However there is currently a class loading issue that prevents the groovysh command from working propertly.</i></b></p>
 <div class="source"><pre>java -jar bin/shell-0.2.0-SNAPSHOT.jar
 
-groovysh -cp bin/shell-0.2.0-SNAPSHOT.jar # BROKEN, CLASS LOADING ISSUE
+groovysh -cp bin/shell-0.2.0-SNAPSHOT.jar
 import org.apache.hadoop.gateway.shell.Hadoop
 import org.apache.hadoop.gateway.shell.hdfs.Hdfs
 import org.apache.hadoop.gateway.shell.job.Job

Modified: incubator/knox/site/contribute-process.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/contribute-process.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/contribute-process.html (original)
+++ incubator/knox/site/contribute-process.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/examples.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/examples.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/examples.html (original)
+++ incubator/knox/site/examples.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>
@@ -158,7 +161,151 @@ Unless required by applicable law or agr
 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. --><p></p><div class="section"><h2>Example #3: WebHDFS &amp; Templeton/WebHCat<a name="Example_3:_WebHDFS__TempletonWebHCat"></a></h2><p>The example below illustrates the sequence of curl commands that could be used to run a word count map reduce job. It utilizes the hadoop-examples.jar from a Hadoop install for running a simple word count job. Take care to follow the instructions below for steps 4/5 and 6/7 where the Location header returned by the call to the NameNode is copied for use with the call to the DataNode that follows it.</p>
+limitations under the License. --><p></p><div class="section"><h2>Apache Knox Gateway - Usage Examples<a name="Apache_Knox_Gateway_-_Usage_Examples"></a></h2><p>This guide provides detailed examples for how to do some basic interactions with Hadoop via the Apache Knox Gateway.</p><p>The first two examples submit a Java MapReduce job and workflow using the KnoxShell DSL</p>
+<ul>
+  <li>Example #1: WebHDFS &amp; Templeton/WebHCat via KnoxShell DSL</li>
+  <li>Example #2: WebHDFS &amp; Oozie via KnoxShell DSL</li>
+</ul><p>The second two examples submit the same job and workflow but do so using only the <a class="externalLink" href="http://curl.haxx.se/">cURL</a> command line HTTP client.</p>
+<ul>
+  <li>Example #1: WebHDFS &amp; Templeton/WebHCat via cURL</li>
+  <li>Example #2: WebHDFS &amp; Oozie via KnoxShell cURL</li>
+</ul><p></p></div><div class="section"><h2>Assumptions<a name="Assumptions"></a></h2><p>This document assumes a few things about your environment in order to simplify the examples.</p>
+<ol style="list-style-type: decimal">
+  <li>The JVM is executable as simply java.</li>
+  <li>The Apache Knox Gateway is installed and functional.</li>
+  <li>The example commands are executed within the context of the GATEWAY_HOME  current directory. The GATEWAY_HOME directory is the directory within the  Apache Knox Gateway installation that contains the README file and the bin,  conf and deployments directories.</li>
+  <li>A few examples optionally require the use of commands from a standard  Groovy installation. These examples are optional but to try them you will  need Groovy <a class="externalLink" href="http://groovy.codehaus.org/Installing+Groovy">installed</a>.</li>
+</ol><p></p></div><div class="section"><h2>Customization<a name="Customization"></a></h2><p>These examples may need to be tailored to the execution environment. In particular hostnames and ports may need to be changes to match your environment. In particular there are two example files in the distribution that may need to be customized. Take a moment to review these files. All of the values that may need to be customized can be found together at the top of each file.</p>
+<ul>
+  <li>samples/ExampleSubmitJob.groovy</li>
+  <li>samples/ExampleSubmitWorkflow.groovy</li>
+</ul><p>If you are using the Sandbox VM for your Hadoop cluster you may want to review <a href="sandbox.html">these configuration tips</a>.</p><p></p></div><div class="section"><h2>Example #1: WebHDFS &amp; Templeton/WebHCat via KnoxShell DSL<a name="Example_1:_WebHDFS__TempletonWebHCat_via_KnoxShell_DSL"></a></h2><p>This example will submit the familiar WordCount Java MapReduce job to the Hadoop cluster via the gateway using the KnoxShell DSL. There are several ways to do this depending upon your preference.</p><p>You can use the embedded Groovy interpreter provided with the distribution.</p>
+<div class="source"><pre>java -jar bin/shell-0.2.0-SNAPSHOT.jar samples/ExampleSubmitJob.groovy
+</pre></div><p>You can load the KnoxShell DSL script into the standard Groovy Console.</p>
+<div class="source"><pre>groovyConsole -cp bin/shell-0.2.0-SNAPSHOT.jar samples/ExampleSubmitJob.groovy
+</pre></div><p>You can manually type in the KnoxShell DSL script into the embedded Groovy interpreter provided with the distribution.</p>
+<div class="source"><pre>java -jar bin/shell-0.2.0-SNAPSHOT.jar
+</pre></div><p>Each line from the file below will need to be typed or copied into the interactive shell.</p><p><b><i>samples/ExampleSubmitJob</i></b></p>
+<div class="source"><pre>import com.jayway.jsonpath.JsonPath
+import org.apache.hadoop.gateway.shell.Hadoop
+import org.apache.hadoop.gateway.shell.hdfs.Hdfs
+import org.apache.hadoop.gateway.shell.job.Job
+
+import static java.util.concurrent.TimeUnit.SECONDS
+
+gateway = &quot;https://localhost:8443/gateway/sample&quot;
+username = &quot;mapred&quot;
+password = &quot;mapred-password&quot;
+dataFile = &quot;LICENSE&quot;
+jarFile = &quot;samples/hadoop-examples.jar&quot;
+
+hadoop = Hadoop.login( gateway, username, password )
+
+println &quot;Delete /tmp/test &quot; + Hdfs.rm(hadoop).file( &quot;/tmp/test&quot; ).recursive().now().statusCode
+println &quot;Create /tmp/test &quot; + Hdfs.mkdir(hadoop).dir( &quot;/tmp/test&quot;).now().statusCode
+
+putData = Hdfs.put(hadoop).file( dataFile ).to( &quot;/tmp/test/input/FILE&quot; ).later() {
+  println &quot;Put /tmp/test/input/FILE &quot; + it.statusCode }
+putJar = Hdfs.put(hadoop).file( jarFile ).to( &quot;/tmp/test/hadoop-examples.jar&quot; ).later() {
+  println &quot;Put /tmp/test/hadoop-examples.jar &quot; + it.statusCode }
+hadoop.waitFor( putData, putJar )
+
+jobId = Job.submitJava(hadoop) \
+  .jar( &quot;/tmp/test/hadoop-examples.jar&quot; ) \
+  .app( &quot;wordcount&quot; ) \
+  .input( &quot;/tmp/test/input&quot; ) \
+  .output( &quot;/tmp/test/output&quot; ) \
+  .now().jobId
+println &quot;Submitted job &quot; + jobId
+
+done = false
+count = 0
+while( !done &amp;&amp; count++ &lt; 60 ) {
+  sleep( 1000 )
+  json = Job.queryStatus(hadoop).jobId(jobId).now().string
+  done = JsonPath.read( json, &quot;.status&quot; )
+}
+println &quot;Done &quot; + done
+
+println &quot;Shutdown &quot; + hadoop.shutdown( 10, SECONDS )
+</pre></div><p></p></div><div class="section"><h2>Example #2: WebHDFS &amp; Oozie via KnoxShell DSL<a name="Example_2:_WebHDFS__Oozie_via_KnoxShell_DSL"></a></h2><p>This example will also submit the familiar WordCount Java MapReduce job to the Hadoop cluster via the gateway using the KnoxShell DSL. However in this case the job will be submitted via a Oozie workflow. There are several ways to do this depending upon your preference.</p><p>You can use the embedded Groovy interpreter provided with the distribution.  java -jar bin/shell-0.2.0-SNAPSHOT.jar samples/ExampleSubmitWorkflow.groovy</p><p>You can load the KnoxShell DSL script into the standard Groovy Console.  groovyConsole -cp bin/shell-0.2.0-SNAPSHOT.jar samples/ExampleSubmitWorkflow.groovy</p><p>You can manually type in the KnoxShell DSL script into the embedded Groovy interpreter provided with the distribution.</p>
+<div class="source"><pre>java -jar bin/shell-0.2.0-SNAPSHOT.jar
+</pre></div><p>Each line from the file below will need to be typed or copied into the interactive shell.</p><p><b><i>samples/ExampleSubmitWorkflow.groovy</i></b></p>
+<div class="source"><pre>import com.jayway.jsonpath.JsonPath
+import org.apache.hadoop.gateway.shell.Hadoop
+import org.apache.hadoop.gateway.shell.hdfs.Hdfs
+import org.apache.hadoop.gateway.shell.workflow.Workflow
+
+import static java.util.concurrent.TimeUnit.SECONDS
+
+gateway = &quot;https://localhost:8443/gateway/sample&quot;
+jobTracker = &quot;sandbox:50300&quot;;
+nameNode = &quot;sandbox:8020&quot;;
+username = &quot;mapred&quot;
+password = &quot;mapred-password&quot;
+inputFile = &quot;LICENSE&quot;
+jarFile = &quot;samples/hadoop-examples.jar&quot;
+
+definition = &quot;&quot;&quot;\
+&lt;workflow-app xmlns=&quot;uri:oozie:workflow:0.2&quot; name=&quot;wordcount-workflow&quot;&gt;
+    &lt;start to=&quot;root-node&quot;/&gt;
+    &lt;action name=&quot;root-node&quot;&gt;
+        &lt;java&gt;
+            &lt;job-tracker&gt;$jobTracker&lt;/job-tracker&gt;
+            &lt;name-node&gt;hdfs://$nameNode&lt;/name-node&gt;
+            &lt;main-class&gt;org.apache.hadoop.examples.WordCount&lt;/main-class&gt;
+            &lt;arg&gt;/tmp/test/input&lt;/arg&gt;
+            &lt;arg&gt;/tmp/test/output&lt;/arg&gt;
+        &lt;/java&gt;
+        &lt;ok to=&quot;end&quot;/&gt;
+        &lt;error to=&quot;fail&quot;/&gt;
+    &lt;/action&gt;
+    &lt;kill name=&quot;fail&quot;&gt;
+        &lt;message&gt;Java failed&lt;/message&gt;
+    &lt;/kill&gt;
+    &lt;end name=&quot;end&quot;/&gt;
+&lt;/workflow-app&gt;
+&quot;&quot;&quot;
+
+configuration = &quot;&quot;&quot;\
+&lt;configuration&gt;
+    &lt;property&gt;
+        &lt;name&gt;user.name&lt;/name&gt;
+        &lt;value&gt;$username&lt;/value&gt;
+    &lt;/property&gt;
+    &lt;property&gt;
+        &lt;name&gt;oozie.wf.application.path&lt;/name&gt;
+        &lt;value&gt;hdfs://$nameNode/tmp/test&lt;/value&gt;
+    &lt;/property&gt;
+&lt;/configuration&gt;
+&quot;&quot;&quot;
+
+hadoop = Hadoop.login( gateway, username, password )
+
+println &quot;Delete /tmp/test &quot; + Hdfs.rm(hadoop).file( &quot;/tmp/test&quot; ).recursive().now().statusCode
+println &quot;Mkdir /tmp/test &quot; + Hdfs.mkdir(hadoop).dir( &quot;/tmp/test&quot;).now().statusCode
+putWorkflow = Hdfs.put(hadoop).text( definition ).to( &quot;/tmp/test/workflow.xml&quot; ).later() {
+  println &quot;Put /tmp/test/workflow.xml &quot; + it.statusCode }
+putData = Hdfs.put(hadoop).file( inputFile ).to( &quot;/tmp/test/input/FILE&quot; ).later() {
+  println &quot;Put /tmp/test/input/FILE &quot; + it.statusCode }
+putJar = Hdfs.put(hadoop).file( jarFile ).to( &quot;/tmp/test/lib/hadoop-examples.jar&quot; ).later() {
+  println &quot;Put /tmp/test/lib/hadoop-examples.jar &quot; + it.statusCode }
+hadoop.waitFor( putWorkflow, putData, putJar )
+
+jobId = Workflow.submit(hadoop).text( configuration ).now().jobId
+println &quot;Submitted job &quot; + jobId
+
+status = &quot;UNKNOWN&quot;;
+count = 0;
+while( status != &quot;SUCCEEDED&quot; &amp;&amp; count++ &lt; 60 ) {
+  sleep( 1000 )
+  json = Workflow.status(hadoop).jobId( jobId ).now().string
+  status = JsonPath.read( json, &quot;.status&quot; )
+}
+println &quot;Job status &quot; + status;
+
+println &quot;Shutdown &quot; + hadoop.shutdown( 10, SECONDS )
+</pre></div><p></p></div><div class="section"><h2>Example #3: WebHDFS &amp; Templeton/WebHCat via cURL<a name="Example_3:_WebHDFS__TempletonWebHCat_via_cURL"></a></h2><p>The example below illustrates the sequence of curl commands that could be used to run a word count map reduce job. It utilizes the hadoop-examples.jar from a Hadoop install for running a simple word count job. Take care to follow the instructions below for steps 4/5 and 6/7 where the Location header returned by the call to the NameNode is copied for use with the call to the DataNode that follows it.</p>
 <div class="source"><pre># 0. Optionally cleanup the test directory in case a previous example was run without cleaning up.
 curl -i -k -u mapred:mapred-password -X DELETE \
   'https://localhost:8443/gateway/sample/namenode/api/v1/tmp/test?op=DELETE&amp;recursive=true'
@@ -207,7 +354,7 @@ curl -i -k -u mapred:mapred-password -X 
 # 11. Optionally cleanup the test directory
 curl -i -k -u mapred:mapred-password -X DELETE \
   'https://localhost:8443/gateway/sample/namenode/api/v1/tmp/test?op=DELETE&amp;recursive=true'
-</pre></div><p></p></div><div class="section"><h2>Example #4: WebHDFS &amp; Oozie<a name="Example_4:_WebHDFS__Oozie"></a></h2><p>The example below illustrates the sequence of curl commands that could be used to run a word count map reduce job via an Oozie workflow. It utilizes the hadoop-examples.jar from a Hadoop install for running a simple word count job. Take care to follow the instructions below where replacement values are required. These replacement values are identivied with { } markup.</p>
+</pre></div><p></p></div><div class="section"><h2>Example #4: WebHDFS &amp; Oozie via cURL<a name="Example_4:_WebHDFS__Oozie_via_cURL"></a></h2><p>The example below illustrates the sequence of curl commands that could be used to run a word count map reduce job via an Oozie workflow. It utilizes the hadoop-examples.jar from a Hadoop install for running a simple word count job. Take care to follow the instructions below where replacement values are required. These replacement values are identivied with { } markup.</p>
 <div class="source"><pre># 0. Optionally cleanup the test directory in case a previous example was run without cleaning up.
 curl -i -k -u mapred:mapred-password -X DELETE \
   'https://localhost:8443/gateway/sample/namenode/api/v1/tmp/test?op=DELETE&amp;recursive=true'

Modified: incubator/knox/site/getting-started.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/getting-started.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/getting-started.html (original)
+++ incubator/knox/site/getting-started.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>
@@ -158,7 +161,7 @@ Unless required by applicable law or agr
 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. --><p></p><div class="section"><h2>Getting Started<a name="Getting_Started"></a></h2><p>This guide describes the steps required to install, deploy and validate the Apache Knox Gateway.</p><p></p></div><div class="section"><h2>Requirements<a name="Requirements"></a></h2><p>The following prerequisites must be installed to successfully complete the steps described in this guide.</p><div class="section"><h3>Java<a name="Java"></a></h3><p>Java 1.6 or later</p></div><div class="section"><h3>Hadoop<a name="Hadoop"></a></h3><p>A local installation of a Hadoop Cluster is required at this time. Hadoop EC2 cluster and/or Sandbox installations are currently difficult to access remotely via the Gateway. The EC2 and Sandbox limitation is caused by Hadoop services running with internal IP addresses. For the Gateway to work in these cases it will need to be deployed on the EC2 cluster or Sandbox, at this time.</p><p>The instructions that follow assume that the
  Gateway is <i>not</i> collocated with the Hadoop clusters themselves and (most importantly) that the hostnames and IP addresses of the cluster services are accessible by the gateway where ever it happens to be running.</p><p>The Hadoop cluster should be ensured to have WebHDFS, WebHCat (i.e. Templeton) and Oozie configured, deployed and running.</p><p></p></div></div><div class="section"><h2>Installation<a name="Installation"></a></h2><div class="section"><h3>1. Extract the distribution ZIP<a name="a1._Extract_the_distribution_ZIP"></a></h3><p>Download and extract the gateway-0.2.0-SNAPSHOT.zip file into the installation directory that will contain your <tt>{GATEWAY_HOME}</tt></p>
+limitations under the License. --><p></p><div class="section"><h2>Apache Knox Gateway - Getting Started<a name="Apache_Knox_Gateway_-_Getting_Started"></a></h2><p>This guide describes the steps required to install, deploy and validate the Apache Knox Gateway.</p><p></p></div><div class="section"><h2>Requirements<a name="Requirements"></a></h2><p>The following prerequisites must be installed to successfully complete the steps described in this guide.</p><div class="section"><h3>Java<a name="Java"></a></h3><p>Java 1.6 or later</p></div><div class="section"><h3>Hadoop<a name="Hadoop"></a></h3><p>A local installation of a Hadoop Cluster is required at this time. Hadoop EC2 cluster and/or Sandbox installations are currently difficult to access remotely via the Gateway. The EC2 and Sandbox limitation is caused by Hadoop services running with internal IP addresses. For the Gateway to work in these cases it will need to be deployed on the EC2 cluster or Sandbox, at this time.</p><p>
 The instructions that follow assume that the Gateway is <i>not</i> collocated with the Hadoop clusters themselves and (most importantly) that the hostnames and IP addresses of the cluster services are accessible by the gateway where ever it happens to be running.</p><p>The Hadoop cluster should be ensured to have WebHDFS, WebHCat (i.e. Templeton) and Oozie configured, deployed and running.</p><p>This release of the Apache Knox Gateway has been tested against the <a class="externalLink" href="http://hortonworks.com/products/hortonworks-sandbox/">Hortonworks Sandbox 1.2</a> with <a href="sandbox.html">these changes</a>.</p><p></p></div></div><div class="section"><h2>Installation<a name="Installation"></a></h2><div class="section"><h3>1. Extract the distribution ZIP<a name="a1._Extract_the_distribution_ZIP"></a></h3><p>Download and extract the gateway-0.2.0-SNAPSHOT.zip file into the installation directory that will contain your <tt>{GATEWAY_HOME}</tt></p>
 <div class="source"><pre>jar xf gateway-0.2.0-SNAPSHOT.zip
 </pre></div><p>This will create a directory <tt>gateway-0.2.0-SNAPSHOT</tt> in your current directory.</p></div><div class="section"><h3>2. Enter the <tt>{GATEWAY_HOME}</tt> directory<a name="a2._Enter_the_GATEWAY_HOME_directory"></a></h3>
 <div class="source"><pre>cd gateway-0.2.0-SNAPSHOT

Modified: incubator/knox/site/index.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/index.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/index.html (original)
+++ incubator/knox/site/index.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/issue-tracking.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/issue-tracking.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/issue-tracking.html (original)
+++ incubator/knox/site/issue-tracking.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/license.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/license.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/license.html (original)
+++ incubator/knox/site/license.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/mail-lists.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/mail-lists.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/mail-lists.html (original)
+++ incubator/knox/site/mail-lists.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/news.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/news.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/news.html (original)
+++ incubator/knox/site/news.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/privacy-policy.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/privacy-policy.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/privacy-policy.html (original)
+++ incubator/knox/site/privacy-policy.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/project-info.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/project-info.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/project-info.html (original)
+++ incubator/knox/site/project-info.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/project-reports.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/project-reports.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/project-reports.html (original)
+++ incubator/knox/site/project-reports.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/rat-report.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/rat-report.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/rat-report.html (original)
+++ incubator/knox/site/rat-report.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>
@@ -148,13 +151,13 @@
 *****************************************************
 Summary
 -------
-Generated at: 2013-03-20T12:03:03-04:00
+Generated at: 2013-03-20T17:11:18-04:00
 Notes: 0
 Binaries: 2
 Archives: 0
-Standards: 15
+Standards: 16
 
-Apache Licensed: 15
+Apache Licensed: 16
 Generated Documents: 0
 
 JavaDocs are generated and so license header is optional
@@ -188,6 +191,7 @@ Archives:
   AL    src/site/markdown/release-0-2-0.md
   AL    src/site/markdown/release-process.md
   AL    src/site/markdown/roadmap-0-3-0.md
+  AL    src/site/markdown/sandbox.md
   AL    src/site/markdown/site-process.md
   AL    src/site/markdown/template.md
   B     src/site/resources/images/apache-incubator-logo.png

Modified: incubator/knox/site/release-0-2-0.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/release-0-2-0.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/release-0-2-0.html (original)
+++ incubator/knox/site/release-0-2-0.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/release-process.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/release-process.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/release-process.html (original)
+++ incubator/knox/site/release-process.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/roadmap-0-3-0.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/roadmap-0-3-0.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/roadmap-0-3-0.html (original)
+++ incubator/knox/site/roadmap-0-3-0.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Added: incubator/knox/site/sandbox.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/sandbox.html?rev=1459057&view=auto
==============================================================================
--- incubator/knox/site/sandbox.html (added)
+++ incubator/knox/site/sandbox.html Wed Mar 20 21:11:26 2013
@@ -0,0 +1,193 @@
+<!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 at Mar 20, 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" />
+    <title></title>
+    <style type="text/css" media="all">
+      @import url("./css/maven-base.css");
+      @import url("./css/maven-theme.css");
+      @import url("./css/site.css");
+    </style>
+    <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+    <meta name="Date-Revision-yyyymmdd" content="20130320" />
+    <meta http-equiv="Content-Language" content="en" />
+                  
+        </head>
+  <body class="composite">
+    <div id="banner">
+                                      <a href="./" id="bannerLeft">
+                                                <img src="images/apache-logo.gif" alt="Knox Gateway" />
+                </a>
+                                            <a href=".." id="bannerRight">
+                                                <img src="images/apache-incubator-logo.png" alt="Apache Incubator" />
+                </a>
+            <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+            
+                
+                <div class="xleft">
+                                  <a href="index.html" title="Knox">Knox</a>
+        &gt;
+    
+      </div>
+            <div class="xright">                    <a href="https://git-wip-us.apache.org/repos/asf/incubator-knox.git" class="externalLink" title="Git">Git</a>
+            |
+                        <a href="https://svn.apache.org/repos/asf/incubator/knox/site" class="externalLink" title="Svn">Svn</a>
+            |
+                        <a href="https://issues.apache.org/jira/browse/KNOX" class="externalLink" title="Jira">Jira</a>
+            |
+                        <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
+              
+                
+                &nbsp;| <span id="publishDate">Last Published: 2013-03-20</span>
+              &nbsp;| <span id="projectVersion">Version: 0.2.0-SNAPSHOT</span>
+            </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+             
+                
+                                <h5>Knox</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="index.html" title="Welcome">Welcome</a>
+            </li>
+                  <li class="none">
+                          <a href="news.html" title="News">News</a>
+            </li>
+                  <li class="none">
+                          <a href="license.html" title="License">License</a>
+            </li>
+          </ul>
+                       <h5>Documentation</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="getting-started.html" title="Getting Started">Getting Started</a>
+            </li>
+                  <li class="none">
+                          <a href="examples.html" title="Usage Examples">Usage Examples</a>
+            </li>
+                  <li class="none">
+                          <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
+            </li>
+                  <li class="none">
+            <strong>Sandbox Configuration</strong>
+          </li>
+                  <li class="none">
+                          <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
+            </li>
+          </ul>
+                       <h5>Releases</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="release-0-2-0.html" title="0.2.0 (coming soon)">0.2.0 (coming soon)</a>
+            </li>
+                  <li class="none">
+                          <a href="roadmap-0-3-0.html" title="0.3.0 (planning)">0.3.0 (planning)</a>
+            </li>
+          </ul>
+                       <h5>Processes</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="build-process.html" title="Build">Build</a>
+            </li>
+                  <li class="none">
+                          <a href="release-process.html" title="Release">Release</a>
+            </li>
+                  <li class="none">
+                          <a href="contribute-process.html" title="Contribute">Contribute</a>
+            </li>
+                  <li class="none">
+                          <a href="site-process.html" title="Site Publication">Site Publication</a>
+            </li>
+          </ul>
+                       <h5>Resources</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="https://git-wip-us.apache.org/repos/asf/incubator-knox.git" class="externalLink" title="Source Code">Source Code</a>
+            </li>
+                  <li class="none">
+                          <a href="team-list.html" title="Project Team">Project Team</a>
+            </li>
+                  <li class="none">
+                          <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+            </li>
+                  <li class="none">
+                          <a href="issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+            </li>
+          </ul>
+                       <h5>ASF</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">How Apache Works</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation">Foundation</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">Sponsoring Apache</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+            </li>
+          </ul>
+                             <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+      </a>
+                   
+                
+            </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+        <!-- -
+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. --><p></p><div class="section"><h2>Sandbox Configuration<a name="Sandbox_Configuration"></a></h2><p>This version of the Apache Knox Gateway is tested against <a class="externalLink" href="http://hortonworks.com/products/hortonworks-sandbox/">Hortonworks Sandbox 1.2</a></p><p>In order to correct the issue with Sandbox you can use the commands below to login to the Sandbox VM and modify the configuration. This assumes that the name sandbox is setup to resolve to the Sandbox VM. It may be necessary to use the IP address of the Sandbox VM instead. ***This is frequently but not always 192.168.56.101.***</p>
+<div class="source"><pre>ssh root@sandbox
+cat /usr/lib/hadoop/conf/hdfs-site.xml | sed s/localhost/sandbox/ &gt; /usr/lib/hadoop/conf/hdfs-site.xml
+shutdown -r now
+</pre></div><p>In addition to make it very easy to follow along with the samples for the gateway you can configure your local system to resolve the address of the Sandbox by the names <tt>vm</tt> and <tt>sandbox</tt>.</p><p>On Linux or Macintosh systems add a line like this to the end of the <tt>/etc/hosts file on</tt> your local machine, <b><i>not the Sandbox VM</i></b>. <i>Note: That is a <i>tab</i> character between the 192.168.56.101 and the vm.</i></p>
+<div class="source"><pre>192.168.56.101  vm sandbox
+</pre></div><p>On Windows systems a similar but different mechanism can be used. On recent versions of windows the file that should be modified is <tt>%systemroot%\system32\drivers\etc\hosts</tt></p><p></p></div><div class="section"><h2>Disclaimer<a name="Disclaimer"></a></h2><p>The Apache Knox Gateway is an effort undergoing incubation at the Apache Software Foundation (ASF), sponsored by the Apache Incubator PMC.</p><p>Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects.</p><p>While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.</p></div>
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xright">
+              <?xml version="1.0" encoding="UTF-8"?>
+<footer>
+  <div class="row span12">Apache Knox Gateway, Apache, the Apache feather logo and the Apache Knox Gateway project logos
+                are trademarks of The Apache Software Foundation.
+                All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
+  <div class="row span12">
+    <a href="privacy-policy.html">Privacy Policy</a>
+  </div>
+</footer>
+            </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+  </body>
+</html>

Modified: incubator/knox/site/site-process.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/site-process.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/site-process.html (original)
+++ incubator/knox/site/site-process.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/team-list.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/team-list.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/team-list.html (original)
+++ incubator/knox/site/team-list.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>

Modified: incubator/knox/site/template.html
URL: http://svn.apache.org/viewvc/incubator/knox/site/template.html?rev=1459057&r1=1459056&r2=1459057&view=diff
==============================================================================
--- incubator/knox/site/template.html (original)
+++ incubator/knox/site/template.html Wed Mar 20 21:11:26 2013
@@ -78,6 +78,9 @@
                           <a href="client.html" title="Client (KnoxShell DSL)">Client (KnoxShell DSL)</a>
             </li>
                   <li class="none">
+                          <a href="sandbox.html" title="Sandbox Configuration">Sandbox Configuration</a>
+            </li>
+                  <li class="none">
                           <a href="https://cwiki.apache.org/confluence/display/KNOX/Knox" class="externalLink" title="Wiki">Wiki</a>
             </li>
           </ul>



Mime
View raw message