[gentoo-commits] gentoo commit in xml/htdocs/doc/en: xen-guide.xml

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: xen-guide.xml

[Sven Vermeulen (swift)]

swift       07/12/10 15:37:11

  Log:
  
-- 
gentoo-commits@gentoo.org mailing list

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: xen-guide.xml

[Camille Huot (cam)]

cam         08/04/10 15:01:51

  Log:
  
-- 
gentoo-commits@lists.gentoo.org mailing list

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: xen-guide.xml

[Sven Vermeulen (swift)]

swift       08/08/11 16:25:23

  Log:
  

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: xen-guide.xml

[Joshua Saddler (nightmorph)]

nightmorph    10/05/14 21:55:13

  Modified:             xen-guide.xml
  Log:
  updated Xen kernel config, bug 319729

Revision  Changes    Path
1.6                  xml/htdocs/doc/en/xen-guide.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.6&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.6&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?r1=1.5&r2=1.6

Index: xen-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- xen-guide.xml	11 Aug 2008 16:25:22 -0000	1.5
+++ xen-guide.xml	14 May 2010 21:55:13 -0000	1.6
@@ -1,9 +1,8 @@
 <?xml version='1.0' encoding='UTF-8'?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.5 2008/08/11 16:25:22 swift Exp $ -->
-
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.6 2010/05/14 21:55:13 nightmorph Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
-<guide link="/doc/en/xen-guide.xml">
+<guide>
 
 <title>Configuring Gentoo with Xen</title>
 
@@ -19,8 +18,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.4</version>
-<date>2008-08-11</date>
+<version>2</version>
+<date>2010-05-14</date>
 
 <chapter>
 <title>Introduction</title>
@@ -161,6 +160,7 @@
 Processor type and features  ---&gt;
       Subarchitecture Type (PC-compatible)
   [*] Enable Xen compatible kernel
+  [*] Support for hot-pluggable CPUs
 </pre>
 
 <pre caption="Domain-0 Kernel Config">

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: xen-guide.xml

[Joshua Saddler (nightmorph)]

nightmorph    10/11/14 15:27:04

  Modified:             xen-guide.xml
  Log:
  mention 32-bit/64-bit dom0 logic for -mnotls-direct-seg-refs, bug 335282

Revision  Changes    Path
1.7                  xml/htdocs/doc/en/xen-guide.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.7&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.7&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?r1=1.6&r2=1.7

Index: xen-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- xen-guide.xml	14 May 2010 21:55:13 -0000	1.6
+++ xen-guide.xml	14 Nov 2010 15:27:04 -0000	1.7
@@ -1,14 +1,16 @@
 <?xml version='1.0' encoding='UTF-8'?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.6 2010/05/14 21:55:13 nightmorph Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.7 2010/11/14 15:27:04 nightmorph Exp $ -->
 
 <guide>
-
 <title>Configuring Gentoo with Xen</title>
 
 <author title="Author">
   <mail link="swift@gentoo.org">Sven Vermeulen</mail>
 </author>
+<author title="Editor">
+  <mail link="nightmorph"/>
+</author>
 
 <abstract>
 This guide describes how to start using Xen on your Gentoo system
@@ -18,8 +20,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>2</version>
-<date>2010-05-14</date>
+<version>3</version>
+<date>2010-11-14</date>
 
 <chapter>
 <title>Introduction</title>
@@ -67,7 +69,7 @@
 </body>
 </section>
 <section>
-<title>Rebuilding the Gentoo Installation ?</title>
+<title>Rebuilding the Gentoo Installation?</title>
 <body>
 
 <p>
@@ -88,7 +90,8 @@
 
 <pre caption="Editing the CFLAGS and rebuild the Gentoo installation">
 ~# <i>nano -w /etc/make.conf</i>
