readme.txt 1.9 KB

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