mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2025-06-18 19:57:31 +00:00
Doc: Grammatical edits to using_windows_as_uos.rst
Signed-off-by: Deb Taylor <deb.taylor@intel.com>
This commit is contained in:
Deb Taylor
deb-intel
parent
b9bf38e8a0
commit
ddb18283a2
@ -3,7 +3,8 @@
|
||||
|
||||
Using Windows as Guest VM on ACRN
|
||||
#################################
|
||||
This tutorial describes how to launch Windows as a Guest (WaaG) VM on the ACRN hypervisor.
|
||||
This tutorial describes how to launch Windows as a Guest (WaaG) VM on the
|
||||
ACRN hypervisor.
|
||||
|
||||
Verified version
|
||||
****************
|
||||
@ -28,17 +29,17 @@ The following Intel Kaby Lake NUCs are verified:
|
||||
|
||||
"NUC7i7DNHE", "DNKBLi7v.86A.0052.2018.0808.1344", "`link <https://downloadcenter.intel.com/download/28886?v=t>`__"
|
||||
"NUC7i5DNHE", "DNKBLi5v.86A.0060.2018.1220.1536", "`link <https://downloadcenter.intel.com/download/28885?v=t>`__"
|
||||
|
||||
|
||||
ACRN Service VM Setup
|
||||
*********************
|
||||
You may refer to the steps in :ref:`kbl-nuc-sdc` for the
|
||||
Intel NUC in order to set up ACRN on the KBL NUC. After following the steps in that guide,
|
||||
you should be able to launch the Service VM successfully.
|
||||
If necessary, refer to the steps in :ref:`kbl-nuc-sdc` to set up ACRN on the
|
||||
KBL NUC. Once complete, you should be able to launch the Service VM
|
||||
successfully.
|
||||
|
||||
Setup for Using Windows as Guest VM
|
||||
***********************************
|
||||
All the patches to support WaaG have been upstreamed; you can download them
|
||||
from the acrn-hypervisor repository.
|
||||
Setup for Using Windows as the Guest VM
|
||||
***************************************
|
||||
All patches to support WaaG have been upstreamed; download them from the
|
||||
``acrn-hypervisor repository``.
|
||||
|
||||
Build ACRN EFI Images
|
||||
=====================
|
||||
@ -49,7 +50,7 @@ Build ACRN EFI Images
|
||||
$ cd acrn-hypervisor
|
||||
$ make FIRMWARE=uefi BOARD=kbl-nuc-i7
|
||||
|
||||
#. Get the outputs from::
|
||||
#. Get the outputs from the following::
|
||||
|
||||
$ build/hypervisor/acrn.efi
|
||||
$ build/devicemodel/acrn-dm
|
||||
@ -63,9 +64,10 @@ Build ACRN EFI Images
|
||||
# scp <acrn-dm from your host> /usr/bin/
|
||||
# chmod +x /usr/bin/acrn-dm && sync
|
||||
|
||||
Build Service VM Kernel
|
||||
=======================
|
||||
#. Follow the steps described at :ref:`getting-started-building` to set up the build environment.
|
||||
Build the Service VM Kernel
|
||||
===========================
|
||||
#. Follow the steps described at :ref:`getting-started-building` to set up
|
||||
the build environment.
|
||||
#. Follow the steps below to build the ACRN kernel::
|
||||
|
||||
$ WORKDIR=`pwd`;
|
||||
@ -76,15 +78,15 @@ Build Service VM Kernel
|
||||
$ make olddefconfig O=${WORKDIR}/build && make -j${JOBS} O=${WORKDIR}/build
|
||||
$ make modules_install INSTALL_MOD_PATH=${WORKDIR}/build-rootfs O=${WORKDIR}/build -j${JOBS}
|
||||
|
||||
Update Kernel on KBL NUC
|
||||
========================
|
||||
Update the Kernel on KBL NUC
|
||||
============================
|
||||
#. Copy the new kernel image (bzImage) and its modules to the target machine::
|
||||
|
||||
# scp <your host>:$WORKDIR/build/arch/x86/boot/bzImage /boot/bzImage
|
||||
# scp -r <your host>:$WORKDIR/build-rootfs/lib/modules/* /lib/modules/
|
||||
# cp /boot/loader/entries/acrn.conf /boot/loader/entries/acrngt.conf
|
||||
|
||||
#. Modify ``acrngt.conf`` to the content as given below:
|
||||
#. Modify ``acrngt.conf`` to the content as shown below:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
@ -94,31 +96,31 @@ Update Kernel on KBL NUC
|
||||
|
||||
.. note:: Change ``/dev/sda3`` to your file system partition.
|
||||
|
||||
#. ``reboot`` the Service VM and select ``The ACRNGT Service VM`` from the boot menu to apply
|
||||
the ACRN kernel and hypervisor updates.
|
||||
#. ``reboot`` the Service VM and select ``The ACRNGT Service VM`` from the
|
||||
boot menu to apply the ACRN kernel and hypervisor updates.
|
||||
|
||||
Create Windows 10 Image in Service VM
|
||||
=====================================
|
||||
Create a Windows 10 image is to install Windows 10 onto the virtual disk.
|
||||
Create a Windows 10 image to install Windows 10 onto a virtual disk.
|
||||
|
||||
Download Win10 ISO and Drivers
|
||||
------------------------------
|
||||
* Download `Windows 10 LTSC ISO <https://www.microsoft.com/en-us/evalcenter/evaluate-windows-10-enterprise>`_.
|
||||
* Select ISO-LTSC, then continue.
|
||||
* Complete the required info then continue.
|
||||
* Select language and "x86 64 bit", click to download ISO and save as "windows10-LTSC-17763.iso".
|
||||
|
||||
* Download `Intel DCH Graphics Driver <https://downloadmirror.intel.com/29074/a08/igfx_win10_100.7212.zip>`_.
|
||||
* Select **ISO-LTSC**, then click **Continue**.
|
||||
* Complete the required info then click **Continue**.
|
||||
* Select the language and **x86 64 bit**, then click **Download ISO** and save as ``windows10-LTSC-17763.iso``.
|
||||
|
||||
* Download `Oracle Windows driver <https://edelivery.oracle.com/osdc/faces/SoftwareDelivery>`_.
|
||||
* Sign in. If you do not have an oracle account, register one.
|
||||
* Select "Download Package", key in "Oracle Linux 7.6" and click "Search"
|
||||
* Click: DLP: Oracle Linux 7.6, it will be added to your Cart.
|
||||
* Click "Checkout" at the top right corner
|
||||
* In the "Platforms/Language", select "x86 64 bit", click "Continue"
|
||||
* Check " I accept the terms in the license agreement", click "Continue"
|
||||
* In the list, right check the item labeled as "Oracle VirtIO Drivers Version for Microsoft Windows 1.x.x, yy MB", and "Save link as ...". At the time of this wiki, it is named as "V982789-01.zip"
|
||||
* Click Download, When the download is complete, unzip, you will get one ISO named "winvirtio.iso"
|
||||
* Download the `Intel DCH Graphics Driver <https://downloadmirror.intel.com/29074/a08/igfx_win10_100.7212.zip>`_.
|
||||
|
||||
* Download the `Oracle Windows driver <https://edelivery.oracle.com/osdc/faces/SoftwareDelivery>`_.
|
||||
* Sign in. If you do not have an Oracle account, register for one.
|
||||
* Select **Download Package**. Key in **Oracle Linux 7.6** and click **Search**.
|
||||
* Click **DLP: Oracle Linux 7.6**; it will be added to your Cart.
|
||||
* Click **Checkout** which is located at the top right corner.
|
||||
* Under **Platforms/Language**, select **x86 64 bit**, and click **Continue**.
|
||||
* Check **I accept the terms in the license agreement**; click **Continue**.
|
||||
* In the list, right check the item labeled **Oracle VirtIO Drivers Version for Microsoft Windows 1.x.x, yy MB**, and then **Save link as ...**. Currently, it is named **V982789-01.zip**.
|
||||
* Click **Download**. When the download is complete, unzip the file. You will see an ISO named **winvirtio.iso**.
|
||||
|
||||
Create Raw Disk
|
||||
---------------
|
||||
@ -141,7 +143,7 @@ Prepare Script to Create Image
|
||||
|
||||
- Change ``-s 3,virtio-blk,./win10-ltsc.img`` to your path to the Windows 10 image.
|
||||
|
||||
- Add ``-s 6,xhci,1-5:1-9``. You may need to change 1-5:1-9 to match the ports of USB keyboard/Mouse and flash of your platform.
|
||||
- Add ``-s 6,xhci,1-5:1-9``. You may need to change 1-5:1-9 to match the ports of the USB keyboard/Mouse and flash on your platform.
|
||||
|
||||
- Add ``-s 8,ahci,cd:./windows10-LTSC-17763.iso`` to point to the Win10 ISO.
|
||||
|
||||
@ -151,12 +153,12 @@ Install Windows 10
|
||||
------------------
|
||||
.. note:: Make sure you have configured your monitor and display according to **3** of
|
||||
:ref:`Boot Windows with GVT-g on ACRN <waag_display_conf_lable>`.
|
||||
|
||||
#. Run ``install_win.sh``, then you will see UEFI shell, input "exit".
|
||||
|
||||
#. Select "Boot Manager", and boot up from Win10 ISO.
|
||||
#. Run ``install_win.sh``. When you see the UEFI shell, input **exit**.
|
||||
|
||||
#. When the display reads "Press any key to boot from CD or DVD" on the monitor, press any key in the terminal on the
|
||||
#. Select **Boot Manager** and boot up from Win10 ISO.
|
||||
|
||||
#. When the display reads **Press any key to boot from CD or DVD** on the monitor, press any key in the terminal on the
|
||||
**Host** side.
|
||||
|
||||
.. figure:: images/windows_install_1.png
|
||||
@ -173,8 +175,10 @@ Install Windows 10
|
||||
.. figure:: images/windows_install_4.png
|
||||
:align: center
|
||||
|
||||
#. Click :kbd:`Browser` and go to the drive which includes the virtio win drivers. Select all in **viostor\\w10\\amd64**
|
||||
and install the following all drivers into the image:
|
||||
#. Click **Browser** and go to the drive that includes the virtio win
|
||||
drivers. Select **all** under **viostor\\w10\\amd64**. Install the
|
||||
following drivers into the image:
|
||||
|
||||
- Virtio-balloon
|
||||
- Virtio-net
|
||||
- Virtio-rng
|
||||
@ -182,13 +186,13 @@ Install Windows 10
|
||||
- Virtio-serial
|
||||
- Virtio-block
|
||||
- Virtio-input
|
||||
|
||||
.. note:: Make sure you have unselected "Hide Drivers that aren't compatible with this computer's hardware" in the bottom.
|
||||
|
||||
.. note:: Be sure to unselect **Hide Drivers that aren't compatible with this computer's hardware** near the bottom of the page.
|
||||
|
||||
.. figure:: images/windows_install_5.png
|
||||
:align: center
|
||||
|
||||
#. Click :kbd:`Next`.
|
||||
#. Click **Next**.
|
||||
|
||||
.. figure:: images/windows_install_6.png
|
||||
:align: center
|
||||
@ -208,16 +212,15 @@ Install Windows 10
|
||||
.. figure:: images/windows_install_9.png
|
||||
:align: center
|
||||
|
||||
.. note:: You must connect two monitors to the KBL NUC in order to launch Windows with
|
||||
the default configurations above.
|
||||
.. note:: You must connect two monitors to the KBL NUC in order to launch Windows with the default configurations above.
|
||||
|
||||
#. The Windows installation is completed after a few configuration steps, and you get to the Windows desktop.
|
||||
#. The Windows installation is completed after a few configuration steps; the Windows desktop displays.
|
||||
|
||||
.. figure:: images/windows_install_10.png
|
||||
:align: center
|
||||
|
||||
|
||||
#. Copy `Intel DCH Graphics Driver <https://downloadmirror.intel.com/29074/a08/igfx_win10_100.7212.zip>`_ into the Windows and install, display driver is updated to 7212.
|
||||
#. Copy `Intel DCH Graphics Driver <https://downloadmirror.intel.com/29074/a08/igfx_win10_100.7212.zip>`_ into Windows and install; the display driver is updated to 7212.
|
||||
|
||||
.. _waag_display_conf_lable:
|
||||
|
||||
@ -225,18 +228,18 @@ Boot Windows with GVT-g on ACRN
|
||||
===============================
|
||||
#. Modify the ``/usr/share/acrn/samples/nuc/launch_win.sh`` script to specify the Windows image generated above.
|
||||
|
||||
#. Run the ``launch_win.sh`` and you should see the WaaG desktop coming up over the HDMI monitor.
|
||||
#. Run the ``launch_win.sh``. The WaaG desktop displays on the HDMI monitor.
|
||||
|
||||
.. note:: Use the following command to disable the GNOME Display Manager (GDM) if it is enabled::
|
||||
|
||||
# sudo systemctl mask gdm.service
|
||||
|
||||
.. note:: You must connect two monitors to the KBL NUC in order to launch Windows with
|
||||
the default configurations above.
|
||||
|
||||
.. note:: The second monitor must include the Weston desktop. If you have set up Weston in the Service VM,
|
||||
follow the steps in :ref:`skl-nuc-gpu-passthrough` to set up Weston as
|
||||
the desktop environment in Service VM in order to experience Windows with the AcrnGT local display feature.
|
||||
.. note:: You must connect two monitors to the KBL NUC in order to launch
|
||||
Windows with the default configurations above. The second monitor must
|
||||
include the Weston desktop. If you have set up Weston in the Service
|
||||
VM, follow the steps in :ref:`skl-nuc-gpu-passthrough` to set up
|
||||
Weston as the desktop environment in the Service VM to
|
||||
experience Windows with the AcrnGT local display feature.
|
||||
|
||||
|
||||
ACRN Windows verified feature list
|
||||
@ -270,7 +273,7 @@ Known Limitations
|
||||
Explanation for acrn-dm popular command lines
|
||||
*********************************************
|
||||
|
||||
.. note:: You can use those acrn-dm command lines according to your real requirements.
|
||||
.. note:: You can use these acrn-dm command lines according to your real requirements.
|
||||
|
||||
* *-s 3,ahci,hd:/root/img/win10.img*:
|
||||
This is the hard disk onto which to install Windows 10.
|
||||
@ -280,38 +283,39 @@ Explanation for acrn-dm popular command lines
|
||||
This is for the network virtualization.
|
||||
|
||||
* *-s 5,fbuf,tcp=0.0.0.0:5900,w=800,h=600*:
|
||||
This will open a port 5900 on Service VM which can be connected to via vncviewer.
|
||||
This opens a port 5900 on the Service VM which can be connected to via vncviewer.
|
||||
|
||||
* *-s 6,virtio-input,/dev/input/event4*:
|
||||
This is to passthrough the mouse/keyboard to Windows via virtio.
|
||||
Please change ``event4`` accordingly. You can use the following command to check
|
||||
Change ``event4`` accordingly. Use the following command to check
|
||||
the event node on your Service VM::
|
||||
|
||||
<To get the input event of mouse>
|
||||
# cat /proc/bus/input/devices | grep mouse
|
||||
|
||||
* *-s 7,ahci,cd:/root/img/Windows10.iso*:
|
||||
This is the IOS image used to install Windows 10. It appears as a cdrom device.
|
||||
Make sure that the slot ID 7 points to your win10 ISO path.
|
||||
This is the IOS image used to install Windows 10. It appears as a cdrom
|
||||
device. Make sure that the slot ID 7 points to your win10 ISO path.
|
||||
|
||||
* *-s 8,ahci,cd:/root/img/winvirtio.iso*:
|
||||
* *-s 8,ahci,cd:/root/img/winvirtio.iso*:
|
||||
This is cdrom device to install the virtio Windows driver. Make sure it points to your VirtIO ISO path.
|
||||
|
||||
* *-s 9,passthru,0/14/0*:
|
||||
This is to passthrough USB controller to Windows.
|
||||
You may need to change 0/14/0 to match bdf of the USB controller of your platform.
|
||||
You may need to change 0/14/0 to match the bdf of the USB controller on
|
||||
your platform.
|
||||
|
||||
* *--ovmf /usr/share/acrn/bios/OVMF.fd*:
|
||||
Make sure it points to your OVMF binary path
|
||||
Make sure it points to your OVMF binary path.
|
||||
|
||||
Secure boot enabling
|
||||
********************
|
||||
You may refer to the steps in :ref:`How-to-enable-secure-boot-for-windows` for
|
||||
Refer to the steps in :ref:`How-to-enable-secure-boot-for-windows` for
|
||||
secure boot enabling.
|
||||
|
||||
Activate Windows 10
|
||||
********************
|
||||
If you are using a trial version of Windows 10, you may find that some apps and features do not work or that Windows 10 get automatically shut down by the Windows licensing monitoring service. To avoid these issues, obtain a licensed version of Windows.
|
||||
If you are using a trial version of Windows 10, you may find that some apps and features do not work or that Windows 10 automatically gets shut down by the Windows licensing monitoring service. To avoid these issues, obtain a licensed version of Windows.
|
||||
|
||||
For Windows 10 activation steps, refer to "`Activate Windows 10 <https://support.microsoft.com/en-us/help/12440/windows-10-activate>`__"
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user