Add VirtualBox instructions and task to create a VMDK

This commit is contained in:
Josh Holtrop 2022-10-14 15:57:26 -04:00
parent 777820d471
commit 6f94bc3ddd
2 changed files with 31 additions and 1 deletions

View File

@ -1,4 +1,6 @@
= INSTALLATION
= Running HOS
== Physical Machine
To install HOS to an EFI partition, follow these steps:
@ -15,3 +17,23 @@ To install HOS to an EFI partition, follow these steps:
3. Set boot order to desired boot order. Exact order will be system dependent. Example:
efibootmgr -o 2,0,6,5
== VirtualBox
To create a VM in VirtualBox:
1. Build HOS ("./rscons").
2. Create a VirtualBox VMDK image with "./rscons mk-vmdk".
3. In VirtualBox, select Machine -> New.
4. Set name to HOS.
5. Set Type to Other.
6. Set Version to Other/Unknown (64-bit).
7. Click Next.
8. Set memory size to 512 MB.
9. Click Next.
10. Select Use an existing virtual hard disk file.
11. Browse and add the build/hello/HOS.vmdk file.
12. Click Create.
13. Open HOS VM settings.
14. Under System, check the Enable EFI checkbox and click OK.
15. To run HOS, either start the VM through VirtualBox or with "./rscons run-vb".

View File

@ -147,6 +147,14 @@ task "run", desc: "Run HOS in QEMU" do
end
end
# See README.md for how to set up VirtualBox for HOS.
task "mk-vmdk", desc: "Create VirtualBox VMDK virtual drive for HOS" do
vmdk = hello_env.expand("^/HOS.vmdk")
rm vmdk
sh %W[VBoxManage internalcommands createrawvmdk -filename #{vmdk} -rawdisk #{File.expand_path(hello_env.expand("^/HOS.img"))}]
end
# See README.md for how to set up VirtualBox for HOS.
task "run-vb", desc: "Run HOS in VirtualBox" do
sh %W[VBoxManage startvm HOS]
end