README.md

Puppet module: sysctl

This is a Puppet module for sysctl It provides only package installation and file configuration.

Based on Example42 layouts by Alessandro Franceschi / Lab42

Sysctl type and sysyctl::value define have been copied from Duritong's puppet-sysctl https://github.com/duritong/puppet-sysctl

Official site: http://www.example42.com

Official git repository: http://github.com/example42/puppet-sysctl

Released under the terms of Apache 2 License.

This module requires the presence of Example42 Puppi module in your modulepath.

USAGE

You can decide to manage sysctl with 2 alternative methods:

• Manage the /etc/sysctl.conf file (and /etc/sysctl.d directory) with the (Example42 standard) source and termplate parameters
• Manage single sysctl entries with the sysctl::value define

• Use custom sources for /etc/sysctl.conf

    class { 'sysctl':
      source => [ "puppet:///modules/example42/sysctl/sysctl.conf-${hostname}" , "puppet:///modules/example42/sysctl/sysctl.conf" ], 
    }
  

• Use custom source directory for the content of /etc/sysctl.d/

    class { 'sysctl':
      source_dir       => 'puppet:///modules/example42/sysctl/conf/',
      source_dir_purge => false, # Set to true to purge any existing file not present in $source_dir
    }
  

• Use custom template for /etc/sysctl.conf . Note that template and source arguments are alternative.

    class { 'sysctl':
      template => 'example42/sysctl/sysctl.conf.erb',
    }
  

• Manage atomically single sysctl entries (alternative to the source and template options):

    sysctl::value { "vm.nr_hugepages": value => "1583"}
  

• Automatically include a custom subclass

    class { 'sysctl':
      my_class => 'example42::my_sysctl',
    }
  

Puppet 4

• Enable class in your yaml or site.pp file (eg: something like so with site.pp) hiera_include('classes') .. - sysctl

• Add value to module of the yaml eg: 40_modules/sysctl.yaml

  sysctl::values: net.ipv4.icmp_echo_ignore_broadcasts: value: '1'

Puppet 4 problems

• I get error "Parameter noop failed on Package[procps]: Invalid value "". Valid values are true, false."

  Add value to module of the yaml eg: 40_modules/sysctl.yaml: sysctl::noops: false

• I get error "Parameter source failed on File[sysctl.dir]: Cannot use relative URLs ''"

  Add value to module of the yaml eg: 40_modules/sysctl.yaml: sysctl::source_dir: '/etc/sysctl.d'