1.1 --- a/README	Mon Apr 24 11:21:16 2006 +0100
     1.2 +++ b/README	Mon Apr 24 18:07:27 2006 +0100
     1.3 @@ -1,176 +1,176 @@
     1.4 -################################
     1.5 - __  __            _____  ___  
     1.6 - \ \/ /___ _ __   |___ / / _ \ 
     1.7 -  \  // _ \ '_ \    |_ \| | | |
     1.8 -  /  \  __/ | | |  ___) | |_| |
     1.9 - /_/\_\___|_| |_| |____(_)___/ 
    1.10 -
    1.11 -################################
    1.12 -
    1.13 -http://www.xensource.com/xen/about.html
    1.14 -
    1.15 -What is Xen?
    1.16 -============
    1.17 -
    1.18 -Xen is a Virtual Machine Monitor (VMM) originally developed by the
    1.19 -Systems Research Group of the University of Cambridge Computer
    1.20 -Laboratory, as part of the UK-EPSRC funded XenoServers project.  Xen
    1.21 -is freely-distributable Open Source software, released under the GNU
    1.22 -GPL. Since its initial public release, Xen has grown a large
    1.23 -development community, spearheaded by XenSource Inc, a company created
    1.24 -by the original Xen development team to build enterprise products
    1.25 -around Xen.
    1.26 -
    1.27 -The 3.0 release offers excellent performance, hardware support and
    1.28 -enterprise-grade features such as x86_32-PAE, x86_64, SMP guests and
    1.29 -live relocation of VMs. This install tree contains source for a Linux
    1.30 -2.6 guest; ports to Linux 2.4, NetBSD, FreeBSD and Solaris will follow
    1.31 -later (and are already available for previous Xen releases).
    1.32 -
    1.33 -This file contains some quick-start instructions to install Xen on
    1.34 -your system. For full documentation, see the Xen User Manual. If this
    1.35 -is a pre-built release then you can find the manual at:
    1.36 - dist/install/usr/share/doc/xen/pdf/user.pdf
    1.37 -If you have a source release, then 'make -C docs' will build the
    1.38 -manual at docs/pdf/user.pdf.
    1.39 -
    1.40 -Quick-Start Guide - Pre-Built Binary Release
    1.41 -============================================
    1.42 -
    1.43 -[NB. Unless noted otherwise, all the following steps should be
    1.44 -performed with root privileges.]
    1.45 -
    1.46 -1. Install the binary distribution onto your filesystem:
    1.47 -
    1.48 -    # sh ./install.sh
    1.49 -
    1.50 -   Among other things, this will install Xen and Xen-ready Linux
    1.51 -   kernel files in /boot, kernel modules and Python packages in /lib,
    1.52 -   and various control tools in standard 'bin' directories.
    1.53 -
    1.54 -2. Configure your bootloader to boot Xen and an initial Linux virtual
    1.55 -   machine. Note that Xen currently only works with GRUB and pxelinux
    1.56 -   derived boot loaders: less common alternatives such as LILO are
    1.57 -   *not* supported. You can most likely find your GRUB menu file at
    1.58 -   /boot/grub/menu.lst: edit this file to include an entry like the
    1.59 -   following:
    1.60 -
    1.61 -    title Xen 3.0 / XenLinux 2.6
    1.62 -       kernel /boot/xen-3.0.gz console=vga
    1.63 -       module /boot/vmlinuz-2.6-xen root=<root-dev> ro console=tty0
    1.64 -       module /boot/initrd-2.6-xen.img
    1.65 -
    1.66 -   NB: Not all kernel configs need an initial ram disk (initrd), but
    1.67 -   if you do specify one you'll need to use the 'module' grub directive
    1.68 -   rather than 'initrd'.
    1.69 -
    1.70 -   The linux command line takes all the usual options, such as
    1.71 -   root=<root-dev> to specify your usual root partition (e.g.,
    1.72 -   /dev/hda1).  
    1.73 -
    1.74 -   The Xen command line takes a number of optional arguments described
    1.75 -   in the manual. The most common is 'dom0_mem=xxxM' which sets the
    1.76 -   amount of memory to allocate for use by your initial virtual
    1.77 -   machine (known as domain 0). Note that Xen itself reserves about
    1.78 -   32MB memory for internal use, which is not available for allocation
    1.79 -   to virtual machines.  
    1.80 -
    1.81 -3. Reboot your system and select the "Xen 3.0 / XenLinux 2.6" menu
    1.82 -   option. After booting Xen, Linux will start and your initialisation
    1.83 -   scripts should execute in the usual way.
    1.84 -
    1.85 -Quick-Start Guide - Source Release
    1.86 -==================================
    1.87 -
    1.88 -First, there are a number of prerequisites for building a Xen source
    1.89 -release. Make sure you have all the following installed, either by
    1.90 -visiting the project webpage or installing a pre-built package
    1.91 -provided by your Linux distributor:
    1.92 -    * GCC (preferably v3.2.x or v3.3.x; older versions are unsupported) 
    1.93 -    * GNU Make
    1.94 -    * GNU Binutils
    1.95 -    * Development install of zlib (e.g., zlib-dev)
    1.96 -    * Development install of Python v2.3 or later (e.g., python-dev)
    1.97 -    * bridge-utils package (/sbin/brctl)
    1.98 -    * iproute package (/sbin/ip)
    1.99 -    * hotplug or udev
   1.100 -
   1.101 -[NB. Unless noted otherwise, all the following steps should be
   1.102 -performed with root privileges.]
   1.103 -
   1.104 -1. Download and untar the source tarball file. This will be a
   1.105 -   file named xen-unstable-src.tgz, or xen-$version-src.tgz.
   1.106 -   You can also pull the current version from the SCMS
   1.107 -   that is being used (Bitkeeper, scheduled to change shortly).
   1.108 -
   1.109 -    # tar xzf xen-unstable-src.tgz
   1.110 -
   1.111 -   Assuming you are using the unstable tree, this will
   1.112 -   untar into xen-unstable. The rest of the instructions
   1.113 -   use the unstable tree as an example, substitute the
   1.114 -   version for unstable.
   1.115 -
   1.116 -2. cd to xen-unstable (or whatever you sensibly rename it to).
   1.117 -   The Linux, netbsd and freebsd kernel source trees are in
   1.118 -   the $os-$version-xen-sparse directories.
   1.119 -
   1.120 -On Linux:
   1.121 -
   1.122 -3. For the very first build, or if you want to destroy existing
   1.123 -   .configs and build trees, perform the following steps:
   1.124 -
   1.125 -    # make world
   1.126 -    # make install
   1.127 -
   1.128 -   This will create and install onto the local machine. It will build 
   1.129 -   the xen binary (xen.gz), and a linux kernel and modules that can be
   1.130 -   used in both dom0 and an unprivileged guest kernel (vmlinuz-2.6.x-xen),
   1.131 -   the tools and the documentation.
   1.132 -
   1.133 -   You can override the destination for make install by setting DESTDIR 
   1.134 -   to some value.
   1.135 -
   1.136 -   The make command line defaults to building the kernel vmlinuz-2.6.x-xen. 
   1.137 -   You can override this default by specifying KERNELS=kernelname. For 
   1.138 -   example, you can make two kernels - linux-2.6-xen0 
   1.139 -   and linux-2.6-xenU - which are smaller builds containing only selected 
   1.140 -   modules, intended primarily for developers that don't like to wait 
   1.141 -   for a full -xen kernel to build. The -xenU kernel is particularly small,
   1.142 -   as it does not contain any physical device drivers, and hence is
   1.143 -   only useful for guest domains.
   1.144 -
   1.145 -   To make these two kernels, simply specify
   1.146 -
   1.147 -   KERNELS="linux-2.6-xen0 linux-2.6-xenU"
   1.148 -
   1.149 -   in the make command line.
   1.150 -
   1.151 -   If you want to build an x86_32 PAE capable xen and kernel to work
   1.152 -   on machines with >= 4GB of memory, use XEN_TARGET_X86_PAE=y on the
   1.153 -   make command line.
   1.154 -
   1.155 -4. To rebuild an existing tree without modifying the config:
   1.156 -    # make dist
   1.157 -
   1.158 -   This will build and install xen, kernels, tools, and
   1.159 -   docs into the local dist/ directory. 
   1.160 -
   1.161 -   You can override the destination for make install by setting DISTDIR 
   1.162 -   to some value.
   1.163 -
   1.164 -   make install and make dist differ in that make install does the 
   1.165 -   right things for your local machine (installing the appropriate 
   1.166 -   version of hotplug or udev scripts, for example), but make dist 
   1.167 -   includes all versions of those scripts, so that you can copy the dist 
   1.168 -   directory to another machine and install from that distribution.
   1.169 -
   1.170 -5. To rebuild a kernel with a modified config:
   1.171 -
   1.172 -    # make linux-2.6-xen-config CONFIGMODE=menuconfig     (or xconfig)
   1.173 -    # make linux-2.6-xen-build
   1.174 -    # make linux-2.6-xen-install
   1.175 -
   1.176 -   Depending on your config, you may need to use 'mkinitrd' to create
   1.177 -   an initial ram disk, just like a native system e.g. 
   1.178 -    # depmod 2.6.16-xen
   1.179 -    # mkinitrd -v -f --with=aacraid --with=sd_mod --with=scsi_mod initrd-2.6.16-xen.img 2.6.16-xen
   1.180 +################################
   1.181 + __  __            _____  ___  
   1.182 + \ \/ /___ _ __   |___ / / _ \ 
   1.183 +  \  // _ \ '_ \    |_ \| | | |
   1.184 +  /  \  __/ | | |  ___) | |_| |
   1.185 + /_/\_\___|_| |_| |____(_)___/ 
   1.186 +
   1.187 +################################
   1.188 +
   1.189 +http://www.xensource.com/xen/about.html
   1.190 +
   1.191 +What is Xen?
   1.192 +============
   1.193 +
   1.194 +Xen is a Virtual Machine Monitor (VMM) originally developed by the
   1.195 +Systems Research Group of the University of Cambridge Computer
   1.196 +Laboratory, as part of the UK-EPSRC funded XenoServers project.  Xen
   1.197 +is freely-distributable Open Source software, released under the GNU
   1.198 +GPL. Since its initial public release, Xen has grown a large
   1.199 +development community, spearheaded by XenSource Inc, a company created
   1.200 +by the original Xen development team to build enterprise products
   1.201 +around Xen.
   1.202 +
   1.203 +The 3.0 release offers excellent performance, hardware support and
   1.204 +enterprise-grade features such as x86_32-PAE, x86_64, SMP guests and
   1.205 +live relocation of VMs. This install tree contains source for a Linux
   1.206 +2.6 guest; ports to Linux 2.4, NetBSD, FreeBSD and Solaris will follow
   1.207 +later (and are already available for previous Xen releases).
   1.208 +
   1.209 +This file contains some quick-start instructions to install Xen on
   1.210 +your system. For full documentation, see the Xen User Manual. If this
   1.211 +is a pre-built release then you can find the manual at:
   1.212 + dist/install/usr/share/doc/xen/pdf/user.pdf
   1.213 +If you have a source release, then 'make -C docs' will build the
   1.214 +manual at docs/pdf/user.pdf.
   1.215 +
   1.216 +Quick-Start Guide - Pre-Built Binary Release
   1.217 +============================================
   1.218 +
   1.219 +[NB. Unless noted otherwise, all the following steps should be
   1.220 +performed with root privileges.]
   1.221 +
   1.222 +1. Install the binary distribution onto your filesystem:
   1.223 +
   1.224 +    # sh ./install.sh
   1.225 +
   1.226 +   Among other things, this will install Xen and Xen-ready Linux
   1.227 +   kernel files in /boot, kernel modules and Python packages in /lib,
   1.228 +   and various control tools in standard 'bin' directories.
   1.229 +
   1.230 +2. Configure your bootloader to boot Xen and an initial Linux virtual
   1.231 +   machine. Note that Xen currently only works with GRUB and pxelinux
   1.232 +   derived boot loaders: less common alternatives such as LILO are
   1.233 +   *not* supported. You can most likely find your GRUB menu file at
   1.234 +   /boot/grub/menu.lst: edit this file to include an entry like the
   1.235 +   following:
   1.236 +
   1.237 +    title Xen 3.0 / XenLinux 2.6
   1.238 +       kernel /boot/xen-3.0.gz console=vga
   1.239 +       module /boot/vmlinuz-2.6-xen root=<root-dev> ro console=tty0
   1.240 +       module /boot/initrd-2.6-xen.img
   1.241 +
   1.242 +   NB: Not all kernel configs need an initial ram disk (initrd), but
   1.243 +   if you do specify one you'll need to use the 'module' grub directive
   1.244 +   rather than 'initrd'.
   1.245 +
   1.246 +   The linux command line takes all the usual options, such as
   1.247 +   root=<root-dev> to specify your usual root partition (e.g.,
   1.248 +   /dev/hda1).  
   1.249 +
   1.250 +   The Xen command line takes a number of optional arguments described
   1.251 +   in the manual. The most common is 'dom0_mem=xxxM' which sets the
   1.252 +   amount of memory to allocate for use by your initial virtual
   1.253 +   machine (known as domain 0). Note that Xen itself reserves about
   1.254 +   32MB memory for internal use, which is not available for allocation
   1.255 +   to virtual machines.  
   1.256 +
   1.257 +3. Reboot your system and select the "Xen 3.0 / XenLinux 2.6" menu
   1.258 +   option. After booting Xen, Linux will start and your initialisation
   1.259 +   scripts should execute in the usual way.
   1.260 +
   1.261 +Quick-Start Guide - Source Release
   1.262 +==================================
   1.263 +
   1.264 +First, there are a number of prerequisites for building a Xen source
   1.265 +release. Make sure you have all the following installed, either by
   1.266 +visiting the project webpage or installing a pre-built package
   1.267 +provided by your Linux distributor:
   1.268 +    * GCC (preferably v3.2.x or v3.3.x; older versions are unsupported) 
   1.269 +    * GNU Make
   1.270 +    * GNU Binutils
   1.271 +    * Development install of zlib (e.g., zlib-dev)
   1.272 +    * Development install of Python v2.3 or later (e.g., python-dev)
   1.273 +    * bridge-utils package (/sbin/brctl)
   1.274 +    * iproute package (/sbin/ip)
   1.275 +    * hotplug or udev
   1.276 +
   1.277 +[NB. Unless noted otherwise, all the following steps should be
   1.278 +performed with root privileges.]
   1.279 +
   1.280 +1. Download and untar the source tarball file. This will be a
   1.281 +   file named xen-unstable-src.tgz, or xen-$version-src.tgz.
   1.282 +   You can also pull the current version from the SCMS
   1.283 +   that is being used (Bitkeeper, scheduled to change shortly).
   1.284 +
   1.285 +    # tar xzf xen-unstable-src.tgz
   1.286 +
   1.287 +   Assuming you are using the unstable tree, this will
   1.288 +   untar into xen-unstable. The rest of the instructions
   1.289 +   use the unstable tree as an example, substitute the
   1.290 +   version for unstable.
   1.291 +
   1.292 +2. cd to xen-unstable (or whatever you sensibly rename it to).
   1.293 +   The Linux, netbsd and freebsd kernel source trees are in
   1.294 +   the $os-$version-xen-sparse directories.
   1.295 +
   1.296 +On Linux:
   1.297 +
   1.298 +3. For the very first build, or if you want to destroy existing
   1.299 +   .configs and build trees, perform the following steps:
   1.300 +
   1.301 +    # make world
   1.302 +    # make install
   1.303 +
   1.304 +   This will create and install onto the local machine. It will build 
   1.305 +   the xen binary (xen.gz), and a linux kernel and modules that can be
   1.306 +   used in both dom0 and an unprivileged guest kernel (vmlinuz-2.6.x-xen),
   1.307 +   the tools and the documentation.
   1.308 +
   1.309 +   You can override the destination for make install by setting DESTDIR 
   1.310 +   to some value.
   1.311 +
   1.312 +   The make command line defaults to building the kernel vmlinuz-2.6.x-xen. 
   1.313 +   You can override this default by specifying KERNELS=kernelname. For 
   1.314 +   example, you can make two kernels - linux-2.6-xen0 
   1.315 +   and linux-2.6-xenU - which are smaller builds containing only selected 
   1.316 +   modules, intended primarily for developers that don't like to wait 
   1.317 +   for a full -xen kernel to build. The -xenU kernel is particularly small,
   1.318 +   as it does not contain any physical device drivers, and hence is
   1.319 +   only useful for guest domains.
   1.320 +
   1.321 +   To make these two kernels, simply specify
   1.322 +
   1.323 +   KERNELS="linux-2.6-xen0 linux-2.6-xenU"
   1.324 +
   1.325 +   in the make command line.
   1.326 +
   1.327 +   If you want to build an x86_32 PAE capable xen and kernel to work
   1.328 +   on machines with >= 4GB of memory, use XEN_TARGET_X86_PAE=y on the
   1.329 +   make command line.
   1.330 +
   1.331 +4. To rebuild an existing tree without modifying the config:
   1.332 +    # make dist
   1.333 +
   1.334 +   This will build and install xen, kernels, tools, and
   1.335 +   docs into the local dist/ directory. 
   1.336 +
   1.337 +   You can override the destination for make install by setting DISTDIR 
   1.338 +   to some value.
   1.339 +
   1.340 +   make install and make dist differ in that make install does the 
   1.341 +   right things for your local machine (installing the appropriate 
   1.342 +   version of hotplug or udev scripts, for example), but make dist 
   1.343 +   includes all versions of those scripts, so that you can copy the dist 
   1.344 +   directory to another machine and install from that distribution.
   1.345 +
   1.346 +5. To rebuild a kernel with a modified config:
   1.347 +
   1.348 +    # make linux-2.6-xen-config CONFIGMODE=menuconfig     (or xconfig)
   1.349 +    # make linux-2.6-xen-build
   1.350 +    # make linux-2.6-xen-install
   1.351 +
   1.352 +   Depending on your config, you may need to use 'mkinitrd' to create
   1.353 +   an initial ram disk, just like a native system e.g. 
   1.354 +    # depmod 2.6.16-xen
   1.355 +    # mkinitrd -v -f --with=aacraid --with=sd_mod --with=scsi_mod initrd-2.6.16-xen.img 2.6.16-xen