yangl/kafka-install-readme.md

## kafka-install-readme.md

      
    Raw
  

              kafka-install-readme.md
            
          
    1.首先安装zookeeper机群：
修改其config目录下的zoo.cfg，主要修改dataDir、server.A=B:C:D参数即可；
然后在dataDir下创建myid文件，内容为当前节点的id；
      # The number of milliseconds of each tick
      tickTime=2000
      # The number of ticks that the initial
      # synchronization phase can take
      initLimit=10
      # The number of ticks that can pass between
      # sending a request and getting an acknowledgement
      syncLimit=5
      # the directory where the snapshot is stored.
      # do not use /tmp for storage, /tmp here is just
      # example sakes.
      dataDir=/data/soft/zookeeper/data
      # the port at which the clients will connect
      #clientPort=2181
      # the maximum number of client connections.
      # increase this if you need to handle more clients
      #maxClientCnxns=60
      #
      # Be sure to read the maintenance section of the
      # administrator guide before turning on autopurge.
      #
      # http://zookeeper.apache.org/doc/current/zookeeperAdmin.html#sc_maintenance
      #
      # The number of snapshots to retain in dataDir
      #autopurge.snapRetainCount=3
      # Purge task interval in hours
      # Set to "0" to disable auto purge feature
      #autopurge.purgeInterval=1
      # Requires updates to be synced to media of the transaction log before finishing
      # processing the update. If this option is set to 'no', ZooKeeper will not require
      # updates to be synced to the media.
      # WARNING: it's not recommended to run a production ZK cluster with forceSync disabled.
      forceSync=yes

      skipACL=yes

      reconfigEnabled=true

      dynamicConfigFile=./zookeeper.properties.dynamic
      

server.1=10.206.28.67:2888:3888:participant;2181
server.2=10.206.28.68:2888:3888:participant;2181
server.3=10.206.28.69:2888:3888:participant;2181
server.4=10.206.28.70:2888:3888:observer;2181
server.5=10.206.28.71:2888:3888:observer;2181
server.6=10.206.28.72:2888:3888:observer;2181
server.7=10.206.28.73:2888:3888:observer;2181

2.安装kafka机群：
修改config/server.properties文件：
      broker.id
      log.dirs
      num.partitions
      zookeeper.connect
      #(zookeeper.connect=10.10.82.173:2181,10.10.82.174:2181,10.10.82.175:2181/kafka)
      ##### Topic #####
      auto.create.topics.enable=false
      delete.topic.enable=true

修改kafka-server-start.sh将其jvm内存加大，如4G
启动即可：

JMX_PORT=6062 ./bin/kafka-server-start.sh -daemon config/server.properties
JVM参数配置见：
http://kafka.apache.org/documentation.html#java
3.安装kafka-manager管理后台：
参见kafka-manager-README
# Protocol
listeners=SASL_PLAINTEXT://:9092
security.inter.broker.protocol=SASL_PLAINTEXT
sasl.mechanism.inter.broker.protocol=SCRAM-SHA-256
sasl.enabled.mechanisms=SCRAM-SHA-256

# ACL
allow.everyone.if.no.acl.found=false
super.users=User:admin
authorizer.class.name=kafka.security.auth.SimpleAclAuthorizer


# 用户
# ./bin/kafka-configs.sh --zookeeper 10.206.28.67:2181/k1 --alter --add-config 'SCRAM-SHA-256=[password=admin-secret-sfkafka]' --entity-type users --entity-name admin
# ./bin/kafka-configs.sh --zookeeper 10.206.28.67:2181/k1 --alter --add-config 'SCRAM-SHA-256=[password=kafka-manager-secret]' --entity-type users --entity-name kafka-manager
# ./bin/kafka-configs.sh --zookeeper 10.206.28.67:2181/k1 --describe --entity-type users
# ./bin/kafka-configs.sh --zookeeper 10.206.28.67:2181/k1 --alter --delete-config SCRAM-SHA-256 --entity-type users --entity-name kafka-manager


# ./bin/kafka-configs.sh --zookeeper 10.206.28.67:2181/k1 --alter --add-config 'SCRAM-SHA-256=[password=spring-kafka-producer-secret]' --entity-type users --entity-name spring-kafka-producer
# ./bin/kafka-configs.sh --zookeeper 10.206.28.67:2181/k1 --alter --add-config 'SCRAM-SHA-256=[password=spring-kafka-consumer-secret]' --entity-type users --entity-name spring-kafka-consumer

