hdfs-default.xml 86 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508
  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 hdfs-site.xml and change them -->
  19. <!-- there. If hdfs-site.xml does not already exist, create it. -->
  20. <configuration>
  21. <property>
  22. <name>hadoop.hdfs.configuration.version</name>
  23. <value>1</value>
  24. <description>version of this configuration file</description>
  25. </property>
  26. <property>
  27. <name>dfs.namenode.rpc-address</name>
  28. <value></value>
  29. <description>
  30. RPC address that handles all clients requests. In the case of HA/Federation where multiple namenodes exist,
  31. the name service id is added to the name e.g. dfs.namenode.rpc-address.ns1
  32. dfs.namenode.rpc-address.EXAMPLENAMESERVICE
  33. The value of this property will take the form of nn-host1:rpc-port.
  34. </description>
  35. </property>
  36. <property>
  37. <name>dfs.namenode.rpc-bind-host</name>
  38. <value></value>
  39. <description>
  40. The actual address the RPC server will bind to. If this optional address is
  41. set, it overrides only the hostname portion of dfs.namenode.rpc-address.
  42. It can also be specified per name node or name service for HA/Federation.
  43. This is useful for making the name node listen on all interfaces by
  44. setting it to 0.0.0.0.
  45. </description>
  46. </property>
  47. <property>
  48. <name>dfs.namenode.servicerpc-address</name>
  49. <value></value>
  50. <description>
  51. RPC address for HDFS Services communication. BackupNode, Datanodes and all other services should be
  52. connecting to this address if it is configured. In the case of HA/Federation where multiple namenodes exist,
  53. the name service id is added to the name e.g. dfs.namenode.servicerpc-address.ns1
  54. dfs.namenode.rpc-address.EXAMPLENAMESERVICE
  55. The value of this property will take the form of nn-host1:rpc-port.
  56. If the value of this property is unset the value of dfs.namenode.rpc-address will be used as the default.
  57. </description>
  58. </property>
  59. <property>
  60. <name>dfs.namenode.servicerpc-bind-host</name>
  61. <value></value>
  62. <description>
  63. The actual address the service RPC server will bind to. If this optional address is
  64. set, it overrides only the hostname portion of dfs.namenode.servicerpc-address.
  65. It can also be specified per name node or name service for HA/Federation.
  66. This is useful for making the name node listen on all interfaces by
  67. setting it to 0.0.0.0.
  68. </description>
  69. </property>
  70. <property>
  71. <name>dfs.namenode.secondary.http-address</name>
  72. <value>0.0.0.0:50090</value>
  73. <description>
  74. The secondary namenode http server address and port.
  75. </description>
  76. </property>
  77. <property>
  78. <name>dfs.namenode.secondary.https-address</name>
  79. <value>0.0.0.0:50091</value>
  80. <description>
  81. The secondary namenode HTTPS server address and port.
  82. </description>
  83. </property>
  84. <property>
  85. <name>dfs.datanode.address</name>
  86. <value>0.0.0.0:50010</value>
  87. <description>
  88. The datanode server address and port for data transfer.
  89. </description>
  90. </property>
  91. <property>
  92. <name>dfs.datanode.http.address</name>
  93. <value>0.0.0.0:50075</value>
  94. <description>
  95. The datanode http server address and port.
  96. </description>
  97. </property>
  98. <property>
  99. <name>dfs.datanode.ipc.address</name>
  100. <value>0.0.0.0:50020</value>
  101. <description>
  102. The datanode ipc server address and port.
  103. </description>
  104. </property>
  105. <property>
  106. <name>dfs.datanode.handler.count</name>
  107. <value>10</value>
  108. <description>The number of server threads for the datanode.</description>
  109. </property>
  110. <property>
  111. <name>dfs.namenode.http-address</name>
  112. <value>0.0.0.0:50070</value>
  113. <description>
  114. The address and the base port where the dfs namenode web ui will listen on.
  115. </description>
  116. </property>
  117. <property>
  118. <name>dfs.namenode.http-bind-host</name>
  119. <value></value>
  120. <description>
  121. The actual adress the HTTP server will bind to. If this optional address
  122. is set, it overrides only the hostname portion of dfs.namenode.http-address.
  123. It can also be specified per name node or name service for HA/Federation.
  124. This is useful for making the name node HTTP server listen on all
  125. interfaces by setting it to 0.0.0.0.
  126. </description>
  127. </property>
  128. <property>
  129. <name>dfs.namenode.heartbeat.recheck-interval</name>
  130. <value>300000</value>
  131. <description>
  132. This time decides the interval to check for expired datanodes.
  133. With this value and dfs.heartbeat.interval, the interval of
  134. deciding the datanode is stale or not is also calculated.
  135. The unit of this configuration is millisecond.
  136. </description>
  137. </property>
  138. <property>
  139. <name>dfs.http.policy</name>
  140. <value>HTTP_ONLY</value>
  141. <description>Decide if HTTPS(SSL) is supported on HDFS
  142. This configures the HTTP endpoint for HDFS daemons:
  143. The following values are supported:
  144. - HTTP_ONLY : Service is provided only on http
  145. - HTTPS_ONLY : Service is provided only on https
  146. - HTTP_AND_HTTPS : Service is provided both on http and https
  147. </description>
  148. </property>
  149. <property>
  150. <name>dfs.client.https.need-auth</name>
  151. <value>false</value>
  152. <description>Whether SSL client certificate authentication is required
  153. </description>
  154. </property>
  155. <property>
  156. <name>dfs.client.cached.conn.retry</name>
  157. <value>3</value>
  158. <description>The number of times the HDFS client will pull a socket from the
  159. cache. Once this number is exceeded, the client will try to create a new
  160. socket.
  161. </description>
  162. </property>
  163. <property>
  164. <name>dfs.https.server.keystore.resource</name>
  165. <value>ssl-server.xml</value>
  166. <description>Resource file from which ssl server keystore
  167. information will be extracted
  168. </description>
  169. </property>
  170. <property>
  171. <name>dfs.client.https.keystore.resource</name>
  172. <value>ssl-client.xml</value>
  173. <description>Resource file from which ssl client keystore
  174. information will be extracted
  175. </description>
  176. </property>
  177. <property>
  178. <name>dfs.datanode.https.address</name>
  179. <value>0.0.0.0:50475</value>
  180. <description>The datanode secure http server address and port.</description>
  181. </property>
  182. <property>
  183. <name>dfs.namenode.https-address</name>
  184. <value>0.0.0.0:50470</value>
  185. <description>The namenode secure http server address and port.</description>
  186. </property>
  187. <property>
  188. <name>dfs.namenode.https-bind-host</name>
  189. <value></value>
  190. <description>
  191. The actual adress the HTTPS server will bind to. If this optional address
  192. is set, it overrides only the hostname portion of dfs.namenode.https-address.
  193. It can also be specified per name node or name service for HA/Federation.
  194. This is useful for making the name node HTTPS server listen on all
  195. interfaces by setting it to 0.0.0.0.
  196. </description>
  197. </property>
  198. <property>
  199. <name>dfs.datanode.dns.interface</name>
  200. <value>default</value>
  201. <description>
  202. The name of the Network Interface from which a data node should
  203. report its IP address. e.g. eth2. This setting may be required for some
  204. multi-homed nodes where the DataNodes are assigned multiple hostnames
  205. and it is desirable for the DataNodes to use a non-default hostname.
  206. Prefer using hadoop.security.dns.interface over
  207. dfs.datanode.dns.interface.
  208. </description>
  209. </property>
  210. <property>
  211. <name>dfs.datanode.dns.nameserver</name>
  212. <value>default</value>
  213. <description>
  214. The host name or IP address of the name server (DNS) which a DataNode
  215. should use to determine its own host name.
  216. Prefer using hadoop.security.dns.nameserver over
  217. dfs.datanode.dns.nameserver.
  218. </description>
  219. </property>
  220. <property>
  221. <name>dfs.namenode.backup.address</name>
  222. <value>0.0.0.0:50100</value>
  223. <description>
  224. The backup node server address and port.
  225. If the port is 0 then the server will start on a free port.
  226. </description>
  227. </property>
  228. <property>
  229. <name>dfs.namenode.backup.http-address</name>
  230. <value>0.0.0.0:50105</value>
  231. <description>
  232. The backup node http server address and port.
  233. If the port is 0 then the server will start on a free port.
  234. </description>
  235. </property>
  236. <property>
  237. <name>dfs.namenode.replication.considerLoad</name>
  238. <value>true</value>
  239. <description>Decide if chooseTarget considers the target's load or not
  240. </description>
  241. </property>
  242. <property>
  243. <name>dfs.default.chunk.view.size</name>
  244. <value>32768</value>
  245. <description>The number of bytes to view for a file on the browser.
  246. </description>
  247. </property>
  248. <property>
  249. <name>dfs.datanode.du.reserved</name>
  250. <value>0</value>
  251. <description>Reserved space in bytes per volume. Always leave this much space free for non dfs use.
  252. </description>
  253. </property>
  254. <property>
  255. <name>dfs.namenode.name.dir</name>
  256. <value>file://${hadoop.tmp.dir}/dfs/name</value>
  257. <description>Determines where on the local filesystem the DFS name node
  258. should store the name table(fsimage). If this is a comma-delimited list
  259. of directories then the name table is replicated in all of the
  260. directories, for redundancy. </description>
  261. </property>
  262. <property>
  263. <name>dfs.namenode.name.dir.restore</name>
  264. <value>false</value>
  265. <description>Set to true to enable NameNode to attempt recovering a
  266. previously failed dfs.namenode.name.dir. When enabled, a recovery of any
  267. failed directory is attempted during checkpoint.</description>
  268. </property>
  269. <property>
  270. <name>dfs.namenode.fs-limits.max-component-length</name>
  271. <value>255</value>
  272. <description>Defines the maximum number of bytes in UTF-8 encoding in each
  273. component of a path. A value of 0 will disable the check.</description>
  274. </property>
  275. <property>
  276. <name>dfs.namenode.fs-limits.max-directory-items</name>
  277. <value>1048576</value>
  278. <description>Defines the maximum number of items that a directory may
  279. contain. Cannot set the property to a value less than 1 or more than
  280. 6400000.</description>
  281. </property>
  282. <property>
  283. <name>dfs.namenode.fs-limits.min-block-size</name>
  284. <value>1048576</value>
  285. <description>Minimum block size in bytes, enforced by the Namenode at create
  286. time. This prevents the accidental creation of files with tiny block
  287. sizes (and thus many blocks), which can degrade
  288. performance.</description>
  289. </property>
  290. <property>
  291. <name>dfs.namenode.fs-limits.max-blocks-per-file</name>
  292. <value>1048576</value>
  293. <description>Maximum number of blocks per file, enforced by the Namenode on
  294. write. This prevents the creation of extremely large files which can
  295. degrade performance.</description>
  296. </property>
  297. <property>
  298. <name>dfs.namenode.edits.dir</name>
  299. <value>${dfs.namenode.name.dir}</value>
  300. <description>Determines where on the local filesystem the DFS name node
  301. should store the transaction (edits) file. If this is a comma-delimited list
  302. of directories then the transaction file is replicated in all of the
  303. directories, for redundancy. Default value is same as dfs.namenode.name.dir
  304. </description>
  305. </property>
  306. <property>
  307. <name>dfs.namenode.shared.edits.dir</name>
  308. <value></value>
  309. <description>A directory on shared storage between the multiple namenodes
  310. in an HA cluster. This directory will be written by the active and read
  311. by the standby in order to keep the namespaces synchronized. This directory
  312. does not need to be listed in dfs.namenode.edits.dir above. It should be
  313. left empty in a non-HA cluster.
  314. </description>
  315. </property>
  316. <property>
  317. <name>dfs.namenode.edits.journal-plugin.qjournal</name>
  318. <value>org.apache.hadoop.hdfs.qjournal.client.QuorumJournalManager</value>
  319. </property>
  320. <property>
  321. <name>dfs.permissions.enabled</name>
  322. <value>true</value>
  323. <description>
  324. If "true", enable permission checking in HDFS.
  325. If "false", permission checking is turned off,
  326. but all other behavior is unchanged.
  327. Switching from one parameter value to the other does not change the mode,
  328. owner or group of files or directories.
  329. </description>
  330. </property>
  331. <property>
  332. <name>dfs.permissions.superusergroup</name>
  333. <value>supergroup</value>
  334. <description>The name of the group of super-users.</description>
  335. </property>
  336. <!--
  337. <property>
  338. <name>dfs.cluster.administrators</name>
  339. <value>ACL for the admins</value>
  340. <description>This configuration is used to control who can access the
  341. default servlets in the namenode, etc.
  342. </description>
  343. </property>
  344. -->
  345. <property>
  346. <name>dfs.namenode.acls.enabled</name>
  347. <value>false</value>
  348. <description>
  349. Set to true to enable support for HDFS ACLs (Access Control Lists). By
  350. default, ACLs are disabled. When ACLs are disabled, the NameNode rejects
  351. all RPCs related to setting or getting ACLs.
  352. </description>
  353. </property>
  354. <property>
  355. <name>dfs.namenode.lazypersist.file.scrub.interval.sec</name>
  356. <value>300</value>
  357. <description>
  358. The NameNode periodically scans the namespace for LazyPersist files with
  359. missing blocks and unlinks them from the namespace. This configuration key
  360. controls the interval between successive scans. Set it to a negative value
  361. to disable this behavior.
  362. </description>
  363. </property>
  364. <property>
  365. <name>dfs.block.access.token.enable</name>
  366. <value>false</value>
  367. <description>
  368. If "true", access tokens are used as capabilities for accessing datanodes.
  369. If "false", no access tokens are checked on accessing datanodes.
  370. </description>
  371. </property>
  372. <property>
  373. <name>dfs.block.access.key.update.interval</name>
  374. <value>600</value>
  375. <description>
  376. Interval in minutes at which namenode updates its access keys.
  377. </description>
  378. </property>
  379. <property>
  380. <name>dfs.block.access.token.lifetime</name>
  381. <value>600</value>
  382. <description>The lifetime of access tokens in minutes.</description>
  383. </property>
  384. <property>
  385. <name>dfs.datanode.data.dir</name>
  386. <value>file://${hadoop.tmp.dir}/dfs/data</value>
  387. <description>Determines where on the local filesystem an DFS data node
  388. should store its blocks. If this is a comma-delimited
  389. list of directories, then data will be stored in all named
  390. directories, typically on different devices. The directories should be tagged
  391. with corresponding storage types ([SSD]/[DISK]/[ARCHIVE]/[RAM_DISK]) for HDFS
  392. storage policies. The default storage type will be DISK if the directory does
  393. not have a storage type tagged explicitly. Directories that do not exist will
  394. be created if local filesystem permission allows.
  395. </description>
  396. </property>
  397. <property>
  398. <name>dfs.datanode.data.dir.perm</name>
  399. <value>700</value>
  400. <description>Permissions for the directories on on the local filesystem where
  401. the DFS data node store its blocks. The permissions can either be octal or
  402. symbolic.</description>
  403. </property>
  404. <property>
  405. <name>dfs.replication</name>
  406. <value>3</value>
  407. <description>Default block replication.
  408. The actual number of replications can be specified when the file is created.
  409. The default is used if replication is not specified in create time.
  410. </description>
  411. </property>
  412. <property>
  413. <name>dfs.replication.max</name>
  414. <value>512</value>
  415. <description>Maximal block replication.
  416. </description>
  417. </property>
  418. <property>
  419. <name>dfs.namenode.replication.min</name>
  420. <value>1</value>
  421. <description>Minimal block replication.
  422. </description>
  423. </property>
  424. <property>
  425. <name>dfs.namenode.safemode.replication.min</name>
  426. <value></value>
  427. <description>
  428. a separate minimum replication factor for calculating safe block count.
  429. This is an expert level setting.
  430. Setting this lower than the dfs.namenode.replication.min
  431. is not recommend and/or dangerous for production setups.
  432. When it's not set it takes value from dfs.namenode.replication.min
  433. </description>
  434. </property>
  435. <property>
  436. <name>dfs.blocksize</name>
  437. <value>134217728</value>
  438. <description>
  439. The default block size for new files, in bytes.
  440. You can use the following suffix (case insensitive):
  441. k(kilo), m(mega), g(giga), t(tera), p(peta), e(exa) to specify the size (such as 128k, 512m, 1g, etc.),
  442. Or provide complete size in bytes (such as 134217728 for 128 MB).
  443. </description>
  444. </property>
  445. <property>
  446. <name>dfs.client.block.write.retries</name>
  447. <value>3</value>
  448. <description>The number of retries for writing blocks to the data nodes,
  449. before we signal failure to the application.
  450. </description>
  451. </property>
  452. <property>
  453. <name>dfs.client.block.write.replace-datanode-on-failure.enable</name>
  454. <value>true</value>
  455. <description>
  456. If there is a datanode/network failure in the write pipeline,
  457. DFSClient will try to remove the failed datanode from the pipeline
  458. and then continue writing with the remaining datanodes. As a result,
  459. the number of datanodes in the pipeline is decreased. The feature is
  460. to add new datanodes to the pipeline.
  461. This is a site-wide property to enable/disable the feature.
  462. When the cluster size is extremely small, e.g. 3 nodes or less, cluster
  463. administrators may want to set the policy to NEVER in the default
  464. configuration file or disable this feature. Otherwise, users may
  465. experience an unusually high rate of pipeline failures since it is
  466. impossible to find new datanodes for replacement.
  467. See also dfs.client.block.write.replace-datanode-on-failure.policy
  468. </description>
  469. </property>
  470. <property>
  471. <name>dfs.client.block.write.replace-datanode-on-failure.policy</name>
  472. <value>DEFAULT</value>
  473. <description>
  474. This property is used only if the value of
  475. dfs.client.block.write.replace-datanode-on-failure.enable is true.
  476. ALWAYS: always add a new datanode when an existing datanode is removed.
  477. NEVER: never add a new datanode.
  478. DEFAULT:
  479. Let r be the replication number.
  480. Let n be the number of existing datanodes.
  481. Add a new datanode only if r is greater than or equal to 3 and either
  482. (1) floor(r/2) is greater than or equal to n; or
  483. (2) r is greater than n and the block is hflushed/appended.
  484. </description>
  485. </property>
  486. <property>
  487. <name>dfs.client.block.write.replace-datanode-on-failure.best-effort</name>
  488. <value>false</value>
  489. <description>
  490. This property is used only if the value of
  491. dfs.client.block.write.replace-datanode-on-failure.enable is true.
  492. Best effort means that the client will try to replace a failed datanode
  493. in write pipeline (provided that the policy is satisfied), however, it
  494. continues the write operation in case that the datanode replacement also
  495. fails.
  496. Suppose the datanode replacement fails.
  497. false: An exception should be thrown so that the write will fail.
  498. true : The write should be resumed with the remaining datandoes.
  499. Note that setting this property to true allows writing to a pipeline
  500. with a smaller number of datanodes. As a result, it increases the
  501. probability of data loss.
  502. </description>
  503. </property>
  504. <property>
  505. <name>dfs.blockreport.intervalMsec</name>
  506. <value>21600000</value>
  507. <description>Determines block reporting interval in milliseconds.</description>
  508. </property>
  509. <property>
  510. <name>dfs.blockreport.initialDelay</name> <value>0</value>
  511. <description>Delay for first block report in seconds.</description>
  512. </property>
  513. <property>
  514. <name>dfs.blockreport.split.threshold</name>
  515. <value>1000000</value>
  516. <description>If the number of blocks on the DataNode is below this
  517. threshold then it will send block reports for all Storage Directories
  518. in a single message.
  519. If the number of blocks exceeds this threshold then the DataNode will
  520. send block reports for each Storage Directory in separate messages.
  521. Set to zero to always split.
  522. </description>
  523. </property>
  524. <property>
  525. <name>dfs.namenode.max.full.block.report.leases</name>
  526. <value>6</value>
  527. <description>The maximum number of leases for full block reports that the
  528. NameNode will issue at any given time. This prevents the NameNode from
  529. being flooded with full block reports that use up all the RPC handler
  530. threads. This number should never be more than the number of RPC handler
  531. threads or less than 1.
  532. </description>
  533. </property>
  534. <property>
  535. <name>dfs.namenode.full.block.report.lease.length.ms</name>
  536. <value>300000</value>
  537. <description>
  538. The number of milliseconds that the NameNode will wait before invalidating
  539. a full block report lease. This prevents a crashed DataNode from
  540. permanently using up a full block report lease.
  541. </description>
  542. </property>
  543. <property>
  544. <name>dfs.datanode.directoryscan.interval</name>
  545. <value>21600</value>
  546. <description>Interval in seconds for Datanode to scan data directories and
  547. reconcile the difference between blocks in memory and on the disk.
  548. </description>
  549. </property>
  550. <property>
  551. <name>dfs.datanode.directoryscan.threads</name>
  552. <value>1</value>
  553. <description>How many threads should the threadpool used to compile reports
  554. for volumes in parallel have.
  555. </description>
  556. </property>
  557. <property>
  558. <name>dfs.datanode.directoryscan.throttle.limit.ms.per.sec</name>
  559. <value>0</value>
  560. <description>The report compilation threads are limited to only running for
  561. a given number of milliseconds per second, as configured by the
  562. property. The limit is taken per thread, not in aggregate, e.g. setting
  563. a limit of 100ms for 4 compiler threads will result in each thread being
  564. limited to 100ms, not 25ms.
  565. Note that the throttle does not interrupt the report compiler threads, so the
  566. actual running time of the threads per second will typically be somewhat
  567. higher than the throttle limit, usually by no more than 20%.
  568. Setting this limit to 1000 disables compiler thread throttling. Only
  569. values between 1 and 1000 are valid. Setting an invalid value will result
  570. in the throttle being disbled and an error message being logged. 1000 is
  571. the default setting.
  572. </description>
  573. </property>
  574. <property>
  575. <name>dfs.heartbeat.interval</name>
  576. <value>3</value>
  577. <description>Determines datanode heartbeat interval in seconds.</description>
  578. </property>
  579. <property>
  580. <name>dfs.namenode.handler.count</name>
  581. <value>10</value>
  582. <description>The number of Namenode RPC server threads that listen to
  583. requests from clients.
  584. If dfs.namenode.servicerpc-address is not configured then
  585. Namenode RPC server threads listen to requests from all nodes.
  586. </description>
  587. </property>
  588. <property>
  589. <name>dfs.namenode.service.handler.count</name>
  590. <value>10</value>
  591. <description>The number of Namenode RPC server threads that listen to
  592. requests from DataNodes and from all other non-client nodes.
  593. dfs.namenode.service.handler.count will be valid only if
  594. dfs.namenode.servicerpc-address is configured.
  595. </description>
  596. </property>
  597. <property>
  598. <name>dfs.namenode.safemode.threshold-pct</name>
  599. <value>0.999f</value>
  600. <description>
  601. Specifies the percentage of blocks that should satisfy
  602. the minimal replication requirement defined by dfs.namenode.replication.min.
  603. Values less than or equal to 0 mean not to wait for any particular
  604. percentage of blocks before exiting safemode.
  605. Values greater than 1 will make safe mode permanent.
  606. </description>
  607. </property>
  608. <property>
  609. <name>dfs.namenode.safemode.min.datanodes</name>
  610. <value>0</value>
  611. <description>
  612. Specifies the number of datanodes that must be considered alive
  613. before the name node exits safemode.
  614. Values less than or equal to 0 mean not to take the number of live
  615. datanodes into account when deciding whether to remain in safe mode
  616. during startup.
  617. Values greater than the number of datanodes in the cluster
  618. will make safe mode permanent.
  619. </description>
  620. </property>
  621. <property>
  622. <name>dfs.namenode.safemode.extension</name>
  623. <value>30000</value>
  624. <description>
  625. Determines extension of safe mode in milliseconds
  626. after the threshold level is reached.
  627. </description>
  628. </property>
  629. <property>
  630. <name>dfs.namenode.resource.check.interval</name>
  631. <value>5000</value>
  632. <description>
  633. The interval in milliseconds at which the NameNode resource checker runs.
  634. The checker calculates the number of the NameNode storage volumes whose
  635. available spaces are more than dfs.namenode.resource.du.reserved, and
  636. enters safemode if the number becomes lower than the minimum value
  637. specified by dfs.namenode.resource.checked.volumes.minimum.
  638. </description>
  639. </property>
  640. <property>
  641. <name>dfs.namenode.resource.du.reserved</name>
  642. <value>104857600</value>
  643. <description>
  644. The amount of space to reserve/require for a NameNode storage directory
  645. in bytes. The default is 100MB.
  646. </description>
  647. </property>
  648. <property>
  649. <name>dfs.namenode.resource.checked.volumes</name>
  650. <value></value>
  651. <description>
  652. A list of local directories for the NameNode resource checker to check in
  653. addition to the local edits directories.
  654. </description>
  655. </property>
  656. <property>
  657. <name>dfs.namenode.resource.checked.volumes.minimum</name>
  658. <value>1</value>
  659. <description>
  660. The minimum number of redundant NameNode storage volumes required.
  661. </description>
  662. </property>
  663. <property>
  664. <name>dfs.datanode.balance.bandwidthPerSec</name>
  665. <value>1048576</value>
  666. <description>
  667. Specifies the maximum amount of bandwidth that each datanode
  668. can utilize for the balancing purpose in term of
  669. the number of bytes per second.
  670. </description>
  671. </property>
  672. <property>
  673. <name>dfs.hosts</name>
  674. <value></value>
  675. <description>Names a file that contains a list of hosts that are
  676. permitted to connect to the namenode. The full pathname of the file
  677. must be specified. If the value is empty, all hosts are
  678. permitted.</description>
  679. </property>
  680. <property>
  681. <name>dfs.hosts.exclude</name>
  682. <value></value>
  683. <description>Names a file that contains a list of hosts that are
  684. not permitted to connect to the namenode. The full pathname of the
  685. file must be specified. If the value is empty, no hosts are
  686. excluded.</description>
  687. </property>
  688. <property>
  689. <name>dfs.namenode.max.objects</name>
  690. <value>0</value>
  691. <description>The maximum number of files, directories and blocks
  692. dfs supports. A value of zero indicates no limit to the number
  693. of objects that dfs supports.
  694. </description>
  695. </property>
  696. <property>
  697. <name>dfs.namenode.datanode.registration.ip-hostname-check</name>
  698. <value>true</value>
  699. <description>
  700. If true (the default), then the namenode requires that a connecting
  701. datanode's address must be resolved to a hostname. If necessary, a reverse
  702. DNS lookup is performed. All attempts to register a datanode from an
  703. unresolvable address are rejected.
  704. It is recommended that this setting be left on to prevent accidental
  705. registration of datanodes listed by hostname in the excludes file during a
  706. DNS outage. Only set this to false in environments where there is no
  707. infrastructure to support reverse DNS lookup.
  708. </description>
  709. </property>
  710. <property>
  711. <name>dfs.namenode.decommission.interval</name>
  712. <value>30</value>
  713. <description>Namenode periodicity in seconds to check if decommission is
  714. complete.</description>
  715. </property>
  716. <property>
  717. <name>dfs.namenode.decommission.blocks.per.interval</name>
  718. <value>500000</value>
  719. <description>The approximate number of blocks to process per
  720. decommission interval, as defined in dfs.namenode.decommission.interval.
  721. </description>
  722. </property>
  723. <property>
  724. <name>dfs.namenode.decommission.max.concurrent.tracked.nodes</name>
  725. <value>100</value>
  726. <description>
  727. The maximum number of decommission-in-progress datanodes nodes that will be
  728. tracked at one time by the namenode. Tracking a decommission-in-progress
  729. datanode consumes additional NN memory proportional to the number of blocks
  730. on the datnode. Having a conservative limit reduces the potential impact
  731. of decomissioning a large number of nodes at once.
  732. A value of 0 means no limit will be enforced.
  733. </description>
  734. </property>
  735. <property>
  736. <name>dfs.namenode.replication.interval</name>
  737. <value>3</value>
  738. <description>The periodicity in seconds with which the namenode computes
  739. replication work for datanodes. </description>
  740. </property>
  741. <property>
  742. <name>dfs.namenode.accesstime.precision</name>
  743. <value>3600000</value>
  744. <description>The access time for HDFS file is precise upto this value.
  745. The default value is 1 hour. Setting a value of 0 disables
  746. access times for HDFS.
  747. </description>
  748. </property>
  749. <property>
  750. <name>dfs.datanode.plugins</name>
  751. <value></value>
  752. <description>Comma-separated list of datanode plug-ins to be activated.
  753. </description>
  754. </property>
  755. <property>
  756. <name>dfs.namenode.plugins</name>
  757. <value></value>
  758. <description>Comma-separated list of namenode plug-ins to be activated.
  759. </description>
  760. </property>
  761. <property>
  762. <name>dfs.stream-buffer-size</name>
  763. <value>4096</value>
  764. <description>The size of buffer to stream files.
  765. The size of this buffer should probably be a multiple of hardware
  766. page size (4096 on Intel x86), and it determines how much data is
  767. buffered during read and write operations.</description>
  768. </property>
  769. <property>
  770. <name>dfs.bytes-per-checksum</name>
  771. <value>512</value>
  772. <description>The number of bytes per checksum. Must not be larger than
  773. dfs.stream-buffer-size</description>
  774. </property>
  775. <property>
  776. <name>dfs.client-write-packet-size</name>
  777. <value>65536</value>
  778. <description>Packet size for clients to write</description>
  779. </property>
  780. <property>
  781. <name>dfs.client.write.exclude.nodes.cache.expiry.interval.millis</name>
  782. <value>600000</value>
  783. <description>The maximum period to keep a DN in the excluded nodes list
  784. at a client. After this period, in milliseconds, the previously excluded node(s) will
  785. be removed automatically from the cache and will be considered good for block allocations
  786. again. Useful to lower or raise in situations where you keep a file open for very long
  787. periods (such as a Write-Ahead-Log (WAL) file) to make the writer tolerant to cluster maintenance
  788. restarts. Defaults to 10 minutes.</description>
  789. </property>
  790. <property>
  791. <name>dfs.namenode.checkpoint.dir</name>
  792. <value>file://${hadoop.tmp.dir}/dfs/namesecondary</value>
  793. <description>Determines where on the local filesystem the DFS secondary
  794. name node should store the temporary images to merge.
  795. If this is a comma-delimited list of directories then the image is
  796. replicated in all of the directories for redundancy.
  797. </description>
  798. </property>
  799. <property>
  800. <name>dfs.namenode.checkpoint.edits.dir</name>
  801. <value>${dfs.namenode.checkpoint.dir}</value>
  802. <description>Determines where on the local filesystem the DFS secondary
  803. name node should store the temporary edits to merge.
  804. If this is a comma-delimited list of directories then the edits is
  805. replicated in all of the directories for redundancy.
  806. Default value is same as dfs.namenode.checkpoint.dir
  807. </description>
  808. </property>
  809. <property>
  810. <name>dfs.namenode.checkpoint.period</name>
  811. <value>3600</value>
  812. <description>The number of seconds between two periodic checkpoints.
  813. </description>
  814. </property>
  815. <property>
  816. <name>dfs.namenode.checkpoint.txns</name>
  817. <value>1000000</value>
  818. <description>The Secondary NameNode or CheckpointNode will create a checkpoint
  819. of the namespace every 'dfs.namenode.checkpoint.txns' transactions, regardless
  820. of whether 'dfs.namenode.checkpoint.period' has expired.
  821. </description>
  822. </property>
  823. <property>
  824. <name>dfs.namenode.checkpoint.check.period</name>
  825. <value>60</value>
  826. <description>The SecondaryNameNode and CheckpointNode will poll the NameNode
  827. every 'dfs.namenode.checkpoint.check.period' seconds to query the number
  828. of uncheckpointed transactions.
  829. </description>
  830. </property>
  831. <property>
  832. <name>dfs.namenode.checkpoint.max-retries</name>
  833. <value>3</value>
  834. <description>The SecondaryNameNode retries failed checkpointing. If the
  835. failure occurs while loading fsimage or replaying edits, the number of
  836. retries is limited by this variable.
  837. </description>
  838. </property>
  839. <property>
  840. <name>dfs.namenode.checkpoint.check.quiet-multiplier</name>
  841. <value>1.5</value>
  842. <description>
  843. Used to calculate the amount of time between retries when in the 'quiet' period
  844. for creating checkpoints (active namenode already has an up-to-date image from another
  845. checkpointer), so we wait a multiplier of the dfs.namenode.checkpoint.check.period before
  846. retrying the checkpoint because another node likely is already managing the checkpoints,
  847. allowing us to save bandwidth to transfer checkpoints that don't need to be used.
  848. </description>
  849. </property>
  850. <property>
  851. <name>dfs.namenode.num.checkpoints.retained</name>
  852. <value>2</value>
  853. <description>The number of image checkpoint files (fsimage_*) that will be retained by
  854. the NameNode and Secondary NameNode in their storage directories. All edit
  855. logs (stored on edits_* files) necessary to recover an up-to-date namespace from the oldest retained
  856. checkpoint will also be retained.
  857. </description>
  858. </property>
  859. <property>
  860. <name>dfs.namenode.num.extra.edits.retained</name>
  861. <value>1000000</value>
  862. <description>The number of extra transactions which should be retained
  863. beyond what is minimally necessary for a NN restart.
  864. It does not translate directly to file's age, or the number of files kept,
  865. but to the number of transactions (here "edits" means transactions).
  866. One edit file may contain several transactions (edits).
  867. During checkpoint, NameNode will identify the total number of edits to retain as extra by
  868. checking the latest checkpoint transaction value, subtracted by the value of this property.
  869. Then, it scans edits files to identify the older ones that don't include the computed range of
  870. retained transactions that are to be kept around, and purges them subsequently.
  871. The retainment can be useful for audit purposes or for an HA setup where a remote Standby Node may have
  872. been offline for some time and need to have a longer backlog of retained
  873. edits in order to start again.
  874. Typically each edit is on the order of a few hundred bytes, so the default
  875. of 1 million edits should be on the order of hundreds of MBs or low GBs.
  876. NOTE: Fewer extra edits may be retained than value specified for this setting
  877. if doing so would mean that more segments would be retained than the number
  878. configured by dfs.namenode.max.extra.edits.segments.retained.
  879. </description>
  880. </property>
  881. <property>
  882. <name>dfs.namenode.max.extra.edits.segments.retained</name>
  883. <value>10000</value>
  884. <description>The maximum number of extra edit log segments which should be retained
  885. beyond what is minimally necessary for a NN restart. When used in conjunction with
  886. dfs.namenode.num.extra.edits.retained, this configuration property serves to cap
  887. the number of extra edits files to a reasonable value.
  888. </description>
  889. </property>
  890. <property>
  891. <name>dfs.namenode.delegation.key.update-interval</name>
  892. <value>86400000</value>
  893. <description>The update interval for master key for delegation tokens
  894. in the namenode in milliseconds.
  895. </description>
  896. </property>
  897. <property>
  898. <name>dfs.namenode.delegation.token.max-lifetime</name>
  899. <value>604800000</value>
  900. <description>The maximum lifetime in milliseconds for which a delegation
  901. token is valid.
  902. </description>
  903. </property>
  904. <property>
  905. <name>dfs.namenode.delegation.token.renew-interval</name>
  906. <value>86400000</value>
  907. <description>The renewal interval for delegation token in milliseconds.
  908. </description>
  909. </property>
  910. <property>
  911. <name>dfs.datanode.failed.volumes.tolerated</name>
  912. <value>0</value>
  913. <description>The number of volumes that are allowed to
  914. fail before a datanode stops offering service. By default
  915. any volume failure will cause a datanode to shutdown.
  916. </description>
  917. </property>
  918. <property>
  919. <name>dfs.image.compress</name>
  920. <value>false</value>
  921. <description>Should the dfs image be compressed?
  922. </description>
  923. </property>
  924. <property>
  925. <name>dfs.image.compression.codec</name>
  926. <value>org.apache.hadoop.io.compress.DefaultCodec</value>
  927. <description>If the dfs image is compressed, how should they be compressed?
  928. This has to be a codec defined in io.compression.codecs.
  929. </description>
  930. </property>
  931. <property>
  932. <name>dfs.image.transfer.timeout</name>
  933. <value>60000</value>
  934. <description>
  935. Socket timeout for image transfer in milliseconds. This timeout and the related
  936. dfs.image.transfer.bandwidthPerSec parameter should be configured such
  937. that normal image transfer can complete successfully.
  938. This timeout prevents client hangs when the sender fails during
  939. image transfer. This is socket timeout during image transfer.
  940. </description>
  941. </property>
  942. <property>
  943. <name>dfs.image.transfer.bandwidthPerSec</name>
  944. <value>0</value>
  945. <description>
  946. Maximum bandwidth used for image transfer in bytes per second.
  947. This can help keep normal namenode operations responsive during
  948. checkpointing. The maximum bandwidth and timeout in
  949. dfs.image.transfer.timeout should be set such that normal image
  950. transfers can complete successfully.
  951. A default value of 0 indicates that throttling is disabled.
  952. </description>
  953. </property>
  954. <property>
  955. <name>dfs.image.transfer.chunksize</name>
  956. <value>65536</value>
  957. <description>
  958. Chunksize in bytes to upload the checkpoint.
  959. Chunked streaming is used to avoid internal buffering of contents
  960. of image file of huge size.
  961. </description>
  962. </property>
  963. <property>
  964. <name>dfs.namenode.support.allow.format</name>
  965. <value>true</value>
  966. <description>Does HDFS namenode allow itself to be formatted?
  967. You may consider setting this to false for any production
  968. cluster, to avoid any possibility of formatting a running DFS.
  969. </description>
  970. </property>
  971. <property>
  972. <name>dfs.datanode.max.transfer.threads</name>
  973. <value>4096</value>
  974. <description>
  975. Specifies the maximum number of threads to use for transferring data
  976. in and out of the DN.
  977. </description>
  978. </property>
  979. <property>
  980. <name>dfs.datanode.scan.period.hours</name>
  981. <value>504</value>
  982. <description>
  983. If this is positive, the DataNode will not scan any
  984. individual block more than once in the specified scan period.
  985. If this is negative, the block scanner is disabled.
  986. If this is set to zero, then the default value of 504 hours
  987. or 3 weeks is used. Prior versions of HDFS incorrectly documented
  988. that setting this key to zero will disable the block scanner.
  989. </description>
  990. </property>
  991. <property>
  992. <name>dfs.block.scanner.volume.bytes.per.second</name>
  993. <value>1048576</value>
  994. <description>
  995. If this is 0, the DataNode's block scanner will be disabled. If this
  996. is positive, this is the number of bytes per second that the DataNode's
  997. block scanner will try to scan from each volume.
  998. </description>
  999. </property>
  1000. <property>
  1001. <name>dfs.datanode.readahead.bytes</name>
  1002. <value>4194304</value>
  1003. <description>
  1004. While reading block files, if the Hadoop native libraries are available,
  1005. the datanode can use the posix_fadvise system call to explicitly
  1006. page data into the operating system buffer cache ahead of the current
  1007. reader's position. This can improve performance especially when
  1008. disks are highly contended.
  1009. This configuration specifies the number of bytes ahead of the current
  1010. read position which the datanode will attempt to read ahead. This
  1011. feature may be disabled by configuring this property to 0.
  1012. If the native libraries are not available, this configuration has no
  1013. effect.
  1014. </description>
  1015. </property>
  1016. <property>
  1017. <name>dfs.datanode.drop.cache.behind.reads</name>
  1018. <value>false</value>
  1019. <description>
  1020. In some workloads, the data read from HDFS is known to be significantly
  1021. large enough that it is unlikely to be useful to cache it in the
  1022. operating system buffer cache. In this case, the DataNode may be
  1023. configured to automatically purge all data from the buffer cache
  1024. after it is delivered to the client. This behavior is automatically
  1025. disabled for workloads which read only short sections of a block
  1026. (e.g HBase random-IO workloads).
  1027. This may improve performance for some workloads by freeing buffer
  1028. cache space usage for more cacheable data.
  1029. If the Hadoop native libraries are not available, this configuration
  1030. has no effect.
  1031. </description>
  1032. </property>
  1033. <property>
  1034. <name>dfs.datanode.drop.cache.behind.writes</name>
  1035. <value>false</value>
  1036. <description>
  1037. In some workloads, the data written to HDFS is known to be significantly
  1038. large enough that it is unlikely to be useful to cache it in the
  1039. operating system buffer cache. In this case, the DataNode may be
  1040. configured to automatically purge all data from the buffer cache
  1041. after it is written to disk.
  1042. This may improve performance for some workloads by freeing buffer
  1043. cache space usage for more cacheable data.
  1044. If the Hadoop native libraries are not available, this configuration
  1045. has no effect.
  1046. </description>
  1047. </property>
  1048. <property>
  1049. <name>dfs.datanode.sync.behind.writes</name>
  1050. <value>false</value>
  1051. <description>
  1052. If this configuration is enabled, the datanode will instruct the
  1053. operating system to enqueue all written data to the disk immediately
  1054. after it is written. This differs from the usual OS policy which
  1055. may wait for up to 30 seconds before triggering writeback.
  1056. This may improve performance for some workloads by smoothing the
  1057. IO profile for data written to disk.
  1058. If the Hadoop native libraries are not available, this configuration
  1059. has no effect.
  1060. </description>
  1061. </property>
  1062. <property>
  1063. <name>dfs.client.failover.max.attempts</name>
  1064. <value>15</value>
  1065. <description>
  1066. Expert only. The number of client failover attempts that should be
  1067. made before the failover is considered failed.
  1068. </description>
  1069. </property>
  1070. <property>
  1071. <name>dfs.client.failover.sleep.base.millis</name>
  1072. <value>500</value>
  1073. <description>
  1074. Expert only. The time to wait, in milliseconds, between failover
  1075. attempts increases exponentially as a function of the number of
  1076. attempts made so far, with a random factor of +/- 50%. This option
  1077. specifies the base value used in the failover calculation. The
  1078. first failover will retry immediately. The 2nd failover attempt
  1079. will delay at least dfs.client.failover.sleep.base.millis
  1080. milliseconds. And so on.
  1081. </description>
  1082. </property>
  1083. <property>
  1084. <name>dfs.client.failover.sleep.max.millis</name>
  1085. <value>15000</value>
  1086. <description>
  1087. Expert only. The time to wait, in milliseconds, between failover
  1088. attempts increases exponentially as a function of the number of
  1089. attempts made so far, with a random factor of +/- 50%. This option
  1090. specifies the maximum value to wait between failovers.
  1091. Specifically, the time between two failover attempts will not
  1092. exceed +/- 50% of dfs.client.failover.sleep.max.millis
  1093. milliseconds.
  1094. </description>
  1095. </property>
  1096. <property>
  1097. <name>dfs.client.failover.connection.retries</name>
  1098. <value>0</value>
  1099. <description>
  1100. Expert only. Indicates the number of retries a failover IPC client
  1101. will make to establish a server connection.
  1102. </description>
  1103. </property>
  1104. <property>
  1105. <name>dfs.client.failover.connection.retries.on.timeouts</name>
  1106. <value>0</value>
  1107. <description>
  1108. Expert only. The number of retry attempts a failover IPC client
  1109. will make on socket timeout when establishing a server connection.
  1110. </description>
  1111. </property>
  1112. <property>
  1113. <name>dfs.client.datanode-restart.timeout</name>
  1114. <value>30</value>
  1115. <description>
  1116. Expert only. The time to wait, in seconds, from reception of an
  1117. datanode shutdown notification for quick restart, until declaring
  1118. the datanode dead and invoking the normal recovery mechanisms.
  1119. The notification is sent by a datanode when it is being shutdown
  1120. using the shutdownDatanode admin command with the upgrade option.
  1121. </description>
  1122. </property>
  1123. <property>
  1124. <name>dfs.nameservices</name>
  1125. <value></value>
  1126. <description>
  1127. Comma-separated list of nameservices.
  1128. </description>
  1129. </property>
  1130. <property>
  1131. <name>dfs.nameservice.id</name>
  1132. <value></value>
  1133. <description>
  1134. The ID of this nameservice. If the nameservice ID is not
  1135. configured or more than one nameservice is configured for
  1136. dfs.nameservices it is determined automatically by
  1137. matching the local node's address with the configured address.
  1138. </description>
  1139. </property>
  1140. <property>
  1141. <name>dfs.internal.nameservices</name>
  1142. <value></value>
  1143. <description>
  1144. Comma-separated list of nameservices that belong to this cluster.
  1145. Datanode will report to all the nameservices in this list. By default
  1146. this is set to the value of dfs.nameservices.
  1147. </description>
  1148. </property>
  1149. <property>
  1150. <name>dfs.ha.namenodes.EXAMPLENAMESERVICE</name>
  1151. <value></value>
  1152. <description>
  1153. The prefix for a given nameservice, contains a comma-separated
  1154. list of namenodes for a given nameservice (eg EXAMPLENAMESERVICE).
  1155. </description>
  1156. </property>
  1157. <property>
  1158. <name>dfs.ha.namenode.id</name>
  1159. <value></value>
  1160. <description>
  1161. The ID of this namenode. If the namenode ID is not configured it
  1162. is determined automatically by matching the local node's address
  1163. with the configured address.
  1164. </description>
  1165. </property>
  1166. <property>
  1167. <name>dfs.ha.log-roll.period</name>
  1168. <value>120</value>
  1169. <description>
  1170. How often, in seconds, the StandbyNode should ask the active to
  1171. roll edit logs. Since the StandbyNode only reads from finalized
  1172. log segments, the StandbyNode will only be as up-to-date as how
  1173. often the logs are rolled. Note that failover triggers a log roll
  1174. so the StandbyNode will be up to date before it becomes active.
  1175. </description>
  1176. </property>
  1177. <property>
  1178. <name>dfs.ha.tail-edits.period</name>
  1179. <value>60</value>
  1180. <description>
  1181. How often, in seconds, the StandbyNode should check for new
  1182. finalized log segments in the shared edits log.
  1183. </description>
  1184. </property>
  1185. <property>
  1186. <name>dfs.ha.tail-edits.namenode-retries</name>
  1187. <value>3</value>
  1188. <description>
  1189. Number of retries to use when contacting the namenode when tailing the log.
  1190. </description>
  1191. </property>
  1192. <property>
  1193. <name>dfs.ha.automatic-failover.enabled</name>
  1194. <value>false</value>
  1195. <description>
  1196. Whether automatic failover is enabled. See the HDFS High
  1197. Availability documentation for details on automatic HA
  1198. configuration.
  1199. </description>
  1200. </property>
  1201. <property>
  1202. <name>dfs.client.use.datanode.hostname</name>
  1203. <value>false</value>
  1204. <description>Whether clients should use datanode hostnames when
  1205. connecting to datanodes.
  1206. </description>
  1207. </property>
  1208. <property>
  1209. <name>dfs.datanode.use.datanode.hostname</name>
  1210. <value>false</value>
  1211. <description>Whether datanodes should use datanode hostnames when
  1212. connecting to other datanodes for data transfer.
  1213. </description>
  1214. </property>
  1215. <property>
  1216. <name>dfs.client.local.interfaces</name>
  1217. <value></value>
  1218. <description>A comma separated list of network interface names to use
  1219. for data transfer between the client and datanodes. When creating
  1220. a connection to read from or write to a datanode, the client
  1221. chooses one of the specified interfaces at random and binds its
  1222. socket to the IP of that interface. Individual names may be
  1223. specified as either an interface name (eg "eth0"), a subinterface
  1224. name (eg "eth0:0"), or an IP address (which may be specified using
  1225. CIDR notation to match a range of IPs).
  1226. </description>
  1227. </property>
  1228. <property>
  1229. <name>dfs.datanode.shared.file.descriptor.paths</name>
  1230. <value>/dev/shm,/tmp</value>
  1231. <description>
  1232. A comma-separated list of paths to use when creating file descriptors that
  1233. will be shared between the DataNode and the DFSClient. Typically we use
  1234. /dev/shm, so that the file descriptors will not be written to disk.
  1235. Systems that don't have /dev/shm will fall back to /tmp by default.
  1236. </description>
  1237. </property>
  1238. <property>
  1239. <name>dfs.short.circuit.shared.memory.watcher.interrupt.check.ms</name>
  1240. <value>60000</value>
  1241. <description>
  1242. The length of time in milliseconds that the short-circuit shared memory
  1243. watcher will go between checking for java interruptions sent from other
  1244. threads. This is provided mainly for unit tests.
  1245. </description>
  1246. </property>
  1247. <property>
  1248. <name>dfs.namenode.kerberos.internal.spnego.principal</name>
  1249. <value>${dfs.web.authentication.kerberos.principal}</value>
  1250. </property>
  1251. <property>
  1252. <name>dfs.secondary.namenode.kerberos.internal.spnego.principal</name>
  1253. <value>${dfs.web.authentication.kerberos.principal}</value>
  1254. </property>
  1255. <property>
  1256. <name>dfs.namenode.kerberos.principal.pattern</name>
  1257. <value>*</value>
  1258. <description>
  1259. A client-side RegEx that can be configured to control
  1260. allowed realms to authenticate with (useful in cross-realm env.)
  1261. </description>
  1262. </property>
  1263. <property>
  1264. <name>dfs.namenode.avoid.read.stale.datanode</name>
  1265. <value>false</value>
  1266. <description>
  1267. Indicate whether or not to avoid reading from &quot;stale&quot; datanodes whose
  1268. heartbeat messages have not been received by the namenode
  1269. for more than a specified time interval. Stale datanodes will be
  1270. moved to the end of the node list returned for reading. See
  1271. dfs.namenode.avoid.write.stale.datanode for a similar setting for writes.
  1272. </description>
  1273. </property>
  1274. <property>
  1275. <name>dfs.namenode.avoid.write.stale.datanode</name>
  1276. <value>false</value>
  1277. <description>
  1278. Indicate whether or not to avoid writing to &quot;stale&quot; datanodes whose
  1279. heartbeat messages have not been received by the namenode
  1280. for more than a specified time interval. Writes will avoid using
  1281. stale datanodes unless more than a configured ratio
  1282. (dfs.namenode.write.stale.datanode.ratio) of datanodes are marked as
  1283. stale. See dfs.namenode.avoid.read.stale.datanode for a similar setting
  1284. for reads.
  1285. </description>
  1286. </property>
  1287. <property>
  1288. <name>dfs.namenode.stale.datanode.interval</name>
  1289. <value>30000</value>
  1290. <description>
  1291. Default time interval for marking a datanode as "stale", i.e., if
  1292. the namenode has not received heartbeat msg from a datanode for
  1293. more than this time interval, the datanode will be marked and treated
  1294. as "stale" by default. The stale interval cannot be too small since
  1295. otherwise this may cause too frequent change of stale states.
  1296. We thus set a minimum stale interval value (the default value is 3 times
  1297. of heartbeat interval) and guarantee that the stale interval cannot be less
  1298. than the minimum value. A stale data node is avoided during lease/block
  1299. recovery. It can be conditionally avoided for reads (see
  1300. dfs.namenode.avoid.read.stale.datanode) and for writes (see
  1301. dfs.namenode.avoid.write.stale.datanode).
  1302. </description>
  1303. </property>
  1304. <property>
  1305. <name>dfs.namenode.write.stale.datanode.ratio</name>
  1306. <value>0.5f</value>
  1307. <description>
  1308. When the ratio of number stale datanodes to total datanodes marked
  1309. is greater than this ratio, stop avoiding writing to stale nodes so
  1310. as to prevent causing hotspots.
  1311. </description>
  1312. </property>
  1313. <property>
  1314. <name>dfs.namenode.invalidate.work.pct.per.iteration</name>
  1315. <value>0.32f</value>
  1316. <description>
  1317. *Note*: Advanced property. Change with caution.
  1318. This determines the percentage amount of block
  1319. invalidations (deletes) to do over a single DN heartbeat
  1320. deletion command. The final deletion count is determined by applying this
  1321. percentage to the number of live nodes in the system.
  1322. The resultant number is the number of blocks from the deletion list
  1323. chosen for proper invalidation over a single heartbeat of a single DN.
  1324. Value should be a positive, non-zero percentage in float notation (X.Yf),
  1325. with 1.0f meaning 100%.
  1326. </description>
  1327. </property>
  1328. <property>
  1329. <name>dfs.namenode.replication.work.multiplier.per.iteration</name>
  1330. <value>2</value>
  1331. <description>
  1332. *Note*: Advanced property. Change with caution.
  1333. This determines the total amount of block transfers to begin in
  1334. parallel at a DN, for replication, when such a command list is being
  1335. sent over a DN heartbeat by the NN. The actual number is obtained by
  1336. multiplying this multiplier with the total number of live nodes in the
  1337. cluster. The result number is the number of blocks to begin transfers
  1338. immediately for, per DN heartbeat. This number can be any positive,
  1339. non-zero integer.
  1340. </description>
  1341. </property>
  1342. <property>
  1343. <name>nfs.server.port</name>
  1344. <value>2049</value>
  1345. <description>
  1346. Specify the port number used by Hadoop NFS.
  1347. </description>
  1348. </property>
  1349. <property>
  1350. <name>nfs.mountd.port</name>
  1351. <value>4242</value>
  1352. <description>
  1353. Specify the port number used by Hadoop mount daemon.
  1354. </description>
  1355. </property>
  1356. <property>
  1357. <name>nfs.dump.dir</name>
  1358. <value>/tmp/.hdfs-nfs</value>
  1359. <description>
  1360. This directory is used to temporarily save out-of-order writes before
  1361. writing to HDFS. For each file, the out-of-order writes are dumped after
  1362. they are accumulated to exceed certain threshold (e.g., 1MB) in memory.
  1363. One needs to make sure the directory has enough space.
  1364. </description>
  1365. </property>
  1366. <property>
  1367. <name>nfs.rtmax</name>
  1368. <value>1048576</value>
  1369. <description>This is the maximum size in bytes of a READ request
  1370. supported by the NFS gateway. If you change this, make sure you
  1371. also update the nfs mount's rsize(add rsize= # of bytes to the
  1372. mount directive).
  1373. </description>
  1374. </property>
  1375. <property>
  1376. <name>nfs.wtmax</name>
  1377. <value>1048576</value>
  1378. <description>This is the maximum size in bytes of a WRITE request
  1379. supported by the NFS gateway. If you change this, make sure you
  1380. also update the nfs mount's wsize(add wsize= # of bytes to the
  1381. mount directive).
  1382. </description>
  1383. </property>
  1384. <property>
  1385. <name>nfs.keytab.file</name>
  1386. <value></value>
  1387. <description>
  1388. *Note*: Advanced property. Change with caution.
  1389. This is the path to the keytab file for the hdfs-nfs gateway.
  1390. This is required when the cluster is kerberized.
  1391. </description>
  1392. </property>
  1393. <property>
  1394. <name>nfs.kerberos.principal</name>
  1395. <value></value>
  1396. <description>
  1397. *Note*: Advanced property. Change with caution.
  1398. This is the name of the kerberos principal. This is required when
  1399. the cluster is kerberized.It must be of this format:
  1400. nfs-gateway-user/nfs-gateway-host@kerberos-realm
  1401. </description>
  1402. </property>
  1403. <property>
  1404. <name>nfs.allow.insecure.ports</name>
  1405. <value>true</value>
  1406. <description>
  1407. When set to false, client connections originating from unprivileged ports
  1408. (those above 1023) will be rejected. This is to ensure that clients
  1409. connecting to this NFS Gateway must have had root privilege on the machine
  1410. where they're connecting from.
  1411. </description>
  1412. </property>
  1413. <property>
  1414. <name>hadoop.fuse.connection.timeout</name>
  1415. <value>300</value>
  1416. <description>
  1417. The minimum number of seconds that we'll cache libhdfs connection objects
  1418. in fuse_dfs. Lower values will result in lower memory consumption; higher
  1419. values may speed up access by avoiding the overhead of creating new
  1420. connection objects.
  1421. </description>
  1422. </property>
  1423. <property>
  1424. <name>hadoop.fuse.timer.period</name>
  1425. <value>5</value>
  1426. <description>
  1427. The number of seconds between cache expiry checks in fuse_dfs. Lower values
  1428. will result in fuse_dfs noticing changes to Kerberos ticket caches more
  1429. quickly.
  1430. </description>
  1431. </property>
  1432. <property>
  1433. <name>dfs.namenode.metrics.logger.period.seconds</name>
  1434. <value>600</value>
  1435. <description>
  1436. This setting controls how frequently the NameNode logs its metrics. The
  1437. logging configuration must also define one or more appenders for
  1438. NameNodeMetricsLog for the metrics to be logged.
  1439. NameNode metrics logging is disabled if this value is set to zero or
  1440. less than zero.
  1441. </description>
  1442. </property>
  1443. <property>
  1444. <name>dfs.datanode.metrics.logger.period.seconds</name>
  1445. <value>600</value>
  1446. <description>
  1447. This setting controls how frequently the DataNode logs its metrics. The
  1448. logging configuration must also define one or more appenders for
  1449. DataNodeMetricsLog for the metrics to be logged.
  1450. DataNode metrics logging is disabled if this value is set to zero or
  1451. less than zero.
  1452. </description>
  1453. </property>
  1454. <property>
  1455. <name>dfs.metrics.percentiles.intervals</name>
  1456. <value></value>
  1457. <description>
  1458. Comma-delimited set of integers denoting the desired rollover intervals
  1459. (in seconds) for percentile latency metrics on the Namenode and Datanode.
  1460. By default, percentile latency metrics are disabled.
  1461. </description>
  1462. </property>
  1463. <property>
  1464. <name>hadoop.user.group.metrics.percentiles.intervals</name>
  1465. <value></value>
  1466. <description>
  1467. A comma-separated list of the granularity in seconds for the metrics
  1468. which describe the 50/75/90/95/99th percentile latency for group resolution
  1469. in milliseconds.
  1470. By default, percentile latency metrics are disabled.
  1471. </description>
  1472. </property>
  1473. <property>
  1474. <name>dfs.encrypt.data.transfer</name>
  1475. <value>false</value>
  1476. <description>
  1477. Whether or not actual block data that is read/written from/to HDFS should
  1478. be encrypted on the wire. This only needs to be set on the NN and DNs,
  1479. clients will deduce this automatically. It is possible to override this setting
  1480. per connection by specifying custom logic via dfs.trustedchannel.resolver.class.
  1481. </description>
  1482. </property>
  1483. <property>
  1484. <name>dfs.encrypt.data.transfer.algorithm</name>
  1485. <value></value>
  1486. <description>
  1487. This value may be set to either "3des" or "rc4". If nothing is set, then
  1488. the configured JCE default on the system is used (usually 3DES.) It is
  1489. widely believed that 3DES is more cryptographically secure, but RC4 is
  1490. substantially faster.
  1491. Note that if AES is supported by both the client and server then this
  1492. encryption algorithm will only be used to initially transfer keys for AES.
  1493. (See dfs.encrypt.data.transfer.cipher.suites.)
  1494. </description>
  1495. </property>
  1496. <property>
  1497. <name>dfs.encrypt.data.transfer.cipher.suites</name>
  1498. <value></value>
  1499. <description>
  1500. This value may be either undefined or AES/CTR/NoPadding. If defined, then
  1501. dfs.encrypt.data.transfer uses the specified cipher suite for data
  1502. encryption. If not defined, then only the algorithm specified in
  1503. dfs.encrypt.data.transfer.algorithm is used. By default, the property is
  1504. not defined.
  1505. </description>
  1506. </property>
  1507. <property>
  1508. <name>dfs.encrypt.data.transfer.cipher.key.bitlength</name>
  1509. <value>128</value>
  1510. <description>
  1511. The key bitlength negotiated by dfsclient and datanode for encryption.
  1512. This value may be set to either 128, 192 or 256.
  1513. </description>
  1514. </property>
  1515. <property>
  1516. <name>dfs.trustedchannel.resolver.class</name>
  1517. <value></value>
  1518. <description>
  1519. TrustedChannelResolver is used to determine whether a channel
  1520. is trusted for plain data transfer. The TrustedChannelResolver is
  1521. invoked on both client and server side. If the resolver indicates
  1522. that the channel is trusted, then the data transfer will not be
  1523. encrypted even if dfs.encrypt.data.transfer is set to true. The
  1524. default implementation returns false indicating that the channel
  1525. is not trusted.
  1526. </description>
  1527. </property>
  1528. <property>
  1529. <name>dfs.data.transfer.protection</name>
  1530. <value></value>
  1531. <description>
  1532. A comma-separated list of SASL protection values used for secured
  1533. connections to the DataNode when reading or writing block data. Possible
  1534. values are authentication, integrity and privacy. authentication means
  1535. authentication only and no integrity or privacy; integrity implies
  1536. authentication and integrity are enabled; and privacy implies all of
  1537. authentication, integrity and privacy are enabled. If
  1538. dfs.encrypt.data.transfer is set to true, then it supersedes the setting for
  1539. dfs.data.transfer.protection and enforces that all connections must use a
  1540. specialized encrypted SASL handshake. This property is ignored for
  1541. connections to a DataNode listening on a privileged port. In this case, it
  1542. is assumed that the use of a privileged port establishes sufficient trust.
  1543. </description>
  1544. </property>
  1545. <property>
  1546. <name>dfs.data.transfer.saslproperties.resolver.class</name>
  1547. <value></value>
  1548. <description>
  1549. SaslPropertiesResolver used to resolve the QOP used for a connection to the
  1550. DataNode when reading or writing block data. If not specified, the value of
  1551. hadoop.security.saslproperties.resolver.class is used as the default value.
  1552. </description>
  1553. </property>
  1554. <property>
  1555. <name>dfs.journalnode.rpc-address</name>
  1556. <value>0.0.0.0:8485</value>
  1557. <description>
  1558. The JournalNode RPC server address and port.
  1559. </description>
  1560. </property>
  1561. <property>
  1562. <name>dfs.journalnode.http-address</name>
  1563. <value>0.0.0.0:8480</value>
  1564. <description>
  1565. The address and port the JournalNode HTTP server listens on.
  1566. If the port is 0 then the server will start on a free port.
  1567. </description>
  1568. </property>
  1569. <property>
  1570. <name>dfs.journalnode.https-address</name>
  1571. <value>0.0.0.0:8481</value>
  1572. <description>
  1573. The address and port the JournalNode HTTPS server listens on.
  1574. If the port is 0 then the server will start on a free port.
  1575. </description>
  1576. </property>
  1577. <property>
  1578. <name>dfs.namenode.audit.loggers</name>
  1579. <value>default</value>
  1580. <description>
  1581. List of classes implementing audit loggers that will receive audit events.
  1582. These should be implementations of org.apache.hadoop.hdfs.server.namenode.AuditLogger.
  1583. The special value "default" can be used to reference the default audit
  1584. logger, which uses the configured log system. Installing custom audit loggers
  1585. may affect the performance and stability of the NameNode. Refer to the custom
  1586. logger's documentation for more details.
  1587. </description>
  1588. </property>
  1589. <property>
  1590. <name>dfs.datanode.available-space-volume-choosing-policy.balanced-space-threshold</name>
  1591. <value>10737418240</value> <!-- 10 GB -->
  1592. <description>
  1593. Only used when the dfs.datanode.fsdataset.volume.choosing.policy is set to
  1594. org.apache.hadoop.hdfs.server.datanode.fsdataset.AvailableSpaceVolumeChoosingPolicy.
  1595. This setting controls how much DN volumes are allowed to differ in terms of
  1596. bytes of free disk space before they are considered imbalanced. If the free
  1597. space of all the volumes are within this range of each other, the volumes
  1598. will be considered balanced and block assignments will be done on a pure
  1599. round robin basis.
  1600. </description>
  1601. </property>
  1602. <property>
  1603. <name>dfs.datanode.available-space-volume-choosing-policy.balanced-space-preference-fraction</name>
  1604. <value>0.75f</value>
  1605. <description>
  1606. Only used when the dfs.datanode.fsdataset.volume.choosing.policy is set to
  1607. org.apache.hadoop.hdfs.server.datanode.fsdataset.AvailableSpaceVolumeChoosingPolicy.
  1608. This setting controls what percentage of new block allocations will be sent
  1609. to volumes with more available disk space than others. This setting should
  1610. be in the range 0.0 - 1.0, though in practice 0.5 - 1.0, since there should
  1611. be no reason to prefer that volumes with less available disk space receive
  1612. more block allocations.
  1613. </description>
  1614. </property>
  1615. <property>
  1616. <name>dfs.namenode.edits.noeditlogchannelflush</name>
  1617. <value>false</value>
  1618. <description>
  1619. Specifies whether to flush edit log file channel. When set, expensive
  1620. FileChannel#force calls are skipped and synchronous disk writes are
  1621. enabled instead by opening the edit log file with RandomAccessFile("rws")
  1622. flags. This can significantly improve the performance of edit log writes
  1623. on the Windows platform.
  1624. Note that the behavior of the "rws" flags is platform and hardware specific
  1625. and might not provide the same level of guarantees as FileChannel#force.
  1626. For example, the write will skip the disk-cache on SAS and SCSI devices
  1627. while it might not on SATA devices. This is an expert level setting,
  1628. change with caution.
  1629. </description>
  1630. </property>
  1631. <property>
  1632. <name>dfs.client.cache.drop.behind.writes</name>
  1633. <value></value>
  1634. <description>
  1635. Just like dfs.datanode.drop.cache.behind.writes, this setting causes the
  1636. page cache to be dropped behind HDFS writes, potentially freeing up more
  1637. memory for other uses. Unlike dfs.datanode.drop.cache.behind.writes, this
  1638. is a client-side setting rather than a setting for the entire datanode.
  1639. If present, this setting will override the DataNode default.
  1640. If the native libraries are not available to the DataNode, this
  1641. configuration has no effect.
  1642. </description>
  1643. </property>
  1644. <property>
  1645. <name>dfs.client.cache.drop.behind.reads</name>
  1646. <value></value>
  1647. <description>
  1648. Just like dfs.datanode.drop.cache.behind.reads, this setting causes the
  1649. page cache to be dropped behind HDFS reads, potentially freeing up more
  1650. memory for other uses. Unlike dfs.datanode.drop.cache.behind.reads, this
  1651. is a client-side setting rather than a setting for the entire datanode. If
  1652. present, this setting will override the DataNode default.
  1653. If the native libraries are not available to the DataNode, this
  1654. configuration has no effect.
  1655. </description>
  1656. </property>
  1657. <property>
  1658. <name>dfs.client.cache.readahead</name>
  1659. <value></value>
  1660. <description>
  1661. When using remote reads, this setting causes the datanode to
  1662. read ahead in the block file using posix_fadvise, potentially decreasing
  1663. I/O wait times. Unlike dfs.datanode.readahead.bytes, this is a client-side
  1664. setting rather than a setting for the entire datanode. If present, this
  1665. setting will override the DataNode default.
  1666. When using local reads, this setting determines how much readahead we do in
  1667. BlockReaderLocal.
  1668. If the native libraries are not available to the DataNode, this
  1669. configuration has no effect.
  1670. </description>
  1671. </property>
  1672. <property>
  1673. <name>dfs.namenode.enable.retrycache</name>
  1674. <value>true</value>
  1675. <description>
  1676. This enables the retry cache on the namenode. Namenode tracks for
  1677. non-idempotent requests the corresponding response. If a client retries the
  1678. request, the response from the retry cache is sent. Such operations
  1679. are tagged with annotation @AtMostOnce in namenode protocols. It is
  1680. recommended that this flag be set to true. Setting it to false, will result
  1681. in clients getting failure responses to retried request. This flag must
  1682. be enabled in HA setup for transparent fail-overs.
  1683. The entries in the cache have expiration time configurable
  1684. using dfs.namenode.retrycache.expirytime.millis.
  1685. </description>
  1686. </property>
  1687. <property>
  1688. <name>dfs.namenode.retrycache.expirytime.millis</name>
  1689. <value>600000</value>
  1690. <description>
  1691. The time for which retry cache entries are retained.
  1692. </description>
  1693. </property>
  1694. <property>
  1695. <name>dfs.namenode.retrycache.heap.percent</name>
  1696. <value>0.03f</value>
  1697. <description>
  1698. This parameter configures the heap size allocated for retry cache
  1699. (excluding the response cached). This corresponds to approximately
  1700. 4096 entries for every 64MB of namenode process java heap size.
  1701. Assuming retry cache entry expiration time (configured using
  1702. dfs.namenode.retrycache.expirytime.millis) of 10 minutes, this
  1703. enables retry cache to support 7 operations per second sustained
  1704. for 10 minutes. As the heap size is increased, the operation rate
  1705. linearly increases.
  1706. </description>
  1707. </property>
  1708. <property>
  1709. <name>dfs.client.mmap.enabled</name>
  1710. <value>true</value>
  1711. <description>
  1712. If this is set to false, the client won't attempt to perform memory-mapped reads.
  1713. </description>
  1714. </property>
  1715. <property>
  1716. <name>dfs.client.mmap.cache.size</name>
  1717. <value>256</value>
  1718. <description>
  1719. When zero-copy reads are used, the DFSClient keeps a cache of recently used
  1720. memory mapped regions. This parameter controls the maximum number of
  1721. entries that we will keep in that cache.
  1722. The larger this number is, the more file descriptors we will potentially
  1723. use for memory-mapped files. mmaped files also use virtual address space.
  1724. You may need to increase your ulimit virtual address space limits before
  1725. increasing the client mmap cache size.
  1726. Note that you can still do zero-copy reads when this size is set to 0.
  1727. </description>
  1728. </property>
  1729. <property>
  1730. <name>dfs.client.mmap.cache.timeout.ms</name>
  1731. <value>3600000</value>
  1732. <description>
  1733. The minimum length of time that we will keep an mmap entry in the cache
  1734. between uses. If an entry is in the cache longer than this, and nobody
  1735. uses it, it will be removed by a background thread.
  1736. </description>
  1737. </property>
  1738. <property>
  1739. <name>dfs.client.mmap.retry.timeout.ms</name>
  1740. <value>300000</value>
  1741. <description>
  1742. The minimum amount of time that we will wait before retrying a failed mmap
  1743. operation.
  1744. </description>
  1745. </property>
  1746. <property>
  1747. <name>dfs.client.short.circuit.replica.stale.threshold.ms</name>
  1748. <value>1800000</value>
  1749. <description>
  1750. The maximum amount of time that we will consider a short-circuit replica to
  1751. be valid, if there is no communication from the DataNode. After this time
  1752. has elapsed, we will re-fetch the short-circuit replica even if it is in
  1753. the cache.
  1754. </description>
  1755. </property>
  1756. <property>
  1757. <name>dfs.namenode.path.based.cache.block.map.allocation.percent</name>
  1758. <value>0.25</value>
  1759. <description>
  1760. The percentage of the Java heap which we will allocate to the cached blocks
  1761. map. The cached blocks map is a hash map which uses chained hashing.
  1762. Smaller maps may be accessed more slowly if the number of cached blocks is
  1763. large; larger maps will consume more memory.
  1764. </description>
  1765. </property>
  1766. <property>
  1767. <name>dfs.datanode.max.locked.memory</name>
  1768. <value>0</value>
  1769. <description>
  1770. The amount of memory in bytes to use for caching of block replicas in
  1771. memory on the datanode. The datanode's maximum locked memory soft ulimit
  1772. (RLIMIT_MEMLOCK) must be set to at least this value, else the datanode
  1773. will abort on startup.
  1774. By default, this parameter is set to 0, which disables in-memory caching.
  1775. If the native libraries are not available to the DataNode, this
  1776. configuration has no effect.
  1777. </description>
  1778. </property>
  1779. <property>
  1780. <name>dfs.namenode.list.cache.directives.num.responses</name>
  1781. <value>100</value>
  1782. <description>
  1783. This value controls the number of cache directives that the NameNode will
  1784. send over the wire in response to a listDirectives RPC.
  1785. </description>
  1786. </property>
  1787. <property>
  1788. <name>dfs.namenode.list.cache.pools.num.responses</name>
  1789. <value>100</value>
  1790. <description>
  1791. This value controls the number of cache pools that the NameNode will
  1792. send over the wire in response to a listPools RPC.
  1793. </description>
  1794. </property>
  1795. <property>
  1796. <name>dfs.namenode.path.based.cache.refresh.interval.ms</name>
  1797. <value>30000</value>
  1798. <description>
  1799. The amount of milliseconds between subsequent path cache rescans. Path
  1800. cache rescans are when we calculate which blocks should be cached, and on
  1801. what datanodes.
  1802. By default, this parameter is set to 30 seconds.
  1803. </description>
  1804. </property>
  1805. <property>
  1806. <name>dfs.namenode.path.based.cache.retry.interval.ms</name>
  1807. <value>30000</value>
  1808. <description>
  1809. When the NameNode needs to uncache something that is cached, or cache
  1810. something that is not cached, it must direct the DataNodes to do so by
  1811. sending a DNA_CACHE or DNA_UNCACHE command in response to a DataNode
  1812. heartbeat. This parameter controls how frequently the NameNode will
  1813. resend these commands.
  1814. </description>
  1815. </property>
  1816. <property>
  1817. <name>dfs.datanode.fsdatasetcache.max.threads.per.volume</name>
  1818. <value>4</value>
  1819. <description>
  1820. The maximum number of threads per volume to use for caching new data
  1821. on the datanode. These threads consume both I/O and CPU. This can affect
  1822. normal datanode operations.
  1823. </description>
  1824. </property>
  1825. <property>
  1826. <name>dfs.cachereport.intervalMsec</name>
  1827. <value>10000</value>
  1828. <description>
  1829. Determines cache reporting interval in milliseconds. After this amount of
  1830. time, the DataNode sends a full report of its cache state to the NameNode.
  1831. The NameNode uses the cache report to update its map of cached blocks to
  1832. DataNode locations.
  1833. This configuration has no effect if in-memory caching has been disabled by
  1834. setting dfs.datanode.max.locked.memory to 0 (which is the default).
  1835. If the native libraries are not available to the DataNode, this
  1836. configuration has no effect.
  1837. </description>
  1838. </property>
  1839. <property>
  1840. <name>dfs.namenode.edit.log.autoroll.multiplier.threshold</name>
  1841. <value>2.0</value>
  1842. <description>
  1843. Determines when an active namenode will roll its own edit log.
  1844. The actual threshold (in number of edits) is determined by multiplying
  1845. this value by dfs.namenode.checkpoint.txns.
  1846. This prevents extremely large edit files from accumulating on the active
  1847. namenode, which can cause timeouts during namenode startup and pose an
  1848. administrative hassle. This behavior is intended as a failsafe for when
  1849. the standby or secondary namenode fail to roll the edit log by the normal
  1850. checkpoint threshold.
  1851. </description>
  1852. </property>
  1853. <property>
  1854. <name>dfs.namenode.edit.log.autoroll.check.interval.ms</name>
  1855. <value>300000</value>
  1856. <description>
  1857. How often an active namenode will check if it needs to roll its edit log,
  1858. in milliseconds.
  1859. </description>
  1860. </property>
  1861. <property>
  1862. <name>dfs.webhdfs.user.provider.user.pattern</name>
  1863. <value>^[A-Za-z_][A-Za-z0-9._-]*[$]?$</value>
  1864. <description>
  1865. Valid pattern for user and group names for webhdfs, it must be a valid java regex.
  1866. </description>
  1867. </property>
  1868. <property>
  1869. <name>dfs.client.context</name>
  1870. <value>default</value>
  1871. <description>
  1872. The name of the DFSClient context that we should use. Clients that share
  1873. a context share a socket cache and short-circuit cache, among other things.
  1874. You should only change this if you don't want to share with another set of
  1875. threads.
  1876. </description>
  1877. </property>
  1878. <property>
  1879. <name>dfs.client.read.shortcircuit</name>
  1880. <value>false</value>
  1881. <description>
  1882. This configuration parameter turns on short-circuit local reads.
  1883. </description>
  1884. </property>
  1885. <property>
  1886. <name>dfs.domain.socket.path</name>
  1887. <value></value>
  1888. <description>
  1889. Optional. This is a path to a UNIX domain socket that will be used for
  1890. communication between the DataNode and local HDFS clients.
  1891. If the string "_PORT" is present in this path, it will be replaced by the
  1892. TCP port of the DataNode.
  1893. </description>
  1894. </property>
  1895. <property>
  1896. <name>dfs.client.read.shortcircuit.skip.checksum</name>
  1897. <value>false</value>
  1898. <description>
  1899. If this configuration parameter is set,
  1900. short-circuit local reads will skip checksums.
  1901. This is normally not recommended,
  1902. but it may be useful for special setups.
  1903. You might consider using this
  1904. if you are doing your own checksumming outside of HDFS.
  1905. </description>
  1906. </property>
  1907. <property>
  1908. <name>dfs.client.read.shortcircuit.streams.cache.size</name>
  1909. <value>256</value>
  1910. <description>
  1911. The DFSClient maintains a cache of recently opened file descriptors.
  1912. This parameter controls the maximum number of file descriptors in the cache.
  1913. Setting this higher will use more file descriptors,
  1914. but potentially provide better performance on workloads
  1915. involving lots of seeks.
  1916. </description>
  1917. </property>
  1918. <property>
  1919. <name>dfs.client.read.shortcircuit.streams.cache.expiry.ms</name>
  1920. <value>300000</value>
  1921. <description>
  1922. This controls the minimum amount of time
  1923. file descriptors need to sit in the client cache context
  1924. before they can be closed for being inactive for too long.
  1925. </description>
  1926. </property>
  1927. <property>
  1928. <name>dfs.datanode.shared.file.descriptor.paths</name>
  1929. <value>/dev/shm,/tmp</value>
  1930. <description>
  1931. Comma separated paths to the directory on which
  1932. shared memory segments are created.
  1933. The client and the DataNode exchange information via
  1934. this shared memory segment.
  1935. It tries paths in order until creation of shared memory segment succeeds.
  1936. </description>
  1937. </property>
  1938. <property>
  1939. <name>dfs.namenode.audit.log.debug.cmdlist</name>
  1940. <value></value>
  1941. <description>
  1942. A comma separated list of NameNode commands that are written to the HDFS
  1943. namenode audit log only if the audit log level is debug.
  1944. </description>
  1945. </property>
  1946. <property>
  1947. <name>dfs.client.use.legacy.blockreader.local</name>
  1948. <value>false</value>
  1949. <description>
  1950. Legacy short-circuit reader implementation based on HDFS-2246 is used
  1951. if this configuration parameter is true.
  1952. This is for the platforms other than Linux
  1953. where the new implementation based on HDFS-347 is not available.
  1954. </description>
  1955. </property>
  1956. <property>
  1957. <name>dfs.block.local-path-access.user</name>
  1958. <value></value>
  1959. <description>
  1960. Comma separated list of the users allowd to open block files
  1961. on legacy short-circuit local read.
  1962. </description>
  1963. </property>
  1964. <property>
  1965. <name>dfs.client.domain.socket.data.traffic</name>
  1966. <value>false</value>
  1967. <description>
  1968. This control whether we will try to pass normal data traffic
  1969. over UNIX domain socket rather than over TCP socket
  1970. on node-local data transfer.
  1971. This is currently experimental and turned off by default.
  1972. </description>
  1973. </property>
  1974. <property>
  1975. <name>dfs.namenode.reject-unresolved-dn-topology-mapping</name>
  1976. <value>false</value>
  1977. <description>
  1978. If the value is set to true, then namenode will reject datanode
  1979. registration if the topology mapping for a datanode is not resolved and
  1980. NULL is returned (script defined by net.topology.script.file.name fails
  1981. to execute). Otherwise, datanode will be registered and the default rack
  1982. will be assigned as the topology path. Topology paths are important for
  1983. data resiliency, since they define fault domains. Thus it may be unwanted
  1984. behavior to allow datanode registration with the default rack if the
  1985. resolving topology failed.
  1986. </description>
  1987. </property>
  1988. <property>
  1989. <name>dfs.namenode.xattrs.enabled</name>
  1990. <value>true</value>
  1991. <description>
  1992. Whether support for extended attributes is enabled on the NameNode.
  1993. </description>
  1994. </property>
  1995. <property>
  1996. <name>dfs.namenode.fs-limits.max-xattrs-per-inode</name>
  1997. <value>32</value>
  1998. <description>
  1999. Maximum number of extended attributes per inode.
  2000. </description>
  2001. </property>
  2002. <property>
  2003. <name>dfs.namenode.fs-limits.max-xattr-size</name>
  2004. <value>16384</value>
  2005. <description>
  2006. The maximum combined size of the name and value of an extended attribute
  2007. in bytes. It should be larger than 0, and less than or equal to maximum
  2008. size hard limit which is 32768.
  2009. </description>
  2010. </property>
  2011. <property>
  2012. <name>dfs.client.slow.io.warning.threshold.ms</name>
  2013. <value>30000</value>
  2014. <description>The threshold in milliseconds at which we will log a slow
  2015. io warning in a dfsclient. By default, this parameter is set to 30000
  2016. milliseconds (30 seconds).
  2017. </description>
  2018. </property>
  2019. <property>
  2020. <name>dfs.datanode.slow.io.warning.threshold.ms</name>
  2021. <value>300</value>
  2022. <description>The threshold in milliseconds at which we will log a slow
  2023. io warning in a datanode. By default, this parameter is set to 300
  2024. milliseconds.
  2025. </description>
  2026. </property>
  2027. <property>
  2028. <name>dfs.namenode.startup.delay.block.deletion.sec</name>
  2029. <value>0</value>
  2030. <description>The delay in seconds at which we will pause the blocks deletion
  2031. after Namenode startup. By default it's disabled.
  2032. In the case a directory has large number of directories and files are
  2033. deleted, suggested delay is one hour to give the administrator enough time
  2034. to notice large number of pending deletion blocks and take corrective
  2035. action.
  2036. </description>
  2037. </property>
  2038. <property>
  2039. <name>dfs.datanode.block.id.layout.upgrade.threads</name>
  2040. <value>12</value>
  2041. <description>The number of threads to use when creating hard links from
  2042. current to previous blocks during upgrade of a DataNode to block ID-based
  2043. block layout (see HDFS-6482 for details on the layout).</description>
  2044. </property>
  2045. <property>
  2046. <name>dfs.namenode.list.encryption.zones.num.responses</name>
  2047. <value>100</value>
  2048. <description>When listing encryption zones, the maximum number of zones
  2049. that will be returned in a batch. Fetching the list incrementally in
  2050. batches improves namenode performance.
  2051. </description>
  2052. </property>
  2053. <property>
  2054. <name>dfs.namenode.inotify.max.events.per.rpc</name>
  2055. <value>1000</value>
  2056. <description>Maximum number of events that will be sent to an inotify client
  2057. in a single RPC response. The default value attempts to amortize away
  2058. the overhead for this RPC while avoiding huge memory requirements for the
  2059. client and NameNode (1000 events should consume no more than 1 MB.)
  2060. </description>
  2061. </property>
  2062. <property>
  2063. <name>dfs.user.home.dir.prefix</name>
  2064. <value>/user</value>
  2065. <description>The directory to prepend to user name to get the user's
  2066. home direcotry.
  2067. </description>
  2068. </property>
  2069. <property>
  2070. <name>dfs.datanode.cache.revocation.timeout.ms</name>
  2071. <value>900000</value>
  2072. <description>When the DFSClient reads from a block file which the DataNode is
  2073. caching, the DFSClient can skip verifying checksums. The DataNode will
  2074. keep the block file in cache until the client is done. If the client takes
  2075. an unusually long time, though, the DataNode may need to evict the block
  2076. file from the cache anyway. This value controls how long the DataNode will
  2077. wait for the client to release a replica that it is reading without
  2078. checksums.
  2079. </description>
  2080. </property>
  2081. <property>
  2082. <name>dfs.datanode.cache.revocation.polling.ms</name>
  2083. <value>500</value>
  2084. <description>How often the DataNode should poll to see if the clients have
  2085. stopped using a replica that the DataNode wants to uncache.
  2086. </description>
  2087. </property>
  2088. <property>
  2089. <name>dfs.encryption.key.provider.uri</name>
  2090. <description>
  2091. The KeyProvider to use when interacting with encryption keys used
  2092. when reading and writing to an encryption zone.
  2093. </description>
  2094. </property>
  2095. <property>
  2096. <name>dfs.storage.policy.enabled</name>
  2097. <value>true</value>
  2098. <description>
  2099. Allow users to change the storage policy on files and directories.
  2100. </description>
  2101. </property>
  2102. <property>
  2103. <name>dfs.namenode.legacy-oiv-image.dir</name>
  2104. <value></value>
  2105. <description>Determines where to save the namespace in the old fsimage format
  2106. during checkpointing by standby NameNode or SecondaryNameNode. Users can
  2107. dump the contents of the old format fsimage by oiv_legacy command. If
  2108. the value is not specified, old format fsimage will not be saved in
  2109. checkpoint.
  2110. </description>
  2111. </property>
  2112. <property>
  2113. <name>dfs.namenode.top.enabled</name>
  2114. <value>true</value>
  2115. <description>Enable nntop: reporting top users on namenode
  2116. </description>
  2117. </property>
  2118. <property>
  2119. <name>dfs.namenode.top.window.num.buckets</name>
  2120. <value>10</value>
  2121. <description>Number of buckets in the rolling window implementation of nntop
  2122. </description>
  2123. </property>
  2124. <property>
  2125. <name>dfs.namenode.top.num.users</name>
  2126. <value>10</value>
  2127. <description>Number of top users returned by the top tool
  2128. </description>
  2129. </property>
  2130. <property>
  2131. <name>dfs.namenode.top.windows.minutes</name>
  2132. <value>1,5,25</value>
  2133. <description>comma separated list of nntop reporting periods in minutes
  2134. </description>
  2135. </property>
  2136. <property>
  2137. <name>dfs.namenode.blocks.per.postponedblocks.rescan</name>
  2138. <value>10000</value>
  2139. <description>Number of blocks to rescan for each iteration of
  2140. postponedMisreplicatedBlocks.
  2141. </description>
  2142. </property>
  2143. <property>
  2144. <name>dfs.datanode.block-pinning.enabled</name>
  2145. <value>false</value>
  2146. <description>Whether pin blocks on favored DataNode.</description>
  2147. </property>
  2148. <property>
  2149. <name>dfs.client.block.write.locateFollowingBlock.initial.delay.ms</name>
  2150. <value>400</value>
  2151. <description>The initial delay (unit is ms) for locateFollowingBlock,
  2152. the delay time will increase exponentially(double) for each retry.
  2153. </description>
  2154. </property>
  2155. <property>
  2156. <name>dfs.ha.zkfc.nn.http.timeout.ms</name>
  2157. <value>20000</value>
  2158. <description>
  2159. The HTTP connection and read timeout value (unit is ms ) when DFS ZKFC
  2160. tries to get local NN thread dump after local NN becomes
  2161. SERVICE_NOT_RESPONDING or SERVICE_UNHEALTHY.
  2162. If it is set to zero, DFS ZKFC won't get local NN thread dump.
  2163. </description>
  2164. </property>
  2165. <property>
  2166. <name>dfs.datanode.stripedread.timeout.millis</name>
  2167. <value>5000</value>
  2168. <description>Datanode striped read timeout in milliseconds.
  2169. </description>
  2170. </property>
  2171. <property>
  2172. <name>dfs.datanode.stripedread.threads</name>
  2173. <value>20</value>
  2174. <description>Number of threads used by the Datanode for background recovery work.
  2175. </description>
  2176. </property>
  2177. <property>
  2178. <name>dfs.datanode.stripedread.buffer.size</name>
  2179. <value>65536</value>
  2180. <description>Datanode striped read buffer size.
  2181. </description>
  2182. </property>
  2183. <property>
  2184. <name>dfs.namenode.quota.init-threads</name>
  2185. <value>4</value>
  2186. <description>
  2187. The number of concurrent threads to be used in quota initialization. The
  2188. speed of quota initialization also affects the namenode fail-over latency.
  2189. If the size of name space is big, try increasing this.
  2190. </description>
  2191. </property>
  2192. <property>
  2193. <name>dfs.datanode.transfer.socket.send.buffer.size</name>
  2194. <value>131072</value>
  2195. <description>
  2196. Socket send buffer size for DataXceiver (mirroring packets to downstream
  2197. in pipeline). This may affect TCP connection throughput.
  2198. If it is set to zero or negative value, no buffer size will be set
  2199. explicitly, thus enable tcp auto-tuning on some system.
  2200. </description>
  2201. </property>
  2202. <property>
  2203. <name>dfs.datanode.transfer.socket.recv.buffer.size</name>
  2204. <value>131072</value>
  2205. <description>
  2206. Socket receive buffer size for DataXceiver (receiving packets from client
  2207. during block writing). This may affect TCP connection throughput.
  2208. If it is set to zero or negative value, no buffer size will be set
  2209. explicitly, thus enable tcp auto-tuning on some system.
  2210. </description>
  2211. </property>
  2212. <property>
  2213. <name>dfs.namenode.upgrade.domain.factor</name>
  2214. <value>${dfs.replication}</value>
  2215. <description>
  2216. This is valid only when block placement policy is set to
  2217. BlockPlacementPolicyWithUpgradeDomain. It defines the number of
  2218. unique upgrade domains any block's replicas should have.
  2219. When the number of replicas is less or equal to this value, the policy
  2220. ensures each replica has an unique upgrade domain. When the number of
  2221. replicas is greater than this value, the policy ensures the number of
  2222. unique domains is at least this value.
  2223. </description>
  2224. </property>
  2225. </configuration>