knox-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From kmin...@apache.org
Subject 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
Date Thu, 03 Oct 2013 19:20:59 GMT
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
 



Mime
View raw message