mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2025-06-21 05:02:24 +00:00
doc: update GSG to include scp instructions
Make the GSG more consistent with the sample app doc and show how to use scp to transfer files between the dev and target machines. Also add a mention of the sample app guide at the end of the GSG. Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
parent
68a7854052
commit
2addfe9ca1
@ -244,6 +244,22 @@ To install Ubuntu 20.04:
|
||||
sudo apt update
|
||||
sudo apt upgrade -y
|
||||
|
||||
#. It's convenient to use the network to transfer files between the development
|
||||
and target system, so we recommend installing the openssh-server package on
|
||||
the target system::
|
||||
|
||||
sudo apt install -y openssh-server
|
||||
|
||||
This command will install and start the ssh-server service on the target
|
||||
system. We'll need to know the target system's IP address to make a
|
||||
connection from the development system, so find it now with this command::
|
||||
|
||||
hostname -I | cut -d ' ' -f 1
|
||||
|
||||
#. Make a working directory on the target system that we'll use later::
|
||||
|
||||
mkdir -p ~/acrn-work
|
||||
|
||||
Configure Target BIOS Settings
|
||||
===============================
|
||||
|
||||
@ -262,8 +278,8 @@ Configure Target BIOS Settings
|
||||
provides additional support for managing I/O virtualization).
|
||||
* Disable **Secure Boot**. This setting simplifies the steps for this example.
|
||||
|
||||
The names and locations of the BIOS settings differ depending on the target
|
||||
hardware and BIOS version.
|
||||
The names and locations of the BIOS settings depend on the target
|
||||
hardware and BIOS vendor and version.
|
||||
|
||||
Generate a Board Configuration File
|
||||
=========================================
|
||||
@ -288,8 +304,16 @@ Generate a Board Configuration File
|
||||
directory.
|
||||
|
||||
#. Copy the Board Inspector Debian package from the development computer to the
|
||||
target system via USB disk as follows:
|
||||
target system.
|
||||
|
||||
Option 1: Use ``scp``
|
||||
Use the ``scp`` command to copy the Debian package from your development
|
||||
computer to the ``~/acrn-work`` working directory we created on the target
|
||||
system. Replace ``10.0.0.200`` with the target system's IP address you found earlier::
|
||||
|
||||
scp ~/acrn-work/acrn-hypervisor/build/acrn-board-inspector*.deb acrn@10.0.0.200:~/acrn-work
|
||||
|
||||
Option 2: Use a USB disk
|
||||
a. On the development computer, insert the USB disk that you intend to use to
|
||||
copy files.
|
||||
|
||||
@ -321,14 +345,14 @@ Generate a Board Configuration File
|
||||
disk="/media/$USER/"$(ls /media/$USER)
|
||||
cp -r "$disk"/acrn-board-inspector*.deb ~/acrn-work
|
||||
|
||||
#. Install the Board Inspector Debian package on the target system:
|
||||
#. Now that we've got the Board Inspector Debian package on the target system, install it there:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
cd ~/acrn-work
|
||||
sudo apt install -y ./acrn-board-inspector*.deb
|
||||
|
||||
#. Reboot the system:
|
||||
#. Reboot the target system:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
@ -356,9 +380,18 @@ Generate a Board Configuration File
|
||||
|
||||
ls ./my_board.xml
|
||||
|
||||
#. Copy ``my_board.xml`` from the target to the development computer via USB
|
||||
disk as follows:
|
||||
#. Copy ``my_board.xml`` from the target to the development computer. Again we
|
||||
have two options:
|
||||
|
||||
Option 1: Use ``scp``
|
||||
From your development computer, use the ``scp`` command to copy the Debian
|
||||
package from your target system back to the ``~/acrn-work`` directory on
|
||||
your development computer.
|
||||
Replace ``10.0.0.200`` with the target system's IP address you found earlier::
|
||||
|
||||
scp acrn@10.0.0.200:~/acrn-work/my_board.xml ~/acrn-work/
|
||||
|
||||
Option 2: Use a USB disk
|
||||
a. Make sure the USB disk is connected to the target.
|
||||
|
||||
#. Copy ``my_board.xml`` to the USB disk:
|
||||
@ -615,8 +648,28 @@ Build ACRN
|
||||
linux-libc-dev_5.10.115-acrn-service-vm-1_amd64.deb
|
||||
|
||||
#. Copy all the necessary files generated on the development computer to the
|
||||
target system by USB disk as follows:
|
||||
target system, using one of these two options:
|
||||
|
||||
Option 1: Use ``scp``
|
||||
Use the ``scp`` command to copy files from your development system to
|
||||
to the target system.
|
||||
Replace ``10.0.0.200`` with the target system's IP address you found earlier::
|
||||
|
||||
scp ~/acrn-work/acrn-hypervisor/build/acrn-my_board-MyConfiguration*.deb \
|
||||
~/acrn-work/*acrn-service-vm*.deb \
|
||||
~/acrn-work/MyConfiguration/launch_user_vm_id1.sh \
|
||||
~/acrn-work/acpica-unix-20210105/generate/unix/bin/iasl
|
||||
acrn@10.0.0.200:~/acrn-work
|
||||
|
||||
Then, go to the target system and put the ``iasl`` tool in its proper
|
||||
place::
|
||||
|
||||
cd ~/acrn-work
|
||||
sudo cp iasl /usr/sbin/
|
||||
sudo chmod a+x /usr/sbin/iasl
|
||||
|
||||
|
||||
Option 2: by USB disk
|
||||
a. Insert the USB disk into the development computer and run these commands:
|
||||
|
||||
.. code-block:: bash
|
||||
@ -648,7 +701,7 @@ Build ACRN
|
||||
Install ACRN
|
||||
************
|
||||
|
||||
#. Install the ACRN Debian package and ACRN kernel Debian packages using these
|
||||
#. On the target system, install the ACRN Debian package and ACRN kernel Debian packages using these
|
||||
commands:
|
||||
|
||||
.. code-block:: bash
|
||||
@ -664,7 +717,7 @@ Install ACRN
|
||||
reboot
|
||||
|
||||
#. Confirm that you see the GRUB menu with the "ACRN multiboot2" entry. Select
|
||||
it and proceed to booting ACRN. (It may be autoselected, in which case it
|
||||
it and proceed to booting ACRN. (It may be auto-selected, in which case it
|
||||
will boot with this option automatically in 5 seconds.)
|
||||
|
||||
.. code-block:: console
|
||||
@ -811,6 +864,9 @@ Launch the User VM
|
||||
Next Steps
|
||||
**************
|
||||
|
||||
:ref:`overview_dev` describes the ACRN configuration process, with links to
|
||||
additional details.
|
||||
* :ref:`overview_dev` describes the ACRN configuration process, with links to
|
||||
additional details.
|
||||
|
||||
* A follow-on :ref:`GSG_sample_app` tutorial shows how to
|
||||
configure, build, and run a more real-world sample application with a Real-time
|
||||
VM communicating with an HMI VM via inter-VM shared memory (IVSHMEM).
|
||||
|
Loading…
Reference in New Issue
Block a user