Forge Home


Install, configures, and manages h2o


5,806 latest version

4.3 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.1.0 (latest)
released May 27th 2017
This version is compatible with:
  • Puppet Enterprise 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.0.0 < 5.0.0
  • , , , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'hfm-h2o', '0.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add hfm-h2o
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install hfm-h2o --version 0.1.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



hfm/h2o — version 0.1.0 May 27th 2017

h2o Build Status Puppet Forge

Table of Contents

  1. Description
  2. Setup - The basics of getting started with h2o
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module


The h2o module handles installing, configuring, and running h2o.


Setup Requirements

Beginning with h2o

To install the h2o with default parameters, declare the h2o class.

include ::h2o


Configuring h2o

class { 'h2o':
  package_ensure => '2.2.2-1~ubuntu16.04.1',

Configuring modules from Hiera

h2o::package_ensure: '2.2.2-1~ubuntu16.04.1'


Public Classes

  • h2o: Installs and runs h2o.

Private Classes

  • h2o::install: Installs the h2o package.
  • h2o::repo: Manages the h2o repository.
  • h2o::repo::yum: Manages the Yum repository.
  • h2o::repo::apt: Manages the Apt sources.
  • h2o::service: Manages service.


h2o class

  • repo_ensure: Specifies whether the h2o repository should exist. Type is the String. Default: 'present'.
  • package_ensure: What state the package should be in. Type is the String. Default: 'installed'.
  • service_ensure: Whether a service should be running. Type is the String. Default: 'running'.
  • service_enable: Whether a service should be enabled to start at boot. Type is the Boolean. Default: true.


This module has been tested on:

  • RedHat Enterprise Linux 6, 7
  • CentOS 6, 7
  • Scientific Linux 6, 7
  • Fedora 22, 23, 24, 25
  • Debian 7, 8
  • Ubuntu 14.04, 16.04


Running tests

The tinyproxy module contains tests for both rspec-puppet (unit tests) and beaker-rspec (acceptance tests) to verify functionality. For detailed information on using these tools, please see their respective documentation.

Testing quickstart

Unit tests:

$ bundle install
$ bundle exec rake test

Acceptance tests using docker:

# List available beaker nodesets
$ bundle exec rake beaker_nodes

# Run beaker acceptance tests
$ BEAKER_set=xenial bundle exec rake beaker