-<comment>(Add -mno-tls-direct-seg-refs)</comment>
+<comment>(Add -mno-tls-direct-seg-refs ONLY if you have a 32-bit dom0)</comment>
+<comment>(You don't need this flag if you have a 64-bit dom0)</comment>
 CFLAGS="-O2 -march=pentium4 -pipe <i>-mno-tls-direct-seg-refs</i>"
 
 ~# <i>emerge -e world</i>
@@ -123,8 +126,6 @@
 ~# <i>emerge xen xen-tools xen-sources</i>
 </pre>
 
-
-
 </body>
 </section>
 <section>

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: xen-guide.xml

[Joshua Saddler (nightmorph)]

nightmorph    11/03/02 09:22:44

  Modified:             xen-guide.xml
  Log:
  remove outdated keywording instructions now that there are stable xen packages

Revision  Changes    Path
1.8                  xml/htdocs/doc/en/xen-guide.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.8&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.8&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?r1=1.7&r2=1.8

Index: xen-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- xen-guide.xml	14 Nov 2010 15:27:04 -0000	1.7
+++ xen-guide.xml	2 Mar 2011 09:22:44 -0000	1.8
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.7 2010/11/14 15:27:04 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.8 2011/03/02 09:22:44 nightmorph Exp $ -->
 
 <guide>
 <title>Configuring Gentoo with Xen</title>
@@ -20,8 +20,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>3</version>
-<date>2010-11-14</date>
+<version>4</version>
+<date>2011-03-02</date>
 
 <chapter>
 <title>Introduction</title>
@@ -110,19 +110,11 @@
 <body>
 
 <p>
-Xen actually contains many components, so you'll need to install a couple of
-packages. Because it is still <uri
-link="/doc/en/handbook/handbook-x86.xml?part=3&amp;chap=3#doc_chap2">~arch
-masked</uri> you first need to unmask it by adding the necessary lines to
-<path>/etc/portage/package.keywords</path> and then install them.
+Xen actually contains many components, so you'll need to install a few
+packages.
 </p>
 
-<pre caption="Unmasking and Installing Xen">
-~# <i>nano -w /etc/portage/package.keywords</i>
-app-emulation/xen
-app-emulation/xen-tools
-sys-kernel/xen-sources
-
+<pre caption="Installing Xen">
 ~# <i>emerge xen xen-tools xen-sources</i>
 </pre>
 

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: xen-guide.xml

[Joshua Saddler (nightmorph)]

nightmorph    11/06/07 09:27:59

  Modified:             xen-guide.xml
  Log:
  update URIs, bug 369837, thanks to swift for the patch

Revision  Changes    Path
1.9                  xml/htdocs/doc/en/xen-guide.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.9&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.9&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?r1=1.8&r2=1.9

Index: xen-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- xen-guide.xml	2 Mar 2011 09:22:44 -0000	1.8
+++ xen-guide.xml	7 Jun 2011 09:27:59 -0000	1.9
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.8 2011/03/02 09:22:44 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.9 2011/06/07 09:27:59 nightmorph Exp $ -->
 
 <guide>
 <title>Configuring Gentoo with Xen</title>
@@ -20,8 +20,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>4</version>
-<date>2011-03-02</date>
+<version>5</version>
+<date>2011-06-07</date>
 
 <chapter>
 <title>Introduction</title>
@@ -535,11 +535,11 @@
 
 <ul>
   <li>
-    <uri link="http://tx.downloads.xensource.com/downloads/docs/user/">Xen
-    Users' Manual</uri>
+    <uri link="http://bits.xensource.com/Xen/docs/user.pdf">Xen
+    Users' Manual (PDF)</uri>
   </li>
   <li>
-    <uri link="http://xen.xensource.com/documentation.html">Xen Community
+    <uri link="http://www.xen.org/support/documentation.html">Xen Community
     Documentation</uri>
   </li>
   <li>

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: xen-guide.xml

[Joshua Saddler (nightmorph)]

nightmorph    11/08/29 10:09:42

  Modified:             xen-guide.xml
  Log:
  update URIs, from an email by Reid Ottem. also update other homepage/doc resource links.

Revision  Changes    Path
1.10                 xml/htdocs/doc/en/xen-guide.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.10&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.10&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?r1=1.9&r2=1.10

Index: xen-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- xen-guide.xml	7 Jun 2011 09:27:59 -0000	1.9
+++ xen-guide.xml	29 Aug 2011 10:09:42 -0000	1.10
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.9 2011/06/07 09:27:59 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.10 2011/08/29 10:09:42 nightmorph Exp $ -->
 
 <guide>
 <title>Configuring Gentoo with Xen</title>
@@ -20,8 +20,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>5</version>
-<date>2011-06-07</date>
+<version>6</version>
+<date>2011-08-29</date>
 
 <chapter>
 <title>Introduction</title>
@@ -29,7 +29,7 @@
 <body>
 
 <p>
-The <uri link="http://www.xensource.com/">Xen</uri> technology allows you to run
+The <uri link="http://www.xen.org/">Xen</uri> technology allows you to run
 multiple operating systems on a single physical system, govern resource
 consumption and even migrate domains (which are the virtual environments in
 which a guest operating system runs) from one Xen-powered system to another. Xen
@@ -42,11 +42,10 @@
 <p>
 This guide will talk you through the configuration steps necessary to get Xen up
 and running on Gentoo Linux. We will not discuss Xen itself (the Xen project has
-<uri
-link="http://www.cl.cam.ac.uk/research/srg/netos/xen/readmes/user">decent
-documentation</uri> available) nor will we talk about specialized setups that
-might be very interesting for Xen setups but are not Xen-related (like exporting
-Portage through NFS, booting Linux using PXE, etc.)
+<uri link="http://xen.org/support/documentation.html">decent documentation</uri>
+available) nor will we talk about specialized setups that might be very
+interesting for Xen setups but are not Xen-related (like exporting Portage
+through NFS, booting Linux using PXE, etc.)
 </p>
 
 </body>
