Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 6 Aug 2018 15:54:56 +0000 (UTC)
From:      Benedict Reuschling <bcr@FreeBSD.org>
To:        doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org
Subject:   svn commit: r52081 - head/en_US.ISO8859-1/books/handbook/virtualization
Message-ID:  <201808061554.w76FsubR057718@repo.freebsd.org>

next in thread | raw e-mail | index | archive | help
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;&nbsp;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;&nbsp;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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201808061554.w76FsubR057718>