Prep networking-lab dir, doc + util

Signed-off-by: Harald Jensås <hjensas@redhat.com>

Author: hjensas

scenarios/networking-lab/README.md

@@ -0,0 +1,45 @@
+# Networking Lab Scenarios
+
+This directory contains networking-focused lab scenarios designed for testing, development, and learning various network topologies and configurations without requiring a full OpenShift deployment.
+
+## Available Scenarios
+
+### devstack-nxsw-vxlan
+A spine-and-leaf Cisco NX-OS topology with VXLAN overlay capabilities, featuring:
+- 4 Cisco NX-OS switches (2 spine, 2 leaf)
+- Devstack node for OpenStack development
+- Ironic nodes for bare metal provisioning
+- VXLAN/EVPN ready configuration
+
+See [devstack-nxsw-vxlan/README.md](devstack-nxsw-vxlan/README.md) for detailed documentation.
+
+## Managing POAP Scripts
+
+All POAP scripts (`*-poap.py`) in networking lab scenarios include md5sum validation. Use the `manage-poap-md5sums.sh` script to automatically update md5sums after modifying any POAP scripts:
+
+```bash
+./scenarios/networking-lab/manage-poap-md5sums.sh
+```
+
+This script:
+- Finds all `*-poap.py` files in networking-lab scenarios
+- Removes old md5sum lines
+- Calculates and adds new md5sum lines
+- Runs automatically via pre-commit hooks
+
+## Contributing
+
+When adding new networking lab scenarios:
+1. Create a descriptive directory name
+2. Follow the existing file structure
+3. Include comprehensive README documentation
+4. Document network topology with diagrams (SVG preferred)
+5. Provide example configurations and validation steps
+6. Include troubleshooting guidance
+7. If using POAP scripts, name them `*-poap.py` for automatic md5sum management
+
+## Related Documentation
+
+- [Main Scenarios README](../README.md)
+- [Hotstack Documentation](../../README.md)
+- [Switch Configuration Guide](../../docs/virtual_switches.md)

scenarios/networking-lab/manage-poap-md5sums.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+# Script to manage POAP md5sums for all *-poap.py files in networking-lab scenarios
+# This script: removes md5sum -> restores md5sum for each POAP file
+
+set -e
+
+# Find the script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Find all *-poap.py files recursively in networking-lab directory
+mapfile -t POAP_FILES < <(find "$SCRIPT_DIR" -name "*-poap.py" -type f | sort)
+
+if [ ${#POAP_FILES[@]} -eq 0 ]; then
+    echo "No *-poap.py files found in $SCRIPT_DIR"
+    exit 0
+fi
+
+echo "Processing ${#POAP_FILES[@]} POAP file(s)..."
+
+for f in "${POAP_FILES[@]}"; do
+    echo "Processing: $f"
+
+    # Step 1: Remove the md5sum line
+    sed -i '/^# *md5sum=/d' "$f"
+
+    # Step 2: Restore and update the md5sum line
+    # Insert the md5sum line after the shebang (line 2)
+    sed -i '1a\#md5sum="placeholder"' "$f"
+
+    # Generate new md5sum excluding the md5sum line itself
+    sed '/^# *md5sum=/d' "$f" > "$f.md5"
+
+    # Update the md5sum line with the correct hash
+    sed -i "s/^# *md5sum=.*/# md5sum=\"$(md5sum "$f.md5" | sed 's/ .*//')\"/" "$f"
+
+    # Clean up temporary files
+    rm -f "$f.md5"
+
+    echo "  ✓ Updated md5sum for $f"
+done
+
+echo "All POAP files processed successfully!"