acrn-hypervisor/misc/packaging
Junjie Mao 5a01fa1a7a FIXME: packaging: generate a grub entry for shared scenario by default
The debian package created by misc/packaging today is supposed to add an
entry into grub.cfg for the installed hypervisor. Unfortunately, that is
done only when the given scenario XML is named shared, partitioned, hybrid
or hybrid_rt. In the rest of the cases, no entry is added while the default
boot option is still changed to ACRN_deb_multiboot2 which does not exist.

As a short-term workaround, this patch adjusts the branching structure of
the postinst script so that a grub entry is always generated. The entry for
shared scenario is chosen as the default if the scenario XML has a name
other than partitioned, hybrid or hybrid_rt.

This is a workaround only for release 3.0. In future releases we should
migrate to the dpkg-buildpackage using the scripts under debian/.

Tracked-On: #7778
Signed-off-by: Junjie Mao <junjie.mao@intel.com>
2022-06-29 13:53:42 +08:00
..
50-acrn.netdev create acrn hypervisor/kernel deb packaging 2020-07-20 11:44:07 +08:00
50-acrn.network create acrn hypervisor/kernel deb packaging 2020-07-20 11:44:07 +08:00
50-eth.network create acrn hypervisor/kernel deb packaging 2020-07-20 11:44:07 +08:00
50-tap0.netdev create acrn hypervisor/kernel deb packaging 2020-07-20 11:44:07 +08:00
100_ACRN Remove "All rights reserved" string headers 2022-04-06 13:21:02 +08:00
README.rst doc: Update Debian packaging readme 2022-02-10 12:43:59 -08:00
acrn-board-inspector.postinst board_inspector.py fails to run on target with clean Ubuntu installation 2022-05-18 15:41:42 +08:00
acrn-board-inspector.prerm deb-pkg: add acrn-hypervisor and acrn-board-inspector into debian package 2021-11-02 15:31:18 +08:00
acrn-hypervisor.postinst FIXME: packaging: generate a grub entry for shared scenario by default 2022-06-29 13:53:42 +08:00
acrn-kernel.postinst Remove "All rights reserved" string headers 2022-04-06 13:21:02 +08:00
compile_iasl.py create acrn hypervisor/kernel deb packaging 2020-07-20 11:44:07 +08:00
deb.json deb-pkg: add OVMF_debug.fd in acrn deb 2022-04-13 14:34:25 +08:00
gen_acrn_deb.py config_tools: clear schema files 2022-06-29 13:53:42 +08:00
release.json misc:update packaging tool,add pre-check scripts/ add patch function /optimize 2020-08-24 09:12:45 +08:00

README.rst

.. _debian_packaging:

ACRN Installation via Debian Packages
#####################################

Debian packages provide a simple way to package ACRN configurations on
a development computer. You can then copy the packages onto your target system,
install the packages, and reboot the system with ACRN and an Ubuntu Service VM
up and running.

ACRN does not distribute pre-built Debian packages for the hypervisor or kernel
because ACRN and the kernel are configured based on your specific hardware and
scenario configurations, as described in the :ref:`overview_dev`. Instead after
configuring ACRN to your needs, Debian packages are created when you build your
ACRN hypervisor and ACRN kernel via ``Makefile`` commands.

All the configuration files and scripts used by the Makefile to build the Debian
packages are in the ``misc/packaging`` folder. The ``gen_acrn_deb.py`` script
does all the work to build the Debian packages so you can copy and install them
on your target system.

For build and installation steps, see :ref:`gsg_build` in the Getting Started
Guide.