Skip to content

Link published MININET-SDN appliance and repair student setup - #1

Merged
antonioclim merged 2 commits into
mainfrom
review/mininet-zenodo-1.0.0
Nov 16, 2026
Merged

antonioclim merged 2 commits into
mainfrom
review/mininet-zenodo-1.0.0

Conversation

@antonioclim

@antonioclim antonioclim commented Nov 16, 2026 •

Copy link
Copy Markdown
Owner

Why this change is needed

Students need a consistent route from COMPNET-EN to the published MININET-SDN appliance and setup instructions that match the repository. The previous instructions contained obsolete paths, mismatched Compose commands and host/guest assumptions. Portainer setup could report success after authentication or endpoint errors, while the advanced S06 controller and OVS checker had reproducible correctness defects.

What changes

  • Link appliance version 1.0.0 at https://doi.org/10.5281/zenodo.24289763 and record its exact filename, byte count and SHA-256. The published Zenodo export confirms publication on 16 November 2026, with all four release files unchanged from the checked final draft.
  • Record concept DOI https://doi.org/10.5281/zenodo.24289762 separately and provide an appliance citation. The course download remains tied to the version-specific DOI and checksum.
  • Separate the VirtualBox appliance route, the WSL alternative and institutional PC provisioning. Correct the Markdown and HTML setup guides together, including S08/S09 scenario checks and project-scoped cleanup.
  • Preserve existing Portainer accounts, containers and volumes; require valid authentication and a successful Docker API ping. Check native Docker exit codes explicitly in Windows PowerShell 5.1.
  • Add a bounded, read-only VM prerequisite checker and correct the WSL checker, Compose v2 installation guidance and Python environment placement.
  • Correct the advanced S06 controller's OS-Ken base class, SwitchFeatures dispatcher, UDP exception priority and lifetime. Select OpenFlow 1.3 explicitly and clean up the topology after startup or CLI failure.
  • Propagate OVS query/cleanup failures and add eight isolated regression tests. Constrain optional OS-Ken below version 4 because that release removes the CLI used by the course.

Current student-facing instructions describe the published release. The changelog preserves the earlier preparation state and adds the publication follow-up. The original institutional installer and repository licence terms are unchanged.

Validation

  • Current head eaf4fdcdc387c74da997d0324968b5f002df12d4: both pull-request CI and push CI succeeded. The PR job reports 68 pytest tests passed.
  • The initial 40 changed remote blobs were verified against the local candidate. The publication follow-up changes six documentation/metadata files; their Git hashes and modes match the candidate, and every other file in the 1,281-file PR tree is unchanged.
  • Repository Markdown links: 406 files, 2,207 targets, PASS.
  • Teaching-corpus integrity and lecture figure targets: PASS; executable manifest: 97 entries, PASS after the existing normalisation step.
  • Eight isolated controller/OVS regression tests: PASS. The test suite uses isolated OS-Ken message objects and a mocked OVS executable.
  • Twenty-two student-script scenarios produced the expected outcomes: 15 revised Portainer cases, five WSL verifier cases and two original-script counterexamples. Real GNU timeout stopped the simulated hung-daemon probe after approximately 15.7 seconds.
  • Four changed Bash scripts passed syntax checks; three changed Python files passed AST parsing.
  • Setup documentation: 36 Markdown/HTML command blocks remain identical after the publication update. The earlier checks passed for 44 Bash blocks, 11 embedded Mininet shell commands, HTML local links and JavaScript syntax. HTML IDs and anchors were rechecked after the update.
  • The published export retains the checked description, component-specific rights entry, related repository and all four file identities.

Evidence and limits

The author confirms that he built, configured and tested the OVA used in the ASE labs. The publication state, version DOI and concept DOI are supported by his supplied published Zenodo record export. Independent HTTP retrieval of the Zenodo/DOI endpoints was unavailable through the review environment's web tool; no successful live download check is claimed.

No OVA bytes were available for an independent hash computation. Native Windows PowerShell, WSL, VirtualBox, Docker and Mininet acceptance was not performed in this source review. HTML structure and commands were checked, while visual rendering was blocked by the browser runtime.

The dependency bound is a compatibility safeguard, not a complete environment lockfile. The committed regression tests are in 00_TOOLS/qa/test_mininet_setup_contracts.py.

Record the reserved appliance DOI and verified identity metadata, distinguish
VirtualBox and WSL routes, correct Portainer failure handling and repair the
S06 OS-Ken policy and OVS verification contracts.

Publication remains pending. Native appliance and Windows acceptance are
separate from the source checks and isolated regression tests.
Record the publication state reported by the supplied Zenodo export, retain
the version-specific DOI and checksum, and distinguish the concept DOI.
Update current download guidance and add an appliance citation while
preserving the earlier preparation history.
@antonioclim antonioclim changed the title Prepare MININET-SDN Zenodo references and repair student setup Link published MININET-SDN appliance and repair student setup Nov 16, 2026
@antonioclim
antonioclim marked this pull request as ready for review November 16, 2026 20:45
@antonioclim
antonioclim merged commit 8b10df8 into main Nov 16, 2026
2 checks passed
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