Skip to content

Commit 9c5beca

Browse files
anujm1nckrss
authored andcommitted
Add QEMU instructions and fix typographical corrections (#127) (#150)
Signed-off-by: Nick Ross <nick.ross@intel.com> Co-authored-by: Nick Ross <nick.ross@intel.com>
1 parent bb668c3 commit 9c5beca

File tree

3 files changed

+32
-2
lines changed

3 files changed

+32
-2
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Check out these articles to quickly learn how to work with Edge Microvisor Toolk
3434

3535
**Edge Microvisor Toolkit Developer Node**
3636

37-
* [Downloading and installing the developer tookit ISO image](./docs/developer-guide/get-started.md#edge-microvisor-toolkit-developer).
37+
* [Downloading and installing the developer toolkit ISO image](./docs/developer-guide/get-started.md#edge-microvisor-toolkit-developer)
3838
* [Building a custom Edge Microvisor Toolkit image](./docs/developer-guide/get-started/building-howto.md)
3939

4040
**Edge Microvisor Toolkit Standalone Node**

docs/developer-guide/get-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ To create a custom developer build of Edge Microvisor Toolkit, follow these step
4747
| Development | gcc, make, python3, perl, cmake, git |
4848
| Security | openssl, gnupg, selinux, cryptsetup, tpm2-tools |
4949
| Filesystem | e2fsprogs, mount |
50-
| Included in kernel | iGPU, dGPU (Intel® Arc&trade;), SRIOV, WiFi, Ethernet, Bluetooth, GPIO, UART, I2C, CAN, USB, PCIe, PWM, SATA, NVMe, MMC/SD, TPM, Manageability Engine, Power Management, Watchdog, RAS |
50+
| Included in kernel | iGPU, dGPU (Intel® Arc&trade;), SR-IOV, WiFi, Ethernet, Bluetooth, GPIO, UART, I2C, CAN, USB, PCIe, PWM, SATA, NVMe, MMC/SD, TPM, Manageability Engine, Power Management, Watchdog, RAS |
5151

5252
The supported package repository offers additional `rpm` for tailoring the image
5353
to specific needs of container runtime, virtualization, orchestration software,

docs/developer-guide/get-started/installation-howto.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,36 @@ sudo usermod -a -G libvirt $(whoami)
102102
| VHD (.vhd, .vpc) | ⚠️ Limited. Direct use is unreliable, conversion is recommended. |
103103
| VDI (.vdi) | ❌ No |
104104

105+
## Virtual Machine with QEMU and UEFI
106+
107+
Instead of using `virt-manager` you can also use `qemu` commands directly:
108+
109+
1. Create a virtual disk image, specifying a disk size appropriate for your usage and available storage:
110+
111+
```bash
112+
qemu-img create -f qcow2 emt_rootfs.img 10G
113+
```
114+
115+
2. Start the virtual machine
116+
117+
Launch and install the Edge Microvisor Toolkit in a Virtual Machine with UEFI virtual machine firmware ([OVMF](https://github.com/tianocore/tianocore.github.io/wiki/OVMF)):
118+
119+
```bash
120+
qemu-system-x86_64 \
121+
-nodefaults -M accel=kvm -cpu host \
122+
-device virtio-rng-pci \
123+
-machine q35 -smp 2 -m 2048M \
124+
-vga std \
125+
-nic user \
126+
-drive if=pflash,format=raw,readonly=on,file=/usr/share/ovmf/OVMF.fd \
127+
-drive id=disk,file=/path/to/emt_rootfs.img,if=none,format=qcow2 \
128+
-device virtio-blk-pci,drive=disk,bootindex=1 \
129+
-drive id=cdrom,file=/path/to/EdgeMicrovisorToolkit-3.0.iso,if=none,media=cdrom \
130+
-device ide-cd,drive=cdrom,bootindex=2
131+
```
132+
133+
Use the appropriate acceleration based on your platform, such as `accel=kvm` for Linux or `accel=hvf` for macOS on Intel based Mac systems. The path to the virtual machine firmware may vary depending on your operating system and qemu package.
134+
105135
## Bare metal with ISO
106136

107137
### Requirements

0 commit comments

Comments
 (0)