diff options
| author |   Paul Barker <pbarker@konsulko.com> | 2020-02-19 09:19:13 +0000 |
|---|---|---|
| committer | Paul Barker <pbarker@konsulko.com> | 2020-02-19 09:19:13 +0000 |
| commit | 8383e86f97fb6b36f2931a25fe332d75f32d843b (patch) | |
| tree | d9df590264caad1e475fdd717d37209f63705cfe | |
| parent | 1201f8e05f99de35141a3b951576ef5a5cd32be4 (diff) | |
getting-started: qemu: Update instructions for UEFI images
The qemux86-64 images now use UEFI to boot.
Bug-AGL: SPEC-2931
Signed-off-by: Paul Barker <pbarker@konsulko.com>
| -rw-r--r-- | docs/getting-started/machines/qemu.md | 25 |
1 files changed, 19 insertions, 6 deletions
diff --git a/docs/getting-started/machines/qemu.md b/docs/getting-started/machines/qemu.md index af781d3..e7b7c77 100644 --- a/docs/getting-started/machines/qemu.md +++ b/docs/getting-started/machines/qemu.md @@ -94,26 +94,30 @@ If your build host is running [Arch Linux](https://www.archlinux.org/), use the following commands: ```bash -sudo pacman -S qemu +sudo pacman -S qemu ovmf +export OVMF_PATH=/usr/share/ovmf/x64/OVMF_CODE.fd ``` If your build host is running Debian or Ubuntu, use the following commands: ```bash -sudo apt-get install qemu-system-x86 +sudo apt-get install qemu-system-x86 ovmf +export OVMF_PATH=/usr/share/ovmf/OVMF.fd ``` If you build host is running Fedora, use the following commands: ```bash -sudo yum install qemu-kvm +sudo yum install qemu qemu-kvm edk2-ovmf +export OVMF_PATH=/usr/share/edk2/ovmf/OVMF_CODE.fd ``` Once QEMU is installed, boot the image with KVM support: ```bash qemu-system-x86_64 -enable-kvm -m 2048 \ - -hda agl-demo-platform-qemux86-64.vmdk \ + -bios ${OVMF_PATH} \ + -hda agl-demo-platform-qemux86-64.wic.vmdk \ -cpu kvm64 -cpu qemu64,+ssse3,+sse4.1,+sse4.2,+popcnt \ -vga virtio -show-cursor \ -device virtio-rng-pci \ @@ -123,6 +127,14 @@ qemu-system-x86_64 -enable-kvm -m 2048 \ -net user,hostfwd=tcp::2222-:22 ``` +**NOTE:** KVM may not be supported within a virtualized environment such as +VirtualBox. This is indicated by the qemu command above giving the error +message `Could not access KVM kernel module: No such file or directory` or +the kernel log output contains the error message `kvm: no hardware support`. +The image can be booted in such an environment by removing `-enable-kvm` from +the qemu command line, however this will result in lower perfromance within +the AGL demo. + #### VirtualBox Start by downloading and installing [VirtualBox](https://www.virtualbox.org/wiki/Downloads) 5.2.0 or later. @@ -137,5 +149,6 @@ Once VirtualBox is installed, follow these steps to boot the image: 6. Set *Memory size* to **2 GB** 7. Click **Use an existing virtual hard disk file** under *Hard disk* 8. Navigate to and select the **agl-demo-platform-qemux86-64.vmdk** image -9. Ensure that the newly created **AGL QEMU** machine is highlighted. -10. Click **Start** +9. Select the newly created **AGL QEMU** machine and click **Settings** +10. Go to the **System** tab and ensure **Enable EFI (special OSes only)** is enabled then click **OK** +11. With the **AGL QEMU** machine still selected, click **Start** to boot the virtual machine |