amq_streams_zookeeper

Zookeeper Role

Perform installation and configuration of Zookeeper ensemble.

This role requires to have a zookeepers group (identified by the amq_streams_zookeeper_inventory_group variable) in the inventory file to identify each node of he Zookeeper cluster. This group is used to set up the right configuration files in order to establish the communication between Zookeeper cluster members.

Example of inventory:

[zookeepers]
zknode1
zknode2
zknode3

Role Defaults

Variable	Description	Default
amq_streams_zookeeper_enabled	Enable zookeeper ensemble	true
amq_streams_zookeeper_config	Zookeeper configuration file	/etc/amq_streams_zookeeper.properties
amq_streams_zookeeper_config_template	Zookeeper template configuration file	templates/zookeeper.properties.j2
amq_streams_zookeeper_server_start	Zookeeper server start file	{{ amq_streams_common_home }}/bin/zookeeper-server-start.sh
amq_streams_zookeeper_user	Zookeeper user	amq_streams_zookeeper
amq_streams_zookeeper_group	User group	amq_streams
amq_streams_zookeeper_service_name	Zookeeper service name	amq_streams_zookeeper
amq_streams_zookeeper_service_config_template	Zookeeper template service file	templates/service.conf.j2
amq_streams_zookeeper_service_env_file	Zookeeper service environment configuration file	/etc/zookeeper.conf
amq_streams_zookeeper_data_dir	Zookeeper data folder	/var/lib/{{ amq_streams_zookeeper_service_name }}/
amq_streams_zookeeper_logs_dir	Zookeeper logs folder	/var/log/{{ amq_streams_zookeeper_service_name }}/
amq_streams_zookeeper_max_client_cnxns	Max client connections	0
amq_streams_zookeeper_admin_enable_server	Enable zookeeper administration server	false
amq_streams_zookeeper_instance_count_enabled	Count zookeeper instances	true
amq_streams_zookeeper_instance_count		0
amq_streams_zookeeper_zookeeper_id	Zookeeper variable to identify the zookeeper in a cluster
amq_streams_zookeeper_java_opts	Default values to apply to KAFKA_OPTS env variable
amq_streams_zookeeper_java_heap_opts	Default values to apply to KAFKA_HEAP_OPTS env variable	-Xmx512M -Xms512M
amq_streams_zookeeper_java_performance_opts	Default values to apply to KAFKA_JVM_PERFORMANCE_OPTS env variable
amq_streams_zookeeper_java_java_gc_log_opts	Default values to apply to KAFKA_GC_LOG_OPTS env variable
amq_streams_zookeeper_java_jmx_opts	Default values to apply to KAFKA_JMX_OPTS env variable
amq_streams_zookeeper_host		localhost
amq_streams_zookeeper_port		2181
amq_streams_firewalld_package_name		- firewalld
amq_streams_firewalld_enabled		false
amq_streams_zookeeper_init_limit		5
amq_streams_zookeeper_sync_limit		2
amq_streams_zookeeper_cluster_port_start		2888
amq_streams_zookeeper_cluster_port_end		3888
amq_streams_zookeeper_auth_enabled	Enable Zookeeper authentication	false
amq_streams_zookeeper_auth_config	JAAS file to set up Zookeeper authentication	/etc/zookeeper-jaas.conf
amq_streams_zookeeper_auth_config_template	JAAS template for Zookeeper authentication	templates/zookeeper-jaas.conf.j2
amq_streams_zookeeper_inventory_group	Identify the group of zookeeper nodes	groups['zookeepers']

Role Variables

The following are a set of required variables for the role:

Variable	Description	Required
amq_streams_zookeeper_auth_user	Zookeeper user to authenticate. Mandatory if amq_streams_zookeeper_auth_enabled: true	''
amq_streams_zookeeper_auth_pass	Zookeeper user password to authenticate. Mandatory if amq_streams_zookeeper_auth_enabled: true	''

License

Apache License v2.0 or later

Author Information

• Romain Pelisse
• Guido Grazioli
• Roman Martin