Exhibitor

Table of Contents

1. Overview
2. Module Description
3. Setup
   • What exhibitor affects
   • Setup requirements
   • Beginning with exhibitor
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.
7. Development - Guide for contributing to the module

Overview

Puppet module for managing/installing exhibitor for Apache zookeeper. Works with Ubuntu 12.04 and 14.04, possibly other distros. Uses Apache Maven command line to download the artifacts.

Module Description

This module includes a POM file for exhibitor and uses it as the configuration for a Maven build resulting in a .jar file in the installation directory. The configuration options available in the exhibitor config file exhibitor.properties can be passed through from the manifest calling the class.

Setup

class { 'exhibitor':
    servers => ['zk-00-01.domain.com', 'zk-00-02.domain.com'],
  }

What exhibitor affects

* /etc/default/exhibitor
* /etc/init.d/exhibitor
* $install_dir/exhibitor.properties
* $install_dir/exhibitor-stndalone-${version}.jar

Setup Requirements OPTIONAL

exhibitor requires a list of servers, although it will default to 'localhost' for a standalone

Beginning with exhibitor

class { 'exhibitor':
    servers => ['zk-00-01.domain.com', 'zk-00-02.domain.com'],
  }

Usage

Although you may want to modify the defaults for exhibitor.properties, you should set your own preferences for these

settings based on your zookeeper installation(s):
exhibitor version $version = '1.5.5',
exhibitor install dir $install_dir = '/opt/exhibitor',
exhibitor conf dir $conf_dir = '/etc/exhibitor',
other exhibitor servers to monitor $servers = ['localhost'],
/etc/default/exhibitor settings $defaultfile_opts = {
    'port'        => '8080',
    'configtype'  => 'file',
    'fsconfigdir' =>  '/opt/exhibitor',
    'hostname'    =>  $::fqdn,
  },
zookeeper settings
$zk_data_dir    = '/mnt/zookeeper/data',
$zk_log_dir     = '/mnt/zookeeper/log',
$zk_install_dir = '/usr/share/zookeeper'

Reference

manifests: init.pp install.pp, config.pp, service.pp

Limitations

only tested on Ubuntu 12.04 and 14.04 so far

Development

please contribute!

============