svn commit: r52081 - head/en_US.ISO8859-1/books/handbook/virtualization

[Benedict Reuschling]

Author: bcr
Date: Mon Aug  6 15:54:55 2018
New Revision: 52081
URL: https://svnweb.freebsd.org/changeset/doc/52081

Log:
  The emulators/xen package does not exist anymore and there are two versions
  now. One is for Xen 4.7, intended for FreeBSD 11. The other is for -CURRENT
  and uses a more modern Xen 4.11. Adjust the description and examples to
  differentiate the two.
  The old 4.7 packages use dom0pvh=1 on the commandline, while Xen 4.11 is
  using dom0=pvh. Adjust those two as well for the supported FreeBSD versions.
  
  Submitted by:		royger@
  Reviewed by:		royger@
  Differential Revision:	https://reviews.freebsd.org/D16590

Modified:
  head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml	Sun Aug  5 09:36:00 2018	(r52080)
+++ head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml	Mon Aug  6 15:54:55 2018	(r52081)
@@ -1432,21 +1432,20 @@ kld_list="nmdm vmm"</programlisting>
     <sect2 xml:id="virtualization-host-xen-dom0-setup">
       <title>&xen; Dom0 Control Domain Setup</title>
 
-      <para>The <package>emulators/xen</package> package works with
-	&os; 11 amd64 binary snapshots and equivalent systems
-	built from source.  This example assumes VNC output for
-	unprivileged domains which is accessed from a another system
-	using a tool such as <package>net/tightvnc</package>.</para>
+      <para>Users of &os; 11 should install the
+	<package>emulators/xen-kernel47</package> and
+	<package>sysutils/xen-tools47</package> packages that are
+	based on Xen version 4.7.  Systems running on &os;-CURRENT
+	with at least revision r336475 or higher, can use Xen 4.11
+	provided by <package>emulators/xen-kernel411</package> and
+	<package>sysutils/xen-tools411</package>, respectively.</para>
 
-      <para>Install <package>emulators/xen</package>:</para>
-
-      <screen>&prompt.root; <userinput>pkg install xen</userinput></screen>
-
       <para>Configuration files must be edited to prepare the host
-	for the Dom0 integration.  An entry to
-	<filename>/etc/sysctl.conf</filename> disables the limit on
-	how many pages of memory are allowed to be wired.  Otherwise,
-	DomU VMs with higher memory requirements will not run.</para>
+	for the Dom0 integration after the Xen packages are installed.
+	An entry to <filename>/etc/sysctl.conf</filename> disables the
+	limit on how many pages of memory are allowed to be wired.
+	Otherwise, DomU VMs with higher memory requirements will not
+	run.</para>
 
       <screen>&prompt.root; <userinput>sysrc -f /etc/sysctl.conf vm.max_wired=-1</userinput></screen>
 
@@ -1479,9 +1478,18 @@ kld_list="nmdm vmm"</programlisting>
 	console is also activated and logging options are
 	defined.</para>
 
+      <para>The following command is used for Xen 4.7 packages:</para>
+
       <screen>&prompt.root; <userinput>sysrc -f /boot/loader.conf hw.pci.mcfg=0</userinput>
 &prompt.root; <userinput>sysrc -f /boot/loader.conf xen_kernel="/boot/xen"</userinput>
 &prompt.root; <userinput>sysrc -f /boot/loader.conf xen_cmdline="dom0_mem=<replaceable>8192M</replaceable> dom0_max_vcpus=<replaceable>4</replaceable> dom0pvh=1 console=com1,vga com1=115200,8n1 guest_loglvl=all loglvl=all"</userinput></screen>
+
+      <para>For Xen versions 4.11 and higher, the following command
+	should be used instead:</para>
+
+      <screen>&prompt.root; <userinput>sysrc -f /boot/loader.conf hw.pci.mcfg=0</userinput>
+&prompt.root; <userinput>sysrc -f /boot/loader.conf xen_kernel="/boot/xen"</userinput>
+&prompt.root; <userinput>sysrc -f /boot/loader.conf xen_cmdline="dom0_mem=<replaceable>8192M</replaceable> dom0_max_vcpus=<replaceable>4</replaceable> dom0=pvh console=com1,vga com1=115200,8n1 guest_loglvl=all loglvl=all"</userinput></screen>
 
 	<para>Log files that &xen; creates for the Dom0 and DomU VMs
 	  are stored in <filename>/var/log/xen</filename>.  This