Ansible Role snmpd

This guide shows you how to install and set up snmpd on your system.

GitHub	GitLab	Downloads	Version

Example Playbook

The following example comes from molecule/default/converge.yml and is tested with every change, pull request, and release.

---
- name: Converge
  hosts: all
  become: true
  gather_facts: true

  roles:
    - role: robertdebock.snmpd

Before running this, the machine needs to be prepared. In CI, this is handled using molecule/default/prepare.yml:

---
- name: prepare
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: robertdebock.bootstrap

You can find a detailed explanation and example on how to use these roles.

Role Variables

Default variable values are set in defaults/main.yml:

---
# defaults file for snmpd

snmpd_security_names:
  - name: notConfigUser
    source: default
    community: public

snmpd_groups:
  - name: notConfigGroup
    security_model: v1
    security_name: notConfigUser
  - name: notConfigGroup
    security_model: v2c
    security_name: notConfigUser

snmpd_views:
  - name: systemview
    type: included
    subtree: ".1.3.6.1.2.1.1"
  - name: systemview
    type: included
    subtree: ".1.3.6.1.2.1.25.1.1"

snmpd_accesses:
  - group: notConfigGroup
    context: ""
    security_model: any
    security_level: noauth
    prefix: exact
    read: systemview
    write: none
    notif: none

snmpd_syslocation: Unknown
snmpd_syscontact: Root <root@localhost>

snmpd_dontlogtcpwrappersconnects: "yes"

snmpd_disks:
  - path: /
    minimum: 10000

snmpd_load:
  one_minute_average: 12
  five_minute_average: 14
  fifteen_minute_average: 14

Requirements

• Install pip packages listed in requirements.txt.

State of Used Roles

Several roles are required to prepare your system. You can use different methods if you prefer.

Requirement	GitHub	GitLab
robertdebock.bootstrap

Context

This role works with many other related roles. You can check the documentation of these roles for more information.

Here is a chart of related roles:

Compatibility

This role has been tested on the following container images:

Ansible version 2.12 or later is required. Tests have been done on:

• The previous version.
• The current version.
• The development version.

If you find any problems, please report them on GitHub.

License

Apache-2.0.

Author Information

This project is maintained by robertdebock.

If you appreciate my work, please consider sponsoring me.