zookeeper 配置文件说明（zoo.cfg）

Posted 2020-09-22 jzssuanfa

clientPort      # 客户端连接server的port，即对外服务port，一般设置为2181。

dataDir        # 存储快照文件snapshot的文件夹。

默认情况下。事务日志也会存储在这里。

建议同一时候配置參数dataLogDir, 事务日志的写性能直接影响zk性能。

tickTime        # ZK中的一个时间单元。ZK中全部时间都是以这个时间单元为基础，进行整数倍配置的。

比如，session的最小超时时间是2*tickTime。

dataLogDir      # 事务日志输出文件夹。尽量给事务日志的输出配置单独的磁盘或是挂载点，这将极大的提升ZK性能。

globalOutstandingLimit    # 最大请求堆积数。默认是1000。ZK执行的时候， 虽然server已经没有空暇来处理很多其它的client请求了，可是还是同意client将请求提交到服务器上来，提高吞吐性能。

当然，为了防止Server内存溢出，这个请求堆积数还是须要限制下的。 Java system property:zookeeper.globalOutstandingLimit.

preAllocSize    # 预先开辟磁盘空间。用于兴许写入事务日志。默认是64M，每一个事务日志大小就是64M。假设ZK的快照频率较大的话。建议适当减小这个參数。

snapCount      # 每进行snapCount次事务日志输出后，触发一次快照(snapshot), 此时，ZK会生成一个snapshot.*文件，同一时候创建一个新的事务日志文件log.*。

默认是100000.（真正的代码实现中，会进行一定的随机数处理，以避免全部server在同一时间进行快照而影响性能）。

traceFile      # 用于记录全部请求的log，一般调试过程中能够使用，可是生产环境不建议使用。会严重影响性能

maxClientCnxns  # 单个client与单台server之间的连接数的限制，是ip级别的，默认是60。假设设置为0。那么表明不作不论什么限制。请注意这个限制的使用范围，不过单台client机器与单台ZKserver之间的连接数限制，不是针对指定clientIP，也不是ZK集群的连接数限制，也不是单台ZK对全部client的连接数限制。

clientPortAddress # 对于多网卡的机器。能够为每一个IP指定不同的监听port。

默认情况是全部IP都监听 clientPort 指定的port。

minSessionTimeoutmaxSessionTimeout    # Session超时时间限制。假设client设置的超时时间不在这个范围，那么会被强制设置为最大或最小时间。

默认的Session超时时间是在2 * tickTime ~ 20 * tickTime 这个范围 。

fsync.warningthresholdms  # 事务日志输出时，假设调用fsync方法超过指定的超时时间，那么会在日志中输出警告信息。默认是1000ms。

autopurge.purgeInterval    # 3.4.0及之后版本号，ZK提供了自己主动清理事务日志和快照文件的功能，这个參数指定了清理频率。单位是小时。须要配置一个1或更大的整数，默认是0。表不开启自己主动清理功能

autopurge.snapRetainCount  # 这个參数和上面的參数搭配使用，这个參数指定了须要保留的文件数目。

默认是保留3个。

electionAlg                #在之前的版本号中， 这个參数配置是同意我们选择leader选举算法，可是因为在以后的版本号中，仅仅会留下一种“TCP-based version of fast leader election”算法，所以这个參数眼下看来没实用了。

initLimit          # Follower在启动过程中，会从Leader同步全部最新数据，然后确定自己可以对外服务的起始状态。Leader同意F在 initLimit 时间内完毕这个工作。通常情况下，我们不用太在意这个參数的设置。假设ZK集群的数据量确实非常大了，F在启动的时候，从Leader上同步数据的时间也会对应变长，因此在这样的情况下。有必要适当调大这个參数了。

syncLimit        # 在执行过程中，Leader负责与ZK集群中全部机器进行通信，比如通过一些心跳检測机制。来检測机器的存活状态。假设L发出心跳包在syncLimit之后，还没有从F那收到响应，那么就觉得这个F已经不在线了。

注意：不要把这个參数设置得过大，否则可能会掩盖一些问题。

leaderServes    # 默认情况下。Leader是会接受client连接，并提供正常的读写服务。可是，假设你想让Leader专注于集群中机器的协调。那么能够将这个參数设置为no，这样一来。会大大提高写操作的性能。

server.X=A:B:C  # 当中X是一个数字, 表示这是第几号server. A是该server所在的IP地址. B配置该server和集群中的leader交换消息所使用的port. C配置选举leader时所使用的port. 这里的x是一个数字，与myid文件里的id是一致的。

右边能够配置两个port，第一个port用于F和L之间的数据同步和其他通信，第二个port用于Leader选举过程中投票通信。 

group.x=nnnnn[:nnnnn]weight.x=nnnnn  # 对机器分组和权重设置。

cnxTimeout          # Leader选举过程中。打开一次连接的超时时间，默认是5s

zookeeper.DigestAuthenticationProvider.superDigest    # ZK权限设置相关

skipACL    # 对全部client请求都不作ACL检查。假设之前节点上设置有权限限制，一旦server上打开这个开头，那么也将失效

forceSync  # 这个參数确定了是否须要在事务日志提交的时候调用 FileChannel .force来保证数据全然同步到磁盘

jute.maxbuffer  # 每一个节点最大数据量，是默认是1M。这个限制必须在server和client端都进行设置才会生效。