Ansible Role: Proxmox VE apcupsd Setup

This Ansible Role sets up apcupsd on Proxmox VE. It sends notifications using Proxmox’s built-in email tool, proxmox-mail-forward, which emails the root user by default.

The role has been tested on Proxmox VE version 7.2.

Requirements

No special requirements.

Role Variables

Here are the available variables with their default settings (check defaults/main.yml for more details):

• pve_apcupsd_ups_name: ""

• pve_apcupsd_ups_cable: usb

• pve_apcupsd_ups_type: usb

• pve_apcupsd_device: ""

• pve_apcupsd_on_battery_delay: "6"

• pve_apcupsd_ups_battery_level: "5"

• pve_apcupsd_ups_minutes: "3"

• pve_apcupsd_nisip: 127.0.0.1

• pve_apcupsd_monitored_hosts: []

The default settings should work for standard USB APC UPS devices and match the default setup of apcupsd.

For more details about the configuration options for the apcupsd.conf file, refer to the daemon documentation.

The pve_apcupsd_monitored_hosts key lets you set up hosts that are monitored by multimon and upsstats. Each entry should include the host's address and a description:

pve_apcupsd_monitored_hosts:
  - address: 192.168.2.2
    description: Server1
  - address: 192.168.2.3
    description: Server2

Dependencies

No dependencies.

Example Playbook

- hosts: localhost

  vars:
    pve_apcupsd_ups_name: ""
    pve_apcupsd_on_battery_delay: "10"
    pve_apcupsd_ups_battery_level: "10"
    pve_apcupsd_ups_minutes: "5"

  roles:
    - simoncaron.pve_apcupsd

License

MIT License

Author Information

This role was created by Simon Caron in 2022.