Hadoop参数汇总

问题导读

1.如何表示文件描述符？
2.fs.trash.interval=0的含义是什么？
3.NN的RPC地址和端口是多少？








linux参数

以下参数最好优化一下：

• 文件描述符ulimit -n
• 用户最大进程 nproc （hbase需要 hbse book）
• 关闭swap分区
• 设置合理的预读取缓冲区
• Linux的内核的IO调度器
  

JVM参数

JVM方面的优化项Hadoop Performance Tuning Guide

Hadoop参数大全适用版本：4.3.0

主要配置文件：

• core
• hdfs
• yarn
• mapred
  

重要性表示如下：

• 重要
• 一般
• 不重要
  

core-default.xml

• hadoop.common.configuration.version

  配置文件的版本。

• hadoop.tmp.dir=/tmp/hadoop-${user.name}

  Hadoop的临时目录，其它目录会基于此路径。本地目录。

  只可以设置一个值；建议设置到一个足够空间的地方，而不是默认的/tmp下
  服务端参数，修改需重启

• hadoop.security.authorization=false

  是否开启安全服务验证。

  建议不开启。认证操作比较复杂，在公司内部网络下，重要性没那么高

• io.file.buffer.size=4096

  在读写文件时使用的缓存大小。这个大小应该是内存Page的倍数。

  建议1M

• io.compression.codecs=null

  压缩和解压缩编码类列表，用逗号分隔。这些类是使用Java ServiceLoader加载。

• fs.defaultFS=file:///

  默认文件系统的名称。URI形式。uri's的scheme需要由(fs.SCHEME.impl)指定文件系统实现类。 uri's的authority部分用来指定host, port等。默认是本地文件系统。

  HA方式，这里设置服务名，例如：hdfs://mycluster1
  HDFS的客户端访问HDFS需要此参数。

• fs.trash.interval=0

  以分钟为单位的垃圾回收时间，垃圾站中数据超过此时间，会被删除。如果是0，垃圾回收机制关闭。可以配置在服务器端和客户端。如果在服务器端配置trash无效，会检查客户端配置。如果服务器端配置有效，客户端配置会忽略。

  建议开启，建议4320（3天）
  垃圾回收站，如有同名文件被删除，会给文件顺序编号，例如：a.txt,a.txt(1)

• fs.trash.checkpoint.interval=0

  以分钟为单位的垃圾回收检查间隔。应该小于或等于fs.trash.interval。如果是0，值等同于fs.trash.interval。每次检查器运行，会创建新的检查点。

  建议设置为60（1小时）

• dfs.ha.fencing.methods=null

  HDFS的HA功能的防脑裂方法。可以是内建的方法(例如shell和sshfence)或者用户定义的方法。建议使用sshfence(hadoop:9922)，括号内的是用户名和端口，注意，这需要NN的2台机器之间能够免密码登陆

  fences是防止脑裂的方法，保证NN中仅一个是Active的，如果2者都是Active的，新的会把旧的强制Kill。

• dfs.ha.fencing.ssh.private-key-files=null

  使用sshfence时，SSH的私钥文件。 使用了sshfence，这个必须指定

• ha.zookeeper.quorum=null

  Ha功能，需要一组zk地址，用逗号分隔。被ZKFailoverController使用于自动失效备援failover。

• ha.zookeeper.session-timeout.ms=5000

  ZK连接超时。ZKFC连接ZK时用。设置一个小值可以更快的探测到服务器崩溃（crash),但也会更频繁的触发失效备援，在传输错误或者网络不畅时。建议10s-30s

• hadoop.http.staticuser.user=dr.who

  在网页界面访问数据使用的用户名。默认值是一个不真实存在的用户，此用户权限很小，不能访问不同用户的数据。这保证了数据安全。也可以设置为hdfs和hadoop等具有较高权限的用户，但会导致能够登陆网页界面的人能看到其它用户数据。实际设置请综合考虑。如无特殊需求。使用默认值就好

• fs.permissions.umask-mode=22

  在创建文件和目录时使用此umask值（用户掩码）。类linux上的文件权限掩码。可以使用8进制数字也可以使用符号，例如："022" (8进制，等同于以符号表示的u=rwx,g=r-x,o=r-x)，或者"u=rwx,g=rwx,o="(符号法，等同于8进制的007)。注意，8进制的掩码，和实际权限设置值正好相反，建议使用符号表示法，描述更清晰

• io.native.lib.available=true

  是否启动Hadoop的本地库，默认启用。本地库可以加快基本操作，例如IO，压缩等。

• hadoop.http.filter.initializers=org.apache.hadoop.http.lib.StaticUserWebFilter

  Hadoop的Http服务中，用逗号分隔的一组过滤器类名，每个类必须扩展自org.apache.hadoop.http.FilterInitializer。 这些组件被初始化，应用于全部用户的JSP和Servlet页面。 列表中定义的顺序就是过滤器被调用的顺序。

• hadoop.security.authentication

  安全验证规则，可以是simple和kerberos。simple意味着不验证。

• hadoop.security.group.mapping=org.apache.hadoop.security.JniBasedUnixGroupsMappingWithFallback

  user到group的映射类。ACL用它以给定user获取group。默认实现是 org.apache.hadoop.security.JniBasedUnixGroupsMappingWithFallback, 如果JNI有效，它将发挥作用，使用Hadoop的API去获取user的groups列表。如果JNI无效，会使用另一个基于shell的实现, ShellBasedUnixGroupsMapping。这个实现是基于Linux、Unix的shell的环境。

• hadoop.security.groups.cache.secs=300

  user到gourp映射缓存的有效时间。如果超时，会再次调用去获取新的映射关系然后缓存起来。

• hadoop.security.service.user.name.key=null

  如果相同的RPC协议被多个Server实现，这个配置是用来指定在客户端进行RPC调用时，使用哪个principal name去联系服务器。不建议使用

• hadoop.security.uid.cache.secs=14400

  安全选项。不建议使用

• hadoop.rpc.protection=authentication

  rpc连接保护。可取的值有authentication（认证）, integrity（完整） and privacy（隐私）。不建议使用

• hadoop.work.around.non.threadsafe.getpwuid=false

  一些系统已知在调用getpwuid_r和getpwgid_r有问题，这些调用是非线程安全的。这个问题的主要表现特征是JVM崩溃。如果你的系统有这些问题，开启这个选项。默认是关闭的。

