Forge Home

bacula

Puppet module for bacula

Javier Bértoli

netmanagers

10,501 downloads

9,650 latest version

3.8 quality score

Version information

  • 1.1.1 (latest)
  • 1.1.0
  • 1.0.1
  • 1.0.0
released May 31st 2014

Start using this module

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

Add this declaration to your Puppetfile:

mod 'netmanagers-bacula', '1.1.1'
Learn more about managing modules with a Puppetfile

Add this module to a Bolt project:

bolt module add netmanagers-bacula
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install netmanagers-bacula --version 1.1.1

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

netmanagers/bacula — version 1.1.1 May 31st 2014

Puppet module: bacula

This is a Puppet module for bacula based on the second generation layout ("NextGen") of Example42 Puppet Modules.

Made by

  • Sebastián Quaino / Netmanagers
  • Javier Bértoli / Netmanagers
  • Dan Schaefer / Schaeferzone

Based on Example42 modules made by Alessandro Franceschi / Lab42

Official site: http://github.com/netmanagers/puppet-bacula

Official git repository: http://github.com/netmanagers/puppet-bacula

Released under the terms of Apache 2 License.

This module requires functions provided by the Example42 Puppi module (you need it even if you don't use and install Puppi)

For detailed info about the logic and usage patterns of Example42 modules check the DOCS directory on Example42 main modules set.

USAGE - Basic management

  • Bacula consists of at least three different applications (a Director, a Storage manager, Clients) and a Console (CLI, GUI, etc.) to manage these resources. This module provides classes and defines to install and configure them all, with a fair degree of customization. Some parameters can be given specifically for each of these applications while others are common to all the classes and defines, for consistency.

    Please check the docs directory for the available parameters on each class and define.

    Als check params.pp, init.pp and the manifests for details.

  • Install bacula with default settings: this, by default, will install only the Client daemon (bacula-fd) and, following Ex42 modules standard practice, will leave all the default configuration as provided by your distribution.

class { 'bacula': }

You can choose which part of bacula to install on a host

class { 'bacula:
  manage_client   => true,
  manage_storage  => false,
  manage_director => true,
  manage_console  => false,
}
  • Install a specific version of bacula storage package
class { 'bacula':
  manage_storage => true,
  version        => '1.0.1',
}

Keep present that the client will ALWAYS be installed and managed, unless explicitelly said so setting manage_client to false

class { 'bacula':
  manage_client  => false,
  manage_storage => true,
  version        => '1.0.1',
}
  • Disable bacula service.
class { 'bacula':
  disable => true
}
  • Remove bacula package
class { 'bacula':
  absent => true
}
  • Enable auditing without making changes on existing bacula configuration files
class { 'bacula':
  audit_only => true
}
  • Module dry-run: Do not make any change on all the resources provided by the module
class { 'bacula':
  noops => true
}

USAGE - Overrides and Customizations

  • For each of bacula applications managed you can override its configuration using *_ source of *_template variables.

  • Use custom source directory for the whole configuration dir

class { 'bacula':
  source_dir            => 'puppet:///modules/example42/bacula/conf/',
  source_director_purge => false, # Set to true to purge any existing file not present in $source_dir
}
  • Use custom sources for config file
class { 'bacula':
  manage_client   => false,
  manage_director => true,
  director_source => [ "puppet:///modules/netmanagers/bacula/bacula-dir.conf-${hostname}",
                       "puppet:///modules/example42/bacula/bacula-dir.conf" ], 
}
  • Templating in this module is strongly recommended, but differs from other templatings in the final result of bacula's configuration dir structure. As bacula permits you to split configuration in different files to improve manageability, we make use of this as soon as you choose to use templates for any of the applications. We also provide templates for all of bacula's daemons. Check the templates dir for more details. Remember that you can always provide your own if none of these suits your particular case.

    When using templates in this module, the resulting configuration directory ends up like this (module's default values considered):

      /etc/bacula/
              bacula-dir.conf       <= Main director config file
              director.d/           <= Director's stanzas
                 catalog-*.conf          - Catalogs
                 fileset-*.conf          - Filesets
                 job-*.conf              - Jobs 
                 jobdef-*.conf           - Jobs 
                 messages-*.conf         - Messages
                 pool-*.conf             - Pools
                 schedule-*.conf         - Schedules
                 storage-*.conf          - Storages
              clients.d/            <= Each client DIRECTOR's entry
                 client1.conf
                 client2.conf
                 clientN.conf
              bacula-sd.conf        <= Main storage config file
              storage.d/            <= Storage's stanzas
                 device-*.conf           - Devices
              bacula-fd.conf        <= Client config file
              bconsole.conf         <= Console config file
    

    For each possible stanza we provide a define to create them. Please check the manifests headers to see the available parameters for each.

  • Add a new device to the storage daemon, using the included template and default values:

bacula::storage::device { 'new_device':
  media_type     => 'File',
  archive_device => '/some/backup/dir',
}
  • Automatically include a custom subclass
class { 'bacula':
  my_class => 'example42::my_bacula',
}

USAGE - Example42 extensions management

  • Activate puppi (recommended, but disabled by default)
class { 'bacula':
  puppi => true,
}
  • Activate puppi and use a custom puppi_helper template (to be provided separately with a puppi::helper define ) to customize the output of puppi commands
class { 'bacula':
  puppi        => true,
  puppi_helper => 'myhelper', 
}
  • Activate automatic monitoring (recommended, but disabled by default). This option requires the usage of Example42 monitor and relevant monitor tools modules
class { 'bacula':
  monitor      => true,
  monitor_tool => [ 'nagios' , 'monit' , 'munin' ],
}
  • Activate automatic firewalling. This option requires the usage of Example42 firewall and relevant firewall tools modules
class { 'bacula':       
  firewall      => true,
  firewall_tool => 'iptables',
  firewall_src  => '10.42.0.0/24',
  firewall_dst  => $ipaddress_eth0,
}

CONTINUOUS TESTING

Travis {}[https://travis-ci.org/netmanagers/puppet-bacula]