@@ -535,15 +534,11 @@
 
 <ul>
   <li>
-    <uri link="http://bits.xensource.com/Xen/docs/user.pdf">Xen
-    Users' Manual (PDF)</uri>
+    <uri link="http://www.xen.org/support/documentation.html">Official Xen
+    documentation</uri>
   </li>
   <li>
-    <uri link="http://www.xen.org/support/documentation.html">Xen Community
-    Documentation</uri>
-  </li>
-  <li>
-    <uri link="http://wiki.xensource.com/xenwiki/">Xen Wiki</uri>
+    <uri link="http://wiki.xen.org/">Xen Wiki</uri>
   </li>
 </ul>
 
@@ -556,7 +551,7 @@
 <ul>
   <li>
     <uri
-    link="http://virt-manager.et.redhat.com/">app-emulation/virt-manager</uri>
+    link="http://virt-manager.org/">app-emulation/virt-manager</uri>
     is a graphical tool for administering virtual machines
   </li>
 </ul>

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: xen-guide.xml

[Sven Vermeulen (swift)]

swift       12/10/07 13:32:49

  Modified:             xen-guide.xml
  Log:
  Bug #437222 - Update Xen document to reflect later releases

Revision  Changes    Path
1.14                 xml/htdocs/doc/en/xen-guide.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.14&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.14&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?r1=1.13&r2=1.14

Index: xen-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- xen-guide.xml	24 Jul 2012 12:12:51 -0000	1.13
+++ xen-guide.xml	7 Oct 2012 13:32:49 -0000	1.14
@@ -1,8 +1,8 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.13 2012/07/24 12:12:51 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.14 2012/10/07 13:32:49 swift Exp $ -->
 
-<guide disclaimer="obsolete">
+<guide disclaimer="draft">
 <title>Configuring Gentoo with Xen</title>
 
 <author title="Author">
@@ -20,8 +20,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>8</version>
-<date>2012-07-24</date>
+<version>9</version>
+<date>2012-10-07</date>
 
 <chapter>
 <title>Introduction</title>
@@ -114,7 +114,7 @@
 </p>
 
 <pre caption="Installing Xen">
-~# <i>emerge xen xen-tools xen-sources</i>
+~# <i>emerge xen xen-tools gentoo-sources</i>
 </pre>
 
 </body>
@@ -125,89 +125,64 @@
 
 <p>
 Next we'll build the Linux kernel with Xen support. This kernel, whose sources
-are available at <path>/usr/src/linux-2.6.x.z-xen</path>, will be our main
+are available at <path>/usr/src/linux</path>, will be our main
 running kernel (i.e. the one running domain 0). In the <c>XEN</c> section you'll
 find drivers for all kinds of input/output, each driver having a <e>backend</e>
 and <e>frontend</e> implementation available. For the domain 0 kernel you need
 to select the <e>backend</e> implementation: these are used by the other
 domains (who use the <e>frontend</e> drivers) to communicate directly with
-the hardware.
+the hardware. However, you should be able to configure the kernel to provide
+support for both frontend (guest) and backend (host) drivers.
 </p>
 
 <p>
