github/acrn-hypervisor
1
0
Fork 0
mirror of https://github.com/projectacrn/acrn-hypervisor.git synced 2025-08-03 17:31:42 +00:00
Code Issues Projects Releases Wiki Activity

doc: update partition mode tutorial to use whl board.

Browse Source 
Signed-off-by: lirui34 <ruix.li@intel.com>
This commit is contained in:
lirui34 2020-04-16 14:50:32 +08:00 committed by deb-intel
parent dfb947fe91
commit 3b21146dfb
1 changed files with 26 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
doc/tutorials/using_partition_mode_on_nuc.rst
View File

@ -1,7 +1,7 @@
.. _using_partition_mode_on_nuc: .. _using_partition_mode_on_nuc:
Using partition mode on NUC Getting Started Guide for ACRN Logical Partition mode
########################### #####################################################
ACRN hypervisor supports logical partition scenario, in which the User OS (such ACRN hypervisor supports logical partition scenario, in which the User OS (such
as Clear Linux) running in a pre-launched VM can bypass the ACRN hypervisor and as Clear Linux) running in a pre-launched VM can bypass the ACRN hypervisor and
@ -18,11 +18,18 @@ scenario on Intel NUC is shown in
The logical partition scenario on Intel NUC The logical partition scenario on Intel NUC
Validated Versions
******************
- Ubuntu version: **18.04**
- Clear Linux version: **32680**
- ACRN hypervisor tag: **v1.6**
- ACRN kernel commit: **8c9a8695966d8c5c8c7ccb296b9c48671b14aa70**
Prerequisites Prerequisites
************* *************
* `Intel NUC Kit NUC7i7DNHE <https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/nuc7i7dnhe.html>`_ * `Intel Whiskey Lake <http://www.maxtangpc.com/industrialmotherboards/142.html#parameters>`_
* Connecting to the serial port, described in :ref:`kbl-nuc-sdc`
* NVMe disk * NVMe disk
* SATA disk * SATA disk
* Storage device with USB interface (such as USB Flash * Storage device with USB interface (such as USB Flash
@ -34,7 +41,7 @@ Prerequisites
filesystem. Set up each VM by following the `Install Clear Linux filesystem. Set up each VM by following the `Install Clear Linux
OS on bare metal with live server OS on bare metal with live server
<https://docs.01.org/clearlinux/latest/get-started/bare-metal-install-server.html>`_ <https://docs.01.org/clearlinux/latest/get-started/bare-metal-install-server.html>`_
and install Clear Linux OS (version: 29970) first on a SATA disk and then again and install Clear Linux OS (version: 32680) first on a SATA disk and then again
on a storage device with a USB interface. The two pre-launched on a storage device with a USB interface. The two pre-launched
VMs will mount the root file systems via the SATA controller and VMs will mount the root file systems via the SATA controller and
the USB controller respectively. the USB controller respectively.
@ -132,7 +139,7 @@ Update ACRN hypervisor Image
.. note:: .. note::
Double check PCI devices BDF defined in the Double check PCI devices BDF defined in the
``hypervisor/arch/x86/configs/nuc7i7dnb/pci_devices.h`` ``hypervisor/arch/x86/configs/whl-ipc-i5/pci_devices.h``
with the information reported by the ``lspci -vv`` command. with the information reported by the ``lspci -vv`` command.
#. Clone the ACRN source code and configure the build options #. Clone the ACRN source code and configure the build options
@ -140,30 +147,23 @@ Update ACRN hypervisor Image
Please refer :ref:`getting-started-building` to setup ACRN build environment Please refer :ref:`getting-started-building` to setup ACRN build environment
on your development workstation. on your development workstation.
Clone the ACRN source code and checkout to the tag v1.1: Clone the ACRN source code and checkout to the tag v1.6:
.. code-block:: none .. code-block:: none
$ git clone https://github.com/projectacrn/acrn-hypervisor.git $ git clone https://github.com/projectacrn/acrn-hypervisor.git
$ cd acrn-hypervisor $ cd acrn-hypervisor
$ git checkout v1.1 $ git checkout v1.6
$ cd hypervisor
Configure the build options: Build ACRN hypervisor with default xmls:
.. code-block:: none .. code-block:: none
$ make defconfig BOARD=nuc7i7dnb $ make hypervisor BOARD_FILE=$PWD/misc/acrn-config/xmls/board-xmls/whl-ipc-i5.xml SCENARIO_FILE=$PWD/misc/acrn-config/xmls/config-xmls/whl-ipc-i5/logical_partition.xml RELEASE=0
$ make menuconfig
Updates the following configure item: .. note::
* Set ACRN Scenario as "Logical Partition VMs"; The ``acrn.32.out`` will be generated to ``./build/hypervisor/acrn.32.out``.
* Set Maximum number of VCPUs per VM as "2";
* Set Maximum number of PCPU as "4";
* Clear/Disable "Enable hypervisor relocation".
We recommend keeping the default values of items not mentioned above.
#. Check Ubuntu boot loader name #. Check Ubuntu boot loader name
@ -178,16 +178,9 @@ Update ACRN hypervisor Image
The above command output should contain the ``GRUB`` keyword. The above command output should contain the ``GRUB`` keyword.
#. Check or update BDF information of PCI devices of each pre-launched VM; #. Check or update BDF information of PCI devices of each pre-launched VM;
Check it in the ``hypervisor/arch/x86/configs/nuc7i7dnb/pci_devices.h``. Check it in the ``hypervisor/arch/x86/configs/whl-ipc-i5/pci_devices.h``.
#. Build the ACRN hypervisor and copy the artifact ``acrn.32.out`` to the #. copy the artifact ``acrn.32.out`` to the ``/boot`` directory:
``/boot`` directory:
#. Build ACRN hypervisor:
.. code-block:: none
$ make
#. Copy ``acrn.32.out`` to a removable disk. #. Copy ``acrn.32.out`` to a removable disk.
@ -231,8 +224,11 @@ Update Ubuntu GRUB to Boot hypervisor and Load Kernel Image
.. code-block:: none .. code-block:: none
#GRUB_HIDDEN_TIMEOUT=0 GRUB_DEFAULT=3
GRUB_HIDDEN_TIMEOUT_QUIET=false GRUB_TIMEOUT=10
GRUB_DISTRIBUTOR=`lsb_release -i -s 2> /dev/null || echo Debian`
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash"
GRUB_CMDLINE_LINUX=""
#. Update grub: #. Update grub: