ics-simlab-config-gen-claude/docs/QUICKSTART.txt

43 lines
1.5 KiB
Plaintext

================================================================================
QUICKSTART: Test the PLC Startup Race Condition Fix
================================================================================
1. BUILD SCENARIO
cd ~/projects/ics-simlab-config-gen_claude
.venv/bin/python3 build_scenario.py --out outputs/scenario_run --overwrite
2. VALIDATE FIX
.venv/bin/python3 validate_fix.py
# Should show: ✅ SUCCESS: All PLC files have the callback retry fix
3. START ICS-SIMLAB
cd ~/projects/ICS-SimLab-main/curtin-ics-simlab
sudo ./start.sh ~/projects/ics-simlab-config-gen_claude/outputs/scenario_run
4. MONITOR PLC2 (in another terminal)
# Find container name
sudo docker ps | grep plc2
# View logs - look for NO "Exception in thread" errors
sudo docker logs <plc2_container_name> -f
5. STOP ICS-SIMLAB
cd ~/projects/ICS-SimLab-main/curtin-ics-simlab
sudo ./stop.sh
================================================================================
FILES CHANGED:
- tools/compile_ir.py (CRITICAL FIX: added _safe_callback retry wrapper)
NEW FILES:
- build_scenario.py (deterministic scenario builder)
- validate_fix.py (validation script)
- test_simlab.sh (interactive launcher)
- diagnose_runtime.sh (diagnostics)
- RUNTIME_FIX.md (complete documentation)
- CHANGES.md (summary with diffs)
- DELIVERABLES.md (this summary)
For full details, see DELIVERABLES.md
================================================================================