Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
8911981
RT-1.21: Update README for BGP TCP MSS and PMTUD
Nov 3, 2026
2a18b03
RT-1.21: Add summary TODO for the in-use MSS leaf
Nov 3, 2026
ac33b9f
RT-1.21: Tighten MSS range checks and clarify state semantics
Nov 3, 2026
c2d8aef
RT-1.21: Address review comments on scope and coverage
Nov 3, 2026
ddaedd3
RT-1.21: Use a single DUT (TESTBED_DUT_ATE_2LINKS)
Nov 4, 2026
0d25b85
Merge branch 'main' into rt-1.21-readme-tcp-mss
isnehashankar43 Nov 4, 2026
58b516c
Merge branch 'main' into rt-1.21-readme-tcp-mss
isnehashankar43 Nov 4, 2026
a6b7bb0
Merge branch 'main' into rt-1.21-readme-tcp-mss
isnehashankar43 Nov 5, 2026
079b37b
Merge branch 'main' into rt-1.21-readme-tcp-mss
isnehashankar43 Nov 5, 2026
c66f8a4
Merge branch 'main' into rt-1.21-readme-tcp-mss
isnehashankar43 Nov 5, 2026
401b8fa
Merge branch 'main' into rt-1.21-readme-tcp-mss
isnehashankar43 Nov 6, 2026
c3b0a7c
RT-1.21: Record session resets on MSS change; clarify PMTUD scope
Nov 6, 2026
282a547
RT-1.21: Clarify that the RT-1.21.1 MSS applies only to the eBGP neig…
Nov 6, 2026
cf036ea
RT-1.21: Cover eBGP and iBGP at the neighbor and peer-group levels
Nov 6, 2026
1af0882
RT-1.21: Remove TCP MD5 authentication from the iBGP sessions
Nov 6, 2026
a189fca
RT-1.21: Add TODO to remove MD5 from the test code
Nov 6, 2026
4712b32
RT-1.21: Separate the MSS and PMTUD subtests
Nov 6, 2026
d1db33b
RT-1.21: Use two subtests, one for MSS and one for PMTUD
Nov 6, 2026
66b18bf
RT-1.21: Add the neighbor-level override at the peer-group level
Nov 9, 2026
a69b8ac
Merge branch 'main' into rt-1.21-readme-tcp-mss
isnehashankar43 Nov 9, 2026
24e94d3
RT-1.22: Add BGP TCP MSS test README
Nov 11, 2026
3f12569
RT-1.21: Test PMTUD through a looped network instance
Nov 11, 2026
b39bdc4
Merge branch 'main' into rt-1.21-readme-tcp-mss
dplore Nov 12, 2026
1853eff
RT-1.22: Add the BGP TCP MSS test plan
Nov 12, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
262 changes: 262 additions & 0 deletions feature/bgp/otg_tests/bgp_tcp_mss/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,262 @@
# RT-1.22: BGP TCP MSS

## Summary

This test validates that the router supports the TCP maximum segment size (MSS)
setting for BGP sessions:

* Configuration and state of the TCP MSS (`transport/config/tcp-mss` and
`transport/state/tcp-mss`) at the neighbor level and at the peer-group
level
* A value set on a neighbor overrides the peer-group value for that neighbor
only. The other neighbors in the peer group keep the peer-group value.
* IPv4 and IPv6 eBGP and iBGP sessions
* `transport/state/tcp-mss` reports the configured MSS (the applied
configuration, including a value inherited from the peer group), in the
same way as `timers/state/hold-time`. When no MSS is configured, it may
instead report the MSS in use on the TCP session.

Path MTU discovery (PMTUD) is covered by RT-1.21.

### Testbed type

