mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2025-05-17 21:00:37 +00:00
0bd384d41b
While we hoped to make the headings consistent over time while doing other edits, we should instead just make the squirrels happy and do them all at once or they'll likely never be made consistent. A python script was used to find the headings, and then a call to https://pypi.org/project/titlecase to transform the title. A visual inspection was used to tweak a few unexpected resulting titles. Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
156 lines
4.8 KiB
ReStructuredText
156 lines
4.8 KiB
ReStructuredText
.. _running_deb_as_serv_vm:
|
|
|
|
Run Debian as the Service VM
|
|
############################
|
|
|
|
The `Debian Project <https://www.debian.org/>`_ is an association of
|
|
individuals who have made common cause to create a `free
|
|
<https://www.debian.org/intro/free>`_ operating system. The `latest
|
|
stable Debian release <https://www.debian.org/releases/stable/>`_ is
|
|
10.0.
|
|
|
|
This tutorial describes how to use Debian 10.0 as the Service VM OS with
|
|
the ACRN hypervisor.
|
|
|
|
Prerequisites
|
|
*************
|
|
|
|
Use the following instructions to install Debian.
|
|
|
|
- Navigate to `Debian 10 iso
|
|
<https://cdimage.debian.org/debian-cd/current/amd64/iso-cd/>`_.
|
|
Select and download **debian-10.1.0-amd64-netinst.iso** (scroll down to
|
|
the bottom of the page).
|
|
|
|
.. note:: These instructions were validated with the
|
|
debian_10.1.0 ISO image. A newer Debian 10 version
|
|
should still work as expected.
|
|
|
|
- Follow the `Debian installation guide
|
|
<https://www.debian.org/releases/stable/amd64/index.en.html>`_ to
|
|
install it on your board; we are using a Kaby Lake Intel NUC (NUC7i7DNHE)
|
|
in this tutorial.
|
|
- :ref:`install-build-tools-dependencies` for ACRN.
|
|
- Update to the newer iASL:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ sudo apt update
|
|
$ sudo apt install m4 bison flex zlib1g-dev
|
|
$ cd ~
|
|
$ wget https://acpica.org/sites/acpica/files/acpica-unix-20190816.tar.gz
|
|
$ tar zxvf acpica-unix-20190816.tar.gz
|
|
$ cd acpica-unix-20190816
|
|
$ make clean && make iasl
|
|
$ sudo cp ./generate/unix/bin/iasl /usr/sbin/
|
|
|
|
Validated Versions
|
|
******************
|
|
|
|
- **Debian version:** 10.1 (buster)
|
|
- **ACRN hypervisor tag:** acrn-2020w40.1-180000p
|
|
- **Debian Service VM Kernel version:** release_2.2
|
|
|
|
Install ACRN on the Debian VM
|
|
*****************************
|
|
|
|
#. Clone the `Project ACRN <https://github.com/projectacrn/acrn-hypervisor>`_ code repository:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ cd ~
|
|
$ git clone https://github.com/projectacrn/acrn-hypervisor
|
|
$ cd acrn-hypervisor
|
|
$ git checkout acrn-2020w40.1-180000p
|
|
|
|
#. Build and install ACRN:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ make all BOARD_FILE=misc/vm_configs/xmls/board-xmls/nuc7i7dnb.xml SCENARIO_FILE=misc/vm_configs/xmls/config-xmls/nuc7i7dnb/industry.xml RELEASE=0
|
|
$ sudo make install
|
|
$ sudo mkdir /boot/acrn/
|
|
$ sudo cp ~/acrn-hypervisor/build/hypervisor/acrn.bin /boot/acrn/
|
|
|
|
#. Build and Install the Service VM kernel:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ mkdir ~/sos-kernel && cd ~/sos-kernel
|
|
$ git clone https://github.com/projectacrn/acrn-kernel
|
|
$ cd acrn-kernel
|
|
$ git checkout release_2.2
|
|
$ cp kernel_config_uefi_sos .config
|
|
$ make olddefconfig
|
|
$ make all
|
|
$ sudo make modules_install
|
|
$ sudo cp arch/x86/boot/bzImage /boot/bzImage
|
|
|
|
#. Update Grub for the Debian Service VM
|
|
|
|
Update the ``/etc/grub.d/40_custom`` file as shown below.
|
|
|
|
.. note::
|
|
Enter the command line for the kernel in ``/etc/grub.d/40_custom`` as
|
|
a single line and not as multiple lines. Otherwise, the kernel will
|
|
fail to boot.
|
|
|
|
.. code-block:: none
|
|
|
|
menuentry "ACRN Multiboot Debian Service VM" --id debian-service-vm {
|
|
recordfail
|
|
load_video
|
|
insmod gzio
|
|
insmod part_gpt
|
|
insmod ext2
|
|
|
|
search --no-floppy --fs-uuid --set 9bd58889-add7-410c-bdb7-1fbc2af9b0e1
|
|
echo 'loading ACRN...'
|
|
multiboot2 /boot/acrn/acrn.bin root=PARTUUID="e515916d-aac4-4439-aaa0-33231a9f4d83"
|
|
module2 /boot/bzImage Linux_bzImage
|
|
}
|
|
|
|
.. note::
|
|
Update this to use the UUID (``--set``) and PARTUUID (``root=`` parameter)
|
|
(or use the device node directly) of the root partition (e.g.
|
|
``/dev/nvme0n1p2``). Hint: use ``sudo blkid <device node>``.
|
|
|
|
Update the kernel name if you used a different name as the source
|
|
for your Service VM kernel.
|
|
|
|
#. Modify the ``/etc/default/grub`` file to make the Grub menu visible when
|
|
booting and make it load the Service VM kernel by default. Modify the
|
|
lines shown below:
|
|
|
|
.. code-block:: none
|
|
|
|
GRUB_DEFAULT=debian-service-vm
|
|
#GRUB_TIMEOUT_STYLE=hidden
|
|
GRUB_TIMEOUT=5
|
|
GRUB_CMDLINE_LINUX="text"
|
|
|
|
#. Update Grub on your system:
|
|
|
|
.. code-block:: none
|
|
|
|
$ sudo update-grub
|
|
$ sudo reboot
|
|
|
|
#. Log in to the Debian Service VM and check the ACRN status:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ dmesg | grep ACRN
|
|
[ 0.000000] Hypervisor detected: ACRN
|
|
[ 0.981476] ACRNTrace: Initialized acrn trace module with 4 cpu
|
|
[ 0.982837] ACRN HVLog: Failed to init last hvlog devs, errno -19
|
|
[ 0.983023] ACRN HVLog: Initialized hvlog module with 4 cp
|
|
|
|
Enable the Network Sharing to Give Network Access to User VM
|
|
************************************************************
|
|
.. code-block:: bash
|
|
|
|
$ sudo systemctl enable systemd-networkd
|
|
$ sudo systemctl start systemd-networkd
|
|
|