Manage Arpwatch installation and configuration
Go to file
Jeremy Gardais 3993f20716 Release 2.0.0 2020-04-28 08:53:46 +02:00
defaults Remove useless arpwatch.conf file 2020-04-28 08:43:12 +02:00
handlers Adapt for Buster start with arpwatch v2.1a15-7 2020-04-27 20:36:21 +02:00
meta Update meta info and now only support Debian Buster 2020-04-28 08:35:14 +02:00
tasks Remove useless arpwatch.conf file 2020-04-28 08:43:12 +02:00
templates/etc/default Update default service file according to Buster 2020-04-28 08:43:27 +02:00
tests Init 2018-04-23 08:35:05 +02:00
.travis.yml Init 2018-04-23 08:35:05 +02:00
CHANGELOG.md Release 2.0.0 2020-04-28 08:53:46 +02:00
README.md Adapt for Buster start with arpwatch v2.1a15-7 2020-04-27 20:36:21 +02:00

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