-Of course, don't forget to select <c>Xen-compatible</c> at <c>Processor type and
-features</c>. If you're wondering about networking: each interface in a domain
+If you're wondering about networking: each interface in a domain
 has a point-to-point link to an interface on domain 0 (called
 <path>vifX.Y</path> where X is the domain number and Y the Yth interface of that
 domain), so you can configure your network the way you want (bridging, NAT,
 etc.)
 </p>
 
-<pre caption="Enabling Xen Support for i386 Kernels">
+<pre caption="Enabling Xen Support">
 Processor type and features  ---&gt;
-      Subarchitecture Type (Xen-compatible)
+    [*] Paravirtualized guest support ---&gt;
+        [*] Xen guest support
 </pre>
 
-<pre caption="Enabling Xen Support for x86_64 Kernels">
-Processor type and features  ---&gt;
-      Subarchitecture Type (PC-compatible)
-  [*] Enable Xen compatible kernel
-  [*] Support for hot-pluggable CPUs
-</pre>
-
-<pre caption="Domain-0 Kernel Config">
-Bus options (PCI etc.)  ---&gt;
-  [*] PCI support
-  [ ]   Xen PCI Frontend Debugging
-
-Networking  ---&gt;
-  Networking options  ---&gt;
-    &lt;*&gt; 802.1d Ethernet Bridging
-    <comment>Only required by bridged networking.</comment>
-
-XEN  ---&gt;
-  [*] Privileged Guest (domain 0)
-  &lt;*&gt; Backend driver support
-  &lt;*&gt;   Block-device backend driver
-  &lt;*&gt;   Network-device backend driver
-  &lt;*&gt;   PCI-device backend driver
-           PCI Backend Mode (Virtual PCI) ---&gt;
-  [*] Scrub memory before freeing it to Xen
-  [*] Disable serial port drivers
-      Xen version compatibility (3.0.4 and later)
-</pre>
-
-<pre caption="Domain-U Kernel Config">
+<pre caption="Kernel Config">
 Bus options (PCI etc.)  ---&gt;
-  [ ] PCI support
+    [*] Xen PCI Frontend
 
-Device Drivers  ---&gt;
-  SCSI device support  ---&gt;
-    &lt; &gt; SCSI device support
-    <comment>Disabling SCSI support frees up the /dev/sd* device names
-    for use as Xen virtual block devices.</comment>
-
-XEN  ---&gt;
-  [ ] Privileged Guest (domain 0)
-  &lt;*&gt; Block-device frontend driver
-  &lt;*&gt; Network-device frontend driver
-  [*] Scrub memory before freeing it to Xen
-  [*] Disable serial port drivers
-      Xen version compatibility (3.0.4 and later)
+[*] Networking support ---&gt;
+    Networking options  ---&gt;
+        &lt;*&gt; 802.1d Ethernet Bridging
+	[*] Network packet filtering framework (Netfilter) ---&gt;
+	    [*] Advanced netfilter configuration
+	        [*] Bridged IP/ARP packets filtering
+
+Device Drivers ---&gt;
+    [*] Block devices (NEW) ---&gt;
+        &lt;*&gt; Xen block-device backend driver
+    [*] Network device support ---&gt;
+        &lt;*&gt; Xen backend network device
+    Xen driver support ---&gt;
+        [*] Xen memory balloon driver (NEW)
+	[*]   Scrub pages before returning them to system (NEW)
+	&lt;*&gt; Xen /dev/xen/evtchn device (NEW)
+	[*] Backend driver support (NEW)
+	&lt;*&gt; Xen filesystem (NEW)
+	[*]   Create compatibility mount point /proc/xen (NEW)
+	[*] Create xen entries under /sys/hypervisor (NEW)
+	&lt;M&gt; userspace grant access device driver (NEW)
+	&lt;M&gt; user-space grant reference allocator driver (NEW)
+	&lt;M&gt; xen platform pci device driver (NEW)
 </pre>
 
 <p>
