OrgACRN
/
acrn-hypervisor
mirror of https://github.com/projectacrn/acrn-hypervisor.git
1
0
Fork 0
Code Issues Releases Wiki Activity

doc:Update Getting started guide for Intel NUC 

Signed-off-by: yunzha4x <yunx.zhang@intel.com>
This commit is contained in:
yunzha4x 2019-07-12 16:44:48 +08:00 committed by David Kinder
parent 009a16bd7d
commit be586b4959
1 changed files with 25 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
doc/getting-started/apl-nuc.rst
View File

@ -85,10 +85,10 @@ manually, as described below).
Please refer to the ACRN :ref:`release_notes` for the Clear Linux OS Please refer to the ACRN :ref:`release_notes` for the Clear Linux OS
version number tested with a specific ACRN release. Adjust the version number tested with a specific ACRN release. Adjust the
instruction below to reference the appropriate version number of Clear instruction below to reference the appropriate version number of Clear
Linux OS (we use version 28960 as an example). Linux OS (we use version 30210 as an example).
#. Download the compressed Clear Linux OS installer image from #. Download the compressed Clear Linux OS installer image from
https://download.clearlinux.org/releases/28960/clear/clear-28960-installer.img.xz https://download.clearlinux.org/releases/30210/clear/clear-30210-live-server.img.xz
and follow the `Clear Linux OS installation guide and follow the `Clear Linux OS installation guide
<https://clearlinux.org/documentation/clear-linux/get-started/bare-metal-install-server>`_ <https://clearlinux.org/documentation/clear-linux/get-started/bare-metal-install-server>`_
as a starting point for installing Clear Linux OS onto your platform. Follow the recommended as a starting point for installing Clear Linux OS onto your platform. Follow the recommended
@ -99,7 +99,12 @@ manually, as described below).
When setting up Clear Linux on your NUC: When setting up Clear Linux on your NUC:
#. Launch the Clear Linux OS installer boot menu #. Launch the Clear Linux OS installer boot menu
#. With Clear Linux OS highlighted, select Enter. #. With Clear Linux OS highlighted, select Enter
#. Login with your root account, and new password
#. Run the installer using the command::
$ clr-installer
#. From the Main Menu, select "Configure Media" and set #. From the Main Menu, select "Configure Media" and set
"Auto Partition" to your desired hard disk. "Auto Partition" to your desired hard disk.
#. Press :kbd:`A` to show the "Advanced options". #. Press :kbd:`A` to show the "Advanced options".
@ -137,7 +142,7 @@ can see your current Clear Linux version with the command::
$ cat /etc/os-release $ cat /etc/os-release
.. note:: In the following steps, we're using Clear Linux version 28960. You should .. note:: In the following steps, we're using Clear Linux version 30210. You should
specify the Clear Linux version you want to use. specify the Clear Linux version you want to use.
Here are the steps to install Clear Linux on your NUC, set up the SOS Here are the steps to install Clear Linux on your NUC, set up the SOS
@ -156,11 +161,11 @@ and UOS using the ``acrn_quick_setup.sh`` script, and launch the UOS:
$ cd ~ $ cd ~
$ wget https://raw.githubusercontent.com/projectacrn/acrn-hypervisor/master/doc/getting-started/acrn_quick_setup.sh $ wget https://raw.githubusercontent.com/projectacrn/acrn-hypervisor/master/doc/getting-started/acrn_quick_setup.sh
$ sudo sh acrn_quick_setup.sh -s 28960 $ sudo sh acrn_quick_setup.sh -s 30210
Password: Password:
Upgrading SOS... Upgrading SOS...
Disable auto update... Disable auto update...
Clear Linux version 28960 is already installed. Continuing to setup SOS... Clear Linux version 30210 is already installed. Continuing to setup SOS...
Adding the service-os, kernel-iot-lts2018 and systemd-networkd-autostart bundles... Adding the service-os, kernel-iot-lts2018 and systemd-networkd-autostart bundles...
...100% ...100%
...100% ...100%
@ -191,7 +196,7 @@ and UOS using the ``acrn_quick_setup.sh`` script, and launch the UOS:
it using ``-e`` option. For example, to set up the SOS on an NVMe it using ``-e`` option. For example, to set up the SOS on an NVMe
SSD, you could specify:: SSD, you could specify::
sudo sh acrn_quick_setup.sh -s 28960 -e /dev/nvme0n1p1 sudo sh acrn_quick_setup.sh -s 30210 -e /dev/nvme0n1p1
.. note:: .. note::
If you don't need to reboot automatically after setting up the SOS, you If you don't need to reboot automatically after setting up the SOS, you
@ -213,10 +218,10 @@ and UOS using the ``acrn_quick_setup.sh`` script, and launch the UOS:
.. code-block:: console .. code-block:: console
$ sudo sh acrn_quick_setup.sh -u 28960 $ sudo sh acrn_quick_setup.sh -u 30210
Password: Password:
Upgrading UOS... Upgrading UOS...
Downloading UOS image: https://download.clearlinux.org/releases/28960/clear/clear-28960-kvm.img.xz Downloading UOS image: https://download.clearlinux.org/releases/30210/clear/clear-30210-kvm.img.xz
% Total % Received % Xferd Average Speed Time Time Time Current % Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed Dload Upload Total Spent Left Speed
14 248M 14 35.4M 0 0 851k 0 0:04:57 0:00:42 0:04:15 293k 14 248M 14 35.4M 0 0 851k 0 0:04:57 0:00:42 0:04:15 293k
@ -225,18 +230,18 @@ and UOS using the ``acrn_quick_setup.sh`` script, and launch the UOS:
.. code-block:: console .. code-block:: console
Unxz UOS image: clear-28960-kvm.img.xz Unxz UOS image: clear-30210-kvm.img.xz
Get UOS image: clear-28960-kvm.img Get UOS image: clear-30210-kvm.img
Upgrade UOS done... Upgrade UOS done...
Now you can run this command to start UOS... Now you can run this command to start UOS...
$ sudo /root/launch_uos_28960.sh $ sudo /root/launch_uos_30210.sh
#. Now you can launch the UOS using the customized launch_uos script #. Now you can launch the UOS using the customized launch_uos script
(with sudo): (with sudo):
.. code-block:: console .. code-block:: console
$ sudo /root/launch_uos_28960.sh $ sudo /root/launch_uos_30210.sh
Password: Password:
cpu1 online=0 cpu1 online=0
cpu2 online=0 cpu2 online=0
@ -296,7 +301,7 @@ and UOS using the ``acrn_quick_setup.sh`` script, and launch the UOS:
.. code-block:: console .. code-block:: console
# uname -r # uname -r
4.19.34-45.iot-lts2018-sos 4.19.55-67.iot-lts2018-sos
# ls /dev/acrn* # ls /dev/acrn*
/dev/acrn_hvlog_cur_0 /dev/acrn_hvlog_cur_2 /dev/acrn_trace_0 /dev/acrn_trace_2 /dev/acrn_vhm /dev/acrn_hvlog_cur_0 /dev/acrn_hvlog_cur_2 /dev/acrn_trace_0 /dev/acrn_trace_2 /dev/acrn_vhm
/dev/acrn_hvlog_cur_1 /dev/acrn_hvlog_cur_3 /dev/acrn_trace_1 /dev/acrn_trace_3 /dev/acrn_hvlog_cur_1 /dev/acrn_hvlog_cur_3 /dev/acrn_trace_1 /dev/acrn_trace_3
@ -325,16 +330,16 @@ and UOS manually following these steps:
.. note:: .. note::
The Clear Linux OS installer will automatically check for updates and install the The Clear Linux OS 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 28960), you can achieve that after the installation has completed using (such as 30210), you can achieve that after the installation has completed using
``sudo swupd verify --fix --picky -m 28960`` ``sudo swupd verify --fix --picky -m 30210``
#. If you have an older version of Clear Linux OS already installed #. If you have an older version of Clear Linux OS already installed
on your hardware, use this command to upgrade Clear Linux OS on your hardware, use this command to upgrade Clear Linux OS
to version 28960 (or newer): to version 30210 (or newer):
.. code-block:: none .. code-block:: none
$ sudo swupd update -m 28960 # or newer version $ sudo swupd update -m 30210 # or newer version
#. Use the ``sudo swupd bundle-add`` command and add these Clear Linux OS bundles: #. Use the ``sudo swupd bundle-add`` command and add these Clear Linux OS bundles:
@ -570,14 +575,14 @@ Set up Reference UOS
==================== ====================
#. On your platform, download the pre-built reference Clear Linux OS UOS #. On your platform, download the pre-built reference Clear Linux OS UOS
image version 28960 (or newer) into your (root) home directory: image version 30210 (or newer) into your (root) home directory:
.. code-block:: none .. code-block:: none
$ cd ~ $ cd ~
$ mkdir uos $ mkdir uos
$ cd uos $ cd uos
$ curl https://download.clearlinux.org/releases/28960/clear/clear-28960-kvm.img.xz -o uos.img.xz $ curl https://download.clearlinux.org/releases/30210/clear/clear-30210-kvm.img.xz -o uos.img.xz
.. note:: .. note::
In case you want to use or try out a newer version of Clear Linux OS as the UOS, you can In case you want to use or try out a newer version of Clear Linux OS as the UOS, you can