openlldp

Open-LLDP installation and management.

Mike Arnold

razorsedge

19,623 downloads

5,062 latest version

4.3 quality score

Version information

  • 1.0.0 (latest)
  • 0.3.0
  • 0.2.1
  • 0.2.0
  • 0.1.0
  • 0.0.1
released Jul 1st 2017
This version is compatible with:
  • Puppet Enterprise 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >=2.7.20 <5.0.0
  • RedHat
    ,
    CentOS
    ,
    OracleLinux

Start using this module

Tags: lldp, facts

Documentation

razorsedge/openlldp — version 1.0.0 Jul 1st 2017

Puppet Open-LLDP Module

master branch: Build Status develop branch: Build Status

Introduction

This module installs Open-LLDP. lldpad (LLDP Agent Daemon) is a GPL licensed implementation of the Link Layer Discovery Protocol for Linux.

Actions:

  • Installs Open-LLDP (lldpad).
  • Starts lldpad.
  • Provides LLDP neighbor facts via facter (requires lldpad running and configured to at least receive LLDP frames on each Ethernet interface).
  • Configures lldpad to receive and/or transmit LLDP frames via the included lldptool.
  • Configures lldpad to transmit LLDP TLVs.

OS Support:

  • RedHat family - tested on CentOS 6.3
  • SuSE family - presently unsupported (patches welcome)
  • Debian family - presently unsupported (patches welcome)

Class documentation is available via puppetdoc.

Examples

class { 'openlldp': }

# Configure lldpad to receive and transmit LLDP frames on the specific interface.
openlldp::config::lldp { 'eth0':
  adminstatus => 'rxtx',
}

# Configure lldpad to transmit Basic LLDP TLVs.
# openlldp::config::lldp adminstatus has to be tx or rxtx for these to transmit.
openlldp::config::tlv { 'eth0':
  portDesc => 'yes',
  sysName  => 'yes',
  sysDesc  => 'yes',
  sysCap   => 'yes',
  mngAddr  => 'yes',
}

Notes

  • Open-LLDP talks about applying configurations globally by not specifying "-i ethX" to lldptool. This has not worked with the versions tested (0.9.43), thus a global configuration mode has not been built into the Puppet module.
  • PVID TLV is not suported as a keyword with the versions tested (0.9.43), thus the code uses numerical values for all TLVs.

Issues

  • None

TODO

  • None

Contributing

Please see CONTRIBUTING.md for contribution information.

License

Please see LICENSE file.

Copyright

Copyright (C) 2012 Mike Arnold mike@razorsedge.org

razorsedge/puppet-openlldp on GitHub

razorsedge/openlldp on Puppet Forge