• hadoop.kerberos.kinit.command=kinit

  用来定期的向Hadoop提供新的Kerberos证书。所提供命令需要能够在运行Hadoop客户端的用户路径中查找到，否则，请指定绝对路径。不建议使用

• hadoop.security.auth_to_local=null

  映射kerberos principals（代理人）到本地用户名

• io.bytes.per.checksum=512

  每次进行校验和检查的字节数。一定不能大于io.file.buffer.size.

• io.skip.checksum.errors=FALSE

  是否跳过校验和错误，默认是否，校验和异常时会抛出错误。

• io.serializations=org.apache.hadoop.io.serializer.WritableSerialization,org.apache.hadoop.io.serializer.avro.AvroSpecificSerialization,org.apache.hadoop.io.serializer.avro.AvroReflectSerialization

  序列化类列表，可以被用来获取序列化器和反序列化器（serializers and deserializers）。

• io.seqfile.local.dir=${hadoop.tmp.dir}/io/local

  本地文件目录。sequence file在merge过程中存储内部数据的地方。可以是逗号分隔的一组目录。最好在不同磁盘以分散IO。实际不存在的目录会被忽略。

• io.map.index.skip=0

  跳过的索引实体数量在entry之间。默认是0。设置大于0的值可以用更少的内存打开大MapFiles。注意：MpaFile是一组Sequence文件，是排序后的，带内部索引的文件

• io.map.index.interval=128

  MapFile包含两个文件，数据文件和索引文件。每io.map.index.interval个记录写入数据文件，一条记录(行key，数据文件位置)写入索引文件。

• fs.default.name=file:///

  过时。使用(fs.defaultFS)代替

• fs.AbstractFileSystem.file.impl=org.apache.hadoop.fs.local.LocalFs

  文件系统实现类：file

• fs.AbstractFileSystem.hdfs.impl=org.apache.hadoop.fs.Hdfs

  文件系统实现类：hdfs

• fs.AbstractFileSystem.viewfs.impl=org.apache.hadoop.fs.viewfs.ViewFs

  文件系统实现类：viewfs (例如客户端挂载表)。

  在实现federation特性时，客户端可以部署此系统，方便同时访问多个nameservice

• fs.ftp.host=0.0.0.0

  非Hdfs文件系统设置。暂不关注

• fs.ftp.host.port=21

  非Hdfs文件系统设置。暂不关注

• fs.df.interval=60000

  磁盘使用统计刷新间隔，以毫秒为单位

• fs.s3.block.size=67108864

  非Hdfs文件系统设置。暂不关注

• fs.s3.buffer.dir=${hadoop.tmp.dir}/s3

  非Hdfs文件系统设置。暂不关注

• fs.s3.maxRetries=4

  非Hdfs文件系统设置。暂不关注

• fs.s3.sleepTimeSeconds=10

  非Hdfs文件系统设置。暂不关注

• fs.automatic.close=true

  默认的，文件系统实例在程序退出时自动关闭，通过JVM shutdown hook方式。可以把此属性设置为false取消这种操作。这是一个高级选项，需要使用者特别关注关闭顺序。不要关闭

• fs.s3n.block.size=67108864

  非Hdfs文件系统设置。暂不关注

• io.seqfile.compress.blocksize=1000000

  SequenceFiles以块压缩方式压缩时，块大小大于此值时才启动压缩。

• io.seqfile.lazydecompress=TRUE

  懒惰解压，仅在必要时解压，仅对块压缩的SequenceFiles有效。

• io.seqfile.sorter.recordlimit=1000000

  在SequenceFiles.Sorter spill过程中，保存在内存中的记录数

• io.mapfile.bloom.size=1048576

  在BloomMapFile使用的布隆过滤器内存大小。

• io.mapfile.bloom.error.rate=0.005

  BloomMapFile中使用布隆过滤器失败比率. 如果减少这个值，使用的内存会成指数增长。

• hadoop.util.hash.type=murmur

  默认Hash算法实现. 'murmur':MurmurHash, 'jenkins':JenkinsHash.

• ipc.client.idlethreshold=4000

  连接数阀值，超过此值，需要进行空闲连接检查

• ipc.client.kill.max=10

  定义客户端最大数量，超过会被断开连接

• ipc.client.connection.maxidletime=10000

  毫秒，最大时间，超过后客户端会断开和服务器的连接。

• ipc.client.connect.max.retries=10

  客户端连接重试次数。

• ipc.client.connect.max.retries.on.timeouts=45

  在连接超时后，客户端连接重试次数

• ipc.server.listen.queue.size=128

  定义服务器端接收客户端连接的监听队列长度

• ipc.server.tcpnodelay=false

  在服务器端开启/关闭Nagle's算法，此算法可以延迟小数据包发送，从而达到网络流量更有效利用。但是这对小数据包是不利的。默认关闭。建议false，即开启Nagle算法

• ipc.client.tcpnodelay=false

  参考ipc.server.tcpnodelay，客户端参数。或许可以考虑关闭Nagle算法，增加客户端响应速度

• hadoop.rpc.socket.factory.class.default=org.apache.hadoop.net.StandardSocketFactory

  高级选项，暂不考虑

• hadoop.rpc.socket.factory.class.ClientProtocol=null

  高级选项，暂不考虑

• hadoop.socks.server=null

  高级选项，暂不考虑

• net.topology.node.switch.mapping.impl=org.apache.hadoop.net.ScriptBasedMapping

  机架感知实现类。

• net.topology.script.file.name=null

  配合ScriptBasedMapping使用。脚本文件。此脚本文件，输入是ip地址，输出是机架路径。

• net.topology.script.number.args=100

  机架感知脚本文件的参数最大数量。脚本每次运行被传递的参数，每个参数是一个ip地址

• net.topology.table.file.name=null

  在net.topology.script.file.name被设置为 org.apache.hadoop.net.TableMapping时，可以使用此配置。文件格式是一个有两个列的文本文件，使用空白字符分隔。第一列是DNS或IP地址，第二列是机架路径。如无指定，使用默认机架（/default-rack）

• file.stream-buffer-size=4096

  非hdfs文件系统，暂不关注