# 权限
# ./bin/kafka-acls.sh --authorizer-properties zookeeper.connect=10.206.28.67:2181/k1 --add --cluster --allow-principal User:kafka-manager
# ./bin/kafka-acls.sh --authorizer-properties zookeeper.connect=10.206.28.67:2181/k1 --list
# ./bin/kafka-acls.sh --authorizer-properties zookeeper.connect=10.206.28.67:2181/k1 --remove --cluster --allow-principal User:kafka-manager
# ./bin/kafka-acls.sh --authorizer-properties zookeeper.connect=10.206.28.67:2181/k1 --add --consumer --topic topic1 --topic topic1.DLT --group fooGroup --allow-principal User:spring-kafka-consumer
# ./bin/kafka-acls.sh --authorizer-properties zookeeper.connect=10.206.28.67:2181/k1 --add --producer --topic topic1  --allow-principal User:spring-kafka-producer
# ./bin/kafka-acls.sh --authorizer-properties zookeeper.connect=10.206.28.67:2181/k1 --add --producer --topic topic1.DLT  --allow-principal User:spring-kafka-consumer


## kafka_server_jaas.conf
KafkaServer {
    org.apache.kafka.common.security.scram.ScramLoginModule required
    username="admin"
    password="admin-secret-sfkafka";
};

## restart.sh
export KAFKA_HEAP_OPTS="-Xmx6G -Xms6G"

export KAFKA_JVM_PERFORMANCE_OPTS="-XX:MetaspaceSize=128m -XX:+UseG1GC -XX:MaxGCPauseMillis=20 -XX:InitiatingHeapOccupancyPercent=35 -XX:G1HeapRegionSize=16M -XX:MinMetaspaceFreeRatio=50 -XX:MaxMetaspaceFreeRatio=80"

export JMX_PORT=6062

# https://github.com/prometheus/jmx_exporter/blob/master/example_configs/kafka-2_0_0.yml
export KAFKA_OPTS="-javaagent:/home/appdeploy/agent/jmx_prometheus_javaagent-0.12.0.jar=7072:/home/appdeploy/agent/kafka-2_0_0.yml -Djava.security.auth.login.config=/home/appdeploy/kafka/config/kafka_server_jaas.conf"

./bin/kafka-server-stop.sh

sleep 3

./bin/kafka-server-start.sh -daemon config/server.properties

## server.properties
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements.  See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License.  You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# see kafka.server.KafkaConfig for additional details and defaults

############################# Server Basics #############################

# The id of the broker. This must be set to a unique integer for each broker.
broker.id=1

############################# Socket Server Settings #############################

# The address the socket server listens on. It will get the value returned from
# java.net.InetAddress.getCanonicalHostName() if not configured.
#   FORMAT:
#     listeners = listener_name://host_name:port
#   EXAMPLE:
#     listeners = PLAINTEXT://your.host.name:9092

# Protocol
listeners=SASL_PLAINTEXT://:9092
security.inter.broker.protocol=SASL_PLAINTEXT
sasl.mechanism.inter.broker.protocol=SCRAM-SHA-256
sasl.enabled.mechanisms=SCRAM-SHA-256

# ACL
allow.everyone.if.no.acl.found=false
super.users=User:admin
authorizer.class.name=kafka.security.auth.SimpleAclAuthorizer


# 用户
# ./kafka-configs.sh --zookeeper 10.206.28.67:2181/k1 --alter --add-config 'SCRAM-SHA-256=[password=admin-secret-sfkafka]' --entity-type users --entity-name admin
# ./kafka-configs.sh --zookeeper 10.206.28.67:2181/k1 --describe --entity-type users
#

# 权限
# ./bin/kafka-acls.sh --authorizer-properties zookeeper.connect=10.206.28.67:2181/k1 --add --cluster --allow-principal User:admin
# ./bin/kafka-acls.sh --authorizer-properties zookeeper.connect=10.206.28.67:2181/k1 --list
# ./bin/kafka-acls.sh --authorizer-properties zookeeper.connect=10.206.28.67:2181/k1 --remove --cluster --allow-principal User:admin
#

