packet_link_qualification_test - openconfig/featureprofiles GitHub Wiki
Validate gNOI RPC can support packet-based link qualification test for the 400g and 100g links within 1 DUT.
+-------------------------+ +-------------------------+
| NEAR_END Generator | | FAR_END Reflector |
| | 400G Link | |
| dut:port1 (lag1) | <=====================> | dut:port2 (lag2) |
| 192.0.2.1/30 | (PBLQ TX / Loopback) | 192.0.2.5/30 |
| 198.51.100.1/30 (LAG) | | 198.51.100.5/30 (LAG) |
| | 100G Link | |
| dut:port3 (lag3) | <=====================> | dut:port4 (lag4) |
| 192.0.2.9/30 | (PBLQ TX / Loopback) | 192.0.2.13/30 |
| 198.51.100.9/30 (LAG) | | 198.51.100.13/30 (LAG) |
+-------------------------+ +-------------------------+
-
dut:port1 <--> dut:port2- 400G ports (port 1 and 2 as singleton and memberlink) -
dut:port3 <--> dut:port4- 100G ports (port 3 and 4 as singleton and memberlink)
-
Capabilities Validation (
CapabilitiesRPC):- Connect the ports as per topology and issue
gnoi.packet_link_qualification.LinkQualification.Capabilities. - Validate the
CapabilitiesResponsefields:-
timeexists (time.seconds >= 1). -
max_historical_results_per_interface >= 2. -
generator.packet_generator:min_mtu >= 64max_mtu >= 8184-
max_bps >= 4e11(400G) /1e11(100G) -
max_pps >= 5e8(or device capability threshold>= 1e8) -
min_setup_duration > 0(>= 1s) -
min_teardown_duration > 0(>= 1s) -
min_sample_interval > 0(>= 10s)
-
reflector(pmd_loopbackorasic_loopback):-
min_setup_duration > 0(>= 1s) -
min_teardown_duration > 0(>= 1s)
-
-
- Connect the ports as per topology and issue
-
Non-Existent ID Error Handling (
GetandDeleteRPCs):- Issue
gnoi.packet_link_qualification.LinkQualification.Getandgnoi.packet_link_qualification.LinkQualification.Deleterequests using a non-existent qualification ID. - Verify that the per-ID status code returned in both
GetResponseandDeleteResponseis5(NOT_FOUND, HTTP Mapping:404 Not Found).
- Issue
-
Baseline List and Delete Validation (
ListandDeleteRPCs):- Issue
gnoi.packet_link_qualification.LinkQualification.Listto query existing link qualification records on the DUT. - If any qualification records exist, delete them via
gnoi.packet_link_qualification.LinkQualification.Delete. - Issue
gnoi.packet_link_qualification.LinkQualification.Listagain and verify that0qualification records remain so subsequent tests start from a clean baseline.
- Issue
This subtest validates that the gNOI LinkQualification service can
concurrently qualify all 4 physical links (both 400G and 100G interfaces) as
singleton Layer 3 interfaces without encountering DEADLINE_EXCEEDED gRPC
errors during session creation (Create), state monitoring (List), result
retrieval (Get), or post-qualification cleanup (Delete).
-
Interface Configuration and Pre-Test Baseline:
- Configure
dut:port1,dut:port2(400G interfaces) anddut:port3,dut:port4(100G interfaces) as singleton Ethernet interfaces usinggNMI.Set:- Set
/interfaces/interface/config/typetoethernetCsmacd,/interfaces/interface/config/enabledtotrue, and/interfaces/interface/config/mtuto9000. - Configure dual-stack IPv4 and IPv6 addressing on subinterface
0(/interfaces/interface/subinterfaces/subinterface/index):-
port1: IPv4192.0.2.1/30and IPv62001:db8::1/126 -
port2: IPv4192.0.2.5/30and IPv62001:db8::5/126 -
port3: IPv4192.0.2.9/30and IPv62001:db8::9/126 -
port4: IPv4192.0.2.13/30and IPv62001:db8::d/126 - Enable both address families by setting
/interfaces/interface/subinterfaces/subinterface/ipv4/config/enabledtotrueand/interfaces/interface/subinterfaces/subinterface/ipv6/config/enabledtotrue.
-
- Set
- Verify via
gNMI.Subscribethat/interfaces/interface/state/admin-statusisUPand/interfaces/interface/state/oper-statusisUPon all 4 interfaces before starting link qualification.
- Configure
-
Concurrent Multi-Link Qualification Start (
CreateRPC):- Using the minimum setup and teardown durations reported by
LinkQualification.CapabilitiesingNOI-2.1.1, issuegnoi.packet_link_qualification.LinkQualification.Createwith an explicit RPC deadline (e.g., 60 seconds) to initiate link qualification simultaneously across all connected port pairs (port1 <--> port2on 400G andport3 <--> port4on 100G):-
NEAR_END (Generator) Interfaces (
port1,port3): ConfigurePacketGeneratorConfigurationwithpacket_rateset to138888PPS andpacket_sizeset to8184bytes, andRPCSyncedTimingset topre_sync_duration: 10s,setup_duration: >= 30s,duration: 180s,post_sync_duration: 0s, andteardown_duration: >= 30s. -
FAR_END (Reflector) Interfaces (
port2,port4): ConfigureAsicLoopbackConfiguration(orPmdLoopbackConfigurationbased on device capabilities) to place the reflector port in loopback mode, withRPCSyncedTimingset topre_sync_duration: 0s,setup_duration: >= 40s,duration: 180s,post_sync_duration: 30s, andteardown_duration: >= 10s.
-
NEAR_END (Generator) Interfaces (
-
Pass/Fail Criteria (
Create): TheCreateRPC must complete before the context deadline expires without returningDEADLINE_EXCEEDED, andCreateResponse.statusmust contain an entry for every requested generator and reflector qualification ID withstatus.code == 0(OK).
- Using the minimum setup and teardown durations reported by
-
Concurrent Active State and Telemetry Verification (
ListRPC):- While the qualification is active, query
gnoi.packet_link_qualification.LinkQualification.Listwith an explicit RPC deadline. - Verify that all requested qualification IDs are present in
ListResponse.resultsand transition toQUALIFICATION_STATE_RUNNING. - While the qualification state is
QUALIFICATION_STATE_RUNNING, verify viagNMI.GetorgNMI.Subscribethat/interfaces/interface/state/oper-statuson all participating generator and reflector ports reportsTESTING.
- While the qualification is active, query
-
Concurrent Result Retrieval and Counter Validation (
GetRPC):- Wait for the qualification duration and teardown window to complete, and
confirm via
LinkQualification.Listthat all qualification IDs reachQUALIFICATION_STATE_COMPLETED. - Issue a batched
gnoi.packet_link_qualification.LinkQualification.GetRPC requesting all qualification IDs simultaneously with an explicit RPC deadline. -
Pass/Fail Criteria (
Get):- The
GetRPC must complete within the context deadline withoutDEADLINE_EXCEEDED. - For every qualification ID:
status.code == 0,state == QUALIFICATION_STATE_COMPLETED,packets_error == 0, andpackets_dropped == 0. - On all
NEAR_ENDgenerator interfaces (andFAR_ENDreflector interfaces whenAsicLoopbackis used and reflector stats are supported),packets_sent > 0andpackets_received > 0. - When
AsicLoopbackis used and reflector stats are supported, the discrepancy between generatorpackets_sent/packets_receivedand reflectorpackets_received/packets_sentmust not exceed0.0001%. WhenPmdLoopbackis used or reflector stats are unsupported, the discrepancy betweenpackets_sentandpackets_receivedon theNEAR_ENDgenerator result must not exceed0.0001%.
- The
- Wait for the qualification duration and teardown window to complete, and
confirm via
-
Cleanup and Interface State Restoration (
DeleteRPC):- Issue
gnoi.packet_link_qualification.LinkQualification.Deletecontaining all qualification IDs with an explicit RPC deadline to clean up all completed sessions. -
Pass/Fail Criteria (
Delete& Recovery):- The
DeleteRPC must complete within the context deadline withoutDEADLINE_EXCEEDEDand returnstatus.code == 0for each ID. - A subsequent
LinkQualification.Listcall must return0qualification entries. - Verify via
gNMI.Subscribethat/interfaces/interface/state/oper-statuson all 4 interfaces returns fromTESTINGtoUP.
- The
- Issue
{
"interfaces": {
"interface": [
{
"config": {
"description": "Singleton 400G Generator Port 1",
"enabled": true,
"mtu": 9000,
"name": "port1",
"type": "iana-if-type:ethernetCsmacd"
},
"name": "port1",
"subinterfaces": {
"subinterface": [
{
"config": {
"index": 0
},
"index": 0,
"ipv4": {
"addresses": {
"address": [
{
"config": {
"ip": "192.0.2.1",
"prefix-length": 30
},
"ip": "192.0.2.1"
}
]
},
"config": {
"enabled": true
}
},
"ipv6": {
"addresses": {
"address": [
{
"config": {
"ip": "2001:db8::1",
"prefix-length": 126
},
"ip": "2001:db8::1"
}
]
},
"config": {
"enabled": true
}
}
}
]
}
},
{
"config": {
"description": "Singleton 400G Reflector Port 2",
"enabled": true,
"mtu": 9000,
"name": "port2",
"type": "iana-if-type:ethernetCsmacd"
},
"name": "port2",
"subinterfaces": {
"subinterface": [
{
"config": {
"index": 0
},
"index": 0,
"ipv4": {
"addresses": {
"address": [
{
"config": {
"ip": "192.0.2.5",
"prefix-length": 30
},
"ip": "192.0.2.5"
}
]
},
"config": {
"enabled": true
}
},
"ipv6": {
"addresses": {
"address": [
{
"config": {
"ip": "2001:db8::5",
"prefix-length": 126
},
"ip": "2001:db8::5"
}
]
},
"config": {
"enabled": true
}
}
}
]
}
},
{
"config": {
"description": "Singleton 100G Generator Port 3",
"enabled": true,
"mtu": 9000,
"name": "port3",
"type": "iana-if-type:ethernetCsmacd"
},
"name": "port3",
"subinterfaces": {
"subinterface": [
{
"config": {
"index": 0
},
"index": 0,
"ipv4": {
"addresses": {
"address": [
{
"config": {
"ip": "192.0.2.9",
"prefix-length": 30
},
"ip": "192.0.2.9"
}
]
},
"config": {
"enabled": true
}
},
"ipv6": {
"addresses": {
"address": [
{
"config": {
"ip": "2001:db8::9",
"prefix-length": 126
},
"ip": "2001:db8::9"
}
]
},
"config": {
"enabled": true
}
}
}
]
}
},
{
"config": {
"description": "Singleton 100G Reflector Port 4",
"enabled": true,
"mtu": 9000,
"name": "port4",
"type": "iana-if-type:ethernetCsmacd"
},
"name": "port4",
"subinterfaces": {
"subinterface": [
{
"config": {
"index": 0
},
"index": 0,
"ipv4": {
"addresses": {
"address": [
{
"config": {
"ip": "192.0.2.13",
"prefix-length": 30
},
"ip": "192.0.2.13"
}
]
},
"config": {
"enabled": true
}
},
"ipv6": {
"addresses": {
"address": [
{
"config": {
"ip": "2001:db8::d",
"prefix-length": 126
},
"ip": "2001:db8::d"
}
]
},
"config": {
"enabled": true
}
}
}
]
}
}
]
}
}This subtest validates that physical interfaces configured as member links of
static IEEE 802.3ad Link Aggregation Group (LAG) bundles with dual-stack IPv4
and IPv6 subinterfaces can undergo concurrent Packet-Based Link Qualification
across multiple links without gNOI RPC timeouts, and that both the physical
member ports and parent LAG interfaces recover to UP upon test completion and
cleanup.
-
Aggregate and Member-Link Configuration:
- Configure static aggregate interfaces (
lag1,lag2for the 400G ports andlag3,lag4for the 100G ports) usinggNMI.Set:- Set
/interfaces/interface/config/typetoieee8023adLag,/interfaces/interface/config/enabledtotrue,/interfaces/interface/config/mtuto9000, and/interfaces/interface/aggregation/config/lag-typetoSTATIC. - Configure dual-stack IPv4 and IPv6 addresses on subinterface
0of each aggregate interface:-
lag1: IPv4198.51.100.1/30and IPv62001:db8:1::1/126 -
lag2: IPv4198.51.100.5/30and IPv62001:db8:1::5/126 -
lag3: IPv4198.51.100.9/30and IPv62001:db8:1::9/126 -
lag4: IPv4198.51.100.13/30and IPv62001:db8:1::d/126 - Set
/interfaces/interface/subinterfaces/subinterface/ipv4/config/enabledand/interfaces/interface/subinterfaces/subinterface/ipv6/config/enabledtotrue.
-
- Set
- Bind physical member ports
port1->lag1,port2->lag2,port3->lag3, andport4->lag4by setting/interfaces/interface/ethernet/config/aggregate-idand/interfaces/interface/config/idon each physical interface. - Verify via
gNMI.Subscribethat/interfaces/interface/state/oper-statusisUPon all aggregate interfaces (lag1throughlag4) and all physical member interfaces (port1throughport4), and that/interfaces/interface/ethernet/state/aggregate-idreflects the assigned LAG name.
- Configure static aggregate interfaces (
-
Concurrent Member-Link Qualification (
Create,List,GetRPCs):- Issue
gnoi.packet_link_qualification.LinkQualification.Createconcurrently across all 4 physical LAG member interfaces (port1andport3asNEAR_ENDPacketGeneratorendpoints withpacket_rate: 138888andpacket_size: 8184;port2andport4asFAR_ENDAsicLoopbackorPmdLoopbackendpoints) with an explicit RPC deadline. - Verify that
Createsucceeds withoutDEADLINE_EXCEEDEDand returnsstatus.code == 0for all 4 member-link qualification IDs. - Query
gnoi.packet_link_qualification.LinkQualification.Listduring the qualification run and verify all 4 member-link qualification IDs are active and that/interfaces/interface/state/oper-statusonport1,port2,port3, andport4transitions toTESTINGwhilestate == QUALIFICATION_STATE_RUNNING. - Once all 4 member-link qualifications transition to
QUALIFICATION_STATE_COMPLETED, invokegnoi.packet_link_qualification.LinkQualification.Getfor all 4 IDs simultaneously with an explicit RPC deadline. -
Pass/Fail Criteria:
-
Getcompletes within the RPC deadline withoutDEADLINE_EXCEEDED. - Every member link reports
status.code == 0,state == QUALIFICATION_STATE_COMPLETED,packets_error == 0, andpackets_dropped == 0. - On all
NEAR_ENDgenerator interfaces (andFAR_ENDreflector interfaces whenAsicLoopbackis used and reflector stats are supported),packets_sent > 0andpackets_received > 0. - When
AsicLoopbackis used and reflector stats are supported, the discrepancy between generatorpackets_sent/packets_receivedand reflectorpackets_received/packets_sentmust not exceed0.0001%. WhenPmdLoopbackis used or reflector stats are unsupported, the discrepancy betweenpackets_sentandpackets_receivedon theNEAR_ENDgenerator result must not exceed0.0001%.
-
- Issue
-
Cleanup and LAG Recovery Verification (
DeleteRPC):- Delete all 4 member-link qualification records via
gnoi.packet_link_qualification.LinkQualification.Deletewith an explicit RPC deadline and verifystatus.code == 0for each ID. - Confirm via
LinkQualification.Listthat0qualification records remain on the device. - Verify via
gNMI.Subscribethat/interfaces/interface/state/oper-statusreturns toUPon all 4 physical member interfaces (port1throughport4) and all 4 parent aggregate interfaces (lag1throughlag4), and restore baseline interface configuration.
- Delete all 4 member-link qualification records via
{
"interfaces": {
"interface": [
{
"aggregation": {
"config": {
"lag-type": "STATIC"
}
},
"config": {
"description": "400G Aggregate Interface 1",
"enabled": true,
"mtu": 9000,
"name": "lag1",
"type": "iana-if-type:ieee8023adLag"
},
"name": "lag1",
"subinterfaces": {
"subinterface": [
{
"config": {
"index": 0
},
"index": 0,
"ipv4": {
"addresses": {
"address": [
{
"config": {
"ip": "198.51.100.1",
"prefix-length": 30
},
"ip": "198.51.100.1"
}
]
},
"config": {
"enabled": true
}
},
"ipv6": {
"addresses": {
"address": [
{
"config": {
"ip": "2001:db8:1::1",
"prefix-length": 126
},
"ip": "2001:db8:1::1"
}
]
},
"config": {
"enabled": true
}
}
}
]
}
},
{
"aggregation": {
"config": {
"lag-type": "STATIC"
}
},
"config": {
"description": "400G Aggregate Interface 2",
"enabled": true,
"mtu": 9000,
"name": "lag2",
"type": "iana-if-type:ieee8023adLag"
},
"name": "lag2",
"subinterfaces": {
"subinterface": [
{
"config": {
"index": 0
},
"index": 0,
"ipv4": {
"addresses": {
"address": [
{
"config": {
"ip": "198.51.100.5",
"prefix-length": 30
},
"ip": "198.51.100.5"
}
]
},
"config": {
"enabled": true
}
},
"ipv6": {
"addresses": {
"address": [
{
"config": {
"ip": "2001:db8:1::5",
"prefix-length": 126
},
"ip": "2001:db8:1::5"
}
]
},
"config": {
"enabled": true
}
}
}
]
}
},
{
"aggregation": {
"config": {
"lag-type": "STATIC"
}
},
"config": {
"description": "100G Aggregate Interface 3",
"enabled": true,
"mtu": 9000,
"name": "lag3",
"type": "iana-if-type:ieee8023adLag"
},
"name": "lag3",
"subinterfaces": {
"subinterface": [
{
"config": {
"index": 0
},
"index": 0,
"ipv4": {
"addresses": {
"address": [
{
"config": {
"ip": "198.51.100.9",
"prefix-length": 30
},
"ip": "198.51.100.9"
}
]
},
"config": {
"enabled": true
}
},
"ipv6": {
"addresses": {
"address": [
{
"config": {
"ip": "2001:db8:1::9",
"prefix-length": 126
},
"ip": "2001:db8:1::9"
}
]
},
"config": {
"enabled": true
}
}
}
]
}
},
{
"aggregation": {
"config": {
"lag-type": "STATIC"
}
},
"config": {
"description": "100G Aggregate Interface 4",
"enabled": true,
"mtu": 9000,
"name": "lag4",
"type": "iana-if-type:ieee8023adLag"
},
"name": "lag4",
"subinterfaces": {
"subinterface": [
{
"config": {
"index": 0
},
"index": 0,
"ipv4": {
"addresses": {
"address": [
{
"config": {
"ip": "198.51.100.13",
"prefix-length": 30
},
"ip": "198.51.100.13"
}
]
},
"config": {
"enabled": true
}
},
"ipv6": {
"addresses": {
"address": [
{
"config": {
"ip": "2001:db8:1::d",
"prefix-length": 126
},
"ip": "2001:db8:1::d"
}
]
},
"config": {
"enabled": true
}
}
}
]
}
},
{
"config": {
"description": "LAG Member Port 1",
"enabled": true,
"id": 10,
"name": "port1",
"type": "iana-if-type:ethernetCsmacd"
},
"ethernet": {
"config": {
"aggregate-id": "lag1"
}
},
"name": "port1"
},
{
"config": {
"description": "LAG Member Port 2",
"enabled": true,
"id": 11,
"name": "port2",
"type": "iana-if-type:ethernetCsmacd"
},
"ethernet": {
"config": {
"aggregate-id": "lag2"
}
},
"name": "port2"
},
{
"config": {
"description": "LAG Member Port 3",
"enabled": true,
"id": 12,
"name": "port3",
"type": "iana-if-type:ethernetCsmacd"
},
"ethernet": {
"config": {
"aggregate-id": "lag3"
}
},
"name": "port3"
},
{
"config": {
"description": "LAG Member Port 4",
"enabled": true,
"id": 13,
"name": "port4",
"type": "iana-if-type:ethernetCsmacd"
},
"ethernet": {
"config": {
"aggregate-id": "lag4"
}
},
"name": "port4"
}
]
}
}- Issue
gnoi.packet_link_qualification.LinkQualification.Deleteto remove any remaining active or historical link qualification sessions, and confirm viagnoi.packet_link_qualification.LinkQualification.Listthat0qualification records remain on the DUT. - Revert all test-specific singleton and LAG configurations via
gNMI.Set, including removing the aggregate interfaces (lag1throughlag4), clearing/interfaces/interface/ethernet/config/aggregate-idand/interfaces/interface/config/idbindings on the physical member ports (port1throughport4), and removing test IPv4/IPv6 subinterface addresses. - Verify via
gNMI.Subscribethat/interfaces/interface/state/admin-statusand/interfaces/interface/state/oper-statuson all physical interfaces (port1throughport4) areUPand the DUT is restored to its baseline operational state.
The below yaml defines the OC paths intended to be covered by this test. OC paths used for test setup are not listed here.
paths:
/interfaces/interface/aggregation/config/lag-type:
/interfaces/interface/config/description:
/interfaces/interface/config/enabled:
/interfaces/interface/config/id:
/interfaces/interface/config/mtu:
/interfaces/interface/config/name:
/interfaces/interface/config/type:
/interfaces/interface/ethernet/config/aggregate-id:
/interfaces/interface/ethernet/state/aggregate-id:
/interfaces/interface/state/admin-status:
/interfaces/interface/state/oper-status:
/interfaces/interface/subinterfaces/subinterface/config/index:
/interfaces/interface/subinterfaces/subinterface/ipv4/addresses/address/config/ip:
/interfaces/interface/subinterfaces/subinterface/ipv4/addresses/address/config/prefix-length:
/interfaces/interface/subinterfaces/subinterface/ipv4/config/enabled:
/interfaces/interface/subinterfaces/subinterface/ipv6/addresses/address/config/ip:
/interfaces/interface/subinterfaces/subinterface/ipv6/addresses/address/config/prefix-length:
/interfaces/interface/subinterfaces/subinterface/ipv6/config/enabled:
rpcs:
gnmi:
gNMI.Get:
gNMI.Set:
gNMI.Subscribe:
gnoi:
packet_link_qualification.LinkQualification.Capabilities:
packet_link_qualification.LinkQualification.Create:
packet_link_qualification.LinkQualification.Delete:
packet_link_qualification.LinkQualification.Get:
packet_link_qualification.LinkQualification.List: