mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2025-06-22 21:47:22 +00:00
doc: upload tutorial of 'Build UOS from Clear Linux'
This commit is contained in:
coneypo
David Kinder
parent
bc5b27a73d
commit
71bf586e7a
160
doc/tutorials/building_uos_from_clearlinux.rst
Normal file
160
doc/tutorials/building_uos_from_clearlinux.rst
Normal file
@ -0,0 +1,160 @@
|
||||
.. _build UOS from Clearlinux:
|
||||
|
||||
Building UOS from Clear Linux
|
||||
##############################
|
||||
|
||||
This document builds on the :ref:`getting_started`,
|
||||
and explains how to build UOS from Clear Linux.
|
||||
|
||||
Build UOS image in Clear Linux native
|
||||
*************************************
|
||||
|
||||
In order to build out the image of UOS,
|
||||
please follow these steps in Clear Linux native:
|
||||
|
||||
#. In Clear Linxu native, please install ``ister`` at first,
|
||||
``ister`` is a template based installer for linux,
|
||||
which is inclued in the package ``os-installer`` in Clear Linux.
|
||||
For more information about ``ister``,
|
||||
please visit https://github.com/bryteise/ister.
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
# sudo swupd bundle-add os-installer
|
||||
|
||||
#. After installation is complete, use ``ister.py`` to
|
||||
generate the image for UOS with the configuration in
|
||||
``uos-image.json``:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
# cd ~
|
||||
# sudo ister.py -t uos-image.json
|
||||
|
||||
An example of the configuration file ``uos-image.json``
|
||||
is shown as below:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
{
|
||||
"DestinationType" : "virtual",
|
||||
"PartitionLayout" : [ { "disk" : "uos.img",
|
||||
"partition" : 1,
|
||||
"size" : "512M",
|
||||
"type" : "EFI" },
|
||||
{ "disk" : "uos.img",
|
||||
"partition" : 2,
|
||||
"size" : "32M",
|
||||
"type" : "swap" },
|
||||
{ "disk" : "uos.img",
|
||||
"partition" : 3,
|
||||
"size" : "8G",
|
||||
"type" : "linux" } ],
|
||||
"FilesystemTypes" : [ { "disk" : "uos.img",
|
||||
"partition" : 1,
|
||||
"type" : "vfat" },
|
||||
{ "disk" : "uos.img",
|
||||
"partition" : 2,
|
||||
"type" : "swap" },
|
||||
{ "disk" : "uos.img",
|
||||
"partition" : 3,
|
||||
"type" : "ext4" } ],
|
||||
"PartitionMountPoints" : [ { "disk" : "uos.img",
|
||||
"partition" : 1,
|
||||
"mount" : "/boot" },
|
||||
{ "disk" : "uos.img",
|
||||
"partition" : 3,
|
||||
"mount" : "/" } ],
|
||||
"Version": "latest",
|
||||
"Bundles": ["bootloader",
|
||||
"editors",
|
||||
"kernel-iot-lts2018",
|
||||
"network-basic",
|
||||
"os-core-update",
|
||||
"os-core",
|
||||
"openssh-server",
|
||||
"software-defined-cockpit",
|
||||
"sysadmin-basic"]
|
||||
}
|
||||
|
||||
.. note::
|
||||
To generate the image with a specified version,
|
||||
please modify with the ``"Version"`` argument,
|
||||
and ``"Version": 26550`` for example.
|
||||
|
||||
Here we will use ``"Version": 26550`` for example,
|
||||
and the image of UOS called ``uos.img`` will be generated
|
||||
after successful installation. It will output log as shown as below:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
Reading configuration
|
||||
Validating configuration
|
||||
Creating virtual disk
|
||||
Creating partitions
|
||||
Mapping loop device
|
||||
Creating file systems
|
||||
Setting up mount points
|
||||
Starting swupd. May take several minutes
|
||||
Installing 9 bundles (and dependencies)...
|
||||
Verifying version 26550
|
||||
Downloading packs...
|
||||
|
||||
Extracting emacs pack for version 26550
|
||||
|
||||
Extracting vim pack for version 26550
|
||||
...
|
||||
Cleaning up
|
||||
Successful installation
|
||||
|
||||
#. Reboot and select "The ACRN Service OS" to boot, as shown below:
|
||||
|
||||
.. code-block:: console
|
||||
:emphasize-lines: 1
|
||||
|
||||
=> The ACRN Service OS
|
||||
Clear Linux OS for Intel Architecture (Clear-linux-iot-lts2018-4.19.0-19)
|
||||
Clear Linux OS for Intel Architecture (Clear-linux-iot-lts2018-sos-4.19.0-19)
|
||||
Clear Linux OS for Intel Architecture (Clear-linux-native.4.19.1-654)
|
||||
EFI Default Loader
|
||||
Reboot Into Firmware Interface
|
||||
|
||||
|
||||
Start the User OS (UOS)
|
||||
***********************
|
||||
|
||||
#. Mount the UOS image and check the UOS kernel:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
# losetup -f -P --show ~/uos.img
|
||||
# mount /dev/loop0p3 /mnt
|
||||
|
||||
# ls -l /mnt/usr/lib/kernel/
|
||||
|
||||
cmdline-4.19.0-26.iot-lts2018
|
||||
config-4.19.0-26.iot-lts2018
|
||||
default-iot-lts2018 -> org.clearlinux.iot-lts2018.4.19.0-26
|
||||
install.d
|
||||
org.clearlinux.iot-lts2018.4.19.0-26
|
||||
|
||||
#. And you need to adjust the ``/usr/share/acrn/samples/nuc/launch_uos.sh``
|
||||
script to match your installation.
|
||||
These are the couple of lines you need to modify:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
-s 3,virtio-blk,~/uos.img \
|
||||
-k /mnt/usr/lib/kernel/default-iot-lts2018 \
|
||||
|
||||
.. note::
|
||||
UOS image ``uos.img`` stored in the directory ``~/``
|
||||
and UOS kernel ``default-iot-lts2018`` stored ``/mnt/usr/lib/kernel/``.
|
||||
|
||||
#. You are now all set to start the User OS (UOS):
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
sudo /usr/share/acrn/samples/nuc/launch_uos.sh
|
||||
|
||||
You are now watching the User OS booting up!
|
||||
Loading…
Reference in New Issue
Block a user