core-default.xml 103 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131
  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 core-site.xml and change them -->
  19. <!-- there. If core-site.xml does not already exist, create it. -->
  20. <configuration>
  21. <!--- global properties -->
  22. <property>
  23. <name>hadoop.common.configuration.version</name>
  24. <value>3.0.0</value>
  25. <description>version of this configuration file</description>
  26. </property>
  27. <property>
  28. <name>hadoop.tmp.dir</name>
  29. <value>/tmp/hadoop-${user.name}</value>
  30. <description>A base for other temporary directories.</description>
  31. </property>
  32. <property>
  33. <name>hadoop.http.filter.initializers</name>
  34. <value>org.apache.hadoop.http.lib.StaticUserWebFilter</value>
  35. <description>A comma separated list of class names. Each class in the list
  36. must extend org.apache.hadoop.http.FilterInitializer. The corresponding
  37. Filter will be initialized. Then, the Filter will be applied to all user
  38. facing jsp and servlet web pages. The ordering of the list defines the
  39. ordering of the filters.</description>
  40. </property>
  41. <!--- security properties -->
  42. <property>
  43. <name>hadoop.security.authorization</name>
  44. <value>false</value>
  45. <description>Is service-level authorization enabled?</description>
  46. </property>
  47. <property>
  48. <name>hadoop.security.instrumentation.requires.admin</name>
  49. <value>false</value>
  50. <description>
  51. Indicates if administrator ACLs are required to access
  52. instrumentation servlets (JMX, METRICS, CONF, STACKS).
  53. </description>
  54. </property>
  55. <property>
  56. <name>hadoop.security.authentication</name>
  57. <value>simple</value>
  58. <description>Possible values are simple (no authentication), and kerberos
  59. </description>
  60. </property>
  61. <property>
  62. <name>hadoop.security.group.mapping</name>
  63. <value>org.apache.hadoop.security.JniBasedUnixGroupsMappingWithFallback</value>
  64. <description>
  65. Class for user to group mapping (get groups for a given user) for ACL.
  66. The default implementation,
  67. org.apache.hadoop.security.JniBasedUnixGroupsMappingWithFallback,
  68. will determine if the Java Native Interface (JNI) is available. If JNI is
  69. available the implementation will use the API within hadoop to resolve a
  70. list of groups for a user. If JNI is not available then the shell
  71. implementation, ShellBasedUnixGroupsMapping, is used. This implementation
  72. shells out to the Linux/Unix environment with the
  73. <code>bash -c groups</code> command to resolve a list of groups for a user.
  74. </description>
  75. </property>
  76. <property>
  77. <name>hadoop.security.dns.interface</name>
  78. <description>
  79. The name of the Network Interface from which the service should determine
  80. its host name for Kerberos login. e.g. eth2. In a multi-homed environment,
  81. the setting can be used to affect the _HOST substitution in the service
  82. Kerberos principal. If this configuration value is not set, the service
  83. will use its default hostname as returned by
  84. InetAddress.getLocalHost().getCanonicalHostName().
  85. Most clusters will not require this setting.
  86. </description>
  87. </property>
  88. <property>
  89. <name>hadoop.security.dns.nameserver</name>
  90. <description>
  91. The host name or IP address of the name server (DNS) which a service Node
  92. should use to determine its own host name for Kerberos Login. Requires
  93. hadoop.security.dns.interface.
  94. Most clusters will not require this setting.
  95. </description>
  96. </property>
  97. <property>
  98. <name>hadoop.security.dns.log-slow-lookups.enabled</name>
  99. <value>false</value>
  100. <description>
  101. Time name lookups (via SecurityUtil) and log them if they exceed the
  102. configured threshold.
  103. </description>
  104. </property>
  105. <property>
  106. <name>hadoop.security.dns.log-slow-lookups.threshold.ms</name>
  107. <value>1000</value>
  108. <description>
  109. If slow lookup logging is enabled, this threshold is used to decide if a
  110. lookup is considered slow enough to be logged.
  111. </description>
  112. </property>
  113. <property>
  114. <name>hadoop.security.groups.cache.secs</name>
  115. <value>300</value>
  116. <description>
  117. This is the config controlling the validity of the entries in the cache
  118. containing the user->group mapping. When this duration has expired,
  119. then the implementation of the group mapping provider is invoked to get
  120. the groups of the user and then cached back.
  121. </description>
  122. </property>
  123. <property>
  124. <name>hadoop.security.groups.negative-cache.secs</name>
  125. <value>30</value>
  126. <description>
  127. Expiration time for entries in the the negative user-to-group mapping
  128. caching, in seconds. This is useful when invalid users are retrying
  129. frequently. It is suggested to set a small value for this expiration, since
  130. a transient error in group lookup could temporarily lock out a legitimate
  131. user.
  132. Set this to zero or negative value to disable negative user-to-group caching.
  133. </description>
  134. </property>
  135. <property>
  136. <name>hadoop.security.groups.cache.warn.after.ms</name>
  137. <value>5000</value>
  138. <description>
  139. If looking up a single user to group takes longer than this amount of
  140. milliseconds, we will log a warning message.
  141. </description>
  142. </property>
  143. <property>
  144. <name>hadoop.security.groups.cache.background.reload</name>
  145. <value>false</value>
  146. <description>
  147. Whether to reload expired user->group mappings using a background thread
  148. pool. If set to true, a pool of
  149. hadoop.security.groups.cache.background.reload.threads is created to
  150. update the cache in the background.
  151. </description>
  152. </property>
  153. <property>
  154. <name>hadoop.security.groups.cache.background.reload.threads</name>
  155. <value>3</value>
  156. <description>
  157. Only relevant if hadoop.security.groups.cache.background.reload is true.
  158. Controls the number of concurrent background user->group cache entry
  159. refreshes. Pending refresh requests beyond this value are queued and
  160. processed when a thread is free.
  161. </description>
  162. </property>
  163. <property>
  164. <name>hadoop.security.groups.shell.command.timeout</name>
  165. <value>0s</value>
  166. <description>
  167. Used by the ShellBasedUnixGroupsMapping class, this property controls how
  168. long to wait for the underlying shell command that is run to fetch groups.
  169. Expressed in seconds (e.g. 10s, 1m, etc.), if the running command takes
  170. longer than the value configured, the command is aborted and the groups
  171. resolver would return a result of no groups found. A value of 0s (default)
  172. would mean an infinite wait (i.e. wait until the command exits on its own).
  173. </description>
  174. </property>
  175. <property>
  176. <name>hadoop.security.group.mapping.ldap.connection.timeout.ms</name>
  177. <value>60000</value>
  178. <description>
  179. This property is the connection timeout (in milliseconds) for LDAP
  180. operations. If the LDAP provider doesn't establish a connection within the
  181. specified period, it will abort the connect attempt. Non-positive value
  182. means no LDAP connection timeout is specified in which case it waits for the
  183. connection to establish until the underlying network times out.
  184. </description>
  185. </property>
  186. <property>
  187. <name>hadoop.security.group.mapping.ldap.read.timeout.ms</name>
  188. <value>60000</value>
  189. <description>
  190. This property is the read timeout (in milliseconds) for LDAP
  191. operations. If the LDAP provider doesn't get a LDAP response within the
  192. specified period, it will abort the read attempt. Non-positive value
  193. means no read timeout is specified in which case it waits for the response
  194. infinitely.
  195. </description>
  196. </property>
  197. <property>
  198. <name>hadoop.security.group.mapping.ldap.url</name>
  199. <value></value>
  200. <description>
  201. The URL of the LDAP server to use for resolving user groups when using
  202. the LdapGroupsMapping user to group mapping.
  203. </description>
  204. </property>
  205. <property>
  206. <name>hadoop.security.group.mapping.ldap.ssl</name>
  207. <value>false</value>
  208. <description>
  209. Whether or not to use SSL when connecting to the LDAP server.
  210. </description>
  211. </property>
  212. <property>
  213. <name>hadoop.security.group.mapping.ldap.ssl.keystore</name>
  214. <value></value>
  215. <description>
  216. File path to the SSL keystore that contains the SSL certificate required
  217. by the LDAP server.
  218. </description>
  219. </property>
  220. <property>
  221. <name>hadoop.security.group.mapping.ldap.ssl.keystore.password.file</name>
  222. <value></value>
  223. <description>
  224. The path to a file containing the password of the LDAP SSL keystore. If
  225. the password is not configured in credential providers and the property
  226. hadoop.security.group.mapping.ldap.ssl.keystore.password is not set,
  227. LDAPGroupsMapping reads password from the file.
  228. IMPORTANT: This file should be readable only by the Unix user running
  229. the daemons and should be a local file.
  230. </description>
  231. </property>
  232. <property>
  233. <name>hadoop.security.group.mapping.ldap.ssl.keystore.password</name>
  234. <value></value>
  235. <description>
  236. The password of the LDAP SSL keystore. this property name is used as an
  237. alias to get the password from credential providers. If the password can
  238. not be found and hadoop.security.credential.clear-text-fallback is true
  239. LDAPGroupsMapping uses the value of this property for password.
  240. </description>
  241. </property>
  242. <property>
  243. <name>hadoop.security.group.mapping.ldap.conversion.rule</name>
  244. <value>none</value>
  245. <description>
  246. The rule is applied on the group names received from LDAP when
  247. RuleBasedLdapGroupsMapping is configured.
  248. Supported rules are "to_upper", "to_lower" and "none".
  249. to_upper: This will convert all the group names to uppercase.
  250. to_lower: This will convert all the group names to lowercase.
  251. none: This will retain the source formatting, this is default value.
  252. </description>
  253. </property>
  254. <property>
  255. <name>hadoop.security.credential.clear-text-fallback</name>
  256. <value>true</value>
  257. <description>
  258. true or false to indicate whether or not to fall back to storing credential
  259. password as clear text. The default value is true. This property only works
  260. when the password can't not be found from credential providers.
  261. </description>
  262. </property>
  263. <property>
  264. <name>hadoop.security.credential.provider.path</name>
  265. <value></value>
  266. <description>
  267. A comma-separated list of URLs that indicates the type and
  268. location of a list of providers that should be consulted.
  269. </description>
  270. </property>
  271. <property>
  272. <name>hadoop.security.credstore.java-keystore-provider.password-file</name>
  273. <value></value>
  274. <description>
  275. The path to a file containing the custom password for all keystores
  276. that may be configured in the provider path.
  277. </description>
  278. </property>
  279. <property>
  280. <name>hadoop.security.group.mapping.ldap.ssl.truststore</name>
  281. <value></value>
  282. <description>
  283. File path to the SSL truststore that contains the root certificate used to
  284. sign the LDAP server's certificate. Specify this if the LDAP server's
  285. certificate is not signed by a well known certificate authority.
  286. </description>
  287. </property>
  288. <property>
  289. <name>hadoop.security.group.mapping.ldap.ssl.truststore.password.file</name>
  290. <value></value>
  291. <description>
  292. The path to a file containing the password of the LDAP SSL truststore.
  293. IMPORTANT: This file should be readable only by the Unix user running
  294. the daemons.
  295. </description>
  296. </property>
  297. <property>
  298. <name>hadoop.security.group.mapping.ldap.bind.user</name>
  299. <value></value>
  300. <description>
  301. The distinguished name of the user to bind as when connecting to the LDAP
  302. server. This may be left blank if the LDAP server supports anonymous binds.
  303. </description>
  304. </property>
  305. <property>
  306. <name>hadoop.security.group.mapping.ldap.bind.password.file</name>
  307. <value></value>
  308. <description>
  309. The path to a file containing the password of the bind user. If
  310. the password is not configured in credential providers and the property
  311. hadoop.security.group.mapping.ldap.bind.password is not set,
  312. LDAPGroupsMapping reads password from the file.
  313. IMPORTANT: This file should be readable only by the Unix user running
  314. the daemons and should be a local file.
  315. </description>
  316. </property>
  317. <property>
  318. <name>hadoop.security.group.mapping.ldap.bind.password</name>
  319. <value></value>
  320. <description>
  321. The password of the bind user. this property name is used as an
  322. alias to get the password from credential providers. If the password can
  323. not be found and hadoop.security.credential.clear-text-fallback is true
  324. LDAPGroupsMapping uses the value of this property for password.
  325. </description>
  326. </property>
  327. <property>
  328. <name>hadoop.security.group.mapping.ldap.base</name>
  329. <value></value>
  330. <description>
  331. The search base for the LDAP connection. This is a distinguished name,
  332. and will typically be the root of the LDAP directory.
  333. </description>
  334. </property>
  335. <property>
  336. <name>hadoop.security.group.mapping.ldap.userbase</name>
  337. <value></value>
  338. <description>
  339. The search base for the LDAP connection for user search query. This is a
  340. distinguished name, and its the root of the LDAP directory for users.
  341. If not set, hadoop.security.group.mapping.ldap.base is used.
  342. </description>
  343. </property>
  344. <property>
  345. <name>hadoop.security.group.mapping.ldap.groupbase</name>
  346. <value></value>
  347. <description>
  348. The search base for the LDAP connection for group search . This is a
  349. distinguished name, and its the root of the LDAP directory for groups.
  350. If not set, hadoop.security.group.mapping.ldap.base is used.
  351. </description>
  352. </property>
  353. <property>
  354. <name>hadoop.security.group.mapping.ldap.search.filter.user</name>
  355. <value>(&amp;(objectClass=user)(sAMAccountName={0}))</value>
  356. <description>
  357. An additional filter to use when searching for LDAP users. The default will
  358. usually be appropriate for Active Directory installations. If connecting to
  359. an LDAP server with a non-AD schema, this should be replaced with
  360. (&amp;(objectClass=inetOrgPerson)(uid={0}). {0} is a special string used to
  361. denote where the username fits into the filter.
  362. If the LDAP server supports posixGroups, Hadoop can enable the feature by
  363. setting the value of this property to "posixAccount" and the value of
  364. the hadoop.security.group.mapping.ldap.search.filter.group property to
  365. "posixGroup".
  366. </description>
  367. </property>
  368. <property>
  369. <name>hadoop.security.group.mapping.ldap.search.filter.group</name>
  370. <value>(objectClass=group)</value>
  371. <description>
  372. An additional filter to use when searching for LDAP groups. This should be
  373. changed when resolving groups against a non-Active Directory installation.
  374. See the description of hadoop.security.group.mapping.ldap.search.filter.user
  375. to enable posixGroups support.
  376. </description>
  377. </property>
  378. <property>
  379. <name>hadoop.security.group.mapping.ldap.search.attr.memberof</name>
  380. <value></value>
  381. <description>
  382. The attribute of the user object that identifies its group objects. By
  383. default, Hadoop makes two LDAP queries per user if this value is empty. If
  384. set, Hadoop will attempt to resolve group names from this attribute,
  385. instead of making the second LDAP query to get group objects. The value
  386. should be 'memberOf' for an MS AD installation.
  387. </description>
  388. </property>
  389. <property>
  390. <name>hadoop.security.group.mapping.ldap.search.attr.member</name>
  391. <value>member</value>
  392. <description>
  393. The attribute of the group object that identifies the users that are
  394. members of the group. The default will usually be appropriate for
  395. any LDAP installation.
  396. </description>
  397. </property>
  398. <property>
  399. <name>hadoop.security.group.mapping.ldap.search.attr.group.name</name>
  400. <value>cn</value>
  401. <description>
  402. The attribute of the group object that identifies the group name. The
  403. default will usually be appropriate for all LDAP systems.
  404. </description>
  405. </property>
  406. <property>
  407. <name>hadoop.security.group.mapping.ldap.search.group.hierarchy.levels</name>
  408. <value>0</value>
  409. <description>
  410. The number of levels to go up the group hierarchy when determining
  411. which groups a user is part of. 0 Will represent checking just the
  412. group that the user belongs to. Each additional level will raise the
  413. time it takes to execute a query by at most
  414. hadoop.security.group.mapping.ldap.directory.search.timeout.
  415. The default will usually be appropriate for all LDAP systems.
  416. </description>
  417. </property>
  418. <property>
  419. <name>hadoop.security.group.mapping.ldap.posix.attr.uid.name</name>
  420. <value>uidNumber</value>
  421. <description>
  422. The attribute of posixAccount to use when groups for membership.
  423. Mostly useful for schemas wherein groups have memberUids that use an
  424. attribute other than uidNumber.
  425. </description>
  426. </property>
  427. <property>
  428. <name>hadoop.security.group.mapping.ldap.posix.attr.gid.name</name>
  429. <value>gidNumber</value>
  430. <description>
  431. The attribute of posixAccount indicating the group id.
  432. </description>
  433. </property>
  434. <property>
  435. <name>hadoop.security.group.mapping.ldap.directory.search.timeout</name>
  436. <value>10000</value>
  437. <description>
  438. The attribute applied to the LDAP SearchControl properties to set a
  439. maximum time limit when searching and awaiting a result.
  440. Set to 0 if infinite wait period is desired.
  441. Default is 10 seconds. Units in milliseconds.
  442. </description>
  443. </property>
  444. <property>
  445. <name>hadoop.security.group.mapping.providers</name>
  446. <value></value>
  447. <description>
  448. Comma separated of names of other providers to provide user to group
  449. mapping. Used by CompositeGroupsMapping.
  450. </description>
  451. </property>
  452. <property>
  453. <name>hadoop.security.group.mapping.providers.combined</name>
  454. <value>true</value>
  455. <description>
  456. true or false to indicate whether groups from the providers are combined or
  457. not. The default value is true. If true, then all the providers will be
  458. tried to get groups and all the groups are combined to return as the final
  459. results. Otherwise, providers are tried one by one in the configured list
  460. order, and if any groups are retrieved from any provider, then the groups
  461. will be returned without trying the left ones.
  462. </description>
  463. </property>
  464. <property>
  465. <name>hadoop.security.service.user.name.key</name>
  466. <value></value>
  467. <description>
  468. For those cases where the same RPC protocol is implemented by multiple
  469. servers, this configuration is required for specifying the principal
  470. name to use for the service when the client wishes to make an RPC call.
  471. </description>
  472. </property>
  473. <property>
  474. <name>fs.azure.user.agent.prefix</name>
  475. <value>unknown</value>
  476. <description>
  477. WASB passes User-Agent header to the Azure back-end. The default value
  478. contains WASB version, Java Runtime version, Azure Client library version,
  479. and the value of the configuration option fs.azure.user.agent.prefix.
  480. </description>
  481. </property>
  482. <property>
  483. <name>hadoop.security.uid.cache.secs</name>
  484. <value>14400</value>
  485. <description>
  486. This is the config controlling the validity of the entries in the cache
  487. containing the userId to userName and groupId to groupName used by
  488. NativeIO getFstat().
  489. </description>
  490. </property>
  491. <property>
  492. <name>hadoop.service.shutdown.timeout</name>
  493. <value>30s</value>
  494. <description>
  495. Timeout to wait for each shutdown operation to complete.
  496. If a hook takes longer than this time to complete, it will be interrupted,
  497. so the service will shutdown. This allows the service shutdown
  498. to recover from a blocked operation.
  499. Some shutdown hooks may need more time than this, for example when
  500. a large amount of data needs to be uploaded to an object store.
  501. In this situation: increase the timeout.
  502. The minimum duration of the timeout is 1 second, "1s".
  503. </description>
  504. </property>
  505. <property>
  506. <name>hadoop.rpc.protection</name>
  507. <value>authentication</value>
  508. <description>A comma-separated list of protection values for secured sasl
  509. connections. Possible values are authentication, integrity and privacy.
  510. authentication means authentication only and no integrity or privacy;
  511. integrity implies authentication and integrity are enabled; and privacy
  512. implies all of authentication, integrity and privacy are enabled.
  513. hadoop.security.saslproperties.resolver.class can be used to override
  514. the hadoop.rpc.protection for a connection at the server side.
  515. </description>
  516. </property>
  517. <property>
  518. <name>hadoop.security.saslproperties.resolver.class</name>
  519. <value></value>
  520. <description>SaslPropertiesResolver used to resolve the QOP used for a
  521. connection. If not specified, the full set of values specified in
  522. hadoop.rpc.protection is used while determining the QOP used for the
  523. connection. If a class is specified, then the QOP values returned by
  524. the class will be used while determining the QOP used for the connection.
  525. </description>
  526. </property>
  527. <property>
  528. <name>hadoop.security.sensitive-config-keys</name>
  529. <value>
  530. secret$
  531. password$
  532. ssl.keystore.pass$
  533. fs.s3.*[Ss]ecret.?[Kk]ey
  534. fs.s3a.*.server-side-encryption.key
  535. fs.azure.account.key.*
  536. credential$
  537. oauth.*token$
  538. hadoop.security.sensitive-config-keys
  539. </value>
  540. <description>A comma-separated or multi-line list of regular expressions to
  541. match configuration keys that should be redacted where appropriate, for
  542. example, when logging modified properties during a reconfiguration,
  543. private credentials should not be logged.
  544. </description>
  545. </property>
  546. <property>
  547. <name>hadoop.workaround.non.threadsafe.getpwuid</name>
  548. <value>true</value>
  549. <description>Some operating systems or authentication modules are known to
  550. have broken implementations of getpwuid_r and getpwgid_r, such that these
  551. calls are not thread-safe. Symptoms of this problem include JVM crashes
  552. with a stack trace inside these functions. If your system exhibits this
  553. issue, enable this configuration parameter to include a lock around the
  554. calls as a workaround.
  555. An incomplete list of some systems known to have this issue is available
  556. at http://wiki.apache.org/hadoop/KnownBrokenPwuidImplementations
  557. </description>
  558. </property>
  559. <property>
  560. <name>hadoop.kerberos.kinit.command</name>
  561. <value>kinit</value>
  562. <description>Used to periodically renew Kerberos credentials when provided
  563. to Hadoop. The default setting assumes that kinit is in the PATH of users
  564. running the Hadoop client. Change this to the absolute path to kinit if this
  565. is not the case.
  566. </description>
  567. </property>
  568. <property>
  569. <name>hadoop.kerberos.min.seconds.before.relogin</name>
  570. <value>60</value>
  571. <description>The minimum time between relogin attempts for Kerberos, in
  572. seconds.
  573. </description>
  574. </property>
  575. <property>
  576. <name>hadoop.security.auth_to_local</name>
  577. <value></value>
  578. <description>Maps kerberos principals to local user names</description>
  579. </property>
  580. <property>
  581. <name>hadoop.token.files</name>
  582. <value></value>
  583. <description>List of token cache files that have delegation tokens for hadoop service</description>
  584. </property>
  585. <!-- i/o properties -->
  586. <property>
  587. <name>io.file.buffer.size</name>
  588. <value>4096</value>
  589. <description>The size of buffer for use in sequence files.
  590. The size of this buffer should probably be a multiple of hardware
  591. page size (4096 on Intel x86), and it determines how much data is
  592. buffered during read and write operations.</description>
  593. </property>
  594. <property>
  595. <name>io.bytes.per.checksum</name>
  596. <value>512</value>
  597. <description>The number of bytes per checksum. Must not be larger than
  598. io.file.buffer.size.</description>
  599. </property>
  600. <property>
  601. <name>io.skip.checksum.errors</name>
  602. <value>false</value>
  603. <description>If true, when a checksum error is encountered while
  604. reading a sequence file, entries are skipped, instead of throwing an
  605. exception.</description>
  606. </property>
  607. <property>
  608. <name>io.compression.codecs</name>
  609. <value></value>
  610. <description>A comma-separated list of the compression codec classes that can
  611. be used for compression/decompression. In addition to any classes specified
  612. with this property (which take precedence), codec classes on the classpath
  613. are discovered using a Java ServiceLoader.</description>
  614. </property>
  615. <property>
  616. <name>io.compression.codec.bzip2.library</name>
  617. <value>system-native</value>
  618. <description>The native-code library to be used for compression and
  619. decompression by the bzip2 codec. This library could be specified
  620. either by by name or the full pathname. In the former case, the
  621. library is located by the dynamic linker, usually searching the
  622. directories specified in the environment variable LD_LIBRARY_PATH.
  623. The value of "system-native" indicates that the default system
  624. library should be used. To indicate that the algorithm should
  625. operate entirely in Java, specify "java-builtin".</description>
  626. </property>
  627. <property>
  628. <name>io.serializations</name>
  629. <value>org.apache.hadoop.io.serializer.WritableSerialization, org.apache.hadoop.io.serializer.avro.AvroSpecificSerialization, org.apache.hadoop.io.serializer.avro.AvroReflectSerialization</value>
  630. <description>A list of serialization classes that can be used for
  631. obtaining serializers and deserializers.</description>
  632. </property>
  633. <property>
  634. <name>io.seqfile.local.dir</name>
  635. <value>${hadoop.tmp.dir}/io/local</value>
  636. <description>The local directory where sequence file stores intermediate
  637. data files during merge. May be a comma-separated list of
  638. directories on different devices in order to spread disk i/o.
  639. Directories that do not exist are ignored.
  640. </description>
  641. </property>
  642. <property>
  643. <name>io.map.index.skip</name>
  644. <value>0</value>
  645. <description>Number of index entries to skip between each entry.
  646. Zero by default. Setting this to values larger than zero can
  647. facilitate opening large MapFiles using less memory.</description>
  648. </property>
  649. <property>
  650. <name>io.map.index.interval</name>
  651. <value>128</value>
  652. <description>
  653. MapFile consist of two files - data file (tuples) and index file
  654. (keys). For every io.map.index.interval records written in the
  655. data file, an entry (record-key, data-file-position) is written
  656. in the index file. This is to allow for doing binary search later
  657. within the index file to look up records by their keys and get their
  658. closest positions in the data file.
  659. </description>
  660. </property>
  661. <property>
  662. <name>io.erasurecode.codec.rs.rawcoders</name>
  663. <value>rs_native,rs_java</value>
  664. <description>
  665. Comma separated raw coder implementations for the rs codec. The earlier
  666. factory is prior to followings in case of failure of creating raw coders.
  667. </description>
  668. </property>
  669. <property>
  670. <name>io.erasurecode.codec.rs-legacy.rawcoders</name>
  671. <value>rs-legacy_java</value>
  672. <description>
  673. Comma separated raw coder implementations for the rs-legacy codec. The earlier
  674. factory is prior to followings in case of failure of creating raw coders.
  675. </description>
  676. </property>
  677. <property>
  678. <name>io.erasurecode.codec.xor.rawcoders</name>
  679. <value>xor_native,xor_java</value>
  680. <description>
  681. Comma separated raw coder implementations for the xor codec. The earlier
  682. factory is prior to followings in case of failure of creating raw coders.
  683. </description>
  684. </property>
  685. <!-- file system properties -->
  686. <property>
  687. <name>fs.defaultFS</name>
  688. <value>file:///</value>
  689. <description>The name of the default file system. A URI whose
  690. scheme and authority determine the FileSystem implementation. The
  691. uri's scheme determines the config property (fs.SCHEME.impl) naming
  692. the FileSystem implementation class. The uri's authority is used to
  693. determine the host, port, etc. for a filesystem.</description>
  694. </property>
  695. <property>
  696. <name>fs.default.name</name>
  697. <value>file:///</value>
  698. <description>Deprecated. Use (fs.defaultFS) property
  699. instead</description>
  700. </property>
  701. <property>
  702. <name>fs.trash.interval</name>
  703. <value>0</value>
  704. <description>Number of minutes after which the checkpoint
  705. gets deleted. If zero, the trash feature is disabled.
  706. This option may be configured both on the server and the
  707. client. If trash is disabled server side then the client
  708. side configuration is checked. If trash is enabled on the
  709. server side then the value configured on the server is
  710. used and the client configuration value is ignored.
  711. </description>
  712. </property>
  713. <property>
  714. <name>fs.trash.checkpoint.interval</name>
  715. <value>0</value>
  716. <description>Number of minutes between trash checkpoints.
  717. Should be smaller or equal to fs.trash.interval. If zero,
  718. the value is set to the value of fs.trash.interval.
  719. Every time the checkpointer runs it creates a new checkpoint
  720. out of current and removes checkpoints created more than
  721. fs.trash.interval minutes ago.
  722. </description>
  723. </property>
  724. <property>
  725. <name>fs.protected.directories</name>
  726. <value></value>
  727. <description>A comma-separated list of directories which cannot
  728. be deleted even by the superuser unless they are empty. This
  729. setting can be used to guard important system directories
  730. against accidental deletion due to administrator error.
  731. </description>
  732. </property>
  733. <property>
  734. <name>fs.AbstractFileSystem.file.impl</name>
  735. <value>org.apache.hadoop.fs.local.LocalFs</value>
  736. <description>The AbstractFileSystem for file: uris.</description>
  737. </property>
  738. <property>
  739. <name>fs.AbstractFileSystem.har.impl</name>
  740. <value>org.apache.hadoop.fs.HarFs</value>
  741. <description>The AbstractFileSystem for har: uris.</description>
  742. </property>
  743. <property>
  744. <name>fs.AbstractFileSystem.hdfs.impl</name>
  745. <value>org.apache.hadoop.fs.Hdfs</value>
  746. <description>The FileSystem for hdfs: uris.</description>
  747. </property>
  748. <property>
  749. <name>fs.AbstractFileSystem.viewfs.impl</name>
  750. <value>org.apache.hadoop.fs.viewfs.ViewFs</value>
  751. <description>The AbstractFileSystem for view file system for viewfs: uris
  752. (ie client side mount table:).</description>
  753. </property>
  754. <property>
  755. <name>fs.viewfs.rename.strategy</name>
  756. <value>SAME_MOUNTPOINT</value>
  757. <description>Allowed rename strategy to rename between multiple mountpoints.
  758. Allowed values are SAME_MOUNTPOINT,SAME_TARGET_URI_ACROSS_MOUNTPOINT and
  759. SAME_FILESYSTEM_ACROSS_MOUNTPOINT.
  760. </description>
  761. </property>
  762. <property>
  763. <name>fs.AbstractFileSystem.ftp.impl</name>
  764. <value>org.apache.hadoop.fs.ftp.FtpFs</value>
  765. <description>The FileSystem for Ftp: uris.</description>
  766. </property>
  767. <property>
  768. <name>fs.ftp.impl</name>
  769. <value>org.apache.hadoop.fs.ftp.FTPFileSystem</value>
  770. <description>The implementation class of the FTP FileSystem</description>
  771. </property>
  772. <property>
  773. <name>fs.AbstractFileSystem.webhdfs.impl</name>
  774. <value>org.apache.hadoop.fs.WebHdfs</value>
  775. <description>The FileSystem for webhdfs: uris.</description>
  776. </property>
  777. <property>
  778. <name>fs.AbstractFileSystem.swebhdfs.impl</name>
  779. <value>org.apache.hadoop.fs.SWebHdfs</value>
  780. <description>The FileSystem for swebhdfs: uris.</description>
  781. </property>
  782. <property>
  783. <name>fs.ftp.host</name>
  784. <value>0.0.0.0</value>
  785. <description>FTP filesystem connects to this server</description>
  786. </property>
  787. <property>
  788. <name>fs.ftp.host.port</name>
  789. <value>21</value>
  790. <description>
  791. FTP filesystem connects to fs.ftp.host on this port
  792. </description>
  793. </property>
  794. <property>
  795. <name>fs.ftp.data.connection.mode</name>
  796. <value>ACTIVE_LOCAL_DATA_CONNECTION_MODE</value>
  797. <description>Set the FTPClient's data connection mode based on configuration.
  798. Valid values are ACTIVE_LOCAL_DATA_CONNECTION_MODE,
  799. PASSIVE_LOCAL_DATA_CONNECTION_MODE and PASSIVE_REMOTE_DATA_CONNECTION_MODE.
  800. </description>
  801. </property>
  802. <property>
  803. <name>fs.ftp.transfer.mode</name>
  804. <value>BLOCK_TRANSFER_MODE</value>
  805. <description>
  806. Set FTP's transfer mode based on configuration. Valid values are
  807. STREAM_TRANSFER_MODE, BLOCK_TRANSFER_MODE and COMPRESSED_TRANSFER_MODE.
  808. </description>
  809. </property>
  810. <property>
  811. <name>fs.df.interval</name>
  812. <value>60000</value>
  813. <description>Disk usage statistics refresh interval in msec.</description>
  814. </property>
  815. <property>
  816. <name>fs.du.interval</name>
  817. <value>600000</value>
  818. <description>File space usage statistics refresh interval in msec.</description>
  819. </property>
  820. <property>
  821. <name>fs.swift.impl</name>
  822. <value>org.apache.hadoop.fs.swift.snative.SwiftNativeFileSystem</value>
  823. <description>The implementation class of the OpenStack Swift Filesystem</description>
  824. </property>
  825. <property>
  826. <name>fs.automatic.close</name>
  827. <value>true</value>
  828. <description>By default, FileSystem instances are automatically closed at program
  829. exit using a JVM shutdown hook. Setting this property to false disables this
  830. behavior. This is an advanced option that should only be used by server applications
  831. requiring a more carefully orchestrated shutdown sequence.
  832. </description>
  833. </property>
  834. <property>
  835. <name>fs.s3a.access.key</name>
  836. <description>AWS access key ID used by S3A file system. Omit for IAM role-based or provider-based authentication.</description>
  837. </property>
  838. <property>
  839. <name>fs.s3a.secret.key</name>
  840. <description>AWS secret key used by S3A file system. Omit for IAM role-based or provider-based authentication.</description>
  841. </property>
  842. <property>
  843. <name>fs.s3a.aws.credentials.provider</name>
  844. <description>
  845. Comma-separated class names of credential provider classes which implement
  846. com.amazonaws.auth.AWSCredentialsProvider.
  847. These are loaded and queried in sequence for a valid set of credentials.
  848. Each listed class must implement one of the following means of
  849. construction, which are attempted in order:
  850. 1. a public constructor accepting java.net.URI and
  851. org.apache.hadoop.conf.Configuration,
  852. 2. a public static method named getInstance that accepts no
  853. arguments and returns an instance of
  854. com.amazonaws.auth.AWSCredentialsProvider, or
  855. 3. a public default constructor.
  856. Specifying org.apache.hadoop.fs.s3a.AnonymousAWSCredentialsProvider allows
  857. anonymous access to a publicly accessible S3 bucket without any credentials.
  858. Please note that allowing anonymous access to an S3 bucket compromises
  859. security and therefore is unsuitable for most use cases. It can be useful
  860. for accessing public data sets without requiring AWS credentials.
  861. If unspecified, then the default list of credential provider classes,
  862. queried in sequence, is:
  863. 1. org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider:
  864. Uses the values of fs.s3a.access.key and fs.s3a.secret.key.
  865. 2. com.amazonaws.auth.EnvironmentVariableCredentialsProvider: supports
  866. configuration of AWS access key ID and secret access key in
  867. environment variables named AWS_ACCESS_KEY_ID and
  868. AWS_SECRET_ACCESS_KEY, as documented in the AWS SDK.
  869. 3. com.amazonaws.auth.InstanceProfileCredentialsProvider: supports use
  870. of instance profile credentials if running in an EC2 VM.
  871. </description>
  872. </property>
  873. <property>
  874. <name>fs.s3a.session.token</name>
  875. <description>Session token, when using org.apache.hadoop.fs.s3a.TemporaryAWSCredentialsProvider
  876. as one of the providers.
  877. </description>
  878. </property>
  879. <property>
  880. <name>fs.s3a.security.credential.provider.path</name>
  881. <value />
  882. <description>
  883. Optional comma separated list of credential providers, a list
  884. which is prepended to that set in hadoop.security.credential.provider.path
  885. </description>
  886. </property>
  887. <property>
  888. <name>fs.s3a.assumed.role.arn</name>
  889. <value />
  890. <description>
  891. AWS ARN for the role to be assumed.
  892. Required if the fs.s3a.aws.credentials.provider contains
  893. org.apache.hadoop.fs.s3a.AssumedRoleCredentialProvider
  894. </description>
  895. </property>
  896. <property>
  897. <name>fs.s3a.assumed.role.session.name</name>
  898. <value />
  899. <description>
  900. Session name for the assumed role, must be valid characters according to
  901. the AWS APIs.
  902. Only used if AssumedRoleCredentialProvider is the AWS credential provider.
  903. If not set, one is generated from the current Hadoop/Kerberos username.
  904. </description>
  905. </property>
  906. <property>
  907. <name>fs.s3a.assumed.role.policy</name>
  908. <value/>
  909. <description>
  910. JSON policy to apply to the role.
  911. Only used if AssumedRoleCredentialProvider is the AWS credential provider.
  912. </description>
  913. </property>
  914. <property>
  915. <name>fs.s3a.assumed.role.session.duration</name>
  916. <value>30m</value>
  917. <description>
  918. Duration of assumed roles before a refresh is attempted.
  919. Only used if AssumedRoleCredentialProvider is the AWS credential provider.
  920. Range: 15m to 1h
  921. </description>
  922. </property>
  923. <property>
  924. <name>fs.s3a.assumed.role.sts.endpoint</name>
  925. <value/>
  926. <description>
  927. AWS Security Token Service Endpoint.
  928. If unset, uses the default endpoint.
  929. Only used if AssumedRoleCredentialProvider is the AWS credential provider.
  930. </description>
  931. </property>
  932. <property>
  933. <name>fs.s3a.assumed.role.sts.endpoint.region</name>
  934. <value>us-west-1</value>
  935. <description>
  936. AWS Security Token Service Endpoint's region;
  937. Needed if fs.s3a.assumed.role.sts.endpoint points to an endpoint
  938. other than the default one and the v4 signature is used.
  939. Only used if AssumedRoleCredentialProvider is the AWS credential provider.
  940. </description>
  941. </property>
  942. <property>
  943. <name>fs.s3a.assumed.role.credentials.provider</name>
  944. <value>org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider</value>
  945. <description>
  946. List of credential providers to authenticate with the STS endpoint and
  947. retrieve short-lived role credentials.
  948. Only used if AssumedRoleCredentialProvider is the AWS credential provider.
  949. If unset, uses "org.apache.hadoop.fs.s3a.SimpleAWSCredentialsProvider".
  950. </description>
  951. </property>
  952. <property>
  953. <name>fs.s3a.connection.maximum</name>
  954. <value>15</value>
  955. <description>Controls the maximum number of simultaneous connections to S3.</description>
  956. </property>
  957. <property>
  958. <name>fs.s3a.connection.ssl.enabled</name>
  959. <value>true</value>
  960. <description>Enables or disables SSL connections to AWS services.
  961. Also sets the default port to use for the s3a proxy settings,
  962. when not explicitly set in fs.s3a.proxy.port.</description>
  963. </property>
  964. <property>
  965. <name>fs.s3a.endpoint</name>
  966. <description>AWS S3 endpoint to connect to. An up-to-date list is
  967. provided in the AWS Documentation: regions and endpoints. Without this
  968. property, the standard region (s3.amazonaws.com) is assumed.
  969. </description>
  970. </property>
  971. <property>
  972. <name>fs.s3a.path.style.access</name>
  973. <value>false</value>
  974. <description>Enable S3 path style access ie disabling the default virtual hosting behaviour.
  975. Useful for S3A-compliant storage providers as it removes the need to set up DNS for virtual hosting.
  976. </description>
  977. </property>
  978. <property>
  979. <name>fs.s3a.proxy.host</name>
  980. <description>Hostname of the (optional) proxy server for S3 connections.</description>
  981. </property>
  982. <property>
  983. <name>fs.s3a.proxy.port</name>
  984. <description>Proxy server port. If this property is not set
  985. but fs.s3a.proxy.host is, port 80 or 443 is assumed (consistent with
  986. the value of fs.s3a.connection.ssl.enabled).</description>
  987. </property>
  988. <property>
  989. <name>fs.s3a.proxy.username</name>
  990. <description>Username for authenticating with proxy server.</description>
  991. </property>
  992. <property>
  993. <name>fs.s3a.proxy.password</name>
  994. <description>Password for authenticating with proxy server.</description>
  995. </property>
  996. <property>
  997. <name>fs.s3a.proxy.domain</name>
  998. <description>Domain for authenticating with proxy server.</description>
  999. </property>
  1000. <property>
  1001. <name>fs.s3a.proxy.workstation</name>
  1002. <description>Workstation for authenticating with proxy server.</description>
  1003. </property>
  1004. <property>
  1005. <name>fs.s3a.attempts.maximum</name>
  1006. <value>20</value>
  1007. <description>How many times we should retry commands on transient errors.</description>
  1008. </property>
  1009. <property>
  1010. <name>fs.s3a.connection.establish.timeout</name>
  1011. <value>5000</value>
  1012. <description>Socket connection setup timeout in milliseconds.</description>
  1013. </property>
  1014. <property>
  1015. <name>fs.s3a.connection.timeout</name>
  1016. <value>200000</value>
  1017. <description>Socket connection timeout in milliseconds.</description>
  1018. </property>
  1019. <property>
  1020. <name>fs.s3a.socket.send.buffer</name>
  1021. <value>8192</value>
  1022. <description>Socket send buffer hint to amazon connector. Represented in bytes.</description>
  1023. </property>
  1024. <property>
  1025. <name>fs.s3a.socket.recv.buffer</name>
  1026. <value>8192</value>
  1027. <description>Socket receive buffer hint to amazon connector. Represented in bytes.</description>
  1028. </property>
  1029. <property>
  1030. <name>fs.s3a.paging.maximum</name>
  1031. <value>5000</value>
  1032. <description>How many keys to request from S3 when doing
  1033. directory listings at a time.</description>
  1034. </property>
  1035. <property>
  1036. <name>fs.s3a.threads.max</name>
  1037. <value>10</value>
  1038. <description>The total number of threads available in the filesystem for data
  1039. uploads *or any other queued filesystem operation*.</description>
  1040. </property>
  1041. <property>
  1042. <name>fs.s3a.threads.keepalivetime</name>
  1043. <value>60</value>
  1044. <description>Number of seconds a thread can be idle before being
  1045. terminated.</description>
  1046. </property>
  1047. <property>
  1048. <name>fs.s3a.max.total.tasks</name>
  1049. <value>5</value>
  1050. <description>The number of operations which can be queued for execution</description>
  1051. </property>
  1052. <property>
  1053. <name>fs.s3a.multipart.size</name>
  1054. <value>100M</value>
  1055. <description>How big (in bytes) to split upload or copy operations up into.
  1056. A suffix from the set {K,M,G,T,P} may be used to scale the numeric value.
  1057. </description>
  1058. </property>
  1059. <property>
  1060. <name>fs.s3a.multipart.threshold</name>
  1061. <value>2147483647</value>
  1062. <description>How big (in bytes) to split upload or copy operations up into.
  1063. This also controls the partition size in renamed files, as rename() involves
  1064. copying the source file(s).
  1065. A suffix from the set {K,M,G,T,P} may be used to scale the numeric value.
  1066. </description>
  1067. </property>
  1068. <property>
  1069. <name>fs.s3a.multiobjectdelete.enable</name>
  1070. <value>true</value>
  1071. <description>When enabled, multiple single-object delete requests are replaced by
  1072. a single 'delete multiple objects'-request, reducing the number of requests.
  1073. Beware: legacy S3-compatible object stores might not support this request.
  1074. </description>
  1075. </property>
  1076. <property>
  1077. <name>fs.s3a.acl.default</name>
  1078. <description>Set a canned ACL for newly created and copied objects. Value may be Private,
  1079. PublicRead, PublicReadWrite, AuthenticatedRead, LogDeliveryWrite, BucketOwnerRead,
  1080. or BucketOwnerFullControl.</description>
  1081. </property>
  1082. <property>
  1083. <name>fs.s3a.multipart.purge</name>
  1084. <value>false</value>
  1085. <description>True if you want to purge existing multipart uploads that may not have been
  1086. completed/aborted correctly. The corresponding purge age is defined in
  1087. fs.s3a.multipart.purge.age.
  1088. If set, when the filesystem is instantiated then all outstanding uploads
  1089. older than the purge age will be terminated -across the entire bucket.
  1090. This will impact multipart uploads by other applications and users. so should
  1091. be used sparingly, with an age value chosen to stop failed uploads, without
  1092. breaking ongoing operations.
  1093. </description>
  1094. </property>
  1095. <property>
  1096. <name>fs.s3a.multipart.purge.age</name>
  1097. <value>86400</value>
  1098. <description>Minimum age in seconds of multipart uploads to purge
  1099. on startup if "fs.s3a.multipart.purge" is true
  1100. </description>
  1101. </property>
  1102. <property>
  1103. <name>fs.s3a.server-side-encryption-algorithm</name>
  1104. <description>Specify a server-side encryption algorithm for s3a: file system.
  1105. Unset by default. It supports the following values: 'AES256' (for SSE-S3),
  1106. 'SSE-KMS' and 'SSE-C'.
  1107. </description>
  1108. </property>
  1109. <property>
  1110. <name>fs.s3a.server-side-encryption.key</name>
  1111. <description>Specific encryption key to use if fs.s3a.server-side-encryption-algorithm
  1112. has been set to 'SSE-KMS' or 'SSE-C'. In the case of SSE-C, the value of this property
  1113. should be the Base64 encoded key. If you are using SSE-KMS and leave this property empty,
  1114. you'll be using your default's S3 KMS key, otherwise you should set this property to
  1115. the specific KMS key id.
  1116. </description>
  1117. </property>
  1118. <property>
  1119. <name>fs.s3a.signing-algorithm</name>
  1120. <description>Override the default signing algorithm so legacy
  1121. implementations can still be used</description>
  1122. </property>
  1123. <property>
  1124. <name>fs.s3a.block.size</name>
  1125. <value>32M</value>
  1126. <description>Block size to use when reading files using s3a: file system.
  1127. A suffix from the set {K,M,G,T,P} may be used to scale the numeric value.
  1128. </description>
  1129. </property>
  1130. <property>
  1131. <name>fs.s3a.buffer.dir</name>
  1132. <value>${hadoop.tmp.dir}/s3a</value>
  1133. <description>Comma separated list of directories that will be used to buffer file
  1134. uploads to.</description>
  1135. </property>
  1136. <property>
  1137. <name>fs.s3a.fast.upload.buffer</name>
  1138. <value>disk</value>
  1139. <description>
  1140. The buffering mechanism to for data being written.
  1141. Values: disk, array, bytebuffer.
  1142. "disk" will use the directories listed in fs.s3a.buffer.dir as
  1143. the location(s) to save data prior to being uploaded.
  1144. "array" uses arrays in the JVM heap
  1145. "bytebuffer" uses off-heap memory within the JVM.
  1146. Both "array" and "bytebuffer" will consume memory in a single stream up to the number
  1147. of blocks set by:
  1148. fs.s3a.multipart.size * fs.s3a.fast.upload.active.blocks.
  1149. If using either of these mechanisms, keep this value low
  1150. The total number of threads performing work across all threads is set by
  1151. fs.s3a.threads.max, with fs.s3a.max.total.tasks values setting the number of queued
  1152. work items.
  1153. </description>
  1154. </property>
  1155. <property>
  1156. <name>fs.s3a.fast.upload.active.blocks</name>
  1157. <value>4</value>
  1158. <description>
  1159. Maximum Number of blocks a single output stream can have
  1160. active (uploading, or queued to the central FileSystem
  1161. instance's pool of queued operations.
  1162. This stops a single stream overloading the shared thread pool.
  1163. </description>
  1164. </property>
  1165. <property>
  1166. <name>fs.s3a.readahead.range</name>
  1167. <value>64K</value>
  1168. <description>Bytes to read ahead during a seek() before closing and
  1169. re-opening the S3 HTTP connection. This option will be overridden if
  1170. any call to setReadahead() is made to an open stream.
  1171. A suffix from the set {K,M,G,T,P} may be used to scale the numeric value.
  1172. </description>
  1173. </property>
  1174. <property>
  1175. <name>fs.s3a.user.agent.prefix</name>
  1176. <value></value>
  1177. <description>
  1178. Sets a custom value that will be prepended to the User-Agent header sent in
  1179. HTTP requests to the S3 back-end by S3AFileSystem. The User-Agent header
  1180. always includes the Hadoop version number followed by a string generated by
  1181. the AWS SDK. An example is "User-Agent: Hadoop 2.8.0, aws-sdk-java/1.10.6".
  1182. If this optional property is set, then its value is prepended to create a
  1183. customized User-Agent. For example, if this configuration property was set
  1184. to "MyApp", then an example of the resulting User-Agent would be
  1185. "User-Agent: MyApp, Hadoop 2.8.0, aws-sdk-java/1.10.6".
  1186. </description>
  1187. </property>
  1188. <property>
  1189. <name>fs.s3a.metadatastore.authoritative</name>
  1190. <value>false</value>
  1191. <description>
  1192. When true, allow MetadataStore implementations to act as source of
  1193. truth for getting file status and directory listings. Even if this
  1194. is set to true, MetadataStore implementations may choose not to
  1195. return authoritative results. If the configured MetadataStore does
  1196. not support being authoritative, this setting will have no effect.
  1197. </description>
  1198. </property>
  1199. <property>
  1200. <name>fs.s3a.metadatastore.impl</name>
  1201. <value>org.apache.hadoop.fs.s3a.s3guard.NullMetadataStore</value>
  1202. <description>
  1203. Fully-qualified name of the class that implements the MetadataStore
  1204. to be used by s3a. The default class, NullMetadataStore, has no
  1205. effect: s3a will continue to treat the backing S3 service as the one
  1206. and only source of truth for file and directory metadata.
  1207. </description>
  1208. </property>
  1209. <property>
  1210. <name>fs.s3a.s3guard.cli.prune.age</name>
  1211. <value>86400000</value>
  1212. <description>
  1213. Default age (in milliseconds) after which to prune metadata from the
  1214. metadatastore when the prune command is run. Can be overridden on the
  1215. command-line.
  1216. </description>
  1217. </property>
  1218. <property>
  1219. <name>fs.s3a.impl</name>
  1220. <value>org.apache.hadoop.fs.s3a.S3AFileSystem</value>
  1221. <description>The implementation class of the S3A Filesystem</description>
  1222. </property>
  1223. <property>
  1224. <name>fs.s3a.s3guard.ddb.region</name>
  1225. <value></value>
  1226. <description>
  1227. AWS DynamoDB region to connect to. An up-to-date list is
  1228. provided in the AWS Documentation: regions and endpoints. Without this
  1229. property, the S3Guard will operate table in the associated S3 bucket region.
  1230. </description>
  1231. </property>
  1232. <property>
  1233. <name>fs.s3a.s3guard.ddb.table</name>
  1234. <value></value>
  1235. <description>
  1236. The DynamoDB table name to operate. Without this property, the respective
  1237. S3 bucket name will be used.
  1238. </description>
  1239. </property>
  1240. <property>
  1241. <name>fs.s3a.s3guard.ddb.table.create</name>
  1242. <value>false</value>
  1243. <description>
  1244. If true, the S3A client will create the table if it does not already exist.
  1245. </description>
  1246. </property>
  1247. <property>
  1248. <name>fs.s3a.s3guard.ddb.table.capacity.read</name>
  1249. <value>500</value>
  1250. <description>
  1251. Provisioned throughput requirements for read operations in terms of capacity
  1252. units for the DynamoDB table. This config value will only be used when
  1253. creating a new DynamoDB table, though later you can manually provision by
  1254. increasing or decreasing read capacity as needed for existing tables.
  1255. See DynamoDB documents for more information.
  1256. </description>
  1257. </property>
  1258. <property>
  1259. <name>fs.s3a.s3guard.ddb.table.capacity.write</name>
  1260. <value>100</value>
  1261. <description>
  1262. Provisioned throughput requirements for write operations in terms of
  1263. capacity units for the DynamoDB table. Refer to related config
  1264. fs.s3a.s3guard.ddb.table.capacity.read before usage.
  1265. </description>
  1266. </property>
  1267. <property>
  1268. <name>fs.s3a.s3guard.ddb.max.retries</name>
  1269. <value>9</value>
  1270. <description>
  1271. Max retries on throttled/incompleted DynamoDB operations
  1272. before giving up and throwing an IOException.
  1273. Each retry is delayed with an exponential
  1274. backoff timer which starts at 100 milliseconds and approximately
  1275. doubles each time. The minimum wait before throwing an exception is
  1276. sum(100, 200, 400, 800, .. 100*2^N-1 ) == 100 * ((2^N)-1)
  1277. </description>
  1278. </property>
  1279. <property>
  1280. <name>fs.s3a.s3guard.ddb.throttle.retry.interval</name>
  1281. <value>100ms</value>
  1282. <description>
  1283. Initial interval to retry after a request is throttled events;
  1284. the back-off policy is exponential until the number of retries of
  1285. fs.s3a.s3guard.ddb.max.retries is reached.
  1286. </description>
  1287. </property>
  1288. <property>
  1289. <name>fs.s3a.s3guard.ddb.background.sleep</name>
  1290. <value>25ms</value>
  1291. <description>
  1292. Length (in milliseconds) of pause between each batch of deletes when
  1293. pruning metadata. Prevents prune operations (which can typically be low
  1294. priority background operations) from overly interfering with other I/O
  1295. operations.
  1296. </description>
  1297. </property>
  1298. <property>
  1299. <name>fs.s3a.retry.limit</name>
  1300. <value>${fs.s3a.attempts.maximum}</value>
  1301. <description>
  1302. Number of times to retry any repeatable S3 client request on failure,
  1303. excluding throttling requests.
  1304. </description>
  1305. </property>
  1306. <property>
  1307. <name>fs.s3a.retry.interval</name>
  1308. <value>500ms</value>
  1309. <description>
  1310. Interval between attempts to retry operations for any reason other
  1311. than S3 throttle errors.
  1312. </description>
  1313. </property>
  1314. <property>
  1315. <name>fs.s3a.retry.throttle.limit</name>
  1316. <value>${fs.s3a.attempts.maximum}</value>
  1317. <description>
  1318. Number of times to retry any throttled request.
  1319. </description>
  1320. </property>
  1321. <property>
  1322. <name>fs.s3a.retry.throttle.interval</name>
  1323. <value>1000ms</value>
  1324. <description>
  1325. Interval between retry attempts on throttled requests.
  1326. </description>
  1327. </property>
  1328. <property>
  1329. <name>fs.s3a.committer.name</name>
  1330. <value>file</value>
  1331. <description>
  1332. Committer to create for output to S3A, one of:
  1333. "file", "directory", "partitioned", "magic".
  1334. </description>
  1335. </property>
  1336. <property>
  1337. <name>fs.s3a.committer.magic.enabled</name>
  1338. <value>false</value>
  1339. <description>
  1340. Enable support in the filesystem for the S3 "Magic" committer.
  1341. When working with AWS S3, S3Guard must be enabled for the destination
  1342. bucket, as consistent metadata listings are required.
  1343. </description>
  1344. </property>
  1345. <property>
  1346. <name>fs.s3a.committer.threads</name>
  1347. <value>8</value>
  1348. <description>
  1349. Number of threads in committers for parallel operations on files
  1350. (upload, commit, abort, delete...)
  1351. </description>
  1352. </property>
  1353. <property>
  1354. <name>fs.s3a.committer.staging.tmp.path</name>
  1355. <value>tmp/staging</value>
  1356. <description>
  1357. Path in the cluster filesystem for temporary data.
  1358. This is for HDFS, not the local filesystem.
  1359. It is only for the summary data of each file, not the actual
  1360. data being committed.
  1361. Using an unqualified path guarantees that the full path will be
  1362. generated relative to the home directory of the user creating the job,
  1363. hence private (assuming home directory permissions are secure).
  1364. </description>
  1365. </property>
  1366. <property>
  1367. <name>fs.s3a.committer.staging.unique-filenames</name>
  1368. <value>true</value>
  1369. <description>
  1370. Option for final files to have a unique name through job attempt info,
  1371. or the value of fs.s3a.committer.staging.uuid
  1372. When writing data with the "append" conflict option, this guarantees
  1373. that new data will not overwrite any existing data.
  1374. </description>
  1375. </property>
  1376. <property>
  1377. <name>fs.s3a.committer.staging.conflict-mode</name>
  1378. <value>fail</value>
  1379. <description>
  1380. Staging committer conflict resolution policy.
  1381. Supported: "fail", "append", "replace".
  1382. </description>
  1383. </property>
  1384. <property>
  1385. <name>fs.s3a.committer.staging.abort.pending.uploads</name>
  1386. <value>true</value>
  1387. <description>
  1388. Should the staging committers abort all pending uploads to the destination
  1389. directory?
  1390. Changing this if more than one partitioned committer is
  1391. writing to the same destination tree simultaneously; otherwise
  1392. the first job to complete will cancel all outstanding uploads from the
  1393. others. However, it may lead to leaked outstanding uploads from failed
  1394. tasks. If disabled, configure the bucket lifecycle to remove uploads
  1395. after a time period, and/or set up a workflow to explicitly delete
  1396. entries. Otherwise there is a risk that uncommitted uploads may run up
  1397. bills.
  1398. </description>
  1399. </property>
  1400. <property>
  1401. <name>fs.AbstractFileSystem.s3a.impl</name>
  1402. <value>org.apache.hadoop.fs.s3a.S3A</value>
  1403. <description>The implementation class of the S3A AbstractFileSystem.</description>
  1404. </property>
  1405. <property>
  1406. <name>fs.s3a.list.version</name>
  1407. <value>2</value>
  1408. <description>
  1409. Select which version of the S3 SDK's List Objects API to use. Currently
  1410. support 2 (default) and 1 (older API).
  1411. </description>
  1412. </property>
  1413. <property>
  1414. <name>fs.s3a.etag.checksum.enabled</name>
  1415. <value>false</value>
  1416. <description>
  1417. Should calls to getFileChecksum() return the etag value of the remote
  1418. object.
  1419. WARNING: if enabled, distcp operations between HDFS and S3 will fail unless
  1420. -skipcrccheck is set.
  1421. </description>
  1422. </property>
  1423. <!-- Azure file system properties -->
  1424. <property>
  1425. <name>fs.wasb.impl</name>
  1426. <value>org.apache.hadoop.fs.azure.NativeAzureFileSystem</value>
  1427. <description>The implementation class of the Native Azure Filesystem</description>
  1428. </property>
  1429. <property>
  1430. <name>fs.wasbs.impl</name>
  1431. <value>org.apache.hadoop.fs.azure.NativeAzureFileSystem$Secure</value>
  1432. <description>The implementation class of the Secure Native Azure Filesystem</description>
  1433. </property>
  1434. <property>
  1435. <name>fs.azure.secure.mode</name>
  1436. <value>false</value>
  1437. <description>
  1438. Config flag to identify the mode in which fs.azure.NativeAzureFileSystem needs
  1439. to run under. Setting it "true" would make fs.azure.NativeAzureFileSystem use
  1440. SAS keys to communicate with Azure storage.
  1441. </description>
  1442. </property>
  1443. <property>
  1444. <name>fs.abfs.impl</name>
  1445. <value>org.apache.hadoop.fs.azurebfs.AzureBlobFileSystem</value>
  1446. <description>The implementation class of the Azure Blob Filesystem</description>
  1447. </property>
  1448. <property>
  1449. <name>fs.abfss.impl</name>
  1450. <value>org.apache.hadoop.fs.azurebfs.SecureAzureBlobFileSystem</value>
  1451. <description>The implementation class of the Secure Azure Blob Filesystem</description>
  1452. </property>
  1453. <property>
  1454. <name>fs.azure.local.sas.key.mode</name>
  1455. <value>false</value>
  1456. <description>
  1457. Works in conjuction with fs.azure.secure.mode. Setting this config to true
  1458. results in fs.azure.NativeAzureFileSystem using the local SAS key generation
  1459. where the SAS keys are generating in the same process as fs.azure.NativeAzureFileSystem.
  1460. If fs.azure.secure.mode flag is set to false, this flag has no effect.
  1461. </description>
  1462. </property>
  1463. <property>
  1464. <name>fs.azure.sas.expiry.period</name>
  1465. <value>90d</value>
  1466. <description>
  1467. The default value to be used for expiration period for SAS keys generated.
  1468. Can use the following suffix (case insensitive):
  1469. ms(millis), s(sec), m(min), h(hour), d(day)
  1470. to specify the time (such as 2s, 2m, 1h, etc.).
  1471. </description>
  1472. </property>
  1473. <property>
  1474. <name>fs.azure.authorization</name>
  1475. <value>false</value>
  1476. <description>
  1477. Config flag to enable authorization support in WASB. Setting it to "true" enables
  1478. authorization support to WASB. Currently WASB authorization requires a remote service
  1479. to provide authorization that needs to be specified via fs.azure.authorization.remote.service.url
  1480. configuration
  1481. </description>
  1482. </property>
  1483. <property>
  1484. <name>fs.azure.authorization.caching.enable</name>
  1485. <value>true</value>
  1486. <description>
  1487. Config flag to enable caching of authorization results and saskeys in WASB.
  1488. This flag is relevant only when fs.azure.authorization is enabled.
  1489. </description>
  1490. </property>
  1491. <property>
  1492. <name>fs.azure.saskey.usecontainersaskeyforallaccess</name>
  1493. <value>true</value>
  1494. <description>
  1495. Use container saskey for access to all blobs within the container.
  1496. Blob-specific saskeys are not used when this setting is enabled.
  1497. This setting provides better performance compared to blob-specific saskeys.
  1498. </description>
  1499. </property>
  1500. <property>
  1501. <name>io.seqfile.compress.blocksize</name>
  1502. <value>1000000</value>
  1503. <description>The minimum block size for compression in block compressed
  1504. SequenceFiles.
  1505. </description>
  1506. </property>
  1507. <property>
  1508. <name>io.mapfile.bloom.size</name>
  1509. <value>1048576</value>
  1510. <description>The size of BloomFilter-s used in BloomMapFile. Each time this many
  1511. keys is appended the next BloomFilter will be created (inside a DynamicBloomFilter).
  1512. Larger values minimize the number of filters, which slightly increases the performance,
  1513. but may waste too much space if the total number of keys is usually much smaller
  1514. than this number.
  1515. </description>
  1516. </property>
  1517. <property>
  1518. <name>io.mapfile.bloom.error.rate</name>
  1519. <value>0.005</value>
  1520. <description>The rate of false positives in BloomFilter-s used in BloomMapFile.
  1521. As this value decreases, the size of BloomFilter-s increases exponentially. This
  1522. value is the probability of encountering false positives (default is 0.5%).
  1523. </description>
  1524. </property>
  1525. <property>
  1526. <name>hadoop.util.hash.type</name>
  1527. <value>murmur</value>
  1528. <description>The default implementation of Hash. Currently this can take one of the
  1529. two values: 'murmur' to select MurmurHash and 'jenkins' to select JenkinsHash.
  1530. </description>
  1531. </property>
  1532. <!-- Ozone file system properties -->
  1533. <property>
  1534. <name>fs.o3.impl</name>
  1535. <value>org.apache.hadoop.fs.ozone.OzoneFileSystem</value>
  1536. <description>The implementation class of the Ozone FileSystem.</description>
  1537. </property>
  1538. <property>
  1539. <name>fs.AbstractFileSystem.o3.impl</name>
  1540. <value>org.apache.hadoop.fs.ozone.OzFs</value>
  1541. <description>The implementation class of the OzFs AbstractFileSystem.</description>
  1542. </property>
  1543. <!-- ipc properties -->
  1544. <property>
  1545. <name>ipc.client.idlethreshold</name>
  1546. <value>4000</value>
  1547. <description>Defines the threshold number of connections after which
  1548. connections will be inspected for idleness.
  1549. </description>
  1550. </property>
  1551. <property>
  1552. <name>ipc.client.kill.max</name>
  1553. <value>10</value>
  1554. <description>Defines the maximum number of clients to disconnect in one go.
  1555. </description>
  1556. </property>
  1557. <property>
  1558. <name>ipc.client.connection.maxidletime</name>
  1559. <value>10000</value>
  1560. <description>The maximum time in msec after which a client will bring down the
  1561. connection to the server.
  1562. </description>
  1563. </property>
  1564. <property>
  1565. <name>ipc.client.connect.max.retries</name>
  1566. <value>10</value>
  1567. <description>Indicates the number of retries a client will make to establish
  1568. a server connection.
  1569. </description>
  1570. </property>
  1571. <property>
  1572. <name>ipc.client.connect.retry.interval</name>
  1573. <value>1000</value>
  1574. <description>Indicates the number of milliseconds a client will wait for
  1575. before retrying to establish a server connection.
  1576. </description>
  1577. </property>
  1578. <property>
  1579. <name>ipc.client.connect.timeout</name>
  1580. <value>20000</value>
  1581. <description>Indicates the number of milliseconds a client will wait for the
  1582. socket to establish a server connection.
  1583. </description>
  1584. </property>
  1585. <property>
  1586. <name>ipc.client.connect.max.retries.on.timeouts</name>
  1587. <value>45</value>
  1588. <description>Indicates the number of retries a client will make on socket timeout
  1589. to establish a server connection.
  1590. </description>
  1591. </property>
  1592. <property>
  1593. <name>ipc.client.tcpnodelay</name>
  1594. <value>true</value>
  1595. <description>Use TCP_NODELAY flag to bypass Nagle's algorithm transmission delays.
  1596. </description>
  1597. </property>
  1598. <property>
  1599. <name>ipc.client.low-latency</name>
  1600. <value>false</value>
  1601. <description>Use low-latency QoS markers for IPC connections.
  1602. </description>
  1603. </property>
  1604. <property>
  1605. <name>ipc.client.ping</name>
  1606. <value>true</value>
  1607. <description>Send a ping to the server when timeout on reading the response,
  1608. if set to true. If no failure is detected, the client retries until at least
  1609. a byte is read or the time given by ipc.client.rpc-timeout.ms is passed.
  1610. </description>
  1611. </property>
  1612. <property>
  1613. <name>ipc.ping.interval</name>
  1614. <value>60000</value>
  1615. <description>Timeout on waiting response from server, in milliseconds.
  1616. The client will send ping when the interval is passed without receiving bytes,
  1617. if ipc.client.ping is set to true.
  1618. </description>
  1619. </property>
  1620. <property>
  1621. <name>ipc.client.rpc-timeout.ms</name>
  1622. <value>0</value>
  1623. <description>Timeout on waiting response from server, in milliseconds.
  1624. If ipc.client.ping is set to true and this rpc-timeout is greater than
  1625. the value of ipc.ping.interval, the effective value of the rpc-timeout is
  1626. rounded up to multiple of ipc.ping.interval.
  1627. </description>
  1628. </property>
  1629. <property>
  1630. <name>ipc.server.listen.queue.size</name>
  1631. <value>128</value>
  1632. <description>Indicates the length of the listen queue for servers accepting
  1633. client connections.
  1634. </description>
  1635. </property>
  1636. <property>
  1637. <name>ipc.server.log.slow.rpc</name>
  1638. <value>false</value>
  1639. <description>This setting is useful to troubleshoot performance issues for
  1640. various services. If this value is set to true then we log requests that
  1641. fall into 99th percentile as well as increment RpcSlowCalls counter.
  1642. </description>
  1643. </property>
  1644. <property>
  1645. <name>ipc.maximum.data.length</name>
  1646. <value>67108864</value>
  1647. <description>This indicates the maximum IPC message length (bytes) that can be
  1648. accepted by the server. Messages larger than this value are rejected by the
  1649. immediately to avoid possible OOMs. This setting should rarely need to be
  1650. changed.
  1651. </description>
  1652. </property>
  1653. <property>
  1654. <name>ipc.maximum.response.length</name>
  1655. <value>134217728</value>
  1656. <description>This indicates the maximum IPC message length (bytes) that can be
  1657. accepted by the client. Messages larger than this value are rejected
  1658. immediately to avoid possible OOMs. This setting should rarely need to be
  1659. changed. Set to 0 to disable.
  1660. </description>
  1661. </property>
  1662. <!-- Proxy Configuration -->
  1663. <property>
  1664. <name>hadoop.security.impersonation.provider.class</name>
  1665. <value></value>
  1666. <description>A class which implements ImpersonationProvider interface, used to
  1667. authorize whether one user can impersonate a specific user.
  1668. If not specified, the DefaultImpersonationProvider will be used.
  1669. If a class is specified, then that class will be used to determine
  1670. the impersonation capability.
  1671. </description>
  1672. </property>
  1673. <property>
  1674. <name>hadoop.rpc.socket.factory.class.default</name>
  1675. <value>org.apache.hadoop.net.StandardSocketFactory</value>
  1676. <description> Default SocketFactory to use. This parameter is expected to be
  1677. formatted as "package.FactoryClassName".
  1678. </description>
  1679. </property>
  1680. <property>
  1681. <name>hadoop.rpc.socket.factory.class.ClientProtocol</name>
  1682. <value></value>
  1683. <description> SocketFactory to use to connect to a DFS. If null or empty, use
  1684. hadoop.rpc.socket.class.default. This socket factory is also used by
  1685. DFSClient to create sockets to DataNodes.
  1686. </description>
  1687. </property>
  1688. <property>
  1689. <name>hadoop.socks.server</name>
  1690. <value></value>
  1691. <description> Address (host:port) of the SOCKS server to be used by the
  1692. SocksSocketFactory.
  1693. </description>
  1694. </property>
  1695. <!-- Topology Configuration -->
  1696. <property>
  1697. <name>net.topology.node.switch.mapping.impl</name>
  1698. <value>org.apache.hadoop.net.ScriptBasedMapping</value>
  1699. <description> The default implementation of the DNSToSwitchMapping. It
  1700. invokes a script specified in net.topology.script.file.name to resolve
  1701. node names. If the value for net.topology.script.file.name is not set, the
  1702. default value of DEFAULT_RACK is returned for all node names.
  1703. </description>
  1704. </property>
  1705. <property>
  1706. <name>net.topology.impl</name>
  1707. <value>org.apache.hadoop.net.NetworkTopology</value>
  1708. <description> The default implementation of NetworkTopology which is classic three layer one.
  1709. </description>
  1710. </property>
  1711. <property>
  1712. <name>net.topology.script.file.name</name>
  1713. <value></value>
  1714. <description> The script name that should be invoked to resolve DNS names to
  1715. NetworkTopology names. Example: the script would take host.foo.bar as an
  1716. argument, and return /rack1 as the output.
  1717. </description>
  1718. </property>
  1719. <property>
  1720. <name>net.topology.script.number.args</name>
  1721. <value>100</value>
  1722. <description> The max number of args that the script configured with
  1723. net.topology.script.file.name should be run with. Each arg is an
  1724. IP address.
  1725. </description>
  1726. </property>
  1727. <property>
  1728. <name>net.topology.table.file.name</name>
  1729. <value></value>
  1730. <description> The file name for a topology file, which is used when the
  1731. net.topology.node.switch.mapping.impl property is set to
  1732. org.apache.hadoop.net.TableMapping. The file format is a two column text
  1733. file, with columns separated by whitespace. The first column is a DNS or
  1734. IP address and the second column specifies the rack where the address maps.
  1735. If no entry corresponding to a host in the cluster is found, then
  1736. /default-rack is assumed.
  1737. </description>
  1738. </property>
  1739. <!-- Local file system -->
  1740. <property>
  1741. <name>file.stream-buffer-size</name>
  1742. <value>4096</value>
  1743. <description>The size of buffer to stream files.
  1744. The size of this buffer should probably be a multiple of hardware
  1745. page size (4096 on Intel x86), and it determines how much data is
  1746. buffered during read and write operations.</description>
  1747. </property>
  1748. <property>
  1749. <name>file.bytes-per-checksum</name>
  1750. <value>512</value>
  1751. <description>The number of bytes per checksum. Must not be larger than
  1752. file.stream-buffer-size</description>
  1753. </property>
  1754. <property>
  1755. <name>file.client-write-packet-size</name>
  1756. <value>65536</value>
  1757. <description>Packet size for clients to write</description>
  1758. </property>
  1759. <property>
  1760. <name>file.blocksize</name>
  1761. <value>67108864</value>
  1762. <description>Block size</description>
  1763. </property>
  1764. <property>
  1765. <name>file.replication</name>
  1766. <value>1</value>
  1767. <description>Replication factor</description>
  1768. </property>
  1769. <!-- FTP file system -->
  1770. <property>
  1771. <name>ftp.stream-buffer-size</name>
  1772. <value>4096</value>
  1773. <description>The size of buffer to stream files.
  1774. The size of this buffer should probably be a multiple of hardware
  1775. page size (4096 on Intel x86), and it determines how much data is
  1776. buffered during read and write operations.</description>
  1777. </property>
  1778. <property>
  1779. <name>ftp.bytes-per-checksum</name>
  1780. <value>512</value>
  1781. <description>The number of bytes per checksum. Must not be larger than
  1782. ftp.stream-buffer-size</description>
  1783. </property>
  1784. <property>
  1785. <name>ftp.client-write-packet-size</name>
  1786. <value>65536</value>
  1787. <description>Packet size for clients to write</description>
  1788. </property>
  1789. <property>
  1790. <name>ftp.blocksize</name>
  1791. <value>67108864</value>
  1792. <description>Block size</description>
  1793. </property>
  1794. <property>
  1795. <name>ftp.replication</name>
  1796. <value>3</value>
  1797. <description>Replication factor</description>
  1798. </property>
  1799. <!-- Tfile -->
  1800. <property>
  1801. <name>tfile.io.chunk.size</name>
  1802. <value>1048576</value>
  1803. <description>
  1804. Value chunk size in bytes. Default to
  1805. 1MB. Values of the length less than the chunk size is
  1806. guaranteed to have known value length in read time (See also
  1807. TFile.Reader.Scanner.Entry.isValueLengthKnown()).
  1808. </description>
  1809. </property>
  1810. <property>
  1811. <name>tfile.fs.output.buffer.size</name>
  1812. <value>262144</value>
  1813. <description>
  1814. Buffer size used for FSDataOutputStream in bytes.
  1815. </description>
  1816. </property>
  1817. <property>
  1818. <name>tfile.fs.input.buffer.size</name>
  1819. <value>262144</value>
  1820. <description>
  1821. Buffer size used for FSDataInputStream in bytes.
  1822. </description>
  1823. </property>
  1824. <!-- HTTP web-consoles Authentication -->
  1825. <property>
  1826. <name>hadoop.http.authentication.type</name>
  1827. <value>simple</value>
  1828. <description>
  1829. Defines authentication used for Oozie HTTP endpoint.
  1830. Supported values are: simple | kerberos | #AUTHENTICATION_HANDLER_CLASSNAME#
  1831. </description>
  1832. </property>
  1833. <property>
  1834. <name>hadoop.http.authentication.token.validity</name>
  1835. <value>36000</value>
  1836. <description>
  1837. Indicates how long (in seconds) an authentication token is valid before it has
  1838. to be renewed.
  1839. </description>
  1840. </property>
  1841. <property>
  1842. <name>hadoop.http.authentication.signature.secret.file</name>
  1843. <value>${user.home}/hadoop-http-auth-signature-secret</value>
  1844. <description>
  1845. The signature secret for signing the authentication tokens.
  1846. The same secret should be used for JT/NN/DN/TT configurations.
  1847. </description>
  1848. </property>
  1849. <property>
  1850. <name>hadoop.http.authentication.cookie.domain</name>
  1851. <value></value>
  1852. <description>
  1853. The domain to use for the HTTP cookie that stores the authentication token.
  1854. In order to authentiation to work correctly across all Hadoop nodes web-consoles
  1855. the domain must be correctly set.
  1856. IMPORTANT: when using IP addresses, browsers ignore cookies with domain settings.
  1857. For this setting to work properly all nodes in the cluster must be configured
  1858. to generate URLs with hostname.domain names on it.
  1859. </description>
  1860. </property>
  1861. <property>
  1862. <name>hadoop.http.authentication.simple.anonymous.allowed</name>
  1863. <value>true</value>
  1864. <description>
  1865. Indicates if anonymous requests are allowed when using 'simple' authentication.
  1866. </description>
  1867. </property>
  1868. <property>
  1869. <name>hadoop.http.authentication.kerberos.principal</name>
  1870. <value>HTTP/_HOST@LOCALHOST</value>
  1871. <description>
  1872. Indicates the Kerberos principal to be used for HTTP endpoint.
  1873. The principal MUST start with 'HTTP/' as per Kerberos HTTP SPNEGO specification.
  1874. </description>
  1875. </property>
  1876. <property>
  1877. <name>hadoop.http.authentication.kerberos.keytab</name>
  1878. <value>${user.home}/hadoop.keytab</value>
  1879. <description>
  1880. Location of the keytab file with the credentials for the principal.
  1881. Referring to the same keytab file Oozie uses for its Kerberos credentials for Hadoop.
  1882. </description>
  1883. </property>
  1884. <!-- HTTP CORS support -->
  1885. <property>
  1886. <name>hadoop.http.cross-origin.enabled</name>
  1887. <value>false</value>
  1888. <description>Enable/disable the cross-origin (CORS) filter.</description>
  1889. </property>
  1890. <property>
  1891. <name>hadoop.http.cross-origin.allowed-origins</name>
  1892. <value>*</value>
  1893. <description>Comma separated list of origins that are allowed for web services
  1894. needing cross-origin (CORS) support. If a value in the list contains an
  1895. asterix (*), a regex pattern, escaping any dots ('.' -> '\.') and replacing
  1896. the asterix such that it captures any characters ('*' -> '.*'), is generated.
  1897. Values prefixed with 'regex:' are interpreted directly as regular expressions,
  1898. e.g. use the expression 'regex:https?:\/\/foo\.bar:([0-9]+)?' to allow any
  1899. origin using the 'http' or 'https' protocol in the domain 'foo.bar' on any
  1900. port. The use of simple wildcards ('*') is discouraged, and only available for
  1901. backward compatibility.</description>
  1902. </property>
  1903. <property>
  1904. <name>hadoop.http.cross-origin.allowed-methods</name>
  1905. <value>GET,POST,HEAD</value>
  1906. <description>Comma separated list of methods that are allowed for web
  1907. services needing cross-origin (CORS) support.</description>
  1908. </property>
  1909. <property>
  1910. <name>hadoop.http.cross-origin.allowed-headers</name>
  1911. <value>X-Requested-With,Content-Type,Accept,Origin</value>
  1912. <description>Comma separated list of headers that are allowed for web
  1913. services needing cross-origin (CORS) support.</description>
  1914. </property>
  1915. <property>
  1916. <name>hadoop.http.cross-origin.max-age</name>
  1917. <value>1800</value>
  1918. <description>The number of seconds a pre-flighted request can be cached
  1919. for web services needing cross-origin (CORS) support.</description>
  1920. </property>
  1921. <property>
  1922. <name>dfs.ha.fencing.methods</name>
  1923. <value></value>
  1924. <description>
  1925. List of fencing methods to use for service fencing. May contain
  1926. builtin methods (eg shell and sshfence) or user-defined method.
  1927. </description>
  1928. </property>
  1929. <property>
  1930. <name>dfs.ha.fencing.ssh.connect-timeout</name>
  1931. <value>30000</value>
  1932. <description>
  1933. SSH connection timeout, in milliseconds, to use with the builtin
  1934. sshfence fencer.
  1935. </description>
  1936. </property>
  1937. <property>
  1938. <name>dfs.ha.fencing.ssh.private-key-files</name>
  1939. <value></value>
  1940. <description>
  1941. The SSH private key files to use with the builtin sshfence fencer.
  1942. </description>
  1943. </property>
  1944. <property>
  1945. <name>ha.zookeeper.quorum</name>
  1946. <description>
  1947. A list of ZooKeeper server addresses, separated by commas, that are
  1948. to be used by the ZKFailoverController in automatic failover.
  1949. </description>
  1950. </property>
  1951. <property>
  1952. <name>ha.zookeeper.session-timeout.ms</name>
  1953. <value>10000</value>
  1954. <description>
  1955. The session timeout to use when the ZKFC connects to ZooKeeper.
  1956. Setting this value to a lower value implies that server crashes
  1957. will be detected more quickly, but risks triggering failover too
  1958. aggressively in the case of a transient error or network blip.
  1959. </description>
  1960. </property>
  1961. <property>
  1962. <name>ha.zookeeper.parent-znode</name>
  1963. <value>/hadoop-ha</value>
  1964. <description>
  1965. The ZooKeeper znode under which the ZK failover controller stores
  1966. its information. Note that the nameservice ID is automatically
  1967. appended to this znode, so it is not normally necessary to
  1968. configure this, even in a federated environment.
  1969. </description>
  1970. </property>
  1971. <property>
  1972. <name>ha.zookeeper.acl</name>
  1973. <value>world:anyone:rwcda</value>
  1974. <description>
  1975. A comma-separated list of ZooKeeper ACLs to apply to the znodes
  1976. used by automatic failover. These ACLs are specified in the same
  1977. format as used by the ZooKeeper CLI.
  1978. If the ACL itself contains secrets, you may instead specify a
  1979. path to a file, prefixed with the '@' symbol, and the value of
  1980. this configuration will be loaded from within.
  1981. </description>
  1982. </property>
  1983. <property>
  1984. <name>ha.zookeeper.auth</name>
  1985. <value></value>
  1986. <description>
  1987. A comma-separated list of ZooKeeper authentications to add when
  1988. connecting to ZooKeeper. These are specified in the same format
  1989. as used by the &quot;addauth&quot; command in the ZK CLI. It is
  1990. important that the authentications specified here are sufficient
  1991. to access znodes with the ACL specified in ha.zookeeper.acl.
  1992. If the auths contain secrets, you may instead specify a
  1993. path to a file, prefixed with the '@' symbol, and the value of
  1994. this configuration will be loaded from within.
  1995. </description>
  1996. </property>
  1997. <!-- Static Web User Filter properties. -->
  1998. <property>
  1999. <name>hadoop.http.staticuser.user</name>
  2000. <value>dr.who</value>
  2001. <description>
  2002. The user name to filter as, on static web filters
  2003. while rendering content. An example use is the HDFS
  2004. web UI (user to be used for browsing files).
  2005. </description>
  2006. </property>
  2007. <!-- SSLFactory configuration -->
  2008. <property>
  2009. <name>hadoop.ssl.keystores.factory.class</name>
  2010. <value>org.apache.hadoop.security.ssl.FileBasedKeyStoresFactory</value>
  2011. <description>
  2012. The keystores factory to use for retrieving certificates.
  2013. </description>
  2014. </property>
  2015. <property>
  2016. <name>hadoop.ssl.require.client.cert</name>
  2017. <value>false</value>
  2018. <description>Whether client certificates are required</description>
  2019. </property>
  2020. <property>
  2021. <name>hadoop.ssl.hostname.verifier</name>
  2022. <value>DEFAULT</value>
  2023. <description>
  2024. The hostname verifier to provide for HttpsURLConnections.
  2025. Valid values are: DEFAULT, STRICT, STRICT_IE6, DEFAULT_AND_LOCALHOST and
  2026. ALLOW_ALL
  2027. </description>
  2028. </property>
  2029. <property>
  2030. <name>hadoop.ssl.server.conf</name>
  2031. <value>ssl-server.xml</value>
  2032. <description>
  2033. Resource file from which ssl server keystore information will be extracted.
  2034. This file is looked up in the classpath, typically it should be in Hadoop
  2035. conf/ directory.
  2036. </description>
  2037. </property>
  2038. <property>
  2039. <name>hadoop.ssl.client.conf</name>
  2040. <value>ssl-client.xml</value>
  2041. <description>
  2042. Resource file from which ssl client keystore information will be extracted
  2043. This file is looked up in the classpath, typically it should be in Hadoop
  2044. conf/ directory.
  2045. </description>
  2046. </property>
  2047. <property>
  2048. <name>hadoop.ssl.enabled</name>
  2049. <value>false</value>
  2050. <description>
  2051. Deprecated. Use dfs.http.policy and yarn.http.policy instead.
  2052. </description>
  2053. </property>
  2054. <property>
  2055. <name>hadoop.ssl.enabled.protocols</name>
  2056. <value>TLSv1,SSLv2Hello,TLSv1.1,TLSv1.2</value>
  2057. <description>
  2058. The supported SSL protocols.
  2059. </description>
  2060. </property>
  2061. <property>
  2062. <name>hadoop.jetty.logs.serve.aliases</name>
  2063. <value>true</value>
  2064. <description>
  2065. Enable/Disable aliases serving from jetty
  2066. </description>
  2067. </property>
  2068. <property>
  2069. <name>fs.permissions.umask-mode</name>
  2070. <value>022</value>
  2071. <description>
  2072. The umask used when creating files and directories.
  2073. Can be in octal or in symbolic. Examples are:
  2074. "022" (octal for u=rwx,g=r-x,o=r-x in symbolic),
  2075. or "u=rwx,g=rwx,o=" (symbolic for 007 in octal).
  2076. </description>
  2077. </property>
  2078. <!-- ha properties -->
  2079. <property>
  2080. <name>ha.health-monitor.connect-retry-interval.ms</name>
  2081. <value>1000</value>
  2082. <description>
  2083. How often to retry connecting to the service.
  2084. </description>
  2085. </property>
  2086. <property>
  2087. <name>ha.health-monitor.check-interval.ms</name>
  2088. <value>1000</value>
  2089. <description>
  2090. How often to check the service.
  2091. </description>
  2092. </property>
  2093. <property>
  2094. <name>ha.health-monitor.sleep-after-disconnect.ms</name>
  2095. <value>1000</value>
  2096. <description>
  2097. How long to sleep after an unexpected RPC error.
  2098. </description>
  2099. </property>
  2100. <property>
  2101. <name>ha.health-monitor.rpc-timeout.ms</name>
  2102. <value>45000</value>
  2103. <description>
  2104. Timeout for the actual monitorHealth() calls.
  2105. </description>
  2106. </property>
  2107. <property>
  2108. <name>ha.failover-controller.new-active.rpc-timeout.ms</name>
  2109. <value>60000</value>
  2110. <description>
  2111. Timeout that the FC waits for the new active to become active
  2112. </description>
  2113. </property>
  2114. <property>
  2115. <name>ha.failover-controller.graceful-fence.rpc-timeout.ms</name>
  2116. <value>5000</value>
  2117. <description>
  2118. Timeout that the FC waits for the old active to go to standby
  2119. </description>
  2120. </property>
  2121. <property>
  2122. <name>ha.failover-controller.graceful-fence.connection.retries</name>
  2123. <value>1</value>
  2124. <description>
  2125. FC connection retries for graceful fencing
  2126. </description>
  2127. </property>
  2128. <property>
  2129. <name>ha.failover-controller.cli-check.rpc-timeout.ms</name>
  2130. <value>20000</value>
  2131. <description>
  2132. Timeout that the CLI (manual) FC waits for monitorHealth, getServiceState
  2133. </description>
  2134. </property>
  2135. <property>
  2136. <name>ipc.client.fallback-to-simple-auth-allowed</name>
  2137. <value>false</value>
  2138. <description>
  2139. When a client is configured to attempt a secure connection, but attempts to
  2140. connect to an insecure server, that server may instruct the client to
  2141. switch to SASL SIMPLE (unsecure) authentication. This setting controls
  2142. whether or not the client will accept this instruction from the server.
  2143. When false (the default), the client will not allow the fallback to SIMPLE
  2144. authentication, and will abort the connection.
  2145. </description>
  2146. </property>
  2147. <property>
  2148. <name>fs.client.resolve.remote.symlinks</name>
  2149. <value>true</value>
  2150. <description>
  2151. Whether to resolve symlinks when accessing a remote Hadoop filesystem.
  2152. Setting this to false causes an exception to be thrown upon encountering
  2153. a symlink. This setting does not apply to local filesystems, which
  2154. automatically resolve local symlinks.
  2155. </description>
  2156. </property>
  2157. <property>
  2158. <name>nfs.exports.allowed.hosts</name>
  2159. <value>* rw</value>
  2160. <description>
  2161. By default, the export can be mounted by any client. The value string
  2162. contains machine name and access privilege, separated by whitespace
  2163. characters. The machine name format can be a single host, a Java regular
  2164. expression, or an IPv4 address. The access privilege uses rw or ro to
  2165. specify read/write or read-only access of the machines to exports. If the
  2166. access privilege is not provided, the default is read-only. Entries are separated by ";".
  2167. For example: "192.168.0.0/22 rw ; host.*\.example\.com ; host1.test.org ro;".
  2168. Only the NFS gateway needs to restart after this property is updated.
  2169. </description>
  2170. </property>
  2171. <property>
  2172. <name>hadoop.user.group.static.mapping.overrides</name>
  2173. <value>dr.who=;</value>
  2174. <description>
  2175. Static mapping of user to groups. This will override the groups if
  2176. available in the system for the specified user. In other words, groups
  2177. look-up will not happen for these users, instead groups mapped in this
  2178. configuration will be used.
  2179. Mapping should be in this format.
  2180. user1=group1,group2;user2=;user3=group2;
  2181. Default, "dr.who=;" will consider "dr.who" as user without groups.
  2182. </description>
  2183. </property>
  2184. <property>
  2185. <name>rpc.metrics.quantile.enable</name>
  2186. <value>false</value>
  2187. <description>
  2188. Setting this property to true and rpc.metrics.percentiles.intervals
  2189. to a comma-separated list of the granularity in seconds, the
  2190. 50/75/90/95/99th percentile latency for rpc queue/processing time in
  2191. milliseconds are added to rpc metrics.
  2192. </description>
  2193. </property>
  2194. <property>
  2195. <name>rpc.metrics.percentiles.intervals</name>
  2196. <value></value>
  2197. <description>
  2198. A comma-separated list of the granularity in seconds for the metrics which
  2199. describe the 50/75/90/95/99th percentile latency for rpc queue/processing
  2200. time. The metrics are outputted if rpc.metrics.quantile.enable is set to
  2201. true.
  2202. </description>
  2203. </property>
  2204. <property>
  2205. <name>hadoop.security.crypto.codec.classes.EXAMPLECIPHERSUITE</name>
  2206. <value></value>
  2207. <description>
  2208. The prefix for a given crypto codec, contains a comma-separated
  2209. list of implementation classes for a given crypto codec (eg EXAMPLECIPHERSUITE).
  2210. The first implementation will be used if available, others are fallbacks.
  2211. </description>
  2212. </property>
  2213. <property>
  2214. <name>hadoop.security.crypto.codec.classes.aes.ctr.nopadding</name>
  2215. <value>org.apache.hadoop.crypto.OpensslAesCtrCryptoCodec, org.apache.hadoop.crypto.JceAesCtrCryptoCodec</value>
  2216. <description>
  2217. Comma-separated list of crypto codec implementations for AES/CTR/NoPadding.
  2218. The first implementation will be used if available, others are fallbacks.
  2219. </description>
  2220. </property>
  2221. <property>
  2222. <name>hadoop.security.crypto.cipher.suite</name>
  2223. <value>AES/CTR/NoPadding</value>
  2224. <description>
  2225. Cipher suite for crypto codec.
  2226. </description>
  2227. </property>
  2228. <property>
  2229. <name>hadoop.security.crypto.jce.provider</name>
  2230. <value></value>
  2231. <description>
  2232. The JCE provider name used in CryptoCodec.
  2233. </description>
  2234. </property>
  2235. <property>
  2236. <name>hadoop.security.crypto.jceks.key.serialfilter</name>
  2237. <description>
  2238. Enhanced KeyStore Mechanisms in JDK 8u171 introduced jceks.key.serialFilter.
  2239. If jceks.key.serialFilter is configured, the JCEKS KeyStore uses it during
  2240. the deserialization of the encrypted Key object stored inside a
  2241. SecretKeyEntry.
  2242. If jceks.key.serialFilter is not configured it will cause an error when
  2243. recovering keystore file in KeyProviderFactory when recovering key from
  2244. keystore file using JDK 8u171 or newer. The filter pattern uses the same
  2245. format as jdk.serialFilter.
  2246. The value of this property will be used as the following:
  2247. 1. The value of jceks.key.serialFilter system property takes precedence
  2248. over the value of this property.
  2249. 2. In the absence of jceks.key.serialFilter system property the value of
  2250. this property will be set as the value of jceks.key.serialFilter.
  2251. 3. If the value of this property and jceks.key.serialFilter system
  2252. property has not been set, org.apache.hadoop.crypto.key.KeyProvider
  2253. sets a default value for jceks.key.serialFilter.
  2254. </description>
  2255. </property>
  2256. <property>
  2257. <name>hadoop.security.crypto.buffer.size</name>
  2258. <value>8192</value>
  2259. <description>
  2260. The buffer size used by CryptoInputStream and CryptoOutputStream.
  2261. </description>
  2262. </property>
  2263. <property>
  2264. <name>hadoop.security.java.secure.random.algorithm</name>
  2265. <value>SHA1PRNG</value>
  2266. <description>
  2267. The java secure random algorithm.
  2268. </description>
  2269. </property>
  2270. <property>
  2271. <name>hadoop.security.secure.random.impl</name>
  2272. <value></value>
  2273. <description>
  2274. Implementation of secure random.
  2275. </description>
  2276. </property>
  2277. <property>
  2278. <name>hadoop.security.random.device.file.path</name>
  2279. <value>/dev/urandom</value>
  2280. <description>
  2281. OS security random device file path.
  2282. </description>
  2283. </property>
  2284. <property>
  2285. <name>hadoop.security.key.provider.path</name>
  2286. <description>
  2287. The KeyProvider to use when managing zone keys, and interacting with
  2288. encryption keys when reading and writing to an encryption zone.
  2289. For hdfs clients, the provider path will be same as namenode's
  2290. provider path.
  2291. </description>
  2292. </property>
  2293. <property>
  2294. <name>hadoop.security.key.default.bitlength</name>
  2295. <value>128</value>
  2296. <description>
  2297. The length (bits) of keys we want the KeyProvider to produce. Key length
  2298. defines the upper-bound on an algorithm's security, ideally, it would
  2299. coincide with the lower-bound on an algorithm's security.
  2300. </description>
  2301. </property>
  2302. <property>
  2303. <name>hadoop.security.key.default.cipher</name>
  2304. <value>AES/CTR/NoPadding</value>
  2305. <description>
  2306. This indicates the algorithm that be used by KeyProvider for generating
  2307. key, and will be converted to CipherSuite when creating encryption zone.
  2308. </description>
  2309. </property>
  2310. <property>
  2311. <name>fs.har.impl.disable.cache</name>
  2312. <value>true</value>
  2313. <description>Don't cache 'har' filesystem instances.</description>
  2314. </property>
  2315. <!--- KMSClientProvider configurations -->
  2316. <property>
  2317. <name>hadoop.security.kms.client.authentication.retry-count</name>
  2318. <value>1</value>
  2319. <description>
  2320. Number of time to retry connecting to KMS on authentication failure
  2321. </description>
  2322. </property>
  2323. <property>
  2324. <name>hadoop.security.kms.client.encrypted.key.cache.size</name>
  2325. <value>500</value>
  2326. <description>
  2327. Size of the EncryptedKeyVersion cache Queue for each key
  2328. </description>
  2329. </property>
  2330. <property>
  2331. <name>hadoop.security.kms.client.encrypted.key.cache.low-watermark</name>
  2332. <value>0.3f</value>
  2333. <description>
  2334. If size of the EncryptedKeyVersion cache Queue falls below the
  2335. low watermark, this cache queue will be scheduled for a refill
  2336. </description>
  2337. </property>
  2338. <property>
  2339. <name>hadoop.security.kms.client.encrypted.key.cache.num.refill.threads</name>
  2340. <value>2</value>
  2341. <description>
  2342. Number of threads to use for refilling depleted EncryptedKeyVersion
  2343. cache Queues
  2344. </description>
  2345. </property>
  2346. <property>
  2347. <name>hadoop.security.kms.client.encrypted.key.cache.expiry</name>
  2348. <value>43200000</value>
  2349. <description>
  2350. Cache expiry time for a Key, after which the cache Queue for this
  2351. key will be dropped. Default = 12hrs
  2352. </description>
  2353. </property>
  2354. <property>
  2355. <name>hadoop.security.kms.client.timeout</name>
  2356. <value>60</value>
  2357. <description>
  2358. Sets value for KMS client connection timeout, and the read timeout
  2359. to KMS servers.
  2360. </description>
  2361. </property>
  2362. <property>
  2363. <name>hadoop.security.kms.client.failover.sleep.base.millis</name>
  2364. <value>100</value>
  2365. <description>
  2366. Expert only. The time to wait, in milliseconds, between failover
  2367. attempts increases exponentially as a function of the number of
  2368. attempts made so far, with a random factor of +/- 50%. This option
  2369. specifies the base value used in the failover calculation. The
  2370. first failover will retry immediately. The 2nd failover attempt
  2371. will delay at least hadoop.security.client.failover.sleep.base.millis
  2372. milliseconds. And so on.
  2373. </description>
  2374. </property>
  2375. <property>
  2376. <name>hadoop.security.kms.client.failover.sleep.max.millis</name>
  2377. <value>2000</value>
  2378. <description>
  2379. Expert only. The time to wait, in milliseconds, between failover
  2380. attempts increases exponentially as a function of the number of
  2381. attempts made so far, with a random factor of +/- 50%. This option
  2382. specifies the maximum value to wait between failovers.
  2383. Specifically, the time between two failover attempts will not
  2384. exceed +/- 50% of hadoop.security.client.failover.sleep.max.millis
  2385. milliseconds.
  2386. </description>
  2387. </property>
  2388. <property>
  2389. <name>ipc.server.max.connections</name>
  2390. <value>0</value>
  2391. <description>The maximum number of concurrent connections a server is allowed
  2392. to accept. If this limit is exceeded, incoming connections will first fill
  2393. the listen queue and then may go to an OS-specific listen overflow queue.
  2394. The client may fail or timeout, but the server can avoid running out of file
  2395. descriptors using this feature. 0 means no limit.
  2396. </description>
  2397. </property>
  2398. <!-- YARN registry -->
  2399. <property>
  2400. <name>hadoop.registry.rm.enabled</name>
  2401. <value>false</value>
  2402. <description>
  2403. Is the registry enabled in the YARN Resource Manager?
  2404. If true, the YARN RM will, as needed.
  2405. create the user and system paths, and purge
  2406. service records when containers, application attempts
  2407. and applications complete.
  2408. If false, the paths must be created by other means,
  2409. and no automatic cleanup of service records will take place.
  2410. </description>
  2411. </property>
  2412. <property>
  2413. <name>hadoop.registry.zk.root</name>
  2414. <value>/registry</value>
  2415. <description>
  2416. The root zookeeper node for the registry
  2417. </description>
  2418. </property>
  2419. <property>
  2420. <name>hadoop.registry.zk.session.timeout.ms</name>
  2421. <value>60000</value>
  2422. <description>
  2423. Zookeeper session timeout in milliseconds
  2424. </description>
  2425. </property>
  2426. <property>
  2427. <name>hadoop.registry.zk.connection.timeout.ms</name>
  2428. <value>15000</value>
  2429. <description>
  2430. Zookeeper connection timeout in milliseconds
  2431. </description>
  2432. </property>
  2433. <property>
  2434. <name>hadoop.registry.zk.retry.times</name>
  2435. <value>5</value>
  2436. <description>
  2437. Zookeeper connection retry count before failing
  2438. </description>
  2439. </property>
  2440. <property>
  2441. <name>hadoop.registry.zk.retry.interval.ms</name>
  2442. <value>1000</value>
  2443. <description>
  2444. </description>
  2445. </property>
  2446. <property>
  2447. <name>hadoop.registry.zk.retry.ceiling.ms</name>
  2448. <value>60000</value>
  2449. <description>
  2450. Zookeeper retry limit in milliseconds, during
  2451. exponential backoff.
  2452. This places a limit even
  2453. if the retry times and interval limit, combined
  2454. with the backoff policy, result in a long retry
  2455. period
  2456. </description>
  2457. </property>
  2458. <property>
  2459. <name>hadoop.registry.zk.quorum</name>
  2460. <value>localhost:2181</value>
  2461. <description>
  2462. List of hostname:port pairs defining the
  2463. zookeeper quorum binding for the registry
  2464. </description>
  2465. </property>
  2466. <property>
  2467. <name>hadoop.registry.secure</name>
  2468. <value>false</value>
  2469. <description>
  2470. Key to set if the registry is secure. Turning it on
  2471. changes the permissions policy from "open access"
  2472. to restrictions on kerberos with the option of
  2473. a user adding one or more auth key pairs down their
  2474. own tree.
  2475. </description>
  2476. </property>
  2477. <property>
  2478. <name>hadoop.registry.system.acls</name>
  2479. <value>sasl:yarn@, sasl:mapred@, sasl:hdfs@</value>
  2480. <description>
  2481. A comma separated list of Zookeeper ACL identifiers with
  2482. system access to the registry in a secure cluster.
  2483. These are given full access to all entries.
  2484. If there is an "@" at the end of a SASL entry it
  2485. instructs the registry client to append the default kerberos domain.
  2486. </description>
  2487. </property>
  2488. <property>
  2489. <name>hadoop.registry.kerberos.realm</name>
  2490. <value></value>
  2491. <description>
  2492. The kerberos realm: used to set the realm of
  2493. system principals which do not declare their realm,
  2494. and any other accounts that need the value.
  2495. If empty, the default realm of the running process
  2496. is used.
  2497. If neither are known and the realm is needed, then the registry
  2498. service/client will fail.
  2499. </description>
  2500. </property>
  2501. <property>
  2502. <name>hadoop.registry.jaas.context</name>
  2503. <value>Client</value>
  2504. <description>
  2505. Key to define the JAAS context. Used in secure
  2506. mode
  2507. </description>
  2508. </property>
  2509. <property>
  2510. <name>hadoop.shell.missing.defaultFs.warning</name>
  2511. <value>false</value>
  2512. <description>
  2513. Enable hdfs shell commands to display warnings if (fs.defaultFS) property
  2514. is not set.
  2515. </description>
  2516. </property>
  2517. <property>
  2518. <name>hadoop.shell.safely.delete.limit.num.files</name>
  2519. <value>100</value>
  2520. <description>Used by -safely option of hadoop fs shell -rm command to avoid
  2521. accidental deletion of large directories. When enabled, the -rm command
  2522. requires confirmation if the number of files to be deleted is greater than
  2523. this limit. The default limit is 100 files. The warning is disabled if
  2524. the limit is 0 or the -safely is not specified in -rm command.
  2525. </description>
  2526. </property>
  2527. <property>
  2528. <name>fs.client.htrace.sampler.classes</name>
  2529. <value></value>
  2530. <description>The class names of the HTrace Samplers to use for Hadoop
  2531. filesystem clients.
  2532. </description>
  2533. </property>
  2534. <property>
  2535. <name>hadoop.htrace.span.receiver.classes</name>
  2536. <value></value>
  2537. <description>The class names of the Span Receivers to use for Hadoop.
  2538. </description>
  2539. </property>
  2540. <property>
  2541. <name>hadoop.http.logs.enabled</name>
  2542. <value>true</value>
  2543. <description>
  2544. Enable the "/logs" endpoint on all Hadoop daemons, which serves local
  2545. logs, but may be considered a security risk due to it listing the contents
  2546. of a directory.
  2547. </description>
  2548. </property>
  2549. <property>
  2550. <name>fs.client.resolve.topology.enabled</name>
  2551. <value>false</value>
  2552. <description>Whether the client machine will use the class specified by
  2553. property net.topology.node.switch.mapping.impl to compute the network
  2554. distance between itself and remote machines of the FileSystem. Additional
  2555. properties might need to be configured depending on the class specified
  2556. in net.topology.node.switch.mapping.impl. For example, if
  2557. org.apache.hadoop.net.ScriptBasedMapping is used, a valid script file
  2558. needs to be specified in net.topology.script.file.name.
  2559. </description>
  2560. </property>
  2561. <!-- Azure Data Lake File System Configurations -->
  2562. <property>
  2563. <name>fs.adl.impl</name>
  2564. <value>org.apache.hadoop.fs.adl.AdlFileSystem</value>
  2565. </property>
  2566. <property>
  2567. <name>fs.AbstractFileSystem.adl.impl</name>
  2568. <value>org.apache.hadoop.fs.adl.Adl</value>
  2569. </property>
  2570. <property>
  2571. <name>adl.feature.ownerandgroup.enableupn</name>
  2572. <value>false</value>
  2573. <description>
  2574. When true : User and Group in FileStatus/AclStatus response is
  2575. represented as user friendly name as per Azure AD profile.
  2576. When false (default) : User and Group in FileStatus/AclStatus
  2577. response is represented by the unique identifier from Azure AD
  2578. profile (Object ID as GUID).
  2579. For optimal performance, false is recommended.
  2580. </description>
  2581. </property>
  2582. <property>
  2583. <name>fs.adl.oauth2.access.token.provider.type</name>
  2584. <value>ClientCredential</value>
  2585. <description>
  2586. Defines Azure Active Directory OAuth2 access token provider type.
  2587. Supported types are ClientCredential, RefreshToken, MSI, DeviceCode,
  2588. and Custom.
  2589. The ClientCredential type requires property fs.adl.oauth2.client.id,
  2590. fs.adl.oauth2.credential, and fs.adl.oauth2.refresh.url.
  2591. The RefreshToken type requires property fs.adl.oauth2.client.id and
  2592. fs.adl.oauth2.refresh.token.
  2593. The MSI type reads optional property fs.adl.oauth2.msi.port, if specified.
  2594. The DeviceCode type requires property
  2595. fs.adl.oauth2.devicecode.clientapp.id.
  2596. The Custom type requires property fs.adl.oauth2.access.token.provider.
  2597. </description>
  2598. </property>
  2599. <property>
  2600. <name>fs.adl.oauth2.client.id</name>
  2601. <value></value>
  2602. <description>The OAuth2 client id.</description>
  2603. </property>
  2604. <property>
  2605. <name>fs.adl.oauth2.credential</name>
  2606. <value></value>
  2607. <description>The OAuth2 access key.</description>
  2608. </property>
  2609. <property>
  2610. <name>fs.adl.oauth2.refresh.url</name>
  2611. <value></value>
  2612. <description>The OAuth2 token endpoint.</description>
  2613. </property>
  2614. <property>
  2615. <name>fs.adl.oauth2.refresh.token</name>
  2616. <value></value>
  2617. <description>The OAuth2 refresh token.</description>
  2618. </property>
  2619. <property>
  2620. <name>fs.adl.oauth2.access.token.provider</name>
  2621. <value></value>
  2622. <description>
  2623. The class name of the OAuth2 access token provider.
  2624. </description>
  2625. </property>
  2626. <property>
  2627. <name>fs.adl.oauth2.msi.port</name>
  2628. <value></value>
  2629. <description>
  2630. The localhost port for the MSI token service. This is the port specified
  2631. when creating the Azure VM. The default, if this setting is not specified,
  2632. is 50342.
  2633. Used by MSI token provider.
  2634. </description>
  2635. </property>
  2636. <property>
  2637. <name>fs.adl.oauth2.devicecode.clientapp.id</name>
  2638. <value></value>
  2639. <description>
  2640. The app id of the AAD native app in whose context the auth request
  2641. should be made.
  2642. Used by DeviceCode token provider.
  2643. </description>
  2644. </property>
  2645. <property>
  2646. <name>adl.http.timeout</name>
  2647. <value>-1</value>
  2648. <description>
  2649. Base timeout (in milliseconds) for HTTP requests from the ADL SDK. Values
  2650. of zero or less cause the SDK default to be used instead.
  2651. </description>
  2652. </property>
  2653. <!-- Azure Data Lake File System Configurations Ends Here-->
  2654. <property>
  2655. <name>hadoop.caller.context.enabled</name>
  2656. <value>false</value>
  2657. <description>When the feature is enabled, additional fields are written into
  2658. name-node audit log records for auditing coarse granularity operations.
  2659. </description>
  2660. </property>
  2661. <property>
  2662. <name>hadoop.caller.context.max.size</name>
  2663. <value>128</value>
  2664. <description>The maximum bytes a caller context string can have. If the
  2665. passed caller context is longer than this maximum bytes, client will
  2666. truncate it before sending to server. Note that the server may have a
  2667. different maximum size, and will truncate the caller context to the
  2668. maximum size it allows.
  2669. </description>
  2670. </property>
  2671. <property>
  2672. <name>hadoop.caller.context.signature.max.size</name>
  2673. <value>40</value>
  2674. <description>
  2675. The caller's signature (optional) is for offline validation. If the
  2676. signature exceeds the maximum allowed bytes in server, the caller context
  2677. will be abandoned, in which case the caller context will not be recorded
  2678. in audit logs.
  2679. </description>
  2680. </property>
  2681. <!-- SequenceFile's Sorter properties -->
  2682. <property>
  2683. <name>seq.io.sort.mb</name>
  2684. <value>100</value>
  2685. <description>
  2686. The total amount of buffer memory to use while sorting files,
  2687. while using SequenceFile.Sorter, in megabytes. By default,
  2688. gives each merge stream 1MB, which should minimize seeks.
  2689. </description>
  2690. </property>
  2691. <property>
  2692. <name>seq.io.sort.factor</name>
  2693. <value>100</value>
  2694. <description>
  2695. The number of streams to merge at once while sorting
  2696. files using SequenceFile.Sorter.
  2697. This determines the number of open file handles.
  2698. </description>
  2699. </property>
  2700. <property>
  2701. <name>hadoop.zk.address</name>
  2702. <!--value>127.0.0.1:2181</value-->
  2703. <description>Host:Port of the ZooKeeper server to be used.
  2704. </description>
  2705. </property>
  2706. <property>
  2707. <name>hadoop.zk.num-retries</name>
  2708. <value>1000</value>
  2709. <description>Number of tries to connect to ZooKeeper.</description>
  2710. </property>
  2711. <property>
  2712. <name>hadoop.zk.retry-interval-ms</name>
  2713. <value>1000</value>
  2714. <description>Retry interval in milliseconds when connecting to ZooKeeper.
  2715. </description>
  2716. </property>
  2717. <property>
  2718. <name>hadoop.zk.timeout-ms</name>
  2719. <value>10000</value>
  2720. <description>ZooKeeper session timeout in milliseconds. Session expiration
  2721. is managed by the ZooKeeper cluster itself, not by the client. This value is
  2722. used by the cluster to determine when the client's session expires.
  2723. Expirations happens when the cluster does not hear from the client within
  2724. the specified session timeout period (i.e. no heartbeat).</description>
  2725. </property>
  2726. <property>
  2727. <name>hadoop.zk.acl</name>
  2728. <value>world:anyone:rwcda</value>
  2729. <description>ACL's to be used for ZooKeeper znodes.</description>
  2730. </property>
  2731. <property>
  2732. <name>hadoop.zk.auth</name>
  2733. <description>
  2734. Specify the auths to be used for the ACL's specified in hadoop.zk.acl.
  2735. This takes a comma-separated list of authentication mechanisms, each of the
  2736. form 'scheme:auth' (the same syntax used for the 'addAuth' command in
  2737. the ZK CLI).
  2738. </description>
  2739. </property>
  2740. <property>
  2741. <name>hadoop.system.tags</name>
  2742. <value>YARN,HDFS,NAMENODE,DATANODE,REQUIRED,SECURITY,KERBEROS,PERFORMANCE,CLIENT
  2743. ,SERVER,DEBUG,DEPRECATED,COMMON,OPTIONAL</value>
  2744. <description>
  2745. Deprecated. Please use hadoop.tags.system instead.
  2746. </description>
  2747. </property>
  2748. <property>
  2749. <name>hadoop.tags.system</name>
  2750. <value>YARN,HDFS,NAMENODE,DATANODE,REQUIRED,SECURITY,KERBEROS,PERFORMANCE,CLIENT
  2751. ,SERVER,DEBUG,DEPRECATED,COMMON,OPTIONAL</value>
  2752. <description>
  2753. System tags to group related properties together.
  2754. </description>
  2755. </property>
  2756. <property>
  2757. <name>ipc.client.bind.wildcard.addr</name>
  2758. <value>false</value>
  2759. <description>When set to true Clients will bind socket to wildcard
  2760. address. (i.e 0.0.0.0)
  2761. </description>
  2762. </property>
  2763. </configuration>