simp / pupmod-simp-swap

A SIMP Puppet module for managing swappiness

Table of Contents

• Description
  • This is a SIMP module
• Setup
  • What swap affects
  • Beginning with swap
• Limitations
• Development
  • Acceptance tests

Description

This module manages the swappiness of a system, either directly or with a dynamic script.

See REFERENCE.md for API details.

This is a SIMP module

This module is a component of the System Integrity Management Platform, a compliance-management framework built on Puppet.

If you find any issues, they may be submitted to our bug tracker.

Setup

What swap affects

• The sysctl value vm.swappiness.
• If enabled, the ability for the system to monitor the amount of free RAM and dynamically set the swappiness based on monitored conditions.
  • See manifests/init.pp for details.

Beginning with swap

To use this class, just include it on your system:

include 'swap'

Limitations

SIMP Puppet modules are generally intended for use on Red Hat Enterprise Linux and compatible distributions, such as CentOS. Please see the metadata.json file for the most up-to-date list of supported operating systems, Puppet versions, and module dependencies.

Development

Please read our Contribution Guide.

Acceptance tests

This module includes Beaker acceptance tests using the SIMP Beaker Helpers. By default the tests use Vagrant with VirtualBox as a back-end; Vagrant and VirtualBox must both be installed to run these tests without modification. To execute the tests run the following:

bundle install
bundle exec rake beaker:suites

Please refer to the SIMP Beaker Helpers documentation for more information.