distcp.html 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593
  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>DistCp</title>
  9. <link type="text/css" href="skin/basic.css" rel="stylesheet">
  10. <link media="screen" type="text/css" href="skin/screen.css" rel="stylesheet">
  11. <link media="print" type="text/css" href="skin/print.css" rel="stylesheet">
  12. <link type="text/css" href="skin/profile.css" rel="stylesheet">
  13. <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>
  14. <link rel="shortcut icon" href="images/favicon.ico">
  15. </head>
  16. <body onload="init()">
  17. <script type="text/javascript">ndeSetTextSize();</script>
  18. <div id="top">
  19. <!--+
  20. |breadtrail
  21. +-->
  22. <div class="breadtrail">
  23. <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>
  24. </div>
  25. <!--+
  26. |header
  27. +-->
  28. <div class="header">
  29. <!--+
  30. |start group logo
  31. +-->
  32. <div class="grouplogo">
  33. <a href="http://hadoop.apache.org/"><img class="logoImage" alt="Hadoop" src="images/hadoop-logo.jpg" title="Apache Hadoop"></a>
  34. </div>
  35. <!--+
  36. |end group logo
  37. +-->
  38. <!--+
  39. |start Project Logo
  40. +-->
  41. <div class="projectlogo">
  42. <a href="http://hadoop.apache.org/core/"><img class="logoImage" alt="Hadoop" src="images/core-logo.gif" title="Scalable Computing Platform"></a>
  43. </div>
  44. <!--+
  45. |end Project Logo
  46. +-->
  47. <!--+
  48. |start Search
  49. +-->
  50. <div class="searchbox">
  51. <form action="http://www.google.com/search" method="get" class="roundtopsmall">
  52. <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;
  53. <input name="Search" value="Search" type="submit">
  54. </form>
  55. </div>
  56. <!--+
  57. |end search
  58. +-->
  59. <!--+
  60. |start Tabs
  61. +-->
  62. <ul id="tabs">
  63. <li>
  64. <a class="unselected" href="http://hadoop.apache.org/core/">Project</a>
  65. </li>
  66. <li>
  67. <a class="unselected" href="http://wiki.apache.org/hadoop">Wiki</a>
  68. </li>
  69. <li class="current">
  70. <a class="selected" href="index.html">Hadoop 0.18 Documentation</a>
  71. </li>
  72. </ul>
  73. <!--+
  74. |end Tabs
  75. +-->
  76. </div>
  77. </div>
  78. <div id="main">
  79. <div id="publishedStrip">
  80. <!--+
  81. |start Subtabs
  82. +-->
  83. <div id="level2tabs"></div>
  84. <!--+
  85. |end Endtabs
  86. +-->
  87. <script type="text/javascript"><!--
  88. document.write("Last Published: " + document.lastModified);
  89. // --></script>
  90. </div>
  91. <!--+
  92. |breadtrail
  93. +-->
  94. <div class="breadtrail">
  95. &nbsp;
  96. </div>
  97. <!--+
  98. |start Menu, mainarea
  99. +-->
  100. <!--+
  101. |start Menu
  102. +-->
  103. <div id="menu">
  104. <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>
  105. <div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
  106. <div class="menuitem">
  107. <a href="index.html">Overview</a>
  108. </div>
  109. <div class="menuitem">
  110. <a href="quickstart.html">Quickstart</a>
  111. </div>
  112. <div class="menuitem">
  113. <a href="cluster_setup.html">Cluster Setup</a>
  114. </div>
  115. <div class="menuitem">
  116. <a href="hdfs_design.html">HDFS Architecture</a>
  117. </div>
  118. <div class="menuitem">
  119. <a href="hdfs_user_guide.html">HDFS User Guide</a>
  120. </div>
  121. <div class="menuitem">
  122. <a href="hdfs_permissions_guide.html">HDFS Permissions Guide</a>
  123. </div>
  124. <div class="menuitem">
  125. <a href="hdfs_quota_admin_guide.html">HDFS Quotas Administrator Guide</a>
  126. </div>
  127. <div class="menuitem">
  128. <a href="commands_manual.html">Commands Manual</a>
  129. </div>
  130. <div class="menuitem">
  131. <a href="hdfs_shell.html">FS Shell Guide</a>
  132. </div>
  133. <div class="menupage">
  134. <div class="menupagetitle">DistCp Guide</div>
  135. </div>
  136. <div class="menuitem">
  137. <a href="mapred_tutorial.html">Map-Reduce Tutorial</a>
  138. </div>
  139. <div class="menuitem">
  140. <a href="native_libraries.html">Native Hadoop Libraries</a>
  141. </div>
  142. <div class="menuitem">
  143. <a href="streaming.html">Streaming</a>
  144. </div>
  145. <div class="menuitem">
  146. <a href="hadoop_archives.html">Hadoop Archives</a>
  147. </div>
  148. <div class="menuitem">
  149. <a href="hod.html">Hadoop On Demand</a>
  150. </div>
  151. <div class="menuitem">
  152. <a href="api/index.html">API Docs</a>
  153. </div>
  154. <div class="menuitem">
  155. <a href="jdiff/changes.html">API Changes</a>
  156. </div>
  157. <div class="menuitem">
  158. <a href="http://wiki.apache.org/hadoop/">Wiki</a>
  159. </div>
  160. <div class="menuitem">
  161. <a href="http://wiki.apache.org/hadoop/FAQ">FAQ</a>
  162. </div>
  163. <div class="menuitem">
  164. <a href="http://hadoop.apache.org/core/mailing_lists.html">Mailing Lists</a>
  165. </div>
  166. <div class="menuitem">
  167. <a href="releasenotes.html">Release Notes</a>
  168. </div>
  169. <div class="menuitem">
  170. <a href="changes.html">All Changes</a>
  171. </div>
  172. </div>
  173. <div id="credit"></div>
  174. <div id="roundbottom">
  175. <img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
  176. <!--+
  177. |alternative credits
  178. +-->
  179. <div id="credit2"></div>
  180. </div>
  181. <!--+
  182. |end Menu
  183. +-->
  184. <!--+
  185. |start content
  186. +-->
  187. <div id="content">
  188. <div title="Portable Document Format" class="pdflink">
  189. <a class="dida" href="distcp.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
  190. PDF</a>
  191. </div>
  192. <h1>DistCp</h1>
  193. <div id="minitoc-area">
  194. <ul class="minitoc">
  195. <li>
  196. <a href="#Overview">Overview</a>
  197. </li>
  198. <li>
  199. <a href="#Usage">Usage</a>
  200. <ul class="minitoc">
  201. <li>
  202. <a href="#Basic">Basic</a>
  203. </li>
  204. <li>
  205. <a href="#options">Options</a>
  206. <ul class="minitoc">
  207. <li>
  208. <a href="#Option+Index">Option Index</a>
  209. </li>
  210. <li>
  211. <a href="#uo">Update and Overwrite</a>
  212. </li>
  213. </ul>
  214. </li>
  215. </ul>
  216. </li>
  217. <li>
  218. <a href="#etc">Appendix</a>
  219. <ul class="minitoc">
  220. <li>
  221. <a href="#Map+sizing">Map sizing</a>
  222. </li>
  223. <li>
  224. <a href="#cpver">Copying between versions of HDFS</a>
  225. </li>
  226. <li>
  227. <a href="#Map%2FReduce+and+other+side-effects">Map/Reduce and other side-effects</a>
  228. </li>
  229. </ul>
  230. </li>
  231. </ul>
  232. </div>
  233. <a name="N1000D"></a><a name="Overview"></a>
  234. <h2 class="h3">Overview</h2>
  235. <div class="section">
  236. <p>DistCp (distributed copy) is a tool used for large inter/intra-cluster
  237. copying. It uses Map/Reduce to effect its distribution, error
  238. handling and recovery, and reporting. It expands a list of files and
  239. directories into input to map tasks, each of which will copy a partition
  240. of the files specified in the source list. Its Map/Reduce pedigree has
  241. endowed it with some quirks in both its semantics and execution. The
  242. purpose of this document is to offer guidance for common tasks and to
  243. elucidate its model.</p>
  244. </div>
  245. <a name="N10017"></a><a name="Usage"></a>
  246. <h2 class="h3">Usage</h2>
  247. <div class="section">
  248. <a name="N1001D"></a><a name="Basic"></a>
  249. <h3 class="h4">Basic</h3>
  250. <p>The most common invocation of DistCp is an inter-cluster copy:</p>
  251. <p>
  252. <span class="codefrag">bash$ hadoop distcp hdfs://nn1:8020/foo/bar \</span>
  253. <br>
  254. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  255. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  256. hdfs://nn2:8020/bar/foo</span>
  257. </p>
  258. <p>This will expand the namespace under <span class="codefrag">/foo/bar</span> on nn1
  259. into a temporary file, partition its contents among a set of map
  260. tasks, and start a copy on each TaskTracker from nn1 to nn2. Note
  261. that DistCp expects absolute paths.</p>
  262. <p>One can also specify multiple source directories on the command
  263. line:</p>
  264. <p>
  265. <span class="codefrag">bash$ hadoop distcp hdfs://nn1:8020/foo/a \</span>
  266. <br>
  267. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  268. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  269. hdfs://nn1:8020/foo/b \</span>
  270. <br>
  271. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  272. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  273. hdfs://nn2:8020/bar/foo</span>
  274. </p>
  275. <p>Or, equivalently, from a file using the <span class="codefrag">-f</span> option:<br>
  276. <span class="codefrag">bash$ hadoop distcp -f hdfs://nn1:8020/srclist \</span>
  277. <br>
  278. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  279. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  280. &nbsp;hdfs://nn2:8020/bar/foo</span>
  281. <br>
  282. </p>
  283. <p>Where <span class="codefrag">srclist</span> contains<br>
  284. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/a</span>
  285. <br>
  286. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/b</span>
  287. </p>
  288. <p>When copying from multiple sources, DistCp will abort the copy with
  289. an error message if two sources collide, but collisions at the
  290. destination are resolved per the <a href="#options">options</a>
  291. specified. By default, files already existing at the destination are
  292. skipped (i.e. not replaced by the source file). A count of skipped
  293. files is reported at the end of each job, but it may be inaccurate if a
  294. copier failed for some subset of its files, but succeeded on a later
  295. attempt (see <a href="#etc">Appendix</a>).</p>
  296. <p>It is important that each TaskTracker can reach and communicate with
  297. both the source and destination file systems. For HDFS, both the source
  298. and destination must be running the same version of the protocol or use
  299. a backwards-compatible protocol (see <a href="#cpver">Copying Between
  300. Versions</a>).</p>
  301. <p>After a copy, it is recommended that one generates and cross-checks
  302. a listing of the source and destination to verify that the copy was
  303. truly successful. Since DistCp employs both Map/Reduce and the
  304. FileSystem API, issues in or between any of the three could adversely
  305. and silently affect the copy. Some have had success running with
  306. <span class="codefrag">-update</span> enabled to perform a second pass, but users should
  307. be acquainted with its semantics before attempting this.</p>
  308. <p>It's also worth noting that if another client is still writing to a
  309. source file, the copy will likely fail. Attempting to overwrite a file
  310. being written at the destination should also fail on HDFS. If a source
  311. file is (re)moved before it is copied, the copy will fail with a
  312. FileNotFoundException.</p>
  313. <a name="N1007E"></a><a name="options"></a>
  314. <h3 class="h4">Options</h3>
  315. <a name="N10084"></a><a name="Option+Index"></a>
  316. <h4>Option Index</h4>
  317. <table class="ForrestTable" cellspacing="1" cellpadding="4">
  318. <tr>
  319. <th colspan="1" rowspan="1"> Flag </th><th colspan="1" rowspan="1"> Description </th><th colspan="1" rowspan="1"> Notes </th>
  320. </tr>
  321. <tr>
  322. <td colspan="1" rowspan="1"><span class="codefrag">-p[rbugp]</span></td>
  323. <td colspan="1" rowspan="1">Preserve<br>
  324. &nbsp;&nbsp;r: replication number<br>
  325. &nbsp;&nbsp;b: block size<br>
  326. &nbsp;&nbsp;u: user<br>
  327. &nbsp;&nbsp;g: group<br>
  328. &nbsp;&nbsp;p: permission<br>
  329. </td>
  330. <td colspan="1" rowspan="1">Modification times are not preserved. Also, when
  331. <span class="codefrag">-update</span> is specified, status updates will
  332. <strong>not</strong> be synchronized unless the file sizes
  333. also differ (i.e. unless the file is re-created).
  334. </td>
  335. </tr>
  336. <tr>
  337. <td colspan="1" rowspan="1"><span class="codefrag">-i</span></td>
  338. <td colspan="1" rowspan="1">Ignore failures</td>
  339. <td colspan="1" rowspan="1">As explained in the <a href="#etc">Appendix</a>, this option
  340. will keep more accurate statistics about the copy than the
  341. default case. It also preserves logs from failed copies, which
  342. can be valuable for debugging. Finally, a failing map will not
  343. cause the job to fail before all splits are attempted.
  344. </td>
  345. </tr>
  346. <tr>
  347. <td colspan="1" rowspan="1"><span class="codefrag">-log &lt;logdir&gt;</span></td>
  348. <td colspan="1" rowspan="1">Write logs to &lt;logdir&gt;</td>
  349. <td colspan="1" rowspan="1">DistCp keeps logs of each file it attempts to copy as map
  350. output. If a map fails, the log output will not be retained if
  351. it is re-executed.
  352. </td>
  353. </tr>
  354. <tr>
  355. <td colspan="1" rowspan="1"><span class="codefrag">-m &lt;num_maps&gt;</span></td>
  356. <td colspan="1" rowspan="1">Maximum number of simultaneous copies</td>
  357. <td colspan="1" rowspan="1">Specify the number of maps to copy data. Note that more maps
  358. may not necessarily improve throughput.
  359. </td>
  360. </tr>
  361. <tr>
  362. <td colspan="1" rowspan="1"><span class="codefrag">-overwrite</span></td>
  363. <td colspan="1" rowspan="1">Overwrite destination</td>
  364. <td colspan="1" rowspan="1">If a map fails and <span class="codefrag">-i</span> is not specified, all the
  365. files in the split, not only those that failed, will be recopied.
  366. As discussed in the <a href="#uo">following</a>, it also changes
  367. the semantics for generating destination paths, so users should
  368. use this carefully.
  369. </td>
  370. </tr>
  371. <tr>
  372. <td colspan="1" rowspan="1"><span class="codefrag">-update</span></td>
  373. <td colspan="1" rowspan="1">Overwrite if src size different from dst size</td>
  374. <td colspan="1" rowspan="1">As noted in the preceding, this is not a "sync"
  375. operation. The only criterion examined is the source and
  376. destination file sizes; if they differ, the source file
  377. replaces the destination file. As discussed in the
  378. <a href="#uo">following</a>, it also changes the semantics for
  379. generating destination paths, so users should use this carefully.
  380. </td>
  381. </tr>
  382. <tr>
  383. <td colspan="1" rowspan="1"><span class="codefrag">-f &lt;urilist_uri&gt;</span></td>
  384. <td colspan="1" rowspan="1">Use list at &lt;urilist_uri&gt; as src list</td>
  385. <td colspan="1" rowspan="1">This is equivalent to listing each source on the command
  386. line. The <span class="codefrag">urilist_uri</span> list should be a fully
  387. qualified URI.
  388. </td>
  389. </tr>
  390. </table>
  391. <a name="N10136"></a><a name="uo"></a>
  392. <h4>Update and Overwrite</h4>
  393. <p>It's worth giving some examples of <span class="codefrag">-update</span> and
  394. <span class="codefrag">-overwrite</span>. Consider a copy from <span class="codefrag">/foo/a</span> and
  395. <span class="codefrag">/foo/b</span> to <span class="codefrag">/bar/foo</span>, where the sources contain
  396. the following:</p>
  397. <p>
  398. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/a</span>
  399. <br>
  400. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/a/aa</span>
  401. <br>
  402. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/a/ab</span>
  403. <br>
  404. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/b</span>
  405. <br>
  406. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/b/ba</span>
  407. <br>
  408. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/b/ab</span>
  409. </p>
  410. <p>If either <span class="codefrag">-update</span> or <span class="codefrag">-overwrite</span> is set,
  411. then both sources will map an entry to <span class="codefrag">/bar/foo/ab</span> at the
  412. destination. For both options, the contents of each source directory
  413. are compared with the <strong>contents</strong> of the destination
  414. directory. Rather than permit this conflict, DistCp will abort.</p>
  415. <p>In the default case, both <span class="codefrag">/bar/foo/a</span> and
  416. <span class="codefrag">/bar/foo/b</span> will be created and neither will collide.</p>
  417. <p>Now consider a legal copy using <span class="codefrag">-update</span>:<br>
  418. <span class="codefrag">distcp -update hdfs://nn1:8020/foo/a \</span>
  419. <br>
  420. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  421. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  422. hdfs://nn1:8020/foo/b \</span>
  423. <br>
  424. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  425. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  426. hdfs://nn2:8020/bar</span>
  427. </p>
  428. <p>With sources/sizes:</p>
  429. <p>
  430. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/a</span>
  431. <br>
  432. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/a/aa 32</span>
  433. <br>
  434. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/a/ab 32</span>
  435. <br>
  436. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/b</span>
  437. <br>
  438. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/b/ba 64</span>
  439. <br>
  440. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn1:8020/foo/b/bb 32</span>
  441. </p>
  442. <p>And destination/sizes:</p>
  443. <p>
  444. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn2:8020/bar</span>
  445. <br>
  446. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn2:8020/bar/aa 32</span>
  447. <br>
  448. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn2:8020/bar/ba 32</span>
  449. <br>
  450. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn2:8020/bar/bb 64</span>
  451. </p>
  452. <p>Will effect:</p>
  453. <p>
  454. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn2:8020/bar</span>
  455. <br>
  456. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn2:8020/bar/aa 32</span>
  457. <br>
  458. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn2:8020/bar/ab 32</span>
  459. <br>
  460. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn2:8020/bar/ba 64</span>
  461. <br>
  462. <span class="codefrag">&nbsp;&nbsp;&nbsp;&nbsp;hdfs://nn2:8020/bar/bb 32</span>
  463. </p>
  464. <p>Only <span class="codefrag">aa</span> is not overwritten on nn2. If
  465. <span class="codefrag">-overwrite</span> were specified, all elements would be
  466. overwritten.</p>
  467. </div> <!-- Usage -->
  468. <a name="N101E7"></a><a name="etc"></a>
  469. <h2 class="h3">Appendix</h2>
  470. <div class="section">
  471. <a name="N101ED"></a><a name="Map+sizing"></a>
  472. <h3 class="h4">Map sizing</h3>
  473. <p>DistCp makes a faint attempt to size each map comparably so that
  474. each copies roughly the same number of bytes. Note that files are the
  475. finest level of granularity, so increasing the number of simultaneous
  476. copiers (i.e. maps) may not always increase the number of
  477. simultaneous copies nor the overall throughput.</p>
  478. <p>If <span class="codefrag">-m</span> is not specified, DistCp will attempt to
  479. schedule work for <span class="codefrag">min (total_bytes / bytes.per.map, 20 *
  480. num_task_trackers)</span> where <span class="codefrag">bytes.per.map</span> defaults
  481. to 256MB.</p>
  482. <p>Tuning the number of maps to the size of the source and
  483. destination clusters, the size of the copy, and the available
  484. bandwidth is recommended for long-running and regularly run jobs.</p>
  485. <a name="N10206"></a><a name="cpver"></a>
  486. <h3 class="h4">Copying between versions of HDFS</h3>
  487. <p>For copying between two different versions of Hadoop, one will
  488. usually use HftpFileSystem. This is a read-only FileSystem, so DistCp
  489. must be run on the destination cluster (more specifically, on
  490. TaskTrackers that can write to the destination cluster). Each source is
  491. specified as <span class="codefrag">hftp://&lt;dfs.http.address&gt;/&lt;path&gt;</span>
  492. (the default <span class="codefrag">dfs.http.address</span> is
  493. &lt;namenode&gt;:50070).</p>
  494. <a name="N10216"></a><a name="Map%2FReduce+and+other+side-effects"></a>
  495. <h3 class="h4">Map/Reduce and other side-effects</h3>
  496. <p>As has been mentioned in the preceding, should a map fail to copy
  497. one of its inputs, there will be several side-effects.</p>
  498. <ul>
  499. <li>Unless <span class="codefrag">-i</span> is specified, the logs generated by that
  500. task attempt will be replaced by the previous attempt.</li>
  501. <li>Unless <span class="codefrag">-overwrite</span> is specified, files successfully
  502. copied by a previous map on a re-execution will be marked as
  503. "skipped".</li>
  504. <li>If a map fails <span class="codefrag">mapred.map.max.attempts</span> times, the
  505. remaining map tasks will be killed (unless <span class="codefrag">-i</span> is
  506. set).</li>
  507. <li>If <span class="codefrag">mapred.speculative.execution</span> is set set
  508. <span class="codefrag">final</span> and <span class="codefrag">true</span>, the result of the copy is
  509. undefined.</li>
  510. </ul>
  511. </div> <!-- Appendix -->
  512. </div>
  513. <!--+
  514. |end content
  515. +-->
  516. <div class="clearboth">&nbsp;</div>
  517. </div>
  518. <div id="footer">
  519. <!--+
  520. |start bottomstrip
  521. +-->
  522. <div class="lastmodified">
  523. <script type="text/javascript"><!--
  524. document.write("Last Published: " + document.lastModified);
  525. // --></script>
  526. </div>
  527. <div class="copyright">
  528. Copyright &copy;
  529. 2007 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
  530. </div>
  531. <!--+
  532. |end bottomstrip
  533. +-->
  534. </div>
  535. </body>
  536. </html>