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 23, 2025
2 parents 5b42015 + af93bbf commit e2511c7
Show file tree
Hide file tree
Showing 12 changed files with 359 additions and 368 deletions.
4 changes: 0 additions & 4 deletions ...nt/cumulus-linux-510/Layer-3/Border-Gateway-Protocol-BGP/Troubleshooting-BGP.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,6 @@ toc: 3
---
Use the following commands to troubleshoot BGP.

## Basic Troubleshooting Commands

Run the following commands to help you troubleshoot BGP.

## Show BGP configuration Summary

To show a summary of the BGP configuration on the switch, run the NVUE `nv show router bgp` command or the vtysh `show ip bgp summary` command. For example:
Expand Down
4 changes: 0 additions & 4 deletions ...nt/cumulus-linux-511/Layer-3/Border-Gateway-Protocol-BGP/Troubleshooting-BGP.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,6 @@ toc: 3
---
Use the following commands to troubleshoot BGP.

## Basic Troubleshooting Commands

Run the following commands to help you troubleshoot BGP.

## Show BGP configuration Summary

To show a summary of the BGP configuration on the switch, run the NVUE `nv show router bgp` command or the vtysh `show ip bgp summary` command. For example:
Expand Down
28 changes: 18 additions & 10 deletions content/cumulus-linux-512/Installation-Management/Upgrading-Cumulus-Linux.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -146,6 +146,8 @@ Cumulus Linux provides two different ways to upgrade the switch with a new image
- **ONIE** is an open source project (equivalent to PXE on servers) that enables the installation of network operating systems (NOS) on a switch.
- **Optimized image upgrade** uses two partitions to upgrade the image with just one reboot cycle. With two partitions on the switch, the current image boots from one partition, from which the image upgrade triggers. After detecting the running partition and checking if the second partition is available for installation, optimized upgrade starts to stage the installation in the second partition (copying the image, preparing the partition, unpacking the new image, and tuning and finalizing the new partition for the new image). The subsequent boot occurs from the second partition.

The switch does not support optimized image upgrade in {{<link url="In-Service-System-Upgrade-ISSU/#restart-mode" text="warm restart mode">}}.

