core-default.xml 96 KB

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