https://github.com/ntd/ansible-role-nut

Ansible role to install and configure Nework UPS tools on Debian
https://github.com/ntd/ansible-role-nut

ansible ansible-role debian nut

Last synced: 3 months ago
JSON representation

Ansible role to install and configure Nework UPS tools on Debian

• Host: GitHub
• URL: https://github.com/ntd/ansible-role-nut
• Owner: ntd
• License: mit
• Created: 2016-09-20T18:31:23.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-10-31T05:32:30.000Z (3 months ago)
• Last Synced: 2024-10-31T06:19:10.523Z (3 months ago)
• Topics: ansible, ansible-role, debian, nut
• Language: Jinja
• Homepage:
• Size: 22.5 KB
• Stars: 11
• Watchers: 2
• Forks: 17
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Ansible Role: NUT

=================

[![Build Status](https://travis-ci.org/ntd/ansible-role-nut.svg?branch=master)](https://travis-ci.org/ntd/ansible-role-nut)

Installs and configures [NUT](http://networkupstools.org/) (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](http://networkupstools.org/stable-hcl.html). 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 ([email protected]).