• s3.stream-buffer-size=4096

  非hdfs文件系统，暂不关注

• kfs.stream-buffer-size=4096

  非hdfs文件系统，暂不关注

• ftp.stream-buffer-size=4096

  非hdfs文件系统，暂不关注

• tfile.io.chunk.size=1048576

  非hdfs文件系统，暂不关注

• hadoop.http.authentication.type=simple

  Oozie Http终端安全验证。可选值：simple | kerberos |#AUTHENTICATION_HANDLER_CLASSNAME#

  建议simple，关闭验证

• hadoop.http.authentication.token.validity=36000

  安全选项。暂不关注

• hadoop.http.authentication.signature.secret.file=${user.home}/hadoop-http-auth-signature-secret

  安全选项。暂不关注

• hadoop.http.authentication.cookie.domain=null

  安全选项。暂不关注

• hadoop.http.authentication.simple.anonymous.allowed=TRUE

  安全选项。暂不关注

• hadoop.http.authentication.kerberos.principal=HTTP/_HOST@LOCALHOST

  安全选项。暂不关注

• hadoop.http.authentication.kerberos.keytab=${user.home}/hadoop.keytab

  安全选项。暂不关注

• dfs.ha.fencing.ssh.connect-timeout=30000

  SSH连接超时，毫秒，仅适用于内建的sshfence fencer。

• ha.zookeeper.parent-znode=/hadoop-ha

  ZK失效备援功能，需要在ZK上创建节点，这里是根节点的名称。ZKFC会在这下面工作。注意，NameService ID会 被写到此节点下，所以即便是开启federation功能，也仅需要指定一个值。

• ha.zookeeper.acl=world:anyone:rwcda

  ZKFC创建的ZK节点的访问控制权限设置。可以多个，逗号分隔。此设置和ZK的CLI使用相同的格式。

• ha.zookeeper.auth=null

  ZK操作时的权限验证。

• hadoop.ssl.keystores.factory.class=org.apache.hadoop.security.ssl.FileBasedKeyStoresFactory

  安全选项。暂不关注

• hadoop.ssl.require.client.cert=FALSE

  安全选项。暂不关注

• hadoop.ssl.hostname.verifier=DEFAULT

  安全选项。暂不关注

• hadoop.ssl.server.conf=ssl-server.xml

  安全选项。暂不关注

• hadoop.ssl.client.conf=ssl-client.xml

  安全选项。暂不关注

• hadoop.ssl.enabled=FALSE

  安全选项。暂不关注

• hadoop.jetty.logs.serve.aliases=TRUE

  是否允许在Jetty中使用别名服务。

• ha.health-monitor.connect-retry-interval.ms=1000

  HA功能的健康监控连接重试间隔

• ha.health-monitor.check-interval.ms=1000

  HA功能的健康监控连接间隔

• ha.health-monitor.sleep-after-disconnect.ms=1000

  HA功能的健康监控，在因网络问题失去连接后休眠多久。用于避免立即重试，此时网络问题仍在，没有意义

• ha.health-monitor.rpc-timeout.ms=45000

  HA功能健康监控的超时时间，毫秒

• ha.failover-controller.new-active.rpc-timeout.ms=60000

  FC等待新的NN变成active状态的超时时间。

• ha.failover-controller.graceful-fence.rpc-timeout.ms=5000

  FC等待旧的active变成standby的超时时间。

• ha.failover-controller.graceful-fence.connection.retries=1

  FC在做完美隔离是的连接重试次数（graceful fencing）

• ha.failover-controller.cli-check.rpc-timeout.ms=20000

  手动运行的FC功能（从CLI）等待健康检查、服务状态的超时时间。

  
  

hdfs-default.xml

• hadoop.hdfs.configuration.version=1
  配置文件的版本
• dfs.datanode.address=0.0.0.0:50010
  DN服务地址和端口，用于数据传输。0表示任意空闲端口。
  xferPort    dfs.datanode.address        50010   数据流地址   数据传输infoPort    dfs.datanode.http.address   50075ipcPort     dfs.datanode.ipc.address    50020   命令
• dfs.datanode.http.address=0.0.0.0:50075

  DN的HTTP服务地址和端口。0表示任意空闲端口。

• dfs.datanode.ipc.address=0.0.0.0:50020

  DN的IPC地址和端口。0表示任意空闲端口。

• dfs.namenode.rpc-address=0.0.0.0:50090

  NN的RPC地址和端口

• dfs.namenode.http-address=0.0.0.0:50070

  NN的HTTP地址和端口。0表示任意空闲端口。

• dfs.datanode.du.reserved=0

  每个磁盘（volume）的保留空间，字节。要注意留足够的空间给非HDFS文件使用。建议保留磁盘容量的5%或者50G以上

• dfs.namenode.name.dir.restore=FALSE

  设置为true，允许NN尝试恢复之前失败的dfs.namenode.name.dir目录。在创建checkpoint是做此尝试。如果设置多个磁盘，建议允许

• dfs.namenode.edits.dir=${dfs.namenode.name.dir}

  本地文件，NN存放edits文件的目录。可以是逗号分隔的目录列表。edits文件会存储在每个目录，冗余安全。

• dfs.namenode.shared.edits.dir=null

  在多个NN中共享存储目录，用于存放edits文件。这个目录，由active写，由standby读，以保持命名空间数据一致。此目录不需要是dfs.namenode.edits.dir中列出的。在非HA集群中，它不会使用。建议使用qj方式，可以不关注这个选项

• dfs.namenode.edits.journal-plugin.qjournal=org.apache.hadoop.hdfs.qjournal.client.QuorumJournalManager

  qj方式共享edits。建议使用此方式

• dfs.permissions.enabled=true

  是否在HDFS中开启权限检查。

• dfs.permissions.superusergroup=supergroup

  超级用户组。仅能设置一个。

• dfs.datanode.data.dir=file://${hadoop.tmp.dir}/dfs/data

  本地磁盘目录，HDFS数据应该存储Block的地方。可以是逗号分隔的目录列表（典型的，每个目录在不同的磁盘）。这些目录被轮流使用，一个块存储在这个目录，下一个块存储在下一个目录，依次循环。每个块在同一个机器上仅存储一份。不存在的目录被忽略。必须创建文件夹，否则被视为不存在。