-A nice hint is to have the kernel make process store its intermediate object
-files elsewhere so that you can reuse the same kernel tree to build different
-configurations:
-</p>
-
-<pre caption="Building the Kernel">
-~# <i>mkdir -p ~/build/dom0 ~/build/domU</i>
-~# <i>make O=~/build/dom0 menuconfig</i>
-<comment>(Configure the kernel)</comment>
-~# <i>make O=~/build/dom0 &amp;&amp; make O=~/build/dom0 modules_install</i>
-</pre>
+The shown kernel configuration should allow the kernel image to boot both as a
+host as well as a guest. However, if you want to, you can slim down the guest
+image kernel considerably. Refer to the Xen documentation for more information.
+</p>
 
 <p>
 Once the kernel is built you'll find the kernel image immediately in the
@@ -220,26 +195,16 @@
 </p>
 
 <pre caption="GRUB Configuration for Xen">
-title Xen 3.0 / Gentoo Linux 2.6.x.y
+title Xen Gentoo Linux 3.5
 root (hd0,0)
 kernel /boot/xen.gz
-module /boot/kernel-2.6.x.y-xen0 root=/dev/sda3
+module /boot/kernel-3.5.x.y-xen0 root=/dev/sda3
 </pre>
 
 <p>
-Now reboot your system into Xen. Once you are booted, you need to load the Xen
-daemon:
-</p>
-
-<pre caption="Loading the Xen daemon">
-~# <i>/etc/init.d/xend start</i>
-</pre>
-
-<p>
-Now check if you can do whatever you normally do on your system. If this is the
-case, you can edit your bootloader configuration to always boot into Xen and add
-the Xen deamon to the default runlevel so that it is started automatically
-next time you boot.
+Now reboot your system into Xen and check if you can do whatever you
+normally do on your system. If this is the case, you can edit your
+bootloader configuration to always boot into Xen.
 </p>
 
 <note>
@@ -259,25 +224,18 @@
 <body>
 
 <p>
-Go to the Xen-powered Linux kernel source and update the configuration. It is
-wise to keep as many topics as possible similar to the main kernel except the
-<c>XEN</c> settings where drivers should now have their <e>frontend</e>
-implementation selected instead of the <e>backend</e>. Then build the kernel
+Go to the Xen-powered Linux kernel source and, if necessary, update the
+configuration. It is wise to keep as many topics as possible similar to
+the main kernel. Then build the kernel
 and place the resulting <path>vmlinuz</path> file where you want (we assume this
 is <path>/mnt/data/xen/kernel</path>):
 </p>
 
 <pre caption="Building the guest kernel">
 ~# <i>make O=~/build/domU</i>
-~# <i>cp ~/build/domU/vmlinuz /mnt/data/xen/kernel/kernel-2.6.x.y-xen</i>
+~# <i>cp ~/build/domU/vmlinuz /mnt/data/xen/kernel/kernel-3.5.x.y-xen</i>
 </pre>
 
-<p>
-It is also possible to create a single kernel image for both the administrative
-domain and the unpriviledged domain. More information about this can be found
-in the Xen user manual.
-</p>
-
 </body>
 </section>
 <section>
@@ -293,13 +251,13 @@
 
 <p>
 You can create a file based filesystem using <c>dd</c> and <c>mke2fs</c> (or
-any other file system creation tool). For instance, to create a 2Gbyte ext3
+any other file system creation tool). For instance, to create a 4 Gbyte ext4
 filesystem:
 </p>
 
 <pre caption="Creating a file based filesystem">
-~# <i>dd if=/dev/zero of=/mnt/data/xen/disks/ext3root.img bs=1M count=2048</i>
-~# <i>mke2fs -j /mnt/data/xen/disks/ext3root.img</i>
+~# <i>dd if=/dev/zero of=/mnt/data/xen/disks/ext4root.img bs=1M count=4096</i>
+~# <i>mkfs.ext4 /mnt/data/xen/disks/ext4root.img</i>
 </pre>
 
 </body>
@@ -319,11 +277,11 @@
 <pre caption="Creating a domain configuration file">
 ~# <i>nano -w /mnt/data/xen/configs/gentoo</i>
 
-kernel = "/mnt/data/xen/kernel/kernel-2.6.x.y-xen"
+kernel = "/mnt/data/xen/kernel/kernel-3.5.x.y-xen"
 memory = 512
 name   = "gentoo"
 <comment>(Map the disk image to the virtual /dev/sda1)</comment>
-disk   = ['file:/mnt/data/xen/disks/ext3root.img,sda1,w']
+disk   = ['file:/mnt/data/xen/disks/ext4root.img,sda1,w']
 root   = "/dev/sda1 ro"
 </pre>
 
