hadoop-common-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From omal...@apache.org
Subject svn commit: r1077362 - in /hadoop/common/branches/branch-0.20-security-patches/src/docs/src/documentation/content/xdocs: commands_manual.xml hdfs_user_guide.xml
Date Fri, 04 Mar 2011 04:07:15 GMT
Author: omalley
Date: Fri Mar  4 04:07:15 2011
New Revision: 1077362

URL: http://svn.apache.org/viewvc?rev=1077362&view=rev
commit 31d5824cda798535ec23d1b897d8d642627b6782
Author: Boris Shkolnik <borya@yahoo-inc.com>
Date:   Thu Mar 25 10:22:55 2010 -0700

    HDFS:1036 from https://issues.apache.org/jira/secure/attachment/12438856/fetchdt_doc.patch
    +++ b/YAHOO-CHANGES.txt
    +    HDFS-1036. Documentation for fetchdt for forrest (boryas)


Modified: hadoop/common/branches/branch-0.20-security-patches/src/docs/src/documentation/content/xdocs/commands_manual.xml
URL: http://svn.apache.org/viewvc/hadoop/common/branches/branch-0.20-security-patches/src/docs/src/documentation/content/xdocs/commands_manual.xml?rev=1077362&r1=1077361&r2=1077362&view=diff
--- hadoop/common/branches/branch-0.20-security-patches/src/docs/src/documentation/content/xdocs/commands_manual.xml
+++ hadoop/common/branches/branch-0.20-security-patches/src/docs/src/documentation/content/xdocs/commands_manual.xml
Fri Mar  4 04:07:15 2011
@@ -56,8 +56,8 @@
 				<title>Generic Options</title>
 				  The following options are supported by <a href="commands_manual.html#dfsadmin">dfsadmin</a>,

-				  <a href="commands_manual.html#fs">fs</a>, <a href="commands_manual.html#fsck">fsck</a>
-				  <a href="commands_manual.html#job">job</a>. 
+				  <a href="commands_manual.html#fs">fs</a>, <a href="commands_manual.html#fsck">fsck</a>,

+				  <a href="commands_manual.html#job">job</a> and <a href="commands_manual.html#fetchdt">fetchdt</a>.

 				  Applications should implement 
 				  <a href="ext:api/org/apache/hadoop/util/tool">Tool</a> to support
 				  <a href="ext:api/org/apache/hadoop/util/genericoptionsparser">
@@ -211,6 +211,26 @@
+                <title> fetchdt </title>
+                <p>
+                    Gets Delegation Token from a NameNode. See <a href="hdfs_user_guide.html#fetchdt">fetchdt</a>
for more info.
+                </p> 
+                <p><code>Usage: hadoop fetchdt [</code><a href="commands_manual.html#Generic+Options">GENERIC_OPTIONS</a><code>]

+                [--webservice &lt;namenode_http_addr&gt;] &lt;path&gt; </code></p>
+                <table>
+                      <tr><th> COMMAND_OPTION </th><th> Description
+                      <tr>
+                        <td><code>&lt;fileName&gt;</code></td>
+                        <td>File name to store the token into.</td>
+                       </tr>
+                       <tr>
+                        <td><code>--webservice &lt;https_address&gt;</code></td>
+                        <td>use http protocol instead of RPC</td>
+                       </tr>
+                    </table>
+            </section>
+			<section>
 				<title> jar </title>
 					Runs a jar file. Users can bundle their Map Reduce code in a jar file and execute it
using this command.

Modified: hadoop/common/branches/branch-0.20-security-patches/src/docs/src/documentation/content/xdocs/hdfs_user_guide.xml
URL: http://svn.apache.org/viewvc/hadoop/common/branches/branch-0.20-security-patches/src/docs/src/documentation/content/xdocs/hdfs_user_guide.xml?rev=1077362&r1=1077361&r2=1077362&view=diff
--- hadoop/common/branches/branch-0.20-security-patches/src/docs/src/documentation/content/xdocs/hdfs_user_guide.xml
+++ hadoop/common/branches/branch-0.20-security-patches/src/docs/src/documentation/content/xdocs/hdfs_user_guide.xml
Fri Mar  4 04:07:15 2011
@@ -99,6 +99,10 @@
     		find missing files or blocks.
+            <code>fetchdt</code>: a utility to fetch DelegationToken and store
+            in a file on the local system. 
+        </li>
+    	<li>
     		Rebalancer: tool to balance the cluster when the data is
     		unevenly distributed among DataNodes.
@@ -371,6 +375,22 @@
       For command usage, see <a href="commands_manual.html#fsck"><code>fsck</code>
       <code>fsck</code> can be run on the whole file system or on a subset of
+   </section> <section> <title> fetchdt </title>
+     <p>    
+      HDFS supports the <code>fetchdt</code> command to fetch Delegation Token

+      and store it in a file on the local system. This token can be later used to 
+      access secure server (NameNode for example) from a non secure client.
+      Utility uses either RPC or HTTPS (over Kerberos) to get the token, and thus
+      requires kerberos tickets to be present before the run (run kinit to get 
+      the tickets). 
+      The HDFS <code>fetchdt</code> command is not a
+      Hadoop shell command. It can be run as '<code>bin/hadoop fetchdt DTfile </code>'.
+      After you got the token you can run an HDFS command without having Kerberos
+      tickets, by pointing HADOOP_TOKEN_FILE_LOCATION environmental variable to 
+      the delegation token file. 
+      For command usage, see <a href="commands_manual.html#fetchdt"><code>fetchdt</code>
+     </p>
    </section> <section> <title> Upgrade and Rollback </title>

View raw message