# Hostname and port the broker will advertise to producers and consumers. If not set,
# it uses the value for "listeners" if configured.  Otherwise, it will use the value
# returned from java.net.InetAddress.getCanonicalHostName().
#advertised.listeners=PLAINTEXT://your.host.name:9092

# Maps listener names to security protocols, the default is for them to be the same. See the config documentation for more details
#listener.security.protocol.map=PLAINTEXT:PLAINTEXT,SSL:SSL,SASL_PLAINTEXT:SASL_PLAINTEXT,SASL_SSL:SASL_SSL

# The number of threads that the server uses for receiving requests from the network and sending responses to the network
num.network.threads=3

# The number of threads that the server uses for processing requests, which may include disk I/O
num.io.threads=8

# The send buffer (SO_SNDBUF) used by the socket server
socket.send.buffer.bytes=102400

# The receive buffer (SO_RCVBUF) used by the socket server
socket.receive.buffer.bytes=102400

# The maximum size of a request that the socket server will accept (protection against OOM)
socket.request.max.bytes=104857600


############################# Log Basics #############################

# A comma separated list of directories under which to store log files
log.dirs=/home/appdeploy/data/kafka-logs

# The default number of log partitions per topic. More partitions allow greater
# parallelism for consumption, but this will also result in more files across
# the brokers.
num.partitions=8

# The number of threads per data directory to be used for log recovery at startup and flushing at shutdown.
# This value is recommended to be increased for installations with data dirs located in RAID array.
num.recovery.threads.per.data.dir=1

############################# Internal Topic Settings  #############################
# The replication factor for the group metadata internal topics "__consumer_offsets" and "__transaction_state"
# For anything other than development testing, a value greater than 1 is recommended for to ensure availability such as 3.
offsets.topic.replication.factor=3
transaction.state.log.replication.factor=3
transaction.state.log.min.isr=2

############################# Log Flush Policy #############################

# Messages are immediately written to the filesystem but by default we only fsync() to sync
# the OS cache lazily. The following configurations control the flush of data to disk.
# There are a few important trade-offs here:
#    1. Durability: Unflushed data may be lost if you are not using replication.
#    2. Latency: Very large flush intervals may lead to latency spikes when the flush does occur as there will be a lot of data to flush.
#    3. Throughput: The flush is generally the most expensive operation, and a small flush interval may lead to excessive seeks.
# The settings below allow one to configure the flush policy to flush data after a period of time or
# every N messages (or both). This can be done globally and overridden on a per-topic basis.

# The number of messages to accept before forcing a flush of data to disk
#log.flush.interval.messages=10000

# The maximum amount of time a message can sit in a log before we force a flush
#log.flush.interval.ms=1000

############################# Log Retention Policy #############################

# The following configurations control the disposal of log segments. The policy can
# be set to delete segments after a period of time, or after a given size has accumulated.
# A segment will be deleted whenever *either* of these criteria are met. Deletion always happens
# from the end of the log.

# The minimum age of a log file to be eligible for deletion due to age
log.retention.hours=72

# A size-based retention policy for logs. Segments are pruned from the log unless the remaining
# segments drop below log.retention.bytes. Functions independently of log.retention.hours.
#log.retention.bytes=1073741824

# The maximum size of a log segment file. When this size is reached a new log segment will be created.
log.segment.bytes=1073741824

# The interval at which log segments are checked to see if they can be deleted according
# to the retention policies
log.retention.check.interval.ms=300000

############################# Zookeeper #############################

# Zookeeper connection string (see zookeeper docs for details).
# This is a comma separated host:port pairs, each corresponding to a zk
# server. e.g. "127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002".
# You can also append an optional chroot string to the urls to specify the
# root directory for all kafka znodes.
zookeeper.connect=10.206.28.67:2181,10.206.28.67:2181,10.206.28.67:2181/k1

# Timeout in ms for connecting to zookeeper
zookeeper.connection.timeout.ms=6000


############################# Group Coordinator Settings #############################

# The following configuration specifies the time, in milliseconds, that the GroupCoordinator will delay the initial consumer rebalance.
# The rebalance will be further delayed by the value of group.initial.rebalance.delay.ms as new members join the group, up to a maximum of max.poll.interval.ms.
# The default value for this is 3 seconds.
# We override this to 0 here as it makes for a better out-of-the-box experience for development and testing.
# However, in production environments the default value of 3 seconds is more suitable as this will help to avoid unnecessary, and potentially expensive, rebalances during application startup.
group.initial.rebalance.delay.ms=0


