Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/stage'
Browse files Browse the repository at this point in the history
  • Loading branch information
Cumulus Docs Auto Merge committed Jan 31, 2025
2 parents b5e3e60 + 0e2b79f commit 3578453
Show file tree
Hide file tree
Showing 5 changed files with 35 additions and 10 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -1382,7 +1382,7 @@ cumulus@leaf01:~$

## BGP Prefix Independent Convergence

BGP prefix independent convergence (PIC) reduces convergence times and improves unicast traffic convergence for remote link and node failures (when the BGP next hop fails) regardless of route scale. A remote link is a link between a spine and a remote leaf, or a spine and the super spine layer.
BGP prefix independent convergence (PIC) reduces convergence times and improves unicast traffic convergence for remote link and node failures (when the BGP next hop fails), regardless of route scale. A remote link is a link between a spine and a remote leaf, or a spine and the super spine layer.

When you configure BGP PIC, Cumulus Linux assigns one next hop group for each source and the remote leaf advertises a route with a prefix derived from the router ID. The remote leaf tags prefix routes with a route-origin extended community (SOO) so that the local leaf recognizes the routes. When the network topology changes, the local leaf obtains the router ID route with the updated ECMP, allowing a O (1) next hop group replace operation for all prefixes from the remote leaf without waiting for individual BGP updates.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -280,19 +280,43 @@ By default, OTLP export is in **secure** mode that requires a certificate. For c

### Customize Export

By default, the switch exports all statistics enabled {{<link url="#configure-open-telemetry" text="globally">}} (with the `nv set system telemetry <statistics>` command) to all configured OTLP destinations. If you want to export different metrics to different OTLP destinations, you can customize the export by specifying a statistics group (`interface-stats`, `platform-stats`, `histogram-stats`, or `routing-stats`) for a destination.
By default, the switch exports all statistics enabled {{<link url="#configure-open-telemetry" text="globally">}} (with the `nv set system telemetry <statistics>` command) to all configured OTLP destinations. If you want to export different metrics to different OTLP destinations, you can customize the export by specifying a statistics group to control which statistics you export and the sample interval for a destination.

The following example exports all platform statistics to the destination IP address 10.1.1.100:
{{%notice note%}}
Statistics groups inherit global OTLP export configurations by default. More specific configuration under a statistics group, such as enabling or disabling a statistic type or changing the sample interval overrides any global OTLP configuration.
{{%/notice%}}

The following example:
- Configures STAT-GROUP1 to export all platform statistics (`platform-stats`) but not interface statistics (`interface-stats`).
- Applies the STAT-GROUP1 configuration to the OTLP destination 10.1.1.100.

```
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP1 platform-stats export state enabled
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP1 interface-stats export state disabled
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.100 stats-group STAT-GROUP1
cumulus@switch:~$ nv config apply
```

The following example:
- Configures STAT-GROUP2 to inherit all statistic configuration from the global telemetry configuration, but changes the sample interval of `router` statistics to 100:
- Applies the STAT-GROUP2 configuration to the OTLP destination 10.1.1.200.

```
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.100 stats-group platform-stats
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP2 router sample-interval 100
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.200 stats-group STAT-GROUP2
cumulus@switch:~$ nv config apply
```

The following example exports all routing statistics to the destination IP address 10.1.1.200:
The following example:
- Configures STAT-GROUP3 to disable histogram (`histogram`) and buffer (`buffer-stats`) statistics, and enables all platform statistics(`platform-stats`) except for disk state:
- Applies the STAT-GROUP3 configuration to the OTLP destination 10.1.1.30.

```
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.200 stats-group routing
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP3 buffer-stats export state disabled
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP3 histogram export state disabled
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP3 platform-stats export state enabled
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP3 platform-stats class disk state disabled
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.30 stats-group STAT-GROUP3
cumulus@switch:~$ nv config apply
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -242,7 +242,8 @@ netgroup: nis
{{< /tabs >}}

{{%notice note%}}
If you configure the authentication order to prefer local authentication before RADIUS, login falls back to RADIUS only if the user is not present locally.
- If you configure the authentication order to prefer local authentication before RADIUS, login falls back to RADIUS only if the user is not configured locally.
- If you configure the same account on the switch locally and on your RADIUS server, you must configure the local user account before attempting authentication with RADIUS for the user; otherwise, local account creation fails.
{{%/notice%}}

## RADIUS User Command Accounting
Expand Down
2 changes: 1 addition & 1 deletion content/cumulus-linux-512/Whats-New/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ nv show system log file
nv show system log file brief
nv show system log file list
nv show system log file follow
nv show system log file <file-name>nv show system packages
nv show system log file <file-name>
nv show system log file <file-name> brief
nv show system log component
nv show system log component <component-name>
Expand Down
4 changes: 2 additions & 2 deletions content/cumulus-linux-512/Whats-New/foss.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,10 @@ Cumulus Linux 5.12 contains the following core switch package versions:

| Package | Version | Description |
| --- | ----| ----------- |
| SDK (`sx-sdk-eth`) | 4.7.3036 | Switch SDK package. Legal Notices and 3rd Party Licenses: {{<exlink url="https://content.mellanox.com/Legal/3rdPartyUnifyNotice_SDK_sx_sdk_4_7_3000_4.7.2948-010.pdf" text="SDK 3rd Party Unify Notice">}}; {{<exlink url="https://content.mellanox.com/Legal/3rdPartyNotice_SDK_sx_sdk_4_7_3000_4.7.2948-010.pdf" text="SDK 3rd Party Notice">}}; {{<exlink url="https://content.mellanox.com/Legal/license_SDK_sx_sdk_4_7_3000_4.7.2948-010.pdf" text="SDK License">}} |
| SDK (`sx-sdk-eth`) | 4.7.3056 | Switch SDK package. Legal Notices and 3rd Party Licenses: {{<exlink url="https://content.mellanox.com/Legal/3rdPartyUnifyNotice_SDK_sx_sdk_4_7_3000_4.7.2948-010.pdf" text="SDK 3rd Party Unify Notice">}}; {{<exlink url="https://content.mellanox.com/Legal/3rdPartyNotice_SDK_sx_sdk_4_7_3000_4.7.2948-010.pdf" text="SDK 3rd Party Notice">}}; {{<exlink url="https://content.mellanox.com/Legal/license_SDK_sx_sdk_4_7_3000_4.7.2948-010.pdf" text="SDK License">}} |
| MFT (`kernel-mft-dkms`) | 4.30.2-23 | Switch MFT package. Legal Notices and 3rd Party Licenses: {{<exlink url="https://content.mellanox.com/Legal/3rdPartyNotice_MFT_LINUX_4_30_2_mft-4.30.2.pdf" text="MFT 3rd Party Notice">}}; {{<exlink url="https://content.mellanox.com/Legal/license_MFT_LINUX_4_30_2_mft-4.30.2.pdf" text="MFT License">}} |
| Hardware management (`hw-management`) | 7.0040.3005 | Hardware management package.|
| NVUE (`python3-nvue`) | 1.8.0.70 | NVUE core package. |
| NVUE (`python3-nvue`) | 1.8.0.80 | NVUE core package. |
| kernel (`linux-image`) | 6.1.94 | Linux kernel package. |

To obtain a complete list of open source packages included in Cumulus Linux 5.12, see the downloads section on the {{<exlink url="https://enterprise-support.nvidia.com/s/" text="NVIDIA Enterprise support portal">}}.

0 comments on commit 3578453

Please sign in to comment.