mapred-default.xml 83 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285
  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.hdfs-servers</name>
  23. <value>${fs.defaultFS}</value>
  24. </property>
  25. <property>
  26. <name>mapreduce.job.committer.setup.cleanup.needed</name>
  27. <value>true</value>
  28. <description> true, if job needs job-setup and job-cleanup.
  29. false, otherwise
  30. </description>
  31. </property>
  32. <!-- i/o properties -->
  33. <property>
  34. <name>mapreduce.task.io.sort.factor</name>
  35. <value>10</value>
  36. <description>The number of streams to merge at once while sorting
  37. files. This determines the number of open file handles.</description>
  38. </property>
  39. <property>
  40. <name>mapreduce.task.io.sort.mb</name>
  41. <value>100</value>
  42. <description>The total amount of buffer memory to use while sorting
  43. files, in megabytes. By default, gives each merge stream 1MB, which
  44. should minimize seeks.</description>
  45. </property>
  46. <property>
  47. <name>mapreduce.map.sort.spill.percent</name>
  48. <value>0.80</value>
  49. <description>The soft limit in the serialization buffer. Once reached, a
  50. thread will begin to spill the contents to disk in the background. Note that
  51. collection will not block if this threshold is exceeded while a spill is
  52. already in progress, so spills may be larger than this threshold when it is
  53. set to less than .5</description>
  54. </property>
  55. <property>
  56. <name>mapreduce.task.spill.files.count.limit</name>
  57. <value>-1</value>
  58. <description>Number of spill files that can be created by a MapTask.
  59. After breaching this, task will fail. Default value for this config is -1
  60. which indicates that there is no limit on number of spill files being
  61. created</description>
  62. </property>
  63. <property>
  64. <name>mapreduce.job.local-fs.single-disk-limit.bytes</name>
  65. <value>-1</value>
  66. <description>Enable an in task monitor thread to watch for single disk
  67. consumption by jobs. By setting this to x nr of bytes, the task will fast
  68. fail in case it is reached. This is a per disk configuration.</description>
  69. </property>
  70. <property>
  71. <name>mapreduce.job.local-fs.single-disk-limit.check.interval-ms</name>
  72. <value>5000</value>
  73. <description>Interval of disk limit check to run in ms.</description>
  74. </property>
  75. <property>
  76. <name>mapreduce.job.local-fs.single-disk-limit.check.kill-limit-exceed</name>
  77. <value>true</value>
  78. <description>If mapreduce.job.local-fs.single-disk-limit.bytes is triggered
  79. should the task be killed or logged. If false the intent to kill the task
  80. is only logged in the container logs.</description>
  81. </property>
  82. <property>
  83. <name>mapreduce.job.dfs.storage.capacity.kill-limit-exceed</name>
  84. <value>false</value>
  85. <description>Whether to fast fail the task when exceeds allocated storage
  86. capacity in the cluster filesystem(ClusterStorageCapacityExceededException
  87. happens), for example, exceeds the dfs quota limitation. If true, the
  88. task will fast fail. If false, the task will get retried.</description>
  89. </property>
  90. <property>
  91. <name>mapreduce.job.maps</name>
  92. <value>2</value>
  93. <description>The default number of map tasks per job.
  94. Ignored when mapreduce.framework.name is "local".
  95. </description>
  96. </property>
  97. <property>
  98. <name>mapreduce.job.reduces</name>
  99. <value>1</value>
  100. <description>The default number of reduce tasks per job. Typically set to 99%
  101. of the cluster's reduce capacity, so that if a node fails the reduces can
  102. still be executed in a single wave.
  103. Ignored when mapreduce.framework.name is "local".
  104. </description>
  105. </property>
  106. <property>
  107. <name>mapreduce.job.running.map.limit</name>
  108. <value>0</value>
  109. <description>The maximum number of simultaneous map tasks per job.
  110. There is no limit if this value is 0 or negative.
  111. </description>
  112. </property>
  113. <property>
  114. <name>mapreduce.job.running.reduce.limit</name>
  115. <value>0</value>
  116. <description>The maximum number of simultaneous reduce tasks per job.
  117. There is no limit if this value is 0 or negative.
  118. </description>
  119. </property>
  120. <property>
  121. <name>mapreduce.job.max.map</name>
  122. <value>-1</value>
  123. <description>Limit on the number of map tasks allowed per job.
  124. There is no limit if this value is negative.
  125. </description>
  126. </property>
  127. <property>
  128. <name>mapreduce.job.reducer.preempt.delay.sec</name>
  129. <value>0</value>
  130. <description>The threshold (in seconds) after which an unsatisfied
  131. mapper request triggers reducer preemption when there is no anticipated
  132. headroom. If set to 0 or a negative value, the reducer is preempted as
  133. soon as lack of headroom is detected. Default is 0.
  134. </description>
  135. </property>
  136. <property>
  137. <name>mapreduce.job.reducer.unconditional-preempt.delay.sec</name>
  138. <value>300</value>
  139. <description>The threshold (in seconds) after which an unsatisfied
  140. mapper request triggers a forced reducer preemption irrespective of the
  141. anticipated headroom. By default, it is set to 5 mins. Setting it to 0
  142. leads to immediate reducer preemption. Setting to -1 disables this
  143. preemption altogether.
  144. </description>
  145. </property>
  146. <property>
  147. <name>mapreduce.job.max.split.locations</name>
  148. <value>15</value>
  149. <description>The max number of block locations to store for each split for
  150. locality calculation.
  151. </description>
  152. </property>
  153. <property>
  154. <name>mapreduce.job.split.metainfo.maxsize</name>
  155. <value>10000000</value>
  156. <description>The maximum permissible size of the split metainfo file.
  157. The MapReduce ApplicationMaster won't attempt to read submitted split metainfo
  158. files bigger than this configured value.
  159. No limits if set to -1.
  160. </description>
  161. </property>
  162. <property>
  163. <name>mapreduce.map.maxattempts</name>
  164. <value>4</value>
  165. <description>Expert: The maximum number of attempts per map task.
  166. In other words, framework will try to execute a map task these many number
  167. of times before giving up on it.
  168. </description>
  169. </property>
  170. <property>
  171. <name>mapreduce.reduce.maxattempts</name>
  172. <value>4</value>
  173. <description>Expert: The maximum number of attempts per reduce task.
  174. In other words, framework will try to execute a reduce task these many number
  175. of times before giving up on it.
  176. </description>
  177. </property>
  178. <property>
  179. <name>mapreduce.reduce.shuffle.fetch.retry.enabled</name>
  180. <value>${yarn.nodemanager.recovery.enabled}</value>
  181. <description>Set to enable fetch retry during host restart.</description>
  182. </property>
  183. <property>
  184. <name>mapreduce.reduce.shuffle.fetch.retry.interval-ms</name>
  185. <value>1000</value>
  186. <description>Time of interval that fetcher retry to fetch again when some
  187. non-fatal failure happens because of some events like NM restart.
  188. </description>
  189. </property>
  190. <property>
  191. <name>mapreduce.reduce.shuffle.fetch.retry.timeout-ms</name>
  192. <value>30000</value>
  193. <description>Timeout value for fetcher to retry to fetch again when some
  194. non-fatal failure happens because of some events like NM restart.</description>
  195. </property>
  196. <property>
  197. <name>mapreduce.reduce.shuffle.retry-delay.max.ms</name>
  198. <value>60000</value>
  199. <description>The maximum number of ms the reducer will delay before retrying
  200. to download map data.
  201. </description>
  202. </property>
  203. <property>
  204. <name>mapreduce.reduce.shuffle.parallelcopies</name>
  205. <value>5</value>
  206. <description>The default number of parallel transfers run by reduce
  207. during the copy(shuffle) phase.
  208. </description>
  209. </property>
  210. <property>
  211. <name>mapreduce.reduce.shuffle.connect.timeout</name>
  212. <value>180000</value>
  213. <description>Expert: The maximum amount of time (in milli seconds) reduce
  214. task spends in trying to connect to a remote node for getting map output.
  215. </description>
  216. </property>
  217. <property>
  218. <name>mapreduce.reduce.shuffle.read.timeout</name>
  219. <value>180000</value>
  220. <description>Expert: The maximum amount of time (in milli seconds) reduce
  221. task waits for map output data to be available for reading after obtaining
  222. connection.
  223. </description>
  224. </property>
  225. <property>
  226. <name>mapreduce.shuffle.listen.queue.size</name>
  227. <value>128</value>
  228. <description>The length of the shuffle server listen queue.</description>
  229. </property>
  230. <property>
  231. <name>mapreduce.shuffle.connection-keep-alive.enable</name>
  232. <value>false</value>
  233. <description>set to true to support keep-alive connections.</description>
  234. </property>
  235. <property>
  236. <name>mapreduce.shuffle.connection-keep-alive.timeout</name>
  237. <value>5</value>
  238. <description>The number of seconds a shuffle client attempts to retain
  239. http connection. Refer "Keep-Alive: timeout=" header in
  240. Http specification
  241. </description>
  242. </property>
  243. <property>
  244. <name>mapreduce.task.timeout</name>
  245. <value>600000</value>
  246. <description>The number of milliseconds before a task will be
  247. terminated if it neither reads an input, writes an output, nor
  248. updates its status string. A value of 0 disables the timeout.
  249. </description>
  250. </property>
  251. <property>
  252. <name>mapreduce.task.stuck.timeout-ms</name>
  253. <value>600000</value>
  254. <description>The max timeout before receiving remote task's first heartbeat.
  255. This parameter is in order to avoid waiting for the container
  256. to start indefinitely, which made task stuck in the NEW state.
  257. A value of 0 disables the timeout.
  258. </description>
  259. </property>
  260. <property>
  261. <name>mapreduce.task.ping-for-liveliness-check.enabled</name>
  262. <value>false</value>
  263. <description>Whether to consider ping from tasks in liveliness check.
  264. </description>
  265. </property>
  266. <property>
  267. <name>mapreduce.map.memory.mb</name>
  268. <value>-1</value>
  269. <description>The amount of memory to request from the scheduler for each
  270. map task. If this is not specified or is non-positive, it is inferred from
  271. mapreduce.map.java.opts and mapreduce.job.heap.memory-mb.ratio.
  272. If java-opts are also not specified, we set it to 1024.
  273. </description>
  274. </property>
  275. <property>
  276. <name>mapreduce.map.cpu.vcores</name>
  277. <value>1</value>
  278. <description>The number of virtual cores to request from the scheduler for
  279. each map task.
  280. </description>
  281. </property>
  282. <property>
  283. <name>mapreduce.reduce.memory.mb</name>
  284. <value>-1</value>
  285. <description>The amount of memory to request from the scheduler for each
  286. reduce task. If this is not specified or is non-positive, it is inferred
  287. from mapreduce.reduce.java.opts and mapreduce.job.heap.memory-mb.ratio.
  288. If java-opts are also not specified, we set it to 1024.
  289. </description>
  290. </property>
  291. <property>
  292. <name>mapreduce.reduce.cpu.vcores</name>
  293. <value>1</value>
  294. <description>The number of virtual cores to request from the scheduler for
  295. each reduce task.
  296. </description>
  297. </property>
  298. <property>
  299. <name>mapred.child.java.opts</name>
  300. <value></value>
  301. <description>Java opts for the task processes.
  302. The following symbol, if present, will be interpolated: @taskid@ is replaced
  303. by current TaskID. Any other occurrences of '@' will go unchanged.
  304. For example, to enable verbose gc logging to a file named for the taskid in
  305. /tmp and to set the heap maximum to be a gigabyte, pass a 'value' of:
  306. -Xmx1024m -verbose:gc -Xloggc:/tmp/@taskid@.gc
  307. Usage of -Djava.library.path can cause programs to no longer function if
  308. hadoop native libraries are used. These values should instead be set as part
  309. of LD_LIBRARY_PATH in the map / reduce JVM env using the mapreduce.map.env and
  310. mapreduce.reduce.env config settings.
  311. If -Xmx is not set, it is inferred from mapreduce.{map|reduce}.memory.mb and
  312. mapreduce.job.heap.memory-mb.ratio.
  313. </description>
  314. </property>
  315. <!-- This is commented out so that it won't override mapred.child.java.opts.
  316. <property>
  317. <name>mapreduce.map.java.opts</name>
  318. <value></value>
  319. <description>Java opts only for the child processes that are maps. If set,
  320. this will be used instead of mapred.child.java.opts. If -Xmx is not set,
  321. it is inferred from mapreduce.map.memory.mb and
  322. mapreduce.job.heap.memory-mb.ratio.
  323. </description>
  324. </property>
  325. -->
  326. <!-- This is commented out so that it won't override mapred.child.java.opts.
  327. <property>
  328. <name>mapreduce.reduce.java.opts</name>
  329. <value></value>
  330. <description>Java opts only for the child processes that are reduces. If set,
  331. this will be used instead of mapred.child.java.opts. If -Xmx is not set,
  332. it is inferred from mapreduce.reduce.memory.mb and
  333. mapreduce.job.heap.memory-mb.ratio.
  334. </description>
  335. </property>
  336. -->
  337. <property>
  338. <name>mapred.child.env</name>
  339. <value></value>
  340. <description>User added environment variables for the task processes,
  341. specified as a comma separated list.
  342. Example :
  343. 1) A=foo This will set the env variable A to foo
  344. 2) B=$B:c This is inherit nodemanager's B env variable on Unix.
  345. 3) B=%B%;c This is inherit nodemanager's B env variable on Windows.
  346. To specify a comma separated list of environment variables specifically for
  347. map or reduce tasks, use the mapreduce.map.env or mapreduce.reduce.env
  348. properties.
  349. To define environment variables individually for map or reduce tasks,
  350. you can specify multiple properties of the form mapreduce.map.env.VARNAME
  351. or mapreduce.reduce.env.VARNAME, where VARNAME is the name of the
  352. environment variable. This is the only way to add a variable when its value
  353. contains commas.
  354. </description>
  355. </property>
  356. <!-- This is commented out so that it won't override mapred.child.env.
  357. <property>
  358. <name>mapreduce.map.env</name>
  359. <value></value>
  360. <description>User added environment variables for the map task processes,
  361. specified as a comma separated list.
  362. Example:
  363. VAR1=value1,VAR2=value2
  364. To define environment variables individually, you can specify
  365. multiple properties of the form mapreduce.map.env.VARNAME,
  366. where VARNAME is the name of the environment variable. This is the only
  367. way to add a variable when its value contains commas.
  368. </description>
  369. </property>
  370. -->
  371. <!-- This is commented out so that it won't override mapred.child.env.
  372. <property>
  373. <name>mapreduce.reduce.env</name>
  374. <value></value>
  375. <description>User added environment variables for the reduce task processes,
  376. specified as a comma separated list.
  377. Example:
  378. VAR1=value1,VAR2=value2
  379. To define environment variables individually, you can specify
  380. multiple properties of the form mapreduce.reduce.env.VARNAME,
  381. where VARNAME is the name of the environment variable. This is the only
  382. way to add a variable when its value contains commas.
  383. contains commas.
  384. </description>
  385. </property>
  386. -->
  387. <property>
  388. <name>mapreduce.admin.user.env</name>
  389. <value></value>
  390. <description>
  391. Expert: Additional execution environment entries for
  392. map and reduce task processes. This is not an additive property.
  393. You must preserve the original value if you want your map and
  394. reduce tasks to have access to native libraries (compression, etc).
  395. When this value is empty, the command to set execution
  396. environment will be OS dependent:
  397. For linux, use LD_LIBRARY_PATH=$HADOOP_COMMON_HOME/lib/native.
  398. For windows, use PATH = %PATH%;%HADOOP_COMMON_HOME%\\bin.
  399. To define environment variables individually, you can specify
  400. multiple properties of the form mapreduce.admin.user.env.VARNAME,
  401. where VARNAME is the name of the environment variable. This is the only
  402. way to add a variable when its value contains commas.
  403. </description>
  404. </property>
  405. <property>
  406. <name>yarn.app.mapreduce.am.log.level</name>
  407. <value>INFO</value>
  408. <description>The logging level for the MR ApplicationMaster. The allowed
  409. levels are: OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE and ALL.
  410. The setting here could be overriden if "mapreduce.job.log4j-properties-file"
  411. is set.
  412. </description>
  413. </property>
  414. <property>
  415. <name>mapreduce.map.log.level</name>
  416. <value>INFO</value>
  417. <description>The logging level for the map task. The allowed levels are:
  418. OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE and ALL.
  419. The setting here could be overridden if "mapreduce.job.log4j-properties-file"
  420. is set.
  421. </description>
  422. </property>
  423. <property>
  424. <name>mapreduce.reduce.log.level</name>
  425. <value>INFO</value>
  426. <description>The logging level for the reduce task. The allowed levels are:
  427. OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE and ALL.
  428. The setting here could be overridden if "mapreduce.job.log4j-properties-file"
  429. is set.
  430. </description>
  431. </property>
  432. <property>
  433. <name>mapreduce.reduce.merge.inmem.threshold</name>
  434. <value>1000</value>
  435. <description>The threshold, in terms of the number of files
  436. for the in-memory merge process. When we accumulate threshold number of files
  437. we initiate the in-memory merge and spill to disk. A value of 0 or less than
  438. 0 indicates we want to DON'T have any threshold and instead depend only on
  439. the ramfs's memory consumption to trigger the merge.
  440. </description>
  441. </property>
  442. <property>
  443. <name>mapreduce.reduce.shuffle.merge.percent</name>
  444. <value>0.66</value>
  445. <description>The usage threshold at which an in-memory merge will be
  446. initiated, expressed as a percentage of the total memory allocated to
  447. storing in-memory map outputs, as defined by
  448. mapreduce.reduce.shuffle.input.buffer.percent.
  449. </description>
  450. </property>
  451. <property>
  452. <name>mapreduce.reduce.shuffle.input.buffer.percent</name>
  453. <value>0.70</value>
  454. <description>The percentage of memory to be allocated from the maximum heap
  455. size to storing map outputs during the shuffle.
  456. </description>
  457. </property>
  458. <property>
  459. <name>mapreduce.reduce.input.buffer.percent</name>
  460. <value>0.0</value>
  461. <description>The percentage of memory- relative to the maximum heap size- to
  462. retain map outputs during the reduce. When the shuffle is concluded, any
  463. remaining map outputs in memory must consume less than this threshold before
  464. the reduce can begin.
  465. </description>
  466. </property>
  467. <property>
  468. <name>mapreduce.reduce.shuffle.memory.limit.percent</name>
  469. <value>0.25</value>
  470. <description>Expert: Maximum percentage of the in-memory limit that a
  471. single shuffle can consume. Range of valid values is [0.0, 1.0]. If the value
  472. is 0.0 map outputs are shuffled directly to disk.</description>
  473. </property>
  474. <property>
  475. <name>mapreduce.shuffle.ssl.enabled</name>
  476. <value>false</value>
  477. <description>
  478. Whether to use SSL for for the Shuffle HTTP endpoints.
  479. </description>
  480. </property>
  481. <property>
  482. <name>mapreduce.shuffle.ssl.file.buffer.size</name>
  483. <value>65536</value>
  484. <description>Buffer size for reading spills from file when using SSL.
  485. </description>
  486. </property>
  487. <property>
  488. <name>mapreduce.shuffle.max.connections</name>
  489. <value>0</value>
  490. <description>Max allowed connections for the shuffle. Set to 0 (zero)
  491. to indicate no limit on the number of connections.
  492. </description>
  493. </property>
  494. <property>
  495. <name>mapreduce.shuffle.max.threads</name>
  496. <value>0</value>
  497. <description>Max allowed threads for serving shuffle connections. Set to zero
  498. to indicate the default of 2 times the number of available
  499. processors (as reported by Runtime.availableProcessors()). Netty is used to
  500. serve requests, so a thread is not needed for each connection.
  501. </description>
  502. </property>
  503. <property>
  504. <name>mapreduce.shuffle.transferTo.allowed</name>
  505. <value></value>
  506. <description>This option can enable/disable using nio transferTo method in
  507. the shuffle phase. NIO transferTo does not perform well on windows in the
  508. shuffle phase. Thus, with this configuration property it is possible to
  509. disable it, in which case custom transfer method will be used. Recommended
  510. value is false when running Hadoop on Windows. For Linux, it is recommended
  511. to set it to true. If nothing is set then the default value is false for
  512. Windows, and true for Linux.
  513. </description>
  514. </property>
  515. <property>
  516. <name>mapreduce.shuffle.transfer.buffer.size</name>
  517. <value>131072</value>
  518. <description>This property is used only if
  519. mapreduce.shuffle.transferTo.allowed is set to false. In that case,
  520. this property defines the size of the buffer used in the buffer copy code
  521. for the shuffle phase. The size of this buffer determines the size of the IO
  522. requests.
  523. </description>
  524. </property>
  525. <property>
  526. <name>mapreduce.reduce.markreset.buffer.percent</name>
  527. <value>0.0</value>
  528. <description>The percentage of memory -relative to the maximum heap size- to
  529. be used for caching values when using the mark-reset functionality.
  530. </description>
  531. </property>
  532. <property>
  533. <name>mapreduce.map.speculative</name>
  534. <value>true</value>
  535. <description>If true, then multiple instances of some map tasks
  536. may be executed in parallel.</description>
  537. </property>
  538. <property>
  539. <name>mapreduce.reduce.speculative</name>
  540. <value>true</value>
  541. <description>If true, then multiple instances of some reduce tasks
  542. may be executed in parallel.</description>
  543. </property>
  544. <property>
  545. <name>mapreduce.job.speculative.speculative-cap-running-tasks</name>
  546. <value>0.1</value>
  547. <description>The max percent (0-1) of running tasks that
  548. can be speculatively re-executed at any time.</description>
  549. </property>
  550. <property>
  551. <name>mapreduce.job.speculative.speculative-cap-total-tasks</name>
  552. <value>0.01</value>
  553. <description>The max percent (0-1) of all tasks that
  554. can be speculatively re-executed at any time.</description>
  555. </property>
  556. <property>
  557. <name>mapreduce.job.speculative.minimum-allowed-tasks</name>
  558. <value>10</value>
  559. <description>The minimum allowed tasks that
  560. can be speculatively re-executed at any time.</description>
  561. </property>
  562. <property>
  563. <name>mapreduce.job.speculative.retry-after-no-speculate</name>
  564. <value>1000</value>
  565. <description>The waiting time(ms) to do next round of speculation
  566. if there is no task speculated in this round.</description>
  567. </property>
  568. <property>
  569. <name>mapreduce.job.speculative.retry-after-speculate</name>
  570. <value>15000</value>
  571. <description>The waiting time(ms) to do next round of speculation
  572. if there are tasks speculated in this round.</description>
  573. </property>
  574. <property>
  575. <name>mapreduce.job.map.output.collector.class</name>
  576. <value>org.apache.hadoop.mapred.MapTask$MapOutputBuffer</value>
  577. <description>
  578. The MapOutputCollector implementation(s) to use. This may be a comma-separated
  579. list of class names, in which case the map task will try to initialize each
  580. of the collectors in turn. The first to successfully initialize will be used.
  581. </description>
  582. </property>
  583. <property>
  584. <name>mapreduce.job.speculative.slowtaskthreshold</name>
  585. <value>1.0</value>
  586. <description>The number of standard deviations by which a task's
  587. ave progress-rates must be lower than the average of all running tasks'
  588. for the task to be considered too slow.
  589. </description>
  590. </property>
  591. <property>
  592. <name>mapreduce.job.ubertask.enable</name>
  593. <value>false</value>
  594. <description>Whether to enable the small-jobs "ubertask" optimization,
  595. which runs "sufficiently small" jobs sequentially within a single JVM.
  596. "Small" is defined by the following maxmaps, maxreduces, and maxbytes
  597. settings. Note that configurations for application masters also affect
  598. the "Small" definition - yarn.app.mapreduce.am.resource.mb must be
  599. larger than both mapreduce.map.memory.mb and mapreduce.reduce.memory.mb,
  600. and yarn.app.mapreduce.am.resource.cpu-vcores must be larger than
  601. both mapreduce.map.cpu.vcores and mapreduce.reduce.cpu.vcores to enable
  602. ubertask. Users may override this value.
  603. </description>
  604. </property>
  605. <property>
  606. <name>mapreduce.job.ubertask.maxmaps</name>
  607. <value>9</value>
  608. <description>Threshold for number of maps, beyond which job is considered
  609. too big for the ubertasking optimization. Users may override this value,
  610. but only downward.
  611. </description>
  612. </property>
  613. <property>
  614. <name>mapreduce.job.ubertask.maxreduces</name>
  615. <value>1</value>
  616. <description>Threshold for number of reduces, beyond which job is considered
  617. too big for the ubertasking optimization. CURRENTLY THE CODE CANNOT SUPPORT
  618. MORE THAN ONE REDUCE and will ignore larger values. (Zero is a valid max,
  619. however.) Users may override this value, but only downward.
  620. </description>
  621. </property>
  622. <property>
  623. <name>mapreduce.job.ubertask.maxbytes</name>
  624. <value></value>
  625. <description>Threshold for number of input bytes, beyond which job is
  626. considered too big for the ubertasking optimization. If no value is
  627. specified, dfs.block.size is used as a default. Be sure to specify a
  628. default value in mapred-site.xml if the underlying filesystem is not HDFS.
  629. Users may override this value, but only downward.
  630. </description>
  631. </property>
  632. <property>
  633. <name>mapreduce.job.emit-timeline-data</name>
  634. <value>false</value>
  635. <description>Specifies if the Application Master should emit timeline data
  636. to the timeline server. Individual jobs can override this value.
  637. </description>
  638. </property>
  639. <property>
  640. <name>mapreduce.job.sharedcache.mode</name>
  641. <value>disabled</value>
  642. <description>
  643. A comma delimited list of resource categories to submit to the shared cache.
  644. The valid categories are: jobjar, libjars, files, archives.
  645. If "disabled" is specified then the job submission code will not use
  646. the shared cache.
  647. </description>
  648. </property>
  649. <property>
  650. <name>mapreduce.input.fileinputformat.split.minsize</name>
  651. <value>0</value>
  652. <description>The minimum size chunk that map input should be split
  653. into. Note that some file formats may have minimum split sizes that
  654. take priority over this setting.</description>
  655. </property>
  656. <property>
  657. <name>mapreduce.input.fileinputformat.list-status.num-threads</name>
  658. <value>1</value>
  659. <description>The number of threads to use to list and fetch block locations
  660. for the specified input paths. Note: multiple threads should not be used
  661. if a custom non thread-safe path filter is used.
  662. </description>
  663. </property>
  664. <property>
  665. <name>mapreduce.input.lineinputformat.linespermap</name>
  666. <value>1</value>
  667. <description>When using NLineInputFormat, the number of lines of input data
  668. to include in each split.</description>
  669. </property>
  670. <property>
  671. <name>mapreduce.client.submit.file.replication</name>
  672. <value>10</value>
  673. <description>The replication level for submitted job files. This
  674. should be around the square root of the number of nodes.
  675. </description>
  676. </property>
  677. <property>
  678. <name>mapreduce.task.files.preserve.failedtasks</name>
  679. <value>false</value>
  680. <description>Should the files for failed tasks be kept. This should only be
  681. used on jobs that are failing, because the storage is never
  682. reclaimed. It also prevents the map outputs from being erased
  683. from the reduce directory as they are consumed.</description>
  684. </property>
  685. <!--
  686. <property>
  687. <name>mapreduce.task.files.preserve.filepattern</name>
  688. <value>.*_m_123456_0</value>
  689. <description>Keep all files from tasks whose task names match the given
  690. regular expression. Defaults to none.</description>
  691. </property>
  692. -->
  693. <property>
  694. <name>mapreduce.output.fileoutputformat.compress</name>
  695. <value>false</value>
  696. <description>Should the job outputs be compressed?
  697. </description>
  698. </property>
  699. <property>
  700. <name>mapreduce.output.fileoutputformat.compress.type</name>
  701. <value>RECORD</value>
  702. <description>If the job outputs are to compressed as SequenceFiles, how should
  703. they be compressed? Should be one of NONE, RECORD or BLOCK.
  704. </description>
  705. </property>
  706. <property>
  707. <name>mapreduce.output.fileoutputformat.compress.codec</name>
  708. <value>org.apache.hadoop.io.compress.DefaultCodec</value>
  709. <description>If the job outputs are compressed, how should they be compressed?
  710. </description>
  711. </property>
  712. <property>
  713. <name>mapreduce.map.output.compress</name>
  714. <value>false</value>
  715. <description>Should the outputs of the maps be compressed before being
  716. sent across the network. Uses SequenceFile compression.
  717. </description>
  718. </property>
  719. <property>
  720. <name>mapreduce.map.output.compress.codec</name>
  721. <value>org.apache.hadoop.io.compress.DefaultCodec</value>
  722. <description>If the map outputs are compressed, how should they be
  723. compressed?
  724. </description>
  725. </property>
  726. <property>
  727. <name>map.sort.class</name>
  728. <value>org.apache.hadoop.util.QuickSort</value>
  729. <description>The default sort class for sorting keys.
  730. </description>
  731. </property>
  732. <property>
  733. <name>mapreduce.task.userlog.limit.kb</name>
  734. <value>0</value>
  735. <description>The maximum size of user-logs of each task in KB. 0 disables the cap.
  736. </description>
  737. </property>
  738. <property>
  739. <name>yarn.app.mapreduce.am.container.log.limit.kb</name>
  740. <value>0</value>
  741. <description>The maximum size of the MRAppMaster attempt container logs in KB.
  742. 0 disables the cap.
  743. </description>
  744. </property>
  745. <property>
  746. <name>yarn.app.mapreduce.task.container.log.backups</name>
  747. <value>0</value>
  748. <description>Number of backup files for task logs when using
  749. ContainerRollingLogAppender (CRLA). See
  750. org.apache.log4j.RollingFileAppender.maxBackupIndex. By default,
  751. ContainerLogAppender (CLA) is used, and container logs are not rolled. CRLA
  752. is enabled for tasks when both mapreduce.task.userlog.limit.kb and
  753. yarn.app.mapreduce.task.container.log.backups are greater than zero.
  754. </description>
  755. </property>
  756. <property>
  757. <name>yarn.app.mapreduce.am.container.log.backups</name>
  758. <value>0</value>
  759. <description>Number of backup files for the ApplicationMaster logs when using
  760. ContainerRollingLogAppender (CRLA). See
  761. org.apache.log4j.RollingFileAppender.maxBackupIndex. By default,
  762. ContainerLogAppender (CLA) is used, and container logs are not rolled. CRLA
  763. is enabled for the ApplicationMaster when both
  764. yarn.app.mapreduce.am.container.log.limit.kb and
  765. yarn.app.mapreduce.am.container.log.backups are greater than zero.
  766. </description>
  767. </property>
  768. <property>
  769. <name>yarn.app.mapreduce.shuffle.log.separate</name>
  770. <value>true</value>
  771. <description>If enabled ('true') logging generated by the client-side shuffle
  772. classes in a reducer will be written in a dedicated log file
  773. 'syslog.shuffle' instead of 'syslog'.
  774. </description>
  775. </property>
  776. <property>
  777. <name>yarn.app.mapreduce.shuffle.log.limit.kb</name>
  778. <value>0</value>
  779. <description>Maximum size of the syslog.shuffle file in kilobytes
  780. (0 for no limit).
  781. </description>
  782. </property>
  783. <property>
  784. <name>yarn.app.mapreduce.shuffle.log.backups</name>
  785. <value>0</value>
  786. <description>If yarn.app.mapreduce.shuffle.log.limit.kb and
  787. yarn.app.mapreduce.shuffle.log.backups are greater than zero
  788. then a ContainerRollngLogAppender is used instead of ContainerLogAppender
  789. for syslog.shuffle. See
  790. org.apache.log4j.RollingFileAppender.maxBackupIndex
  791. </description>
  792. </property>
  793. <property>
  794. <name>mapreduce.job.maxtaskfailures.per.tracker</name>
  795. <value>3</value>
  796. <description>The number of task-failures on a node manager of a given job
  797. after which new tasks of that job aren't assigned to it. It
  798. MUST be less than mapreduce.map.maxattempts and
  799. mapreduce.reduce.maxattempts otherwise the failed task will
  800. never be tried on a different node.
  801. </description>
  802. </property>
  803. <property>
  804. <name>mapreduce.client.output.filter</name>
  805. <value>FAILED</value>
  806. <description>The filter for controlling the output of the task's userlogs sent
  807. to the console of the JobClient.
  808. The permissible options are: NONE, KILLED, FAILED, SUCCEEDED and
  809. ALL.
  810. </description>
  811. </property>
  812. <property>
  813. <name>mapreduce.client.completion.pollinterval</name>
  814. <value>5000</value>
  815. <description>The interval (in milliseconds) between which the JobClient
  816. polls the MapReduce ApplicationMaster for updates about job status. You may want to
  817. set this to a lower value to make tests run faster on a single node system. Adjusting
  818. this value in production may lead to unwanted client-server traffic.
  819. </description>
  820. </property>
  821. <property>
  822. <name>mapreduce.client.progressmonitor.pollinterval</name>
  823. <value>1000</value>
  824. <description>The interval (in milliseconds) between which the JobClient
  825. reports status to the console and checks for job completion. You may want to set this
  826. to a lower value to make tests run faster on a single node system. Adjusting
  827. this value in production may lead to unwanted client-server traffic.
  828. </description>
  829. </property>
  830. <property>
  831. <name>mapreduce.client.libjars.wildcard</name>
  832. <value>true</value>
  833. <description>
  834. Whether the libjars cache files should be localized using
  835. a wildcarded directory instead of naming each archive independently.
  836. Using wildcards reduces the space needed for storing the job
  837. information in the case of a highly available resource manager
  838. configuration.
  839. This propery should only be set to false for specific
  840. jobs which are highly sensitive to the details of the archive
  841. localization. Having this property set to true will cause the archives
  842. to all be localized to the same local cache location. If false, each
  843. archive will be localized to its own local cache location. In both
  844. cases a symbolic link will be created to every archive from the job's
  845. working directory.
  846. </description>
  847. </property>
  848. <property>
  849. <name>mapreduce.task.profile</name>
  850. <value>false</value>
  851. <description>To set whether the system should collect profiler
  852. information for some of the tasks in this job? The information is stored
  853. in the user log directory. The value is "true" if task profiling
  854. is enabled.</description>
  855. </property>
  856. <property>
  857. <name>mapreduce.task.profile.maps</name>
  858. <value>0-2</value>
  859. <description> To set the ranges of map tasks to profile.
  860. mapreduce.task.profile has to be set to true for the value to be accounted.
  861. </description>
  862. </property>
  863. <property>
  864. <name>mapreduce.task.profile.reduces</name>
  865. <value>0-2</value>
  866. <description> To set the ranges of reduce tasks to profile.
  867. mapreduce.task.profile has to be set to true for the value to be accounted.
  868. </description>
  869. </property>
  870. <property>
  871. <name>mapreduce.task.profile.params</name>
  872. <value>-agentlib:hprof=cpu=samples,heap=sites,force=n,thread=y,verbose=n,file=%s</value>
  873. <description>JVM profiler parameters used to profile map and reduce task
  874. attempts. This string may contain a single format specifier %s that will
  875. be replaced by the path to profile.out in the task attempt log directory.
  876. To specify different profiling options for map tasks and reduce tasks,
  877. more specific parameters mapreduce.task.profile.map.params and
  878. mapreduce.task.profile.reduce.params should be used.</description>
  879. </property>
  880. <property>
  881. <name>mapreduce.task.profile.map.params</name>
  882. <value>${mapreduce.task.profile.params}</value>
  883. <description>Map-task-specific JVM profiler parameters. See
  884. mapreduce.task.profile.params</description>
  885. </property>
  886. <property>
  887. <name>mapreduce.task.profile.reduce.params</name>
  888. <value>${mapreduce.task.profile.params}</value>
  889. <description>Reduce-task-specific JVM profiler parameters. See
  890. mapreduce.task.profile.params</description>
  891. </property>
  892. <property>
  893. <name>mapreduce.task.skip.start.attempts</name>
  894. <value>2</value>
  895. <description> The number of Task attempts AFTER which skip mode
  896. will be kicked off. When skip mode is kicked off, the
  897. tasks reports the range of records which it will process
  898. next, to the MR ApplicationMaster. So that on failures, the MR AM
  899. knows which ones are possibly the bad records. On further executions,
  900. those are skipped.
  901. </description>
  902. </property>
  903. <property>
  904. <name>mapreduce.job.skip.outdir</name>
  905. <value></value>
  906. <description> If no value is specified here, the skipped records are
  907. written to the output directory at _logs/skip.
  908. User can stop writing skipped records by giving the value "none".
  909. </description>
  910. </property>
  911. <property>
  912. <name>mapreduce.map.skip.maxrecords</name>
  913. <value>0</value>
  914. <description> The number of acceptable skip records surrounding the bad
  915. record PER bad record in mapper. The number includes the bad record as well.
  916. To turn the feature of detection/skipping of bad records off, set the
  917. value to 0.
  918. The framework tries to narrow down the skipped range by retrying
  919. until this threshold is met OR all attempts get exhausted for this task.
  920. Set the value to Long.MAX_VALUE to indicate that framework need not try to
  921. narrow down. Whatever records(depends on application) get skipped are
  922. acceptable.
  923. </description>
  924. </property>
  925. <property>
  926. <name>mapreduce.map.skip.proc-count.auto-incr</name>
  927. <value>true</value>
  928. <description>The flag which if set to true,
  929. SkipBadRecords.COUNTER_MAP_PROCESSED_RECORDS is incremented by
  930. MapRunner after invoking the map function. This value must be set
  931. to false for applications which process the records asynchronously
  932. or buffer the input records. For example streaming. In such cases
  933. applications should increment this counter on their own.
  934. </description>
  935. </property>
  936. <property>
  937. <name>mapreduce.reduce.skip.maxgroups</name>
  938. <value>0</value>
  939. <description> The number of acceptable skip groups surrounding the bad
  940. group PER bad group in reducer. The number includes the bad group as well.
  941. To turn the feature of detection/skipping of bad groups off, set the
  942. value to 0.
  943. The framework tries to narrow down the skipped range by retrying
  944. until this threshold is met OR all attempts get exhausted for this task.
  945. Set the value to Long.MAX_VALUE to indicate that framework need not try to
  946. narrow down. Whatever groups(depends on application) get skipped are
  947. acceptable.
  948. </description>
  949. </property>
  950. <property>
  951. <name>mapreduce.reduce.skip.proc-count.auto-incr</name>
  952. <value>true</value>
  953. <description>The flag which if set to true.
  954. SkipBadRecords.COUNTER_REDUCE_PROCESSED_GROUPS is incremented by framework
  955. after invoking the reduce function. This value must be set to false for
  956. applications which process the records asynchronously or buffer the input
  957. records. For example streaming. In such cases applications should increment
  958. this counter on their own.
  959. </description>
  960. </property>
  961. <property>
  962. <name>mapreduce.ifile.readahead</name>
  963. <value>true</value>
  964. <description>Configuration key to enable/disable IFile readahead.
  965. </description>
  966. </property>
  967. <property>
  968. <name>mapreduce.ifile.readahead.bytes</name>
  969. <value>4194304</value>
  970. <description>Configuration key to set the IFile readahead length in bytes.
  971. </description>
  972. </property>
  973. <property>
  974. <name>mapreduce.job.queuename</name>
  975. <value>default</value>
  976. <description> Queue to which a job is submitted. This must match one of the
  977. queues defined in mapred-queues.xml for the system. Also, the ACL setup
  978. for the queue must allow the current user to submit a job to the queue.
  979. Before specifying a queue, ensure that the system is configured with
  980. the queue, and access is allowed for submitting jobs to the queue.
  981. </description>
  982. </property>
  983. <property>
  984. <name>mapreduce.job.tags</name>
  985. <value></value>
  986. <description> Tags for the job that will be passed to YARN at submission
  987. time. Queries to YARN for applications can filter on these tags.
  988. If these tags are intended to be used with The YARN Timeline Service v.2,
  989. prefix them with the appropriate tag names for flow name, flow version and
  990. flow run id. Example:
  991. timeline_flow_name_tag:foo,
  992. timeline_flow_version_tag:3df8b0d6100530080d2e0decf9e528e57c42a90a,
  993. timeline_flow_run_id_tag:1465246348599
  994. </description>
  995. </property>
  996. <property>
  997. <name>mapreduce.cluster.local.dir</name>
  998. <value>${hadoop.tmp.dir}/mapred/local</value>
  999. <description>
  1000. The local directory where MapReduce stores intermediate
  1001. data files. May be a comma-separated list of
  1002. directories on different devices in order to spread disk i/o.
  1003. Directories that do not exist are ignored.
  1004. </description>
  1005. </property>
  1006. <property>
  1007. <name>mapreduce.cluster.acls.enabled</name>
  1008. <value>false</value>
  1009. <description> Specifies whether ACLs should be checked
  1010. for authorization of users for doing various queue and job level operations.
  1011. ACLs are disabled by default. If enabled, access control checks are made by
  1012. MapReduce ApplicationMaster when requests are made by users for queue
  1013. operations like submit job to a queue and kill a job in the queue and job
  1014. operations like viewing the job-details (See mapreduce.job.acl-view-job)
  1015. or for modifying the job (See mapreduce.job.acl-modify-job) using
  1016. Map/Reduce APIs, RPCs or via the console and web user interfaces.
  1017. For enabling this flag, set to true in mapred-site.xml file of all
  1018. MapReduce clients (MR job submitting nodes).
  1019. </description>
  1020. </property>
  1021. <property>
  1022. <name>mapreduce.job.acl-modify-job</name>
  1023. <value> </value>
  1024. <description> Job specific access-control list for 'modifying' the job. It
  1025. is only used if authorization is enabled in Map/Reduce by setting the
  1026. configuration property mapreduce.cluster.acls.enabled to true.
  1027. This specifies the list of users and/or groups who can do modification
  1028. operations on the job. For specifying a list of users and groups the
  1029. format to use is "user1,user2 group1,group". If set to '*', it allows all
  1030. users/groups to modify this job. If set to ' '(i.e. space), it allows
  1031. none. This configuration is used to guard all the modifications with respect
  1032. to this job and takes care of all the following operations:
  1033. o killing this job
  1034. o killing a task of this job, failing a task of this job
  1035. o setting the priority of this job
  1036. Each of these operations are also protected by the per-queue level ACL
  1037. "acl-administer-jobs" configured via mapred-queues.xml. So a caller should
  1038. have the authorization to satisfy either the queue-level ACL or the
  1039. job-level ACL.
  1040. Irrespective of this ACL configuration, (a) job-owner, (b) the user who
  1041. started the cluster, (c) members of an admin configured supergroup
  1042. configured via mapreduce.cluster.permissions.supergroup and (d) queue
  1043. administrators of the queue to which this job was submitted to configured
  1044. via acl-administer-jobs for the specific queue in mapred-queues.xml can
  1045. do all the modification operations on a job.
  1046. By default, nobody else besides job-owner, the user who started the cluster,
  1047. members of supergroup and queue administrators can perform modification
  1048. operations on a job.
  1049. </description>
  1050. </property>
  1051. <property>
  1052. <name>mapreduce.job.acl-view-job</name>
  1053. <value> </value>
  1054. <description> Job specific access-control list for 'viewing' the job. It is
  1055. only used if authorization is enabled in Map/Reduce by setting the
  1056. configuration property mapreduce.cluster.acls.enabled to true.
  1057. This specifies the list of users and/or groups who can view private details
  1058. about the job. For specifying a list of users and groups the
  1059. format to use is "user1,user2 group1,group". If set to '*', it allows all
  1060. users/groups to modify this job. If set to ' '(i.e. space), it allows
  1061. none. This configuration is used to guard some of the job-views and at
  1062. present only protects APIs that can return possibly sensitive information
  1063. of the job-owner like
  1064. o job-level counters
  1065. o task-level counters
  1066. o tasks' diagnostic information
  1067. o task-logs displayed on the HistoryServer's web-UI and
  1068. o job.xml showed by the HistoryServer's web-UI
  1069. Every other piece of information of jobs is still accessible by any other
  1070. user, for e.g., JobStatus, JobProfile, list of jobs in the queue, etc.
  1071. Irrespective of this ACL configuration, (a) job-owner, (b) the user who
  1072. started the cluster, (c) members of an admin configured supergroup
  1073. configured via mapreduce.cluster.permissions.supergroup and (d) queue
  1074. administrators of the queue to which this job was submitted to configured
  1075. via acl-administer-jobs for the specific queue in mapred-queues.xml can
  1076. do all the view operations on a job.
  1077. By default, nobody else besides job-owner, the user who started the
  1078. cluster, memebers of supergroup and queue administrators can perform
  1079. view operations on a job.
  1080. </description>
  1081. </property>
  1082. <property>
  1083. <name>mapreduce.job.finish-when-all-reducers-done</name>
  1084. <value>true</value>
  1085. <description>Specifies whether the job should complete once all reducers
  1086. have finished, regardless of whether there are still running mappers.
  1087. </description>
  1088. </property>
  1089. <property>
  1090. <name>mapreduce.job.token.tracking.ids.enabled</name>
  1091. <value>false</value>
  1092. <description>Whether to write tracking ids of tokens to
  1093. job-conf. When true, the configuration property
  1094. "mapreduce.job.token.tracking.ids" is set to the token-tracking-ids of
  1095. the job</description>
  1096. </property>
  1097. <property>
  1098. <name>mapreduce.job.token.tracking.ids</name>
  1099. <value></value>
  1100. <description>When mapreduce.job.token.tracking.ids.enabled is
  1101. set to true, this is set by the framework to the
  1102. token-tracking-ids used by the job.</description>
  1103. </property>
  1104. <property>
  1105. <name>mapreduce.task.merge.progress.records</name>
  1106. <value>10000</value>
  1107. <description> The number of records to process during merge before
  1108. sending a progress notification to the MR ApplicationMaster.
  1109. </description>
  1110. </property>
  1111. <property>
  1112. <name>mapreduce.task.combine.progress.records</name>
  1113. <value>10000</value>
  1114. <description> The number of records to process during combine output collection
  1115. before sending a progress notification.
  1116. </description>
  1117. </property>
  1118. <property>
  1119. <name>mapreduce.job.reduce.slowstart.completedmaps</name>
  1120. <value>0.05</value>
  1121. <description>Fraction of the number of maps in the job which should be
  1122. complete before reduces are scheduled for the job.
  1123. </description>
  1124. </property>
  1125. <property>
  1126. <name>mapreduce.job.complete.cancel.delegation.tokens</name>
  1127. <value>true</value>
  1128. <description> if false - do not unregister/cancel delegation tokens from
  1129. renewal, because same tokens may be used by spawned jobs
  1130. </description>
  1131. </property>
  1132. <property>
  1133. <name>mapreduce.shuffle.port</name>
  1134. <value>13562</value>
  1135. <description>Default port that the ShuffleHandler will run on. ShuffleHandler
  1136. is a service run at the NodeManager to facilitate transfers of intermediate
  1137. Map outputs to requesting Reducers.
  1138. </description>
  1139. </property>
  1140. <property>
  1141. <name>mapreduce.shuffle.pathcache.max-weight</name>
  1142. <value>10485760</value>
  1143. <description>The maximum total weight of entries the cache may contain.
  1144. </description>
  1145. </property>
  1146. <property>
  1147. <name>mapreduce.shuffle.pathcache.expire-after-access-minutes</name>
  1148. <value>5</value>
  1149. <description>The length of time after an entry is last accessed that it
  1150. should be automatically removed.
  1151. </description>
  1152. </property>
  1153. <property>
  1154. <name>mapreduce.shuffle.pathcache.concurrency-level</name>
  1155. <value>16</value>
  1156. <description>Uses the concurrency level to create a fixed number of hashtable
  1157. segments, each governed by its own write lock.
  1158. </description>
  1159. </property>
  1160. <property>
  1161. <name>mapreduce.job.reduce.shuffle.consumer.plugin.class</name>
  1162. <value>org.apache.hadoop.mapreduce.task.reduce.Shuffle</value>
  1163. <description>
  1164. Name of the class whose instance will be used
  1165. to send shuffle requests by reducetasks of this job.
  1166. The class must be an instance of org.apache.hadoop.mapred.ShuffleConsumerPlugin.
  1167. </description>
  1168. </property>
  1169. <!-- MR YARN Application properties -->
  1170. <property>
  1171. <name>mapreduce.job.node-label-expression</name>
  1172. <description>All the containers of the Map Reduce job will be run with this
  1173. node label expression. If the node-label-expression for job is not set, then
  1174. it will use queue's default-node-label-expression for all job's containers.
  1175. </description>
  1176. </property>
  1177. <property>
  1178. <name>mapreduce.job.am.node-label-expression</name>
  1179. <description>This is node-label configuration for Map Reduce Application Master
  1180. container. If not configured it will make use of
  1181. mapreduce.job.node-label-expression and if job's node-label expression is not
  1182. configured then it will use queue's default-node-label-expression.
  1183. </description>
  1184. </property>
  1185. <property>
  1186. <name>mapreduce.map.node-label-expression</name>
  1187. <description>This is node-label configuration for Map task containers. If not
  1188. configured it will use mapreduce.job.node-label-expression and if job's
  1189. node-label expression is not configured then it will use queue's
  1190. default-node-label-expression.
  1191. </description>
  1192. </property>
  1193. <property>
  1194. <name>mapreduce.reduce.node-label-expression</name>
  1195. <description>This is node-label configuration for Reduce task containers. If
  1196. not configured it will use mapreduce.job.node-label-expression and if job's
  1197. node-label expression is not configured then it will use queue's
  1198. default-node-label-expression.
  1199. </description>
  1200. </property>
  1201. <property>
  1202. <name>mapreduce.job.counters.max</name>
  1203. <value>120</value>
  1204. <description>The max number of user counters allowed per job.
  1205. </description>
  1206. </property>
  1207. <property>
  1208. <name>mapreduce.framework.name</name>
  1209. <value>local</value>
  1210. <description>The runtime framework for executing MapReduce jobs.
  1211. Can be one of local, classic or yarn.
  1212. </description>
  1213. </property>
  1214. <property>
  1215. <name>yarn.app.mapreduce.am.staging-dir</name>
  1216. <value>/tmp/hadoop-yarn/staging</value>
  1217. <description>The staging dir used while submitting jobs.
  1218. </description>
  1219. </property>
  1220. <property>
  1221. <name>yarn.app.mapreduce.am.staging-dir.erasurecoding.enabled</name>
  1222. <value>false</value>
  1223. <description>Whether Erasure Coding should be enabled for
  1224. files that are copied to the MR staging area. This is a job-level
  1225. setting.
  1226. </description>
  1227. </property>
  1228. <property>
  1229. <name>mapreduce.am.max-attempts</name>
  1230. <value>2</value>
  1231. <description>The maximum number of application attempts. It is a
  1232. application-specific setting. It should not be larger than the global number
  1233. set by resourcemanager. Otherwise, it will be override. The default number is
  1234. set to 2, to allow at least one retry for AM.</description>
  1235. </property>
  1236. <!-- Job Notification Configuration -->
  1237. <property>
  1238. <name>mapreduce.job.end-notification.url</name>
  1239. <!--<value>http://localhost:8080/jobstatus.php?jobId=$jobId&amp;jobStatus=$jobStatus</value>-->
  1240. <description>Indicates url which will be called on completion of job to inform
  1241. end status of job.
  1242. User can give at most 2 variables with URI : $jobId and $jobStatus.
  1243. If they are present in URI, then they will be replaced by their
  1244. respective values.
  1245. </description>
  1246. </property>
  1247. <property>
  1248. <name>mapreduce.job.end-notification.retry.attempts</name>
  1249. <value>0</value>
  1250. <description>The number of times the submitter of the job wants to retry job
  1251. end notification if it fails. This is capped by
  1252. mapreduce.job.end-notification.max.attempts</description>
  1253. </property>
  1254. <property>
  1255. <name>mapreduce.job.end-notification.retry.interval</name>
  1256. <value>1000</value>
  1257. <description>The number of milliseconds the submitter of the job wants to
  1258. wait before job end notification is retried if it fails. This is capped by
  1259. mapreduce.job.end-notification.max.retry.interval</description>
  1260. </property>
  1261. <property>
  1262. <name>mapreduce.job.end-notification.max.attempts</name>
  1263. <value>5</value>
  1264. <final>true</final>
  1265. <description>The maximum number of times a URL will be read for providing job
  1266. end notification. Cluster administrators can set this to limit how long
  1267. after end of a job, the Application Master waits before exiting. Must be
  1268. marked as final to prevent users from overriding this.
  1269. </description>
  1270. </property>
  1271. <property>
  1272. <name>mapreduce.job.end-notification.custom-notifier-class</name>
  1273. <description>A class to be invoked in order to send a notification after the
  1274. job has completed (success/failure). The class must implement
  1275. org.apache.hadoop.mapreduce.CustomJobEndNotifier. A notification
  1276. url still has to be set which will be passed to the notifyOnce
  1277. method of your implementation along with the Job's configuration.
  1278. If this is set instead of using a simple HttpURLConnection we'll
  1279. create a new instance of this class. For now this still only works
  1280. with HTTP/HTTPS URLs, but by implementing this class you can choose
  1281. how you want to make the notification itself. For example you can
  1282. choose to use a custom HTTP library, or do a delegation token
  1283. authentication, maybe set a custom SSL context on the connection, etc.
  1284. The class needs to have a no-arg constructor.
  1285. </description>
  1286. </property>
  1287. <property>
  1288. <name>mapreduce.job.log4j-properties-file</name>
  1289. <value></value>
  1290. <description>Used to override the default settings of log4j in container-log4j.properties
  1291. for NodeManager. Like container-log4j.properties, it requires certain
  1292. framework appenders properly defined in this overriden file. The file on the
  1293. path will be added to distributed cache and classpath. If no-scheme is given
  1294. in the path, it defaults to point to a log4j file on the local FS.
  1295. </description>
  1296. </property>
  1297. <property>
  1298. <name>mapreduce.job.end-notification.max.retry.interval</name>
  1299. <value>5000</value>
  1300. <final>true</final>
  1301. <description>The maximum amount of time (in milliseconds) to wait before
  1302. retrying job end notification. Cluster administrators can set this to
  1303. limit how long the Application Master waits before exiting. Must be marked
  1304. as final to prevent users from overriding this.</description>
  1305. </property>
  1306. <property>
  1307. <name>yarn.app.mapreduce.am.env</name>
  1308. <value></value>
  1309. <description>User added environment variables for the MR App Master
  1310. processes, specified as a comma separated list.
  1311. Example :
  1312. 1) A=foo This will set the env variable A to foo
  1313. 2) B=$B:c This is inherit tasktracker's B env variable.
  1314. To define environment variables individually, you can specify
  1315. multiple properties of the form yarn.app.mapreduce.am.env.VARNAME,
  1316. where VARNAME is the name of the environment variable. This is the only
  1317. way to add a variable when its value contains commas.
  1318. </description>
  1319. </property>
  1320. <property>
  1321. <name>yarn.app.mapreduce.am.admin.user.env</name>
  1322. <value></value>
  1323. <description>Environment variables for the MR App Master
  1324. processes for admin purposes, specified as a comma separated list
  1325. These values are set first and can be overridden by the user env
  1326. (yarn.app.mapreduce.am.env). Example :
  1327. 1) A=foo This will set the env variable A to foo
  1328. 2) B=$B:c This is inherit app master's B env variable.
  1329. To define environment variables individually, you can specify
  1330. multiple properties of the form yarn.app.mapreduce.am.admin.user.env.VARNAME,
  1331. where VARNAME is the name of the environment variable. This is the only
  1332. way to add a variable when its value contains commas.
  1333. </description>
  1334. </property>
  1335. <property>
  1336. <name>yarn.app.mapreduce.am.command-opts</name>
  1337. <value>-Xmx1024m</value>
  1338. <description>Java opts for the MR App Master processes.
  1339. The following symbol, if present, will be interpolated: @taskid@ is replaced
  1340. by current TaskID. Any other occurrences of '@' will go unchanged.
  1341. For example, to enable verbose gc logging to a file named for the taskid in
  1342. /tmp and to set the heap maximum to be a gigabyte, pass a 'value' of:
  1343. -Xmx1024m -verbose:gc -Xloggc:/tmp/@taskid@.gc
  1344. Usage of -Djava.library.path can cause programs to no longer function if
  1345. hadoop native libraries are used. These values should instead be set as part
  1346. of LD_LIBRARY_PATH in the map / reduce JVM env using the mapreduce.map.env and
  1347. mapreduce.reduce.env config settings.
  1348. </description>
  1349. </property>
  1350. <property>
  1351. <name>yarn.app.mapreduce.am.admin-command-opts</name>
  1352. <value></value>
  1353. <description>Java opts for the MR App Master processes for admin purposes.
  1354. It will appears before the opts set by yarn.app.mapreduce.am.command-opts and
  1355. thus its options can be overridden user.
  1356. Usage of -Djava.library.path can cause programs to no longer function if
  1357. hadoop native libraries are used. These values should instead be set as part
  1358. of LD_LIBRARY_PATH in the map / reduce JVM env using the mapreduce.map.env and
  1359. mapreduce.reduce.env config settings.
  1360. </description>
  1361. </property>
  1362. <property>
  1363. <name>yarn.app.mapreduce.am.job.task.listener.thread-count</name>
  1364. <value>30</value>
  1365. <description>The number of threads used to handle RPC calls in the
  1366. MR AppMaster from remote tasks</description>
  1367. </property>
  1368. <property>
  1369. <name>yarn.app.mapreduce.am.job.client.port-range</name>
  1370. <value></value>
  1371. <description>Range of ports that the MapReduce AM can use when binding.
  1372. Leave blank if you want all possible ports.
  1373. For example 50000-50050,50100-50200</description>
  1374. </property>
  1375. <property>
  1376. <name>yarn.app.mapreduce.am.webapp.port-range</name>
  1377. <value></value>
  1378. <description>Range of ports that the MapReduce AM can use for its webapp when binding.
  1379. Leave blank if you want all possible ports.
  1380. For example 50000-50050,50100-50200</description>
  1381. </property>
  1382. <property>
  1383. <name>yarn.app.mapreduce.am.webapp.https.enabled</name>
  1384. <value>false</value>
  1385. <description>True if the MR AM should use HTTPS for its webapp. If
  1386. yarn.resourcemanager.application-https.policy is set to LENIENT or STRICT,
  1387. the MR AM will automatically use the keystore provided by YARN with a
  1388. certificate for the MR AM webapp, unless provided by the user.
  1389. </description>
  1390. </property>
  1391. <property>
  1392. <name>yarn.app.mapreduce.am.webapp.https.client.auth</name>
  1393. <value>false</value>
  1394. <description>True if the MR AM webapp should require client HTTPS
  1395. authentication (i.e. the proxy server (RM) should present a certificate to
  1396. the MR AM webapp). If yarn.resourcemanager.application-https.policy is set
  1397. to LENIENT or STRICT, the MR AM will automatically use the truststore
  1398. provided by YARN with the RMs certificate, unless provided by the user.
  1399. </description>
  1400. </property>
  1401. <property>
  1402. <name>yarn.app.mapreduce.am.job.committer.cancel-timeout</name>
  1403. <value>60000</value>
  1404. <description>The amount of time in milliseconds to wait for the output
  1405. committer to cancel an operation if the job is killed</description>
  1406. </property>
  1407. <property>
  1408. <name>yarn.app.mapreduce.am.job.committer.commit-window</name>
  1409. <value>10000</value>
  1410. <description>Defines a time window in milliseconds for output commit
  1411. operations. If contact with the RM has occurred within this window then
  1412. commits are allowed, otherwise the AM will not allow output commits until
  1413. contact with the RM has been re-established.</description>
  1414. </property>
  1415. <property>
  1416. <name>mapreduce.fileoutputcommitter.algorithm.version</name>
  1417. <value>2</value>
  1418. <description>The file output committer algorithm version
  1419. valid algorithm version number: 1 or 2
  1420. default to 2, which is the original algorithm
  1421. In algorithm version 1,
  1422. 1. commitTask will rename directory
  1423. $joboutput/_temporary/$appAttemptID/_temporary/$taskAttemptID/
  1424. to
  1425. $joboutput/_temporary/$appAttemptID/$taskID/
  1426. 2. recoverTask will also do a rename
  1427. $joboutput/_temporary/$appAttemptID/$taskID/
  1428. to
  1429. $joboutput/_temporary/($appAttemptID + 1)/$taskID/
  1430. 3. commitJob will merge every task output file in
  1431. $joboutput/_temporary/$appAttemptID/$taskID/
  1432. to
  1433. $joboutput/, then it will delete $joboutput/_temporary/
  1434. and write $joboutput/_SUCCESS
  1435. It has a performance regression, which is discussed in MAPREDUCE-4815.
  1436. If a job generates many files to commit then the commitJob
  1437. method call at the end of the job can take minutes.
  1438. the commit is single-threaded and waits until all
  1439. tasks have completed before commencing.
  1440. algorithm version 2 will change the behavior of commitTask,
  1441. recoverTask, and commitJob.
  1442. 1. commitTask will rename all files in
  1443. $joboutput/_temporary/$appAttemptID/_temporary/$taskAttemptID/
  1444. to $joboutput/
  1445. 2. recoverTask actually doesn't require to do anything, but for
  1446. upgrade from version 1 to version 2 case, it will check if there
  1447. are any files in
  1448. $joboutput/_temporary/($appAttemptID - 1)/$taskID/
  1449. and rename them to $joboutput/
  1450. 3. commitJob can simply delete $joboutput/_temporary and write
  1451. $joboutput/_SUCCESS
  1452. This algorithm will reduce the output commit time for
  1453. large jobs by having the tasks commit directly to the final
  1454. output directory as they were completing and commitJob had
  1455. very little to do.
  1456. </description>
  1457. </property>
  1458. <property>
  1459. <name>mapreduce.fileoutputcommitter.task.cleanup.enabled</name>
  1460. <value>false</value>
  1461. <description>Whether tasks should delete their task temporary directories. This is purely an
  1462. optimization for filesystems without O(1) recursive delete, as commitJob will recursively delete
  1463. the entire job temporary directory. HDFS has O(1) recursive delete, so this parameter is left
  1464. false by default. Users of object stores, for example, may want to set this to true.
  1465. Note: this is only used if mapreduce.fileoutputcommitter.algorithm.version=2</description>
  1466. </property>
  1467. <property>
  1468. <name>yarn.app.mapreduce.am.scheduler.heartbeat.interval-ms</name>
  1469. <value>1000</value>
  1470. <description>The interval in ms at which the MR AppMaster should send
  1471. heartbeats to the ResourceManager</description>
  1472. </property>
  1473. <property>
  1474. <name>yarn.app.mapreduce.client-am.ipc.max-retries</name>
  1475. <value>3</value>
  1476. <description>The number of client retries to the AM - before reconnecting
  1477. to the RM to fetch Application Status.
  1478. In other words, it is the ipc.client.connect.max.retries to be used during
  1479. reconnecting to the RM and fetching Application Status.</description>
  1480. </property>
  1481. <property>
  1482. <name>yarn.app.mapreduce.client-am.ipc.max-retries-on-timeouts</name>
  1483. <value>3</value>
  1484. <description>The number of client retries on socket timeouts to the AM - before
  1485. reconnecting to the RM to fetch Application Status.
  1486. In other words, it is the ipc.client.connect.max.retries.on.timeouts to be used during
  1487. reconnecting to the RM and fetching Application Status.</description>
  1488. </property>
  1489. <property>
  1490. <name>yarn.app.mapreduce.client.max-retries</name>
  1491. <value>3</value>
  1492. <description>The number of client retries to the RM/HS before
  1493. throwing exception. This is a layer above the ipc.</description>
  1494. </property>
  1495. <property>
  1496. <name>yarn.app.mapreduce.am.resource.mb</name>
  1497. <value>1536</value>
  1498. <description>The amount of memory the MR AppMaster needs.</description>
  1499. </property>
  1500. <property>
  1501. <name>yarn.app.mapreduce.am.resource.cpu-vcores</name>
  1502. <value>1</value>
  1503. <description>
  1504. The number of virtual CPU cores the MR AppMaster needs.
  1505. </description>
  1506. </property>
  1507. <property>
  1508. <name>yarn.app.mapreduce.am.hard-kill-timeout-ms</name>
  1509. <value>10000</value>
  1510. <description>
  1511. Number of milliseconds to wait before the job client kills the application.
  1512. </description>
  1513. </property>
  1514. <property>
  1515. <name>yarn.app.mapreduce.client.job.max-retries</name>
  1516. <value>3</value>
  1517. <description>The number of retries the client will make for getJob and
  1518. dependent calls.
  1519. This is needed for non-HDFS DFS where additional, high level
  1520. retries are required to avoid spurious failures during the getJob call.
  1521. 30 is a good value for WASB</description>
  1522. </property>
  1523. <property>
  1524. <name>yarn.app.mapreduce.client.job.retry-interval</name>
  1525. <value>2000</value>
  1526. <description>The delay between getJob retries in ms for retries configured
  1527. with yarn.app.mapreduce.client.job.max-retries.</description>
  1528. </property>
  1529. <property>
  1530. <description>CLASSPATH for MR applications. A comma-separated list
  1531. of CLASSPATH entries. If mapreduce.application.framework is set then this
  1532. must specify the appropriate classpath for that archive, and the name of
  1533. the archive must be present in the classpath.
  1534. If mapreduce.app-submission.cross-platform is false, platform-specific
  1535. environment variable expansion syntax would be used to construct the default
  1536. CLASSPATH entries.
  1537. For Linux:
  1538. $HADOOP_MAPRED_HOME/share/hadoop/mapreduce/*,
  1539. $HADOOP_MAPRED_HOME/share/hadoop/mapreduce/lib/*.
  1540. For Windows:
  1541. %HADOOP_MAPRED_HOME%/share/hadoop/mapreduce/*,
  1542. %HADOOP_MAPRED_HOME%/share/hadoop/mapreduce/lib/*.
  1543. If mapreduce.app-submission.cross-platform is true, platform-agnostic default
  1544. CLASSPATH for MR applications would be used:
  1545. {{HADOOP_MAPRED_HOME}}/share/hadoop/mapreduce/*,
  1546. {{HADOOP_MAPRED_HOME}}/share/hadoop/mapreduce/lib/*
  1547. Parameter expansion marker will be replaced by NodeManager on container
  1548. launch based on the underlying OS accordingly.
  1549. </description>
  1550. <name>mapreduce.application.classpath</name>
  1551. <value></value>
  1552. </property>
  1553. <property>
  1554. <description>If enabled, user can submit an application cross-platform
  1555. i.e. submit an application from a Windows client to a Linux/Unix server or
  1556. vice versa.
  1557. </description>
  1558. <name>mapreduce.app-submission.cross-platform</name>
  1559. <value>false</value>
  1560. </property>
  1561. <property>
  1562. <description>Path to the MapReduce framework archive. If set, the framework
  1563. archive will automatically be distributed along with the job, and this
  1564. path would normally reside in a public location in an HDFS filesystem. As
  1565. with distributed cache files, this can be a URL with a fragment specifying
  1566. the alias to use for the archive name. For example,
  1567. hdfs:/mapred/framework/hadoop-mapreduce-2.1.1.tar.gz#mrframework would
  1568. alias the localized archive as "mrframework".
  1569. Note that mapreduce.application.classpath must include the appropriate
  1570. classpath for the specified framework. The base name of the archive, or
  1571. alias of the archive if an alias is used, must appear in the specified
  1572. classpath.
  1573. </description>
  1574. <name>mapreduce.application.framework.path</name>
  1575. <value></value>
  1576. </property>
  1577. <property>
  1578. <name>mapreduce.job.classloader</name>
  1579. <value>false</value>
  1580. <description>Whether to use a separate (isolated) classloader for
  1581. user classes in the task JVM.</description>
  1582. </property>
  1583. <property>
  1584. <name>mapreduce.job.classloader.system.classes</name>
  1585. <value></value>
  1586. <description>Used to override the default definition of the system classes for
  1587. the job classloader. The system classes are a comma-separated list of
  1588. patterns that indicate whether to load a class from the system classpath,
  1589. instead from the user-supplied JARs, when mapreduce.job.classloader is
  1590. enabled.
  1591. A positive pattern is defined as:
  1592. 1. A single class name 'C' that matches 'C' and transitively all nested
  1593. classes 'C$*' defined in C;
  1594. 2. A package name ending with a '.' (e.g., "com.example.") that matches
  1595. all classes from that package.
  1596. A negative pattern is defined by a '-' in front of a positive pattern
  1597. (e.g., "-com.example.").
  1598. A class is considered a system class if and only if it matches one of the
  1599. positive patterns and none of the negative ones. More formally:
  1600. A class is a member of the inclusion set I if it matches one of the positive
  1601. patterns. A class is a member of the exclusion set E if it matches one of
  1602. the negative patterns. The set of system classes S = I \ E.
  1603. </description>
  1604. </property>
  1605. <property>
  1606. <name>mapreduce.jvm.system-properties-to-log</name>
  1607. <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>
  1608. <description>Comma-delimited list of system properties to log on mapreduce JVM start</description>
  1609. </property>
  1610. <property>
  1611. <name>mapreduce.jvm.add-opens-as-default</name>
  1612. <value>false</value>
  1613. <description>Since on JDK17 it's no longer possible to use the reflection API to
  1614. access non-public fields and methods add-opens flags should be added to MR AM
  1615. and map/reduce containers regardless of the user specified java opts. Setting
  1616. this to true will add the flags to the container launch commands on nodes with
  1617. JDK17 or higher. Defaults to false, and the setting has no effect on nodes using
  1618. JDK16 and before.
  1619. </description>
  1620. </property>
  1621. <!-- jobhistory properties -->
  1622. <property>
  1623. <name>mapreduce.jobhistory.address</name>
  1624. <value>0.0.0.0:10020</value>
  1625. <description>MapReduce JobHistory Server IPC host:port</description>
  1626. </property>
  1627. <property>
  1628. <name>mapreduce.jobhistory.webapp.address</name>
  1629. <value>0.0.0.0:19888</value>
  1630. <description>MapReduce JobHistory Server Web UI host:port</description>
  1631. </property>
  1632. <property>
  1633. <name>mapreduce.jobhistory.webapp.https.address</name>
  1634. <value>0.0.0.0:19890</value>
  1635. <description>
  1636. The https address the MapReduce JobHistory Server WebApp is on.
  1637. </description>
  1638. </property>
  1639. <property>
  1640. <name>mapreduce.jobhistory.keytab</name>
  1641. <description>
  1642. Location of the kerberos keytab file for the MapReduce
  1643. JobHistory Server.
  1644. </description>
  1645. <value>/etc/security/keytab/jhs.service.keytab</value>
  1646. </property>
  1647. <property>
  1648. <name>mapreduce.jobhistory.principal</name>
  1649. <description>
  1650. Kerberos principal name for the MapReduce JobHistory Server.
  1651. </description>
  1652. <value>jhs/_HOST@REALM.TLD</value>
  1653. </property>
  1654. <property>
  1655. <name>mapreduce.jobhistory.intermediate-done-dir</name>
  1656. <value>${yarn.app.mapreduce.am.staging-dir}/history/done_intermediate</value>
  1657. <description></description>
  1658. </property>
  1659. <property>
  1660. <name>mapreduce.jobhistory.intermediate-user-done-dir.permissions</name>
  1661. <value>770</value>
  1662. <description>The permissions of the user directories in
  1663. ${mapreduce.jobhistory.intermediate-done-dir}. The user and the group
  1664. permission must be 7, this is enforced.
  1665. </description>
  1666. </property>
  1667. <property>
  1668. <name>mapreduce.jobhistory.always-scan-user-dir</name>
  1669. <value>false</value>
  1670. <description>Some Cloud FileSystems do not currently update the
  1671. modification time of directories. To support these filesystems, this
  1672. configuration value should be set to 'true'.
  1673. </description>
  1674. </property>
  1675. <property>
  1676. <name>mapreduce.jobhistory.done-dir</name>
  1677. <value>${yarn.app.mapreduce.am.staging-dir}/history/done</value>
  1678. <description></description>
  1679. </property>
  1680. <property>
  1681. <name>mapreduce.jobhistory.cleaner.enable</name>
  1682. <value>true</value>
  1683. <description></description>
  1684. </property>
  1685. <property>
  1686. <name>mapreduce.jobhistory.cleaner.interval-ms</name>
  1687. <value>86400000</value>
  1688. <description> How often the job history cleaner checks for files to delete,
  1689. in milliseconds. Defaults to 86400000 (one day). Files are only deleted if
  1690. they are older than mapreduce.jobhistory.max-age-ms.
  1691. </description>
  1692. </property>
  1693. <property>
  1694. <name>mapreduce.jobhistory.max-age-ms</name>
  1695. <value>604800000</value>
  1696. <description> Job history files older than this many milliseconds will
  1697. be deleted when the history cleaner runs. Defaults to 604800000 (1 week).
  1698. </description>
  1699. </property>
  1700. <property>
  1701. <name>mapreduce.jobhistory.client.thread-count</name>
  1702. <value>10</value>
  1703. <description>The number of threads to handle client API requests</description>
  1704. </property>
  1705. <property>
  1706. <name>mapreduce.jobhistory.datestring.cache.size</name>
  1707. <value>200000</value>
  1708. <description>Size of the date string cache. Effects the number of directories
  1709. which will be scanned to find a job.</description>
  1710. </property>
  1711. <property>
  1712. <name>mapreduce.jobhistory.joblist.cache.size</name>
  1713. <value>20000</value>
  1714. <description>Size of the job list cache</description>
  1715. </property>
  1716. <property>
  1717. <name>mapreduce.jobhistory.loadedjobs.cache.size</name>
  1718. <value>5</value>
  1719. <description>Size of the loaded job cache. This property is ignored if
  1720. the property mapreduce.jobhistory.loadedtasks.cache.size is set to a
  1721. positive value.
  1722. </description>
  1723. </property>
  1724. <property>
  1725. <name>mapreduce.jobhistory.loadedtasks.cache.size</name>
  1726. <value></value>
  1727. <description>Change the job history cache limit to be set in terms
  1728. of total task count. If the total number of tasks loaded exceeds
  1729. this value, then the job cache will be shrunk down until it is
  1730. under this limit (minimum 1 job in cache). If this value is empty
  1731. or nonpositive then the cache reverts to using the property
  1732. mapreduce.jobhistory.loadedjobs.cache.size as a job cache size.
  1733. Two recommendations for the mapreduce.jobhistory.loadedtasks.cache.size
  1734. property:
  1735. 1) For every 100k of cache size, set the heap size of the Job History
  1736. Server to 1.2GB. For example,
  1737. mapreduce.jobhistory.loadedtasks.cache.size=500000, heap size=6GB.
  1738. 2) Make sure that the cache size is larger than the number of tasks
  1739. required for the largest job run on the cluster. It might be a good
  1740. idea to set the value slightly higher (say, 20%) in order to allow
  1741. for job size growth.
  1742. </description>
  1743. </property>
  1744. <property>
  1745. <name>mapreduce.jobhistory.move.interval-ms</name>
  1746. <value>180000</value>
  1747. <description>Scan for history files to more from intermediate done dir to done
  1748. dir at this frequency.
  1749. </description>
  1750. </property>
  1751. <property>
  1752. <name>mapreduce.jobhistory.move.thread-count</name>
  1753. <value>3</value>
  1754. <description>The number of threads used to move files.</description>
  1755. </property>
  1756. <property>
  1757. <name>mapreduce.jobhistory.store.class</name>
  1758. <value></value>
  1759. <description>The HistoryStorage class to use to cache history data.</description>
  1760. </property>
  1761. <property>
  1762. <name>mapreduce.jobhistory.minicluster.fixed.ports</name>
  1763. <value>false</value>
  1764. <description>Whether to use fixed ports with the minicluster</description>
  1765. </property>
  1766. <property>
  1767. <name>mapreduce.jobhistory.admin.address</name>
  1768. <value>0.0.0.0:10033</value>
  1769. <description>The address of the History server admin interface.</description>
  1770. </property>
  1771. <property>
  1772. <name>mapreduce.jobhistory.admin.acl</name>
  1773. <value>*</value>
  1774. <description>ACL of who can be admin of the History server.</description>
  1775. </property>
  1776. <property>
  1777. <name>mapreduce.jobhistory.recovery.enable</name>
  1778. <value>false</value>
  1779. <description>Enable the history server to store server state and recover
  1780. server state upon startup. If enabled then
  1781. mapreduce.jobhistory.recovery.store.class must be specified.</description>
  1782. </property>
  1783. <property>
  1784. <name>mapreduce.jobhistory.recovery.store.class</name>
  1785. <value>org.apache.hadoop.mapreduce.v2.hs.HistoryServerFileSystemStateStoreService</value>
  1786. <description>The HistoryServerStateStoreService class to store history server
  1787. state for recovery.</description>
  1788. </property>
  1789. <property>
  1790. <name>mapreduce.jobhistory.recovery.store.fs.uri</name>
  1791. <value>${hadoop.tmp.dir}/mapred/history/recoverystore</value>
  1792. <!--value>hdfs://localhost:9000/mapred/history/recoverystore</value-->
  1793. <description>The URI where history server state will be stored if
  1794. HistoryServerFileSystemStateStoreService is configured as the recovery
  1795. storage class.</description>
  1796. </property>
  1797. <property>
  1798. <name>mapreduce.jobhistory.recovery.store.leveldb.path</name>
  1799. <value>${hadoop.tmp.dir}/mapred/history/recoverystore</value>
  1800. <description>The URI where history server state will be stored if
  1801. HistoryServerLeveldbSystemStateStoreService is configured as the recovery
  1802. storage class.</description>
  1803. </property>
  1804. <property>
  1805. <name>mapreduce.jobhistory.http.policy</name>
  1806. <value>HTTP_ONLY</value>
  1807. <description>
  1808. This configures the HTTP endpoint for JobHistoryServer web UI.
  1809. The following values are supported:
  1810. - HTTP_ONLY : Service is provided only on http
  1811. - HTTPS_ONLY : Service is provided only on https
  1812. </description>
  1813. </property>
  1814. <property>
  1815. <name>mapreduce.jobhistory.jobname.limit</name>
  1816. <value>50</value>
  1817. <description>
  1818. Number of characters allowed for job name in Job History Server web page.
  1819. </description>
  1820. </property>
  1821. <property>
  1822. <description>
  1823. File format the AM will use when generating the .jhist file. Valid
  1824. values are "json" for text output and "binary" for faster parsing.
  1825. </description>
  1826. <name>mapreduce.jobhistory.jhist.format</name>
  1827. <value>binary</value>
  1828. </property>
  1829. <property>
  1830. <name>mapreduce.job.heap.memory-mb.ratio</name>
  1831. <value>0.8</value>
  1832. <description>The ratio of heap-size to container-size. If no -Xmx is
  1833. specified, it is calculated as
  1834. (mapreduce.{map|reduce}.memory.mb * mapreduce.heap.memory-mb.ratio).
  1835. If -Xmx is specified but not mapreduce.{map|reduce}.memory.mb, it is
  1836. calculated as (heapSize / mapreduce.heap.memory-mb.ratio).
  1837. </description>
  1838. </property>
  1839. <property>
  1840. <name>yarn.app.mapreduce.am.containerlauncher.threadpool-initial-size</name>
  1841. <value>10</value>
  1842. <description>The initial size of thread pool to launch containers in the
  1843. app master.
  1844. </description>
  1845. </property>
  1846. <property>
  1847. <name>mapreduce.task.exit.timeout</name>
  1848. <value>60000</value>
  1849. <description>The number of milliseconds before a task will be
  1850. terminated if it stays in finishing state for too long.
  1851. After a task attempt completes from TaskUmbilicalProtocol's point of view,
  1852. it will be transitioned to finishing state. That will give a chance for the
  1853. task to exit by itself.
  1854. </description>
  1855. </property>
  1856. <property>
  1857. <name>mapreduce.task.exit.timeout.check-interval-ms</name>
  1858. <value>20000</value>
  1859. <description>The interval in milliseconds between which the MR framework
  1860. checks if task attempts stay in finishing state for too long.
  1861. </description>
  1862. </property>
  1863. <property>
  1864. <name>mapreduce.job.encrypted-intermediate-data</name>
  1865. <value>false</value>
  1866. <description>Encrypt intermediate MapReduce spill files or not
  1867. default is false</description>
  1868. </property>
  1869. <property>
  1870. <name>mapreduce.job.encrypted-intermediate-data-key-size-bits</name>
  1871. <value>128</value>
  1872. <description>Mapreduce encrypt data key size default is 128</description>
  1873. </property>
  1874. <property>
  1875. <name>mapreduce.job.encrypted-intermediate-data.buffer.kb</name>
  1876. <value>128</value>
  1877. <description>Buffer size for intermediate encrypt data in kb
  1878. default is 128</description>
  1879. </property>
  1880. <property>
  1881. <name>mapreduce.task.local-fs.write-limit.bytes</name>
  1882. <value>-1</value>
  1883. <description>Limit on the byte written to the local file system by each task.
  1884. This limit only applies to writes that go through the Hadoop filesystem APIs
  1885. within the task process (i.e.: writes that will update the local filesystem's
  1886. BYTES_WRITTEN counter). It does not cover other writes such as logging,
  1887. sideband writes from subprocesses (e.g.: streaming jobs), etc.
  1888. Negative values disable the limit.
  1889. default is -1</description>
  1890. </property>
  1891. <property>
  1892. <description>
  1893. Enable the CSRF filter for the job history web app
  1894. </description>
  1895. <name>mapreduce.jobhistory.webapp.rest-csrf.enabled</name>
  1896. <value>false</value>
  1897. </property>
  1898. <property>
  1899. <description>
  1900. Optional parameter that indicates the custom header name to use for CSRF
  1901. protection.
  1902. </description>
  1903. <name>mapreduce.jobhistory.webapp.rest-csrf.custom-header</name>
  1904. <value>X-XSRF-Header</value>
  1905. </property>
  1906. <property>
  1907. <description>
  1908. Optional parameter that indicates the list of HTTP methods that do not
  1909. require CSRF protection
  1910. </description>
  1911. <name>mapreduce.jobhistory.webapp.rest-csrf.methods-to-ignore</name>
  1912. <value>GET,OPTIONS,HEAD</value>
  1913. </property>
  1914. <property>
  1915. <name>mapreduce.job.cache.limit.max-resources</name>
  1916. <value>0</value>
  1917. <description>The maximum number of resources a map reduce job is allowed to
  1918. submit for localization via files, libjars, archives, and jobjar command
  1919. line arguments and through the distributed cache. If set to 0 the limit is
  1920. ignored.
  1921. </description>
  1922. </property>
  1923. <property>
  1924. <name>mapreduce.job.cache.limit.max-resources-mb</name>
  1925. <value>0</value>
  1926. <description>The maximum size (in MB) a map reduce job is allowed to submit
  1927. for localization via files, libjars, archives, and jobjar command line
  1928. arguments and through the distributed cache. If set to 0 the limit is
  1929. ignored.
  1930. </description>
  1931. </property>
  1932. <property>
  1933. <name>mapreduce.job.cache.limit.max-single-resource-mb</name>
  1934. <value>0</value>
  1935. <description>The maximum size (in MB) of a single resource a map reduce job
  1936. is allow to submit for localization via files, libjars, archives, and
  1937. jobjar command line arguments and through the distributed cache. If set to
  1938. 0 the limit is ignored.
  1939. </description>
  1940. </property>
  1941. <property>
  1942. <description>
  1943. Value of the xframe-options
  1944. </description>
  1945. <name>mapreduce.jobhistory.webapp.xfs-filter.xframe-options</name>
  1946. <value>SAMEORIGIN</value>
  1947. </property>
  1948. <property>
  1949. <description>
  1950. The maximum number of tasks that a job can have so that the Job History
  1951. Server will fully parse its associated job history file and load it into
  1952. memory. A value of -1 (default) will allow all jobs to be loaded.
  1953. </description>
  1954. <name>mapreduce.jobhistory.loadedjob.tasks.max</name>
  1955. <value>-1</value>
  1956. </property>
  1957. <property>
  1958. <description>
  1959. The list of job configuration properties whose value will be redacted.
  1960. </description>
  1961. <name>mapreduce.job.redacted-properties</name>
  1962. <value></value>
  1963. </property>
  1964. <property>
  1965. <description>
  1966. This configuration is a regex expression. The list of configurations that
  1967. match the regex expression will be sent to RM. RM will use these
  1968. configurations for renewing tokens.
  1969. This configuration is added for below scenario: User needs to run distcp
  1970. jobs across two clusters, but the RM does not have necessary hdfs
  1971. configurations to connect to the remote hdfs cluster. Hence, user relies on
  1972. this config to send the configurations to RM and RM uses these
  1973. configurations to renew tokens.
  1974. For example the following regex expression indicates the minimum required
  1975. configs for RM to connect to a remote hdfs cluster:
  1976. dfs.nameservices|^dfs.namenode.rpc-address.*$|^dfs.ha.namenodes.*$|^dfs.client.failover.proxy.provider.*$|dfs.namenode.kerberos.principal
  1977. </description>
  1978. <name>mapreduce.job.send-token-conf</name>
  1979. <value></value>
  1980. </property>
  1981. <property>
  1982. <description>
  1983. The name of an output committer factory for MRv2 FileOutputFormat to use
  1984. for committing work. If set, overrides any per-filesystem committer
  1985. defined for the destination filesystem.
  1986. </description>
  1987. <name>mapreduce.outputcommitter.factory.class</name>
  1988. <value></value>
  1989. </property>
  1990. <property>
  1991. <name>mapreduce.outputcommitter.factory.scheme.s3a</name>
  1992. <value>org.apache.hadoop.fs.s3a.commit.S3ACommitterFactory</value>
  1993. <description>
  1994. The committer factory to use when writing data to S3A filesystems.
  1995. If mapreduce.outputcommitter.factory.class is set, it will
  1996. override this property.
  1997. </description>
  1998. </property>
  1999. <!-- use manifest committer for abfs URLs -->
  2000. <property>
  2001. <name>mapreduce.outputcommitter.factory.scheme.abfs</name>
  2002. <value>org.apache.hadoop.fs.azurebfs.commit.AzureManifestCommitterFactory</value>
  2003. <description>
  2004. The default committer factory for ABFS is the manifest committer with
  2005. abfs-specific recovery.
  2006. </description>
  2007. </property>
  2008. <!-- use manifest committer for gs URLs -->
  2009. <property>
  2010. <name>mapreduce.outputcommitter.factory.scheme.gs</name>
  2011. <value>org.apache.hadoop.mapreduce.lib.output.committer.manifest.ManifestCommitterFactory</value>
  2012. <description>
  2013. The default committer factory for google cloud storage is the manifest committer.
  2014. </description>
  2015. </property>
  2016. </configuration>