From Fedora Project Wiki
 
(6 intermediate revisions by 2 users not shown)
Line 3: Line 3:
== Setting up the host ==
== Setting up the host ==


Richard WM Jones has witten an excellent post on booting a [https://rwmj.wordpress.com/2015/02/27/how-to-boot-a-fedora-21-aarch64-uefi-guest-on-x86_64/ Fedora 21 aarch64 UEFI guest on x86_64].  This can be reproduced on an F21 x86_64 host using existing packages, but as Richard mentioned, newer versions of some packages are required.  These can be pulled from the Fedora rawhide and [https://www.kraxel.org/repos/firmware.repo Gerd Hoffmann's firmware repos], as described below.
Richard WM Jones has written an excellent post on booting a [https://rwmj.wordpress.com/2015/02/27/how-to-boot-a-fedora-21-aarch64-uefi-guest-on-x86_64/ Fedora 21 aarch64 UEFI guest on x86_64].  This can be reproduced on an F21 x86_64 host using existing packages, but as Richard mentioned, newer versions of some packages are required.  Using an updated F22 host now provides all the necessary package versions.


First get virt-builder, in order to make an F21 image for QEMU (if not already installed):
First get virt-builder, in order to make an F22 AArch64 image for QEMU (if not already installed):


<pre>
<pre>
sudo yum -y install libguestfs-tools-c
$ sudo dnf -y install libguestfs-tools-c libvirt
</pre>
</pre>


You will need to get the rawhide version of QEMU.  Set up the rawhide repo (if not already done) and install QEMU:
The latest version of AAVMF should be installed to run an aarch64 image.  AAVMF is not in an official Fedora package yet, but  Gerd has provided an RPM package for installation convenience.  Download his repo definition and install his latest build of edk2:
 
<pre>
sudo yum install fedora-repos-rawhide
sudo yum --enablerepo=rawhide update qemu-system-aarch64
</pre>
 
You will also need to install AAVMF for running an aarch64 image.  AAVMF is not in an official Fedora package yet, but  Gerd has provided an RPM package for installation convenience.  Download his repo definition and install his latest build of edk2:


<pre>
<pre>
(cd /etc/yum.repos.d; sudo curl -O https://www.kraxel.org/repos/firmware.repo )
(cd /etc/yum.repos.d; sudo curl -O https://www.kraxel.org/repos/firmware.repo )
sudo yum -y install edk2.git-aarch64
sudo dnf -y install edk2.git-aarch64
</pre>
</pre>


== Making the Image ==
== Making the Image ==
Line 31: Line 23:


<pre>
<pre>
curl -O http://libguestfs.org/download/builder/fedora-21-aarch64-nvram.xz
curl -O http://libguestfs.org/download/builder/fedora-22-aarch64-nvram.xz
unxz fedora-21-aarch64-nvram.xz
</pre>
 
 
{{admon/note | Note | By default, a randomly generated root password will be assigned.  Make note of the root password in the virt-builder output, so you can log in later.  Optionally, a root password may be set when building an image.  In this example a password will be set.  It should be the only entry in a single line text file.}}
 
<pre>
vi fedora
<Enter one line with the desired root password>
</pre>
 
 
Use virt-builder to make an F21 image file:
 
<pre>
virt-builder --arch aarch64 --root-password file:./fedora fedora-21
</pre>
 
 
A script may be set up to start the VM:
 
<pre>
cat > run-qemu.sh << EOF
#!/bin/bash
 
VERSION=21
 
qemu-system-aarch64 \\
    -nodefconfig \\
    -nodefaults \\
    -display none \\
    -M virt -cpu cortex-a57 -machine accel=tcg \\
    -m 2048 \\
    -drive if=pflash,format=raw,file=/usr/share/edk2.git/aarch64/QEMU_EFI-pflash.raw,readonly \\
    -drive if=pflash,format=raw,file=fedora-\${VERSION}-aarch64-nvram \\
    -drive file=fedora-\${VERSION}.img,format=raw,if=none,id=hd0 \\
    -device virtio-blk-device,drive=hd0 \\
    -netdev user,id=usernet -device virtio-net-device,netdev=usernet \\
    -serial stdio
EOF
 
chmod +x run-qemu.sh
</pre>
 
== Booting the image ==
 
Run the script (or the command it contains) to boot the VM.
 
<pre>
./run-qemu.sh
</pre>
 
This should boot grub2 and automatically boot the Fedora 21 kernel.
 
 
= Making an F22 Test Image =
 
Richard WM Jones provides image templates for Fedora releases, but not for candidates.  For testing purposes, there is an F22 Beta TC1 template available. 
 
== Setting up the host ==
 
The same tools versions must be set up for building an F22 test image as used for F21 above.  In addition, a local libguestfs.conf must be set up in order to access the test template.
 
<pre>
vi ~/.config/virt-builder/repos.d/libguestfs.conf
----------------------
[libguestfs.org]
uri=https://dmarlin.fedorapeople.org/fedora-arm/aarch64/builder/index
----------------------
</pre>
 
{{admon/note | This config file will override the defaults.  You may need to remove it to use the default config.}}
 
 
== Making the image ==
 
Make a test directory for the image and switch to it.
 
<pre>
mkdir test
cd test
</pre>
 
 
Get the pre-configured UEFI NVRAM file:
 
<pre>
curl -O https://dmarlin.fedorapeople.org/fedora-arm/aarch64/builder/fedora-22-aarch64-nvram.xz
unxz fedora-22-aarch64-nvram.xz
unxz fedora-22-aarch64-nvram.xz
</pre>
</pre>




Create a root password file.
{{admon/note | Note | By default, a randomly generated root password will be assigned. Make note of the root password in the virt-builder output, so you can log in later.  Optionally, a root password may be set when building an image.  In this example a password will be set.}}


<pre>
{{admon/note | Note | In order to run virt-builder in F22, selinux must be set to Permissive or Disabled.}}
vi fedora
[Enter one line with the desired root password]
</pre>


 
Use virt-builder to make an F22 image file:
Use virt-builder to make an F22 test image file:


<pre>
<pre>
virt-builder \
virt-builder \
   --arch aarch64 \
   --arch aarch64 \
  --no-check-signature \
   --root-password password:fedora \
   --root-password file:./fedora \
     fedora-22
     fedora-22
</pre>
</pre>




== Booting the Image ==
A script may be set up to start the VM:
 
A convenience script may also be created to run the image, for example:


<pre>
<pre>
Line 157: Line 54:
     -nodefaults \\
     -nodefaults \\
     -display none \\
     -display none \\
    -M virt -cpu cortex-a57 -machine accel=tcg \\
     -m 2048 \\
     -m 2048 \\
     -drive if=pflash,format=raw,file=/usr/share/edk2.git/aarch64/QEMU_EFI-pflash.raw,readonly \\
    -cpu host -machine virt,accel=kvm \\
     -drive if=pflash,format=raw,file=/usr/share/edk2.git/aarch64/QEMU_EFI-pflash.raw,readonly=on \\
     -drive if=pflash,format=raw,file=fedora-\${VERSION}-aarch64-nvram \\
     -drive if=pflash,format=raw,file=fedora-\${VERSION}-aarch64-nvram \\
     -drive file=fedora-\${VERSION}.img,format=raw,if=none,id=hd0 \\
    -device virtio-scsi-device,id=scsi \\
    -device virtio-blk-device,drive=hd0 \\
     -drive file=fedora-\${VERSION}.img,format=raw,if=none,id=hd0 -device scsi-hd,drive=hd0 \\
     -netdev user,id=usernet -device virtio-net-device,netdev=usernet \\
     -netdev user,id=usernet -device virtio-net-device,netdev=usernet \\
     -serial stdio
     -serial stdio
Line 170: Line 67:
</pre>
</pre>


== Booting the image ==


Run the script to boot the image.
Run the script (or the command it contains) to boot the VM.


<pre>
<pre>
Line 177: Line 75:
</pre>
</pre>


This should boot grub2 and automatically boot the Fedora 22 AArch64 Beta TC1 kernel.
This should boot grub2 and automatically boot the Fedora 22 kernel.

Latest revision as of 19:39, 23 June 2015

Booting AArch64 using UEFI in a QEMU/KVM VM

Setting up the host

Richard WM Jones has written an excellent post on booting a Fedora 21 aarch64 UEFI guest on x86_64. This can be reproduced on an F21 x86_64 host using existing packages, but as Richard mentioned, newer versions of some packages are required. Using an updated F22 host now provides all the necessary package versions.

First get virt-builder, in order to make an F22 AArch64 image for QEMU (if not already installed):

$ sudo dnf -y install libguestfs-tools-c libvirt

The latest version of AAVMF should be installed to run an aarch64 image. AAVMF is not in an official Fedora package yet, but Gerd has provided an RPM package for installation convenience. Download his repo definition and install his latest build of edk2:

(cd /etc/yum.repos.d; sudo curl -O https://www.kraxel.org/repos/firmware.repo )
sudo dnf -y install edk2.git-aarch64

Making the Image

Note.png
Note
There is a bug regarding fallback.efi [BZ#1190191], so use a pre-built NVRAM file to work around it.
curl -O http://libguestfs.org/download/builder/fedora-22-aarch64-nvram.xz
unxz fedora-22-aarch64-nvram.xz


Note.png
Note
By default, a randomly generated root password will be assigned. Make note of the root password in the virt-builder output, so you can log in later. Optionally, a root password may be set when building an image. In this example a password will be set.
Note.png
Note
In order to run virt-builder in F22, selinux must be set to Permissive or Disabled.

Use virt-builder to make an F22 image file:

virt-builder \
  --arch aarch64 \
  --root-password password:fedora \
    fedora-22


A script may be set up to start the VM:

cat > run-qemu.sh << EOF
#!/bin/bash

VERSION=22

qemu-system-aarch64 \\
    -nodefconfig \\
    -nodefaults \\
    -display none \\
    -m 2048 \\
    -cpu host -machine virt,accel=kvm \\
    -drive if=pflash,format=raw,file=/usr/share/edk2.git/aarch64/QEMU_EFI-pflash.raw,readonly=on \\
    -drive if=pflash,format=raw,file=fedora-\${VERSION}-aarch64-nvram \\
    -device virtio-scsi-device,id=scsi \\
    -drive file=fedora-\${VERSION}.img,format=raw,if=none,id=hd0 -device scsi-hd,drive=hd0 \\
    -netdev user,id=usernet -device virtio-net-device,netdev=usernet \\
    -serial stdio
EOF

chmod +x run-qemu.sh

Booting the image

Run the script (or the command it contains) to boot the VM.

./run-qemu.sh

This should boot grub2 and automatically boot the Fedora 22 kernel.