oefenweb / ansible-snmpd

Ansible role to set up snmp(d) in Debian-like systems

snmpd

Set up snmp(d) in Debian-like systems.

Requirements

On Debian the non-free repository must be enabled to download the snmp-mibs-downloader package, on Ubuntu this package is in multiverse. See the "Recommended" section below.

Variables

• snmpd_install [default: [lm-sensors]]: Additional packages to install

• snmpd_mibs [default: UCD-SNMP-MIB]: MIBs to load

• snmpd_run [default: true]: Snmpd control (true means start daemon)

• snmpd_opts [default: '-LS4d -Lf /dev/null -u snmp -g snmp -I -smux -p /var/run/snmpd.pid']: Snmpd options (use syslog, close stdin/out/err)

• snmpd_trapd_run [default: false]: Snmptrapd control (true means start daemon)

• snmpd_trapd_opts [default: '-Lsd -p /var/run/snmptrapd.pid']: Snmptrapd options (use syslog)

• snmpd_snmpd_compat [default: false]: Create symlink on Debian legacy location to official RFC path

• snmpd_agent_address [default: `['udp:161', 'udp6:[::1]:161']: Agent address

• snmpd_internal_user: [default: see defaults.yml]: Internal user. Make sure to change!

• snmpd_users: [default: see defaults.yml]: Additional users. Make sure to change!

• snmpd_sys_location [default: '']: System location

• snmpd_sys_contact [default: Root <root@localhost>]: System contact

• snmpd_sys_description [default: {{ inventory_hostname }}]: System description

• snmpd_disks_include_all: [default: false]: Include all disks mounted on the system in the SNMP table

• snmpd_disks_include_all_threshold_minpercent: [default: 10%]: Minimum free space specified as a percentage

• snmpd_disks: [default: []]: List of disk paths and their corresponding thresholds to be included in the SNMP table

• snmpd_disks.{n}.path: [required]: The disks mountpoint (e.g. /)

• snmpd_disks.{n}.threshold: [required]: The disks minimum threshold either be specified in kB (MINSPACE) or as a percentage of the total disk (MINPERCENT% with a '%' character) (e.g. 10%)

• snmpd_default_monitors [default: true]: Configure the Event MIB tables to monitor the various UCD-SNMP-MIB tables for problems

• snmpd_link_up_down_notifications [default: true]: Configure the Event MIB tables to monitor the fTable for network interfaces being taken up or down, and triggering a linkUp or linkDown notification as appropriate

• snmpd_extensions: [default: []]: Extension MIB declaration(s)

• snmpd_extensions.{n}.name: [required]: An identifying string for the extension

• snmpd_extensions.{n}.prog: [required]: The program to run

• snmpd_extensions.{n}.args: [default: []]: The arguments to give the program

• snmpd_passes: [default: []]: Pass MIB declaration(s)

• snmpd_passes.{n}.name: [required]: An identifying string for the extension (OID)

• snmpd_passes.{n}.prog: [required]: The program to run

Dependencies

None

Recommended

• ansible-apt (see, to manage apt repositories (in /etc/apt/sources.list)

Example

---
- hosts: all
  roles:
    - oefenweb.snmpd

License

MIT

Author Information

Mischa ter Smitten

Feedback, bug-reports, requests, ...

Are welcome!

ansible-snmpd's Issues

Idempotence test fails for Ansible 1.4 (Travis)

See https://travis-ci.org/Oefenweb/ansible-snmpd/jobs/63309804

Deprecation Warning

Hi Oefenweb,

with the newest ansible version (2.0.1.0) we get a deprecation warning

example:
[DEPRECATION WARNING]: Using bare variables is deprecated. Update your playbooks so that the environment value uses the full variable syntax ('{{snmpd_dependencies}}'). This feature will be removed in a future release. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg.

Add Vagrantfile for testing provisions

See Oefenweb/ansible-memcached@8685ce9

No package matching 'snmp-mibs-downloader' is available

It seems that snmp-mibs-downloader is in the multiverse repository which is not enabled by default.

It seems that the snmpd daemon exits on debian-6010

TASK: [snmpd | start and enable service] ************************************** 
<127.0.0.1> REMOTE_MODULE service name=snmpd state=started
changed: [debian-6010] => {"changed": true, "enabled": true, "name": "snmpd", "state": "started"}

This task is always changed

404 Not Found (with cold apt cache)

Why having default credentials?

Hello!

I'm just having a first look at the role, and wondering: why are there default passwords here https://github.com/Oefenweb/ansible-snmpd/blob/master/defaults/main.yml ?

Is that for CI to work, or is there another reason ?

Thanks!

Fix failing idempotence test on Travis CI

https://travis-ci.org/Oefenweb/ansible-snmpd/builds/114182925