Skip to content

schema: document switch scope rule + v4.0 test-infrastructure-switch idea - #846

Merged
FileSystemGuy merged 1 commit into
mainfrom
schema-switch-scope-breadcrumbs
Aug 14, 2026
Merged

schema: document switch scope rule + v4.0 test-infrastructure-switch idea#846
FileSystemGuy merged 1 commit into
mainfrom
schema-switch-scope-breadcrumbs

Conversation

@FileSystemGuy

Copy link
Copy Markdown
Contributor

Comment-only change — no behavior, no schema semantics touched.

Records two things at the product_switches declaration in schema.yaml and on SwitchDescription in schema_validator.py:

  1. The switch scope rule adopted by the review chairs during the v3.0 review (2026-08-14): a switch belongs in product_switches only if it talks exclusively to storage-solution nodes. A switch the benchmark clients attach to is test infrastructure and must be omitted, because entries there feed the rule-11 total_rack_units sum and reportgen's derived "Provisioned Power (W)" column. (Applied across the v3.0 tree: Everpure PR mlcommons/submissions_storage_v3.0#200, plus guidance to Suzhou and InspurData in their submission issues mlpstorage checkpointing datasize run failed #198/cosmoflow data load too slow #199.)

  2. A v4.0 enhancement idea, deliberately not implemented: submitters have no structured slot for documenting test-infrastructure switches — the v3.0 Everpure submission wanted to honestly report a dedicated-but-client-attached 8-switch fabric and could only do so in PDF prose and YAML comments. Options sketched: a sibling test_infrastructure_switches list excluded from rule 11 and power derivation, or a scope: solution|test_infrastructure field on switch_description. To be picked up when gearing up for the v4.0 submission round.

…idea

Comment-only. Records the review-chairs ruling (2026-08-14) that
product_switches is for switches that talk exclusively to
storage-solution nodes -- a switch the benchmark clients attach to is
test infrastructure and must not feed the rule-11 total_rack_units sum
or the derived Provisioned Power column.

Also records the v4.0 enhancement idea prompted by the Everpure v3.0
submission (a dedicated-but-client-attached fabric with no structured
place to be documented): either a sibling test_infrastructure_switches
list excluded from both sums, or a scope field on switch_description.
Deliberately not implemented now; revisit when gearing up for v4.0.
@FileSystemGuy
FileSystemGuy requested a review from a team August 14, 2026 15:19
@github-actions

Copy link
Copy Markdown

MLCommons CLA bot All contributors have signed the MLCommons CLA ✍️ ✅

@FileSystemGuy
FileSystemGuy merged commit ce28a98 into main Aug 14, 2026
4 checks passed
@FileSystemGuy
FileSystemGuy deleted the schema-switch-scope-breadcrumbs branch August 14, 2026 15:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant