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
This commit is contained in:
Benedict Reuschling 2018-08-06 15:54:55 +00:00
parent 78da43ac93
commit c4c50e5c5d
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=52081

View file

@ -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>Install <package>emulators/xen</package>:</para>
<screen>&prompt.root; <userinput>pkg install xen</userinput></screen>
<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>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,10 +1478,19 @@ 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
directory does not exist by default and must be