cookbook 'apache_zookeeper', '= 0.3.0'
apache_zookeeper
(22) Versions
0.3.0
-
Follow17
Installs/Configures Apache Zookeeper
cookbook 'apache_zookeeper', '= 0.3.0', :supermarket
knife supermarket install apache_zookeeper
knife supermarket download apache_zookeeper
Apache Zookeeper Cookbook
Installs and configures Apache Zookeeper.
View the Change Log to see what has changed.
Supports
- CentOS
- Ubuntu
Usage
Using the default attributes will setup a single Zookeeper server in standalone mode.
If you are wanting to setup Zookeeper in a multi-server cluster make sure to fill out the
node["zookeeper"]["servers"]
attribute with an array of fqdn/hostnames/ips/machinename/ec2_hostname/ec2_ip
of your zookeeper servers. This array is used to calculate the server ids for each zookeeper.
You can also provide the server ids yourself by including values for the attributes
node["zookeeper"]["zoo.cfg"]["server.[ID]"]
. If this is done you don't have to provide the
node["zookeeper"]["servers"]
attribute.
What does the installation look like
By default the installation will look like,
zkCli | /usr/bin/zkCli - The Zookeeper cli binary command
/opt/zookeeper/* - All of Zookeeper's files (config, binaries, event handlers, logs...)
/etc/init.d/zookeeper - An init.d script to start/stop zookeeper. You can use service
zookeeper [start|stop|restart|status] instead
Unique Quorum and Leader Election Ports
It is possible to provide unique quorum and leader election ports via node["zookeeper"]["servers"]
attribute
or node["zookeeper"]["zoo.cfg"]["server.[ID]"]
by specifying the hostname followed by the quorum and
leader election ports like this,
node["zookeeper"]["servers"] = ["host1:2188:3188", "host2:2188:3188", "host3:2188:3188"]
or
node["zookeeper"]["zoo.cfg"]["server.1"] = "host1:2188:3188"
...
Environment Variables
Should note that the zkServer.sh
and other various scripts provided by zookeeper taken in various environment variables to tweak
runtime settings. Here are some,
-
ZOO_LOG_DIR
: Overwrites log4jzookeeper.log.file
. Defaults to.
if not set which is why we provide a default value for it to thenode["zookeeper"]["log_directory"]
value. -
ZOO_LOG4J_PROP
: Overwrites log4jzookeeper.root.logger
. Defaults to'INFO, CONSOLE'
if not set which is why we provide a default value for it'INFO,CONSOLE,ROLLINGFILE'
-
JMXDISABLE
: Disables jmx. Defaults to enabling JMX. To disable set to any value -
SERVER_JVMFLAGS
: JVM flags for the server process
Attributes
-
node["zookeeper"]["user"]
: The user that owns the Zookeeper installation (default="zookeeper") -
node["zookeeper"]["group"]
: The group that owns the Zookeeper installation (default="zookeeper") -
node["zookeeper"]["open_file_limit"]
: The open file limit for the zookeeper user (default=32768) -
node["zookeeper"]["max_processes"]
: The max processes limit for the zookeeper user (default=1024) -
node["zookeeper"]["env_vars"]
: The environment variables set for the zookeeper user (default={"ZOO_LOG_DIR" =>node["zookeeper"]["log_directory"]
, "ZOO_LOG4J_PROP" => "'INFO, CONSOLE, ROLLINGFILE'"}) -
node["zookeeper"]["servers"]
: The array of fqdn/hostnames/ips for the zookeeper servers in the cluster (default=[]) -
node["zookeeper"]["follower_port"]
: The port used by zookeeper followers (default=2888) -
node["zookeeper"]["election_port"]
: The port used for zookeeper elections (default=3888) -
node["zookeeper"]["version"]
: The version of the Serf agent to install (default="3.4.5") -
node["zookeeper"]["binary_url"]
: The full binary url of Zookeeper. If you override this value make sure to provide a valid and up to date value fornode["zookeeper"]["version"]
(default=File.join node["zookeeper"]["mirror"], "zookeeper-#{node["zookeeper"]["version"]}", "zookeeper-#{node["zookeeper"]["version"]}.tar.gz"
) -
node["zookeeper"]["base_directory"]
: The base directory Zookeeper should be installed into (default="/opt/zookeeper") -
node["zookeeper"]["log_directory"]
: The log directory for Zookeeper (default="#{node["zookeeper"]["base_directory"]}/logs"
) -
node["zookeeper"]["zoo.cfg"][*]
: The key/values set for thezoo.cfg
config file (see attributes file for defaults) -
node["zookeeper"]["log4j.properties"][*]
: The key/values set for thelog4j.properties
config file (see attributes file for defaults)
Dependent cookbooks
java >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Change Log
0.3.0
- [Enhancement] Issue-10 : Additional attribute tweaks
0.2.2
- [Bug] Issue-11 : Release without PaxHeaders
0.2.1
- [Enhancement] Issue-9 : Set zookeeper log directory by default
- [Bug] Issue-8 : Client port is always appended to hosts
- [Enhancement] Issue-2 : Add tests
0.2.0
- [Feature] Issue-7 : Additional attributes
0.1.3
- [Bug] Issue-6 : Create myid file
0.1.2
- [Bug] Issue-5 : Init script does not support chkconfig
0.1.1
- [Bug] Issue-4 : Metadata does not include java depends
0.1.0
- [Feature] Issue-1 : Initial Cookbook