README.rst
1:orphan:
2
3ACRN Sample Application Image Builder
4#####################################
5
6This directory contains the scripts to create VM images for ACRN sample
7application.
8
9Prerequisites
10*************
11
12Make sure you have Ubuntu installed with network access on your development
13computer. Then execute the following command to install the prerequisites.
14
15 .. code-block:: bash
16
17 sudo apt install -y kpartx \
18 schroot \
19 mount \
20 wget \
21 qemu-utils
22
23Also you'll need the Debian packages of Linux RT kernels built from
24https://github.com/projectacrn/acrn-kernel when (and only when) building a
25real-time VM image. After the kernel is built, copy those Debian packages (whose
26names looks like ``linux-libc-*``, ``linux-headers-*`` and ``linux-image-*``) to
27this directory (i.e. misc/sample_application/image_builder/).
28
29Build images
30************
31
32To build the VM image for graphical HMI, run the following command under this
33directory:
34
35 .. code-block:: bash
36
37 ./create_image.sh hmi-vm
38
39This will generate an image named ``hmi_vm.img`` under the this directory, which
40can be used as the file of a virtio-blk device of a post-launched VM. Installing
41the GNOME desktop system will take some time depending on your network and
42storage speed.
43
44To build the VM image for running real-time applications, run the following
45command under this directory:
46
47 .. code-block:: bash
48
49 ./create_image.sh rt-vm
50
51This will generate an image named ``rt_vm.img`` under the this directory.
52