puppet-smartd

Simplified smartd configuration management with Puppet.

Usage

include smartd

and confgure e-mail nofifications for all disks:

smartd::defaults: '-a -m root@domain.org'

this would generate a smartd.conf based on smartd::disks (by default $facts['disks'] is used):

DEFAULT -a -m root@domain.org
/dev/sda -d ata
/dev/sdb -d ata

Main class smartd supports following attributes:

• defaults Shared configuration directives can be specified e.g. common email -m root@my.org. Accepts string or an array or strings.
• disks Fact or Hash containing devices declaration
• rules Applied smartd options to disks definition.
• devicescan When enabled will automatically detect all matching devices (restricted by options). Default: false
• options DEVICESCAN options, e.g. -d removable will ignore errors on removable devices. Requires devicescan: true. Accepts string or an array or strings.

By default Puppet built-in $facts['disks'] is used (accessible also via facter -y disks), e.g.:

nvme0n1:
  model: "SAMSUNG MZQL2960HCJR-00A07"
  serial: "S64FNE0R503522"
  size: 894.25 GiB
  size_bytes: 960197124096
  type: ssd

that can be used to generate configuration (at least simple list of devices). Though any other fact or hardcoded hash of disks might be used.

The rules parameter can be used to define e.g. model/vendor specific rules that might be generalized.

smartd::rules:
  - attr: model         # attr value match disk attributes, e.g. vendor, type, etc. might be used
    match: SAMSUNG MZ7
    options: -I 173     # ignore wear_level_count for disks matching this model

Match device name using special key $name:

smartd::rules:
  - attr: $name
    match: ^nvme  # regexp match
    options: -H   # will append all matching rules
  - attr: type
    match: ssd
    options:  -l error

this would output (assuming NVMe has attribute type with value ssd)

/dev/nvme0n1 -H -l error

Ignore device completely (will be ommited from the list):

smartd::rules:
  - attr: vendor
    match: DELL
    action: ignore

Apply megaraid device type

smartd::rules:
  - atrr: model
    match: PERC
    options: -d megaraid,0

Configuration parameters

See man smartd.conf for full configuration specification.

• -a equivalent of -H -f -t -l error -l selftest -l selfteststs -C 197 -U 198
• -m email address for notifications
• -d device type auto,ata, scsi,nvme,ignore,removable
• -H perform S.M.A.R.T health check, i.e. smartctl -H /dev/sda
• -i ignore failure of Usage Attributes (e.g. percent of lifetime used)

Examples

Will scan for all devices, and then monitor them. It will send one email warning per device for any problems that are found.

smartd::devicescan: true
smartd::options: '-H -d ata -m root@example.com'

this would produce config:

DEVICESCAN -H -d ata -m root@example.com

that will ensure that smartd will check SMART health status on all ata drives daily.

Common configuration will be applied for all disks defined bellow (in the config).

smartd::defaults:
  - '-a -R5! -W 2,40,45 -I 194 -s L/../../7/00'
  - '-m admin@example.com'

Limitations

Written for Puppet 6 and newer, backward compatibility with older versions hasn't been tested.

Changelog

All notable changes to this project will be documented in this file.

Release 1.1.0 [2024-11-03]

• Replace stdlib::ensure_packages with ensure_resources which doesn't require stdlib >=9
• Use hierarchical facts in tests

Full diff

Release 1.0.0 [2024-06-21]

Breaking changes

• use namespaced Puppet 4.x functions (require stdlib >= 9)

Full diff

Release 0.5.0 [2023-12-10]

Features

• Puppet 8 support
• Debian 12 support

Bugfixes

• Fixed module dependencies
• Optional param defaults to undef

Full diff

Release 0.4.0 [2022-10-20]

Features

• Support passing package install options

Full diff

Release 0.3.0 [2022-09-20]

Bugfixes

• Fixed service name on Debian 10
• Fixed array options serialization

Release 0.2.0 [2022-09-15]

Bugfixes

• Changed semantics of rules from Hash to Array of Hashes in order to support multiple rules over the same attribute
• Debian service is called smartmontools but smartd works as an alias

Full diff

Release 0.1.0 [2022-09-15]

Features

• Support matching disk attributes and appending smard config flags
• Support matching by device name
• Ignore certain devices

Known Issues