github/acrn-hypervisor
1
0
Fork 0
mirror of https://github.com/projectacrn/acrn-hypervisor.git synced 2025-05-04 14:36:55 +00:00
Code Issues Projects Releases Wiki Activity
ac29ec2c6b
acrn-hypervisor/misc/sample_application/image_builder
History
David B. Kinder e9b4f5bff1 Update sample app scripts for Ubuntu 22.04 
The switch to Ubuntu 22.04 for ACRN v3.2 requires a few changes to the
sample application scripts:

- user _apt cannot access debian packages in user directories, so copy
  them to /tmp to install
- HMI-VM image size needs to be bigger (running out of space during
  image update)

Tracked-On: #8352

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
2022-12-01 17:00:11 +08:00
..
configRTcores.sh sample_app: Add scripts to create RT and HMI VM images 2022-08-08 08:26:43 +08:00
create_image.sh Update sample app scripts for Ubuntu 22.04 2022-12-01 17:00:11 +08:00
logger.sh sample_app: Add scripts to create RT and HMI VM images 2022-08-08 08:26:43 +08:00
README.rst sample_app: Add scripts to create RT and HMI VM images 2022-08-08 08:26:43 +08:00
setup_hmi_vm.sh doc: update changes to 22.04 on sample app guide 2022-11-01 09:56:07 +08:00
setup_rt_vm.sh Update sample app scripts for Ubuntu 22.04 2022-12-01 17:00:11 +08:00

README.rst 

: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.