* [TESTBED_DUT_ATE_2LINKS](https://github.com/openconfig/featureprofiles/blob/main/topologies/atedut_2.testbed)

### Topology

```mermaid
graph LR
ATE["ATE"] <-->|"port-1: eBGP IPv4 and IPv6"| DUT["DUT"]
ATE <-->|"port-2: iBGP IPv4 and IPv6"| DUT
```

### DUT and OTG properties

| Device | Port | IPv4 | IPv6 | AS |
| :----- | :----- | :----------- | :---------------------- | :---- |
| DUT | Port 1 | 192.0.2.1/30 | 2001:db8::192:0:2:1/126 | 64500 |
| DUT | Port 2 | 192.0.2.5/30 | 2001:db8::192:0:2:5/126 | 64500 |
| ATE | Port 1 | 192.0.2.2/30 | 2001:db8::192:0:2:2/126 | 64501 |
| ATE | Port 2 | 192.0.2.6/30 | 2001:db8::192:0:2:6/126 | 64500 |

### Procedure

#### Initial Setup:

* Connect ATE port-1 to DUT port-1, and ATE port-2 to DUT port-2.
* Configure the DUT and ATE interfaces per the table above.
* Configure BGP on the DUT (AS `64500`) with two peer groups:
* `EBGP-PEERS` (peer AS `64501`) containing the IPv4 and IPv6 eBGP
neighbors on ATE port-1.
* `IBGP-PEERS` (peer AS `64500`) containing the IPv4 and IPv6 iBGP
neighbors on ATE port-2.
* Configure the matching BGP peers on the ATE, and verify that all four
sessions are `ESTABLISHED`.

### RT-1.22.1: TCP MSS at the neighbor and peer-group levels

* If the DUT reports `transport/state/tcp-mss` for the neighbors before an
MSS is configured, verify that the value is at least the TCP default MSS
(536 for IPv4 and 1220 for IPv6) and at most the MTU of the DUT port minus
40 bytes for IPv4 or 60 bytes for IPv6 (1460 and 1440 for a 1500-byte MTU).
* Set the MTU of DUT port-1, DUT port-2, ATE port-1 and ATE port-2 to 5040
bytes, and verify that all four sessions are `ESTABLISHED`.
* Neighbor level:
* Record `state/established-transitions` for all four neighbors.
* Configure `transport/config/tcp-mss` to 4096 on all four neighbors.
* Record whether applying the MSS reset the sessions, that is, whether
`state/established-transitions` increased or `state/session-state`
left `ESTABLISHED` within 30 seconds of the change. This shows whether
the configuration change is disruptive. It is reported only and is not
a pass/fail criterion.
* Re-establish the four sessions, for example by restarting the ATE BGP
peers.
* Verify that all four sessions are `ESTABLISHED`, and that
`transport/state/tcp-mss` equals `transport/config/tcp-mss` (4096) for
all four neighbors.
* Remove `transport/config/tcp-mss` from the four neighbors.
* Peer-group level:
* Set `transport/config/tcp-mss` to 4000 on the peer groups `EBGP-PEERS`
and `IBGP-PEERS`, with no MSS configured on the neighbors.
* Re-establish the four sessions.
* Verify that all four sessions are `ESTABLISHED`, that
`transport/state/tcp-mss` is 4000 for both peer groups, and that all
four neighbors inherit it (`transport/state/tcp-mss` is 4000).
* Neighbor-level override: keep the peer-group MSS, and set
`transport/config/tcp-mss` to 1400 on one neighbor in each peer group
(the IPv4 neighbors 192.0.2.2 and 192.0.2.6).
* Re-establish the four sessions.
* Verify that all four sessions are `ESTABLISHED`, that
`transport/state/tcp-mss` is 1400 for the two IPv4 neighbors, and that
it is still 4000 for the two IPv6 neighbors and both peer groups.
* Remove `transport/config/tcp-mss` from the two IPv4 neighbors and from
both peer groups.
* Remove the MTU configuration from the four ports so that they return to the
default MTU.

#### Canonical OC

The block below shows the neighbor-level override step: the peer groups use
an MSS of 4000, and the IPv4 neighbors override it with 1400. In the
neighbor-level step, the four neighbors use 4096 instead, and the peer groups
have no MSS.

```json
{
"interfaces": {
"interface": [
{
"name": "port1",
"config": {
"name": "port1",
"type": "iana-if-type:ethernetCsmacd",
"mtu": 5040
}
},
{
"name": "port2",
"config": {
"name": "port2",
"type": "iana-if-type:ethernetCsmacd",
"mtu": 5040
}
}
]
},
"network-instances": {
"network-instance": [
{
"name": "DEFAULT",
"config": {
"name": "DEFAULT"
},
"protocols": {
"protocol": [
{
"identifier": "BGP",
"name": "BGP",
"config": {
"identifier": "BGP",
"name": "BGP"
},
"bgp": {
"peer-groups": {
"peer-group": [
{
"peer-group-name": "EBGP-PEERS",
"config": {
"peer-group-name": "EBGP-PEERS",
"peer-as": 64501
},
"transport": {
"config": {
"tcp-mss": 4000
}
}
},
{
"peer-group-name": "IBGP-PEERS",
"config": {
"peer-group-name": "IBGP-PEERS",
"peer-as": 64500
},
"transport": {
"config": {
"tcp-mss": 4000
}
}
}
]
},
"neighbors": {
"neighbor": [
{
"neighbor-address": "192.0.2.2",
"config": {
"neighbor-address": "192.0.2.2",
"peer-group": "EBGP-PEERS"
},
"transport": {
"config": {
"tcp-mss": 1400
}
}
},
{
"neighbor-address": "2001:db8::192:0:2:2",
"config": {
"neighbor-address": "2001:db8::192:0:2:2",
"peer-group": "EBGP-PEERS"
}
},
{
"neighbor-address": "192.0.2.6",
"config": {
"neighbor-address": "192.0.2.6",
"peer-group": "IBGP-PEERS"
},
"transport": {
"config": {
"tcp-mss": 1400
}
}
},
{
"neighbor-address": "2001:db8::192:0:2:6",
"config": {
"neighbor-address": "2001:db8::192:0:2:6",
"peer-group": "IBGP-PEERS"
}
}
]
}
}
}
]
}
}
]
}
}
```

#### Test pass fail criteria

* If any of the below conditions occur, the test should be declared as a
"FAIL":
1. A BGP session is not `ESTABLISHED` after it is re-established
2. `transport/state/tcp-mss` is not 4096 for a neighbor at the neighbor
level, not 1400 for a neighbor with the override, or not 4000 for a
peer group or any other neighbor at the peer-group level
3. A `transport/state/tcp-mss` reported before any MSS is configured is
outside the range given in `RT-1.22.1`

### Cleanup

* Remove the BGP and MTU configurations from the DUT and stop OTG protocols
to restore the baseline state.

## OpenConfig Path and RPC Coverage

```yaml
paths:
## Config Parameter Coverage
/network-instances/network-instance/protocols/protocol/bgp/neighbors/neighbor/transport/config/tcp-mss:
/network-instances/network-instance/protocols/protocol/bgp/peer-groups/peer-group/transport/config/tcp-mss:

## Telemetry Parameter Coverage
/network-instances/network-instance/protocols/protocol/bgp/neighbors/neighbor/transport/state/tcp-mss:
/network-instances/network-instance/protocols/protocol/bgp/peer-groups/peer-group/transport/state/tcp-mss:

rpcs:
gnmi:
gNMI.Set:
replace: true
delete: true
gNMI.Subscribe:
on_change: true
```

## Minimum DUT platform requirement

N/A
8 changes: 8 additions & 0 deletions feature/bgp/otg_tests/bgp_tcp_mss/metadata.textproto
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# proto-file: github.com/openconfig/featureprofiles/proto/metadata.proto
# proto-message: Metadata

uuid: "8764301d-6146-4a31-ac8f-5d1568e3f5fe"
plan_id: "RT-1.22"
description: "BGP TCP MSS"
testbed: TESTBED_DUT_ATE_2LINKS
tags: TAGS_AGGREGATION
5 changes: 5 additions & 0 deletions testregistry.textproto
Original file line number Diff line number Diff line change
Expand Up @@ -886,6 +886,11 @@ test: {
readme: "https://github.com/openconfig/featureprofiles/blob/main/feature/bgp/otg_tests/bgp_tcp_mss_path_mtu/README.md"
exec: "https://github.com/openconfig/featureprofiles/blob/main/feature/bgp/otg_tests/bgp_tcp_mss_path_mtu/bgp_tcp_mss_path_mtu_test.go"
}
test: {
id: "RT-1.22"
description: "BGP TCP MSS"
readme: "https://github.com/openconfig/featureprofiles/blob/main/feature/bgp/otg_tests/bgp_tcp_mss/README.md"
}
test: {
id: "RT-1.23"
description: "BGP AFI SAFI OC DEFAULTS"
Expand Down
Loading