Attention

You are viewing an older version of the documentation. The latest version is v3.3.

Virtualize ECI Images with KVM

This section explains a method to virtualize ECI images core-bookworm and core-jammy with KVM. This method is helpful in developing solutions when a dedicated target system is unavailable, or it is inconvenient to develop on.

Prerequisites to Virtualize ECI Images

  • Install KVM and Virtual Machine Manager (virt-manager):

    $ sudo apt install qemu-system-x86 libvirt-daemon-system virt-manager

  • Build an ECI image (core-bookworm or core-jammy).

Install ECI Image into KVM

  1. Open Virtual Manager:

    $ sudo virt-manager

  2. Follow the menu path File > New Virtual Machine.

    ../../_images/019.png

  3. In Step 1 of 5, select Local install media (ISO image or CDROM) from the available options. Click Forward.

    ../../_images/024.png

  4. In Step 2 of 5, browse for the core-bookworm or core-jammy *.wic image. The built images are located at: eci-release/build/ecs-<build_target>/build/tmp/deploy/images/intel-corei7-64/*.wic. Enter Generic default as the operating system type. Click Forward.

    ../../_images/033.png

  5. In Step 3 of 5, set the amount of Memory and CPUs to be allocated to the virtual machine (VM). It is recommended to allocate at least 4 GB memory. Click Forward.

    ../../_images/041.png

  6. In Step 4 of 5, create a new disk image for this VM. Size the disk based on the requirements of the application. Graphical applications or use of containers typically require more disk space. Click Forward.

    ../../_images/051.png

  7. In Step 5 of 5, provide a unique name to the VM. It is recommended to choose a name that identifies the image. Select Customize configuration before install. Click Finish.

    ../../_images/061.png

  8. A dialog with the VM configuration details will open. Click Overview from the navigation list, then select Q35 from the Chipset drop-down, and UEFI x86_64: /usr/share/OVMF/OVMF_CODE.fd from the Firmware drop-down.

    ../../_images/07.png

  9. Click IDE Disk 1 from the navigation list, then select SATA from the Disk bus drop-down. Click Apply.

    ../../_images/08.png

  10. Right-click IDE CDROM 1 from the navigation list, then select Remove Hardware from the context menu.

    ../../_images/09.png

  11. Click Add Hardware. Add a new storage device:

    • Choose the Select or create custom storage option.

    • Select the ECI image to install in the VM.

    • Select Disk device from the Device type drop-down.

    • Select SATA from the Bus type drop-down.

    • Click Finish to add the new storage device.

    ../../_images/10.png

  12. Click Boot Options from the navigation list. From the Boot device order list, clear SATA Disk 1 and check SATA Disk 2. Click Apply.

    ../../_images/11.png

  13. Click Begin Installation to boot the VM. When the GRUB menu appears, select install from the list of options.

    ../../_images/12.png

  14. The ECI installer will boot and should find the empty storage device. You will be prompted to enter the name of the storage device. Enter sda when prompted.

    ../../_images/13.png

  15. Wait for the installation to complete. The installer should output “Success: Installation successful…”. At this point, Select Force Off from the Virtual Machine > Shut Down menu.

    ../../_images/14.png

  16. Select Details from the View menu.

    ../../_images/15.png

  17. Right-click SATA Disk 2 item from the navigation list, then select Remove Hardware from the context menu.

    ../../_images/16.png

  18. At this point, you can boot the VM and use the ECI image.