@@ -353,11 +311,11 @@
 <p>
 Now we're all set and we can launch the new domain. If the disk image contained
 an operating system, we could just create and attach the domain using the
-<c>xm</c> command (Xen manager):
+<c>xl</c> command:
 </p>
 
 <pre caption="Creating and starting a new domain">
-~# <i>xm create /mnt/data/xen/configs/gentoo -c</i>
+~# <i>xl create /mnt/data/xen/configs/gentoo -c</i>
 </pre>
 
 <p>
@@ -369,7 +327,7 @@
 
 <p>
 If you want to disconnect from the domain, press <path>Ctrl+]</path>. You can
-always reconnect to the domains' console using <c>xm console gentoo</c>.
+always reconnect to the domains' console using <c>xl console gentoo</c>.
 However, there is only one console per domain, so only use it when you can't
 access the domain otherwise (for instance, through SSH).
 </p>
@@ -384,23 +342,8 @@
 <body>
 
 <p>
-Xen supports at least two ways of configuring your (virtual) network:
-<e>routed</e> and <e>bridged</e>.
-</p>
-
-<p>
-When selecting the <e>routed</e> approach, the interface inside your
-unpriviledged domain is connected to the virtual interface on your
-administrative domain. On your administrative domain (domain 0), the virtual
-interface is linked together with <path>eth0</path>. The
-interface inside your unpriviledged domain should have an IP address on the same
-network as the interface on the administrative domain. Any communication to
-that IP address can only occur from the administrative domain, unless you set
-up specific routing rules.
-</p>
-
-<p>
-When selecting the <e>bridged</e> approach, your default network interface on
+Xen works best when using a bridged mode network configuration.
+This means that your default network interface on
 the administrative domain becomes a bridge which accepts connections to the
 virtual domains as well as to the IP address your administrative domain has.
 </p>
@@ -408,119 +351,39 @@
 </body>
 </section>
 <section>
-<title>Regular Routed Interfaces</title>
-<body>
-
-<p>
-Before you set up the interface on your unpriviledged domain, make sure that
-Xen's <path>netloop</path> and <path>netbk</path> drivers are loaded. A quick
-hint: if you have <path>netloop</path> as a module, load it with
-<c>nloopbacks=0</c> so that it doesn't create pointless interfaces to the
-loopback device. Then, edit your domain configuration file and add a <c>vif</c>
-instruction to it.
-</p>
-
-<pre caption="Configuring a virtual interface">
-~# <i>nano -w /mnt/data/xen/configs/gentoo</i>
-
-<comment>(Add the vif instruction)</comment>
-vif    = [ 'ip=192.168.1.101, vifname=veth1' ]
-</pre>
-
-<p>
-In the above example, the interface will be created for the unpriviledged domain
-(in which it will be called <path>eth0</path>) and Xen will ensure that address
-192.168.1.101 will be reachable from the administrative domain through interface
-<path>veth1</path>.
-</p>
-
-<p>
-This doesn't mean that the virtual <path>eth0</path> interface will
-automatically have IP 192.168.1.101 assigned to it, but rather that, if you
-don't give it that IP, it will not be connected with the administrative domain
-and thus cannot be reached.
-</p>
-
-<p>
-Now edit <path>/etc/xen/xend-config.sxp</path> as follows to select routed
-network configuration:
-</p>
-
-<pre caption="Editing xend-config.sxp">
-~# <i>nano -w /etc/xen/xend-config.sxp</i>
-
-<comment>(Comment out the following lines)</comment>
-<i>#</i>(network-script network-bridge)
-<i>#</i>(vif-script vif-bridge)
-
-<comment>(Enable the following lines)</comment>
-(network-script network-route)
-(vif-script vif-route)
-</pre>
-
-</body>
-</section>
-<section>
 <title>Bridged Interfaces</title>
 <body>
 
 <p>
-Unlike the routed interfaces you now need to load the <path>netloop</path>
-driver with <c>nloopbacks=1</c> (or higher) as the additional loopback devices
-are used to create the bridge. For the other modules you still need the
-<path>netbk</path> module as well as briding functionality (<path>bridge</path>
-module if build as such).
-</p>
-
-<p>
-Now edit your virtual domain and add the <c>vif</c> construct:
+Create a bridge interface by creating a new link to the networking init script
+as provided by Gentoo:
 </p>
 
