Forge Home

lldpd

installs, configures, and manages the lldpd daemon from Vincent Bernat

32,394 downloads

1,124 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

  • 6.0.0 (latest)
  • 5.1.0
  • 5.0.0
  • 4.0.2
  • 4.0.1
  • 4.0.0
  • 3.3.0
  • 3.2.0
  • 3.1.0
  • 3.0.3
  • 3.0.2
  • 3.0.0
  • 2.3.0
  • 2.2.0
  • 2.1.0
  • 2.0.1
  • 2.0.0
  • 1.3.1
  • 1.3.0
  • 1.2.0
  • 1.1.0
  • 1.0.1
  • 1.0.0
released Feb 21st 2018
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.4.x
  • Puppet >= 4.9.4 < 6.0.0
  • Archlinux, , , , ,

Start using this module

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

Add this module to your Puppetfile:

mod 'puppet-lldpd', '1.0.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add puppet-lldpd
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install puppet-lldpd --version 1.0.1

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

puppet/lldpd — version 1.0.1 Feb 21st 2018

puppet-lldpd

Build Status Puppet Forge Puppet Forge - downloads Puppet Forge - endorsement Puppet Forge - scores Yard Docs AGPL v3 License

Table of Contents


Overview

LLDP stands for Link Layer Discovery Protocol. This module manages the LLDP implementation from Vincent Bernat. puppet-strings docs are available in /docs. They are generated before each release. This module configures the upstream repo if necessary. The LLDP requires a daemon, which will be started. the command line client has support for json output. This is used to create a structured fact. It is updated automatically with a systemd timer (or a cronjob on legacy systems).

Setup

This is very easy:

include lldpd

You can disable the repo management:

class{'lldpd':
  manage_repo => false,
}

Support

This module supports the installation on:

  • Archlinux
  • CentOS 6
  • CentOS 7
  • Fedora 25
  • Fedora 26
  • Fedora 27
  • Debian 8
  • Debian 9
  • Ubuntu 14.04
  • Ubuntu 16.04
  • Virtuozzo Linux 6
  • Parallels Cloud Server Bare Metal 5
  • FreeBSD

The fact is present on all Operating Systems except for FreeBSD. Docker acceptance tests work for CentOS 6 and 7. Vagrant acceptance tests work for Fedora 25. Other nodesets are currently not present. The module requires at least Puppet 4.9.4 (this is the first version with proper data-in-modules support).

Reference

The main class provides an interface that can be used. It can be configured via the upcoming parameters. All other classes are internal and can't be accessed directly.

$manage_facts

This is a boolean, it defaults to true on all systems except for the CentOS family (see limitations. If true, the module will provide a script to run lldpctl and save the output as json as structured fact. A systemd timer or a cronjob will be deployed to execute the script periodically. This decouples the fact generation from the actual facter/puppet.

$manage_service

Boolean, if true, the module will enable the service. Defaults to true.

$manage_repo

Boolean, if true, the module will setup the upstream repository. Defaults to true on Debian and CentOS family.

$manage_jq

Boolean. jq is a dependency needed for the fact generation. This module can install it. Defaults to true on all systems except for CentOS. See also limitations.

$repourl

String, part of the upstream repository URL. The module provides sane defaults for all repositories. There should be no need to set this parameter.

$ensure

String, allowed values are present, absent and latest. This sets the status of the lldpd package.

Limitations

The facts require jq to work. The installation can be configured with $manage_jq. This is disabled on CentOS machines. You can install it on CentOS if you configure the EPEL repository.

Development

This project contains tests for rspec-puppet.

Quickstart to run all linter and unit tests:

bundle install --path .vendor/ --without system_tests --without development --without release
bundle exec rake test

For acceptance tests:

bundle install --path .vendor/ --with system_tests --without development --without release
BEAKER_debug=true PUPPET_INSTALL_TYPE=agent bundle exec rake beaker:fedora-25-x64
BEAKER_debug=true PUPPET_INSTALL_TYPE=agent bundle exec rake acceptance BEAKER_set=docker/centos-7

Authors

puppet-lldpd is maintained by Vox Pupuli, it was written by Tim 'bastelfreak' Meusel.