mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2025-06-22 21:47:22 +00:00
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:
parent
ec6777ab09
commit
2d5fdecf41
@ -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
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user