Turgon37.apcupsd
Ansible Role for APC UPS Daemon
⚠️ This role is still being developed, so there may be significant changes. Avoid using it in production environments, but you can use it as a base for your own role. 🔨
Description
❗ Before using this role, be aware that all my Ansible roles have been tailored to my specific IT setup. Although they are designed to be generic, they may not meet your needs. Please review what they do and ensure they can be installed safely on your servers.
This role sets up the apcups daemon to monitor an APC brand UPS.
Requirements
You need Ansible version 2.4 or higher.
Dependencies
If you are using the Zabbix monitoring system, you will need the ansible-zabbix-agent role.
OS Family
This role is compatible with Debian.
Features
Currently, this role can:
- Install apcupsd packages
- Perform a basic configuration (more advanced features are planned)
- Monitor using:
- Zabbix
- Provide local facts
Configuration
You can change settings by modifying variables located in the defaults/main.yml file, as well as in the table below. Check this file for the default values.
| Name | Type/Value | Description |
|---|---|---|
apcupsd__facts |
Boolean | Install the local fact script |
apcupsd__monitoring |
String | The name of the monitoring "profile" to use. Options are 'zabbix' |
apcupsd__service_enabled |
Boolean | Enable or disable the service |
apcupsd__net_server |
Boolean | Turn on or off the network information server (NIS), allowing clients to check UPS status |
apcupsd__net_server_address |
String | The network address for the NIS server to listen on |
apcupsd__net_server_port |
String | The network port for the NIS server to listen on |
Facts
By default, the local facts are installed and provide the following variables:
ansible_local.apcupsd.version_fullansible_local.apcupsd.version_major
Example
Playbook
You can use it in a playbook like this:
- hosts: all
roles:
- turgon37.apcupsd
Inventory
apcupsd__net_server_address: 127.0.0.1
ansible-galaxy install Turgon37.apcupsd