[PATCH wiki] Fix the typo and format problems.
Zhenyu Wang
zhenyuw at linux.intel.com
Tue Feb 28 02:37:58 UTC 2017
Pushed. Thanks!
On 2017.03.08 01:20:53 +0800, Terrence Xu wrote:
> Signed-off-by: Terrence Xu <terrence.xu at intel.com>
> ---
> GVTg_Setup_Guide.md | 109 +++++++++++++++++++++++++++++++++++-----------------
> 1 file changed, 73 insertions(+), 36 deletions(-)
>
> diff --git a/GVTg_Setup_Guide.md b/GVTg_Setup_Guide.md
> index 49c4356..8ee10f4 100644
> --- a/GVTg_Setup_Guide.md
> +++ b/GVTg_Setup_Guide.md
> @@ -50,7 +50,8 @@ A virtual GPU instance is maintained for each VM, with part of performance criti
>
> ## 2.3 Library Dependence ##
> Use Ubuntu as example, there are some software package needed by host environment setup, as below:
> -> apt-get install git libfdt-dev libpixman-1-dev libssl-dev vim socat libsdl1.2-dev libspice-server-dev autoconf libtool xtightvncviewer tightvncserver x11vnc libsdl1.2-dev uuid-runtime uuid uml-utilities bridge-utils
> +
> +> apt-get install git libfdt-dev libpixman-1-dev libssl-dev vim socat libsdl1.2-dev libspice-server-dev autoconf libtool xtightvncviewer tightvncserver x11vnc libsdl1.2-dev uuid-runtime uuid uml-utilities bridge-utils
>
>
> # 3 Host Environment Setup #
> @@ -64,8 +65,11 @@ Use Ubuntu as example, there are some software package needed by host environmen
> ### 3.2.1 Build the initrd (initial ramdisk) ###
> Use Ubuntu as example, modify /etc/initramfs-tools/modules, like below:
> > kvmgt
> +
> > vfio-iommu-type1
> +
> > vfio-mdev
> +
> For Fedora or RHEL you should make the similar changes in "dracut".
>
> ### 3.2.2 Build Kernel Source ###
> @@ -74,9 +78,10 @@ For Fedora or RHEL you should make the similar changes in "dracut".
>
> > cd gvt-linux
>
> ->git checkout gvt-stable-4.10
> +> git checkout gvt-stable-4.10
>
> > echo ""|make oldconfig
> +
> Then make sure to enable **CONFIG_DRM_I915_GVT** and **CONFIG_DRM_I915_GVT_KVMGT** in ".config", which depends on **CONFIG_VFIO_MDEV** and **CONFIG_VFIO_MDEV_DEVICE**.
>
> > make -j8 && make modules_install && make install
> @@ -93,15 +98,24 @@ Then build QEMU as follow:
> > git submodule update --init roms/seabios
>
> > ./configure --prefix=/usr \
> -> --enable-kvm \
> -> --disable-xen \
> -> --enable-debug-info \
> -> --enable-debug \
> -> --enable-sdl \
> -> --enable-vhost-net \
> -> --enable-spice \
> -> --disable-debug-tcg \
> -> --target-list=x86_64-softmmu
> +
> +> --enable-kvm \
> +
> +> --disable-xen \
> +
> +> --enable-debug-info \
> +
> +> --enable-debug \
> +
> +> --enable-sdl \
> +
> +> --enable-vhost-net \
> +
> +> --enable-spice \
> +
> +> --disable-debug-tcg \
> +
> +> --target-list=x86_64-softmmu
>
> > make -j8
>
> @@ -117,7 +131,7 @@ Then build QEMU as follow:
>
> ## 3.4 Grub Update ##
>
> -Make sure the “i915.enable_gvt=1” exist in host grub.cfg, use Ubuntu as example, as below:
> +Make sure the "i915.enable_gvt=1" exist in host grub.cfg, use Ubuntu as example, as below:
>
> menuentry 'GVT-g Upstream' --class kvmgt --class gnu-linux --class gnu --class os $menuentry_id_option 'gnulinux-simple-106518cd-fb74-4048-81de-3ecee7ad74d4' {
> recordfail
> @@ -161,16 +175,24 @@ We needs the special X11 configuration change for linux guest to use the Intel G
> Device "intel"
> EndSection
>
> -BTW: The PCI ID was chose by the “lspci”
> +BTW: The PCI ID was chose by the "lspci".
> > root at gvtg-host:~# lspci
> -00:00.0 Host bridge: Intel Corporation 440FX - 82441FX PMC [Natoma] (rev 02)
> -00:01.0 ISA bridge: Intel Corporation 82371SB PIIX3 ISA [Natoma/Triton II]
> -00:01.1 IDE interface: Intel Corporation 82371SB PIIX3 IDE [Natoma/Triton II]
> -00:01.2 USB controller: Intel Corporation 82371SB PIIX3 USB [Natoma/Triton II] (rev 01)
> -00:01.3 Bridge: Intel Corporation 82371AB/EB/MB PIIX4 ACPI (rev 03)
> -00:02.0 VGA compatible controller: Cirrus Logic GD 5446
> -00:03.0 Ethernet controller: Intel Corporation 82540EM Gigabit Ethernet Controller (rev 03)
> -00:04.0 VGA compatible controller: Intel Corporation Broadwell-U Integrated Graphics (rev 0a)
> +
> +> 00:00.0 Host bridge: Intel Corporation 440FX - 82441FX PMC [Natoma] (rev 02)
> +
> +> 00:01.0 ISA bridge: Intel Corporation 82371SB PIIX3 ISA [Natoma/Triton II]
> +
> +> 00:01.1 IDE interface: Intel Corporation 82371SB PIIX3 IDE [Natoma/Triton II]
> +
> +> 00:01.2 USB controller: Intel Corporation 82371SB PIIX3 USB [Natoma/Triton II] (rev 01)
> +
> +> 00:01.3 Bridge: Intel Corporation 82371AB/EB/MB PIIX4 ACPI (rev 03)
> +
> +> 00:02.0 VGA compatible controller: Cirrus Logic GD 5446
> +
> +> 00:03.0 Ethernet controller: Intel Corporation 82540EM Gigabit Ethernet Controller (rev 03)
> +
> +> 00:04.0 VGA compatible controller: Intel Corporation Broadwell-U Integrated Graphics (rev 0a)
>
> NOTICE: after you changed the display card to Intel GFX card, Qemu will comes to black screen, you only can see guest desktop by remote protocal.
>
> @@ -198,6 +220,7 @@ Use Ubuntu as example, to support X11VNC, you must install the xhost in guest fi
>
> After you completed the lightdm configuration, you can run the X11VNC service in guest as below:
> > x11vnc -storepasswd
> +
> > x11vnc -rfbauth ~/.vnc/passwd -display :0 -forever -bg -repeat -nowf -o ~/.vnc/x11vnc.log -rfbport 5900
>
> Then connect guest by host with guest X support by:
> @@ -213,7 +236,7 @@ Win7-32 / Win7-64 / Win8.1-64 /Win10-RS1-64 are validated.
> ### 4.2.2 Windows GFX Driver Support ###
> After you boot up Windows guest, you can see 2 GFX card in "Device manager" (One is the virtual GFX card "QXL" or "Cirrus", the other is Intel GFX card), then you must install the Intel GFX Windows for the Intel GFX card to support OpenCL / OpenGL / DirectX9 / DirectX10/ DirectX11 / DirectX12 hardware acceleration .
> You can get the Windows driver from Intel website: https://downloadcenter.intel.com/product/80939/Graphics-Drivers
> - Skylake: >= 15.45.14.4910
> + Skylake: >= 15.45.14.4590
> Broadwell: The driver has been published, will coming soon.
>
> NOTICE: after you installed Windows GFX driver, you can see guest desktop by both QEMU and remote protocal.
> @@ -228,34 +251,48 @@ All Windows Remote protocol are supported, such as TightVNC, HP RGS, RDP.
> ## 5.1 Check mdev Module ##
> After you boot up you host to GVT-g menuentry, you make sure the "mdev_supported_types" node with differenct vgpu type existed(The "V#ID" represent the corresponding platform, "V4" means it is "Broadwell" platform, "V5" means it is "Skylake" platform), the example as below
> > root at gvtg-host:~# ll /sys/bus/pci/devices/0000:00:02.0/mdev_supported_types/
> - total 0
> - drwxr-xr-x 5 root root 0 Apr 16 21:24 ./
> - drwxr-xr-x 12 root root 0 Apr 16 20:04 ../
> - drwxr-xr-x 3 root root 0 Apr 16 21:24 i915-GVTg_V4_1/ # This node max support 1 VM
> - drwxr-xr-x 3 root root 0 Apr 16 21:24 i915-GVTg_V4_2/ # This node max support 2 VMs
> - drwxr-xr-x 3 root root 0 Apr 16 21:24 i915-GVTg_V4_4/ # This node max support 4 VMs
> +
> +> total 0
> +
> +> drwxr-xr-x 5 root root 0 Apr 16 21:24 ./
> +
> +> drwxr-xr-x 12 root root 0 Apr 16 20:04 ../
> +
> +> drwxr-xr-x 3 root root 0 Apr 16 21:24 i915-GVTg_V4_1/ # This node max support 1 VM
> +
> +> drwxr-xr-x 3 root root 0 Apr 16 21:24 i915-GVTg_V4_2/ # This node max support 2 VMs
> +
> +> drwxr-xr-x 3 root root 0 Apr 16 21:24 i915-GVTg_V4_4/ # This node max support 4 VMs
>
> And you can check the detail description for each vgpu type,
>
> > root at gvtg-host:/sys/bus/pci/devices/0000:00:02.0/mdev_supported_types/i915-GVTg_V4_1# cat description
> - low_gm_size: 256MB
> - high_gm_size: 2048MB
> - fence: 4
> +
> +> low_gm_size: 256MB
> +
> +> high_gm_size: 2048MB
> +
> +> fence: 4
>
> ## 5.2 Generate the uuid for create VGPU ##
> Use Ubuntu as example, you can use the third-party tool to generate uuid like "uuid", "uuidgen", if we need to create 3 VM, we must create 3 uuid for 3 VGPU, like below:
> > root at gvtg-host:~# uuid -n 3
> - a297db4a-f4c2-11e6-90f6-d3b88d6c9525
> - a297de6a-f4c2-11e6-90f7-cb6a86ce449f
> - a297deec-f4c2-11e6-90f8-c39f1ae774e5
> +
> +> a297db4a-f4c2-11e6-90f6-d3b88d6c9525
> +
> +> a297de6a-f4c2-11e6-90f7-cb6a86ce449f
> +
> +> a297deec-f4c2-11e6-90f8-c39f1ae774e5
>
>
> ## 5.3 Create VGPU ##
> Use the uuid you generated to create VGPU, notes: if you want to boot up multi guests, you can use echo "uuid" > "/sys/bus/pci/devices/0000:00:02.0/mdev_supported_types/i915-GVTg_V#ID_#Type/create", like below:
>
> > echo "a297db4a-f4c2-11e6-90f6-d3b88d6c9525" > "/sys/bus/pci/devices/0000:00:02.0/ mdev_supported_types/i915-GVTg_V4_4/create"
> - echo "a297de6a-f4c2-11e6-90f7-cb6a86ce449f" > "/sys/bus/pci/devices/0000:00:02.0/ mdev_supported_types/i915-GVTg_V4_4/create"
> - echo "a297deec-f4c2-11e6-90f8-c39f1ae774e5" > "/sys/bus/pci/devices/0000:00:02.0/ mdev_supported_types/i915-GVTg_V4_4/create"
> +
> +> echo "a297de6a-f4c2-11e6-90f7-cb6a86ce449f" > "/sys/bus/pci/devices/0000:00:02.0/ mdev_supported_types/i915-GVTg_V4_4/create"
> +
> +> echo "a297deec-f4c2-11e6-90f8-c39f1ae774e5" > "/sys/bus/pci/devices/0000:00:02.0/ mdev_supported_types/i915-GVTg_V4_4/create"
>
> Then all the vgpu directory you created can be found at "/sys/bus/pci/devices/0000:00:02.0/"
>
> --
> 2.7.4
>
> _______________________________________________
> intel-gvt-dev mailing list
> intel-gvt-dev at lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/intel-gvt-dev
--
Open Source Technology Center, Intel ltd.
$gpg --keyserver wwwkeys.pgp.net --recv-keys 4D781827
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 163 bytes
Desc: not available
URL: <https://lists.freedesktop.org/archives/intel-gvt-dev/attachments/20170228/70372565/attachment-0001.sig>
More information about the intel-gvt-dev
mailing list