guide: add instructions for running linux direct#2875
guide: add instructions for running linux direct#2875mattkur merged 5 commits intomicrosoft:mainfrom
Conversation
There was a problem hiding this comment.
Pull request overview
This PR adds documentation to the OpenVMM guide showing how to run OpenHCL in Linux direct boot mode from a locally built test IGVM, similar to PR #2874 which added instructions for specifying a UEFI firmware file.
Changes:
- Adds a new "OpenHCL, via Linux Direct Boot" section in
Guide/src/user_guide/openvmm/run.mdwith a build command, a PowerShell run command, and an admonish warning about the necessity of serial terminals when usingrdinit=/bin/sh.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
- Simplify command: only --vmbus-com1-serial is required for VTL0 boot, --com3 is optional (for VTL2 debug output), --vmbus-com2-serial removed - Update admonish warning to clarify which flag is required and why - Add tip about cargo xflowey build-igvm as faster alternative Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
|
||
| ```admonish tip | ||
| If you only need the IGVM binary (and already have `openvmm.exe`), you can | ||
| use `cargo xflowey build-igvm` instead — it's faster than building the full |
There was a problem hiding this comment.
At some point we need to rewrite xflowey vmm-tests to only rebuild the things needed for the tests you specify instead of building the world. All the wiring is there, someone just needs to do it...
There was a problem hiding this comment.
I think @chris-oo has something like this in progress. I will say: a rebuild of vmm-tests is pretty quick. It's the initial build (and downloading the vhd deps) that gets ya.
There was a problem hiding this comment.
We've had two people get to 'in progress', but nobody's gotten to 'done' yet lol
|
Addressed both review threads in f6e06b8: @chris-oo (terminal requirement): You were right — tested today and confirmed only @smalis-msft (build-igvm): Added a tip noting |
Like #2874, but for linux direct.
It took me a few minutes to figure out something that should be in the guide. So, add it.