• dfs.replication=3

  数据块副本数。此值可以在创建文件是设定，客户端可以只有设定，也可以在命令行修改。不同文件可以有不同的副本数。默认值用于未指定时。

• dfs.replication.max=512

  最大块副本数，不要大于节点总数。

• dfs.namenode.replication.min=1

  最小块副本数。在上传文件时，达到最小副本数，就认为上传是成功的

• dfs.blocksize=67108864

  块大小，字节。可以使用后缀: k(kilo), m(mega), g(giga), t(tera), p(peta), e(exa)指定大小 (就像128k, 512m, 1g, 等待)。

• dfs.client.block.write.retries=3

  客户端写数据到DN时，最大重试次数。超过重试次数就会报出错误。

• dfs.client.block.write.replace-datanode-on-failure.enable=true

  在进行pipeline写数据（上传数据的方式）时，如果DN或者磁盘故障，客户端将尝试移除失败的DN，然后写到剩下的磁盘。一个结果是，pipeline中的DN减少了。这个特性是添加新的DN到pipeline。这是一个站点范围的选项。当集群规模非常小时，例如3个或者更小，集群管理者可能想要禁止掉此特性。

• dfs.client.block.write.replace-datanode-on-failure.policy=DEFAULT

  此属性仅在dfs.client.block.write.replace-datanode-on-failure.enable设置为true时有效。

  
  

  • ALWAYS: 总是添加新的DN
    
    • NEVER: 从不添加新的DN
    • DEFAULT: 设r是副本数，n是要写的DN数。在r>=3并且floor(r/2)>=n或者r>n(前提是文件是hflushed/appended)时添加新的DN。
      
    
    

• dfs.heartbeat.interval=3

  DN的心跳间隔，秒

• dfs.namenode.handler.count=10

  NN的服务线程数。用于处理RPC请求。

• dfs.namenode.safemode.threshold-pct=0.999f

  数据进入安全模式阀值，百分比，float形式，数据块达到最小副本数（dfs.namenode.replication.min）的百分比。值小于等于0意味着在退出安全模式前不等待数据修复。大于1的值将导致无法离开安全模式。

• dfs.namenode.safemode.extension=30000

  安全模式扩展存在时间，在需要的阀值达到后，毫秒。可以设置为0，或者比较短的一个时间，例如3秒

• dfs.datanode.balance.bandwidthPerSec=1048576

  在做数据平衡时，每个DN最大带宽占用，每秒字节。默认值是1M。建议可以到10M

• dfs.hosts=null

  文件名，包含了一个host列表，允许列表内机器连到NN。必须指定完整路径。如果值为空，全部hosts都允许连入。

• dfs.hosts.exclude=null

  文件名，包含了一个hosts列表，不允许列表内机器连到NN。必须指定完整路径。如果值为空。没有host被禁止。如果上述2个都设置并且有重合，dfs.hosts中优先级高。

• dfs.stream-buffer-size=4096

  文件流缓存大小。需要是硬件page大小的整数倍。在读写操作时，数据缓存大小。注意和core-default.xml中指定文件类型的缓存是不同的，这个是dfs共用的

• dfs.namenode.num.extra.edits.retained=1000000

  除最小的必须的editlog之外，额外保留的editlog文件数量。这是有用的，可以用于审核目的，或者HA设置一个远程Standby节点并且有时可能离线时，都需要保留一个较长的backlog。

  ---

  典型的，每个edit大约几百字节，默认的1百万editlog大约有百兆到1G。注意：早先的extra edits文件可能操作这里设置的值，因为还有其它选项，例如dfs.namenode.max.extra.edits.segments.retained

  建议值：2200，约3天的

• dfs.datanode.handler.count=10

  DN的服务线程数。这些线程仅用于接收请求，处理业务命令

• dfs.datanode.failed.volumes.tolerated=0

  可以接受的卷的失败数量。默认值0表示，任一个卷失败都会导致DN关闭。

  建议设置此值，避免个别磁盘问题。如果此值超过真实磁盘数，将会报错，启动失败

• dfs.namenode.support.allow.format=true

  NN是否允许被格式化？在生产系统，把它设置为false，阻止任何格式化操作在一个运行的DFS上。

  建议初次格式化后，修改配置禁止

• dfs.client.failover.max.attempts=15

  专家设置。客户端失败重试次数。

• dfs.client.failover.connection.retries=0

  专家设置。IPC客户端失败重试次数。在网络不稳定时建议加大此值

• dfs.client.failover.connection.retries.on.timeouts=0

  专家设置。IPC客户端失败重试次数，此失败仅指超时失败。在网络不稳定时建议加大此值

• dfs.nameservices=null

  nameservices列表。逗号分隔。

  我们常用的仅配置一个，启动federation功能需要配置多个

• dfs.nameservice.id=null

  nameservice id，如果没有配置或者配置多个，由匹配到的本地节点地址配置的IP地址决定。我们进配置一个NS的情况下，建议这里不配置

• dfs.ha.namenodes.EXAMPLENAMESERVICE=null

  包含一个NN列表。EXAMPLENAMESERVICE是指具体的nameservice名称，通常就是dfs.nameservices中配置的。值是预备配置的NN的ID。

  ID是自己取的，不重复就可以，例如nn1,nn2

• dfs.ha.namenode.id=null

  NN的ID，如果没有配置，由系统决定。通过匹配本地节点地址和配置的地址。

  这里设置的是本机的NN的ID（此配置仅对NN生效），由于要配置2个NN，建议没有特殊需要，这里不进行配置

• dfs.ha.automatic-failover.enabled=FALSE

  是否开启自动故障转移。建议开启，true

• dfs.namenode.avoid.write.stale.datanode=FALSE

  决定是否避开在脏DN上写数据。写操作将会避开脏DN，除非超过一个配置的比率 (dfs.namenode.write.stale.datanode.ratio)。

  尝试开启

• dfs.journalnode.rpc-address=0.0.0.0:8485

  JournalNode RPC服务地址和端口

• dfs.journalnode.http-address=0.0.0.0:8480

  JournalNode的HTTP地址和端口。端口设置为0表示随机选择。

