mapred-default.xml 58 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619
  1. <?xml version="1.0"?>
  2. <?xml-stylesheet type="text/xsl" href="configuration.xsl"?>
  3. <!--
  4. Licensed to the Apache Software Foundation (ASF) under one or more
  5. contributor license agreements. See the NOTICE file distributed with
  6. this work for additional information regarding copyright ownership.
  7. The ASF licenses this file to You under the Apache License, Version 2.0
  8. (the "License"); you may not use this file except in compliance with
  9. the License. You may obtain a copy of the License at
  10. http://www.apache.org/licenses/LICENSE-2.0
  11. Unless required by applicable law or agreed to in writing, software
  12. distributed under the License is distributed on an "AS IS" BASIS,
  13. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14. See the License for the specific language governing permissions and
  15. limitations under the License.
  16. -->
  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.job.committer.setup.cleanup.needed</name>
  23. <value>true</value>
  24. <description> true, if job needs job-setup and job-cleanup.
  25. false, otherwise
  26. </description>
  27. </property>
  28. <!-- i/o properties -->
  29. <property>
  30. <name>mapreduce.task.io.sort.factor</name>
  31. <value>10</value>
  32. <description>The number of streams to merge at once while sorting
  33. files. This determines the number of open file handles.</description>
  34. </property>
  35. <property>
  36. <name>mapreduce.task.io.sort.mb</name>
  37. <value>100</value>
  38. <description>The total amount of buffer memory to use while sorting
  39. files, in megabytes. By default, gives each merge stream 1MB, which
  40. should minimize seeks.</description>
  41. </property>
  42. <property>
  43. <name>mapreduce.map.sort.spill.percent</name>
  44. <value>0.80</value>
  45. <description>The soft limit in the serialization buffer. Once reached, a
  46. thread will begin to spill the contents to disk in the background. Note that
  47. collection will not block if this threshold is exceeded while a spill is
  48. already in progress, so spills may be larger than this threshold when it is
  49. set to less than .5</description>
  50. </property>
  51. <property>
  52. <name>mapreduce.local.clientfactory.class.name</name>
  53. <value>org.apache.hadoop.mapred.LocalClientFactory</value>
  54. <description>This the client factory that is responsible for
  55. creating local job runner client</description>
  56. </property>
  57. <property>
  58. <name>mapreduce.job.maps</name>
  59. <value>2</value>
  60. <description>The default number of map tasks per job.
  61. Ignored when mapreduce.framework.name is "local".
  62. </description>
  63. </property>
  64. <property>
  65. <name>mapreduce.job.reduces</name>
  66. <value>1</value>
  67. <description>The default number of reduce tasks per job. Typically set to 99%
  68. of the cluster's reduce capacity, so that if a node fails the reduces can
  69. still be executed in a single wave.
  70. Ignored when mapreduce.framework.name is "local".
  71. </description>
  72. </property>
  73. <property>
  74. <name>mapreduce.job.reducer.preempt.delay.sec</name>
  75. <value>0</value>
  76. <description>The threshold in terms of seconds after which an unsatisfied mapper
  77. request triggers reducer preemption to free space. Default 0 implies that the
  78. reduces should be preempted immediately after allocation if there is currently no
  79. room for newly allocated mappers.
  80. </description>
  81. </property>
  82. <property>
  83. <name>mapreduce.job.max.split.locations</name>
  84. <value>10</value>
  85. <description>The max number of block locations to store for each split for
  86. locality calculation.
  87. </description>
  88. </property>
  89. <property>
  90. <name>mapreduce.job.split.metainfo.maxsize</name>
  91. <value>10000000</value>
  92. <description>The maximum permissible size of the split metainfo file.
  93. The MapReduce ApplicationMaster won't attempt to read submitted split metainfo
  94. files bigger than this configured value.
  95. No limits if set to -1.
  96. </description>
  97. </property>
  98. <property>
  99. <name>mapreduce.map.maxattempts</name>
  100. <value>4</value>
  101. <description>Expert: The maximum number of attempts per map task.
  102. In other words, framework will try to execute a map task these many number
  103. of times before giving up on it.
  104. </description>
  105. </property>
  106. <property>
  107. <name>mapreduce.reduce.maxattempts</name>
  108. <value>4</value>
  109. <description>Expert: The maximum number of attempts per reduce task.
  110. In other words, framework will try to execute a reduce task these many number
  111. of times before giving up on it.
  112. </description>
  113. </property>
  114. <property>
  115. <name>mapreduce.reduce.shuffle.fetch.retry.enabled</name>
  116. <value>${yarn.nodemanager.recovery.enabled}</value>
  117. <description>Set to enable fetch retry during host restart.</description>
  118. </property>
  119. <property>
  120. <name>mapreduce.reduce.shuffle.fetch.retry.interval-ms</name>
  121. <value>1000</value>
  122. <description>Time of interval that fetcher retry to fetch again when some
  123. non-fatal failure happens because of some events like NM restart.
  124. </description>
  125. </property>
  126. <property>
  127. <name>mapreduce.reduce.shuffle.fetch.retry.timeout-ms</name>
  128. <value>30000</value>
  129. <description>Timeout value for fetcher to retry to fetch again when some
  130. non-fatal failure happens because of some events like NM restart.</description>
  131. </property>
  132. <property>
  133. <name>mapreduce.reduce.shuffle.retry-delay.max.ms</name>
  134. <value>60000</value>
  135. <description>The maximum number of ms the reducer will delay before retrying
  136. to download map data.
  137. </description>
  138. </property>
  139. <property>
  140. <name>mapreduce.reduce.shuffle.parallelcopies</name>
  141. <value>5</value>
  142. <description>The default number of parallel transfers run by reduce
  143. during the copy(shuffle) phase.
  144. </description>
  145. </property>
  146. <property>
  147. <name>mapreduce.reduce.shuffle.connect.timeout</name>
  148. <value>180000</value>
  149. <description>Expert: The maximum amount of time (in milli seconds) reduce
  150. task spends in trying to connect to a remote node for getting map output.
  151. </description>
  152. </property>
  153. <property>
  154. <name>mapreduce.reduce.shuffle.read.timeout</name>
  155. <value>180000</value>
  156. <description>Expert: The maximum amount of time (in milli seconds) reduce
  157. task waits for map output data to be available for reading after obtaining
  158. connection.
  159. </description>
  160. </property>
  161. <property>
  162. <name>mapreduce.shuffle.connection-keep-alive.enable</name>
  163. <value>false</value>
  164. <description>set to true to support keep-alive connections.</description>
  165. </property>
  166. <property>
  167. <name>mapreduce.shuffle.connection-keep-alive.timeout</name>
  168. <value>5</value>
  169. <description>The number of seconds a shuffle client attempts to retain
  170. http connection. Refer "Keep-Alive: timeout=" header in
  171. Http specification
  172. </description>
  173. </property>
  174. <property>
  175. <name>mapreduce.task.timeout</name>
  176. <value>600000</value>
  177. <description>The number of milliseconds before a task will be
  178. terminated if it neither reads an input, writes an output, nor
  179. updates its status string. A value of 0 disables the timeout.
  180. </description>
  181. </property>
  182. <property>
  183. <name>mapreduce.map.memory.mb</name>
  184. <value>-1</value>
  185. <description>The amount of memory to request from the scheduler for each
  186. map task. If this is not specified or is non-positive, it is inferred from
  187. mapreduce.map.java.opts and mapreduce.job.heap.memory-mb.ratio.
  188. If java-opts are also not specified, we set it to 1024.
  189. </description>
  190. </property>
  191. <property>
  192. <name>mapreduce.map.cpu.vcores</name>
  193. <value>1</value>
  194. <description>The number of virtual cores to request from the scheduler for
  195. each map task.
  196. </description>
  197. </property>
  198. <property>
  199. <name>mapreduce.reduce.memory.mb</name>
  200. <value>-1</value>
  201. <description>The amount of memory to request from the scheduler for each
  202. reduce task. If this is not specified or is non-positive, it is inferred
  203. from mapreduce.reduce.java.opts and mapreduce.job.heap.memory-mb.ratio.
  204. If java-opts are also not specified, we set it to 1024.
  205. </description>
  206. </property>
  207. <property>
  208. <name>mapreduce.reduce.cpu.vcores</name>
  209. <value>1</value>
  210. <description>The number of virtual cores to request from the scheduler for
  211. each reduce task.
  212. </description>
  213. </property>
  214. <property>
  215. <name>mapred.child.java.opts</name>
  216. <value></value>
  217. <description>Java opts for the task processes.
  218. The following symbol, if present, will be interpolated: @taskid@ is replaced
  219. by current TaskID. Any other occurrences of '@' will go unchanged.
  220. For example, to enable verbose gc logging to a file named for the taskid in
  221. /tmp and to set the heap maximum to be a gigabyte, pass a 'value' of:
  222. -Xmx1024m -verbose:gc -Xloggc:/tmp/@taskid@.gc
  223. Usage of -Djava.library.path can cause programs to no longer function if
  224. hadoop native libraries are used. These values should instead be set as part
  225. of LD_LIBRARY_PATH in the map / reduce JVM env using the mapreduce.map.env and
  226. mapreduce.reduce.env config settings.
  227. If -Xmx is not set, it is inferred from mapreduce.{map|reduce}.memory.mb and
  228. mapreduce.job.heap.memory-mb.ratio.
  229. </description>
  230. </property>
  231. <!-- This is commented out so that it won't override mapred.child.java.opts.
  232. <property>
  233. <name>mapreduce.map.java.opts</name>
  234. <value></value>
  235. <description>Java opts only for the child processes that are maps. If set,
  236. this will be used instead of mapred.child.java.opts. If -Xmx is not set,
  237. it is inferred from mapreduce.map.memory.mb and
  238. mapreduce.job.heap.memory-mb.ratio.
  239. </description>
  240. </property>
  241. -->
  242. <!-- This is commented out so that it won't override mapred.child.java.opts.
  243. <property>
  244. <name>mapreduce.reduce.java.opts</name>
  245. <value></value>
  246. <description>Java opts only for the child processes that are reduces. If set,
  247. this will be used instead of mapred.child.java.opts. If -Xmx is not set,
  248. it is inferred from mapreduce.reduce.memory.mb and
  249. mapreduce.job.heap.memory-mb.ratio.
  250. </description>
  251. </property>
  252. -->
  253. <property>
  254. <name>mapred.child.env</name>
  255. <value></value>
  256. <description>User added environment variables for the task processes.
  257. Example :
  258. 1) A=foo This will set the env variable A to foo
  259. 2) B=$B:c This is inherit nodemanager's B env variable on Unix.
  260. 3) B=%B%;c This is inherit nodemanager's B env variable on Windows.
  261. </description>
  262. </property>
  263. <!-- This is commented out so that it won't override mapred.child.env.
  264. <property>
  265. <name>mapreduce.map.env</name>
  266. <value></value>
  267. <description>User added environment variables for the map task processes.
  268. </description>
  269. </property>
  270. -->
  271. <!-- This is commented out so that it won't override mapred.child.env.
  272. <property>
  273. <name>mapreduce.reduce.env</name>
  274. <value></value>
  275. <description>User added environment variables for the reduce task processes.
  276. </description>
  277. </property>
  278. -->
  279. <property>
  280. <name>mapreduce.admin.user.env</name>
  281. <value></value>
  282. <description>
  283. Expert: Additional execution environment entries for
  284. map and reduce task processes. This is not an additive property.
  285. You must preserve the original value if you want your map and
  286. reduce tasks to have access to native libraries (compression, etc).
  287. When this value is empty, the command to set execution
  288. envrionment will be OS dependent:
  289. For linux, use LD_LIBRARY_PATH=$HADOOP_COMMON_HOME/lib/native.
  290. For windows, use PATH = %PATH%;%HADOOP_COMMON_HOME%\\bin.
  291. </description>
  292. </property>
  293. <property>
  294. <name>mapreduce.map.log.level</name>
  295. <value>INFO</value>
  296. <description>The logging level for the map task. The allowed levels are:
  297. OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE and ALL.
  298. The setting here could be overridden if "mapreduce.job.log4j-properties-file"
  299. is set.
  300. </description>
  301. </property>
  302. <property>
  303. <name>mapreduce.reduce.log.level</name>
  304. <value>INFO</value>
  305. <description>The logging level for the reduce task. The allowed levels are:
  306. OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE and ALL.
  307. The setting here could be overridden if "mapreduce.job.log4j-properties-file"
  308. is set.
  309. </description>
  310. </property>
  311. <property>
  312. <name>mapreduce.map.cpu.vcores</name>
  313. <value>1</value>
  314. <description>
  315. The number of virtual cores required for each map task.
  316. </description>
  317. </property>
  318. <property>
  319. <name>mapreduce.reduce.cpu.vcores</name>
  320. <value>1</value>
  321. <description>
  322. The number of virtual cores required for each reduce task.
  323. </description>
  324. </property>
  325. <property>
  326. <name>mapreduce.reduce.merge.inmem.threshold</name>
  327. <value>1000</value>
  328. <description>The threshold, in terms of the number of files
  329. for the in-memory merge process. When we accumulate threshold number of files
  330. we initiate the in-memory merge and spill to disk. A value of 0 or less than
  331. 0 indicates we want to DON'T have any threshold and instead depend only on
  332. the ramfs's memory consumption to trigger the merge.
  333. </description>
  334. </property>
  335. <property>
  336. <name>mapreduce.reduce.shuffle.merge.percent</name>
  337. <value>0.66</value>
  338. <description>The usage threshold at which an in-memory merge will be
  339. initiated, expressed as a percentage of the total memory allocated to
  340. storing in-memory map outputs, as defined by
  341. mapreduce.reduce.shuffle.input.buffer.percent.
  342. </description>
  343. </property>
  344. <property>
  345. <name>mapreduce.reduce.shuffle.input.buffer.percent</name>
  346. <value>0.70</value>
  347. <description>The percentage of memory to be allocated from the maximum heap
  348. size to storing map outputs during the shuffle.
  349. </description>
  350. </property>
  351. <property>
  352. <name>mapreduce.reduce.input.buffer.percent</name>
  353. <value>0.0</value>
  354. <description>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. </description>
  359. </property>
  360. <property>
  361. <name>mapreduce.reduce.shuffle.memory.limit.percent</name>
  362. <value>0.25</value>
  363. <description>Expert: Maximum percentage of the in-memory limit that a
  364. single shuffle can consume</description>
  365. </property>
  366. <property>
  367. <name>mapreduce.shuffle.ssl.enabled</name>
  368. <value>false</value>
  369. <description>
  370. Whether to use SSL for for the Shuffle HTTP endpoints.
  371. </description>
  372. </property>
  373. <property>
  374. <name>mapreduce.shuffle.ssl.file.buffer.size</name>
  375. <value>65536</value>
  376. <description>Buffer size for reading spills from file when using SSL.
  377. </description>
  378. </property>
  379. <property>
  380. <name>mapreduce.shuffle.max.connections</name>
  381. <value>0</value>
  382. <description>Max allowed connections for the shuffle. Set to 0 (zero)
  383. to indicate no limit on the number of connections.
  384. </description>
  385. </property>
  386. <property>
  387. <name>mapreduce.shuffle.max.threads</name>
  388. <value>0</value>
  389. <description>Max allowed threads for serving shuffle connections. Set to zero
  390. to indicate the default of 2 times the number of available
  391. processors (as reported by Runtime.availableProcessors()). Netty is used to
  392. serve requests, so a thread is not needed for each connection.
  393. </description>
  394. </property>
  395. <property>
  396. <name>mapreduce.shuffle.transferTo.allowed</name>
  397. <value></value>
  398. <description>This option can enable/disable using nio transferTo method in
  399. the shuffle phase. NIO transferTo does not perform well on windows in the
  400. shuffle phase. Thus, with this configuration property it is possible to
  401. disable it, in which case custom transfer method will be used. Recommended
  402. value is false when running Hadoop on Windows. For Linux, it is recommended
  403. to set it to true. If nothing is set then the default value is false for
  404. Windows, and true for Linux.
  405. </description>
  406. </property>
  407. <property>
  408. <name>mapreduce.shuffle.transfer.buffer.size</name>
  409. <value>131072</value>
  410. <description>This property is used only if
  411. mapreduce.shuffle.transferTo.allowed is set to false. In that case,
  412. this property defines the size of the buffer used in the buffer copy code
  413. for the shuffle phase. The size of this buffer determines the size of the IO
  414. requests.
  415. </description>
  416. </property>
  417. <property>
  418. <name>mapreduce.reduce.markreset.buffer.percent</name>
  419. <value>0.0</value>
  420. <description>The percentage of memory -relative to the maximum heap size- to
  421. be used for caching values when using the mark-reset functionality.
  422. </description>
  423. </property>
  424. <property>
  425. <name>mapreduce.map.speculative</name>
  426. <value>true</value>
  427. <description>If true, then multiple instances of some map tasks
  428. may be executed in parallel.</description>
  429. </property>
  430. <property>
  431. <name>mapreduce.reduce.speculative</name>
  432. <value>true</value>
  433. <description>If true, then multiple instances of some reduce tasks
  434. may be executed in parallel.</description>
  435. </property>
  436. <property>
  437. <name>mapreduce.job.speculative.speculative-cap-running-tasks</name>
  438. <value>0.1</value>
  439. <description>The max percent (0-1) of running tasks that
  440. can be speculatively re-executed at any time.</description>
  441. </property>
  442. <property>
  443. <name>mapreduce.job.speculative.speculative-cap-total-tasks</name>
  444. <value>0.01</value>
  445. <description>The max percent (0-1) of all tasks that
  446. can be speculatively re-executed at any time.</description>
  447. </property>
  448. <property>
  449. <name>mapreduce.job.speculative.minimum-allowed-tasks</name>
  450. <value>10</value>
  451. <description>The minimum allowed tasks that
  452. can be speculatively re-executed at any time.</description>
  453. </property>
  454. <property>
  455. <name>mapreduce.job.speculative.retry-after-no-speculate</name>
  456. <value>1000</value>
  457. <description>The waiting time(ms) to do next round of speculation
  458. if there is no task speculated in this round.</description>
  459. </property>
  460. <property>
  461. <name>mapreduce.job.speculative.retry-after-speculate</name>
  462. <value>15000</value>
  463. <description>The waiting time(ms) to do next round of speculation
  464. if there are tasks speculated in this round.</description>
  465. </property>
  466. <property>
  467. <name>mapreduce.job.map.output.collector.class</name>
  468. <value>org.apache.hadoop.mapred.MapTask$MapOutputBuffer</value>
  469. <description>
  470. The MapOutputCollector implementation(s) to use. This may be a comma-separated
  471. list of class names, in which case the map task will try to initialize each
  472. of the collectors in turn. The first to successfully initialize will be used.
  473. </description>
  474. </property>
  475. <property>
  476. <name>mapreduce.job.speculative.slowtaskthreshold</name>
  477. <value>1.0</value>
  478. <description>The number of standard deviations by which a task's
  479. ave progress-rates must be lower than the average of all running tasks'
  480. for the task to be considered too slow.
  481. </description>
  482. </property>
  483. <property>
  484. <name>mapreduce.job.ubertask.enable</name>
  485. <value>false</value>
  486. <description>Whether to enable the small-jobs "ubertask" optimization,
  487. which runs "sufficiently small" jobs sequentially within a single JVM.
  488. "Small" is defined by the following maxmaps, maxreduces, and maxbytes
  489. settings. Note that configurations for application masters also affect
  490. the "Small" definition - yarn.app.mapreduce.am.resource.mb must be
  491. larger than both mapreduce.map.memory.mb and mapreduce.reduce.memory.mb,
  492. and yarn.app.mapreduce.am.resource.cpu-vcores must be larger than
  493. both mapreduce.map.cpu.vcores and mapreduce.reduce.cpu.vcores to enable
  494. ubertask. Users may override this value.
  495. </description>
  496. </property>
  497. <property>
  498. <name>mapreduce.job.ubertask.maxmaps</name>
  499. <value>9</value>
  500. <description>Threshold for number of maps, beyond which job is considered
  501. too big for the ubertasking optimization. Users may override this value,
  502. but only downward.
  503. </description>
  504. </property>
  505. <property>
  506. <name>mapreduce.job.ubertask.maxreduces</name>
  507. <value>1</value>
  508. <description>Threshold for number of reduces, beyond which job is considered
  509. too big for the ubertasking optimization. CURRENTLY THE CODE CANNOT SUPPORT
  510. MORE THAN ONE REDUCE and will ignore larger values. (Zero is a valid max,
  511. however.) Users may override this value, but only downward.
  512. </description>
  513. </property>
  514. <property>
  515. <name>mapreduce.job.ubertask.maxbytes</name>
  516. <value></value>
  517. <description>Threshold for number of input bytes, beyond which job is
  518. considered too big for the ubertasking optimization. If no value is
  519. specified, dfs.block.size is used as a default. Be sure to specify a
  520. default value in mapred-site.xml if the underlying filesystem is not HDFS.
  521. Users may override this value, but only downward.
  522. </description>
  523. </property>
  524. <property>
  525. <name>mapreduce.job.emit-timeline-data</name>
  526. <value>false</value>
  527. <description>Specifies if the Application Master should emit timeline data
  528. to the timeline server. Individual jobs can override this value.
  529. </description>
  530. </property>
  531. <property>
  532. <name>mapreduce.input.fileinputformat.split.minsize</name>
  533. <value>0</value>
  534. <description>The minimum size chunk that map input should be split
  535. into. Note that some file formats may have minimum split sizes that
  536. take priority over this setting.</description>
  537. </property>
  538. <property>
  539. <name>mapreduce.input.fileinputformat.list-status.num-threads</name>
  540. <value>1</value>
  541. <description>The number of threads to use to list and fetch block locations
  542. for the specified input paths. Note: multiple threads should not be used
  543. if a custom non thread-safe path filter is used.
  544. </description>
  545. </property>
  546. <property>
  547. <name>mapreduce.input.lineinputformat.linespermap</name>
  548. <value>1</value>
  549. <description>When using NLineInputFormat, the number of lines of input data
  550. to include in each split.</description>
  551. </property>
  552. <property>
  553. <name>mapreduce.client.submit.file.replication</name>
  554. <value>10</value>
  555. <description>The replication level for submitted job files. This
  556. should be around the square root of the number of nodes.
  557. </description>
  558. </property>
  559. <property>
  560. <name>mapreduce.task.files.preserve.failedtasks</name>
  561. <value>false</value>
  562. <description>Should the files for failed tasks be kept. This should only be
  563. used on jobs that are failing, because the storage is never
  564. reclaimed. It also prevents the map outputs from being erased
  565. from the reduce directory as they are consumed.</description>
  566. </property>
  567. <!--
  568. <property>
  569. <name>mapreduce.task.files.preserve.filepattern</name>
  570. <value>.*_m_123456_0</value>
  571. <description>Keep all files from tasks whose task names match the given
  572. regular expression. Defaults to none.</description>
  573. </property>
  574. -->
  575. <property>
  576. <name>mapreduce.output.fileoutputformat.compress</name>
  577. <value>false</value>
  578. <description>Should the job outputs be compressed?
  579. </description>
  580. </property>
  581. <property>
  582. <name>mapreduce.output.fileoutputformat.compress.type</name>
  583. <value>RECORD</value>
  584. <description>If the job outputs are to compressed as SequenceFiles, how should
  585. they be compressed? Should be one of NONE, RECORD or BLOCK.
  586. </description>
  587. </property>
  588. <property>
  589. <name>mapreduce.output.fileoutputformat.compress.codec</name>
  590. <value>org.apache.hadoop.io.compress.DefaultCodec</value>
  591. <description>If the job outputs are compressed, how should they be compressed?
  592. </description>
  593. </property>
  594. <property>
  595. <name>mapreduce.map.output.compress</name>
  596. <value>false</value>
  597. <description>Should the outputs of the maps be compressed before being
  598. sent across the network. Uses SequenceFile compression.
  599. </description>
  600. </property>
  601. <property>
  602. <name>mapreduce.map.output.compress.codec</name>
  603. <value>org.apache.hadoop.io.compress.DefaultCodec</value>
  604. <description>If the map outputs are compressed, how should they be
  605. compressed?
  606. </description>
  607. </property>
  608. <property>
  609. <name>map.sort.class</name>
  610. <value>org.apache.hadoop.util.QuickSort</value>
  611. <description>The default sort class for sorting keys.
  612. </description>
  613. </property>
  614. <property>
  615. <name>mapreduce.task.userlog.limit.kb</name>
  616. <value>0</value>
  617. <description>The maximum size of user-logs of each task in KB. 0 disables the cap.
  618. </description>
  619. </property>
  620. <property>
  621. <name>yarn.app.mapreduce.am.container.log.limit.kb</name>
  622. <value>0</value>
  623. <description>The maximum size of the MRAppMaster attempt container logs in KB.
  624. 0 disables the cap.
  625. </description>
  626. </property>
  627. <property>
  628. <name>yarn.app.mapreduce.task.container.log.backups</name>
  629. <value>0</value>
  630. <description>Number of backup files for task logs when using
  631. ContainerRollingLogAppender (CRLA). See
  632. org.apache.log4j.RollingFileAppender.maxBackupIndex. By default,
  633. ContainerLogAppender (CLA) is used, and container logs are not rolled. CRLA
  634. is enabled for tasks when both mapreduce.task.userlog.limit.kb and
  635. yarn.app.mapreduce.task.container.log.backups are greater than zero.
  636. </description>
  637. </property>
  638. <property>
  639. <name>yarn.app.mapreduce.am.container.log.backups</name>
  640. <value>0</value>
  641. <description>Number of backup files for the ApplicationMaster logs when using
  642. ContainerRollingLogAppender (CRLA). See
  643. org.apache.log4j.RollingFileAppender.maxBackupIndex. By default,
  644. ContainerLogAppender (CLA) is used, and container logs are not rolled. CRLA
  645. is enabled for the ApplicationMaster when both
  646. mapreduce.task.userlog.limit.kb and
  647. yarn.app.mapreduce.am.container.log.backups are greater than zero.
  648. </description>
  649. </property>
  650. <property>
  651. <name>yarn.app.mapreduce.shuffle.log.separate</name>
  652. <value>true</value>
  653. <description>If enabled ('true') logging generated by the client-side shuffle
  654. classes in a reducer will be written in a dedicated log file
  655. 'syslog.shuffle' instead of 'syslog'.
  656. </description>
  657. </property>
  658. <property>
  659. <name>yarn.app.mapreduce.shuffle.log.limit.kb</name>
  660. <value>0</value>
  661. <description>Maximum size of the syslog.shuffle file in kilobytes
  662. (0 for no limit).
  663. </description>
  664. </property>
  665. <property>
  666. <name>yarn.app.mapreduce.shuffle.log.backups</name>
  667. <value>0</value>
  668. <description>If yarn.app.mapreduce.shuffle.log.limit.kb and
  669. yarn.app.mapreduce.shuffle.log.backups are greater than zero
  670. then a ContainerRollngLogAppender is used instead of ContainerLogAppender
  671. for syslog.shuffle. See
  672. org.apache.log4j.RollingFileAppender.maxBackupIndex
  673. </description>
  674. </property>
  675. <property>
  676. <name>mapreduce.job.maxtaskfailures.per.tracker</name>
  677. <value>3</value>
  678. <description>The number of task-failures on a node manager of a given job
  679. after which new tasks of that job aren't assigned to it. It
  680. MUST be less than mapreduce.map.maxattempts and
  681. mapreduce.reduce.maxattempts otherwise the failed task will
  682. never be tried on a different node.
  683. </description>
  684. </property>
  685. <property>
  686. <name>mapreduce.client.output.filter</name>
  687. <value>FAILED</value>
  688. <description>The filter for controlling the output of the task's userlogs sent
  689. to the console of the JobClient.
  690. The permissible options are: NONE, KILLED, FAILED, SUCCEEDED and
  691. ALL.
  692. </description>
  693. </property>
  694. <property>
  695. <name>mapreduce.client.completion.pollinterval</name>
  696. <value>5000</value>
  697. <description>The interval (in milliseconds) between which the JobClient
  698. polls the MapReduce ApplicationMaster for updates about job status. You may want to
  699. set this to a lower value to make tests run faster on a single node system. Adjusting
  700. this value in production may lead to unwanted client-server traffic.
  701. </description>
  702. </property>
  703. <property>
  704. <name>mapreduce.client.progressmonitor.pollinterval</name>
  705. <value>1000</value>
  706. <description>The interval (in milliseconds) between which the JobClient
  707. reports status to the console and checks for job completion. You may want to set this
  708. to a lower value to make tests run faster on a single node system. Adjusting
  709. this value in production may lead to unwanted client-server traffic.
  710. </description>
  711. </property>
  712. <property>
  713. <name>mapreduce.task.profile</name>
  714. <value>false</value>
  715. <description>To set whether the system should collect profiler
  716. information for some of the tasks in this job? The information is stored
  717. in the user log directory. The value is "true" if task profiling
  718. is enabled.</description>
  719. </property>
  720. <property>
  721. <name>mapreduce.task.profile.maps</name>
  722. <value>0-2</value>
  723. <description> To set the ranges of map tasks to profile.
  724. mapreduce.task.profile has to be set to true for the value to be accounted.
  725. </description>
  726. </property>
  727. <property>
  728. <name>mapreduce.task.profile.reduces</name>
  729. <value>0-2</value>
  730. <description> To set the ranges of reduce tasks to profile.
  731. mapreduce.task.profile has to be set to true for the value to be accounted.
  732. </description>
  733. </property>
  734. <property>
  735. <name>mapreduce.task.profile.params</name>
  736. <value>-agentlib:hprof=cpu=samples,heap=sites,force=n,thread=y,verbose=n,file=%s</value>
  737. <description>JVM profiler parameters used to profile map and reduce task
  738. attempts. This string may contain a single format specifier %s that will
  739. be replaced by the path to profile.out in the task attempt log directory.
  740. To specify different profiling options for map tasks and reduce tasks,
  741. more specific parameters mapreduce.task.profile.map.params and
  742. mapreduce.task.profile.reduce.params should be used.</description>
  743. </property>
  744. <property>
  745. <name>mapreduce.task.profile.map.params</name>
  746. <value>${mapreduce.task.profile.params}</value>
  747. <description>Map-task-specific JVM profiler parameters. See
  748. mapreduce.task.profile.params</description>
  749. </property>
  750. <property>
  751. <name>mapreduce.task.profile.reduce.params</name>
  752. <value>${mapreduce.task.profile.params}</value>
  753. <description>Reduce-task-specific JVM profiler parameters. See
  754. mapreduce.task.profile.params</description>
  755. </property>
  756. <property>
  757. <name>mapreduce.task.skip.start.attempts</name>
  758. <value>2</value>
  759. <description> The number of Task attempts AFTER which skip mode
  760. will be kicked off. When skip mode is kicked off, the
  761. tasks reports the range of records which it will process
  762. next, to the MR ApplicationMaster. So that on failures, the MR AM
  763. knows which ones are possibly the bad records. On further executions,
  764. those are skipped.
  765. </description>
  766. </property>
  767. <property>
  768. <name>mapreduce.map.skip.proc.count.autoincr</name>
  769. <value>true</value>
  770. <description> The flag which if set to true,
  771. SkipBadRecords.COUNTER_MAP_PROCESSED_RECORDS is incremented
  772. by MapRunner after invoking the map function. This value must be set to
  773. false for applications which process the records asynchronously
  774. or buffer the input records. For example streaming.
  775. In such cases applications should increment this counter on their own.
  776. </description>
  777. </property>
  778. <property>
  779. <name>mapreduce.reduce.skip.proc.count.autoincr</name>
  780. <value>true</value>
  781. <description> The flag which if set to true,
  782. SkipBadRecords.COUNTER_REDUCE_PROCESSED_GROUPS is incremented
  783. by framework after invoking the reduce function. This value must be set to
  784. false for applications which process the records asynchronously
  785. or buffer the input records. For example streaming.
  786. In such cases applications should increment this counter on their own.
  787. </description>
  788. </property>
  789. <property>
  790. <name>mapreduce.job.skip.outdir</name>
  791. <value></value>
  792. <description> If no value is specified here, the skipped records are
  793. written to the output directory at _logs/skip.
  794. User can stop writing skipped records by giving the value "none".
  795. </description>
  796. </property>
  797. <property>
  798. <name>mapreduce.map.skip.maxrecords</name>
  799. <value>0</value>
  800. <description> The number of acceptable skip records surrounding the bad
  801. record PER bad record in mapper. The number includes the bad record as well.
  802. To turn the feature of detection/skipping of bad records off, set the
  803. value to 0.
  804. The framework tries to narrow down the skipped range by retrying
  805. until this threshold is met OR all attempts get exhausted for this task.
  806. Set the value to Long.MAX_VALUE to indicate that framework need not try to
  807. narrow down. Whatever records(depends on application) get skipped are
  808. acceptable.
  809. </description>
  810. </property>
  811. <property>
  812. <name>mapreduce.reduce.skip.maxgroups</name>
  813. <value>0</value>
  814. <description> The number of acceptable skip groups surrounding the bad
  815. group PER bad group in reducer. The number includes the bad group as well.
  816. To turn the feature of detection/skipping of bad groups off, set the
  817. value to 0.
  818. The framework tries to narrow down the skipped range by retrying
  819. until this threshold is met OR all attempts get exhausted for this task.
  820. Set the value to Long.MAX_VALUE to indicate that framework need not try to
  821. narrow down. Whatever groups(depends on application) get skipped are
  822. acceptable.
  823. </description>
  824. </property>
  825. <property>
  826. <name>mapreduce.ifile.readahead</name>
  827. <value>true</value>
  828. <description>Configuration key to enable/disable IFile readahead.
  829. </description>
  830. </property>
  831. <property>
  832. <name>mapreduce.ifile.readahead.bytes</name>
  833. <value>4194304</value>
  834. <description>Configuration key to set the IFile readahead length in bytes.
  835. </description>
  836. </property>
  837. <property>
  838. <name>mapreduce.job.queuename</name>
  839. <value>default</value>
  840. <description> Queue to which a job is submitted. This must match one of the
  841. queues defined in mapred-queues.xml for the system. Also, the ACL setup
  842. for the queue must allow the current user to submit a job to the queue.
  843. Before specifying a queue, ensure that the system is configured with
  844. the queue, and access is allowed for submitting jobs to the queue.
  845. </description>
  846. </property>
  847. <property>
  848. <name>mapreduce.job.tags</name>
  849. <value></value>
  850. <description> Tags for the job that will be passed to YARN at submission
  851. time. Queries to YARN for applications can filter on these tags.
  852. </description>
  853. </property>
  854. <property>
  855. <name>mapreduce.cluster.local.dir</name>
  856. <value>${hadoop.tmp.dir}/mapred/local</value>
  857. <description>
  858. The local directory where MapReduce stores intermediate
  859. data files. May be a comma-separated list of
  860. directories on different devices in order to spread disk i/o.
  861. Directories that do not exist are ignored.
  862. </description>
  863. </property>
  864. <property>
  865. <name>mapreduce.cluster.acls.enabled</name>
  866. <value>false</value>
  867. <description> Specifies whether ACLs should be checked
  868. for authorization of users for doing various queue and job level operations.
  869. ACLs are disabled by default. If enabled, access control checks are made by
  870. MapReduce ApplicationMaster when requests are made by users for queue
  871. operations like submit job to a queue and kill a job in the queue and job
  872. operations like viewing the job-details (See mapreduce.job.acl-view-job)
  873. or for modifying the job (See mapreduce.job.acl-modify-job) using
  874. Map/Reduce APIs, RPCs or via the console and web user interfaces.
  875. For enabling this flag, set to true in mapred-site.xml file of all
  876. MapReduce clients (MR job submitting nodes).
  877. </description>
  878. </property>
  879. <property>
  880. <name>mapreduce.job.acl-modify-job</name>
  881. <value> </value>
  882. <description> Job specific access-control list for 'modifying' the job. It
  883. is only used if authorization is enabled in Map/Reduce by setting the
  884. configuration property mapreduce.cluster.acls.enabled to true.
  885. This specifies the list of users and/or groups who can do modification
  886. operations on the job. For specifying a list of users and groups the
  887. format to use is "user1,user2 group1,group". If set to '*', it allows all
  888. users/groups to modify this job. If set to ' '(i.e. space), it allows
  889. none. This configuration is used to guard all the modifications with respect
  890. to this job and takes care of all the following operations:
  891. o killing this job
  892. o killing a task of this job, failing a task of this job
  893. o setting the priority of this job
  894. Each of these operations are also protected by the per-queue level ACL
  895. "acl-administer-jobs" configured via mapred-queues.xml. So a caller should
  896. have the authorization to satisfy either the queue-level ACL or the
  897. job-level ACL.
  898. Irrespective of this ACL configuration, (a) job-owner, (b) the user who
  899. started the cluster, (c) members of an admin configured supergroup
  900. configured via mapreduce.cluster.permissions.supergroup and (d) queue
  901. administrators of the queue to which this job was submitted to configured
  902. via acl-administer-jobs for the specific queue in mapred-queues.xml can
  903. do all the modification operations on a job.
  904. By default, nobody else besides job-owner, the user who started the cluster,
  905. members of supergroup and queue administrators can perform modification
  906. operations on a job.
  907. </description>
  908. </property>
  909. <property>
  910. <name>mapreduce.job.acl-view-job</name>
  911. <value> </value>
  912. <description> Job specific access-control list for 'viewing' the job. It is
  913. only used if authorization is enabled in Map/Reduce by setting the
  914. configuration property mapreduce.cluster.acls.enabled to true.
  915. This specifies the list of users and/or groups who can view private details
  916. about the job. For specifying a list of users and groups the
  917. format to use is "user1,user2 group1,group". If set to '*', it allows all
  918. users/groups to modify this job. If set to ' '(i.e. space), it allows
  919. none. This configuration is used to guard some of the job-views and at
  920. present only protects APIs that can return possibly sensitive information
  921. of the job-owner like
  922. o job-level counters
  923. o task-level counters
  924. o tasks' diagnostic information
  925. o task-logs displayed on the HistoryServer's web-UI and
  926. o job.xml showed by the HistoryServer's web-UI
  927. Every other piece of information of jobs is still accessible by any other
  928. user, for e.g., JobStatus, JobProfile, list of jobs in the queue, etc.
  929. Irrespective of this ACL configuration, (a) job-owner, (b) the user who
  930. started the cluster, (c) members of an admin configured supergroup
  931. configured via mapreduce.cluster.permissions.supergroup and (d) queue
  932. administrators of the queue to which this job was submitted to configured
  933. via acl-administer-jobs for the specific queue in mapred-queues.xml can
  934. do all the view operations on a job.
  935. By default, nobody else besides job-owner, the user who started the
  936. cluster, memebers of supergroup and queue administrators can perform
  937. view operations on a job.
  938. </description>
  939. </property>
  940. <property>
  941. <name>mapreduce.job.token.tracking.ids.enabled</name>
  942. <value>false</value>
  943. <description>Whether to write tracking ids of tokens to
  944. job-conf. When true, the configuration property
  945. "mapreduce.job.token.tracking.ids" is set to the token-tracking-ids of
  946. the job</description>
  947. </property>
  948. <property>
  949. <name>mapreduce.job.token.tracking.ids</name>
  950. <value></value>
  951. <description>When mapreduce.job.token.tracking.ids.enabled is
  952. set to true, this is set by the framework to the
  953. token-tracking-ids used by the job.</description>
  954. </property>
  955. <property>
  956. <name>mapreduce.task.merge.progress.records</name>
  957. <value>10000</value>
  958. <description> The number of records to process during merge before
  959. sending a progress notification to the MR ApplicationMaster.
  960. </description>
  961. </property>
  962. <property>
  963. <name>mapreduce.task.combine.progress.records</name>
  964. <value>10000</value>
  965. <description> The number of records to process during combine output collection
  966. before sending a progress notification.
  967. </description>
  968. </property>
  969. <property>
  970. <name>mapreduce.job.reduce.slowstart.completedmaps</name>
  971. <value>0.05</value>
  972. <description>Fraction of the number of maps in the job which should be
  973. complete before reduces are scheduled for the job.
  974. </description>
  975. </property>
  976. <property>
  977. <name>mapreduce.job.complete.cancel.delegation.tokens</name>
  978. <value>true</value>
  979. <description> if false - do not unregister/cancel delegation tokens from
  980. renewal, because same tokens may be used by spawned jobs
  981. </description>
  982. </property>
  983. <property>
  984. <name>mapreduce.shuffle.port</name>
  985. <value>13562</value>
  986. <description>Default port that the ShuffleHandler will run on. ShuffleHandler
  987. is a service run at the NodeManager to facilitate transfers of intermediate
  988. Map outputs to requesting Reducers.
  989. </description>
  990. </property>
  991. <property>
  992. <name>mapreduce.job.reduce.shuffle.consumer.plugin.class</name>
  993. <value>org.apache.hadoop.mapreduce.task.reduce.Shuffle</value>
  994. <description>
  995. Name of the class whose instance will be used
  996. to send shuffle requests by reducetasks of this job.
  997. The class must be an instance of org.apache.hadoop.mapred.ShuffleConsumerPlugin.
  998. </description>
  999. </property>
  1000. <!-- MR YARN Application properties -->
  1001. <property>
  1002. <name>mapreduce.job.counters.limit</name>
  1003. <value>120</value>
  1004. <description>Limit on the number of user counters allowed per job.
  1005. </description>
  1006. </property>
  1007. <property>
  1008. <name>mapreduce.framework.name</name>
  1009. <value>local</value>
  1010. <description>The runtime framework for executing MapReduce jobs.
  1011. Can be one of local, classic or yarn.
  1012. </description>
  1013. </property>
  1014. <property>
  1015. <name>yarn.app.mapreduce.am.staging-dir</name>
  1016. <value>/tmp/hadoop-yarn/staging</value>
  1017. <description>The staging dir used while submitting jobs.
  1018. </description>
  1019. </property>
  1020. <property>
  1021. <name>mapreduce.am.max-attempts</name>
  1022. <value>2</value>
  1023. <description>The maximum number of application attempts. It is a
  1024. application-specific setting. It should not be larger than the global number
  1025. set by resourcemanager. Otherwise, it will be override. The default number is
  1026. set to 2, to allow at least one retry for AM.</description>
  1027. </property>
  1028. <!-- Job Notification Configuration -->
  1029. <property>
  1030. <name>mapreduce.job.end-notification.url</name>
  1031. <!--<value>http://localhost:8080/jobstatus.php?jobId=$jobId&amp;jobStatus=$jobStatus</value>-->
  1032. <description>Indicates url which will be called on completion of job to inform
  1033. end status of job.
  1034. User can give at most 2 variables with URI : $jobId and $jobStatus.
  1035. If they are present in URI, then they will be replaced by their
  1036. respective values.
  1037. </description>
  1038. </property>
  1039. <property>
  1040. <name>mapreduce.job.end-notification.retry.attempts</name>
  1041. <value>0</value>
  1042. <description>The number of times the submitter of the job wants to retry job
  1043. end notification if it fails. This is capped by
  1044. mapreduce.job.end-notification.max.attempts</description>
  1045. </property>
  1046. <property>
  1047. <name>mapreduce.job.end-notification.retry.interval</name>
  1048. <value>1000</value>
  1049. <description>The number of milliseconds the submitter of the job wants to
  1050. wait before job end notification is retried if it fails. This is capped by
  1051. mapreduce.job.end-notification.max.retry.interval</description>
  1052. </property>
  1053. <property>
  1054. <name>mapreduce.job.end-notification.max.attempts</name>
  1055. <value>5</value>
  1056. <final>true</final>
  1057. <description>The maximum number of times a URL will be read for providing job
  1058. end notification. Cluster administrators can set this to limit how long
  1059. after end of a job, the Application Master waits before exiting. Must be
  1060. marked as final to prevent users from overriding this.
  1061. </description>
  1062. </property>
  1063. <property>
  1064. <name>mapreduce.job.log4j-properties-file</name>
  1065. <value></value>
  1066. <description>Used to override the default settings of log4j in container-log4j.properties
  1067. for NodeManager. Like container-log4j.properties, it requires certain
  1068. framework appenders properly defined in this overriden file. The file on the
  1069. path will be added to distributed cache and classpath. If no-scheme is given
  1070. in the path, it defaults to point to a log4j file on the local FS.
  1071. </description>
  1072. </property>
  1073. <property>
  1074. <name>mapreduce.job.end-notification.max.retry.interval</name>
  1075. <value>5000</value>
  1076. <final>true</final>
  1077. <description>The maximum amount of time (in milliseconds) to wait before
  1078. retrying job end notification. Cluster administrators can set this to
  1079. limit how long the Application Master waits before exiting. Must be marked
  1080. as final to prevent users from overriding this.</description>
  1081. </property>
  1082. <property>
  1083. <name>yarn.app.mapreduce.am.env</name>
  1084. <value></value>
  1085. <description>User added environment variables for the MR App Master
  1086. processes. Example :
  1087. 1) A=foo This will set the env variable A to foo
  1088. 2) B=$B:c This is inherit tasktracker's B env variable.
  1089. </description>
  1090. </property>
  1091. <property>
  1092. <name>yarn.app.mapreduce.am.admin.user.env</name>
  1093. <value></value>
  1094. <description> Environment variables for the MR App Master
  1095. processes for admin purposes. These values are set first and can be
  1096. overridden by the user env (yarn.app.mapreduce.am.env) Example :
  1097. 1) A=foo This will set the env variable A to foo
  1098. 2) B=$B:c This is inherit app master's B env variable.
  1099. </description>
  1100. </property>
  1101. <property>
  1102. <name>yarn.app.mapreduce.am.command-opts</name>
  1103. <value>-Xmx1024m</value>
  1104. <description>Java opts for the MR App Master processes.
  1105. The following symbol, if present, will be interpolated: @taskid@ is replaced
  1106. by current TaskID. Any other occurrences of '@' will go unchanged.
  1107. For example, to enable verbose gc logging to a file named for the taskid in
  1108. /tmp and to set the heap maximum to be a gigabyte, pass a 'value' of:
  1109. -Xmx1024m -verbose:gc -Xloggc:/tmp/@taskid@.gc
  1110. Usage of -Djava.library.path can cause programs to no longer function if
  1111. hadoop native libraries are used. These values should instead be set as part
  1112. of LD_LIBRARY_PATH in the map / reduce JVM env using the mapreduce.map.env and
  1113. mapreduce.reduce.env config settings.
  1114. </description>
  1115. </property>
  1116. <property>
  1117. <name>yarn.app.mapreduce.am.admin-command-opts</name>
  1118. <value></value>
  1119. <description>Java opts for the MR App Master processes for admin purposes.
  1120. It will appears before the opts set by yarn.app.mapreduce.am.command-opts and
  1121. thus its options can be overridden user.
  1122. Usage of -Djava.library.path can cause programs to no longer function if
  1123. hadoop native libraries are used. These values should instead be set as part
  1124. of LD_LIBRARY_PATH in the map / reduce JVM env using the mapreduce.map.env and
  1125. mapreduce.reduce.env config settings.
  1126. </description>
  1127. </property>
  1128. <property>
  1129. <name>yarn.app.mapreduce.am.job.task.listener.thread-count</name>
  1130. <value>30</value>
  1131. <description>The number of threads used to handle RPC calls in the
  1132. MR AppMaster from remote tasks</description>
  1133. </property>
  1134. <property>
  1135. <name>yarn.app.mapreduce.am.job.client.port-range</name>
  1136. <value></value>
  1137. <description>Range of ports that the MapReduce AM can use when binding.
  1138. Leave blank if you want all possible ports.
  1139. For example 50000-50050,50100-50200</description>
  1140. </property>
  1141. <property>
  1142. <name>yarn.app.mapreduce.am.job.committer.cancel-timeout</name>
  1143. <value>60000</value>
  1144. <description>The amount of time in milliseconds to wait for the output
  1145. committer to cancel an operation if the job is killed</description>
  1146. </property>
  1147. <property>
  1148. <name>yarn.app.mapreduce.am.job.committer.commit-window</name>
  1149. <value>10000</value>
  1150. <description>Defines a time window in milliseconds for output commit
  1151. operations. If contact with the RM has occurred within this window then
  1152. commits are allowed, otherwise the AM will not allow output commits until
  1153. contact with the RM has been re-established.</description>
  1154. </property>
  1155. <property>
  1156. <name>yarn.app.mapreduce.am.scheduler.heartbeat.interval-ms</name>
  1157. <value>1000</value>
  1158. <description>The interval in ms at which the MR AppMaster should send
  1159. heartbeats to the ResourceManager</description>
  1160. </property>
  1161. <property>
  1162. <name>yarn.app.mapreduce.client-am.ipc.max-retries</name>
  1163. <value>3</value>
  1164. <description>The number of client retries to the AM - before reconnecting
  1165. to the RM to fetch Application Status.</description>
  1166. </property>
  1167. <property>
  1168. <name>yarn.app.mapreduce.client-am.ipc.max-retries-on-timeouts</name>
  1169. <value>3</value>
  1170. <description>The number of client retries on socket timeouts to the AM - before
  1171. reconnecting to the RM to fetch Application Status.</description>
  1172. </property>
  1173. <property>
  1174. <name>yarn.app.mapreduce.client.max-retries</name>
  1175. <value>3</value>
  1176. <description>The number of client retries to the RM/HS before
  1177. throwing exception. This is a layer above the ipc.</description>
  1178. </property>
  1179. <property>
  1180. <name>yarn.app.mapreduce.am.resource.mb</name>
  1181. <value>1536</value>
  1182. <description>The amount of memory the MR AppMaster needs.</description>
  1183. </property>
  1184. <property>
  1185. <name>yarn.app.mapreduce.am.resource.cpu-vcores</name>
  1186. <value>1</value>
  1187. <description>
  1188. The number of virtual CPU cores the MR AppMaster needs.
  1189. </description>
  1190. </property>
  1191. <property>
  1192. <description>CLASSPATH for MR applications. A comma-separated list
  1193. of CLASSPATH entries. If mapreduce.application.framework is set then this
  1194. must specify the appropriate classpath for that archive, and the name of
  1195. the archive must be present in the classpath.
  1196. If mapreduce.app-submission.cross-platform is false, platform-specific
  1197. environment vairable expansion syntax would be used to construct the default
  1198. CLASSPATH entries.
  1199. For Linux:
  1200. $HADOOP_MAPRED_HOME/share/hadoop/mapreduce/*,
  1201. $HADOOP_MAPRED_HOME/share/hadoop/mapreduce/lib/*.
  1202. For Windows:
  1203. %HADOOP_MAPRED_HOME%/share/hadoop/mapreduce/*,
  1204. %HADOOP_MAPRED_HOME%/share/hadoop/mapreduce/lib/*.
  1205. If mapreduce.app-submission.cross-platform is true, platform-agnostic default
  1206. CLASSPATH for MR applications would be used:
  1207. {{HADOOP_MAPRED_HOME}}/share/hadoop/mapreduce/*,
  1208. {{HADOOP_MAPRED_HOME}}/share/hadoop/mapreduce/lib/*
  1209. Parameter expansion marker will be replaced by NodeManager on container
  1210. launch based on the underlying OS accordingly.
  1211. </description>
  1212. <name>mapreduce.application.classpath</name>
  1213. <value></value>
  1214. </property>
  1215. <property>
  1216. <description>If enabled, user can submit an application cross-platform
  1217. i.e. submit an application from a Windows client to a Linux/Unix server or
  1218. vice versa.
  1219. </description>
  1220. <name>mapreduce.app-submission.cross-platform</name>
  1221. <value>false</value>
  1222. </property>
  1223. <property>
  1224. <description>Path to the MapReduce framework archive. If set, the framework
  1225. archive will automatically be distributed along with the job, and this
  1226. path would normally reside in a public location in an HDFS filesystem. As
  1227. with distributed cache files, this can be a URL with a fragment specifying
  1228. the alias to use for the archive name. For example,
  1229. hdfs:/mapred/framework/hadoop-mapreduce-2.1.1.tar.gz#mrframework would
  1230. alias the localized archive as "mrframework".
  1231. Note that mapreduce.application.classpath must include the appropriate
  1232. classpath for the specified framework. The base name of the archive, or
  1233. alias of the archive if an alias is used, must appear in the specified
  1234. classpath.
  1235. </description>
  1236. <name>mapreduce.application.framework.path</name>
  1237. <value></value>
  1238. </property>
  1239. <property>
  1240. <name>mapreduce.job.classloader</name>
  1241. <value>false</value>
  1242. <description>Whether to use a separate (isolated) classloader for
  1243. user classes in the task JVM.</description>
  1244. </property>
  1245. <property>
  1246. <name>mapreduce.job.classloader.system.classes</name>
  1247. <value></value>
  1248. <description>Used to override the default definition of the system classes for
  1249. the job classloader. The system classes are a comma-separated list of
  1250. patterns that indicate whether to load a class from the system classpath,
  1251. instead from the user-supplied JARs, when mapreduce.job.classloader is
  1252. enabled.
  1253. A positive pattern is defined as:
  1254. 1. A single class name 'C' that matches 'C' and transitively all nested
  1255. classes 'C$*' defined in C;
  1256. 2. A package name ending with a '.' (e.g., "com.example.") that matches
  1257. all classes from that package.
  1258. A negative pattern is defined by a '-' in front of a positive pattern
  1259. (e.g., "-com.example.").
  1260. A class is considered a system class if and only if it matches one of the
  1261. positive patterns and none of the negative ones. More formally:
  1262. A class is a member of the inclusion set I if it matches one of the positive
  1263. patterns. A class is a member of the exclusion set E if it matches one of
  1264. the negative patterns. The set of system classes S = I \ E.
  1265. </description>
  1266. </property>
  1267. <property>
  1268. <name>mapreduce.jvm.system-properties-to-log</name>
  1269. <value>os.name,os.version,java.home,java.runtime.version,java.vendor,java.version,java.vm.name,java.class.path,java.io.tmpdir,user.dir,user.name</value>
  1270. <description>Comma-delimited list of system properties to log on mapreduce JVM start</description>
  1271. </property>
  1272. <!-- jobhistory properties -->
  1273. <property>
  1274. <name>mapreduce.jobhistory.address</name>
  1275. <value>0.0.0.0:10020</value>
  1276. <description>MapReduce JobHistory Server IPC host:port</description>
  1277. </property>
  1278. <property>
  1279. <name>mapreduce.jobhistory.webapp.address</name>
  1280. <value>0.0.0.0:19888</value>
  1281. <description>MapReduce JobHistory Server Web UI host:port</description>
  1282. </property>
  1283. <property>
  1284. <name>mapreduce.jobhistory.keytab</name>
  1285. <description>
  1286. Location of the kerberos keytab file for the MapReduce
  1287. JobHistory Server.
  1288. </description>
  1289. <value>/etc/security/keytab/jhs.service.keytab</value>
  1290. </property>
  1291. <property>
  1292. <name>mapreduce.jobhistory.principal</name>
  1293. <description>
  1294. Kerberos principal name for the MapReduce JobHistory Server.
  1295. </description>
  1296. <value>jhs/_HOST@REALM.TLD</value>
  1297. </property>
  1298. <property>
  1299. <name>mapreduce.jobhistory.intermediate-done-dir</name>
  1300. <value>${yarn.app.mapreduce.am.staging-dir}/history/done_intermediate</value>
  1301. <description></description>
  1302. </property>
  1303. <property>
  1304. <name>mapreduce.jobhistory.done-dir</name>
  1305. <value>${yarn.app.mapreduce.am.staging-dir}/history/done</value>
  1306. <description></description>
  1307. </property>
  1308. <property>
  1309. <name>mapreduce.jobhistory.cleaner.enable</name>
  1310. <value>true</value>
  1311. <description></description>
  1312. </property>
  1313. <property>
  1314. <name>mapreduce.jobhistory.cleaner.interval-ms</name>
  1315. <value>86400000</value>
  1316. <description> How often the job history cleaner checks for files to delete,
  1317. in milliseconds. Defaults to 86400000 (one day). Files are only deleted if
  1318. they are older than mapreduce.jobhistory.max-age-ms.
  1319. </description>
  1320. </property>
  1321. <property>
  1322. <name>mapreduce.jobhistory.max-age-ms</name>
  1323. <value>604800000</value>
  1324. <description> Job history files older than this many milliseconds will
  1325. be deleted when the history cleaner runs. Defaults to 604800000 (1 week).
  1326. </description>
  1327. </property>
  1328. <property>
  1329. <name>mapreduce.jobhistory.client.thread-count</name>
  1330. <value>10</value>
  1331. <description>The number of threads to handle client API requests</description>
  1332. </property>
  1333. <property>
  1334. <name>mapreduce.jobhistory.datestring.cache.size</name>
  1335. <value>200000</value>
  1336. <description>Size of the date string cache. Effects the number of directories
  1337. which will be scanned to find a job.</description>
  1338. </property>
  1339. <property>
  1340. <name>mapreduce.jobhistory.joblist.cache.size</name>
  1341. <value>20000</value>
  1342. <description>Size of the job list cache</description>
  1343. </property>
  1344. <property>
  1345. <name>mapreduce.jobhistory.loadedjobs.cache.size</name>
  1346. <value>5</value>
  1347. <description>Size of the loaded job cache</description>
  1348. </property>
  1349. <property>
  1350. <name>mapreduce.jobhistory.move.interval-ms</name>
  1351. <value>180000</value>
  1352. <description>Scan for history files to more from intermediate done dir to done
  1353. dir at this frequency.
  1354. </description>
  1355. </property>
  1356. <property>
  1357. <name>mapreduce.jobhistory.move.thread-count</name>
  1358. <value>3</value>
  1359. <description>The number of threads used to move files.</description>
  1360. </property>
  1361. <property>
  1362. <name>mapreduce.jobhistory.store.class</name>
  1363. <value></value>
  1364. <description>The HistoryStorage class to use to cache history data.</description>
  1365. </property>
  1366. <property>
  1367. <name>mapreduce.jobhistory.minicluster.fixed.ports</name>
  1368. <value>false</value>
  1369. <description>Whether to use fixed ports with the minicluster</description>
  1370. </property>
  1371. <property>
  1372. <name>mapreduce.jobhistory.admin.address</name>
  1373. <value>0.0.0.0:10033</value>
  1374. <description>The address of the History server admin interface.</description>
  1375. </property>
  1376. <property>
  1377. <name>mapreduce.jobhistory.admin.acl</name>
  1378. <value>*</value>
  1379. <description>ACL of who can be admin of the History server.</description>
  1380. </property>
  1381. <property>
  1382. <name>mapreduce.jobhistory.recovery.enable</name>
  1383. <value>false</value>
  1384. <description>Enable the history server to store server state and recover
  1385. server state upon startup. If enabled then
  1386. mapreduce.jobhistory.recovery.store.class must be specified.</description>
  1387. </property>
  1388. <property>
  1389. <name>mapreduce.jobhistory.recovery.store.class</name>
  1390. <value>org.apache.hadoop.mapreduce.v2.hs.HistoryServerFileSystemStateStoreService</value>
  1391. <description>The HistoryServerStateStoreService class to store history server
  1392. state for recovery.</description>
  1393. </property>
  1394. <property>
  1395. <name>mapreduce.jobhistory.recovery.store.fs.uri</name>
  1396. <value>${hadoop.tmp.dir}/mapred/history/recoverystore</value>
  1397. <!--value>hdfs://localhost:9000/mapred/history/recoverystore</value-->
  1398. <description>The URI where history server state will be stored if
  1399. HistoryServerFileSystemStateStoreService is configured as the recovery
  1400. storage class.</description>
  1401. </property>
  1402. <property>
  1403. <name>mapreduce.jobhistory.recovery.store.leveldb.path</name>
  1404. <value>${hadoop.tmp.dir}/mapred/history/recoverystore</value>
  1405. <description>The URI where history server state will be stored if
  1406. HistoryServerLeveldbSystemStateStoreService is configured as the recovery
  1407. storage class.</description>
  1408. </property>
  1409. <property>
  1410. <name>mapreduce.jobhistory.http.policy</name>
  1411. <value>HTTP_ONLY</value>
  1412. <description>
  1413. This configures the HTTP endpoint for JobHistoryServer web UI.
  1414. The following values are supported:
  1415. - HTTP_ONLY : Service is provided only on http
  1416. - HTTPS_ONLY : Service is provided only on https
  1417. </description>
  1418. </property>
  1419. <property>
  1420. <name>mapreduce.job.heap.memory-mb.ratio</name>
  1421. <value>0.8</value>
  1422. <description>The ratio of heap-size to container-size. If no -Xmx is
  1423. specified, it is calculated as
  1424. (mapreduce.{map|reduce}.memory.mb * mapreduce.heap.memory-mb.ratio).
  1425. If -Xmx is specified but not mapreduce.{map|reduce}.memory.mb, it is
  1426. calculated as (heapSize / mapreduce.heap.memory-mb.ratio).
  1427. </description>
  1428. </property>
  1429. </configuration>