hdfs_user_guide.html 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <head>
  4. <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
  5. <meta content="Apache Forrest" name="Generator">
  6. <meta name="Forrest-version" content="0.8">
  7. <meta name="Forrest-skin-name" content="pelt">
  8. <title>
  9. Hadoop DFS User Guide
  10. </title>
  11. <link type="text/css" href="skin/basic.css" rel="stylesheet">
  12. <link media="screen" type="text/css" href="skin/screen.css" rel="stylesheet">
  13. <link media="print" type="text/css" href="skin/print.css" rel="stylesheet">
  14. <link type="text/css" href="skin/profile.css" rel="stylesheet">
  15. <script src="skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="skin/fontsize.js" language="javascript" type="text/javascript"></script>
  16. <link rel="shortcut icon" href="images/favicon.ico">
  17. </head>
  18. <body onload="init()">
  19. <script type="text/javascript">ndeSetTextSize();</script>
  20. <div id="top">
  21. <!--+
  22. |breadtrail
  23. +-->
  24. <div class="breadtrail">
  25. <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://hadoop.apache.org/">Hadoop</a> &gt; <a href="http://hadoop.apache.org/core/">Core</a><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
  26. </div>
  27. <!--+
  28. |header
  29. +-->
  30. <div class="header">
  31. <!--+
  32. |start group logo
  33. +-->
  34. <div class="grouplogo">
  35. <a href="http://hadoop.apache.org/"><img class="logoImage" alt="Hadoop" src="images/hadoop-logo.jpg" title="Apache Hadoop"></a>
  36. </div>
  37. <!--+
  38. |end group logo
  39. +-->
  40. <!--+
  41. |start Project Logo
  42. +-->
  43. <div class="projectlogo">
  44. <a href="http://hadoop.apache.org/core/"><img class="logoImage" alt="Hadoop" src="images/core-logo.gif" title="Scalable Computing Platform"></a>
  45. </div>
  46. <!--+
  47. |end Project Logo
  48. +-->
  49. <!--+
  50. |start Search
  51. +-->
  52. <div class="searchbox">
  53. <form action="http://www.google.com/search" method="get" class="roundtopsmall">
  54. <input value="hadoop.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp;
  55. <input name="Search" value="Search" type="submit">
  56. </form>
  57. </div>
  58. <!--+
  59. |end search
  60. +-->
  61. <!--+
  62. |start Tabs
  63. +-->
  64. <ul id="tabs">
  65. <li>
  66. <a class="unselected" href="http://hadoop.apache.org/core/">Project</a>
  67. </li>
  68. <li>
  69. <a class="unselected" href="http://wiki.apache.org/hadoop">Wiki</a>
  70. </li>
  71. <li class="current">
  72. <a class="selected" href="index.html">Hadoop 0.19 Documentation</a>
  73. </li>
  74. </ul>
  75. <!--+
  76. |end Tabs
  77. +-->
  78. </div>
  79. </div>
  80. <div id="main">
  81. <div id="publishedStrip">
  82. <!--+
  83. |start Subtabs
  84. +-->
  85. <div id="level2tabs"></div>
  86. <!--+
  87. |end Endtabs
  88. +-->
  89. <script type="text/javascript"><!--
  90. document.write("Last Published: " + document.lastModified);
  91. // --></script>
  92. </div>
  93. <!--+
  94. |breadtrail
  95. +-->
  96. <div class="breadtrail">
  97. &nbsp;
  98. </div>
  99. <!--+
  100. |start Menu, mainarea
  101. +-->
  102. <!--+
  103. |start Menu
  104. +-->
  105. <div id="menu">
  106. <div onclick="SwitchMenu('menu_selected_1.1', 'skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Documentation</div>
  107. <div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
  108. <div class="menuitem">
  109. <a href="index.html">Overview</a>
  110. </div>
  111. <div class="menuitem">
  112. <a href="quickstart.html">Quickstart</a>
  113. </div>
  114. <div class="menuitem">
  115. <a href="cluster_setup.html">Cluster Setup</a>
  116. </div>
  117. <div class="menuitem">
  118. <a href="hdfs_design.html">HDFS Architecture</a>
  119. </div>
  120. <div class="menupage">
  121. <div class="menupagetitle">HDFS User Guide</div>
  122. </div>
  123. <div class="menuitem">
  124. <a href="hdfs_permissions_guide.html">HDFS Permissions Guide</a>
  125. </div>
  126. <div class="menuitem">
  127. <a href="hdfs_quota_admin_guide.html">HDFS Quotas Administrator Guide</a>
  128. </div>
  129. <div class="menuitem">
  130. <a href="hdfs_shell.html">FS Shell Guide</a>
  131. </div>
  132. <div class="menuitem">
  133. <a href="distcp.html">DistCp Guide</a>
  134. </div>
  135. <div class="menuitem">
  136. <a href="mapred_tutorial.html">Map-Reduce Tutorial</a>
  137. </div>
  138. <div class="menuitem">
  139. <a href="native_libraries.html">Native Hadoop Libraries</a>
  140. </div>
  141. <div class="menuitem">
  142. <a href="streaming.html">Streaming</a>
  143. </div>
  144. <div class="menuitem">
  145. <a href="hadoop_archives.html">Hadoop Archives</a>
  146. </div>
  147. <div class="menuitem">
  148. <a href="hod.html">Hadoop On Demand</a>
  149. </div>
  150. <div class="menuitem">
  151. <a href="api/index.html">API Docs</a>
  152. </div>
  153. <div class="menuitem">
  154. <a href="http://wiki.apache.org/hadoop/">Wiki</a>
  155. </div>
  156. <div class="menuitem">
  157. <a href="http://wiki.apache.org/hadoop/FAQ">FAQ</a>
  158. </div>
  159. <div class="menuitem">
  160. <a href="http://hadoop.apache.org/core/mailing_lists.html">Mailing Lists</a>
  161. </div>
  162. <div class="menuitem">
  163. <a href="releasenotes.html">Release Notes</a>
  164. </div>
  165. <div class="menuitem">
  166. <a href="changes.html">All Changes</a>
  167. </div>
  168. </div>
  169. <div id="credit"></div>
  170. <div id="roundbottom">
  171. <img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
  172. <!--+
  173. |alternative credits
  174. +-->
  175. <div id="credit2"></div>
  176. </div>
  177. <!--+
  178. |end Menu
  179. +-->
  180. <!--+
  181. |start content
  182. +-->
  183. <div id="content">
  184. <div title="Portable Document Format" class="pdflink">
  185. <a class="dida" href="hdfs_user_guide.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
  186. PDF</a>
  187. </div>
  188. <h1>
  189. Hadoop DFS User Guide
  190. </h1>
  191. <div id="minitoc-area">
  192. <ul class="minitoc">
  193. <li>
  194. <a href="#Purpose">Purpose</a>
  195. </li>
  196. <li>
  197. <a href="#Overview"> Overview </a>
  198. </li>
  199. <li>
  200. <a href="#Pre-requisites"> Pre-requisites </a>
  201. </li>
  202. <li>
  203. <a href="#Web+Interface"> Web Interface </a>
  204. </li>
  205. <li>
  206. <a href="#Shell+Commands">Shell Commands</a>
  207. <ul class="minitoc">
  208. <li>
  209. <a href="#DFSAdmin+Command"> DFSAdmin Command </a>
  210. </li>
  211. </ul>
  212. </li>
  213. <li>
  214. <a href="#Secondary+Namenode"> Secondary Namenode </a>
  215. </li>
  216. <li>
  217. <a href="#Rebalancer"> Rebalancer </a>
  218. </li>
  219. <li>
  220. <a href="#Rack+Awareness"> Rack Awareness </a>
  221. </li>
  222. <li>
  223. <a href="#Safemode"> Safemode </a>
  224. </li>
  225. <li>
  226. <a href="#Fsck"> Fsck </a>
  227. </li>
  228. <li>
  229. <a href="#Upgrade+and+Rollback"> Upgrade and Rollback </a>
  230. </li>
  231. <li>
  232. <a href="#File+Permissions+and+Security"> File Permissions and Security </a>
  233. </li>
  234. <li>
  235. <a href="#Scalability"> Scalability </a>
  236. </li>
  237. <li>
  238. <a href="#Related+Documentation"> Related Documentation </a>
  239. </li>
  240. </ul>
  241. </div>
  242. <a name="N1000D"></a><a name="Purpose"></a>
  243. <h2 class="h3">Purpose</h2>
  244. <div class="section">
  245. <p>
  246. This document aims to be the starting point for users working with
  247. Hadoop Distributed File System (HDFS) either as a part of a
  248. <a href="http://hadoop.apache.org/">Hadoop</a>
  249. cluster or as a stand-alone general purpose distributed file system.
  250. While HDFS is designed to "just-work" in many environments, a working
  251. knowledge of HDFS helps greatly with configuration improvements and
  252. diagnostics on a specific cluster.
  253. </p>
  254. </div>
  255. <a name="N1001B"></a><a name="Overview"></a>
  256. <h2 class="h3"> Overview </h2>
  257. <div class="section">
  258. <p>
  259. HDFS is the primary distributed storage used by Hadoop applications. A
  260. HDFS cluster primarily consists of a <em>NameNode</em> that manages the
  261. filesystem metadata and Datanodes that store the actual data. The
  262. architecture of HDFS is described in detail
  263. <a href="hdfs_design.html">here</a>. This user guide primarily deals with
  264. interaction of users and administrators with HDFS clusters.
  265. The <a href="images/hdfsarchitecture.gif">diagram</a> from
  266. <a href="hdfs_design.html">HDFS architecture</a> depicts
  267. basic interactions among Namenode, Datanodes, and the clients. Eseentially,
  268. clients contact Namenode for file metadata or file modifications and perform
  269. actual file I/O directly with the datanodes.
  270. </p>
  271. <p>
  272. The following are some of the salient features that could be of
  273. interest to many users. The terms in <em>italics</em>
  274. are described in later sections.
  275. </p>
  276. <ul>
  277. <li>
  278. Hadoop, including HDFS, is well suited for distributed storage
  279. and distributed processing using commodity hardware. It is fault
  280. tolerant, scalable, and extremely simple to expand.
  281. <a href="mapred_tutorial.html">Map-Reduce</a>,
  282. well known for its simplicity and applicability for large set of
  283. distributed applications, is an integral part of Hadoop.
  284. </li>
  285. <li>
  286. HDFS is highly configurable with a default configuration well
  287. suited for many installations. Most of the time, configuration
  288. needs to be tuned only for very large clusters.
  289. </li>
  290. <li>
  291. It is written in Java and is supported on all major platforms.
  292. </li>
  293. <li>
  294. Supports <em>shell like commands</em> to interact with HDFS directly.
  295. </li>
  296. <li>
  297. Namenode and Datanodes have built in web servers that makes it
  298. easy to check current status of the cluster.
  299. </li>
  300. <li>
  301. New features and improvements are regularly implemented in HDFS.
  302. The following is a subset of useful features in HDFS:
  303. <ul>
  304. <li>
  305. <em>File permissions and authentication.</em>
  306. </li>
  307. <li>
  308. <em>Rack awareness</em> : to take a node's physical location into
  309. account while scheduling tasks and allocating storage.
  310. </li>
  311. <li>
  312. <em>Safemode</em> : an administrative mode for maintanance.
  313. </li>
  314. <li>
  315. <em>fsck</em> : an utility to diagnose health of the filesystem, to
  316. find missing files or blocks.
  317. </li>
  318. <li>
  319. <em>Rebalancer</em> : tool to balance the cluster when the data is
  320. unevenly distributed among datanodes.
  321. </li>
  322. <li>
  323. <em>Upgrade and Rollback</em> : after a software upgrade,
  324. it is possible to
  325. rollback to HDFS' state before the upgrade in case of unexpected
  326. problems.
  327. </li>
  328. <li>
  329. <em>Secondary Namenode</em> : helps keep the size of file
  330. containing log of HDFS modification with in certain limit at
  331. the Namenode.
  332. </li>
  333. </ul>
  334. </li>
  335. </ul>
  336. </div>
  337. <a name="N10083"></a><a name="Pre-requisites"></a>
  338. <h2 class="h3"> Pre-requisites </h2>
  339. <div class="section">
  340. <p>
  341. The following documents describe installation and set up of a
  342. Hadoop cluster :
  343. </p>
  344. <ul>
  345. <li>
  346. <a href="quickstart.html">Hadoop Quickstart</a>
  347. for first-time users.
  348. </li>
  349. <li>
  350. <a href="cluster_setup.html">Hadoop Cluster Setup</a>
  351. for large, distributed clusters.
  352. </li>
  353. </ul>
  354. <p>
  355. The rest of document assumes the user is able to set up and run a
  356. HDFS with at least one Datanode. For the purpose of this document,
  357. both Namenode and Datanode could be running on the same physical
  358. machine.
  359. </p>
  360. </div>
  361. <a name="N100A1"></a><a name="Web+Interface"></a>
  362. <h2 class="h3"> Web Interface </h2>
  363. <div class="section">
  364. <p>
  365. Namenode and Datanode each run an internal web server in order to
  366. display basic information about the current status of the cluster.
  367. With the default configuration, namenode front page is at
  368. <span class="codefrag">http://namenode:50070/</span> .
  369. It lists the datanodes in the cluster and basic stats of the
  370. cluster. The web interface can also be used to browse the file
  371. system (using "Browse the file system" link on the Namenode front
  372. page).
  373. </p>
  374. </div>
  375. <a name="N100AE"></a><a name="Shell+Commands"></a>
  376. <h2 class="h3">Shell Commands</h2>
  377. <div class="section">
  378. <p>
  379. Hadoop includes various "shell-like" commands that directly
  380. interact with HDFS and other file systems that Hadoop supports.
  381. The command
  382. <span class="codefrag">bin/hadoop fs -help</span>
  383. lists the commands supported by Hadoop
  384. shell. Further,
  385. <span class="codefrag">bin/hadoop fs -help command</span>
  386. displays more detailed help on a command. The commands support
  387. most of the normal filesystem operations like copying files,
  388. changing file permissions, etc. It also supports a few HDFS
  389. specific operations like changing replication of files.
  390. </p>
  391. <a name="N100BD"></a><a name="DFSAdmin+Command"></a>
  392. <h3 class="h4"> DFSAdmin Command </h3>
  393. <p>
  394. <span class="codefrag">'bin/hadoop dfsadmin'</span>
  395. command supports a few HDFS administration related operations.
  396. <span class="codefrag">bin/hadoop dfsadmin -help</span>
  397. lists all the commands currently supported. For e.g.:
  398. </p>
  399. <ul>
  400. <li>
  401. <span class="codefrag">-report</span>
  402. : reports basic stats of HDFS. Some of this information is
  403. also available on the Namenode front page.
  404. </li>
  405. <li>
  406. <span class="codefrag">-safemode</span>
  407. : though usually not required, an administrator can manually enter
  408. or leave <em>safemode</em>.
  409. </li>
  410. <li>
  411. <span class="codefrag">-finalizeUpgrade</span>
  412. : removes previous backup of the cluster made during last upgrade.
  413. </li>
  414. </ul>
  415. </div>
  416. <a name="N100E6"></a><a name="Secondary+Namenode"></a>
  417. <h2 class="h3"> Secondary Namenode </h2>
  418. <div class="section">
  419. <p>
  420. Namenode stores modifications to the filesystem as a log
  421. appended to a native filesystem file (<span class="codefrag">edits</span>).
  422. When a Namenode starts up, it reads HDFS state from an image
  423. file (<span class="codefrag">fsimage</span>) and then applies <em>edits</em> from
  424. edits log file. It then writes new HDFS state to (<span class="codefrag">fsimage</span>)
  425. and starts normal
  426. operation with an empty edits file. Since namenode merges
  427. <span class="codefrag">fsimage</span> and <span class="codefrag">edits</span> files only during start up,
  428. edits file could get very large over time on a large cluster.
  429. Another side effect of larger edits file is that next
  430. restart of Namenade takes longer.
  431. </p>
  432. <p>
  433. The secondary namenode merges fsimage and edits log periodically
  434. and keeps edits log size with in a limit. It is usually run on a
  435. different machine than the primary Namenode since its memory requirements
  436. are on the same order as the primary namemode. The secondary
  437. namenode is started by <span class="codefrag">bin/start-dfs.sh</span> on the nodes
  438. specified in <span class="codefrag">conf/masters</span> file.
  439. </p>
  440. </div>
  441. <a name="N1010B"></a><a name="Rebalancer"></a>
  442. <h2 class="h3"> Rebalancer </h2>
  443. <div class="section">
  444. <p>
  445. HDFS data might not always be be placed uniformly across the
  446. datanode. One common reason is addition of new datanodes to an
  447. existing cluster. While placing new <em>blocks</em> (data for a file is
  448. stored as a series of blocks), Namenode considers various
  449. parameters before choosing the datanodes to receive these blocks.
  450. Some of the considerations are :
  451. </p>
  452. <ul>
  453. <li>
  454. Policy to keep one of the replicas of a block on the same node
  455. as the node that is writing the block.
  456. </li>
  457. <li>
  458. Need to spread different replicas of a block across the racks so
  459. that cluster can survive loss of whole rack.
  460. </li>
  461. <li>
  462. One of the replicas is usually placed on the same rack as the
  463. node writing to the file so that cross-rack network I/O is
  464. reduced.
  465. </li>
  466. <li>
  467. Spread HDFS data uniformly across the datanodes in the cluster.
  468. </li>
  469. </ul>
  470. <p>
  471. Due to multiple competing considerations, data might not be
  472. uniformly placed across the datanodes.
  473. HDFS provides a tool for administrators that analyzes block
  474. placement and relanaces data across the datnodes. A brief
  475. adminstrator's guide for rebalancer as a
  476. <a href="http://issues.apache.org/jira/secure/attachment/12368261/RebalanceDesign6.pdf">PDF</a>
  477. is attached to
  478. <a href="http://issues.apache.org/jira/browse/HADOOP-1652">HADOOP-1652</a>.
  479. </p>
  480. </div>
  481. <a name="N10132"></a><a name="Rack+Awareness"></a>
  482. <h2 class="h3"> Rack Awareness </h2>
  483. <div class="section">
  484. <p>
  485. Typically large Hadoop clusters are arranged in <em>racks</em> and
  486. network traffic between different nodes with in the same rack is
  487. much more desirable than network traffic across the racks. In
  488. addition Namenode tries to place replicas of block on
  489. multiple racks for improved fault tolerance. Hadoop lets the
  490. cluster administrators decide which <em>rack</em> a node belongs to
  491. through configuration variable <span class="codefrag">dfs.network.script</span>. When this
  492. script is configured, each node runs the script to determine its
  493. <em>rackid</em>. A default installation assumes all the nodes belong to
  494. the same rack. This feature and configuration is further described
  495. in <a href="http://issues.apache.org/jira/secure/attachment/12345251/Rack_aware_HDFS_proposal.pdf">PDF</a>
  496. attached to
  497. <a href="http://issues.apache.org/jira/browse/HADOOP-692">HADOOP-692</a>.
  498. </p>
  499. </div>
  500. <a name="N10150"></a><a name="Safemode"></a>
  501. <h2 class="h3"> Safemode </h2>
  502. <div class="section">
  503. <p>
  504. During start up Namenode loads the filesystem state from
  505. <em>fsimage</em> and <em>edits</em> log file. It then waits for datanodes
  506. to report their blocks so that it does not prematurely start
  507. replicating the blocks though enough replicas already exist in the
  508. cluster. During this time Namenode stays in <em>safemode</em>. A
  509. <em>Safemode</em>
  510. for Namenode is essentially a read-only mode for the HDFS cluster,
  511. where it does not allow any modifications to filesystem or blocks.
  512. Normally Namenode gets out of safemode automatically at
  513. the beginning. If required, HDFS could be placed in safemode explicitly
  514. using <span class="codefrag">'bin/hadoop dfsadmin -safemode'</span> command. Namenode front
  515. page shows whether safemode is on or off. A more detailed
  516. description and configuration is maintained as JavaDoc for
  517. <a href="http://hadoop.apache.org/core/docs/current/api/org/apache/hadoop/dfs/NameNode.html#setSafeMode(org.apache.hadoop.dfs.FSConstants.SafeModeAction)"><span class="codefrag">setSafeMode()</span></a>.
  518. </p>
  519. </div>
  520. <a name="N1016E"></a><a name="Fsck"></a>
  521. <h2 class="h3"> Fsck </h2>
  522. <div class="section">
  523. <p>
  524. HDFS supports <span class="codefrag">fsck</span> command to check for various
  525. inconsistencies.
  526. It it is designed for reporting problems with various
  527. files, for e.g. missing blocks for a file or under replicated
  528. blocks. Unlike a traditional fsck utility for native filesystems,
  529. this command does not correct the errors it detects. Normally Namenode
  530. automatically corrects most of the recoverable failures. By default
  531. fsck ignores open files but provides an option to select during reporting.
  532. HDFS' fsck is not a
  533. Hadoop shell command. It can be run as '<span class="codefrag">bin/hadoop fsck</span>'.
  534. Fsck can be run on the whole filesystem or on a subset of files.
  535. </p>
  536. </div>
  537. <a name="N1017E"></a><a name="Upgrade+and+Rollback"></a>
  538. <h2 class="h3"> Upgrade and Rollback </h2>
  539. <div class="section">
  540. <p>
  541. When Hadoop is upgraded on an existing cluster, as with any
  542. software upgrade, it is possible there are new bugs or
  543. incompatible changes that affect existing applications and were
  544. not discovered earlier. In any non-trivial HDFS installation, it
  545. is not an option to loose any data, let alone to restart HDFS from
  546. scratch. HDFS allows administrators to go back to earlier version
  547. of Hadoop and <em>roll back</em> the cluster to the state it was in
  548. before
  549. the upgrade. HDFS upgrade is described in more detail in
  550. <a href="http://wiki.apache.org/hadoop/Hadoop%20Upgrade">upgrade wiki</a>.
  551. HDFS can have one such backup at a time. Before upgrading,
  552. administrators need to remove existing backup using <span class="codefrag">bin/hadoop
  553. dfsadmin -finalizeUpgrade</span> command. The following
  554. briefly describes typical upgrade procedure :
  555. </p>
  556. <ul>
  557. <li>
  558. Before upgrading Hadoop software,
  559. <em>finalize</em> if there an existing backup.
  560. <span class="codefrag">dfsadmin -upgradeProgress status</span>
  561. can tell if the cluster needs to be <em>finalized</em>.
  562. </li>
  563. <li>Stop the cluster and distribute new version of Hadoop.</li>
  564. <li>
  565. Run the new version with <span class="codefrag">-upgrade</span> option
  566. (<span class="codefrag">bin/start-dfs.sh -upgrade</span>).
  567. </li>
  568. <li>
  569. Most of the time, cluster works just fine. Once the new HDFS is
  570. considered working well (may be after a few days of operation),
  571. finalize the upgrade. Note that until the cluster is finalized,
  572. deleting the files that existed before the upgrade does not free
  573. up real disk space on the datanodes.
  574. </li>
  575. <li>
  576. If there is a need to move back to the old version,
  577. <ul>
  578. <li> stop the cluster and distribute earlier version of Hadoop. </li>
  579. <li> start the cluster with rollback option.
  580. (<span class="codefrag">bin/start-dfs.h -rollback</span>).
  581. </li>
  582. </ul>
  583. </li>
  584. </ul>
  585. </div>
  586. <a name="N101BF"></a><a name="File+Permissions+and+Security"></a>
  587. <h2 class="h3"> File Permissions and Security </h2>
  588. <div class="section">
  589. <p>
  590. The file permissions are designed to be similar to file permissions on
  591. other familiar platforms like Linux. Currently, security is limited
  592. to simple file permissions. The user that starts Namenode is
  593. treated as the <em>super user</em> for HDFS. Future versions of HDFS will
  594. support network authentication protocols like Kerberos for user
  595. authentication and encryption of data transfers. The details are discussed in the
  596. <a href="hdfs_permissions_guide.html"><em>Permissions User and Administrator Guide</em></a>.
  597. </p>
  598. </div>
  599. <a name="N101D1"></a><a name="Scalability"></a>
  600. <h2 class="h3"> Scalability </h2>
  601. <div class="section">
  602. <p>
  603. Hadoop currently runs on clusters with thousands of nodes.
  604. <a href="http://wiki.apache.org/hadoop/PoweredBy">PoweredBy Hadoop</a>
  605. lists some of the organizations that deploy Hadoop on large
  606. clusters. HDFS has one Namenode for each cluster. Currently
  607. the total memory available on Namenode is the primary scalability
  608. limitation. On very large clusters, increasing average size of
  609. files stored in HDFS helps with increasing cluster size without
  610. increasing memory requirements on Namenode.
  611. The default configuration may not suite very large clustes.
  612. <a href="http://wiki.apache.org/hadoop/FAQ">Hadoop FAQ</a> page lists
  613. suggested configuration improvements for large Hadoop clusters.
  614. </p>
  615. </div>
  616. <a name="N101E3"></a><a name="Related+Documentation"></a>
  617. <h2 class="h3"> Related Documentation </h2>
  618. <div class="section">
  619. <p>
  620. This user guide is intended to be a good starting point for
  621. working with HDFS. While it continues to improve,
  622. there is a large wealth of documentation about Hadoop and HDFS.
  623. The following lists starting points for further exploration :
  624. </p>
  625. <ul>
  626. <li>
  627. <a href="http://hadoop.apache.org/">Hadoop Home Page</a>
  628. : the start page for everything Hadoop.
  629. </li>
  630. <li>
  631. <a href="http://wiki.apache.org/hadoop/FrontPage">Hadoop Wiki</a>
  632. : Front page for Hadoop Wiki documentation. Unlike this
  633. guide which is part of Hadoop source tree, Hadoop Wiki is
  634. regularly edited by Hadoop Community.
  635. </li>
  636. <li>
  637. <a href="http://wiki.apache.org/hadoop/FAQ">FAQ</a> from Hadoop Wiki.
  638. </li>
  639. <li>
  640. Hadoop <a href="http://hadoop.apache.org/core/docs/current/api/">
  641. JavaDoc API</a>.
  642. </li>
  643. <li>
  644. Hadoop User Mailing List :
  645. <a href="mailto:core-user@hadoop.apache.org">core-user[at]hadoop.apache.org</a>.
  646. </li>
  647. <li>
  648. Explore <span class="codefrag">conf/hadoop-default.xml</span>.
  649. It includes brief
  650. description of most of the configuration variables available.
  651. </li>
  652. </ul>
  653. </div>
  654. </div>
  655. <!--+
  656. |end content
  657. +-->
  658. <div class="clearboth">&nbsp;</div>
  659. </div>
  660. <div id="footer">
  661. <!--+
  662. |start bottomstrip
  663. +-->
  664. <div class="lastmodified">
  665. <script type="text/javascript"><!--
  666. document.write("Last Published: " + document.lastModified);
  667. // --></script>
  668. </div>
  669. <div class="copyright">
  670. Copyright &copy;
  671. 2007 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
  672. </div>
  673. <!--+
  674. |end bottomstrip
  675. +-->
  676. </div>
  677. </body>
  678. </html>