Ansible role to configure and install Monarx Agent and Monarx cPanel/WHM Plugins (where applicable).
Tested on:
- AlmaLinux 9 / Rocky Linux 9 / CloudLinux 9
- CentOS 8 / AlmaLinux 8 / Rocky Linux 8 / CloudLinux 8
- CentOS 7 / CloudLinux 7
- Ubuntu 23 (Lunar Lobster)
- Ubuntu 22 (Jammy Jellyfish)
- Ubuntu 20 (Focal Fossa)
- Ubuntu 18 (Bionic Beaver)
- Ubuntu 16 (Xenial Xerus)
- Debian 10 (Buster)
- Debian 11 (Bullseye)
- Debian 12 (Bookworm)
None
Available variables are listed below, along with default values (see defaults/main.yml
):
client_id: "CLIENTID" # Required - Monarx API Client ID
client_secret: "SECRET" # Required - Monarx API Client Secret
The client_id
and client_secret
variables are required to register the Monarx Agent with the administration dashboard
The following variables are optional and can be used to customize the agent, if not provided, the default values are used:
user_bases: # Optional - Base Directory(-ies) for Users
- /home/
- /var/www/
exclude_dirs: # Optional - Excluded directories
- /virtfs
- /(clam_|\.)?quarantine
- ^/home/quarantine/
exclude_users: # Optional - Excluded users
- ^virtfs$
advanced_options: # Optional - Advanced Options
- { name: "quarantine.global", value: "/var/log/.quarantine/" }
- { name: "quarantine.user", value: "$USER/.quarantine/ $USER $USER 0700" }
agent_tags: # Optional - Agent Tafs
- tag1
- tag2
The following variables indicate whether you want to install the cPanel and WHM Plugins. if set to true
, the playbook would check if cPanel is installed before attempting to install the plugins:
install_cpanel_plugin: true # Optional - Install cPanel Plugin
install_whm_plugin: true # Optional - Install WHM Plugin
None
- hosts: servers
roles:
- { role: libyanspider.monarx_agent, client_id: "MYCLIENTID", client_secret: "MYSECRET", agent_tags: [upsell, vps] }
BSD
Ahmed Shibani (#shumbashi) [email protected].