svn commit: r1528980 - in /incubator/knox: site/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html trunk/books/0.3.0/book_getting-started.md trunk/books/0.3.0/book_troubleshooting.md

[km...@apache.org]

Author: kminder
Date: Thu Oct  3 19:20:58 2013
New Revision: 1528980

URL: http://svn.apache.org/r1528980
Log:
Change server.jar to gateway.jar.

Modified:
    incubator/knox/site/books/knox-incubating-0-3-0/knox-incubating-0-3-0.html
    incubator/knox/trunk/books/0.3.0/book_getting-started.md
    incubator/knox/trunk/books/0.3.0/book_troubleshooting.md

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=1528980&r1=1528979&r2=1528980&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 Thu Oct  3 19:20:58 2013
@@ -233,7 +233,7 @@
 </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 &ldquo;guest&rdquo; has been already included. Note that the passwords in this file are &ldquo;fictitious&rdquo; 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 &amp;
 </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>&amp;</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&rsquo;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/server.jar
+<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>
@@ -2311,7 +2311,7 @@ log4j.logger.org.apache.http.client=DEBU
 log4j.logger.org.apache.http.headers=DEBUG   # Use this logger to increase the debugging of Apache HTTP header.
 log4j.logger.org.apache.http.wire=DEBUG      # Use this logger to increase the debugging of Apache HTTP wire traffic.
 </code></pre><h3><a id="Filing+Bugs"></a>Filing Bugs</h3><p>Bugs can be filed using <a href="https://issues.apache.org/jira/browse/KNOX">Jira</a>. Please include the results of this command below in the Environment section. Also include the version of Hadoop being used in the same section.</p>
-<pre><code>java -jar bin/server.jar -version
+<pre><code>java -jar bin/gateway.jar -version
 </code></pre><h2><a id="Export+Controls"></a>Export Controls</h2><p>Apache Knox Gateway includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country&rsquo;s laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See <a href="http://www.wassenaar.org">http://www.wassenaar.org</a> for more information.</p><p>The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this Apache Software Foundation distribution makes it eligible for export under the License Exception ENC
  Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.</p><p>The following provides more details on the included cryptographic software:</p>
 <ul>
   <li>Apache Knox Gateway uses the ApacheDS which in turn uses Bouncy Castle generic encryption libraries.</li>

Modified: incubator/knox/trunk/books/0.3.0/book_getting-started.md
URL: http://svn.apache.org/viewvc/incubator/knox/trunk/books/0.3.0/book_getting-started.md?rev=1528980&r1=1528979&r2=1528980&view=diff
==============================================================================
--- incubator/knox/trunk/books/0.3.0/book_getting-started.md (original)
+++ incubator/knox/trunk/books/0.3.0/book_getting-started.md Thu Oct  3 19:20:58 2013
@@ -234,7 +234,7 @@ Both options are detailed below.
 This is the simplest way to start the gateway.
 Starting this way will result in all logging being written directly to standard output.
 
-    java -jar bin/server.jar
+    java -jar bin/gateway.jar
 
 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.

Modified: incubator/knox/trunk/books/0.3.0/book_troubleshooting.md
URL: http://svn.apache.org/viewvc/incubator/knox/trunk/books/0.3.0/book_troubleshooting.md?rev=1528980&r1=1528979&r2=1528980&view=diff
==============================================================================
--- incubator/knox/trunk/books/0.3.0/book_troubleshooting.md (original)
+++ incubator/knox/trunk/books/0.3.0/book_troubleshooting.md Thu Oct  3 19:20:58 2013
@@ -42,5 +42,5 @@ Bugs can be filed using [Jira][jira].
 Please include the results of this command below in the Environment section.
 Also include the version of Hadoop being used in the same section.
 
-    java -jar bin/server.jar -version
+    java -jar bin/gateway.jar -version