vyos/vyos-documentation
1
0
Fork 0
mirror of https://github.com/vyos/vyos-documentation.git synced 2025-10-26 08:41:46 +01:00
Code Issues Packages Projects Releases Wiki Activity

lldp: rewrite with new cfgcmd/opcmd syntax

Browse Source
This commit is contained in:
Christian Poessinger 2019-12-15 18:50:47 +01:00
parent a27ccecdbc
commit d0a59cae81
2 changed files with 89 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

135
docs/services/lldp.rst
View File

@ -1,7 +1,8 @@
.. _lldp: .. _lldp:
####
LLDP LLDP
---- ####
:abbr:`LLDP (Link Layer Discovery Protocol)` is a vendor-neutral link layer :abbr:`LLDP (Link Layer Discovery Protocol)` is a vendor-neutral link layer
protocol in the Internet Protocol Suite used by network devices for advertising protocol in the Internet Protocol Suite used by network devices for advertising
@ -11,19 +12,17 @@ as Station and Media Access Control Connectivity Discovery specified in IEEE
802.1AB and IEEE 802.3-2012 section 6 clause 79. 802.1AB and IEEE 802.3-2012 section 6 clause 79.
LLDP performs functions similar to several proprietary protocols, such as LLDP performs functions similar to several proprietary protocols, such as
`Cisco Discovery Protocol`_, `Foundry Discovery Protocol`_, :abbr:`CDP (Cisco Discovery Protocol)`, :abbr:`FDP (Foundry Discovery Protocol)`,
Nortel Discovery Protocol and Link Layer Topology Discovery. :abbr:`NDP (Nortel Discovery Protocol)` and :abbr:`LLTD (Link Layer Topology
Discovery)`.
Information gathered Information gathered with LLDP is stored in the device as a :abbr:`MIB
^^^^^^^^^^^^^^^^^^^^ (Management Information Database)` and can be queried with :abbr:`SNMP (Simple
Network Management Protocol)` as specified in :rfc:`2922`. The topology of an
Information gathered with LLDP is stored in the device as a management
information database (MIB_) and can be queried with the Simple Network
Management Protocol (SNMP_) as specified in :rfc:`2922`. The topology of an
LLDP-enabled network can be discovered by crawling the hosts and querying this LLDP-enabled network can be discovered by crawling the hosts and querying this
database. Information that may be retrieved include: database. Information that may be retrieved include:
* System name and description * System Name and Description
* Port name and description * Port name and description
* VLAN name * VLAN name
* IP management address * IP management address
@ -33,67 +32,111 @@ database. Information that may be retrieved include:
* Link aggregation * Link aggregation
Configuration Configuration
^^^^^^^^^^^^^ =============
* Enable service with: .. cfgcmd:: set service lldp
:code:`set service lldp` Enable LLDP service
Options .. cfgcmd:: set service lldp management-address <address>
*******
* Configure a Define management-address: Define IPv4 management address transmitted via LLDP.
:code:`set service lldp management-address <x.x.x.x>` .. cfgcmd:: set service lldp interface <interface>
* Define listening interfaces Enable transmission of LLDP information on given `<interface>`. You can also
say ``all`` here so LLDP is turned on on every interface.
:code:`set service lldp interface <all|interface name>` .. cfgcmd:: set service lldp interface <interface> disable
* LLDPd also implements an SNMP subagent. To Enable SNMP queries of the LLDP Disable transmit of LLDP frames on given `<interface>`. Useful to exclude
database: certain interfaces from LLDP when ``all`` have been enabled.
:code:`set service lldp snmp enable` .. cfgcmd:: set service lldp snmp enable
* Enable optional/other protocols Enable SNMP queries of the LLDP database
:code:`set service lldp legacy-protocols cdp`
Supported legacy protocols:
* ``cdp`` - Listen for CDP for Cisco routers/switches
* ``edp`` - Listen for EDP for Extreme routers/switches
* ``fdp`` - Listen for FDP for Foundry routers/switches
* ``sonmp`` - Listen for SONMP for Nortel routers/switches
Display neighbors .. cfgcmd:: set service lldp legacy-protocols <cdp|edp|fdp|sonmp>
^^^^^^^^^^^^^^^^^
* Display with: Enable given legacy protocol on this LLDP instance. Legacy protocols include:
``show lldp neighbors`` * ``cdp`` - Listen for CDP for Cisco routers/switches
* ``edp`` - Listen for EDP for Extreme routers/switches
* ``fdp`` - Listen for FDP for Foundry routers/switches
* ``sonmp`` - Listen for SONMP for Nortel routers/switches
Exemple: Operation
=========
.. opcmd:: show lldp neighbors
Displays information about all neighbors discovered via LLDP.
.. code-block:: none .. code-block:: none
vyos@vyos:~# show lldp neighbors vyos@vyos:~# show lldp neighbors
Capability Codes: R - Router, B - Bridge, W - Wlan r - Repeater, S - Station Capability Codes: R - Router, B - Bridge, W - Wlan r - Repeater, S - Station
D - Docsis, T - Telephone, O - Other D - Docsis, T - Telephone, O - Other
Device ID Local Proto Cap Platform Port ID Device ID Local Proto Cap Platform Port ID
--------- ----- ----- --- -------- ------- --------- ----- ----- --- -------- -------
swA309 eth0 LLDP ? Cisco IOS Software, GigE0/33 Switch0815 eth0 LLDP B Cisco IOS Software, Gi0/4
.. opcmd:: show lldp neighbors detail
* Options: Get detailed information about LLDP neighbors.
* ``detail`` - Show lldp neighbors detail .. code-block:: none
* ``interface`` - Show LLDP for specified interface
Troubleshooting vyos@vyos:~# show lldp neighbors detail
^^^^^^^^^^^^^^^ -------------------------------------------------------------------------------
LLDP neighbors:
-------------------------------------------------------------------------------
Interface: eth0, via: LLDP, RID: 1, Time: 12 days, xxxx:xxxx:40
Chassis:
ChassisID: mac 00:50:40:20:03:00
SysName: Switch0815
SysDescr: Cisco IOS Software, C2960 Software (C2960-LANBASEK9-M), Version 15.0(2)SE11, RELEASE SOFTWARE (fc3)
Technical Support: http://www.cisco.com/techsupport
Copyright (c) 1986-2017 by Cisco Systems, Inc.
Compiled Sat 19-Aug-17 09:34 by prod_rel_team
MgmtIP: 192.0.2.201
Capability: Bridge, on
Port:
PortID: ifname Gi0/4
PortDescr: GigabitEthernet0/4
TTL: 120
PMD autoneg: supported: yes, enabled: yes
Adv: 10Base-T, HD: yes, FD: yes
Adv: 100Base-TX, HD: yes, FD: yes
Adv: 1000Base-T, HD: no, FD: yes
MAU oper type: 1000BaseTFD - Four-pair Category 5 UTP, full duplex mode
VLAN: 1, pvid: yes
LLDP-MED:
Device Type: Network Connectivity Device
Capability: Capabilities, yes
Capability: Policy, yes
Capability: Location, yes
Capability: Inventory, yes
LLDP-MED Network Policy for: Voice, Defined: no
Priority: Best effort
PCP: 0
DSCP Value: 0
LLDP-MED Network Policy for: Voice Signaling, Defined: no
Priority: Best effort
PCP: 0
DSCP Value: 0
Inventory:
Hardware Revision: WS-C2960G-8TC-L (PowerPC405):C0
Software Revision: 15.0(2)SE11
Manufacturer: Cisco Systems, Inc.
Model: WS-C2960G-8TC-L
Use operational command ``show log lldp`` to display logs. .. opcmd:: show lldp neighbors interface <interface>
.. include:: references.rst Show LLDP neighbors connected via interface `<interface>`.
.. opcmd:: show log lldp
Used for troubleshooting.

2
docs/services/references.rst
View File

@ -1,5 +1,3 @@
.. _`Cisco Discovery Protocol`: https://en.wikipedia.org/wiki/Cisco_Discovery_Protocol
.. _`Foundry Discovery Protocol`: https://en.wikipedia.org/wiki/Foundry_Discovery_Protocol
.. _MIB: https://en.wikipedia.org/wiki/Management_information_base .. _MIB: https://en.wikipedia.org/wiki/Management_information_base
.. _SNMP: https://en.wikipedia.org/wiki/Simple_Network_Management_Protocol .. _SNMP: https://en.wikipedia.org/wiki/Simple_Network_Management_Protocol
.. _SNMPv2: https://en.wikipedia.org/wiki/Simple_Network_Management_Protocol#Version_2 .. _SNMPv2: https://en.wikipedia.org/wiki/Simple_Network_Management_Protocol#Version_2