Forge Home

arpwatch

Install and manage arpwatch

10,390 downloads

504 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.3.0 (latest)
  • 0.2.1
  • 0.2.0
  • 0.1.2
  • 0.1.1
  • 0.1.0 (deleted)
released Mar 1st 2022
This version is compatible with:
  • Puppet Enterprise 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
  • Puppet >= 4.10.0 < 8.0.0
  • ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'ardichoke-arpwatch', '0.3.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add ardichoke-arpwatch
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install ardichoke-arpwatch --version 0.3.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

ardichoke/arpwatch — version 0.3.0 Mar 1st 2022

arpwatch

Table of Contents

  1. Description
  2. Setup - The basics of getting started with arpwatch
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module
  7. Release Notes

Description

Install and configure arpwatch

Setup

Beginning with arpwatch

include ::arpwatch is enough to get you up and running.

Usage

All interaction with the arpwatch module is done through the main arpwatch class. You can simply set the options in ::arpwatch to have full functionality of the module.

Reference

Classes

Public Classes

  • arpwatch: Main class, installs and configures arpwatch

Private Classes

  • arpwatch::params: Determines and sets the defaults used by the main arpwatch class

Parameters

The following parameters are available in the ::arpwatch class:

config_file

Specifies a file for arpwatch's configuration. Valid options: string containing an absolute path. Default value: '/etc/sysconfig/arpwatch'

config_template

Specifies a file to act as a ERB template for the config file. Valid options: string containing a path (absolute, or relative to the module path). Example value: 'arpwatch/conf.rhel.erb'

dest_email

Specifies the email address to send arpwatch alerts to. Valid options: string. Default value: '-' (suppresses all email output from arpwatch)

interface

Specifies the interface to monitor for arp changes. Valid options: string containing an interface name. Default: eth0

opts

Specify additional options to pass to arpwatch at start. Valid options: string of command line options. Default: OS dependant

package_ensure

Tells Puppet whether the arpwatch package should be installed, and what version. Valid options: 'present', 'latest', or a specific version number. Default value: 'present'

package_name

Tells Puppet what arpwatch package to manage. Valid options: string. Default value: 'arpwatch'

service_enable

Tells Puppet whether to enable the arpwatch service at boot. Valid options: true or false. Default value: true

service_ensure

Tells Puppet whether the arpwatch service should be running. Valid options: 'running' or 'stopped'. Default value: 'running'

service_name

Tells Puppet what arpwatch service to manage. Valid options: string. Default value: 'arpwatch'

service_user

Specifies which user account arpwatch should run under. Valid options: string. Default value: 'arpwatch' ('pcap' under RHEL5)

source_email

Specifies the source email address for arpwatch emails. Only works under RedHat family distributions. Valid options: string. Default value: 'arpwatch@${::fqdn}'

Limitations

This module currently supports RedHat and Debian distributions. It has only been thoroughly tested under RedHat. Pull requests are welcome to add support for other platforms.

Development

Pull requests are welcome. Please make sure to properly document any additions or changes made to the module.

Release Notes

v0.2.0 - Add support for Debian

v0.1.2 - Add spec tests and dependencies

v0.1.0 - Initial release of arpwatch module