• dfs.namenode.audit.loggers=default

  审查日志的实现类列表，能够接收audit事件。它们需要实现 org.apache.hadoop.hdfs.server.namenode.AuditLogger接口。默认值"default"可以用于引用默认的audit logger， 它使用配置的日志系统。安装客户自己的audit loggers可能影响NN的稳定性和性能。

  建议default，开启

• dfs.client.socket-timeout=60*1000
• dfs.datanode.socket.write.timeout=8*60*1000
• dfs.datanode.socket.reuse.keepalive=1000
• dfs.namenode.logging.level=info

  DFS的NN的日志等级。值可以是：info，dir(跟踪命名空间变动)，"block" (跟踪块的创建删除，replication变动)，或者"all".

• dfs.namenode.secondary.http-address=0.0.0.0:50090

  SNN的http服务地址。如果是0，服务将随机选择一个空闲端口。使用了HA后，就不再使用SNN了

• dfs.https.enable=FALSE

  允许HDFS支持HTTPS(SSL)。建议不支持

• dfs.client.https.need-auth=FALSE

  安全选项，暂不关注

• dfs.https.server.keystore.resource=ssl-server.xml

  安全选项，暂不关注

• dfs.client.https.keystore.resource=ssl-client.xml

  安全选项，暂不关注

• dfs.datanode.https.address=0.0.0.0:50475

  安全选项，暂不关注

• dfs.namenode.https-address=0.0.0.0:50470

  安全选项，暂不关注

• dfs.datanode.dns.interface=default

  DN汇报它的IP地址的网卡。我们给DN指定了0.0.0.0之类的地址，这个地址需要被解析成对外地址，这里指定的是网卡名，即那个网卡上绑定的IP是可以对外的IP，一般的，默认值就足够了

• dfs.datanode.dns.nameserver=default

  DNS的域名或者IP地址。DN用它来确定自己的域名，在对外联系和显示时调用。一般的，默认值就足够了

• dfs.namenode.backup.address=0.0.0.0:50100

  NN的BK节点地址和端口，0表示随机选用。使用HA，就不需要关注此选项了。建议不使用BK节点

• dfs.namenode.backup.http-address=0.0.0.0:50105

  使用HA，就不需要关注此选项了。建议不使用BK节点

• dfs.namenode.replication.considerLoad=true

  设定在选择存放目标时是否考虑负载。需要

• dfs.default.chunk.view.size=32768

  在浏览器中查看一个文件时，可以看到的字节数。

• dfs.namenode.name.dir=file://${hadoop.tmp.dir}/dfs/name

  本地磁盘目录，NN存储fsimage文件的地方。可以是按逗号分隔的目录列表，fsimage文件会存储在全部目录，冗余安全。这里多个目录设定，最好在多个磁盘，另外，如果其中一个磁盘故障，不会导致系统故障，会跳过坏磁盘。由于使用了HA，建议仅设置一个。如果特别在意安全，可以设置2个

• dfs.namenode.fs-limits.max-component-length=0

  路径中每个部分的最大字节长度（目录名，文件名的长度）。0表示不检查长度。长文件名影响性能

• dfs.namenode.fs-limits.max-directory-items=0

  设置每个目录最多拥有多少个子目录或者文件。0表示无限制。同一目录下子文件和目录多影响性能

• dfs.namenode.fs-limits.min-block-size=1048576

  最小的Block大小，字节。在NN创建时强制验证。避免用户设定过小的Block Size，导致过多的Block，这非常影响性能。

• dfs.namenode.fs-limits.max-blocks-per-file=1048576

  每个文件最大的Block数。在NN写时强制检查。用于防止创建超大文件。

• dfs.block.access.token.enable=FALSE

  访问DN时是否验证访问令牌。建议false，不检查

• dfs.block.access.key.update.interval=600

  安全选项，暂不关注

• dfs.block.access.token.lifetime=600

  安全选项，暂不关注

• dfs.datanode.data.dir.perm=700

  本地数据目录权限设定。8进制或者符号方式都可以。

• dfs.blockreport.intervalMsec=21600000

  数据块汇报间隔，毫秒，默认是6小时。

• dfs.blockreport.initialDelay=0

  第一次数据块汇报时延迟，秒。目的是减轻NN压力？

• dfs.datanode.directoryscan.interval=21600

  DN的数据块扫描间隔，秒。磁盘上数据和内存中数据调整一致。

• dfs.datanode.directoryscan.threads=1

  线程池要有多少线程用来并发的压缩磁盘的汇报数据。

• dfs.namenode.safemode.min.datanodes=0

  NN收到回报的DN的数量的最小值，达不到此值，NN不退出安全模式。（在系统启动时发生作用）。<=0的值表示不关心DN数量，在启动时。大于DN实际数量的值会导致无法离开安全模式。建议不设置此值

• dfs.namenode.max.objects=0

  DFS支持的最大文件、目录、数据块数量。0无限制。

• dfs.namenode.decommission.interval=30

  NN周期性检查退役是否完成的间隔，秒。

• dfs.namenode.decommission.nodes.per.interval=5

  NN检查退役是否完成，每dfs.namenode.decommission.interval秒检查的节点数量。

• dfs.namenode.replication.interval=3

  NN周期性计算DN的副本情况的频率，秒。

• dfs.namenode.accesstime.precision=3600000

  HDFS文件的访问时间精确到此值，默认是1小时。0表示禁用访问时间。

• dfs.datanode.plugins=null

  DN上的插件列表，逗号分隔。

• dfs.namenode.plugins=null

  NN上的插件列表，逗号分隔。

• dfs.bytes-per-checksum=512

  每次计算校验和的字节数。一定不能大于dfs.stream-buffer-size。

• dfs.client-write-packet-size=65536

  客户端写数据时的包的大小。包是块中的更小单位数据集合

• dfs.client.write.exclude.nodes.cache.expiry.interval.millis=600000

  最大周期去让DN保持在例外节点队列中。毫秒。操过此周期，先前被排除的DN将被移除缓存并被尝试再次申请Block。默认为10分钟。

• dfs.namenode.checkpoint.dir=file://${hadoop.tmp.dir}/dfs/namesecondary

  本地文件系统中，DFS SNN应该在哪里存放临时[用于合并|合并后]（to merge）的Image。如果是逗号分隔的目录列表，Image文件存放多份。冗余备份。建议不使用SNN功能，忽略此配置

