Forge Home


Install, configures, and manages the Percona products.


8,844 latest version

5.0 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.4.0 (latest)
  • 0.3.0
  • 0.2.0
  • 0.1.7
  • 0.1.5
  • 0.1.4
  • 0.1.3
  • 0.1.2
  • 0.1.0
released Oct 3rd 2018
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 6.0.0
  • , , , ,

Start using this module

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

Add this module to your Puppetfile:

mod 'hfm-percona', '0.4.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

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

Manually install this module globally with Puppet module tool:

puppet module install hfm-percona --version 0.4.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/percona — version 0.4.0 Oct 3rd 2018


Build Status Puppet Forge

Table of Contents

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


This module installs, configures, and manages the Percona products.


Beginning with percona

To configure the percona::repo with default parameters, declare the percona::repo class.

include 'percona::repo'


Configuring modules

class { 'percona::repo':
  percona_release_basearch_enabled => 0,
  percona_release_noarch_enabled   => 0,

Configuring modules from Hiera

# default off
percona::repo::percona_release_basearch_enabled: 0
percona::repo::percona_release_noarch_enabled: 0


Public Classes

Private Classes

  • percona::rpm_gpg_key: Import the RPM GPG key for the Percona.


Class: percona::toolkit

  • ensure: What state the package should be in. Default to installed.

Class: percona::xtrabackup

  • ensure: What state the package should be in. Default to installed.
  • version: Specify package version. Valid options: a string. Default to undef.


This module has been tested on:

  • RedHat Enterprise Linux 5, 6, 7
  • CentOS 5, 6, 7
  • Scientific Linux 5, 6, 7
  • Ubuntu 12.04, 14.04, 16.04
  • Debian 6, 7, 8


Running tests

The STNS puppet 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 all
  • Acceptance tests:
# Set your DOCKER_HOST variable
$ eval "$(docker-machine env default)"

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