arpwatch

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

Overview

This tool is for installing and setting up Arpwatch.

Role Variables

• arpwatch__base_packages: List of essential packages for arpwatch [default: arpwatch].
• arpwatch__enabled: Turn Arpwatch support on or off for a specific host [default: True].
• arpwatch__service_manage: Decide if the arpwatch service should be managed [default: True].
• arpwatch__service_name: The name of the service to control [default: arpwatch].
• arpwatch__conf_interfaces: List of network interfaces for arpwatch to monitor [default: [ '{{ ansible_default_ipv4.interface }}' ]].
• arpwatch__conf_src: Template used for the configuration file [default: ../templates/etc/arpwatch.conf.j2].
• arpwatch__conf_username: Username for running Arpwatch [default: arpwatch].
• arpwatch__conf_args: Arguments to apply to Arpwatch [default: -N -p].

Example Playbook

• Using default variables:

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

Configuration

This role will:

• Install necessary packages for the arpwatch service.
• Manage the arpwatch configuration file (/etc/arpwatch.conf).
• Allow setting the user that runs Arpwatch.
• Allow setting arguments for the Arpwatch service.
• Ensure that an arpwatch process starts for the main network interface at least.
• Restart the arpwatch service if the configuration changes.

Development

The source code is available on our Gogs instance, and we have a Github repository to share the role with Ansible Galaxy.

Feel free to submit issues or pull requests here!

Thanks to this hook, Github automatically gets updates from our Gogs instance!

License

WTFPL

Author Information

Jérémy Gardais

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