• dfs.namenode.checkpoint.edits.dir=${dfs.namenode.checkpoint.dir}

  建议不使用SNN功能，忽略此配置

• dfs.namenode.checkpoint.period=3600

  建议不使用SNN功能，忽略此配置

• dfs.namenode.checkpoint.txns=1000000

  建议不使用SNN功能，忽略此配置

• dfs.namenode.checkpoint.check.period=60

  建议不使用SNN功能，忽略此配置

• dfs.namenode.checkpoint.max-retries=3

  建议不使用SNN功能，忽略此配置

• dfs.namenode.num.checkpoints.retained=2
  建议不使用SNN功能，忽略此配置
• dfs.namenode.num.extra.edits.retained=1000000

  数量限制，额外的edits事务数。

• dfs.namenode.max.extra.edits.segments.retained=10000

  extra edit日志文件segments的最大数量。除了用于NN重启时的最小edits文件之外。一个segments包含多个日志文件

• dfs.namenode.delegation.key.update-interval=86400000

  NN中更新主代理令牌的时间间隔，毫秒。安全选项，不关注

• dfs.namenode.delegation.token.max-lifetime=604800000

  NN中更新主代理令牌的时间间隔，毫秒。安全选项，不关注

• dfs.namenode.delegation.token.renew-interval=86400000

  NN中更新主代理令牌的时间间隔，毫秒。安全选项，不关注

• dfs.image.compress=FALSE

  Image文件要压缩吗？

• dfs.image.compression.codec=org.apache.hadoop.io.compress.DefaultCodec

  Image文件压缩编码。必须是在io.compression.codecs中定义的编码。

• dfs.image.transfer.timeout=600000

  Image文件传输时超时。HA方式使用不到，可不关注

• dfs.image.transfer.bandwidthPerSec=0

  Image文件传输时可以使用的最大带宽，秒字节。0表示没有限制。HA方式使用不到，可不关注

• dfs.datanode.max.transfer.threads=4096

  = 旧参数 dfs.datanode.max.xcievers
  DN上传送数据出入的最大线程数。

• dfs.datanode.readahead.bytes=4193404

  预读磁盘数据。如果Hadoop本地库生效，DN可以调用posix_fadvise系统获取页面数据到操作系统的缓存中。这个配置指定读取当前读取位置之前的字节数。设置为0，取消此功能。无本地库，此功能也无效。？

