acrn-hypervisor/misc/sample_application/image_builder/README.rst

52 lines
1.5 KiB
ReStructuredText

:orphan:
ACRN Sample Application Image Builder
#####################################
This directory contains the scripts to create VM images for ACRN sample
application.
Prerequisites
*************
Make sure you have Ubuntu installed with network access on your development
computer. Then execute the following command to install the prerequisites.
.. code-block:: bash
sudo apt install -y kpartx \
schroot \
mount \
wget \
qemu-utils
Also you'll need the Debian packages of Linux RT kernels built from
https://github.com/projectacrn/acrn-kernel when (and only when) building a
real-time VM image. After the kernel is built, copy those Debian packages (whose
names looks like ``linux-libc-*``, ``linux-headers-*`` and ``linux-image-*``) to
this directory (i.e. misc/sample_application/image_builder/).
Build images
************
To build the VM image for graphical HMI, run the following command under this
directory:
.. code-block:: bash
./create_image.sh hmi-vm
This will generate an image named ``hmi_vm.img`` under the this directory, which
can be used as the file of a virtio-blk device of a post-launched VM. Installing
the GNOME desktop system will take some time depending on your network and
storage speed.
To build the VM image for running real-time applications, run the following
command under this directory:
.. code-block:: bash
./create_image.sh rt-vm
This will generate an image named ``rt_vm.img`` under the this directory.