Forge Home

holland

Puppet module to manage Holland Backup Manager

5,826 downloads

4,373 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

  • 1.1.0 (latest)
  • 1.0.0
released Sep 4th 2019
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
  • Puppet >= 4.10.0 < 7.0.0
  • , ,

Start using this module

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

Add this module to your Puppetfile:

mod 'rharrison-holland', '1.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add rharrison-holland
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install rharrison-holland --version 1.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.

Download

Documentation

rharrison/holland — version 1.1.0 Sep 4th 2019

holland

Puppet module to manage Holland Backup Manager

Table of Contents

  1. Description
  2. Setup - The basics of getting started with holland
  3. Usage - Configuration options and additional functionality
  4. Limitations - OS compatibility, etc.
  5. Development - Guide for contributing to the module

Description

This module will setup the Holland Backup Manager and manage its providers and backup sets. Currently only the mongodump and mysqldump providers are supported by this module.

Setup

Setup Requirements

This module requires puppetlabs/stdlib and if you are using Puppet 6 or above it also requires puppetlabs/augeas_core

mongodump Requirements

If you are going to use the holland-mongodump provider you will need to make sure the mongodump command is installed and in the path outside of the module as the package does not pull it in as a dependency. I'm not working around this in the module because of the many different ways to install the utility. It will need to match the version and deployment method of your MongoDB deployment.

Beginning with holland

At a minimum you will need to simply include the main holland class and one of the providers.

include ::holland
include ::holland::mysqldump

Usage

Please see the REFFERENCE.md for the reference documentation and examples of usage.

Limitations

The version of holland-mongodump that is included in the EPEL pulls in the python-pymongo package from EPEL as a dependency. This package matches with the version of MongoDB also included in EPEL but will have authentication errors if you're trying to backup more recent versions of MongoDB. To work around this issue I've used the following hack to upgrade pymongo via pip as a workaround.

package { 'pymongo':
  ensure          => '3.7.2',
  install_options => '--upgrade',
  provider        => 'pip',
  require         => Package['holland-mongodump', 'python2-pip'],
}

Development

Pull requests are welcome especially for unit tests, and additional providers.

TODO

  • Support more backup providers
  • Add logging format config to main Holland configuration
  • Support historic backup set size calculation for MySQL providers
  • Support "hook" commands to be run before, after, or on failure of a backup.
  • Better unit tests