• dfs.datanode.drop.cache.behind.reads=FALSE

  在有些场景下，特别是对一些大的，并且不可能重用的数据，缓存在操作系统的缓存区是无用的。此时，DN可以配置自动清理缓存区数据，在已经发生向客户端之后。此功能自动失效，在读取小数据片时。(例如HBase的随机读写场景）。通过释放缓存，这在某些场景下可以提高性能。Hadoop本地库无效，此功能无效。看起来是一个可以尝试的特性

• dfs.datanode.drop.cache.behind.writes=FALSE

  同dfs.datanode.drop.cache.behind.reads相似。

• dfs.datanode.sync.behind.writes=FALSE

  如果是true，在写之后，DN将指示操作系统把队列中数据全部立即写磁盘。和常用的OS策略不同，它们可能在触发写磁盘之前等待30秒。Hadoop本地库无效，此功能无效。

• dfs.client.failover.sleep.base.millis=500

  专家设置。失败重试间的等待时间，毫秒。这里的值是个基本值，实际值会根据失败/成功次数递增/递减50%。第一次失败会立即重试。第二次将延迟至少dfs.client.failover.sleep.base.millis毫秒。依次类推。

• dfs.client.failover.sleep.max.millis=15000

  专家设置。失败重试见的等待时间最大值，毫秒。

• dfs.ha.log-roll.period=120

  StandbyNode要求Active滚动EditLog，由于StandBy只能从已经完成的Log Segments中读，所以Standby上的数据新鲜程度依赖于以如何的频率滚动日志。秒。另外，故障转移也会触发一次日志滚动，所以StandbyNode在Active之前，数据也会更新成最新的。秒，默认是2分钟。

• dfs.ha.tail-edits.period=60

  StandbyNode以此频率检测共享目录中最新的日志，秒。

• dfs.ha.zkfc.port=8019

  zkfc的rpc端口

• dfs.support.append=TRUE

  是否允许append。

• dfs.client.use.datanode.hostname=FALSE

  是否客户端应该使用DN的HostName，在连接DN时，默认是使用IP。

• dfs.datanode.use.datanode.hostname=FALSE

  是否DN应该使用HostName连接其它DN，在数据传输时。默认是是IP。

• dfs.client.local.interfaces=null

  逗号分隔的网卡列表，用于在客户端和DN之间传输数据时。当创建连接时，客户端随机选择一个并绑定它的socket到这个网卡的IP上。名字可以以网卡名(例如 "eth0"), 子网卡名 (eg "eth0:0"), 或者IP地址(which may be specified using CIDR notation to match a range of IPs)。

• dfs.namenode.kerberos.internal.spnego.principal=${dfs.web.authentication.kerberos.principal}

  安全选项，暂不关注

• dfs.secondary.namenode.kerberos.internal.spnego.principal=${dfs.web.authentication.kerberos.principal}

  安全选项，暂不关注

• dfs.namenode.avoid.read.stale.datanode=FALSE

  决定是否避开从脏DN上读数据。脏DN指在一个指定的时间间隔内没有收到心跳信息。脏DN将被移到可以读取节点列表的尾端。尝试开启

• dfs.namenode.stale.datanode.interval=30000

  标记一个DN是脏的时间间隔。例如，如果NN在此设定的时间内没有接收到来自某一个节点的心跳信息，此DN将被标记为脏的。此间隔不能太小，否则容易导致被频繁的标记为脏DN。

  我们建议是1分钟

• dfs.namenode.write.stale.datanode.ratio=0.5f

  当全部DN被标记为脏DN的比率高于此阀值，停止不写数据到脏DN的策略，以免造成热点问题（有效的，可写的DN太少，压力太大）。

• dfs.namenode.invalidate.work.pct.per.iteration=0.32f

  高级属性。改变需小心。

• dfs.namenode.replication.work.multiplier.per.iteration=2

  高级属性。改变需小心。

• dfs.webhdfs.enabled=FALSE

  在NN和DN上开启WebHDFS (REST API)功能。

  可以开启尝试

• hadoop.fuse.connection.timeout=300

  秒，在fuse_dfs中缓存libhdfs连接对象的超时时间。 小值使用内存小。大值可以加快访问，通过避开创建新的连接对象。

• hadoop.fuse.timer.period=5

  秒

• dfs.metrics.percentiles.intervals=null

  Comma-delimited set of integers denoting the desired rollover intervals (in seconds) for percentile latency metrics on the Namenode and Datanode. By default, percentile latency metrics are disabled.

• dfs.encrypt.data.transfer=FALSE

  是否加密传输数据？仅需要配置在NN和DN。客户端可以自行判断。

• dfs.encrypt.data.transfer.algorithm=null

  可以设置为"3des"或"rc4"。否则使用默认的，通常是usually 3DES。3DES更安全，RC4更快。

• dfs.datanode.hdfs-blocks-metadata.enabled=TRUE

  布尔值，设定后台DN端是否支持DistributedFileSystem#getFileVBlockStorageLocations API。

• dfs.client.file-block-storage-locations.num-threads=10

  在调用DistributedFileSystem#getFileBlockStorageLocations()的并发RPC的线程数

• dfs.client.file-block-storage-locations.timeout=60

  Timeout (in seconds) for the parallel RPCs made in DistributedFileSystem#getFileBlockStorageLocations().

• dfs.domain.socket.path=/var/run/hadoop-hdfs/dn._PORT

  可选选项。socket文件路径，unix下。用来在DN和本地的HDFS客户端加快网络连接。如果字符串"_PORT"出现在路径中，它将被DN的TCP端口替换。

  
  

yarn-default.xml

• yarn.app.mapreduce.am.env=null

  用户为MR AM添加环境变量。例如：

  
  

  • A=foo 设置环境变量A为foo
  • B=$B:c 继承并设置TT内的B变量
    

• yarn.app.mapreduce.am.command-opts=-Xmx1024m

  MR AM的Java opts。如下符号会被替换：

  
  

  • @taskid@ 被替换成当前的TaskID。其它出现的'@'不会改变。例如，为了让gc日志能够按task打印存储在/tmp目录，可以设置'value'为：-Xmx1024m -verbose:gc -Xloggc:/tmp/@taskid@.gc
  • 如果hadoop本地库可以使用，使用-Djava.library.path参数可能造成程序的此功能无效。这个值应该被替换，设置在MR的JVM环境中LD_LIBRARY_PATH变量中，使用 mapreduce.map.env和mapreduce.reduce.env配置项。
    

• yarn.app.mapreduce.am.resource.mb=1536

  AM申请的内存

• yarn.resourcemanager.address=0.0.0.0:8032

  RM地址:端口

• yarn.resourcemanager.scheduler.address=0.0.0.0:8030

  调度器地址：端口

• yarn.admin.acl=*

  ACL中谁可以管理YARN集群

• yarn.resourcemanager.admin.address=0.0.0.0:8033

  RM管理接口地址：端口

• yarn.resourcemanager.am.max-retries=1

  AM重试最大次数。服务端参数。重启生效。

  建议4

• yarn.resourcemanager.nodes.include-path=null

  存储有效节点列表的文件

• yarn.resourcemanager.nodes.exclude-path=null

  存储拒绝节点列表的文件。如和包含文件冲突，包含文件优先级高

• yarn.resourcemanager.scheduler.class=org.apache.hadoop.yarn.server.resourcemanager.scheduler.fifo.FifoScheduler

  调度器实现类。

  建议使用公平调度器

• yarn.scheduler.minimum-allocation-mb=1024

  每个container想RM申请内存的最小大小。兆字节。内存请求小于此值，实际申请到的是此值大小。默认值偏大

• yarn.scheduler.maximum-allocation-mb=8192

  每个container向RM申请内存的最大大小，兆字节。申请值大于此值，将最多得到此值内存。

• yarn.resourcemanager.recovery.enabled=FALSE

  是否启动RM的状态恢复功能。如果true，必须指定yarn.resourcemanager.store.class。尝试启用

• yarn.resourcemanager.store.class=null

  用于持久存储的类。尝试开启

• yarn.resourcemanager.max-completed-applications=10000

  RM中保存的最大完成的app数量。内存中存储。

• yarn.nodemanager.address=0.0.0.0:0

  NM中的container管理器的地址：端口

• yarn.nodemanager.env-whitelist=JAVA_HOME,HADOOP_COMMON_HOME,HADOOP_HDFS_HOME,HADOOP_CONF_DIR,YARN_HOME

  container应该覆盖而不是使用NM的环境变量名单。允许container自己配置的环境变量

• yarn.nodemanager.delete.debug-delay-sec=0

  秒，一个app完成后，NM删除服务将删除app的本地文件目录和日志目录。为了诊断问题，把这个选项设置成足够大的值（例如，设置为10分钟），可以继续访问这些目录。设置此选项，需要重启NM。Yarn应用的工作目录根路径是yarn.nodemanager.local-dirs，Yarn应用日志目录的根路径是yarn.nodemanager.log-dirs。

  调试问题时可用

• yarn.nodemanager.local-dirs=${hadoop.tmp.dir}/nm-local-dir

  本地文件存储目录，列表。一个应用的本地文件目录定位方式：${yarn.nodemanager.local-dirs}/usercache/${user}/appcache/application_${appid}。每个container的工作目录，是此目录的子目录，目录名是container_${contid}。

  非常重要，建议配置多个磁盘，平衡IO。

• yarn.nodemanager.log-dirs=${yarn.log.dir}/userlogs

  存储container日志的地方。一个应用的本地日志目录定位是：${yarn.nodemanager.log-dirs}/application_${appid}。每个container的日志目录在此目录下，名字是container_{$contid}。每个container目录中包含stderr, stdin, and syslog等container产生的文件

  非常重要，建议配置多个磁盘

• yarn.log-aggregation-enable=FALSE

  是否允许日志汇聚功能。建议开启

• yarn.log-aggregation.retain-seconds=-1

  保存汇聚日志时间，秒，超过会删除，-1表示不删除。 注意，设置的过小，将导致NN垃圾碎片。建议3-7天 = 7 * 86400 = 604800

• yarn.nodemanager.log.retain-seconds=10800

  保留用户日志的时间，秒。在日志汇聚功能关闭时生效。

  建议7天

• yarn.nodemanager.remote-app-log-dir=/tmp/logs

  汇聚日志的地方，目录路径，HDFS系统。

  对于开了权限检查的系统，注意权限问题。HDFS上。

• yarn.nodemanager.remote-app-log-dir-suffix=logs

  汇聚日志目录路径后缀。汇聚目录创建在{yarn.nodemanager.remote-app-log-dir}/${user}/{thisParam}

• yarn.nodemanager.resource.memory-mb=8192

  NM上可以用于container申请的物理内存大小，MB。

• yarn.nodemanager.vmem-pmem-ratio=2.1

  在设置container的内存限制时，虚拟内存到物理内存的比率。Container申请的内存如果超过此物理内存，可以以此比率获取虚拟内存用于满足需求。虚拟地址的是物理地址的倍数上限。建议设置的大点，例如：4.1，8.1，此虚拟内存并非内存，而是占用的虚拟地址。

• yarn.nodemanager.webapp.address=0.0.0.0:8042

  NM的网页界面地址和端口。

• yarn.nodemanager.log-aggregation.compression-type=none

  汇聚日志的压缩类型。汇聚日志是TFile格式文件。Hadoop-3315。可以使用的值有none,lzo,gz等。

  可以尝试

• yarn.nodemanager.aux-services=null

  请配置为：mapreduce.shuffle，在Yarn上开启MR的必须项

• yarn.nodemanager.aux-services.mapreduce.shuffle.class=org.apache.hadoop.mapred.ShuffleHandler

  对应参考yarn.nodemanager.aux-services

• mapreduce.job.jar=null

  Job客户端参数。提交的job的jar文件。

• mapreduce.job.hdfs-servers=${fs.defaultFS}

  Job客户端参数。

• yarn.application.classpath=$HADOOP_CONF_DIR,$HADOOP_COMMON_HOME/share/hadoop/common/,$HADOOP_COMMON_HOME/share/hadoop/common/lib/,$HADOOP_HDFS_HOME/share/hadoop/hdfs/,$HADOOP_HDFS_HOME/share/hadoop/hdfs/lib/,$YARN_HOME/share/hadoop/yarn/*,$YARN_HOME/share/hadoop/yarn/lib/*

  YARN应用的CLASSPATH，逗号分隔列表。

• yarn.app.mapreduce.am.job.task.listener.thread-count=30

  MR AM处理RPC调用的线程数。

• yarn.app.mapreduce.am.job.client.port-range=null

  MR AM能够绑定使用的端口范围。例如：50000-50050,50100-50200。 如果你先要全部的有用端口，可以留空（默认值null）。

• yarn.app.mapreduce.am.job.committer.cancel-timeout=60000

  毫秒，如果job被kill了，等待output committer取消操作的时间。

• yarn.app.mapreduce.am.scheduler.heartbeat.interval-ms=1000

  MR AM发送心跳到RM的时间间隔，毫秒

• yarn.app.mapreduce.client-am.ipc.max-retries=3

  在重新连接RM获取Application状态前，客户端重试连接AM的次数。

• yarn.app.mapreduce.client.max-retries=3

  客户端重连RM/HS/AM的次数。这是基于ipc接口上的规则

• yarn.ipc.client.factory.class=null

  创建客户端IPC类的工厂类

• yarn.ipc.serializer.type=protocolbuffers

  使用哪种序列化类

• yarn.ipc.server.factory.class=null

  创建IPC服务类的工厂类

• yarn.ipc.exception.factory.class=null

  创建IPC异常的工厂类

• yarn.ipc.record.factory.class=null

  创建序列化记录的工厂类

• yarn.ipc.rpc.class=org.apache.hadoop.yarn.ipc.HadoopYarnProtoRPC

  RPC类实现类

• yarn.resourcemanager.client.thread-count=50

  RM用来处理客户端请求的线程数

• yarn.am.liveness-monitor.expiry-interval-ms=600000

  AM报告间隔，毫秒。？

• yarn.resourcemanager.principal=null

  安全选项

• yarn.resourcemanager.scheduler.client.thread-count=50

  调度器用于处理请求的线程数

• yarn.resourcemanager.webapp.address=0.0.0.0:8088

  RM的网页接口地址：端口

• yarn.resourcemanager.resource-tracker.address=0.0.0.0:8031

  ？

• yarn.acl.enable=TRUE

  开启访问控制

• yarn.resourcemanager.admin.client.thread-count=1

  RM管理端口处理事务的线程数

• yarn.resourcemanager.amliveliness-monitor.interval-ms=1000

  RM检查AM存活的间隔

• yarn.resourcemanager.container.liveness-monitor.interval-ms=600000

  检查container存活的时间间隔，毫秒。建议短一些，例如3分钟

• yarn.resourcemanager.keytab=/etc/krb5.keytab

  安全选项

• yarn.nm.liveness-monitor.expiry-interval-ms=600000

  RM判断NM死亡的时间间隔。
  非主动检查，被动等待，不连接时间超过此值
  10分钟无检查到活动，判定NM死亡

• yarn.resourcemanager.nm.liveness-monitor.interval-ms=1000

  RM检查NM存活的时间间隔。

• yarn.resourcemanager.resource-tracker.client.thread-count=50

  处理资源跟踪调用的线程数。？

• yarn.resourcemanager.delayed.delegation-token.removal-interval-ms=30000

  安全选项

• yarn.resourcemanager.application-tokens.master-key-rolling-interval-secs=86400

  安全选项

• yarn.resourcemanager.container-tokens.master-key-rolling-interval-secs=86400

  安全选项

• yarn.nodemanager.admin-env=MALLOC_ARENA_MAX=$MALLOC_ARENA_MAX

  应该从NM传送到container的环境变量

• yarn.nodemanager.container-executor.class=org.apache.hadoop.yarn.server.nodemanager.DefaultContainerExecutor

  启动containers的类。

• yarn.nodemanager.container-manager.thread-count=20

  用于container管理的线程数

• yarn.nodemanager.delete.thread-count=4