Attention

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

legacy-poky-acrn

The following section is applicable to:

../../_images/linux4.png

The ECI legacy-poky-acrn Yocto target image provides the ACRN Hypervisor, service OS (SOS), and software utilities to manage virtual machines (VMs).

Important

ACRN is only supported on specific target platforms. For a list of platforms that support ACRN, refer to Validated Hardware Platforms. To build ACRN for non-supported platforms, refer to Compile ACRN for Different Platforms.

This section provides the steps to build an ECI legacy-poky-acrn image.

Prerequisites for Building legacy-poky-acrn

Before building the ECI legacy-poky-acrn installation image, make sure that you have:

Build ECI legacy-poky-acrn Image

  1. After you select legacy-poky-acrn from the list of available build targets, a menu will display the available target hardware platforms. Select a target hardware platform.

    ../../_images/039.png

    The ACRN hypervisor will be compiled based on the selected target hardware platform. The following table lists the available target hardware platforms:

    Target Hardware Platform

    Description

    Maxtang WHL i5

    Maxtang PC with Whiskey Lake Core-i5

    Vecow SPC-7100 TGL i7

    iEi Tank PC with Kaby Lake Core-i5

    K700 CFL i7

    Karbon 700 with Coffee Lake (Refresh) Core-i7

    EHL-CRB Atom

    Elkhart Lake Customer Reference Board

    TGL-RVP i7

    Tiger Lake Reference Validation Platform

    Select the target hardware platform. Use the arrow keys to move the selection and spacebar to toggle the state. When complete, press the enter key to finalize the selection.

  2. Next, the features will be displayed allowing you to modify the build configuration of the legacy-poky-acrn target image.

    ../../_images/047.png

    The following table lists the available options:

    Feature Option

    Description

    SDK (build tools)

    Adds GCC and Make to the target image.

    Intel® Castle Lake Dependencies

    Adds kernel modules and tools necessary to support an Intel® Castle Lake Client.

    Intel® Time Coordinated Computing

    Enables Intel® Time Coordinated Computing features.


    Note:

    Intel TCC Tools features are only supported on 11th Gen Intel® Core™ and Intel Atom® x6000E Series processors.

    Trusted VM

    Embed a pre-launched VM to manage TPM access.

    Secure Boot

    Creates a signed bootloader and boot artifacts for use with Secure Boot.

    Kubernetes

    Adds binaries required to join a Kubernetes cluster.

    Kernel source

    Adds kernel source & header files to the target image.

    *Experimental*

    Enables experimental features.

    Select/deselect features to be included in the image. Use the arrow keys to move the selection and spacebar to toggle the state. When complete, press the enter key to finalize the selection.

  3. The setup script will begin downloading and configuring the assets needed to build the target image. Depending on the feature options selected and state of the build environment, a few notifications may occur.

    • Build directory already exists

      If the setup script is not building the target for the first time, the script will prompt: Build directory eci-legacy-poky-acrn already exists. Do you want to clean the cached build? [y/N]

      ../../_images/055.png

      Press n to retain the target build cache, or press y to delete target build cache.

      Note: It is recommended that you delete the target build cache if the target source was modified or the previous build was incomplete. Retaining the target build cache will reduce the build time, but might cause build errors if the target source was modified or the previous build was incomplete. If build errors occur, rerun the setup script and choose y at this prompt.

    • Build Directory Already Exists

    • Detected Lock Files for Target

    • System Memory below Recommended Minimum

  4. After setting up the build target, a prompt will check whether you want to run an automated build: Do you want to run an automated build? [Y/n].

Note: Automated builds give the option to automatically build and embed ECI images as ACRN VMs. If you are a novice user of ACRN, it is recommended that you choose to perform an automated build.

../../_images/A1.png

  1. To perform an automated build, press y at the prompt.

    ../../_images/A1.png

  2. After selecting to perform an automated build, the prompt Embed an ECI image for use as an ACRN VM? will appear. This prompt gives the ability to automatically build an ECI image and have it embedded into the ACRN image so that it can be launched as a VM using the VM launch scripts. To embed an ECI image as an ACRN VM, select Yes at the prompt.

    Note: This automated build will overwrite any existing build.

    ../../_images/065.png

  3. If you opt to embed an ECI image, a menu will appear with the available ECI image options. Select an ECI image to build and embed as an ACRN VM.

    ../../_images/073.png

The build typically takes a very long time. A Linux build system with the recommended specifications might take about 1-2 hours to complete. A Linux build system with the minimum specifications might take over four hours to complete. Refer to Linux build system for the recommended specifications.

../../_images/B.png

What Next after Building legacy-poky-acrn

After the build completes, refer to Install ECI Image with Yocto-based ACRN (Legacy) to create a bootable USB flash drive to install the legacy-poky-acrn image.