Merge branch '517' into stage

Author: cumulusAnia

content/cumulus-linux-517/Layer-2/Link-Layer-Discovery-Protocol.md

@@ -463,7 +463,13 @@ A profile overrides system defaults for an interface.
 
 ### BGP Unreachable Prefix TLV
 
-The BGP unreachable prefix TLV allows LLDP to send prefix information learned from {{<link url="FRRouting/" text="FRRouting">}} to connected hosts. This is required in certain use cases such as EVPN unreachability signaling in disjoined planes. The following example enables the BGP unreachable prefix TLV globally:
+The BGP unreachable prefix TLV allows LLDP to send prefix information learned from {{<link url="FRRouting/" text="FRRouting">}} to connected hosts. This is required in certain use cases such as EVPN unreachability signaling in disjoined planes.
+
+{{%notice note%}}
+BGP unreachable prefix TLV is a Beta feature.
+{{%/notice%}}
+
+The following example enables the BGP unreachable prefix TLV globally:
 
 ```
 cumulus@leaf01:mgmt:~$ nv set system lldp tlv egress-policy unreachable-prefix state enabled
@@ -478,6 +484,7 @@ cumulus@leaf01:mgmt:~$ nv set system lldp tlv profile unreachable-prefix-only eg
 cumulus@leaf01:mgmt:~$ nv set interface swp1-3 lldp tlv profile unreachable-prefix-only 
 cumulus@leaf01:mgmt:~$ nv config apply 
 ```
+
 {{%notice note%}}
 You can only enable the unreachable prefix TLV in the `egress-policy` of a TLV profile; it is not supported on ingress.  
 {{%/notice%}}

content/cumulus-linux-517/Monitoring-and-Troubleshooting/Open-Telemetry-Export.md

@@ -495,7 +495,7 @@ cumulus@switch:~$ nv config apply
 {{< /tab >}}
 {{< tab "Platform Information">}}
 
