- Notifications
You must be signed in to change notification settings - Fork10
Ansible role to install and configure smartmontools
License
stuvusIT/smartd
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
This role installs and configuressmartd.In the default configuration, all devices will be tested and observed, but no mails will be sent.
Debian, Ubuntu, Arch Linux, or Fedora/usr/bin/mail has to exist and be configured to be able to send report mails if that is desired.
This role only uses one top-level var calledsmartd_devices, which is a dict of dicts to specify device monitoring.Each key corresponds to one drive path, whileDEVICESCAN (the only default entry) may be used to scan for devices.After aDEVICESCAN entry, all further lines are ignored by smartd, so you probably want to insert it at the end or not at all.
All possible options inside the dict are briefly described here.You can find a detailed wall-of-text for each one on thesmartd man page.
| Name | Mandatory / Default | Description |
|---|---|---|
type | auto | The type of device, e.g.ata,scsi,marvell, etc. |
nocheck | standby,15,q | Powermode setting. By default, devices instandby are only woken up every 15th attempt and skipped check attempts are not logged. |
check_type | normal | Usenormal orpermissive to force SMART checking even if it is not advertised. |
ata_offline_testing | Set toon oroff to enable or disable automatic ATA offline testing by the device itself. Note that you have to quote the value because of ansible's interpretation ofoff. | |
attribute_autosave | True | Enables or disables attribute autosave on startup |
check_health_return_status | True | Check device health status using the SMART return status |
report_error_types | [error,xerror,selftest,offlinests,"scterc,0,0"] | List of error types to report. By default, SMART errors as well as failed tests are logged and TLER will be disabled. |
non_smart_settings | ["lookahead,on"] | List of non-SMART options to set |
test_schedule | (L/../../6/01|S/../.././02) | REGEXP to specify self-test schedules. By default, a short test is executed daily after 1am. A long test is executed each sunday after 2am. |
mail_recipients | []] | List of mail addresses to report to |
mail_frequency | diminishing | Frequency of report emails.once,daily anddiminishing are possible values. |
mail_script | Path to a script that will be executed in addition to sending report mails | |
report_ata_failure | True | Report failure of any ATA usage attributes |
report_ata_prefail | True | Report change of any ATA prefail attributes |
report_ata_usage | False | Report any time a usage attribute has changed |
ignore_ata_failure_ids | [] | List of SMART IDs to ignore when checking for failures |
ignore_ata_usage_ids | [] | List of SMART IDs to ignore when tracking usage value changes |
report_raw_ids | [] | List of IDs to force reporting raw values for. Append! to an ID to consider changes critical. |
ata_pending_id | 197+ | ID specifying pending sectors. Append+ to only report increasage instead of non-zero-ness. |
ata_uncorrectable_id | 198+ | ID specifying pending sectors. Append+ to only report increasage instead of non-zero-ness. |
temperature_report_diff | 10 | Difference in temperature to report. Use0 to ignore. |
temperature_report_info | 45 | Temperature threshold to start sending informational reports. Use0 to ignore. |
temperature_report_crit | 50 | Temperature threshold to start sending critical reports. Use0 to ignore. |
firmware_bugs | [] | List of known firmware bugs SMARTD should circumvent. |
vendor_formats | [] | List of options to rewrite interpretation of raw SMART values and their interpretation. |
preset_mode | use | Set toignore if you don't want to use known presets for a detected drive. |
-hosts:storageroles: -role:smartdsmartd_devices:/dev/sda:check_type:permissivetest_schedule:L/../../7/04temperature_report_diff:5DEVICESCAN:non_smart_settings: -lookahead,on -wcache,off -standby,off -apm,254
This configuration will force SMART checking even if it is not advertised as implemented on/dev/sda. The device will only be tested after 4am every sunday and already temperature changes of 5 degrees will be reported.All other drives will be monitored using the default settings, except for the listed options set additionally.
This work is licensed under aCreative Commons Attribution-ShareAlike 4.0 International License.