ia64/xen-unstable

changeset 8218:31d86fc0a271

Update xend-config.sxp so that dom0-min-mem is 196MB by default, as this is rather more user friendly.
Also do some minor fixes to the README
Signed-off-by: ian@xensource.com
author iap10@freefall.cl.cam.ac.uk
date Sat Dec 03 20:05:39 2005 +0100 (2005-12-03)
parents 8754277cec01
children 00c349d5b40d
files README tools/examples/xend-config.sxp
line diff
     1.1 --- a/README	Sat Dec 03 11:41:49 2005 +0100
     1.2 +++ b/README	Sat Dec 03 20:05:39 2005 +0100
     1.3 @@ -1,30 +1,31 @@
     1.4 -###############################
     1.5 -__  __            ____    ___
     1.6 -\ \/ /___ _ __   |___ \  / _ \
     1.7 - \  // _ \ '_ \    __) || | | |
     1.8 - /  \  __/ | | |  / __/ | |_| |
     1.9 -/_/\_\___|_| |_| |_____(_)___/
    1.10 +################################
    1.11 + __  __            _____  ___  
    1.12 + \ \/ /___ _ __   |___ / / _ \ 
    1.13 +  \  // _ \ '_ \    |_ \| | | |
    1.14 +  /  \  __/ | | |  ___) | |_| |
    1.15 + /_/\_\___|_| |_| |____(_)___/ 
    1.16  
    1.17 -###############################
    1.18 +################################
    1.19  
    1.20 -University of Cambridge Computer Laboratory
    1.21 -3 November 2004
    1.22 -
    1.23 -http://www.cl.cam.ac.uk/netos/xen/
    1.24 +http://www.xensource.com/xen/about.html
    1.25  
    1.26  What is Xen?
    1.27  ============
    1.28  
    1.29  Xen is a Virtual Machine Monitor (VMM) originally developed by the
    1.30  Systems Research Group of the University of Cambridge Computer
    1.31 -Laboratory, as part of the UK-EPSRC funded XenoServers project.
    1.32 -Xen is freely-distributable Open Source software, released under the
    1.33 -GNU GPL.
    1.34 +Laboratory, as part of the UK-EPSRC funded XenoServers project.  Xen
    1.35 +is freely-distributable Open Source software, released under the GNU
    1.36 +GPL. Since its initial public release, Xen has grown a large
    1.37 +development community, spearheaded by XenSource Inc, a company created
    1.38 +by the original Xen development team to build enterprise products
    1.39 +around Xen.
    1.40  
    1.41 -The 2.0 release offers excellent performance, hardware support and
    1.42 -enterprise-grade features such as live migration. Linux 2.6 and
    1.43 -NetBSD 2.0 are already available for Xen, with more operating system
    1.44 -ports on the way.
    1.45 +The 3.0 release offers excellent performance, hardware support and
    1.46 +enterprise-grade features such as x86_32-PAE, x86_64, SMP gusets and
    1.47 +live relocation of VMs. This install tree contains source for a Linux
    1.48 +2.6 guest; ports to Linux 2.4, NetBSD, FreeBSD and Solaris will follow
    1.49 +later (and are already available for previous Xen releases).
    1.50  
    1.51  This file contains some quick-start instructions to install Xen on
    1.52  your system. For full documentation, see the Xen User Manual. If this
    1.53 @@ -43,29 +44,40 @@ 1. Install the binary distribution onto 
    1.54  
    1.55      # sh ./install.sh
    1.56  
    1.57 -   Amongst other things, this will install Xen and XenLinux kernel
    1.58 -   files in /boot, kernel modules and Python packages in /lib, and
    1.59 -   various control tools in standard 'bin' directories.
    1.60 +   Among other things, this will install Xen and Xen-ready Linux
    1.61 +   kernel files in /boot, kernel modules and Python packages in /lib,
    1.62 +   and various control tools in standard 'bin' directories.
    1.63  
    1.64  2. Configure your bootloader to boot Xen and an initial Linux virtual
    1.65 -   machine. Note that Xen currently only works with GRUB: less common
    1.66 -   alternatives such as LILO are *not* supported. You can most likely
    1.67 -   find your GRUB menu file at /boot/grub/menu.lst: edit this file to
    1.68 -   include an entry like the following:
    1.69 +   machine. Note that Xen currently only works with GRUB and pxelinux
    1.70 +   derived boot loaders: less common alternatives such as LILO are
    1.71 +   *not* supported. You can most likely find your GRUB menu file at
    1.72 +   /boot/grub/menu.lst: edit this file to include an entry like the
    1.73 +   following:
    1.74  
    1.75 -    # title Xen 2.0 / XenLinux 2.6
    1.76 -    #   kernel /boot/xen-2.0.gz dom0_mem=<mem-kb> console=vga
    1.77 -    #   module /boot/vmlinuz-2.6-xen0 root=<root-dev> ro console=tty0
    1.78 +    title Xen 3.0 / XenLinux 2.6
    1.79 +       kernel /boot/xen-3.0.gz console=vga
    1.80 +       module /boot/vmlinuz-2.6-xen root=<root-dev> ro console=tty0
    1.81 +       module /boot/initrd-2.6-xen.img
    1.82 +
    1.83 +   NB: Not all kernel configs need an initial ram disk (initrd), but
    1.84 +   if you do specify one you need you'll need to use 'module' grub
    1.85 +   directive rather than 'initrd'.
    1.86  
    1.87 -   For <mem-kb> you should specify the amount of memory, in kilobytes,
    1.88 -   to allocate for use by your initial XenLinux virtual machine. Note
    1.89 -   that Xen itself reserves about 32MB memory for internal use, which
    1.90 -   is not available for allocation to virtual machines.
    1.91 -   For <root-dev>, specify your usual root partition (e.g., /dev/hda1).
    1.92 +   The linux command line takes all the usual options, such as
    1.93 +   root=<root-dev> to specify your usual root partition (e.g.,
    1.94 +   /dev/hda1).  
    1.95  
    1.96 -3. Reboot your system and select the "Xen 2.0 / XenLinux 2.6" menu
    1.97 -   option. After booting Xen, XenLinux will start and your
    1.98 -   initialisation scripts should execute in the usual way.
    1.99 +   The Xen command line takes a number of optional arguments described
   1.100 +   in the manual. The most common is 'dom0_mem=xxxM' which sets the
   1.101 +   amount of memory to allocate for use by your initial virtual
   1.102 +   machine (known as domain 0). Note that Xen itself reserves about
   1.103 +   32MB memory for internal use, which is not available for allocation
   1.104 +   to virtual machines.  
   1.105 +
   1.106 +3. Reboot your system and select the "Xen 3.0 / XenLinux 2.6" menu
   1.107 +   option. After booting Xen, Linux will start and your initialisation
   1.108 +   scripts should execute in the usual way.
   1.109  
   1.110  Quick-Start Guide - Source Release
   1.111  ==================================
   1.112 @@ -77,9 +89,11 @@ provided by your Linux distributor:
   1.113      * GCC (preferably v3.2.x or v3.3.x; older versions are unsupported) 
   1.114      * GNU Make
   1.115      * GNU Binutils
   1.116 -    * Development install of libcurl (e.g., libcurl-dev)
   1.117      * Development install of zlib (e.g., zlib-dev)
   1.118 -    * Development install of Python v2.2 or later (e.g., python-dev)
   1.119 +    * Development install of Python v2.3 or later (e.g., python-dev)
   1.120 +    * bridge-utils package (/sbin/brctl)
   1.121 +    * iproute package (/sbin/ip)
   1.122 +    * hotplug or udev
   1.123  
   1.124  [NB. Unless noted otherwise, all the following steps should be
   1.125  performed with root privileges.]
   1.126 @@ -105,16 +119,26 @@ On Linux:
   1.127  3. For the very first build, or if you want to destroy existing
   1.128     .configs and build trees, perform the following steps:
   1.129  
   1.130 -    # make world
   1.131 +    # make KERNELS=linux-2.6-xen world
   1.132      # make install
   1.133  
   1.134 -   This will create the directories linux-2.6-xen0/ and
   1.135 -   linux-2.6-xenU/ after first cleaning everything. It will
   1.136 -   create and install into the dist/ directory which is the
   1.137 -   default install location. It will build the xen binary
   1.138 -   (xen.gz), the boot images for dom0 and an unprivileged
   1.139 -   guest kernel (vmlinuz-2.6.x-xen0 and vmlinuz-2.6.x-xenU
   1.140 -   respectively), the tools and the documentation.
   1.141 +   It will create and install into the dist/ directory which is the
   1.142 +   default install location. It will build the xen binary (xen.gz),
   1.143 +   and a linux kernel and modules that can be used in both dom0 and an
   1.144 +   unprivileged guest kernel (vmlinuz-2.6.x-xen), the tools and the
   1.145 +   documentation.
   1.146 +
   1.147 +   If you don't specify KERNELS= on the make command line it will
   1.148 +   default to building two kernels, vmlinuz-2.6.x-xen0 and
   1.149 +   vmlinuz-2.6.x-xenU. These are smaller builds with just selected
   1.150 +   modules, intended primarilly for developers that don't like to wait
   1.151 +   for a -xen kernel to build. The -xenU kernel is particularly small
   1.152 +   as it does not contain any physical device drivers, and hence is
   1.153 +   only useful for guest domains.
   1.154 +
   1.155 +   If you want to build an x86_32 PAE capable xen and kernel to work
   1.156 +   on machines with >= 4GB of memory, use XEN_TARGET_X86_PAE=y on the
   1.157 +   make command line.
   1.158  
   1.159  4. To rebuild an existing tree without modifying the config:
   1.160      # make dist
   1.161 @@ -124,20 +148,22 @@ 4. To rebuild an existing tree without m
   1.162  
   1.163  5. To rebuild a kernel with a modified config:
   1.164  
   1.165 -    # cd linux-2.6-xen0            # or linux-2.6-xenU
   1.166 +    # cd linux-2.6.12-xen          # or linux-2.6.12-xen0 etc.
   1.167      # make ARCH=xen menuconfig     # or xconfig
   1.168      # cd ..
   1.169      # make dist
   1.170      # make install
   1.171  
   1.172 -   You can copy your own config into linux-2.6-xen0 first.
   1.173     Alternatively, you can also copy your config file to
   1.174     dist/install/boot/config-$version-xen0/U.  This is picked up
   1.175     when a make dist is done. Include the ARCH=xen directive for
   1.176     all make commands when building the kernels.
   1.177  
   1.178 -6. To see a full list of targets and a brief description, type:
   1.179 -    # make help
   1.180 +   NB: The need to specify ARCH=xen when building linux is likely to
   1.181 +   disappear soon: the Xen patch is being rearranged to become just
   1.182 +   another config option rather than a separate 'architecture'.
   1.183  
   1.184 -7. Edit your grub.conf file as described above to have an
   1.185 -   appropriate entry for your new kernel.
   1.186 +   Depending on your config, you may need to use 'mkinitrd' to create
   1.187 +   an initial ram disk, just like a native system e.g. 
   1.188 +    # depmod 2.6.12.6-xen
   1.189 +    # mkinitrd -v -f --with=aacraid --with=sd_mod --with=scsi_mod initrd-2.6.12.6-xen.img 2.6.12.6-xen
     2.1 --- a/tools/examples/xend-config.sxp	Sat Dec 03 11:41:49 2005 +0100
     2.2 +++ b/tools/examples/xend-config.sxp	Sat Dec 03 20:05:39 2005 +0100
     2.3 @@ -105,7 +105,7 @@
     2.4  # Dom0 will balloon out when needed to free memory for domU.
     2.5  # dom0-min-mem is the lowest memory level (in MB) dom0 will get down to.
     2.6  # If dom0-min-mem=0, dom0 will never balloon out.
     2.7 -(dom0-min-mem 0)
     2.8 +(dom0-min-mem 196)
     2.9  
    2.10  # In SMP system, dom0 will use dom0-cpus # of CPUS
    2.11  # If dom0-cpus = 0, dom0 will take all cpus available