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"> <sect2 xml:id="virtualization-host-xen-dom0-setup">
<title>&xen; Dom0 Control Domain Setup</title> <title>&xen; Dom0 Control Domain Setup</title>
<para>The <package>emulators/xen</package> package works with <para>Users of &os;&nbsp;11 should install the
&os;&nbsp;11 amd64 binary snapshots and equivalent systems <package>emulators/xen-kernel47</package> and
built from source. This example assumes VNC output for <package>sysutils/xen-tools47</package> packages that are
unprivileged domains which is accessed from a another system based on Xen version 4.7. Systems running on &os;-CURRENT
using a tool such as <package>net/tightvnc</package>.</para> with at least revision r336475 or higher, can use Xen 4.11
provided by <package>emulators/xen-kernel411</package> and
<para>Install <package>emulators/xen</package>:</para> <package>sysutils/xen-tools411</package>, respectively.</para>
<screen>&prompt.root; <userinput>pkg install xen</userinput></screen>
<para>Configuration files must be edited to prepare the host <para>Configuration files must be edited to prepare the host
for the Dom0 integration. An entry to for the Dom0 integration after the Xen packages are installed.
<filename>/etc/sysctl.conf</filename> disables the limit on An entry to <filename>/etc/sysctl.conf</filename> disables the
how many pages of memory are allowed to be wired. Otherwise, limit on how many pages of memory are allowed to be wired.
DomU VMs with higher memory requirements will not run.</para> 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> <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 console is also activated and logging options are
defined.</para> 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> <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_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> &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 <para>Log files that &xen; creates for the Dom0 and DomU VMs
are stored in <filename>/var/log/xen</filename>. This are stored in <filename>/var/log/xen</filename>. This
directory does not exist by default and must be directory does not exist by default and must be