puppet-kdump

Overview

This module manages the kdump service.

Usage

Use default actions of ensuring kdump is stopped

class { 'kdump': }

Example of how to enable kdump

class { 'kdump':
  enable => true,
}

Example of changing the configuration for kdump.conf.

The config_overrides is a hash that can be used to override the default configuration. Below is the default config_overrides.

class { 'kdump':
  enable => true,
  config_overrides => {
    'path' => '/var/crash',
    'core_collector' => 'makedumpfile -c --message-level 1 -d 31',
  },
}

Reference

http://treydock.github.io/puppet-kdump/

Development

Testing

Testing requires the following dependencies:

• rake
• bundler

Install gem dependencies

bundle install

Run unit tests

bundle exec rake spec

Further Information

• https://www.kernel.org/doc/Documentation/kdump/kdump.txt

Reference

Table of Contents

Classes

• kdump: Manage kdump

Classes

kdump

Manage kdump

Examples

Use default actions of ensuring kdump is stopped

class { 'kdump': }

Example of how to enable kdump

class { 'kdump':
  enable => true,
}

Parameters

The following parameters are available in the kdump class:

• enable
• crashkernel
• crashkernel_bootmode
• bootloader_config_path
• package_name
• service_name
• service_ensure
• service_enable
• service_hasstatus
• service_hasrestart
• config_path
• config_overrides
• kernel_parameter_provider
• manage_kernel_parameter
• grub_kdump_cfg

enable

Data type: Boolean

Set state of kdump. true - Ensure service running and crashkernel kernel argument set false - Ensure service stopped and crashkernel kernel argument absent

Default value: false

crashkernel

Data type: String

Kernel crashkernel argument value

Default value: 'auto'

crashkernel_bootmode

Data type: String

The bootmode for crashkernel kernel argument

Default value: 'all'

bootloader_config_path

Data type: Optional[Stdlib::AbsolutePath]

Path to boot loader config

Default value: undef

package_name

Data type: String

Package name that provides kdump.

Default value: 'kexec-tools'

service_name

Data type: String

Service name for kdump.

Default value: 'kdump'

service_ensure

Data type: Optional[String]

The service ensure property for kdump.

Default value: undef

service_enable

Data type: Optional[Boolean]

The service enable property for kdump.

Default value: undef

service_hasstatus

Data type: Boolean

The service hasstatus property for kdump.

Default value: true

service_hasrestart

Data type: Boolean

The service hasrestart property for kdump.

Default value: true

config_path

Data type: Stdlib::AbsolutePath

The configuration file path for kdump.

Default value: '/etc/kdump.conf'

config_overrides

Data type: Hash

Hash of config values to add to kdump.conf

Default value: {}

kernel_parameter_provider

Data type: String

The provider property for the kernel_parameter defined type.

Default value: 'grub2'

manage_kernel_parameter

Data type: Boolean

Controls if kernel_parameter resource is managed

Default value: true

grub_kdump_cfg

Data type: Optional[String]

Path to grub2 kdump config. Only used on Ubuntu.

Default value: undef

Change log

All notable changes to this project will be documented in this file. The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

v2.0.2 (2025-04-28)

Full Changelog

Fixed

• Fix RHEL9 default for crashkernel #27 (treydock)

v2.0.1 (2024-01-09)

Full Changelog

Fixed

• Fix merge function stdlib deprecation message #25 (ynnckvdv)

v2.0.0 (2023-09-20)

Full Changelog

Changed

• Update Debian and Ubuntu support #24 (treydock)
• BREAKING: Updates, Drop Puppet 6 and add Puppet 8 support #21 (treydock)

Added

• Support EL9 #23 (treydock)
• Update module dependencies #22 (treydock)

v1.0.0 (2022-03-19)

Full Changelog

Changed

• Major updates #17 (treydock)

Added

• Add manage_kernel_parameter parameter #18 (treydock)

v0.4.1 (2019-08-19)

Full Changelog

Fixed

• Increase upper bound of stdlib module dependency #15 (treydock)

v0.4.0 (2019-08-19)

Full Changelog

Changed

• Change facts used by module #13 (treydock)

Added

• Only start kdump service if crashkernel kernel argument present #14 (treydock)

v0.3.0 (2019-08-19)

Full Changelog

Changed

• Drop Puppet 4 support #10 (treydock)

Added

• Debian/Ubuntu support #12 (treydock)
• Use module Hiera data #11 (treydock)
• Convert module to PDK #9 (treydock)

0.2.0 (2019-04-22)

Full Changelog

Added

• ability to specify different service parameters #8 (lukebigum)

0.1.1 (2019-04-02)

Full Changelog

0.1.0 (2019-04-02)

Full Changelog

Changed

• Drop support for EL5 #5 (treydock)

Added

• Updated to work with Puppet 4.10 and later #3 (jeannegreulich)

0.0.1 (2015-07-31)

Full Changelog

Added

• CentOS 7 compatibility #1 (tangestani)

* This Changelog was automatically generated by github_changelog_generator