ia64/xen-unstable

annotate README @ 5225:13e24e7bb79d

bitkeeper revision 1.1159.258.159 (429c6342A2HJ4wUj0nM5MNauX7azZQ)

vnet-xend.txt, user.tex, README:
Update the Linux kernel version number from 2.6.9 to 2.6 or 2.6.11
in several places in documentation.
Original patch provided by Andrew Thompson <andrewkt@aktzero.com>
Signed-off-by: Christian Limpach <Christian.Limpach@cl.cam.ac.uk>
author cl349@firebug.cl.cam.ac.uk
date Tue May 31 13:14:42 2005 +0000 (2005-05-31)
parents 0956f3af9fd3
children 777fa188124b
rev   line source
mwilli2@2386 1 ###############################
mwilli2@2386 2 __ __ ____ ___
mwilli2@2386 3 \ \/ /___ _ __ |___ \ / _ \
mwilli2@2386 4 \ // _ \ '_ \ __) || | | |
mwilli2@2386 5 / \ __/ | | | / __/ | |_| |
mwilli2@2386 6 /_/\_\___|_| |_| |_____(_)___/
mwilli2@2386 7
mwilli2@2386 8 ###############################
iap10@706 9
iap10@706 10 University of Cambridge Computer Laboratory
kaf24@2849 11 3 November 2004
iap10@706 12
mwilli2@2762 13 http://www.cl.cam.ac.uk/netos/xen/
iap10@706 14
kaf24@2849 15 What is Xen?
kaf24@2849 16 ============
iap10@706 17
kaf24@2781 18 Xen is a Virtual Machine Monitor (VMM) originally developed by the
iap10@1061 19 Systems Research Group of the University of Cambridge Computer
kaf24@2781 20 Laboratory, as part of the UK-EPSRC funded XenoServers project.
kaf24@2849 21 Xen is freely-distributable Open Source software, released under the
kaf24@2849 22 GNU GPL.
iap10@706 23
kaf24@2781 24 The 2.0 release offers excellent performance, hardware support and
kaf24@2781 25 enterprise-grade features such as live migration. Linux 2.6, 2.4 and
kaf24@2781 26 NetBSD 2.0 are already available for Xen, with more operating system
kaf24@2781 27 ports on the way.
iap10@771 28
kaf24@2849 29 This file contains some quick-start instructions to install Xen on
kaf24@2849 30 your system. For full documentation, see the Xen User Manual. If this
kaf24@2849 31 is a pre-built release then you can find the manual at:
kaf24@2849 32 dist/install/usr/share/doc/xen/pdf/user.pdf
kaf24@2849 33 If you have a source release, then 'make -C docs' will build the
kaf24@2849 34 manual at docs/pdf/user.pdf.
kaf24@1557 35
kaf24@2849 36 Quick-Start Guide - Pre-Built Binary Release
kaf24@2849 37 ============================================
kaf24@2849 38
kaf24@2849 39 [NB. Unless noted otherwise, all the following steps should be
kaf24@2849 40 performed with root privileges.]
kaf24@2849 41
kaf24@2849 42 1. Install the binary distribution onto your filesystem:
kaf24@2849 43 # sh ./install.sh
kaf24@2849 44 Amongst other things, this will install Xen and XenLinux kernel
kaf24@2849 45 files in /boot, kernel modules and Python packages in /lib, and
kaf24@2849 46 various control tools in standard 'bin' directories.
kaf24@2849 47
kaf24@2849 48 2. Configure your bootloader to boot Xen and an initial Linux virtual
kaf24@2849 49 machine. Note that Xen currently only works with GRUB: less common
kaf24@2849 50 alternatives such as LILO are *not* supported. You can most likely
kaf24@2849 51 find your GRUB menu file at /boot/grub/menu.lst: edit this file to
kaf24@2849 52 include an entry like the following:
cl349@5225 53 # title Xen 2.0 / XenLinux 2.6
cl349@5225 54 # kernel /boot/xen-2.0.gz dom0_mem=<mem-kb> console=vga
cl349@5225 55 # module /boot/vmlinuz-2.6-xen0 root=<root-dev> ro console=tty0
kaf24@2849 56 For <mem-kb> you should specify the amount of memory, in kilobytes,
kaf24@2849 57 to allocate for use by your initial XenLinux virtual machine. Note
kaf24@2849 58 that Xen itself reserves about 32MB memory for internal use, which
kaf24@2849 59 is not available for allocation to virtual machines.
kaf24@2849 60 For <root-dev>, specify your usual root partition (e.g., /dev/hda1).
kaf24@2849 61
cl349@5225 62 3. Reboot your system and select the "Xen 2.0 / XenLinux 2.6" menu
kaf24@2849 63 option. After booting Xen, XenLinux will start and your
kaf24@2849 64 initialisation scripts should execute in the usual way.
kaf24@2849 65
kaf24@2849 66 Quick-Start Guide - Source Release
kaf24@2849 67 ==================================
kaf24@2849 68
kaf24@2849 69 First, there are a number of prerequisites for building a Xen source
kaf24@2849 70 release. Make sure you have all the following installed, either by
kaf24@2849 71 visiting the project webpage or installing a pre-built package
kaf24@2849 72 provided by your Linux distributor:
kaf24@2849 73 * GCC (preferably v3.2.x or v3.3.x; older versions are unsupported)
kaf24@2849 74 * GNU Make
kaf24@2849 75 * GNU Binutils
kaf24@2849 76 * Development install of libcurl (e.g., libcurl-dev)
kaf24@2849 77 * Development install of zlib (e.g., zlib-dev)
kaf24@2849 78 * Development install of Python v2.2 or later (e.g., python-dev)
kaf24@2849 79
kaf24@2849 80 [NB. Unless noted otherwise, all the following steps should be
kaf24@2849 81 performed with root privileges.]