Doc: Update GSG for v0.5 version and launch and acrn.conf sample script

modify sbl_up2 version and scripts
This commit is contained in:
wenlingz 2019-01-16 11:11:09 +08:00 committed by Wang, Hongbo
parent b4a1dd2b56
commit 34b4294334
5 changed files with 25 additions and 25 deletions

View File

@ -21,7 +21,7 @@ acrn-dm -A -m $mem_size -c $2 -s 0:0,hostbridge -s 1:0,lpc -l com1,stdio \
-s 2,pci-gvt -G "$3" \
-s 5,virtio-console,@pty:pty_port \
-s 6,virtio-hyper_dmabuf \
-s 3,virtio-blk,/home/clear/uos/clear-26770-kvm.img \
-s 3,virtio-blk,/home/clear/uos/clear-27230-kvm.img \
-s 4,virtio-net,tap0 \
--mac_seed $mac_seed \
-k /usr/lib/kernel/default-iot-lts2018 \

View File

@ -37,13 +37,13 @@ complete this setup.
.. note::
ACRN v0.4 (and the current master branch) requires Clear Linux
version 26770 or newer. If you use a newer version of Clear Linux,
ACRN v0.5 (and the current master branch) requires Clear Linux
version 27230 or newer. If you use a newer version of Clear Linux,
you'll need to adjust the instructions below to reference the version
number of Clear Linux you are using.
#. Download the compressed Clear installer image from
https://download.clearlinux.org/releases/26770/clear/clear-26770-installer.img.xz
https://download.clearlinux.org/releases/27230/clear/clear-27230-installer.img.xz
and follow the `Clear Linux installation guide
<https://clearlinux.org/documentation/clear-linux/get-started/bare-metal-install>`__
as a starting point for installing Clear Linux onto your platform. Follow the recommended
@ -74,12 +74,12 @@ complete this setup.
.. note::
The Clear Linux installer will automatically check for updates and install the
latest version available on your system. If you wish to use a specific version
(such as 26770), you can achieve that after the installation has completed using
``sudo swupd verify --fix --picky -m 26770``
(such as 27230), you can achieve that after the installation has completed using
``sudo swupd verify --fix --picky -m 27230``
#. If you have an older version of Clear Linux already installed
on your hardware, use this command to upgrade Clear Linux
to version 26770 (or newer):
to version 27230 (or newer):
.. code-block:: none
@ -118,9 +118,9 @@ partition. Follow these steps:
$ sudo ls -1 /boot/EFI/org.clearlinux
bootloaderx64.efi
kernel-org.clearlinux.native.4.19.8-670
kernel-org.clearlinux.iot-lts2018-sos.4.19.5-29
kernel-org.clearlinux.iot-lts2018.4.19.5-29
kernel-org.clearlinux.native.4.20.2-683
kernel-org.clearlinux.iot-lts2018-sos.4.19.13-1901141830
kernel-org.clearlinux.iot-lts2018.4.19.13-1901141830
kernel-org.clearlinux.pk414-sos.4.14.74-115
loaderx64.efi
@ -250,9 +250,9 @@ partition. Follow these steps:
:caption: ACRN Service OS Boot Menu
=> The ACRN Service OS
Clear Linux OS for Intel Architecture (Clear-linux-iot-lts2018-4.19.5-29)
Clear Linux OS for Intel Architecture (Clear-linux-iot-lts2018-sos-4.19.5-29)
Clear Linux OS for Intel Architecture (Clear-linux-native.4.19.8-670)
Clear Linux OS for Intel Architecture (Clear-linux-iot-lts2018-4.19.13-1901141830)
Clear Linux OS for Intel Architecture (Clear-linux-iot-lts2018-sos-4.19.13-1901141830)
Clear Linux OS for Intel Architecture (Clear-linux-native.4.20.2-683)
EFI Default Loader
Reboot Into Firmware Interface
@ -291,14 +291,14 @@ Set up Reference UOS
====================
#. On your platform, download the pre-built reference Clear Linux UOS
image version 26770 (or newer) into your (root) home directory:
image version 27230 (or newer) into your (root) home directory:
.. code-block:: none
$ cd ~
$ mkdir uos
$ cd uos
$ curl -O https://download.clearlinux.org/releases/26770/clear/clear-26770-kvm.img.xz
$ curl -O https://download.clearlinux.org/releases/27230/clear/clear-27230-kvm.img.xz
.. note::
In case you want to use or try out a newer version of Clear Linux as the UOS, you can
@ -309,16 +309,16 @@ Set up Reference UOS
.. code-block:: none
$ unxz clear-26770-kvm.img.xz
$ unxz clear-27230-kvm.img.xz
#. Deploy the UOS kernel modules to UOS virtual disk image (note: you'll need to use
the same **iot-lts2018** image version number noted in step 1 above):
.. code-block:: none
$ sudo losetup -f -P --show clear-26770-kvm.img
$ sudo losetup -f -P --show clear-27230-kvm.img
$ sudo mount /dev/loop0p3 /mnt
$ sudo cp -r /usr/lib/modules/4.19.5-29.iot-lts2018 /mnt/lib/modules/
$ sudo cp -r /usr/lib/modules/4.19.13-1901141830.iot-lts2018 /mnt/lib/modules/
$ sudo umount /mnt
$ sync
@ -337,7 +337,7 @@ Set up Reference UOS
.. note::
In case you have downloaded a different Clear Linux image than the one above
(``clear-26770-kvm.img.xz``), you will need to modify the Clear Linux file name
(``clear-27230-kvm.img.xz``), you will need to modify the Clear Linux file name
and version number highlighted above (the ``-s 3,virtio-blk`` argument) to match
what you have downloaded above. Likewise, you may need to adjust the kernel file
name on the second line highlighted (check the exact name to be used using:

View File

@ -103,7 +103,7 @@ create_uos_images() {
echo mount laag_image >> .cleanup
mkdir -p laag_image/clearlinux
ister.py -t $LAAG_JSON -V $MIRRORURL -C $MIRRORURL ||
ister.py -t $LAAG_JSON --format=staging -V $MIRRORURL -C $MIRRORURL ||
{
echo "ister create clearlinux.img failed"
return 1

View File

@ -90,14 +90,14 @@ An example of the configuration file ``uos.json``:
{ "disk" : "clearlinux.img", "partition" : 2, "type" : "ext4" } ],
"PartitionMountPoints" : [ { "disk" : "clearlinux.img", "partition" : 1, "mount" : "/boot" },
{ "disk" : "clearlinux.img", "partition" : 2, "mount" : "/" } ],
"Version": 27050,
"Version": 27230,
"Bundles": ["kernel-iot-lts2018", "openssh-server", "software-defined-cockpit", "os-core", "os-core-update"]
}
.. note::
To generate the image with a specified version, please modify
the "Version" argument, ``"Version": 26000`` instead
of ``"Version": 27050`` for example.
the "Version" argument, ``"Version": 2****`` instead
of ``"Version": 27230`` for example.
Clone the source code of ``acrn-hypervisor`` for building and use
``v0.5`` release for example:
@ -118,7 +118,7 @@ Build SOS and LaaG image:
$ sudo -s
# ./acrn-hypervisor/devicemodel/samples/up2/create-up2-images.sh --images-type all \
--clearlinux-version 27050 --laag-json uos.json --acrn-code-path /path/to/acrn-hypervisor/
--clearlinux-version 27230 --laag-json uos.json --acrn-code-path /path/to/acrn-hypervisor/
.. note::
You must have root privileges to run ``create-up2-images.sh``.

View File

@ -1,3 +1,3 @@
title The ACRN Service OS
linux /EFI/org.clearlinux/kernel-org.clearlinux.iot-lts2018-sos.4.19.5-29
linux /EFI/org.clearlinux/kernel-org.clearlinux.iot-lts2018-sos.4.19.13-1901141830
options console=tty0 console=ttyS0 i915.nuclear_pageflip=1 root=PARTUUID=<UUID of rootfs partition> rw rootwait ignore_loglevel no_timer_check consoleblank=0 i915.tsd_init=7 i915.tsd_delay=2000 i915.avail_planes_per_pipe=0x01010F i915.domain_plane_owners=0x011111110000 i915.enable_guc_loading=0 i915.enable_guc_submission=0 i915.enable_preemption=1 i915.context_priority_mode=2 i915.enable_gvt=1 i915.enable_guc=0 hvlog=2M@0x1FE00000