ansible.arpwatch/README.md

arpwatch

1. Overview
2. Role Variables
3. Example Playbook
4. Configuration
5. Development
6. License
7. Author Information

Overview

Manage Arpwatch installation and configuration.

Role Variables

• arpwatch__base_packages : List of base packages in order to provide arpwatch [default : arpwatch].
• arpwatch__enabled : Enable or disable support for Arpwatch on a given host [default : True].
• arpwatch__service_manage : If the arpwatch service should be managed [default : True].
• arpwatch__service_name : The service name to manage [default : arpwatch].
• arpwatch__conf_interfaces : List of network interfaces where arpwatch should listen [default : [ '{{ ansible_default_ipv4.interface }}' ]].
• arpwatch__conf_src : Template used to provide configuration file [default : ../templates/etc/arpwatch.conf.j2].
• arpwatch__conf_username : Username that should run Arpwatch [default : arpwatch].
• arpwatch__conf_args : Arguments to apply to Arpwatch [default : -N -p].

Example Playbook

• Use defaults vars :

- hosts: serverXYZ
  roles:
    - role: ipr-cnrs.arpwatch

Configuration

This role will :

• Install needed packages to provide arpwatch service.
• Manage arpwatch configuration (/etc/arpwatch.conf).
• Allow to set the user that run Arpwatch.
• Allow to set arguments to pass Arpwatch service.
• Ensure to start an arpwatch process for the main network interface at least.
• Ensure to restart arpwatch service if configuration changed.

Development

This source code comes from our Gogs instance and the Github repo exist just to be able to send the role to Ansible Galaxy…

But feel free to send issue/PR here :)

Thanks to this hook, Github automatically got updates from our Gogs instance :)

License

WTFPL

Author Information

Jérémy Gardais

• Source : on IPR's Gogs
• IPR (Institut de Physique de Rennes)