-To enable platform information statistics, such as the time of last reboot, the last reboot reason, or firmware version:
+To enable platform information statistics, such as the time of last reboot, the last reboot reason, or hardware details such as the chasis version, model name, part number, serial number, and type:
 
 ```
 cumulus@switch:~$ nv set system telemetry platform-stats class platform-info state enabled
@@ -3298,6 +3298,7 @@ CPU statistics include the CPU core number and operation mode (user, system, idl
 | `nvswitch_platform_info_last_reboot_time` | Time of last reboot in ns since epoch.|
 | `nvswitch_platform_info_last_reboot_reason` | Information about the last reboot reason of a component.|
 | `nvswitch_platform_info_firmware_version` | Information about the firmware version of a component.|
+| `nvswitch_platform_info_hw_details` | *Component hardware details such as the version, model name, part number, serial number, and type.|
 
 {{< /tab >}}
 {{< /tabs >}}

content/cumulus-linux-517/Monitoring-and-Troubleshooting/gNMI Streaming.md

@@ -670,8 +670,11 @@ An asterisk (*) in the `Description` column of the tables below indicates that m
 
 |  Name | Description |
 |------ | ----------- |
-| `/components/component[name]/state/serial-no` | Serial number of the component, keyed by component name.|
-| `/components/component[name]/state/part-no` | Part number of the component, keyed by component name.|
+| `/components/component[name]/state/serial-no` | *Serial number of the chasis, keyed by component name.|
+| `/components/component[name]/state/part-no` | *Part number of the chasis, keyed by component name.|
+| `/components/component[name]/state/model-name`| *Model name of the chasis.|
+| `/components/component[name]/state/hardware-version`|  *Hardware version of the chasis.|
+| `/components/component[name]/state/type`|  *Chasis type.|
 | `/components/component[name]/storage/state/counters/rotation-rate-rpm` | Disk rotation rate in RPMs (supported only on SATA disks). |
 | `/components/component[name]/storage/state/counters/write-cache` | Indicates whether the disk has a write cache (supported only on SATA disks). |
 | `/components/component[name]/storage/state/counters/write-cache-enabled` | Indicates whether the disk write cache is enabled. (supported only on SATA disks) |

content/cumulus-linux-517/Network-Virtualization/Ethernet-Virtual-Private-Network-EVPN/EVPN-Enhancements.md

@@ -232,19 +232,23 @@ address-family l2vpn evpn
 
 ## EVPN Unreachability in Disjoined Planes
 
-In EVPN disjoined multi-plane topologies, each GPU in a cluster connects to multiple independent network planes. Leaf switches perform route aggregation per tenant VRF for scalability, but this suppresses visibility of individual host link failures. EVPN unreachability signaling in a tenant VRF sends a route to advertise host unreachability after a link failure, enabling leaf switches to send LLDP TLVs informing connected NICs to avoid unreachable paths.
+In EVPN disjoined multi-plane topologies, each GPU in a cluster connects to multiple independent network planes. Leaf switches perform route aggregation per tenant VRF for scalability but this suppresses visibility of individual host link failures. EVPN unreachability signaling in a tenant VRF sends a route to advertise host unreachability after a link failure, enabling leaf switches to send LLDP TLVs informing connected NICs to avoid unreachable paths.
+
+{{%notice note%}}
+EVPN unreachability in disjoined planes is a Beta feature.
+{{%/notice%}}
 
 To enable EVPN unreachability signaling for disjoined multi-plane topologies on each leaf switch tenant VRF:
 
-1. Configurate route aggregation in the tenant VRFs to summarize relevant network IPv4 and/or IPv6 prefixes
+1. Configurate route aggregation in the tenant VRFs to summarize relevant network IPv4 and, or IPv6 prefixes:
 
 ```
 cumulus@leaf01:mgmt:~$ nv set vrf TENANT1 router bgp address-family ipv4-unicast aggregate-route 10.1.0.0/16 summary-only enabled
 cumulus@leaf01:mgmt:~$ nv set vrf TENANT1 router bgp address-family ipv6-unicast aggregate-route 2001:db8::/64 summary-only enabled
 cumulus@leaf01:mgmt:~$ nv config apply
 ```
 
-2. Configure `bgp advertise-unreach interfaces-match <prefix>` under each IPv4 and/or IPv6 unreachability address-family to match interface prefixes attached to GPU NICs:
+2. Configure `bgp advertise-unreach interfaces-match <prefix>` under each IPv4 and, or IPv6 unreachability address-family to match interface prefixes attached to GPU NICs:
 
 ```
 cumulus@leaf01:mgmt:~$ nv set vrf TENANT1 router bgp address-family ipv4-unreachability advertise-unreach interfaces-match 10.1.0.0/16 
@@ -260,7 +264,7 @@ cumulus@leaf01:mgmt:~$ nv set vrf TENANT1 router bgp address-family ipv6-unreach
 cumulus@leaf01:mgmt:~$ nv config apply
 ```
 
-4. Enable `bgp export lldp` in tenant VRFs to configure FRR to LLDP integration to send IPv4 and/or IPv6 prefix information to LLDP
+4. Enable `bgp export lldp` in tenant VRFs to configure FRR to LLDP integration to send IPv4 and, or IPv6 prefix information to LLDP
 
 ```
 cumulus@leaf01:mgmt:~$ nv set vrf TENANT1 router bgp address-family ipv4-unreachability export-lldp state
@@ -270,6 +274,42 @@ cumulus@leaf01:mgmt:~$ nv config apply
 
 5. Enable the LLDP {{<link url="Link-Layer-Discovery-Protocol/#bgp-unreachable-prefix-tlv" text="BGP unreachable prefix TLV">}} to distribute unreachable prefix information to connected hosts.
 
