Documentation: update GSG for release 0.3

Update Getting Started Guide (GSG) with Clear Linux version and
kernel versions for ACRN v0.3.

Signed-off-by: Geoffroy Van Cutsem <geoffroy.vancutsem@intel.com>
This commit is contained in:
Geoffroy Van Cutsem 2018-11-12 16:40:18 +01:00 committed by David Kinder
parent 33137dc9fb
commit 1847497d8f

View File

@ -38,12 +38,12 @@ complete this setup.
.. note:: .. note::
ACRN v0.3 (and the current master branch) requires Clear Linux ACRN v0.3 (and the current master branch) requires Clear Linux
version 26120 or newer. If you use a newer version of Clear Linux, version 26200 or newer. If you use a newer version of Clear Linux,
you'll need to adjust the instructions below to reference the version you'll need to adjust the instructions below to reference the version
number of Clear Linux you are using. number of Clear Linux you are using.
#. Download the compressed Clear installer image from #. Download the compressed Clear installer image from
https://download.clearlinux.org/releases/26120/clear/clear-26120-installer.img.xz https://download.clearlinux.org/releases/26200/clear/clear-26200-installer.img.xz
and follow the `Clear Linux installation guide and follow the `Clear Linux installation guide
<https://clearlinux.org/documentation/clear-linux/get-started/bare-metal-install>`__ <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 as a starting point for installing Clear Linux onto your platform. Follow the recommended
@ -65,16 +65,16 @@ complete this setup.
.. note:: .. note::
The Clear Linux installer will automatically check for updates and install the 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 latest version available on your system. If you wish to use a specific version
(such as 26120), you can achieve that after the installation has completed using (such as 26200), you can achieve that after the installation has completed using
``swupd verify --fix --picky -m 26120`` ``swupd verify --fix --picky -m 26200``
#. If you have an older version of Clear Linux already installed #. If you have an older version of Clear Linux already installed
on your hardware, use this command to upgrade Clear Linux on your hardware, use this command to upgrade Clear Linux
to version 26120 (or newer): to version 26200 (or newer):
.. code-block:: none .. code-block:: none
# swupd update -m 26120 # or newer version # swupd update -m 26200 # or newer version
#. Use the ``swupd bundle-add`` command and add these Clear Linux bundles: #. Use the ``swupd bundle-add`` command and add these Clear Linux bundles:
@ -124,9 +124,9 @@ partition. Follow these steps:
# ls -1 /mnt/EFI/org.clearlinux # ls -1 /mnt/EFI/org.clearlinux
bootloaderx64.efi bootloaderx64.efi
kernel-org.clearlinux.native.4.18.16-650 kernel-org.clearlinux.native.4.19.1-654
kernel-org.clearlinux.iot-lts2018-sos.4.19.0-16 kernel-org.clearlinux.iot-lts2018-sos.4.19.0-19
kernel-org.clearlinux.iot-lts2018.4.19.0-16 kernel-org.clearlinux.iot-lts2018.4.19.0-19
loaderx64.efi loaderx64.efi
.. note:: .. note::
@ -262,9 +262,9 @@ partition. Follow these steps:
:caption: ACRN Service OS Boot Menu :caption: ACRN Service OS Boot Menu
=> The ACRN Service OS => The ACRN Service OS
Clear Linux OS for Intel Architecture (Clear-linux-iot-lts2018-4.19.0-16) 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-16) 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.18.16-650) Clear Linux OS for Intel Architecture (Clear-linux-native.4.19.1-654)
EFI Default Loader EFI Default Loader
Reboot Into Firmware Interface Reboot Into Firmware Interface
@ -309,12 +309,12 @@ Set up Reference UOS
==================== ====================
#. On your platform, download the pre-built reference Clear Linux UOS #. On your platform, download the pre-built reference Clear Linux UOS
image version 26120 (or newer) into your (root) home directory: image version 26200 (or newer) into your (root) home directory:
.. code-block:: none .. code-block:: none
# cd ~ # cd ~
# curl -O https://download.clearlinux.org/releases/26120/clear/clear-26120-kvm.img.xz # curl -O https://download.clearlinux.org/releases/26200/clear/clear-26200-kvm.img.xz
.. note:: .. note::
In case you want to use or try out a newer version of Clear Linux as the UOS, you can In case you want to use or try out a newer version of Clear Linux as the UOS, you can
@ -325,16 +325,16 @@ Set up Reference UOS
.. code-block:: none .. code-block:: none
# unxz clear-26120-kvm.img.xz # unxz clear-26200-kvm.img.xz
#. Deploy the UOS kernel modules to UOS virtual disk image (note: you'll need to use #. Deploy the UOS kernel modules to UOS virtual disk image (note: you'll need to use
the same **standard** image version number noted in step 1 above): the same **standard** image version number noted in step 1 above):
.. code-block:: none .. code-block:: none
# losetup -f -P --show /root/clear-25130-kvm.img # losetup -f -P --show /root/clear-26200-kvm.img
# mount /dev/loop0p3 /mnt # mount /dev/loop0p3 /mnt
# cp -r /usr/lib/modules/4.19.0-16.iot-lts2018 /mnt/lib/modules/ # cp -r /usr/lib/modules/4.19.0-19.iot-lts2018 /mnt/lib/modules/
# umount /mnt # umount /mnt
# sync # sync
@ -353,7 +353,7 @@ Set up Reference UOS
.. note:: .. note::
In case you have downloaded a different Clear Linux image than the one above In case you have downloaded a different Clear Linux image than the one above
(``clear-25130-kvm.img.xz``), you will need to modify the Clear Linux file name (``clear-26200-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 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 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: name on the second line highlighted (check the exact name to be used using: