knox-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From lmc...@apache.org
Subject [2/2] knox git commit: KNOX-993 - The samples README for knoxshell references the 0.5.0 userguide
Date Mon, 14 Aug 2017 14:12:00 GMT
KNOX-993 - The samples README for knoxshell references the 0.5.0 userguide

Project: http://git-wip-us.apache.org/repos/asf/knox/repo
Commit: http://git-wip-us.apache.org/repos/asf/knox/commit/35e7173b
Tree: http://git-wip-us.apache.org/repos/asf/knox/tree/35e7173b
Diff: http://git-wip-us.apache.org/repos/asf/knox/diff/35e7173b

Branch: refs/heads/v0.13.0
Commit: 35e7173bb36ea65c1037d114d229ea1e409ef874
Parents: b9b0db2
Author: Larry McCay <lmccay@hortonworks.com>
Authored: Sat Aug 12 18:05:02 2017 -0400
Committer: Larry McCay <lmccay@hortonworks.com>
Committed: Mon Aug 14 10:11:36 2017 -0400

----------------------------------------------------------------------
 .../src/main/resources/samples/README           | 32 ++++++++++++++++++--
 1 file changed, 30 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/knox/blob/35e7173b/gateway-shell-samples/src/main/resources/samples/README
----------------------------------------------------------------------
diff --git a/gateway-shell-samples/src/main/resources/samples/README b/gateway-shell-samples/src/main/resources/samples/README
index 3e59836..e25466d 100644
--- a/gateway-shell-samples/src/main/resources/samples/README
+++ b/gateway-shell-samples/src/main/resources/samples/README
@@ -8,6 +8,34 @@ from the service components of a Hadoop cluster.
 Depending on exactly how your Knox installation was done, there will be some number of
 steps required in order fully install and configure the samples for use in your environment.
 
-Please see the following section within the Apache Knox Users Guide: 
+Please see the following section from the Apache Knox Users Guide: 
 
-http://knox.apache.org/books/knox-0-5-0/knox-0-5-0.html#Gateway+Samples
\ No newline at end of file
+Gateway Samples 
+
+The purpose of the samples within the {GATEWAY_HOME}/samples directory is to demonstrate
the capabilities
+of the Apache Knox Gateway to provide access to the numerous APIs that are available from
the service
+components of a Hadoop cluster.
+
+Depending on exactly how your Knox installation was done, there will be some number of steps
required in
+order fully install and configure the samples for use.
+
+This section will help describe the assumptions of the samples and the steps to get them
to work in a couple
+of different deployment scenarios.
+
+Assumptions of the Samples 
+
+The samples were initially written with the intent of working out of the box for the various
Hadoop demo
+environments that are deployed as a single node cluster inside of a VM. The following assumptions
were made
+from that context and should be understood in order to get the samples to work in other deployment
scenarios:
+
+* That there is a valid java JDK on the PATH for executing the samples
+* The Knox Demo LDAP server is running on localhost and port 33389 which is the default port
for the
+ApacheDS LDAP server.
+* That the LDAP directory in use has a set of demo users provisioned with the convention
of username
+and username“-password” as the password. Most of the samples have some variation of this
pattern with
+“guest” and “guest-password”.
+* That the Knox Gateway instance is running on the same machine which you will be running
the samples
+from - therefore “localhost” and that the default port of “8443” is being used.
+* Finally, that there is a properly provisioned sandbox.xml topology in the
+{GATEWAY_HOME}/conf/topologies directory that is configured to point to the actual host and
ports of
+running service components.


Mime
View raw message