-<pre caption="Configuring a virtual interface">
-~# <i>nano -w /mnt/data/xen/configs/gentoo</i>
-
-<comment>(Add the vif instruction)</comment>
-vif    = [ 'ip=192.168.1.101, vifname=veth0' ]
-</pre>
-
-<p>
-Next edit <path>/etc/xen/xend-config.sxp</path> as follows to select bridged
-network configuration:
-</p>
-
-<pre caption="Editing xend-config.sxp">
-~# <i>nano -w /etc/xen/xend-config.sxp</i>
-
-<comment>(Enable the following lines)</comment>
-(network-script network-bridge)
-(vif-script vif-bridge)
-
-<comment>(Comment out the following lines if not done already)</comment>
-<i>#</i> (network-script network-route)
-<i>#</i> (vif-script vif-route)
+<pre caption="Creating a bridge interface">
+# <i>cd /etc/init.d</i>
+# <i>ln -s net.lo net.br0</i>
 </pre>
 
 <p>
-By default, the bridge will contain whatever interface is configured to be the
-default interface (the device that is listed under the default route through
-<c>ip route list</c>). If you want to alter this behavior, edit the
-<path>xend-config.sxp</path> as follows:
+Next, edit <path>/etc/conf.d/net</path> and setup the bridge:
 </p>
 
-<pre caption="Editing xend-config.sxp to change bridge configuration">
-~# <i>nano -w /etc/xen/xend-config.sxp</i>
+<pre caption="Enabling the bridge br0 interface">
+# <i>nano -w /etc/conf.d/net</i>
 
-<comment>(Edit the network-script line)</comment>
-(network-script <i>'</i>network-bridge <i>netdev=eth0 bridge=xenbr0 vifnum=0'</i>)
+bridge_br0="eth0"
+config_br0="192.168.1.200 netmask 255.255.255.0 brd 192.168.1.255"
+routes_br0="default via 192.168.1.1"
 </pre>
 
 <p>
-Once the configuration is done, restart the <c>xend</c> init script to have Xen
-build the bridge:
+Finally, install the <e>net-misc/bridge-utils</e> package, and make sure the
+<path>net.br0</path> init script is loaded at boot.
 </p>
 
-<pre caption="Restarting the xend daemon">
-~# <i>/etc/init.d/xend restart</i>
+<pre caption="Finishing the bridge setup">
+# <i>emerge net-misc/bridge-utils</i>
+# <i>rc-update add net.br0 default</i>
 </pre>
 
 </body>

[gentoo-commits] gentoo commit in xml/htdocs/doc/en: xen-guide.xml

[Sven Vermeulen (swift)]

swift       13/11/24 18:36:25

  Modified:             xen-guide.xml
  Log:
  Mark CONFIG_XEN_GNTDEV for in-kernel build instead of modular, this is needed for using file-backed filesystems for a domU, thanks to Matthew Daley

Revision  Changes    Path
1.15                 xml/htdocs/doc/en/xen-guide.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.15&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?rev=1.15&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/xen-guide.xml?r1=1.14&r2=1.15

Index: xen-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- xen-guide.xml	7 Oct 2012 13:32:49 -0000	1.14
+++ xen-guide.xml	24 Nov 2013 18:36:24 -0000	1.15
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.14 2012/10/07 13:32:49 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xen-guide.xml,v 1.15 2013/11/24 18:36:24 swift Exp $ -->
 
 <guide disclaimer="draft">
 <title>Configuring Gentoo with Xen</title>
@@ -20,8 +20,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>9</version>
-<date>2012-10-07</date>
+<version>10</version>
+<date>2013-11-24</date>
 
 <chapter>
 <title>Introduction</title>
@@ -173,7 +173,7 @@
 	&lt;*&gt; Xen filesystem (NEW)
 	[*]   Create compatibility mount point /proc/xen (NEW)
 	[*] Create xen entries under /sys/hypervisor (NEW)
-	&lt;M&gt; userspace grant access device driver (NEW)
+	&lt;*&gt; userspace grant access device driver (NEW)
 	&lt;M&gt; user-space grant reference allocator driver (NEW)
 	&lt;M&gt; xen platform pci device driver (NEW)
 </pre>