Date: Mon, 11 Feb 2019 18:15:48 +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: r52813 - head/en_US.ISO8859-1/books/handbook/virtualization Message-ID: <201902111815.x1BIFmBN025464@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: bcr Date: Mon Feb 11 18:15:48 2019 New Revision: 52813 URL: https://svnweb.freebsd.org/changeset/doc/52813 Log: Update the Xen chapter to support newer versions of Xen. This patch clarifies which versions of FreeBSD support Xen 4.7 (PVHv1) and Xen 4.11 or greater (PVHv2). Additionally, improve a few of the instructions. Use onifconsole for Xen, add a line to loader.conf to load the tap device. Remove restrictions to use MMCFG PCI accesses for Xen >= 4.11. Make /var/log/xen stand out a bit more by making it a tip. Finally, the example guest was creating a 10.3 version of FreeBSD, which is no longer supported. Update that to 12.0 and wrap it in replaceable tags so that people know they can put something else there. Big thanks to royger@ for the updates and doing the documentation work before I had a chance to do it. Submitted by: royger@ Reported by: freebsd-xen mailinglist Approved by: bcr@ Differential Revision: https://reviews.freebsd.org/D19106 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 Mon Feb 11 12:31:11 2019 (r52812) +++ head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml Mon Feb 11 18:15:48 2019 (r52813) @@ -1452,9 +1452,9 @@ kld_list="nmdm vmm"</programlisting> <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 + based on Xen version 4.7. Systems running on &os;-12.0 or + newer 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 @@ -1483,7 +1483,7 @@ kld_list="nmdm vmm"</programlisting> <para>Add an entry for the &xen; console to <filename>/etc/ttys</filename>:</para> - <screen>&prompt.root; <userinput>echo 'xc0 "/usr/libexec/getty Pc" xterm on secure' >> /etc/ttys</userinput></screen> + <screen>&prompt.root; <userinput>echo 'xc0 "/usr/libexec/getty Pc" xterm onifconsole secure' >> /etc/ttys</userinput></screen> <para>Selecting a &xen; kernel in <filename>/boot/loader.conf</filename> activates the Dom0. @@ -1498,24 +1498,24 @@ kld_list="nmdm vmm"</programlisting> <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 if_tap_load="YES"</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> + <screen>&prompt.root; <userinput>sysrc -f /boot/loader.conf if_tap_load="YES"</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 - created.</para> + <tip> + <para>Log files that &xen; creates for the DomU VMs + are stored in <filename>/var/log/xen</filename>. Please + be sure to check the contents of that directory if + experiencing issues.</para> + </tip> - <screen>&prompt.root; <userinput>mkdir -p /var/log/xen</userinput> -&prompt.root; <userinput>chmod 644 /var/log/xen</userinput></screen> - <para>&xen; provides a boot menu to activate and de-activate the hypervisor on demand in <filename>/boot/menu.rc.local</filename>:</para> @@ -1576,7 +1576,7 @@ Domain-0 0 8192 retrieved with &man.fetch.1; and saved locally in a file called <filename>freebsd.iso</filename>.</para> - <screen>&prompt.root; <userinput>fetch <replaceable>ftp://ftp.freebsd.org/pub/FreeBSD/releases/ISO-IMAGES/10.3/FreeBSD-10.3-RELEASE-amd64-bootonly.iso</replaceable>; -o <replaceable>freebsd.iso</replaceable></userinput></screen> + <screen>&prompt.root; <userinput>fetch <replaceable>ftp://ftp.freebsd.org/pub/FreeBSD/releases/ISO-IMAGES/<replaceable>12.0</replaceable>/FreeBSD-<replaceable>12.0</replaceable>-RELEASE-amd64-bootonly.iso</replaceable>; -o <replaceable>freebsd.iso</replaceable></userinput></screen> <para>A ZFS volume of 20 GB called <filename>xendisk0</filename> is created to serve as the disk
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201902111815.x1BIFmBN025464>