doc: update acrn ootb doc

1. Update acrn.efi name in acrn ootb scripts
2. Add licenses to acrn ootb scripts
3. Add format U disk step
4. Add execute permission to ootb script
5. Fix wrong img name
6. update clearlinux version to 31600

Signed-off-by: Lei, Lu <leix.lu@intel.com>
This commit is contained in:
Lei, Lu 2019-11-12 09:33:14 +08:00 committed by deb-intel
parent ec6777ab09
commit 2d5fdecf41

View File

@ -88,7 +88,7 @@ Step 1: Create a Service VM YAML file and script
{cmd: "${yamlDir}/service-os-post.sh ${chrootDir}"}, {cmd: "${yamlDir}/service-os-post.sh ${chrootDir}"},
] ]
version: 30970 version: 31670
.. note:: Update the version value to your target Clear Linux version. .. note:: Update the version value to your target Clear Linux version.
@ -103,6 +103,8 @@ Step 1: Create a Service VM YAML file and script
.. code-block:: bash .. code-block:: bash
#!/bin/bash #!/bin/bash
# Copyright (C) 2019 Intel Corporation.
# SPDX-License-Identifier: BSD-3-Clause
# ACRN SOS Image Post Install steps # ACRN SOS Image Post Install steps
@ -111,11 +113,11 @@ Step 1: Create a Service VM YAML file and script
CHROOTPATH=$1 CHROOTPATH=$1
# acrn.efi path # acrn.efi path
acrn_efi_path="$CHROOTPATH/usr/lib/acrn/acrn.efi" acrn_efi_path="$CHROOTPATH/usr/lib/acrn/acrn.nuc7i7dnb.sdc.efi"
# copy acrn.efi to efi partition # copy acrn.efi to efi partition
mkdir -p "$CHROOTPATH/boot/EFI/acrn" || exit 1 mkdir -p "$CHROOTPATH/boot/EFI/acrn" || exit 1
cp "$acrn_efi_path" "$CHROOTPATH/boot/EFI/acrn" || exit 1 cp "$acrn_efi_path" "$CHROOTPATH/boot/EFI/acrn/acrn.efi" || exit 1
# create load.conf # create load.conf
echo "Add default (5 seconds) boot wait time" echo "Add default (5 seconds) boot wait time"
@ -132,6 +134,12 @@ Step 1: Create a Service VM YAML file and script
exit 0 exit 0
Grant execute permission to the script:
.. code-block:: none
$ chmod a+x service-os-post.sh
**Scenario 2: ACRN INDUSTRY** **Scenario 2: ACRN INDUSTRY**
#. Create the ACRN INDUSTRY ``service-os-industry.yaml`` file: #. Create the ACRN INDUSTRY ``service-os-industry.yaml`` file:
@ -197,7 +205,7 @@ Step 1: Create a Service VM YAML file and script
{cmd: "${yamlDir}/service-os-industry-post.sh ${chrootDir}"}, {cmd: "${yamlDir}/service-os-industry-post.sh ${chrootDir}"},
] ]
version: 30970 version: 31670
.. note:: Update the version value to your target Clear Linux version. .. note:: Update the version value to your target Clear Linux version.
@ -212,6 +220,9 @@ Step 1: Create a Service VM YAML file and script
.. code-block:: bash .. code-block:: bash
#!/bin/bash #!/bin/bash
# Copyright (C) 2019 Intel Corporation.
# SPDX-License-Identifier: BSD-3-Clause
# ACRN SOS Image Post Install steps # ACRN SOS Image Post Install steps
@ -219,8 +230,8 @@ Step 1: Create a Service VM YAML file and script
CHROOTPATH=$1 CHROOTPATH=$1
# acrn.kbl-nuc-i7.industry.efi path # acrn.nuc7i7dnb.industry.efi path
acrn_industry_efi_path="$CHROOTPATH/usr/lib/acrn/acrn.kbl-nuc-i7.industry.efi" acrn_industry_efi_path="$CHROOTPATH/usr/lib/acrn/acrn.nuc7i7dnb.industry.efi"
# copy acrn.efi to efi partition # copy acrn.efi to efi partition
mkdir -p "$CHROOTPATH/boot/EFI/acrn" || exit 1 mkdir -p "$CHROOTPATH/boot/EFI/acrn" || exit 1
@ -241,6 +252,12 @@ Step 1: Create a Service VM YAML file and script
exit 0 exit 0
Grant execute permission to the script:
.. code-block:: none
$ chmod a+x service-os-industry-post.sh
Step 2: Build the Service VM image Step 2: Build the Service VM image
================================== ==================================
@ -254,7 +271,7 @@ Use the clr-installer to build the Service VM image.
$ sudo clr-installer -c service-os.yaml $ sudo clr-installer -c service-os.yaml
The ``service-os.img`` will be generated at current directory. The ``sos.img`` will be generated at current directory.
**Scenario 2: ACRN INDUSTRY** **Scenario 2: ACRN INDUSTRY**
@ -265,14 +282,40 @@ Use the clr-installer to build the Service VM image.
$ sudo clr-installer -c service-os-industry.yaml $ sudo clr-installer -c service-os-industry.yaml
The ``service-os-industry.img`` will be generated at current directory. The ``sos-industry.img`` will be generated at current directory.
.. _deploy_ootb_service_vm: .. _deploy_ootb_service_vm:
Step 3: Deploy the Service VM image Step 3: Deploy the Service VM image
=================================== ===================================
#. Prepare a U disk with at least 8GB memory. #. Prepare a U disk with at least 8GB memory. Begin by formatting the U disk:
.. code-block:: none
# sudo gdisk /dev/sdb
GPT fdisk (gdisk) version 1.0.3
Partition table scan:
MBR: protective
BSD: not present
APM: not present
GPT: present
Found valid GPT with protective MBR; using GPT.
Command (? for help): o
This option deletes all partitions and creates a new protective MBR.
Proceed? (Y/N): Y
Command (? for help): w
Final checks complete. About to write GPT data. THIS WILL OVERWRITE EXISTING
PARTITIONS!!
Do you want to proceed? (Y/N): Y
OK; writing new GUID partition table (GPT) to /dev/sdb.
The operation has completed successfully.
#. Follow these steps to create two partitions on the U disk. #. Follow these steps to create two partitions on the U disk.
Keep 4GB in the first partition and leave free space in the second parition. Keep 4GB in the first partition and leave free space in the second parition.
@ -334,11 +377,10 @@ Step 3: Deploy the Service VM image
.. code-block:: none .. code-block:: none
$ wget https://download.clearlinux.org/releases/30970/clear/clear-30970-live-server.iso.xz $ wget https://download.clearlinux.org/releases/31670/clear/clear-31670-live-server.iso
$ xz -d clear-30970-live-server.iso.xz $ sudo dd if=clear-31670-live-server.iso of=/dev/sdb1 bs=4M oflag=sync status=progress
$ sudo dd if=clear-30970-live-server.iso of=/dev/sdb1 bs=4M oflag=sync status=progress
#. Copy the ``service-os.img`` or ``service-os-industry.img`` to the U disk: #. Copy the ``sos.img`` or ``sos-industry.img`` to the U disk:
.. code-block:: none .. code-block:: none
@ -349,14 +391,14 @@ Step 3: Deploy the Service VM image
.. code-block:: none .. code-block:: none
$ cp ~/service-os/service-os.img /mnt $ cp ~/service-os/sos.img /mnt
$ sync && umount /mnt $ sync && umount /mnt
- ACRN INDUSTRY scenario: - ACRN INDUSTRY scenario:
.. code-block:: none .. code-block:: none
$ cp ~/service-os-industry/service-os-industry.img /mnt $ cp ~/service-os-industry/sos-industry.img /mnt
$ sync && umount /mnt $ sync && umount /mnt
#. Unplug the U disk from the development machine and plug it in to your test machine. #. Unplug the U disk from the development machine and plug it in to your test machine.
@ -491,7 +533,7 @@ Step 1: Create a Preempt-RT image YAML file and script
language: en_US.UTF-8 language: en_US.UTF-8
kernel: kernel-lts2018-preempt-rt kernel: kernel-lts2018-preempt-rt
version: 30970 version: 31670
.. note:: Update the version value to your target Clear Linux version .. note:: Update the version value to your target Clear Linux version