lldpd #4
Description
LLDP is an industry standard protocol designed to supplant proprietary
Link-Layer protocols such as Extreme's EDP (Extreme Discovery
Protocol) and CDP (Cisco Discovery Protocol). The goal of LLDP is to
provide an inter-vendor compatible mechanism to deliver Link-Layer
notifications to adjacent network devices. This implementation
provides LLDP sending and reception, supports VLAN and includes an
SNMP subagent that can interface to an SNMP agent through AgentX
protocol. This daemon is also able to deal with CDP, SONMP, FDP and
EDP protocol. It also handles LLDP-MED extension.
- Tags:
- network ›
- ops ›
- monitoring ›
Overview
Purpose of this charm is to install and configure LLDP daemon (lldpd). LLDP
is used by network administrators to detect how machines are connected to
switches and routers.
Usage
Start by installing the lldpd charm and relating it to another application:
juju deploy lldpd
juju add-relation lldpd application-on-physical-machine
Being a subordinate charm it needs to be related to an application running
on physical machine. It doesn't make much sense to install LLDP on a VM
or LXD container, because Linux bridge will terminate LLDP traffic.
Scale out Usage
By scaling your application, subordinate charm will get installed automatically.
Known Limitations and Issues
LLDP is not very useful on containers and virtual machines and therefore it's
use on those is not recommended.
Configuration
By default LLDPd will listen on all interfaces and pick, more or less, a random
systemid. Two given configuration options allow user to specify which interfaces
will be used to broadcast LLDP data and which will be used for systemid.
One additional option, i40e-lldp-stop, is included because some Intel NICs
block user-space LLDP generated data and instead broadcast their own. By setting
this option to True (default), NIC's built-in LLDP daemon will be disabled, if
such a NIC has been discovered on the system.
Configuration
- enable-snmp
- (boolean) Enable the SNMP agent for LLDPD
- i40e-lldp-stop
- (boolean) "This allows control over Intel's i40e NIC driver. By default i40e blocks userspace LLDP and does it on its own. Setting this option to 'True' means charm will disable this functionality in the NIC and do it within userspace."
- True
- interfaces-regex
- (string) "Which interfaces should lldpd announce details. If you want lldpd to listen on multiple interfaces, set it here. Examples: seth*,meth* You can also use exclamation mark to exclude an interface: eth*,!eth1 This way lldpd will listen on all eth* interfaces with an exception of eth1. By default this is set to None, which puts lldpd in listening mode only."
- nagios_context
- (string) A string that will be prepended to instance name to set the host name in nagios. So for instance the hostname would be something like: juju-myservice-0 If you're running multiple environments with the same services in them this allows you to differentiate between them.
- juju
- nagios_servicegroups
- (string) Comma separated list of nagios servicegroups for the check
- juju
- short-name
- (boolean) Set short name in SysName instead of FQDN
- systemid-from-interface
- (string) Pull systemID from this interface