mapred-default.html 33 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667
  1. <html>
  2. <body>
  3. <table border="1">
  4. <tr>
  5. <td>name</td><td>value</td><td>description</td>
  6. </tr>
  7. <tr>
  8. <td><a name="hadoop.job.history.location">hadoop.job.history.location</a></td><td></td><td> If job tracker is static the history files are stored
  9. in this single well known place. If No value is set here, by default,
  10. it is in the local file system at ${hadoop.log.dir}/history.
  11. </td>
  12. </tr>
  13. <tr>
  14. <td><a name="hadoop.job.history.user.location">hadoop.job.history.user.location</a></td><td></td><td> User can specify a location to store the history files of
  15. a particular job. If nothing is specified, the logs are stored in
  16. output directory. The files are stored in "_logs/history/" in the directory.
  17. User can stop logging by giving the value "none".
  18. </td>
  19. </tr>
  20. <tr>
  21. <td><a name="io.sort.factor">io.sort.factor</a></td><td>10</td><td>The number of streams to merge at once while sorting
  22. files. This determines the number of open file handles.</td>
  23. </tr>
  24. <tr>
  25. <td><a name="io.sort.mb">io.sort.mb</a></td><td>100</td><td>The total amount of buffer memory to use while sorting
  26. files, in megabytes. By default, gives each merge stream 1MB, which
  27. should minimize seeks.</td>
  28. </tr>
  29. <tr>
  30. <td><a name="io.sort.record.percent">io.sort.record.percent</a></td><td>0.05</td><td>The percentage of io.sort.mb dedicated to tracking record
  31. boundaries. Let this value be r, io.sort.mb be x. The maximum number
  32. of records collected before the collection thread must block is equal
  33. to (r * x) / 4</td>
  34. </tr>
  35. <tr>
  36. <td><a name="io.sort.spill.percent">io.sort.spill.percent</a></td><td>0.80</td><td>The soft limit in either the buffer or record collection
  37. buffers. Once reached, a thread will begin to spill the contents to disk
  38. in the background. Note that this does not imply any chunking of data to
  39. the spill. A value less than 0.5 is not recommended.</td>
  40. </tr>
  41. <tr>
  42. <td><a name="io.map.index.skip">io.map.index.skip</a></td><td>0</td><td>Number of index entries to skip between each entry.
  43. Zero by default. Setting this to values larger than zero can
  44. facilitate opening large map files using less memory.</td>
  45. </tr>
  46. <tr>
  47. <td><a name="mapred.job.tracker">mapred.job.tracker</a></td><td>local</td><td>The host and port that the MapReduce job tracker runs
  48. at. If "local", then jobs are run in-process as a single map
  49. and reduce task.
  50. </td>
  51. </tr>
  52. <tr>
  53. <td><a name="mapred.job.tracker.http.address">mapred.job.tracker.http.address</a></td><td>0.0.0.0:50030</td><td>
  54. The job tracker http server address and port the server will listen on.
  55. If the port is 0 then the server will start on a free port.
  56. </td>
  57. </tr>
  58. <tr>
  59. <td><a name="mapred.job.tracker.handler.count">mapred.job.tracker.handler.count</a></td><td>10</td><td>
  60. The number of server threads for the JobTracker. This should be roughly
  61. 4% of the number of tasktracker nodes.
  62. </td>
  63. </tr>
  64. <tr>
  65. <td><a name="mapred.task.tracker.report.address">mapred.task.tracker.report.address</a></td><td>127.0.0.1:0</td><td>The interface and port that task tracker server listens on.
  66. Since it is only connected to by the tasks, it uses the local interface.
  67. EXPERT ONLY. Should only be changed if your host does not have the loopback
  68. interface.</td>
  69. </tr>
  70. <tr>
  71. <td><a name="mapred.local.dir">mapred.local.dir</a></td><td>${hadoop.tmp.dir}/mapred/local</td><td>The local directory where MapReduce stores intermediate
  72. data files. May be a comma-separated list of
  73. directories on different devices in order to spread disk i/o.
  74. Directories that do not exist are ignored.
  75. </td>
  76. </tr>
  77. <tr>
  78. <td><a name="mapred.system.dir">mapred.system.dir</a></td><td>${hadoop.tmp.dir}/mapred/system</td><td>The shared directory where MapReduce stores control files.
  79. </td>
  80. </tr>
  81. <tr>
  82. <td><a name="mapred.temp.dir">mapred.temp.dir</a></td><td>${hadoop.tmp.dir}/mapred/temp</td><td>A shared directory for temporary files.
  83. </td>
  84. </tr>
  85. <tr>
  86. <td><a name="mapred.local.dir.minspacestart">mapred.local.dir.minspacestart</a></td><td>0</td><td>If the space in mapred.local.dir drops under this,
  87. do not ask for more tasks.
  88. Value in bytes.
  89. </td>
  90. </tr>
  91. <tr>
  92. <td><a name="mapred.local.dir.minspacekill">mapred.local.dir.minspacekill</a></td><td>0</td><td>If the space in mapred.local.dir drops under this,
  93. do not ask more tasks until all the current ones have finished and
  94. cleaned up. Also, to save the rest of the tasks we have running,
  95. kill one of them, to clean up some space. Start with the reduce tasks,
  96. then go with the ones that have finished the least.
  97. Value in bytes.
  98. </td>
  99. </tr>
  100. <tr>
  101. <td><a name="mapred.tasktracker.expiry.interval">mapred.tasktracker.expiry.interval</a></td><td>600000</td><td>Expert: The time-interval, in miliseconds, after which
  102. a tasktracker is declared 'lost' if it doesn't send heartbeats.
  103. </td>
  104. </tr>
  105. <tr>
  106. <td><a name="mapred.tasktracker.instrumentation">mapred.tasktracker.instrumentation</a></td><td>org.apache.hadoop.mapred.TaskTrackerMetricsInst</td><td>Expert: The instrumentation class to associate with each TaskTracker.
  107. </td>
  108. </tr>
  109. <tr>
  110. <td><a name="mapred.tasktracker.vmem.reserved">mapred.tasktracker.vmem.reserved</a></td><td>-1</td><td>Configuration property to specify the amount of virtual memory
  111. that has to be reserved by the TaskTracker for system usage (OS, TT etc).
  112. The reserved virtual memory should be a part of the total virtual memory
  113. available on the TaskTracker.
  114. The reserved virtual memory and the total virtual memory values are
  115. reported by the TaskTracker as part of heart-beat so that they can
  116. considered by a scheduler. Please refer to the documentation of the
  117. configured scheduler to see how this property is used.
  118. These two values are also used by a TaskTracker for tracking tasks' memory
  119. usage. Memory management functionality on a TaskTracker is disabled if this
  120. property is set to -1, if it more than the total virtual memory on the
  121. tasktracker, or if either of the values is negative.
  122. </td>
  123. </tr>
  124. <tr>
  125. <td><a name="mapred.tasktracker.pmem.reserved">mapred.tasktracker.pmem.reserved</a></td><td>-1</td><td>Configuration property to specify the amount of physical memory
  126. that has to be reserved by the TaskTracker for system usage (OS, TT etc).
  127. The reserved physical memory should be a part of the total physical memory
  128. available on the TaskTracker.
  129. The reserved physical memory and the total physical memory values are
  130. reported by the TaskTracker as part of heart-beat so that they can
  131. considered by a scheduler. Please refer to the documentation of the
  132. configured scheduler to see how this property is used.
  133. </td>
  134. </tr>
  135. <tr>
  136. <td><a name="mapred.task.default.maxvmem">mapred.task.default.maxvmem</a></td><td>-1</td><td>
  137. Cluster-wide configuration in bytes to be set by the administrators that
  138. provides default amount of maximum virtual memory for job's tasks. This has
  139. to be set on both the JobTracker node for the sake of scheduling decisions
  140. and on the TaskTracker nodes for the sake of memory management.
  141. If a job doesn't specify its virtual memory requirement by setting
  142. mapred.task.maxvmem to -1, tasks are assured a memory limit set
  143. to this property. This property is set to -1 by default.
  144. This value should in general be less than the cluster-wide
  145. configuration mapred.task.limit.maxvmem. If not or if it is not set,
  146. TaskTracker's memory management will be disabled and a scheduler's memory
  147. based scheduling decisions may be affected. Please refer to the
  148. documentation of the configured scheduler to see how this property is used.
  149. </td>
  150. </tr>
  151. <tr>
  152. <td><a name="mapred.task.limit.maxvmem">mapred.task.limit.maxvmem</a></td><td>-1</td><td>
  153. Cluster-wide configuration in bytes to be set by the site administrators
  154. that provides an upper limit on the maximum virtual memory that can be
  155. specified by a job via mapred.task.maxvmem. This has to be set on both the
  156. JobTracker node for the sake of scheduling decisions and on the TaskTracker
  157. nodes for the sake of memory management.
  158. The job configuration mapred.task.maxvmem should not be more than this
  159. value, otherwise depending on the scheduler being configured, the job may
  160. be rejected or the job configuration may just be ignored. Please refer to
  161. the documentation of the configured scheduler to see how this property is
  162. used.
  163. If it is not set a TaskTracker, TaskTracker's memory management will be
  164. disabled.
  165. </td>
  166. </tr>
  167. <tr>
  168. <td><a name="mapred.task.maxvmem">mapred.task.maxvmem</a></td><td>-1</td><td>
  169. The maximum amount of virtual memory any task of a job will use, in bytes.
  170. This value will be used by TaskTrackers for monitoring the memory usage of
  171. tasks of this jobs. If a TaskTracker's memory management functionality is
  172. enabled, each task of this job will be allowed to use a maximum virtual
  173. memory specified by this property. If the task's memory usage goes over
  174. this value, the task will be failed by the TT. If not set, the
  175. cluster-wide configuration mapred.task.default.maxvmem is used as the
  176. default value for memory requirements. If this property cascaded with
  177. mapred.task.default.maxvmem becomes equal to -1, the job's tasks will
  178. not be assured any particular amount of virtual memory and may be killed by
  179. a TT that intends to control the total memory usage of the tasks via memory
  180. management functionality. If the memory management functionality is
  181. disabled on a TT, this value is ignored.
  182. This value should not be more than the cluster-wide configuration
  183. mapred.task.limit.maxvmem.
  184. This value may be used by schedulers that support scheduling based on job's
  185. memory requirements. Please refer to the documentation of the scheduler
  186. being configured to see if it does memory based scheduling and if it does,
  187. how this property is used by that scheduler.
  188. </td>
  189. </tr>
  190. <tr>
  191. <td><a name="mapred.task.maxpmem">mapred.task.maxpmem</a></td><td>-1</td><td>
  192. The maximum amount of physical memory any task of a job will use in bytes.
  193. This value may be used by schedulers that support scheduling based on job's
  194. memory requirements. In general, a task of this job will be scheduled on a
  195. TaskTracker, only if the amount of physical memory still unoccupied on the
  196. TaskTracker is greater than or equal to this value. Different schedulers can
  197. take different decisions, some might just ignore this value. Please refer to
  198. the documentation of the scheduler being configured to see if it does
  199. memory based scheduling and if it does, how this variable is used by that
  200. scheduler.
  201. </td>
  202. </tr>
  203. <tr>
  204. <td><a name="mapred.tasktracker.memory_calculator_plugin">mapred.tasktracker.memory_calculator_plugin</a></td><td></td><td>
  205. Name of the class whose instance will be used to query memory information
  206. on the tasktracker.
  207. The class must be an instance of
  208. org.apache.hadoop.util.MemoryCalculatorPlugin. If the value is null, the
  209. tasktracker attempts to use a class appropriate to the platform.
  210. Currently, the only platform supported is Linux.
  211. </td>
  212. </tr>
  213. <tr>
  214. <td><a name="mapred.tasktracker.taskmemorymanager.monitoring-interval">mapred.tasktracker.taskmemorymanager.monitoring-interval</a></td><td>5000</td><td>The interval, in milliseconds, for which the tasktracker waits
  215. between two cycles of monitoring its tasks' memory usage. Used only if
  216. tasks' memory management is enabled via mapred.tasktracker.tasks.maxmemory.
  217. </td>
  218. </tr>
  219. <tr>
  220. <td><a name="mapred.tasktracker.procfsbasedprocesstree.sleeptime-before-sigkill">mapred.tasktracker.procfsbasedprocesstree.sleeptime-before-sigkill</a></td><td>5000</td><td>The time, in milliseconds, the tasktracker waits for sending a
  221. SIGKILL to a process that has overrun memory limits, after it has been sent
  222. a SIGTERM. Used only if tasks' memory management is enabled via
  223. mapred.tasktracker.tasks.maxmemory.</td>
  224. </tr>
  225. <tr>
  226. <td><a name="mapred.map.tasks">mapred.map.tasks</a></td><td>2</td><td>The default number of map tasks per job. Typically set
  227. to a prime several times greater than number of available hosts.
  228. Ignored when mapred.job.tracker is "local".
  229. </td>
  230. </tr>
  231. <tr>
  232. <td><a name="mapred.reduce.tasks">mapred.reduce.tasks</a></td><td>1</td><td>The default number of reduce tasks per job. Typically set
  233. to a prime close to the number of available hosts. Ignored when
  234. mapred.job.tracker is "local".
  235. </td>
  236. </tr>
  237. <tr>
  238. <td><a name="mapred.jobtracker.restart.recover">mapred.jobtracker.restart.recover</a></td><td>false</td><td>"true" to enable (job) recovery upon restart,
  239. "false" to start afresh
  240. </td>
  241. </tr>
  242. <tr>
  243. <td><a name="mapred.jobtracker.job.history.block.size">mapred.jobtracker.job.history.block.size</a></td><td>3145728</td><td>The block size of the job history file. Since the job recovery
  244. uses job history, its important to dump job history to disk as
  245. soon as possible. Note that this is an expert level parameter.
  246. The default value is set to 3 MB.
  247. </td>
  248. </tr>
  249. <tr>
  250. <td><a name="mapred.jobtracker.taskScheduler">mapred.jobtracker.taskScheduler</a></td><td>org.apache.hadoop.mapred.JobQueueTaskScheduler</td><td>The class responsible for scheduling the tasks.</td>
  251. </tr>
  252. <tr>
  253. <td><a name="mapred.jobtracker.taskScheduler.maxRunningTasksPerJob">mapred.jobtracker.taskScheduler.maxRunningTasksPerJob</a></td><td></td><td>The maximum number of running tasks for a job before
  254. it gets preempted. No limits if undefined.
  255. </td>
  256. </tr>
  257. <tr>
  258. <td><a name="mapred.map.max.attempts">mapred.map.max.attempts</a></td><td>4</td><td>Expert: The maximum number of attempts per map task.
  259. In other words, framework will try to execute a map task these many number
  260. of times before giving up on it.
  261. </td>
  262. </tr>
  263. <tr>
  264. <td><a name="mapred.reduce.max.attempts">mapred.reduce.max.attempts</a></td><td>4</td><td>Expert: The maximum number of attempts per reduce task.
  265. In other words, framework will try to execute a reduce task these many number
  266. of times before giving up on it.
  267. </td>
  268. </tr>
  269. <tr>
  270. <td><a name="mapred.reduce.parallel.copies">mapred.reduce.parallel.copies</a></td><td>5</td><td>The default number of parallel transfers run by reduce
  271. during the copy(shuffle) phase.
  272. </td>
  273. </tr>
  274. <tr>
  275. <td><a name="mapred.reduce.copy.backoff">mapred.reduce.copy.backoff</a></td><td>300</td><td>The maximum amount of time (in seconds) a reducer spends on
  276. fetching one map output before declaring it as failed.
  277. </td>
  278. </tr>
  279. <tr>
  280. <td><a name="mapred.task.timeout">mapred.task.timeout</a></td><td>600000</td><td>The number of milliseconds before a task will be
  281. terminated if it neither reads an input, writes an output, nor
  282. updates its status string.
  283. </td>
  284. </tr>
  285. <tr>
  286. <td><a name="mapred.tasktracker.map.tasks.maximum">mapred.tasktracker.map.tasks.maximum</a></td><td>2</td><td>The maximum number of map tasks that will be run
  287. simultaneously by a task tracker.
  288. </td>
  289. </tr>
  290. <tr>
  291. <td><a name="mapred.tasktracker.reduce.tasks.maximum">mapred.tasktracker.reduce.tasks.maximum</a></td><td>2</td><td>The maximum number of reduce tasks that will be run
  292. simultaneously by a task tracker.
  293. </td>
  294. </tr>
  295. <tr>
  296. <td><a name="mapred.jobtracker.completeuserjobs.maximum">mapred.jobtracker.completeuserjobs.maximum</a></td><td>100</td><td>The maximum number of complete jobs per user to keep around
  297. before delegating them to the job history.</td>
  298. </tr>
  299. <tr>
  300. <td><a name="mapred.jobtracker.instrumentation">mapred.jobtracker.instrumentation</a></td><td>org.apache.hadoop.mapred.JobTrackerMetricsInst</td><td>Expert: The instrumentation class to associate with each JobTracker.
  301. </td>
  302. </tr>
  303. <tr>
  304. <td><a name="mapred.child.java.opts">mapred.child.java.opts</a></td><td>-Xmx200m</td><td>Java opts for the task tracker child processes.
  305. The following symbol, if present, will be interpolated: @taskid@ is replaced
  306. by current TaskID. Any other occurrences of '@' will go unchanged.
  307. For example, to enable verbose gc logging to a file named for the taskid in
  308. /tmp and to set the heap maximum to be a gigabyte, pass a 'value' of:
  309. -Xmx1024m -verbose:gc -Xloggc:/tmp/@taskid@.gc
  310. The configuration variable mapred.child.ulimit can be used to control the
  311. maximum virtual memory of the child processes.
  312. </td>
  313. </tr>
  314. <tr>
  315. <td><a name="mapred.child.ulimit">mapred.child.ulimit</a></td><td></td><td>The maximum virtual memory, in KB, of a process launched by the
  316. Map-Reduce framework. This can be used to control both the Mapper/Reducer
  317. tasks and applications using Hadoop Pipes, Hadoop Streaming etc.
  318. By default it is left unspecified to let cluster admins control it via
  319. limits.conf and other such relevant mechanisms.
  320. Note: mapred.child.ulimit must be greater than or equal to the -Xmx passed to
  321. JavaVM, else the VM might not start.
  322. </td>
  323. </tr>
  324. <tr>
  325. <td><a name="mapred.child.tmp">mapred.child.tmp</a></td><td>./tmp</td><td> To set the value of tmp directory for map and reduce tasks.
  326. If the value is an absolute path, it is directly assigned. Otherwise, it is
  327. prepended with task's working directory. The java tasks are executed with
  328. option -Djava.io.tmpdir='the absolute path of the tmp dir'. Pipes and
  329. streaming are set with environment variable,
  330. TMPDIR='the absolute path of the tmp dir'
  331. </td>
  332. </tr>
  333. <tr>
  334. <td><a name="mapred.inmem.merge.threshold">mapred.inmem.merge.threshold</a></td><td>1000</td><td>The threshold, in terms of the number of files
  335. for the in-memory merge process. When we accumulate threshold number of files
  336. we initiate the in-memory merge and spill to disk. A value of 0 or less than
  337. 0 indicates we want to DON'T have any threshold and instead depend only on
  338. the ramfs's memory consumption to trigger the merge.
  339. </td>
  340. </tr>
  341. <tr>
  342. <td><a name="mapred.job.shuffle.merge.percent">mapred.job.shuffle.merge.percent</a></td><td>0.66</td><td>The usage threshold at which an in-memory merge will be
  343. initiated, expressed as a percentage of the total memory allocated to
  344. storing in-memory map outputs, as defined by
  345. mapred.job.shuffle.input.buffer.percent.
  346. </td>
  347. </tr>
  348. <tr>
  349. <td><a name="mapred.job.shuffle.input.buffer.percent">mapred.job.shuffle.input.buffer.percent</a></td><td>0.70</td><td>The percentage of memory to be allocated from the maximum heap
  350. size to storing map outputs during the shuffle.
  351. </td>
  352. </tr>
  353. <tr>
  354. <td><a name="mapred.job.reduce.input.buffer.percent">mapred.job.reduce.input.buffer.percent</a></td><td>0.0</td><td>The percentage of memory- relative to the maximum heap size- to
  355. retain map outputs during the reduce. When the shuffle is concluded, any
  356. remaining map outputs in memory must consume less than this threshold before
  357. the reduce can begin.
  358. </td>
  359. </tr>
  360. <tr>
  361. <td><a name="mapred.map.tasks.speculative.execution">mapred.map.tasks.speculative.execution</a></td><td>true</td><td>If true, then multiple instances of some map tasks
  362. may be executed in parallel.</td>
  363. </tr>
  364. <tr>
  365. <td><a name="mapred.reduce.tasks.speculative.execution">mapred.reduce.tasks.speculative.execution</a></td><td>true</td><td>If true, then multiple instances of some reduce tasks
  366. may be executed in parallel.</td>
  367. </tr>
  368. <tr>
  369. <td><a name="mapred.job.reuse.jvm.num.tasks">mapred.job.reuse.jvm.num.tasks</a></td><td>1</td><td>How many tasks to run per jvm. If set to -1, there is
  370. no limit.
  371. </td>
  372. </tr>
  373. <tr>
  374. <td><a name="mapred.min.split.size">mapred.min.split.size</a></td><td>0</td><td>The minimum size chunk that map input should be split
  375. into. Note that some file formats may have minimum split sizes that
  376. take priority over this setting.</td>
  377. </tr>
  378. <tr>
  379. <td><a name="mapred.jobtracker.maxtasks.per.job">mapred.jobtracker.maxtasks.per.job</a></td><td>-1</td><td>The maximum number of tasks for a single job.
  380. A value of -1 indicates that there is no maximum. </td>
  381. </tr>
  382. <tr>
  383. <td><a name="mapred.submit.replication">mapred.submit.replication</a></td><td>10</td><td>The replication level for submitted job files. This
  384. should be around the square root of the number of nodes.
  385. </td>
  386. </tr>
  387. <tr>
  388. <td><a name="mapred.tasktracker.dns.interface">mapred.tasktracker.dns.interface</a></td><td>default</td><td>The name of the Network Interface from which a task
  389. tracker should report its IP address.
  390. </td>
  391. </tr>
  392. <tr>
  393. <td><a name="mapred.tasktracker.dns.nameserver">mapred.tasktracker.dns.nameserver</a></td><td>default</td><td>The host name or IP address of the name server (DNS)
  394. which a TaskTracker should use to determine the host name used by
  395. the JobTracker for communication and display purposes.
  396. </td>
  397. </tr>
  398. <tr>
  399. <td><a name="tasktracker.http.threads">tasktracker.http.threads</a></td><td>40</td><td>The number of worker threads that for the http server. This is
  400. used for map output fetching
  401. </td>
  402. </tr>
  403. <tr>
  404. <td><a name="mapred.task.tracker.http.address">mapred.task.tracker.http.address</a></td><td>0.0.0.0:50060</td><td>
  405. The task tracker http server address and port.
  406. If the port is 0 then the server will start on a free port.
  407. </td>
  408. </tr>
  409. <tr>
  410. <td><a name="keep.failed.task.files">keep.failed.task.files</a></td><td>false</td><td>Should the files for failed tasks be kept. This should only be
  411. used on jobs that are failing, because the storage is never
  412. reclaimed. It also prevents the map outputs from being erased
  413. from the reduce directory as they are consumed.</td>
  414. </tr>
  415. <tr>
  416. <td><a name="mapred.output.compress">mapred.output.compress</a></td><td>false</td><td>Should the job outputs be compressed?
  417. </td>
  418. </tr>
  419. <tr>
  420. <td><a name="mapred.output.compression.type">mapred.output.compression.type</a></td><td>RECORD</td><td>If the job outputs are to compressed as SequenceFiles, how should
  421. they be compressed? Should be one of NONE, RECORD or BLOCK.
  422. </td>
  423. </tr>
  424. <tr>
  425. <td><a name="mapred.output.compression.codec">mapred.output.compression.codec</a></td><td>org.apache.hadoop.io.compress.DefaultCodec</td><td>If the job outputs are compressed, how should they be compressed?
  426. </td>
  427. </tr>
  428. <tr>
  429. <td><a name="mapred.compress.map.output">mapred.compress.map.output</a></td><td>false</td><td>Should the outputs of the maps be compressed before being
  430. sent across the network. Uses SequenceFile compression.
  431. </td>
  432. </tr>
  433. <tr>
  434. <td><a name="mapred.map.output.compression.codec">mapred.map.output.compression.codec</a></td><td>org.apache.hadoop.io.compress.DefaultCodec</td><td>If the map outputs are compressed, how should they be
  435. compressed?
  436. </td>
  437. </tr>
  438. <tr>
  439. <td><a name="map.sort.class">map.sort.class</a></td><td>org.apache.hadoop.util.QuickSort</td><td>The default sort class for sorting keys.
  440. </td>
  441. </tr>
  442. <tr>
  443. <td><a name="mapred.userlog.limit.kb">mapred.userlog.limit.kb</a></td><td>0</td><td>The maximum size of user-logs of each task in KB. 0 disables the cap.
  444. </td>
  445. </tr>
  446. <tr>
  447. <td><a name="mapred.userlog.retain.hours">mapred.userlog.retain.hours</a></td><td>24</td><td>The maximum time, in hours, for which the user-logs are to be
  448. retained.
  449. </td>
  450. </tr>
  451. <tr>
  452. <td><a name="mapred.hosts">mapred.hosts</a></td><td></td><td>Names a file that contains the list of nodes that may
  453. connect to the jobtracker. If the value is empty, all hosts are
  454. permitted.</td>
  455. </tr>
  456. <tr>
  457. <td><a name="mapred.hosts.exclude">mapred.hosts.exclude</a></td><td></td><td>Names a file that contains the list of hosts that
  458. should be excluded by the jobtracker. If the value is empty, no
  459. hosts are excluded.</td>
  460. </tr>
  461. <tr>
  462. <td><a name="mapred.max.tracker.blacklists">mapred.max.tracker.blacklists</a></td><td>4</td><td>The number of blacklists for a taskTracker by various jobs
  463. after which the task tracker could be blacklisted across
  464. all jobs. The tracker will be given a tasks later
  465. (after a day). The tracker will become a healthy
  466. tracker after a restart.
  467. </td>
  468. </tr>
  469. <tr>
  470. <td><a name="mapred.max.tracker.failures">mapred.max.tracker.failures</a></td><td>4</td><td>The number of task-failures on a tasktracker of a given job
  471. after which new tasks of that job aren't assigned to it.
  472. </td>
  473. </tr>
  474. <tr>
  475. <td><a name="jobclient.output.filter">jobclient.output.filter</a></td><td>FAILED</td><td>The filter for controlling the output of the task's userlogs sent
  476. to the console of the JobClient.
  477. The permissible options are: NONE, KILLED, FAILED, SUCCEEDED and
  478. ALL.
  479. </td>
  480. </tr>
  481. <tr>
  482. <td><a name="mapred.job.tracker.persist.jobstatus.active">mapred.job.tracker.persist.jobstatus.active</a></td><td>false</td><td>Indicates if persistency of job status information is
  483. active or not.
  484. </td>
  485. </tr>
  486. <tr>
  487. <td><a name="mapred.job.tracker.persist.jobstatus.hours">mapred.job.tracker.persist.jobstatus.hours</a></td><td>0</td><td>The number of hours job status information is persisted in DFS.
  488. The job status information will be available after it drops of the memory
  489. queue and between jobtracker restarts. With a zero value the job status
  490. information is not persisted at all in DFS.
  491. </td>
  492. </tr>
  493. <tr>
  494. <td><a name="mapred.job.tracker.persist.jobstatus.dir">mapred.job.tracker.persist.jobstatus.dir</a></td><td>/jobtracker/jobsInfo</td><td>The directory where the job status information is persisted
  495. in a file system to be available after it drops of the memory queue and
  496. between jobtracker restarts.
  497. </td>
  498. </tr>
  499. <tr>
  500. <td><a name="mapred.task.profile">mapred.task.profile</a></td><td>false</td><td>To set whether the system should collect profiler
  501. information for some of the tasks in this job? The information is stored
  502. in the user log directory. The value is "true" if task profiling
  503. is enabled.</td>
  504. </tr>
  505. <tr>
  506. <td><a name="mapred.task.profile.maps">mapred.task.profile.maps</a></td><td>0-2</td><td> To set the ranges of map tasks to profile.
  507. mapred.task.profile has to be set to true for the value to be accounted.
  508. </td>
  509. </tr>
  510. <tr>
  511. <td><a name="mapred.task.profile.reduces">mapred.task.profile.reduces</a></td><td>0-2</td><td> To set the ranges of reduce tasks to profile.
  512. mapred.task.profile has to be set to true for the value to be accounted.
  513. </td>
  514. </tr>
  515. <tr>
  516. <td><a name="mapred.line.input.format.linespermap">mapred.line.input.format.linespermap</a></td><td>1</td><td> Number of lines per split in NLineInputFormat.
  517. </td>
  518. </tr>
  519. <tr>
  520. <td><a name="mapred.skip.attempts.to.start.skipping">mapred.skip.attempts.to.start.skipping</a></td><td>2</td><td> The number of Task attempts AFTER which skip mode
  521. will be kicked off. When skip mode is kicked off, the
  522. tasks reports the range of records which it will process
  523. next, to the TaskTracker. So that on failures, TT knows which
  524. ones are possibly the bad records. On further executions,
  525. those are skipped.
  526. </td>
  527. </tr>
  528. <tr>
  529. <td><a name="mapred.skip.map.auto.incr.proc.count">mapred.skip.map.auto.incr.proc.count</a></td><td>true</td><td> The flag which if set to true,
  530. SkipBadRecords.COUNTER_MAP_PROCESSED_RECORDS is incremented
  531. by MapRunner after invoking the map function. This value must be set to
  532. false for applications which process the records asynchronously
  533. or buffer the input records. For example streaming.
  534. In such cases applications should increment this counter on their own.
  535. </td>
  536. </tr>
  537. <tr>
  538. <td><a name="mapred.skip.reduce.auto.incr.proc.count">mapred.skip.reduce.auto.incr.proc.count</a></td><td>true</td><td> The flag which if set to true,
  539. SkipBadRecords.COUNTER_REDUCE_PROCESSED_GROUPS is incremented
  540. by framework after invoking the reduce function. This value must be set to
  541. false for applications which process the records asynchronously
  542. or buffer the input records. For example streaming.
  543. In such cases applications should increment this counter on their own.
  544. </td>
  545. </tr>
  546. <tr>
  547. <td><a name="mapred.skip.out.dir">mapred.skip.out.dir</a></td><td></td><td> If no value is specified here, the skipped records are
  548. written to the output directory at _logs/skip.
  549. User can stop writing skipped records by giving the value "none".
  550. </td>
  551. </tr>
  552. <tr>
  553. <td><a name="mapred.skip.map.max.skip.records">mapred.skip.map.max.skip.records</a></td><td>0</td><td> The number of acceptable skip records surrounding the bad
  554. record PER bad record in mapper. The number includes the bad record as well.
  555. To turn the feature of detection/skipping of bad records off, set the
  556. value to 0.
  557. The framework tries to narrow down the skipped range by retrying
  558. until this threshold is met OR all attempts get exhausted for this task.
  559. Set the value to Long.MAX_VALUE to indicate that framework need not try to
  560. narrow down. Whatever records(depends on application) get skipped are
  561. acceptable.
  562. </td>
  563. </tr>
  564. <tr>
  565. <td><a name="mapred.skip.reduce.max.skip.groups">mapred.skip.reduce.max.skip.groups</a></td><td>0</td><td> The number of acceptable skip groups surrounding the bad
  566. group PER bad group in reducer. The number includes the bad group as well.
  567. To turn the feature of detection/skipping of bad groups off, set the
  568. value to 0.
  569. The framework tries to narrow down the skipped range by retrying
  570. until this threshold is met OR all attempts get exhausted for this task.
  571. Set the value to Long.MAX_VALUE to indicate that framework need not try to
  572. narrow down. Whatever groups(depends on application) get skipped are
  573. acceptable.
  574. </td>
  575. </tr>
  576. <tr>
  577. <td><a name="job.end.retry.attempts">job.end.retry.attempts</a></td><td>0</td><td>Indicates how many times hadoop should attempt to contact the
  578. notification URL </td>
  579. </tr>
  580. <tr>
  581. <td><a name="job.end.retry.interval">job.end.retry.interval</a></td><td>30000</td><td>Indicates time in milliseconds between notification URL retry
  582. calls</td>
  583. </tr>
  584. <tr>
  585. <td><a name="hadoop.rpc.socket.factory.class.JobSubmissionProtocol">hadoop.rpc.socket.factory.class.JobSubmissionProtocol</a></td><td></td><td> SocketFactory to use to connect to a Map/Reduce master
  586. (JobTracker). If null or empty, then use hadoop.rpc.socket.class.default.
  587. </td>
  588. </tr>
  589. <tr>
  590. <td><a name="mapred.task.cache.levels">mapred.task.cache.levels</a></td><td>2</td><td> This is the max level of the task cache. For example, if
  591. the level is 2, the tasks cached are at the host level and at the rack
  592. level.
  593. </td>
  594. </tr>
  595. <tr>
  596. <td><a name="mapred.queue.names">mapred.queue.names</a></td><td>default</td><td> Comma separated list of queues configured for this jobtracker.
  597. Jobs are added to queues and schedulers can configure different
  598. scheduling properties for the various queues. To configure a property
  599. for a queue, the name of the queue must match the name specified in this
  600. value. Queue properties that are common to all schedulers are configured
  601. here with the naming convention, mapred.queue.$QUEUE-NAME.$PROPERTY-NAME,
  602. for e.g. mapred.queue.default.submit-job-acl.
  603. The number of queues configured in this parameter could depend on the
  604. type of scheduler being used, as specified in
  605. mapred.jobtracker.taskScheduler. For example, the JobQueueTaskScheduler
  606. supports only a single queue, which is the default configured here.
  607. Before adding more queues, ensure that the scheduler you've configured
  608. supports multiple queues.
  609. </td>
  610. </tr>
  611. <tr>
  612. <td><a name="mapred.acls.enabled">mapred.acls.enabled</a></td><td>false</td><td> Specifies whether ACLs are enabled, and should be checked
  613. for various operations.
  614. </td>
  615. </tr>
  616. <tr>
  617. <td><a name="mapred.queue.default.acl-submit-job">mapred.queue.default.acl-submit-job</a></td><td>*</td><td> Comma separated list of user and group names that are allowed
  618. to submit jobs to the 'default' queue. The user list and the group list
  619. are separated by a blank. For e.g. alice,bob group1,group2.
  620. If set to the special value '*', it means all users are allowed to
  621. submit jobs.
  622. </td>
  623. </tr>
  624. <tr>
  625. <td><a name="mapred.queue.default.acl-administer-jobs">mapred.queue.default.acl-administer-jobs</a></td><td>*</td><td> Comma separated list of user and group names that are allowed
  626. to delete jobs or modify job's priority for jobs not owned by the current
  627. user in the 'default' queue. The user list and the group list
  628. are separated by a blank. For e.g. alice,bob group1,group2.
  629. If set to the special value '*', it means all users are allowed to do
  630. this operation.
  631. </td>
  632. </tr>
  633. <tr>
  634. <td><a name="mapred.job.queue.name">mapred.job.queue.name</a></td><td>default</td><td> Queue to which a job is submitted. This must match one of the
  635. queues defined in mapred.queue.names for the system. Also, the ACL setup
  636. for the queue must allow the current user to submit a job to the queue.
  637. Before specifying a queue, ensure that the system is configured with
  638. the queue, and access is allowed for submitting jobs to the queue.
  639. </td>
  640. </tr>
  641. <tr>
  642. <td><a name="mapred.tasktracker.indexcache.mb">mapred.tasktracker.indexcache.mb</a></td><td>10</td><td> The maximum memory that a task tracker allows for the
  643. index cache that is used when serving map outputs to reducers.
  644. </td>
  645. </tr>
  646. <tr>
  647. <td><a name="mapred.merge.recordsBeforeProgress">mapred.merge.recordsBeforeProgress</a></td><td>10000</td><td> The number of records to process during merge before
  648. sending a progress notification to the TaskTracker.
  649. </td>
  650. </tr>
  651. </table>
  652. </body>
  653. </html>