Ansible Role: NUT

Installs and configures NUT (Nework UPS tools) on Debian based systems.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

nut_managed_config: true

If this is set to false, none of the following options will have any effect, that is any and all changes under /etc/nut/ will be your responsibility. This is often desirable when you have complex configurations.

nut_host: localhost
nut_user: monitor
nut_password: Whatever...

Mainly used for configuring the monitor user. A user in the NUT sense is not the typical user a UNIX administrator is used to.

nut_ups:
  - name: UPS
    driver: riello_ups
    device: /dev/ttyUSB0
    description: Some descriptive information
    extra: |
      maxretry = 10
      retrydelay = 1

name is an arbitrary string that must identify univocally the UPS.

driver depends on your hardware and must be one of the available NUT driver. Be sure the NUT version installed on your server has that specific driver available.

device is device where the UPS is listening (typically an USB port or a serial device).

description is optional and is an arbitrary string used for debugging and reporting purposes.

extra is an optional multiline text to be inserted verbatim in the global section of the relevant configuration file.

Other less used variables, all of them optionals:

nut_mode: standalone # `man 5 nut.conf`     MODE directive
nut_powervalue: 1    # `man 5 upsmon.conf`  MONITOR directive, powervalue field
nut_role: master     # `man 5 upsmon.conf`  MONITOR directive, type field
nut_services:        # Name of the services to enable
  - nut-driver
  - nut-monitor
  - nut-server

Example Playbook

- hosts: all
  roles:
  - role: ntd.nut
    nut_ups:
      - name: riello
        driver: riello_usb
        device: /dev/ups
        description: iPlug 800

For more examples, please see tests/test.yml.

License

MIT

Author Information

This role was created in 2016 by Nicola Fontana (ntd@entidi.it).