############################# Topic #############################
auto.create.topics.enable=false
delete.topic.enable=true
	KafkaServer {
	org.apache.kafka.common.security.scram.ScramLoginModule required
	username="admin"
	password="admin-secret-sfkafka";
	};
	export KAFKA_HEAP_OPTS="-Xmx6G -Xms6G"

	export KAFKA_JVM_PERFORMANCE_OPTS="-XX:MetaspaceSize=128m -XX:+UseG1GC -XX:MaxGCPauseMillis=20 -XX:InitiatingHeapOccupancyPercent=35 -XX:G1HeapRegionSize=16M -XX:MinMetaspaceFreeRatio=50 -XX:MaxMetaspaceFreeRatio=80"

	export JMX_PORT=6062

	# https://github.com/prometheus/jmx_exporter/blob/master/example_configs/kafka-2_0_0.yml
	export KAFKA_OPTS="-javaagent:/home/appdeploy/agent/jmx_prometheus_javaagent-0.12.0.jar=7072:/home/appdeploy/agent/kafka-2_0_0.yml -Djava.security.auth.login.config=/home/appdeploy/kafka/config/kafka_server_jaas.conf"

	./bin/kafka-server-stop.sh

	sleep 3

	./bin/kafka-server-start.sh -daemon config/server.properties
	# Licensed to the Apache Software Foundation (ASF) under one or more
	# contributor license agreements. See the NOTICE file distributed with
	# this work for additional information regarding copyright ownership.
	# The ASF licenses this file to You under the Apache License, Version 2.0
	# (the "License"); you may not use this file except in compliance with
	# the License. You may obtain a copy of the License at
	#
	# http://www.apache.org/licenses/LICENSE-2.0
	#
	# Unless required by applicable law or agreed to in writing, software
	# distributed under the License is distributed on an "AS IS" BASIS,
	# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	# See the License for the specific language governing permissions and
	# limitations under the License.

	# see kafka.server.KafkaConfig for additional details and defaults

	############################# Server Basics #############################

	# The id of the broker. This must be set to a unique integer for each broker.
	broker.id=1

	############################# Socket Server Settings #############################

	# The address the socket server listens on. It will get the value returned from
	# java.net.InetAddress.getCanonicalHostName() if not configured.
	# FORMAT:
	# listeners = listener_name://host_name:port
	# EXAMPLE:
	# listeners = PLAINTEXT://your.host.name:9092

	# Protocol
	listeners=SASL_PLAINTEXT://:9092
	security.inter.broker.protocol=SASL_PLAINTEXT
	sasl.mechanism.inter.broker.protocol=SCRAM-SHA-256
	sasl.enabled.mechanisms=SCRAM-SHA-256

	# ACL
	allow.everyone.if.no.acl.found=false
	super.users=User:admin
	authorizer.class.name=kafka.security.auth.SimpleAclAuthorizer


	# 用户
	# ./kafka-configs.sh --zookeeper 10.206.28.67:2181/k1 --alter --add-config 'SCRAM-SHA-256=[password=admin-secret-sfkafka]' --entity-type users --entity-name admin
	# ./kafka-configs.sh --zookeeper 10.206.28.67:2181/k1 --describe --entity-type users
	#

	# 权限
	# ./bin/kafka-acls.sh --authorizer-properties zookeeper.connect=10.206.28.67:2181/k1 --add --cluster --allow-principal User:admin
	# ./bin/kafka-acls.sh --authorizer-properties zookeeper.connect=10.206.28.67:2181/k1 --list
	# ./bin/kafka-acls.sh --authorizer-properties zookeeper.connect=10.206.28.67:2181/k1 --remove --cluster --allow-principal User:admin
	#

	# Hostname and port the broker will advertise to producers and consumers. If not set,
	# it uses the value for "listeners" if configured. Otherwise, it will use the value
	# returned from java.net.InetAddress.getCanonicalHostName().
	#advertised.listeners=PLAINTEXT://your.host.name:9092

	# Maps listener names to security protocols, the default is for them to be the same. See the config documentation for more details
	#listener.security.protocol.map=PLAINTEXT:PLAINTEXT,SSL:SSL,SASL_PLAINTEXT:SASL_PLAINTEXT,SASL_SSL:SASL_SSL

	# The number of threads that the server uses for receiving requests from the network and sending responses to the network
	num.network.threads=3

	# The number of threads that the server uses for processing requests, which may include disk I/O
	num.io.threads=8

	# The send buffer (SO_SNDBUF) used by the socket server
	socket.send.buffer.bytes=102400

	# The receive buffer (SO_RCVBUF) used by the socket server
	socket.receive.buffer.bytes=102400

	# The maximum size of a request that the socket server will accept (protection against OOM)
	socket.request.max.bytes=104857600


	############################# Log Basics #############################

	# A comma separated list of directories under which to store log files
	log.dirs=/home/appdeploy/data/kafka-logs

	# The default number of log partitions per topic. More partitions allow greater
	# parallelism for consumption, but this will also result in more files across
	# the brokers.
	num.partitions=8

	# The number of threads per data directory to be used for log recovery at startup and flushing at shutdown.
	# This value is recommended to be increased for installations with data dirs located in RAID array.
	num.recovery.threads.per.data.dir=1

	############################# Internal Topic Settings #############################
	# The replication factor for the group metadata internal topics "__consumer_offsets" and "__transaction_state"
	# For anything other than development testing, a value greater than 1 is recommended for to ensure availability such as 3.
	offsets.topic.replication.factor=3
	transaction.state.log.replication.factor=3
	transaction.state.log.min.isr=2

	############################# Log Flush Policy #############################

	# Messages are immediately written to the filesystem but by default we only fsync() to sync
	# the OS cache lazily. The following configurations control the flush of data to disk.
	# There are a few important trade-offs here:
	# 1. Durability: Unflushed data may be lost if you are not using replication.
	# 2. Latency: Very large flush intervals may lead to latency spikes when the flush does occur as there will be a lot of data to flush.
	# 3. Throughput: The flush is generally the most expensive operation, and a small flush interval may lead to excessive seeks.
	# The settings below allow one to configure the flush policy to flush data after a period of time or
	# every N messages (or both). This can be done globally and overridden on a per-topic basis.

	# The number of messages to accept before forcing a flush of data to disk
	#log.flush.interval.messages=10000

	# The maximum amount of time a message can sit in a log before we force a flush
	#log.flush.interval.ms=1000

	############################# Log Retention Policy #############################

	# The following configurations control the disposal of log segments. The policy can
	# be set to delete segments after a period of time, or after a given size has accumulated.
	# A segment will be deleted whenever either of these criteria are met. Deletion always happens
	# from the end of the log.

	# The minimum age of a log file to be eligible for deletion due to age
	log.retention.hours=72

	# A size-based retention policy for logs. Segments are pruned from the log unless the remaining
	# segments drop below log.retention.bytes. Functions independently of log.retention.hours.
	#log.retention.bytes=1073741824

	# The maximum size of a log segment file. When this size is reached a new log segment will be created.
	log.segment.bytes=1073741824

	# The interval at which log segments are checked to see if they can be deleted according
	# to the retention policies
	log.retention.check.interval.ms=300000

	############################# Zookeeper #############################

	# Zookeeper connection string (see zookeeper docs for details).
	# This is a comma separated host:port pairs, each corresponding to a zk
	# server. e.g. "127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002".
	# You can also append an optional chroot string to the urls to specify the
	# root directory for all kafka znodes.
	zookeeper.connect=10.206.28.67:2181,10.206.28.67:2181,10.206.28.67:2181/k1

	# Timeout in ms for connecting to zookeeper
	zookeeper.connection.timeout.ms=6000


	############################# Group Coordinator Settings #############################

	# The following configuration specifies the time, in milliseconds, that the GroupCoordinator will delay the initial consumer rebalance.
	# The rebalance will be further delayed by the value of group.initial.rebalance.delay.ms as new members join the group, up to a maximum of max.poll.interval.ms.
	# The default value for this is 3 seconds.
	# We override this to 0 here as it makes for a better out-of-the-box experience for development and testing.
	# However, in production environments the default value of 3 seconds is more suitable as this will help to avoid unnecessary, and potentially expensive, rebalances during application startup.
	group.initial.rebalance.delay.ms=0


	############################# Topic #############################
	auto.create.topics.enable=false
	delete.topic.enable=true