{{%notice note%}}
Upgrading an MLAG pair requires additional steps. If you are using MLAG to dual connect two Cumulus Linux switches in your environment, follow the steps in [Upgrade Switches in an MLAG Pair](#upgrade-switches-in-an-mlag-pair) below to ensure a smooth upgrade.
{{%/notice%}}
Expand All @@ -165,13 +167,13 @@ Upgrading an MLAG pair requires additional steps. If you are using MLAG to dual
2. Install the image on the second partition:

```
cumulus@switch:~$ nv action install system image
cumulus@switch:~$ nv action install system image cumulus-linux-5.12.0-mlx-amd64.bin
```

Use the `force` option to force install the image:

```
cumulus@switch:~$ nv action install system image force
cumulus@switch:~$ nv action install system image cumulus-linux-5.12.0-mlx-amd64.bin force
```

3. Set the boot partition:
Expand All @@ -193,14 +195,20 @@ To show information about a cumulus image:

```
cumulus@switch:~$ nv show system image
operational
------------- --------------------
current 1
partition1
build-id 5.12.0.0012
description Cumulus Linux 5.12.0
disk /dev/vda5
release 5.12.0
operational
------------- -------------------------
current 2
next 2
partition1
build-id 5.11.0.0026.devsignedpkgs
description Cumulus Linux 5.11.0
disk /dev/sda5
release 5.11.0
partition2
build-id 5.12.0.0018.devsignedpkgs
description Cumulus Linux 5.12.0
disk /dev/sda6
release 5.12.0
```

- To list the available Cumulus Linux image files, run the `nv show system image files` command.
Expand Down
317 changes: 1 addition & 316 deletions ...lus-linux-512/Layer-3/Border-Gateway-Protocol-BGP/Optional-BGP-Configuration.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1522,322 +1522,7 @@ spine01# exit
{{< /tab >}}
{{< /tabs >}}

### Show PIC Information

{{< tabs "1585 ">}}
{{< tab "NVUE Commands ">}}

To show information about all SOO routes, run the `nv show <vrf> default router bgp address-family <address-family> soo-route` command:

```
cumulus@spine01:~$ nv show vrf default router bgp address-family ipv4-unicast soo-route
PathCnt - Number of paths for this SoO., RouteCnt - Number of routes with this
SoO, SoONhgID - Nexthop group id used by this SoO, SoORouteFlag - Indicates
Site-of-Origin route flag - I - Installed, NhgRouteCnt - Number of routes using
SoO NHG, NhgFlag - V - valid, Ip - install-pending, Dp - delete-pending
SoORouteID PathCnt RouteCnt SoONhgID SoORouteFlag NhgRouteCnt NhgFlag
---------- ------- -------- -------- ------------ ----------- -------
10.10.10.1 1 1 70328885 I 1 V
```

To show information about a specific SOO route, run the `nv show <vrf> default router bgp address-family <address-family> soo-route` command:

```
cumulus@spine01:~$ nv show vrf default router bgp address-family ipv4-unicast soo-route 10.10.10.1
operational
------------------------ -------------------------
num-paths 1
nexthop-group-id 70328885
num-routes-with-soo 1
num-routes-using-soo-nhg 1
soo-route-flag I
nhg-flags-string V
nhg-flags
nhg-valid yes
nhg-install-pending no
nhg-delete-pending no
[peer-index] fe80::4ab0:2dff:fe3a:a928
bit-map
selected-path-bitmap 1
installed-path-bitmap 1
[route-with-soo] 10.0.1.12/32
```

To show the SOO peer bit index mapping for an SOO route, run the `nv show <vrf> default router bgp address-family <address-family> soo-route <prefix> peer-index` command:

```
cumulus@spine01:~$ nv show vrf default router bgp address-family ipv4-unicast soo-route 10.10.10.1 peer-index
SooPeerBitIndex - Indicates Site-of-Origin peer bit index mapping
IPAddress SooPeerBitIndex
------------------------- ---------------
fe80::4ab0:2dff:fe3a:a928 1
```

To show if a specific route uses PIC, run the `nv show <vrf> default router bgp address-family <address-family> soo-route <prefix> route-with-soo` command:

```
cumulus@spine01:~$ nv show vrf default router bgp address-family ipv4-unicast soo-route 10.10.10.1 route-with-soo
UseSooNhg - Indicates this route-with-soo uses SooNhg, SelectedPathBitmap -
Details of Site-of-Origin selected path bitmap
Prefix UseSooNhg SelectedPathBitmap
------------ --------- ------------------
10.0.1.12/32 yes 1
```

{{< /tab >}}
{{< tab "vtysh Commands ">}}

To show information about all SOO routes, run the `show bgp vrf <vrf> <address-family> unicast soo route` command:

```
cumulus@leaf01:~$ sudo vtysh
...
show bgp vrf default ipv4 unicast soo route
BGP: VRF default
SoO: 10.10.10.1
NHG:
NHG ID: 70328887
NHG flags: Valid, Installed
SoO route:
Number of paths: 1
Number of Routes with SoO: 1
Number of Routes with SoO using SoO NHG: 1
SoO route flags: Installed
Nexthop cache:
fe80::4ab0:2dff:feec:f8e/128 NH ifidx: 3 type: 5 flags: 5 lbw: 0
Peer BitIndex Mappings:
fe80::4ab0:2dff:feec:f8e: 1
Bitmaps:
Selected path info bitmap bits set: 1
Installed path info bitmap bits set: 1
Route with SoO:
10.0.1.12/32 uses SoO NHG Selected path info bitmap bits set: 1
SoO: 10.10.10.3
NHG:
NHG ID: 70328889
NHG flags: Valid, Installed
SoO route:
Number of paths: 1
Number of Routes with SoO: 1
Number of Routes with SoO using SoO NHG: 1
SoO route flags: Installed
Nexthop cache:
fe80::4ab0:2dff:fef2:6bc5/128 NH ifidx: 5 type: 5 flags: 5 lbw: 0
Peer BitIndex Mappings:
fe80::4ab0:2dff:fef2:6bc5: 3
Bitmaps:
Selected path info bitmap bits set: 3
Installed path info bitmap bits set: 3
Route with SoO:
10.0.1.34/32 uses SoO NHG Selected path info bitmap bits set: 3
SoO: 10.10.10.2
NHG:
NHG ID: 70328888
NHG flags: Valid, Installed
SoO route:
Number of paths: 1
Number of Routes with SoO: 1
Number of Routes with SoO using SoO NHG: 0
SoO route flags: Installed
Nexthop cache:
fe80::4ab0:2dff:fe5d:6456/128 NH ifidx: 4 type: 5 flags: 5 lbw: 0
Peer BitIndex Mappings:
fe80::4ab0:2dff:fe5d:6456: 2
Bitmaps:
Selected path info bitmap bits set: 2
Installed path info bitmap bits set: 2
Route with SoO:
10.0.1.12/32 Selected path info bitmap bits set: 2
```

To show information about a specific SOO route, run the `show bgp vrf <vrf> <address-family> unicast soo route <prefix>` command:

```
cumulus@spine01:~$ sudo vtysh
...
show bgp vrf default ipv4 unicast soo route 10.10.10.3
BGP: VRF default
SoO: 10.10.10.3
NHG:
NHG ID: 70328889
NHG flags: Valid, Installed
SoO route:
Number of paths: 1
Number of Routes with SoO: 1
Number of Routes with SoO using SoO NHG: 1
SoO route flags: Installed
Nexthop cache:
fe80::4ab0:2dff:fef2:6bc5/128 NH ifidx: 5 type: 5 flags: 5 lbw: 0
Peer BitIndex Mappings:
fe80::4ab0:2dff:fef2:6bc5: 3
Bitmaps:
Selected path info bitmap bits set: 3
Installed path info bitmap bits set: 3
Route with SoO:
10.0.1.34/32 uses SoO NHG Selected path info bitmap bits set: 3
```

You can show the above commands in json format. For example:

```
cumulus@spine01:~$ sudo vtysh
...
show bgp vrf default ipv4 unicast soo route json
{
"default":[
{
"SoORoute":"10.10.10.1",
"numPaths":1,
"nexthopgroupId":70328887,
"numRoutesWithSoO":1,
"numRoutesWithSoOUsingSoONHG":1,
"nhgValid":true,
"nhgInstallPending":false,
"nhgDeletePending":false,
"SoORouteFlag":"Installed",
"nextHopCache":[
{
"prefix":"fe80::4ab0:2dff:feec:f8e/128",
"ifIndex":3,
"type":5,
"flags":5,
"lbw":0
}
],
"peerBitIndexMapping":[
{
"peerIp":"fe80::4ab0:2dff:feec:f8e",
"bitIndex":1
}
],
"bitMaps":[
{
"selectedPathBitmap":" 1",
"installedPathBitmap":" 1"
}
],
"routeWithSoO":[
{
"prefix":"10.0.1.12/32",
"usesSoONhg":true,
"selectedPathBitmap":" 1"
}
]
},
{
"SoORoute":"10.10.10.3",
"numPaths":1,
"nexthopgroupId":70328889,
"numRoutesWithSoO":1,
"numRoutesWithSoOUsingSoONHG":1,
"nhgValid":true,
"nhgInstallPending":false,
"nhgDeletePending":false,
"SoORouteFlag":"Installed",
"nextHopCache":[
{
"prefix":"fe80::4ab0:2dff:fef2:6bc5/128",
"ifIndex":5,
"type":5,
"flags":5,
"lbw":0
}
],
"peerBitIndexMapping":[
{
"peerIp":"fe80::4ab0:2dff:fef2:6bc5",
"bitIndex":3
}
],
"bitMaps":[
{
"selectedPathBitmap":" 3",
"installedPathBitmap":" 3"
}
],
"routeWithSoO":[
{
"prefix":"10.0.1.34/32",
"usesSoONhg":true,
"selectedPathBitmap":" 3"
}
]
},
{
"SoORoute":"10.10.10.2",
"numPaths":1,
"nexthopgroupId":70328888,
"numRoutesWithSoO":1,
"numRoutesWithSoOUsingSoONHG":0,
"nhgValid":true,
"nhgInstallPending":false,
"nhgDeletePending":false,
"SoORouteFlag":"Installed",
"nextHopCache":[
{
"prefix":"fe80::4ab0:2dff:fe5d:6456/128",
"ifIndex":4,
"type":5,
"flags":5,
"lbw":0
}
],
"peerBitIndexMapping":[
{
"peerIp":"fe80::4ab0:2dff:fe5d:6456",
"bitIndex":2
}
],
"bitMaps":[
{
"selectedPathBitmap":" 2",
"installedPathBitmap":" 2"
}
],
"routeWithSoO":[
{
"prefix":"10.0.1.12/32",
"usesSoONhg":false,
"selectedPathBitmap":" 2"
}
]
}
]
}
```

The `show bgp ipv4 unicast` and `show bgp ipv4 unicast <prefix>` commands also show SOO information:

```
cumulus@spine01:~$ sudo vtysh
...
show bgp ipv4 unicast 10.10.10.3
BGP routing table entry for 10.10.10.3/32, version 29 SoO:10.10.10.3, multipath soo nhg:70328889
Paths: (2 available, best #1, table default)
Advertised to non peer-group peers:
leaf01(swp1) leaf02(swp2) leaf03(swp3) leaf04(swp4) border01(swp5) border02(swp6)
65103
fe80::4ab0:2dff:fef2:6bc5 (leaf03) from leaf03(swp3) (10.10.10.3)
(fe80::4ab0:2dff:fef2:6bc5) (used)
Origin IGP, metric 0, valid, external, bestpath-from-AS 65103, best (AS Path)
Extended Community: SoO:10.10.10.3:0
Last update: Wed Jan 22 20:12:46 2025
65104 65103
fe80::4ab0:2dff:feab:57dd (leaf04) from leaf04(swp4) (10.10.10.4)
(fe80::4ab0:2dff:feab:57dd) (used)
Origin IGP, valid, external, bestpath-from-AS 65104
Extended Community: SoO:10.10.10.3:0
Last update: Wed Jan 22 20:12:46 2025
```

{{< /tab >}}
{{< /tabs >}}
Cumulus Linux provides several show commands to help you troubleshoot BGP PIC. Refer to {{<link url="Troubleshooting-BGP/#show-prefix-independent-convergence-information" text="Show Prefix Independent Convergence Information">}}.

## BGP Timers

Expand Down
Loading

0 comments on commit e2511c7

Please sign in to comment.