+### Show EVPN Unreachability Information
+
+To show EVPN unreachability signaling information, run the `nv show vrf <vrf-id> router bgp address-family l2vpn-evpn route` command:
+
+```
+cumulus@leaf01:mgmt:~$ nv show vrf TENANT1 router bgp address-family l2vpn-evpn route
+```
+
+To show EVPN unreachability signaling for a specific IPv4 route, run the `nv show vrf <vrf-id> router bgp address-family ipv4-unreachability <route>` command:
+
+```
+cumulus@leaf01:mgmt:~$ nv show vrf TENANT1 router bgp address-family ipv4-unreachability 10.1.0.0/16
+```
+
+To show EVPN unreachability signaling for a specific IPv6 route, run the `nv show vrf <vrf-id> router bgp address-family ipv6-unreachability <route>` command:
+
+```
+cumulus@leaf01:mgmt:~$ nv show vrf TENANT1 router bgp address-family ipv6-unreachability 2001:db8::/64
+```
+
+### Known Limitations
+
+Be aware of the following limitations when configuring EVPN unreachability in disjoined planes.
+
+#### switchd Restart
+
+Restarting `switchd` results in network churn. FRR sees interfaces going down, which triggers BGP to start advertising EVPN unreachable routes and brings down peering. BGP withdraws the EVPN unreachable routes and re-establishes BGP sessions after the interfaces are back up operationally.
+
+#### Link Down with Dynamic VRF Assignment on 802.1X Interfaces
+
+When a link with a configured IP address goes down operationally on the leaf switch on only one plane, BGP on the leaf advertises the EVPN unreachable route type for the IP prefix of the interface that is operationally down. However, because the interface is unassigned from the VRF, BGP withdraws the EVPN unreachable route type from the remote leaf switch. Because the remote node still has the aggregate summary route, the leaf switch where the link is down attracts traffic and blocks it instead of rerouting traffic through other healthy planes.
+
+#### Redistributed Route Overlapping with the Interface Match Command
+
+If an interface address redistributed by BGP falls within the IP address range configured in the `bgp advertise-unreach interfaces-match` command and the interface goes down operationally, BGP withdraws the type-5 route and advertise the EVPN unreachable route type for the interface IP address.
+
 ## Enable EVPN in an iBGP Environment with an OSPF Underlay
 
 You can use EVPN with an {{<link url="Open-Shortest-Path-First-OSPF" text="OSPF">}} or static route underlay. This is a more complex configuration than using <span class="a-tooltip">[eBGP](## "external BGP")</span>. In this case, <span class="a-tooltip">[iBGP](## "internal BGP")</span> advertises EVPN routes directly between <span class="a-tooltip">[VTEPs](## "Virtual Tunnel End Points")</span> and the spines are unaware of EVPN or BGP.

content/cumulus-linux-517/Whats-New/New-and-Updated-Telemetry-Metrics.md

@@ -159,6 +159,14 @@ The following tables list the new, updated, and deprecated gNMI and OTEL metrics
 | `/interfaces/interface[name]/phy/local_reason_opcode` | Opcode of link down reason at the local end.|
 | `/interfaces/interface[name]/phy/remote_reason_opcode` | Opcode of link down reason at the remote end.|
 
+{{< /tab >}}
+{{< tab "Platform">}}
+| `/components/component[name]/state/serial-no` | Component serial number, keyed by component name.|
+| `/components/component[name]/state/part-no` | Component part number, keyed by component name.|
+| `/components/component[name]/state/model-name`| Component model name.|
+| `/components/component[name]/state/hardware-version`| Component hardware version.|
+| `/components/component[name]/state/type`| Component type.|
+
 {{< /tab >}}
 {{< /tabs >}}
 
@@ -169,7 +177,6 @@ The following tables list the new, updated, and deprecated gNMI and OTEL metrics
 
 |  Name | Description |
 |------ | ----------- |
-
 | `node_netstat_Ip_InReceives` | | 
 | `node_netstat_Ip_InAddrErrors` | |  
 | `node_netstat_Ip_InDelivers` | |  
@@ -314,5 +321,10 @@ The following tables list the new, updated, and deprecated gNMI and OTEL metrics
 | `nvswitch_interface_phy_stats_link_down_reason_code_local ` | Opcode of link down reason at the local end.|
 | `nvswitch_interface_phy_stats_link_down_reason_code_remote ` | Opcode of link down reason at the remote end. |
 
+{{< /tab >}}
+{{< tab "Platform">}}
+
+| `nvswitch_platform_info_hw_details` | Hardware details such as the version, model name, part number, serial number, and type.|
+
 {{< /tab >}}
 {{< /tabs >}}

content/cumulus-linux-517/Whats-New/_index.md

@@ -26,17 +26,17 @@ Cumulus Linux 5.17 contains new features and improvements, and provides bug fixe
 - {{<link url="Link-Layer-Discovery-Protocol/#lldp-tlvs" text="Granular LLDP TLV definition and control">}}
 - {{<link url="Automatic-Configuration-Backup" text="Automatic configuration backup">}}
 - {{<link url="Syslog/#thermal-control-logs" text="Thermal logging in syslog (sensor and fan state and errors)">}}
-- BGP/LLDP X-Plane multi-plane'd GPUs with disjoined planes (EVPN based deployments) (Beta)
-- LLDP BGP Route Redistribution Extension (Beta)
+- {{<link url="EVPN-Enhancements/#evpn-unreachability-in-disjoined-planes" text="EVPN Unreachability in Disjoined Planes">}} (Beta)
+- {{<link url="Link-Layer-Discovery-Protocol/#bgp-unreachable-prefix-tlv" text="BGP unreachable prefix TLV">}} (Beta)
 - NVUE
   - {{<link url="Installing-a-New-Cumulus-Linux-Image-with-ONIE/#show-secure-boot-details" text="NVUE command to show secure boot status and details">}}
   - {{<link url="RDMA-over-Converged-Ethernet-RoCE/#verify-roce-configuration" text="nv show interface <interface-id> qos roce counters supports multiple interfaces, including ranges">}}
   - {{<link url="NVUE-CLI/#configuration-commands" text="NVUE prevents configuration changes during long background operations">}}
   -  {{<link url="NVUE-CLI/#verify-configuration-before-applying" text="NVUE command">}} and {{<link url="NVUE-API/#verify-configuration-before-applying" text="NVUE API option">}} to verify configuration before applying
   - {{<link url="System-Power-and-Switch-Reboot/#show-reboot" text="NVUE command to show warm boot status ">}}
 - Telemetry
-  - New OTEL metrics: {{<link url="Open-Telemetry-Export/#interface-statistic-format" text="link debounce">}}, {{<link url="Open-Telemetry-Export/#interface-statistic-format" text="PHY link down">}}, and {{<link url="Open-Telemetry-Export/#control-plane-statistic-format" text="control plane">}}
-  - New gNMI metrics: {{<link url="gNMI-Streaming/#metrics" text="PHY link down, link debounce, control plane, and systemd service">}}
+  - New OTEL metrics: {{<link url="Open-Telemetry-Export/#interface-statistic-format" text="link debounce">}}, {{<link url="Open-Telemetry-Export/#interface-statistic-format" text="PHY link down">}}, {{<link url="Open-Telemetry-Export/#control-plane-statistic-format" text="control plane">}}, and {{<link url="Open-Telemetry-Export/#platform-statistic-format" text="platform information">}}
+  - New gNMI metrics: {{<link url="gNMI-Streaming/#metrics" text="PHY link down, link debounce, control plane, platform information, and systemd service">}}
   - {{<link url="Open-Telemetry-Export/#granular-metric-selection" text="OTEL granular metric selection">}} (Beta)
   - {{<link url="High-Frequency-Telemetry/#streaming-hft-export" text="High frequency telemetry streaming over IPFIX">}}
 - Security