mapred-default.xml 40 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145
  1. <?xml version="1.0"?>
  2. <!--
  3. Licensed to the Apache Software Foundation (ASF) under one or more
  4. contributor license agreements. See the NOTICE file distributed with
  5. this work for additional information regarding copyright ownership.
  6. The ASF licenses this file to You under the Apache License, Version 2.0
  7. (the "License"); you may not use this file except in compliance with
  8. the License. You may obtain a copy of the License at
  9. http://www.apache.org/licenses/LICENSE-2.0
  10. Unless required by applicable law or agreed to in writing, software
  11. distributed under the License is distributed on an "AS IS" BASIS,
  12. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. See the License for the specific language governing permissions and
  14. limitations under the License.
  15. -->
  16. <?xml-stylesheet type="text/xsl" href="configuration.xsl"?>
  17. <!-- Do not modify this file directly. Instead, copy entries that you -->
  18. <!-- wish to modify from this file into mapred-site.xml and change them -->
  19. <!-- there. If mapred-site.xml does not already exist, create it. -->
  20. <configuration>
  21. <property>
  22. <name>mapreduce.jobtracker.jobhistory.location</name>
  23. <value></value>
  24. <description> If job tracker is static the history files are stored
  25. in this single well known place. If No value is set here, by default,
  26. it is in the local file system at ${hadoop.log.dir}/history.
  27. </description>
  28. </property>
  29. <property>
  30. <name>mapreduce.jobtracker.jobhistory.task.numberprogresssplits</name>
  31. <value>12</value>
  32. <description> Every task attempt progresses from 0.0 to 1.0 [unless
  33. it fails or is killed]. We record, for each task attempt, certain
  34. statistics over each twelfth of the progress range. You can change
  35. the number of intervals we divide the entire range of progress into
  36. by setting this property. Higher values give more precision to the
  37. recorded data, but costs more memory in the job tracker at runtime.
  38. Each increment in this attribute costs 16 bytes per running task.
  39. </description>
  40. </property>
  41. <property>
  42. <name>mapreduce.job.userhistorylocation</name>
  43. <value></value>
  44. <description> User can specify a location to store the history files of
  45. a particular job. If nothing is specified, the logs are stored in
  46. output directory. The files are stored in "_logs/history/" in the directory.
  47. User can stop logging by giving the value "none".
  48. </description>
  49. </property>
  50. <property>
  51. <name>mapreduce.jobtracker.jobhistory.completed.location</name>
  52. <value></value>
  53. <description> The completed job history files are stored at this single well
  54. known location. If nothing is specified, the files are stored at
  55. ${mapreduce.jobtracker.jobhistory.location}/done.
  56. </description>
  57. </property>
  58. <property>
  59. <name>mapreduce.job.committer.setup.cleanup.needed</name>
  60. <value>true</value>
  61. <description> true, if job needs job-setup and job-cleanup.
  62. false, otherwise
  63. </description>
  64. </property>
  65. <!-- i/o properties -->
  66. <property>
  67. <name>mapreduce.task.io.sort.factor</name>
  68. <value>10</value>
  69. <description>The number of streams to merge at once while sorting
  70. files. This determines the number of open file handles.</description>
  71. </property>
  72. <property>
  73. <name>mapreduce.task.io.sort.mb</name>
  74. <value>100</value>
  75. <description>The total amount of buffer memory to use while sorting
  76. files, in megabytes. By default, gives each merge stream 1MB, which
  77. should minimize seeks.</description>
  78. </property>
  79. <property>
  80. <name>mapreduce.map.sort.spill.percent</name>
  81. <value>0.80</value>
  82. <description>The soft limit in the serialization buffer. Once reached, a
  83. thread will begin to spill the contents to disk in the background. Note that
  84. collection will not block if this threshold is exceeded while a spill is
  85. already in progress, so spills may be larger than this threshold when it is
  86. set to less than .5</description>
  87. </property>
  88. <property>
  89. <name>mapreduce.jobtracker.address</name>
  90. <value>local</value>
  91. <description>The host and port that the MapReduce job tracker runs
  92. at. If "local", then jobs are run in-process as a single map
  93. and reduce task.
  94. </description>
  95. </property>
  96. <property>
  97. <name>mapreduce.jobtracker.http.address</name>
  98. <value>0.0.0.0:50030</value>
  99. <description>
  100. The job tracker http server address and port the server will listen on.
  101. If the port is 0 then the server will start on a free port.
  102. </description>
  103. </property>
  104. <property>
  105. <name>mapreduce.jobtracker.handler.count</name>
  106. <value>10</value>
  107. <description>
  108. The number of server threads for the JobTracker. This should be roughly
  109. 4% of the number of tasktracker nodes.
  110. </description>
  111. </property>
  112. <property>
  113. <name>mapreduce.tasktracker.report.address</name>
  114. <value>127.0.0.1:0</value>
  115. <description>The interface and port that task tracker server listens on.
  116. Since it is only connected to by the tasks, it uses the local interface.
  117. EXPERT ONLY. Should only be changed if your host does not have the loopback
  118. interface.</description>
  119. </property>
  120. <property>
  121. <name>mapreduce.cluster.local.dir</name>
  122. <value>${hadoop.tmp.dir}/mapred/local</value>
  123. <description>The local directory where MapReduce stores intermediate
  124. data files. May be a comma-separated list of
  125. directories on different devices in order to spread disk i/o.
  126. Directories that do not exist are ignored.
  127. </description>
  128. </property>
  129. <property>
  130. <name>mapreduce.jobtracker.system.dir</name>
  131. <value>${hadoop.tmp.dir}/mapred/system</value>
  132. <description>The directory where MapReduce stores control files.
  133. </description>
  134. </property>
  135. <property>
  136. <name>mapreduce.jobtracker.staging.root.dir</name>
  137. <value>${hadoop.tmp.dir}/mapred/staging</value>
  138. <description>The root of the staging area for users' job files
  139. In practice, this should be the directory where users' home
  140. directories are located (usually /user)
  141. </description>
  142. </property>
  143. <property>
  144. <name>mapreduce.cluster.temp.dir</name>
  145. <value>${hadoop.tmp.dir}/mapred/temp</value>
  146. <description>A shared directory for temporary files.
  147. </description>
  148. </property>
  149. <property>
  150. <name>mapreduce.tasktracker.local.dir.minspacestart</name>
  151. <value>0</value>
  152. <description>If the space in mapreduce.cluster.local.dir drops under this,
  153. do not ask for more tasks.
  154. Value in bytes.
  155. </description>
  156. </property>
  157. <property>
  158. <name>mapreduce.tasktracker.local.dir.minspacekill</name>
  159. <value>0</value>
  160. <description>If the space in mapreduce.cluster.local.dir drops under this,
  161. do not ask more tasks until all the current ones have finished and
  162. cleaned up. Also, to save the rest of the tasks we have running,
  163. kill one of them, to clean up some space. Start with the reduce tasks,
  164. then go with the ones that have finished the least.
  165. Value in bytes.
  166. </description>
  167. </property>
  168. <property>
  169. <name>mapreduce.jobtracker.expire.trackers.interval</name>
  170. <value>600000</value>
  171. <description>Expert: The time-interval, in miliseconds, after which
  172. a tasktracker is declared 'lost' if it doesn't send heartbeats.
  173. </description>
  174. </property>
  175. <property>
  176. <name>mapreduce.tasktracker.instrumentation</name>
  177. <value>org.apache.hadoop.mapred.TaskTrackerMetricsInst</value>
  178. <description>Expert: The instrumentation class to associate with each TaskTracker.
  179. </description>
  180. </property>
  181. <property>
  182. <name>mapreduce.tasktracker.resourcecalculatorplugin</name>
  183. <value></value>
  184. <description>
  185. Name of the class whose instance will be used to query resource information
  186. on the tasktracker.
  187. The class must be an instance of
  188. org.apache.hadoop.util.ResourceCalculatorPlugin. If the value is null, the
  189. tasktracker attempts to use a class appropriate to the platform.
  190. Currently, the only platform supported is Linux.
  191. </description>
  192. </property>
  193. <property>
  194. <name>mapreduce.tasktracker.taskmemorymanager.monitoringinterval</name>
  195. <value>5000</value>
  196. <description>The interval, in milliseconds, for which the tasktracker waits
  197. between two cycles of monitoring its tasks' memory usage. Used only if
  198. tasks' memory management is enabled via mapred.tasktracker.tasks.maxmemory.
  199. </description>
  200. </property>
  201. <property>
  202. <name>mapreduce.tasktracker.tasks.sleeptimebeforesigkill</name>
  203. <value>5000</value>
  204. <description>The time, in milliseconds, the tasktracker waits for sending a
  205. SIGKILL to a task, after it has been sent a SIGTERM. This is currently
  206. not used on WINDOWS where tasks are just sent a SIGTERM.
  207. </description>
  208. </property>
  209. <property>
  210. <name>mapreduce.job.maps</name>
  211. <value>2</value>
  212. <description>The default number of map tasks per job.
  213. Ignored when mapreduce.jobtracker.address is "local".
  214. </description>
  215. </property>
  216. <property>
  217. <name>mapreduce.job.reduces</name>
  218. <value>1</value>
  219. <description>The default number of reduce tasks per job. Typically set to 99%
  220. of the cluster's reduce capacity, so that if a node fails the reduces can
  221. still be executed in a single wave.
  222. Ignored when mapreduce.jobtracker.address is "local".
  223. </description>
  224. </property>
  225. <property>
  226. <name>mapreduce.jobtracker.restart.recover</name>
  227. <value>false</value>
  228. <description>"true" to enable (job) recovery upon restart,
  229. "false" to start afresh
  230. </description>
  231. </property>
  232. <property>
  233. <name>mapreduce.jobtracker.jobhistory.block.size</name>
  234. <value>3145728</value>
  235. <description>The block size of the job history file. Since the job recovery
  236. uses job history, its important to dump job history to disk as
  237. soon as possible. Note that this is an expert level parameter.
  238. The default value is set to 3 MB.
  239. </description>
  240. </property>
  241. <property>
  242. <name>mapreduce.jobtracker.taskscheduler</name>
  243. <value>org.apache.hadoop.mapred.JobQueueTaskScheduler</value>
  244. <description>The class responsible for scheduling the tasks.</description>
  245. </property>
  246. <property>
  247. <name>mapreduce.jobtracker.split.metainfo.maxsize</name>
  248. <value>10000000</value>
  249. <description>The maximum permissible size of the split metainfo file.
  250. The JobTracker won't attempt to read split metainfo files bigger than
  251. the configured value.
  252. No limits if set to -1.
  253. </description>
  254. </property>
  255. <property>
  256. <name>mapreduce.jobtracker.taskscheduler.maxrunningtasks.perjob</name>
  257. <value></value>
  258. <description>The maximum number of running tasks for a job before
  259. it gets preempted. No limits if undefined.
  260. </description>
  261. </property>
  262. <property>
  263. <name>mapreduce.map.maxattempts</name>
  264. <value>4</value>
  265. <description>Expert: The maximum number of attempts per map task.
  266. In other words, framework will try to execute a map task these many number
  267. of times before giving up on it.
  268. </description>
  269. </property>
  270. <property>
  271. <name>mapreduce.reduce.maxattempts</name>
  272. <value>4</value>
  273. <description>Expert: The maximum number of attempts per reduce task.
  274. In other words, framework will try to execute a reduce task these many number
  275. of times before giving up on it.
  276. </description>
  277. </property>
  278. <property>
  279. <name>mapreduce.reduce.shuffle.parallelcopies</name>
  280. <value>5</value>
  281. <description>The default number of parallel transfers run by reduce
  282. during the copy(shuffle) phase.
  283. </description>
  284. </property>
  285. <property>
  286. <name>mapreduce.reduce.shuffle.connect.timeout</name>
  287. <value>180000</value>
  288. <description>Expert: The maximum amount of time (in milli seconds) reduce
  289. task spends in trying to connect to a tasktracker for getting map output.
  290. </description>
  291. </property>
  292. <property>
  293. <name>mapreduce.reduce.shuffle.read.timeout</name>
  294. <value>180000</value>
  295. <description>Expert: The maximum amount of time (in milli seconds) reduce
  296. task waits for map output data to be available for reading after obtaining
  297. connection.
  298. </description>
  299. </property>
  300. <property>
  301. <name>mapreduce.task.timeout</name>
  302. <value>600000</value>
  303. <description>The number of milliseconds before a task will be
  304. terminated if it neither reads an input, writes an output, nor
  305. updates its status string.
  306. </description>
  307. </property>
  308. <property>
  309. <name>mapreduce.tasktracker.map.tasks.maximum</name>
  310. <value>2</value>
  311. <description>The maximum number of map tasks that will be run
  312. simultaneously by a task tracker.
  313. </description>
  314. </property>
  315. <property>
  316. <name>mapreduce.tasktracker.reduce.tasks.maximum</name>
  317. <value>2</value>
  318. <description>The maximum number of reduce tasks that will be run
  319. simultaneously by a task tracker.
  320. </description>
  321. </property>
  322. <property>
  323. <name>mapreduce.jobtracker.retiredjobs.cache.size</name>
  324. <value>1000</value>
  325. <description>The number of retired job status to keep in the cache.
  326. </description>
  327. </property>
  328. <property>
  329. <name>mapreduce.tasktracker.outofband.heartbeat</name>
  330. <value>false</value>
  331. <description>Expert: Set this to true to let the tasktracker send an
  332. out-of-band heartbeat on task-completion for better latency.
  333. </description>
  334. </property>
  335. <property>
  336. <name>mapreduce.jobtracker.jobhistory.lru.cache.size</name>
  337. <value>5</value>
  338. <description>The number of job history files loaded in memory. The jobs are
  339. loaded when they are first accessed. The cache is cleared based on LRU.
  340. </description>
  341. </property>
  342. <property>
  343. <name>mapreduce.jobtracker.instrumentation</name>
  344. <value>org.apache.hadoop.mapred.JobTrackerMetricsInst</value>
  345. <description>Expert: The instrumentation class to associate with each JobTracker.
  346. </description>
  347. </property>
  348. <property>
  349. <name>mapred.child.java.opts</name>
  350. <value>-Xmx200m</value>
  351. <description>Java opts for the task tracker child processes.
  352. The following symbol, if present, will be interpolated: @taskid@ is replaced
  353. by current TaskID. Any other occurrences of '@' will go unchanged.
  354. For example, to enable verbose gc logging to a file named for the taskid in
  355. /tmp and to set the heap maximum to be a gigabyte, pass a 'value' of:
  356. -Xmx1024m -verbose:gc -Xloggc:/tmp/@taskid@.gc
  357. The configuration variable mapred.child.ulimit can be used to control the
  358. maximum virtual memory of the child processes.
  359. </description>
  360. </property>
  361. <property>
  362. <name>mapred.child.env</name>
  363. <value></value>
  364. <description>User added environment variables for the task tracker child
  365. processes. Example :
  366. 1) A=foo This will set the env variable A to foo
  367. 2) B=$B:c This is inherit tasktracker's B env variable.
  368. </description>
  369. </property>
  370. <property>
  371. <name>mapred.child.ulimit</name>
  372. <value></value>
  373. <description>The maximum virtual memory, in KB, of a process launched by the
  374. Map-Reduce framework. This can be used to control both the Mapper/Reducer
  375. tasks and applications using Hadoop Pipes, Hadoop Streaming etc.
  376. By default it is left unspecified to let cluster admins control it via
  377. limits.conf and other such relevant mechanisms.
  378. Note: mapred.child.ulimit must be greater than or equal to the -Xmx passed to
  379. JavaVM, else the VM might not start.
  380. </description>
  381. </property>
  382. <property>
  383. <name>mapreduce.map.log.level</name>
  384. <value>INFO</value>
  385. <description>The logging level for the map task. The allowed levels are:
  386. OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE and ALL.
  387. </description>
  388. </property>
  389. <property>
  390. <name>mapreduce.reduce.log.level</name>
  391. <value>INFO</value>
  392. <description>The logging level for the reduce task. The allowed levels are:
  393. OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE and ALL.
  394. </description>
  395. </property>
  396. <property>
  397. <name>mapreduce.reduce.merge.inmem.threshold</name>
  398. <value>1000</value>
  399. <description>The threshold, in terms of the number of files
  400. for the in-memory merge process. When we accumulate threshold number of files
  401. we initiate the in-memory merge and spill to disk. A value of 0 or less than
  402. 0 indicates we want to DON'T have any threshold and instead depend only on
  403. the ramfs's memory consumption to trigger the merge.
  404. </description>
  405. </property>
  406. <property>
  407. <name>mapreduce.reduce.shuffle.merge.percent</name>
  408. <value>0.66</value>
  409. <description>The usage threshold at which an in-memory merge will be
  410. initiated, expressed as a percentage of the total memory allocated to
  411. storing in-memory map outputs, as defined by
  412. mapreduce.reduce.shuffle.input.buffer.percent.
  413. </description>
  414. </property>
  415. <property>
  416. <name>mapreduce.reduce.shuffle.input.buffer.percent</name>
  417. <value>0.70</value>
  418. <description>The percentage of memory to be allocated from the maximum heap
  419. size to storing map outputs during the shuffle.
  420. </description>
  421. </property>
  422. <property>
  423. <name>mapreduce.reduce.input.buffer.percent</name>
  424. <value>0.0</value>
  425. <description>The percentage of memory- relative to the maximum heap size- to
  426. retain map outputs during the reduce. When the shuffle is concluded, any
  427. remaining map outputs in memory must consume less than this threshold before
  428. the reduce can begin.
  429. </description>
  430. </property>
  431. <property>
  432. <name>mapreduce.reduce.markreset.buffer.percent</name>
  433. <value>0.0</value>
  434. <description>The percentage of memory -relative to the maximum heap size- to
  435. be used for caching values when using the mark-reset functionality.
  436. </description>
  437. </property>
  438. <property>
  439. <name>mapreduce.map.speculative</name>
  440. <value>true</value>
  441. <description>If true, then multiple instances of some map tasks
  442. may be executed in parallel.</description>
  443. </property>
  444. <property>
  445. <name>mapreduce.reduce.speculative</name>
  446. <value>true</value>
  447. <description>If true, then multiple instances of some reduce tasks
  448. may be executed in parallel.</description>
  449. </property>
  450. <property>
  451. <name>mapreduce.job.speculative.speculativecap</name>
  452. <value>0.1</value>
  453. <description>The max percent (0-1) of running tasks that
  454. can be speculatively re-executed at any time.</description>
  455. </property>
  456. <property>
  457. <name>mapreduce.job.speculative.slowtaskthreshold</name>
  458. <value>1.0</value>The number of standard deviations by which a task's
  459. ave progress-rates must be lower than the average of all running tasks'
  460. for the task to be considered too slow.
  461. <description>
  462. </description>
  463. </property>
  464. <property>
  465. <name>mapreduce.job.speculative.slownodethreshold</name>
  466. <value>1.0</value>
  467. <description>The number of standard deviations by which a Task
  468. Tracker's ave map and reduce progress-rates (finishTime-dispatchTime)
  469. must be lower than the average of all successful map/reduce task's for
  470. the TT to be considered too slow to give a speculative task to.
  471. </description>
  472. </property>
  473. <property>
  474. <name>mapreduce.job.jvm.numtasks</name>
  475. <value>1</value>
  476. <description>How many tasks to run per jvm. If set to -1, there is
  477. no limit.
  478. </description>
  479. </property>
  480. <property>
  481. <name>mapreduce.input.fileinputformat.split.minsize</name>
  482. <value>0</value>
  483. <description>The minimum size chunk that map input should be split
  484. into. Note that some file formats may have minimum split sizes that
  485. take priority over this setting.</description>
  486. </property>
  487. <property>
  488. <name>mapreduce.jobtracker.maxtasks.perjob</name>
  489. <value>-1</value>
  490. <description>The maximum number of tasks for a single job.
  491. A value of -1 indicates that there is no maximum. </description>
  492. </property>
  493. <property>
  494. <name>mapreduce.client.submit.file.replication</name>
  495. <value>10</value>
  496. <description>The replication level for submitted job files. This
  497. should be around the square root of the number of nodes.
  498. </description>
  499. </property>
  500. <property>
  501. <name>mapreduce.tasktracker.dns.interface</name>
  502. <value>default</value>
  503. <description>The name of the Network Interface from which a task
  504. tracker should report its IP address.
  505. </description>
  506. </property>
  507. <property>
  508. <name>mapreduce.tasktracker.dns.nameserver</name>
  509. <value>default</value>
  510. <description>The host name or IP address of the name server (DNS)
  511. which a TaskTracker should use to determine the host name used by
  512. the JobTracker for communication and display purposes.
  513. </description>
  514. </property>
  515. <property>
  516. <name>mapreduce.tasktracker.http.threads</name>
  517. <value>40</value>
  518. <description>The number of worker threads that for the http server. This is
  519. used for map output fetching
  520. </description>
  521. </property>
  522. <property>
  523. <name>mapreduce.tasktracker.http.address</name>
  524. <value>0.0.0.0:50060</value>
  525. <description>
  526. The task tracker http server address and port.
  527. If the port is 0 then the server will start on a free port.
  528. </description>
  529. </property>
  530. <property>
  531. <name>mapreduce.task.files.preserve.failedtasks</name>
  532. <value>false</value>
  533. <description>Should the files for failed tasks be kept. This should only be
  534. used on jobs that are failing, because the storage is never
  535. reclaimed. It also prevents the map outputs from being erased
  536. from the reduce directory as they are consumed.</description>
  537. </property>
  538. <!--
  539. <property>
  540. <name>mapreduce.task.files.preserve.filepattern</name>
  541. <value>.*_m_123456_0</value>
  542. <description>Keep all files from tasks whose task names match the given
  543. regular expression. Defaults to none.</description>
  544. </property>
  545. -->
  546. <property>
  547. <name>mapreduce.output.fileoutputformat.compress</name>
  548. <value>false</value>
  549. <description>Should the job outputs be compressed?
  550. </description>
  551. </property>
  552. <property>
  553. <name>mapreduce.output.fileoutputformat.compression.type</name>
  554. <value>RECORD</value>
  555. <description>If the job outputs are to compressed as SequenceFiles, how should
  556. they be compressed? Should be one of NONE, RECORD or BLOCK.
  557. </description>
  558. </property>
  559. <property>
  560. <name>mapreduce.output.fileoutputformat.compression.codec</name>
  561. <value>org.apache.hadoop.io.compress.DefaultCodec</value>
  562. <description>If the job outputs are compressed, how should they be compressed?
  563. </description>
  564. </property>
  565. <property>
  566. <name>mapreduce.map.output.compress</name>
  567. <value>false</value>
  568. <description>Should the outputs of the maps be compressed before being
  569. sent across the network. Uses SequenceFile compression.
  570. </description>
  571. </property>
  572. <property>
  573. <name>mapreduce.map.output.compress.codec</name>
  574. <value>org.apache.hadoop.io.compress.DefaultCodec</value>
  575. <description>If the map outputs are compressed, how should they be
  576. compressed?
  577. </description>
  578. </property>
  579. <property>
  580. <name>map.sort.class</name>
  581. <value>org.apache.hadoop.util.QuickSort</value>
  582. <description>The default sort class for sorting keys.
  583. </description>
  584. </property>
  585. <property>
  586. <name>mapreduce.task.userlog.limit.kb</name>
  587. <value>0</value>
  588. <description>The maximum size of user-logs of each task in KB. 0 disables the cap.
  589. </description>
  590. </property>
  591. <property>
  592. <name>mapreduce.job.userlog.retain.hours</name>
  593. <value>24</value>
  594. <description>The maximum time, in hours, for which the user-logs are to be
  595. retained after the job completion.
  596. </description>
  597. </property>
  598. <property>
  599. <name>mapreduce.jobtracker.hosts.filename</name>
  600. <value></value>
  601. <description>Names a file that contains the list of nodes that may
  602. connect to the jobtracker. If the value is empty, all hosts are
  603. permitted.</description>
  604. </property>
  605. <property>
  606. <name>mapreduce.jobtracker.hosts.exclude.filename</name>
  607. <value></value>
  608. <description>Names a file that contains the list of hosts that
  609. should be excluded by the jobtracker. If the value is empty, no
  610. hosts are excluded.</description>
  611. </property>
  612. <property>
  613. <name>mapreduce.jobtracker.heartbeats.in.second</name>
  614. <value>100</value>
  615. <description>Expert: Approximate number of heart-beats that could arrive
  616. at JobTracker in a second. Assuming each RPC can be processed
  617. in 10msec, the default value is made 100 RPCs in a second.
  618. </description>
  619. </property>
  620. <property>
  621. <name>mapreduce.jobtracker.tasktracker.maxblacklists</name>
  622. <value>4</value>
  623. <description>The number of blacklists for a taskTracker by various jobs
  624. after which the task tracker could be blacklisted across
  625. all jobs. The tracker will be given a tasks later
  626. (after a day). The tracker will become a healthy
  627. tracker after a restart.
  628. </description>
  629. </property>
  630. <property>
  631. <name>mapreduce.job.maxtaskfailures.per.tracker</name>
  632. <value>4</value>
  633. <description>The number of task-failures on a tasktracker of a given job
  634. after which new tasks of that job aren't assigned to it.
  635. </description>
  636. </property>
  637. <property>
  638. <name>mapreduce.client.output.filter</name>
  639. <value>FAILED</value>
  640. <description>The filter for controlling the output of the task's userlogs sent
  641. to the console of the JobClient.
  642. The permissible options are: NONE, KILLED, FAILED, SUCCEEDED and
  643. ALL.
  644. </description>
  645. </property>
  646. <property>
  647. <name>mapreduce.client.completion.pollinterval</name>
  648. <value>5000</value>
  649. <description>The interval (in milliseconds) between which the JobClient
  650. polls the JobTracker for updates about job status. You may want to set this
  651. to a lower value to make tests run faster on a single node system. Adjusting
  652. this value in production may lead to unwanted client-server traffic.
  653. </description>
  654. </property>
  655. <property>
  656. <name>mapreduce.client.progressmonitor.pollinterval</name>
  657. <value>1000</value>
  658. <description>The interval (in milliseconds) between which the JobClient
  659. reports status to the console and checks for job completion. You may want to set this
  660. to a lower value to make tests run faster on a single node system. Adjusting
  661. this value in production may lead to unwanted client-server traffic.
  662. </description>
  663. </property>
  664. <property>
  665. <name>mapreduce.jobtracker.persist.jobstatus.active</name>
  666. <value>true</value>
  667. <description>Indicates if persistency of job status information is
  668. active or not.
  669. </description>
  670. </property>
  671. <property>
  672. <name>mapreduce.jobtracker.persist.jobstatus.hours</name>
  673. <value>1</value>
  674. <description>The number of hours job status information is persisted in DFS.
  675. The job status information will be available after it drops of the memory
  676. queue and between jobtracker restarts. With a zero value the job status
  677. information is not persisted at all in DFS.
  678. </description>
  679. </property>
  680. <property>
  681. <name>mapreduce.jobtracker.persist.jobstatus.dir</name>
  682. <value>/jobtracker/jobsInfo</value>
  683. <description>The directory where the job status information is persisted
  684. in a file system to be available after it drops of the memory queue and
  685. between jobtracker restarts.
  686. </description>
  687. </property>
  688. <property>
  689. <name>mapreduce.task.profile</name>
  690. <value>false</value>
  691. <description>To set whether the system should collect profiler
  692. information for some of the tasks in this job? The information is stored
  693. in the user log directory. The value is "true" if task profiling
  694. is enabled.</description>
  695. </property>
  696. <property>
  697. <name>mapreduce.task.profile.maps</name>
  698. <value>0-2</value>
  699. <description> To set the ranges of map tasks to profile.
  700. mapreduce.task.profile has to be set to true for the value to be accounted.
  701. </description>
  702. </property>
  703. <property>
  704. <name>mapreduce.task.profile.reduces</name>
  705. <value>0-2</value>
  706. <description> To set the ranges of reduce tasks to profile.
  707. mapreduce.task.profile has to be set to true for the value to be accounted.
  708. </description>
  709. </property>
  710. <property>
  711. <name>mapreduce.task.skip.start.attempts</name>
  712. <value>2</value>
  713. <description> The number of Task attempts AFTER which skip mode
  714. will be kicked off. When skip mode is kicked off, the
  715. tasks reports the range of records which it will process
  716. next, to the TaskTracker. So that on failures, TT knows which
  717. ones are possibly the bad records. On further executions,
  718. those are skipped.
  719. </description>
  720. </property>
  721. <property>
  722. <name>mapreduce.map.skip.proc.count.autoincr</name>
  723. <value>true</value>
  724. <description> The flag which if set to true,
  725. SkipBadRecords.COUNTER_MAP_PROCESSED_RECORDS is incremented
  726. by MapRunner after invoking the map function. This value must be set to
  727. false for applications which process the records asynchronously
  728. or buffer the input records. For example streaming.
  729. In such cases applications should increment this counter on their own.
  730. </description>
  731. </property>
  732. <property>
  733. <name>mapreduce.reduce.skip.proc.count.autoincr</name>
  734. <value>true</value>
  735. <description> The flag which if set to true,
  736. SkipBadRecords.COUNTER_REDUCE_PROCESSED_GROUPS is incremented
  737. by framework after invoking the reduce function. This value must be set to
  738. false for applications which process the records asynchronously
  739. or buffer the input records. For example streaming.
  740. In such cases applications should increment this counter on their own.
  741. </description>
  742. </property>
  743. <property>
  744. <name>mapreduce.job.skip.outdir</name>
  745. <value></value>
  746. <description> If no value is specified here, the skipped records are
  747. written to the output directory at _logs/skip.
  748. User can stop writing skipped records by giving the value "none".
  749. </description>
  750. </property>
  751. <property>
  752. <name>mapreduce.map.skip.maxrecords</name>
  753. <value>0</value>
  754. <description> The number of acceptable skip records surrounding the bad
  755. record PER bad record in mapper. The number includes the bad record as well.
  756. To turn the feature of detection/skipping of bad records off, set the
  757. value to 0.
  758. The framework tries to narrow down the skipped range by retrying
  759. until this threshold is met OR all attempts get exhausted for this task.
  760. Set the value to Long.MAX_VALUE to indicate that framework need not try to
  761. narrow down. Whatever records(depends on application) get skipped are
  762. acceptable.
  763. </description>
  764. </property>
  765. <property>
  766. <name>mapreduce.reduce.skip.maxgroups</name>
  767. <value>0</value>
  768. <description> The number of acceptable skip groups surrounding the bad
  769. group PER bad group in reducer. The number includes the bad group as well.
  770. To turn the feature of detection/skipping of bad groups off, set the
  771. value to 0.
  772. The framework tries to narrow down the skipped range by retrying
  773. until this threshold is met OR all attempts get exhausted for this task.
  774. Set the value to Long.MAX_VALUE to indicate that framework need not try to
  775. narrow down. Whatever groups(depends on application) get skipped are
  776. acceptable.
  777. </description>
  778. </property>
  779. <!-- Job Notification Configuration -->
  780. <!--
  781. <property>
  782. <name>mapreduce.job.end-notification.url</name>
  783. <value>http://localhost:8080/jobstatus.php?jobId=$jobId&amp;jobStatus=$jobStatus</value>
  784. <description>Indicates url which will be called on completion of job to inform
  785. end status of job.
  786. User can give at most 2 variables with URI : $jobId and $jobStatus.
  787. If they are present in URI, then they will be replaced by their
  788. respective values.
  789. </description>
  790. </property>
  791. -->
  792. <property>
  793. <name>mapreduce.job.end-notification.retry.attempts</name>
  794. <value>0</value>
  795. <description>Indicates how many times hadoop should attempt to contact the
  796. notification URL </description>
  797. </property>
  798. <property>
  799. <name>mapreduce.job.end-notification.retry.interval</name>
  800. <value>30000</value>
  801. <description>Indicates time in milliseconds between notification URL retry
  802. calls</description>
  803. </property>
  804. <!-- Proxy Configuration -->
  805. <property>
  806. <name>mapreduce.jobtracker.taskcache.levels</name>
  807. <value>2</value>
  808. <description> This is the max level of the task cache. For example, if
  809. the level is 2, the tasks cached are at the host level and at the rack
  810. level.
  811. </description>
  812. </property>
  813. <property>
  814. <name>mapreduce.job.queuename</name>
  815. <value>default</value>
  816. <description> Queue to which a job is submitted. This must match one of the
  817. queues defined in mapred-queues.xml for the system. Also, the ACL setup
  818. for the queue must allow the current user to submit a job to the queue.
  819. Before specifying a queue, ensure that the system is configured with
  820. the queue, and access is allowed for submitting jobs to the queue.
  821. </description>
  822. </property>
  823. <property>
  824. <name>mapreduce.cluster.acls.enabled</name>
  825. <value>false</value>
  826. <description> Specifies whether ACLs should be checked
  827. for authorization of users for doing various queue and job level operations.
  828. ACLs are disabled by default. If enabled, access control checks are made by
  829. JobTracker and TaskTracker when requests are made by users for queue
  830. operations like submit job to a queue and kill a job in the queue and job
  831. operations like viewing the job-details (See mapreduce.job.acl-view-job)
  832. or for modifying the job (See mapreduce.job.acl-modify-job) using
  833. Map/Reduce APIs, RPCs or via the console and web user interfaces.
  834. For enabling this flag(mapreduce.cluster.acls.enabled), this is to be set
  835. to true in mapred-site.xml on JobTracker node and on all TaskTracker nodes.
  836. </description>
  837. </property>
  838. <property>
  839. <description>Network ACL to AM closed.</description>
  840. <name>mapreduce.job.am-access-disabled</name>
  841. <value>false</value>
  842. </property>
  843. <property>
  844. <name>mapreduce.job.acl-modify-job</name>
  845. <value> </value>
  846. <description> Job specific access-control list for 'modifying' the job. It
  847. is only used if authorization is enabled in Map/Reduce by setting the
  848. configuration property mapreduce.cluster.acls.enabled to true.
  849. This specifies the list of users and/or groups who can do modification
  850. operations on the job. For specifying a list of users and groups the
  851. format to use is "user1,user2 group1,group". If set to '*', it allows all
  852. users/groups to modify this job. If set to ' '(i.e. space), it allows
  853. none. This configuration is used to guard all the modifications with respect
  854. to this job and takes care of all the following operations:
  855. o killing this job
  856. o killing a task of this job, failing a task of this job
  857. o setting the priority of this job
  858. Each of these operations are also protected by the per-queue level ACL
  859. "acl-administer-jobs" configured via mapred-queues.xml. So a caller should
  860. have the authorization to satisfy either the queue-level ACL or the
  861. job-level ACL.
  862. Irrespective of this ACL configuration, (a) job-owner, (b) the user who
  863. started the cluster, (c) cluster administrators
  864. configured via mapreduce.cluster.administrators and (d) queue
  865. administrators of the queue to which this job was submitted to configured
  866. via acl-administer-jobs for the specific queue in mapred-queues.xml can
  867. do all the modification operations on a job.
  868. By default, nobody else besides job-owner, the user who started the cluster,
  869. cluster administrators and queue administrators can perform modification
  870. operations on a job.
  871. </description>
  872. </property>
  873. <property>
  874. <name>mapreduce.job.acl-view-job</name>
  875. <value> </value>
  876. <description> Job specific access-control list for 'viewing' the job. It is
  877. only used if authorization is enabled in Map/Reduce by setting the
  878. configuration property mapreduce.cluster.acls.enabled to true.
  879. This specifies the list of users and/or groups who can view private details
  880. about the job. For specifying a list of users and groups the
  881. format to use is "user1,user2 group1,group". If set to '*', it allows all
  882. users/groups to modify this job. If set to ' '(i.e. space), it allows
  883. none. This configuration is used to guard some of the job-views and at
  884. present only protects APIs that can return possibly sensitive information
  885. of the job-owner like
  886. o job-level counters
  887. o task-level counters
  888. o tasks' diagnostic information
  889. o task-logs displayed on the TaskTracker web-UI and
  890. o job.xml showed by the JobTracker's web-UI
  891. Every other piece of information of jobs is still accessible by any other
  892. user, for e.g., JobStatus, JobProfile, list of jobs in the queue, etc.
  893. Irrespective of this ACL configuration, (a) job-owner, (b) the user who
  894. started the cluster, (c) cluster administrators
  895. configured via mapreduce.cluster.administrators and (d) queue
  896. administrators of the queue to which this job was submitted to configured
  897. via acl-administer-jobs for the specific queue in mapred-queues.xml can
  898. do all the view operations on a job.
  899. By default, nobody else besides job-owner, the user who started the
  900. cluster, cluster administrators and queue administrators can perform
  901. view operations on a job.
  902. </description>
  903. </property>
  904. <property>
  905. <name>mapreduce.jobtracker.webinterface.trusted</name>
  906. <value>false</value>
  907. <description> If set to true, the web interface of the JobTracker
  908. will include actions such as kill job that are security sensitive.
  909. Leave this option as false if untrusted users have access to the web interface.
  910. </description>
  911. </property>
  912. <property>
  913. <name>mapreduce.tasktracker.indexcache.mb</name>
  914. <value>10</value>
  915. <description> The maximum memory that a task tracker allows for the
  916. index cache that is used when serving map outputs to reducers.
  917. </description>
  918. </property>
  919. <!-- TaskTracker DistributedCache configuration -->
  920. <property>
  921. <name>mapreduce.tasktracker.cache.local.size</name>
  922. <value>10737418240</value>
  923. <description>The number of bytes to allocate in each local TaskTracker
  924. directory for holding Distributed Cache data.</description>
  925. </property>
  926. <property>
  927. <name>mapreduce.tasktracker.cache.local.numberdirectories</name>
  928. <value>10000</value>
  929. <description>
  930. The maximum number of subdirectories that should be created in any particular
  931. distributed cache store. After this many directories have been created,
  932. cache items will be expunged regardless of whether the total size threshold
  933. has been exceeded.
  934. </description>
  935. </property>
  936. <!-- End of TaskTracker DistributedCache configuration -->
  937. <property>
  938. <name>mapreduce.task.combine.progress.records</name>
  939. <value>10000</value>
  940. <description> The number of records to process during combine output collection
  941. before sending a progress notification to the TaskTracker.
  942. </description>
  943. </property>
  944. <property>
  945. <name>mapreduce.task.merge.progress.records</name>
  946. <value>10000</value>
  947. <description> The number of records to process during merge before
  948. sending a progress notification to the TaskTracker.
  949. </description>
  950. </property>
  951. <property>
  952. <name>mapreduce.job.reduce.slowstart.completedmaps</name>
  953. <value>0.05</value>
  954. <description>Fraction of the number of maps in the job which should be
  955. complete before reduces are scheduled for the job.
  956. </description>
  957. </property>
  958. <property>
  959. <name>mapreduce.job.complete.cancel.delegation.tokens</name>
  960. <value>true</value>
  961. <description> if false - do not unregister/cancel delegation tokens from
  962. renewal, because same tokens may be used by spawned jobs
  963. </description>
  964. </property>
  965. <property>
  966. <name>mapreduce.tasktracker.taskcontroller</name>
  967. <value>org.apache.hadoop.mapred.DefaultTaskController</value>
  968. <description>TaskController which is used to launch and manage task execution
  969. </description>
  970. </property>
  971. <property>
  972. <name>mapreduce.tasktracker.group</name>
  973. <value></value>
  974. <description>Expert: Group to which TaskTracker belongs. If
  975. LinuxTaskController is configured via mapreduce.tasktracker.taskcontroller,
  976. the group owner of the task-controller binary should be same as this group.
  977. </description>
  978. </property>
  979. <!-- Node health script variables -->
  980. <property>
  981. <name>mapreduce.tasktracker.healthchecker.script.path</name>
  982. <value></value>
  983. <description>Absolute path to the script which is
  984. periodicallyrun by the node health monitoring service to determine if
  985. the node is healthy or not. If the value of this key is empty or the
  986. file does not exist in the location configured here, the node health
  987. monitoring service is not started.</description>
  988. </property>
  989. <property>
  990. <name>mapreduce.tasktracker.healthchecker.interval</name>
  991. <value>60000</value>
  992. <description>Frequency of the node health script to be run,
  993. in milliseconds</description>
  994. </property>
  995. <property>
  996. <name>mapreduce.tasktracker.healthchecker.script.timeout</name>
  997. <value>600000</value>
  998. <description>Time after node health script should be killed if
  999. unresponsive and considered that the script has failed.</description>
  1000. </property>
  1001. <property>
  1002. <name>mapreduce.tasktracker.healthchecker.script.args</name>
  1003. <value></value>
  1004. <description>List of arguments which are to be passed to
  1005. node health script when it is being launched comma seperated.
  1006. </description>
  1007. </property>
  1008. <!-- end of node health script variables -->
  1009. </configuration>