readme.txt
1Mender UEFI PC sample config
2=====================
3
41. Build
5
6 $ make mender_x86_64_efi_defconfig
7
8 Add any additional packages required. Update the files in board/mender/x86_64
9 and change /dev/vda to what is relevant for your platform: typically
10 /dev/mmcblk0p for eMMC and /dev/sda for USB or SATA.
11
12 $ make
13
142. Write the Pendrive
15
16 The build process will create a Pendrive image called disk.img in
17 output/images.
18
19 Write the image to a pendrive:
20
21 $ dd if=output/images/disk.img of=/dev/${pendrive}; sync
22
23 Once the process is complete, insert it into the target PC and boot.
24
25 Remember that if said PC has another boot device you might need to
26 select this alternative for it to boot.
27
28 You might need to disable Secure Boot from the setup as well.
29
303. Enjoy
31
32Emulation in qemu
33========================
34
35Run the emulation with:
36
37qemu-system-x86_64 \
38 -M pc \
39 -drive file=output/images/disk.img,if=virtio,format=raw \
40 -net nic,model=virtio \
41 -net user \
42 -serial stdio \
43 -bios </path/to/OVMF_CODE.fd>
44
45Note that </path/to/OVMF.fd> needs to point to a valid x86_64 UEFI
46firmware image for qemu. It may be provided by your distribution as an
47edk2 or OVMF package, in a path such as /usr/share/edk2/ovmf/OVMF_CODE.fd.
48
49Optional arguments:
50 - -enable-kvm to speed up qemu. This requires a loaded kvm module on the host
51 system.
52 - Add -smp N to emulate an SMP system with N CPUs.
53
54The login prompt will appear in the serial window.
55
56Tested with QEMU 4.1.1 on Fedora 31
57
58Creating a mender-artifact
59========================
60
61The mender artifact is created in output/images/buildroot-x86_64-1.0.mender
62
63You may wish to change --artifact-name=1.0 to a name that best suits your
64particular needs, as this option changes the mender artifact name.
65
66Using mender
67========================
68Please read the mender documentation at:
69https://docs.mender.io/2.2/getting-started
70