mapred-default.xml 64 KB

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