From owner-svn-doc-all@freebsd.org Mon Feb 11 18:15:49 2019 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 2FAC414DFA40; Mon, 11 Feb 2019 18:15:49 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id A20B183139; Mon, 11 Feb 2019 18:15:48 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 8A91E3B21; Mon, 11 Feb 2019 18:15:48 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id x1BIFmVM025465; Mon, 11 Feb 2019 18:15:48 GMT (envelope-from bcr@FreeBSD.org) Received: (from bcr@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id x1BIFmBN025464; Mon, 11 Feb 2019 18:15:48 GMT (envelope-from bcr@FreeBSD.org) Message-Id: <201902111815.x1BIFmBN025464@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bcr set sender to bcr@FreeBSD.org using -f From: Benedict Reuschling Date: Mon, 11 Feb 2019 18:15:48 +0000 (UTC) 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 X-SVN-Group: doc-head X-SVN-Commit-Author: bcr X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/handbook/virtualization X-SVN-Commit-Revision: 52813 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: A20B183139 X-Spamd-Bar: -- Authentication-Results: mx1.freebsd.org X-Spamd-Result: default: False [-2.94 / 15.00]; local_wl_from(0.00)[FreeBSD.org]; NEURAL_HAM_MEDIUM(-1.00)[-0.997,0]; NEURAL_HAM_SHORT(-0.95)[-0.948,0]; NEURAL_HAM_LONG(-1.00)[-1.000,0]; ASN(0.00)[asn:11403, ipnet:2610:1c1:1::/48, country:US] X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 11 Feb 2019 18:15:49 -0000 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" Users of &os; 11 should install the emulators/xen-kernel47 and sysutils/xen-tools47 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 emulators/xen-kernel411 and + based on Xen version 4.7. Systems running on &os;-12.0 or + newer can use Xen 4.11 provided by + emulators/xen-kernel411 and sysutils/xen-tools411, respectively. Configuration files must be edited to prepare the host @@ -1483,7 +1483,7 @@ kld_list="nmdm vmm" Add an entry for the &xen; console to /etc/ttys: - &prompt.root; echo 'xc0 "/usr/libexec/getty Pc" xterm on secure' >> /etc/ttys + &prompt.root; echo 'xc0 "/usr/libexec/getty Pc" xterm onifconsole secure' >> /etc/ttys Selecting a &xen; kernel in /boot/loader.conf activates the Dom0. @@ -1498,24 +1498,24 @@ kld_list="nmdm vmm" The following command is used for Xen 4.7 packages: &prompt.root; sysrc -f /boot/loader.conf hw.pci.mcfg=0 +&prompt.root; sysrc -f /boot/loader.conf if_tap_load="YES" &prompt.root; sysrc -f /boot/loader.conf xen_kernel="/boot/xen" &prompt.root; sysrc -f /boot/loader.conf xen_cmdline="dom0_mem=8192M dom0_max_vcpus=4 dom0pvh=1 console=com1,vga com1=115200,8n1 guest_loglvl=all loglvl=all" For Xen versions 4.11 and higher, the following command should be used instead: - &prompt.root; sysrc -f /boot/loader.conf hw.pci.mcfg=0 + &prompt.root; sysrc -f /boot/loader.conf if_tap_load="YES" &prompt.root; sysrc -f /boot/loader.conf xen_kernel="/boot/xen" &prompt.root; sysrc -f /boot/loader.conf xen_cmdline="dom0_mem=8192M dom0_max_vcpus=4 dom0=pvh console=com1,vga com1=115200,8n1 guest_loglvl=all loglvl=all" - Log files that &xen; creates for the Dom0 and DomU VMs - are stored in /var/log/xen. This - directory does not exist by default and must be - created. + + Log files that &xen; creates for the DomU VMs + are stored in /var/log/xen. Please + be sure to check the contents of that directory if + experiencing issues. + - &prompt.root; mkdir -p /var/log/xen -&prompt.root; chmod 644 /var/log/xen - &xen; provides a boot menu to activate and de-activate the hypervisor on demand in /boot/menu.rc.local: @@ -1576,7 +1576,7 @@ Domain-0 0 8192 retrieved with &man.fetch.1; and saved locally in a file called freebsd.iso. - &prompt.root; fetch ftp://ftp.freebsd.org/pub/FreeBSD/releases/ISO-IMAGES/10.3/FreeBSD-10.3-RELEASE-amd64-bootonly.iso -o freebsd.iso + &prompt.root; fetch ftp://ftp.freebsd.org/pub/FreeBSD/releases/ISO-IMAGES/12.0/FreeBSD-12.0-RELEASE-amd64-bootonly.iso -o freebsd.iso A ZFS volume of 20 GB called xendisk0 is created to serve as the disk