1
1
.. _using_windows_as_uos :
2
2
3
- Using Windows as Guest OS on ACRN
3
+ Using Windows as Guest VM on ACRN
4
4
#################################
5
- This tutorial describes how to launch Windows as the Guest OS on the ACRN hypervisor.
5
+ This tutorial describes how to launch Windows as a Guest (WaaG) VM on the ACRN hypervisor.
6
6
7
7
Hardware setup
8
8
**************
@@ -14,13 +14,13 @@ The following Intel Kaby Lake NUCs are verified:
14
14
"NUC7i7DNHE", "DNKBLi7v.86A.0052.2018.0808.1344", "`link <https://downloadcenter.intel.com/download/28886?v=t >`__"
15
15
"NUC7i5DNHE", "DNKBLi5v.86A.0060.2018.1220.1536", "`link <https://downloadcenter.intel.com/download/28885?v=t >`__"
16
16
17
- ACRN Service OS Setup
17
+ ACRN Service VM Setup
18
18
*********************
19
19
You may refer to the steps in :ref: `getting-started-apl-nuc ` for
20
20
Intel NUC to set up ACRN on the KBL NUC. After following the steps in that guide,
21
- you should be able to launch a Clear Linux UOS successfully.
21
+ you should be able to launch the Service VM successfully.
22
22
23
- Setup for Using Windows as Guest OS
23
+ Setup for Using Windows as Guest VM
24
24
***********************************
25
25
All the patches to support WaaG have been upstreamed; you can download them
26
26
from the acrn-hypervisor repository.
@@ -41,14 +41,14 @@ Build ACRN EFI Images
41
41
42
42
#. Replace the ``acrn.efi `` and ``acrn-dm `` on your NUC:
43
43
44
- a. Log in to the ACRN Service OS and then ``mount `` the EFI partition to ``/boot ``
44
+ a. Log in to the ACRN Service VM and then ``mount `` the EFI partition to ``/boot ``
45
45
#. ``scp `` the ``acrn.efi `` and ``acrn-dm `` from your host::
46
46
47
47
# scp <acrn.efi from your host> /boot/EFI/acrn/
48
48
# scp <acrn-dm from your host> /usr/bin/
49
49
# chmod +x /usr/bin/acrn-dm && sync
50
50
51
- Build Service OS Kernel
51
+ Build Service VM Kernel
52
52
=======================
53
53
#. Follow the steps described at :ref: `getting-started-building ` to set up the build environment.
54
54
#. Follow the steps below to build the ACRN kernel::
@@ -73,13 +73,13 @@ Update Kernel on KBL NUC
73
73
74
74
.. code-block :: none
75
75
76
- title The ACRNGT Service OS
76
+ title The ACRNGT Service VM
77
77
linux /bzImage
78
78
options console=tty0 console=ttyS0 root=/dev/sda3 rw rootwait ignore_loglevel no_timer_check consoleblank=0 i915.nuclear_pageflip=1 i915.avail_planes_per_pipe=0x010101 i915.domain_plane_owners=0x011100001111 i915.enable_gvt=1 i915.enable_conformance_check=0 i915.enable_guc=0 hvlog=2M@0x1FE00000
79
79
80
80
.. note :: Change ``/dev/sda3`` to your file system partition.
81
81
82
- #. ``reboot `` the Service OS and select ``The ACRNGT Service OS `` from the boot menu to apply
82
+ #. ``reboot `` the Service VM and select ``The ACRNGT Service VM `` from the boot menu to apply
83
83
the ACRN kernel and hypervisor updates.
84
84
85
85
Create Windows 10 Image
@@ -103,7 +103,7 @@ Preparations
103
103
104
104
* Download `virtio Windows driver
105
105
<https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/archive-virtio/virtio-win-0.1.141-1/virtio-win-0.1.141.iso> `_
106
- to the Service OS in ``/root/img/virtio-win-0.1.141.iso ``.
106
+ to the Service VM in ``/root/img/virtio-win-0.1.141.iso ``.
107
107
108
108
* Download `Intel DCH Graphics Driver <https://downloadmirror.intel.com/28148/a08/dch_win64_25.20.100.6444.exe >`_.
109
109
@@ -252,7 +252,7 @@ Pre-install drivers and re-generate Windows ISO
252
252
253
253
Create Raw Disk
254
254
---------------
255
- Run these commands on the Service OS ::
255
+ Run these commands on the Service VM ::
256
256
257
257
# swupd bundle-add kvm-host
258
258
# mkdir /root/img
@@ -268,7 +268,7 @@ version is used to install Windows 10 on ACRN from scratch. The
268
268
<https://raw.githubusercontent.com/projectacrn/acrn-hypervisor/master/doc/tutorials/install_by_vga_gsg.tar.gz> `_
269
269
together with the script used to install Windows 10.
270
270
271
- #. Uncompress ``install_by_vga_gsg.tar.gz `` to the Service OS ::
271
+ #. Uncompress ``install_by_vga_gsg.tar.gz `` to the Service VM ::
272
272
273
273
# tar zxvf install_by_vga_gsg.tar.gz && cd install_by_vga_gsg
274
274
@@ -335,8 +335,12 @@ together with the script used to install Windows 10.
335
335
336
336
Boot Windows with GVT-g on ACRN
337
337
===============================
338
- #. Launch the Windows Guest using the ``launch_igx-waag.sh ``. You should see the WaaG desktop
339
- coming up over the HDMI monitor (instead of the VNC).
338
+ #. Modify the ``/usr/share/acrn/samples/nuc/launch_win.sh `` script to specify the Windows image generated above.
339
+
340
+ #. Download `OVMF.fd <https://raw.githubusercontent.com/projectacrn/acrn-hypervisor/master/doc/tutorials/OVMF.fd >`_
341
+ binary to the directory in Service VM: ``/usr/share/acrn/samples/nuc/ ``.
342
+
343
+ #. Run the ``launch_win.sh `` and you should see the WaaG desktop coming up over the HDMI monitor (instead of the VNC).
340
344
341
345
.. note :: Use the following command to disable the GNOME Display Manager (GDM) if it is enabled::
342
346
@@ -345,9 +349,10 @@ Boot Windows with GVT-g on ACRN
345
349
.. note :: You must connect two monitors to the KBL NUC in order to launch Windows with
346
350
the default configurations above.
347
351
348
- .. note :: The second monitor must include the Weston desktop. If you have set up Weston in the Service OS ,
352
+ .. note :: The second monitor must include the Weston desktop. If you have set up Weston in the Service VM ,
349
353
follow the steps in :ref: `skl-nuc-gpu-passthrough ` to set up Weston as
350
- the desktop environment in SOS in order to experience Windows with the AcrnGT local display feature.
354
+ the desktop environment in Service VM in order to experience Windows with the AcrnGT local display feature.
355
+
351
356
352
357
ACRN Windows verified feature list
353
358
**********************************
@@ -398,11 +403,12 @@ Device configurations of acrn-dm command line
398
403
This is for the network virtualization.
399
404
400
405
* *-s 5,fbuf,tcp=0.0.0.0:5900,w=800,h=600 *:
401
- This will open a port 5900 on SOS which can be connected to via vncviewer.
406
+ This will open a port 5900 on Service VM which can be connected to via vncviewer.
402
407
403
408
* *-s 6,virtio-input,/dev/input/event4 *:
404
409
This is to passthrough the mouse/keyboard to Windows via virtio.
405
- Please change ``event4 `` accordingly. You can use the following command to check the event node on your SOS::
410
+ Please change ``event4 `` accordingly. You can use the following command to check
411
+ the event node on your Service VM::
406
412
407
413
<To get the input event of mouse>
408
414
# cat /proc/bus/input/devices | grep mouse
0 commit comments