debuggers.hg

view README @ 21067:b4a1832a916f

Update Xen version to 4.0.0-rc6
author Keir Fraser <keir.fraser@citrix.com>
date Tue Mar 09 18:18:05 2010 +0000 (2010-03-09)
parents 71af69a9d393
children 1bcd2519a11a
line source
1 #################################
2 __ __ _ _ ___
3 \ \/ /___ _ __ | || | / _ \
4 \ // _ \ '_ \ | || |_| | | |
5 / \ __/ | | | |__ _| |_| |
6 /_/\_\___|_| |_| |_|(_)___/
8 #################################
10 http://www.xen.org/
12 What is Xen?
13 ============
15 Xen is a Virtual Machine Monitor (VMM) originally developed by the
16 Systems Research Group of the University of Cambridge Computer
17 Laboratory, as part of the UK-EPSRC funded XenoServers project. Xen
18 is freely-distributable Open Source software, released under the GNU
19 GPL. Since its initial public release, Xen has grown a large
20 development community, spearheaded by xen.org (http://www.xen.org).
22 The 4.0 release offers excellent performance, hardware support and
23 enterprise-grade features such as x86_32-PAE, x86_64, SMP guests and
24 live relocation of VMs. Ports to Linux, NetBSD, FreeBSD and Solaris
25 are available from the community.
27 This file contains some quick-start instructions to install Xen on
28 your system. For full documentation, see the Xen User Manual. If this
29 is a pre-built release then you can find the manual at:
30 dist/install/usr/share/doc/xen/pdf/user.pdf
31 If you have a source release, then 'make -C docs' will build the
32 manual at docs/pdf/user.pdf.
34 Quick-Start Guide
35 =================
37 First, there are a number of prerequisites for building a Xen source
38 release. Make sure you have all the following installed, either by
39 visiting the project webpage or installing a pre-built package
40 provided by your Linux distributor:
41 * GCC v3.4 or later
42 * GNU Make
43 * GNU Binutils
44 * Development install of zlib (e.g., zlib-dev)
45 * Development install of Python v2.3 or later (e.g., python-dev)
46 * Development install of curses (e.g., libncurses-dev)
47 * Development install of openssl (e.g., openssl-dev)
48 * Development install of x11 (e.g. xorg-x11-dev)
49 * bridge-utils package (/sbin/brctl)
50 * iproute package (/sbin/ip)
51 * hotplug or udev
52 * GNU bison and GNU flex
54 [NB. Unless noted otherwise, all the following steps should be
55 performed with root privileges.]
57 1. Download and untar the source tarball file. This will be a
58 file named xen-unstable-src.tgz, or xen-$version-src.tgz.
59 You can also pull the current version from the mercurial
60 repository at http://xenbits.xensource.com/
62 # tar xzf xen-unstable-src.tgz
64 Assuming you are using the unstable tree, this will
65 untar into xen-unstable. The rest of the instructions
66 use the unstable tree as an example, substitute the
67 version for unstable.
69 2. cd to xen-unstable (or whatever you sensibly rename it to).
71 On Linux:
73 3. For the very first build, or if you want to destroy existing
74 .configs and build trees, perform the following steps:
76 # make world
77 # make install
79 This will create and install onto the local machine. It will build
80 the xen binary (xen.gz), and a linux kernel and modules that can be
81 used in both dom0 and an unprivileged guest kernel (vmlinuz-2.6.x-xen),
82 the tools and the documentation.
84 You can override the destination for make install by setting DESTDIR
85 to some value.
87 The make command line defaults to building the kernel vmlinuz-2.6.x-xen.
88 You can override this default by specifying KERNELS=kernelname. For
89 example, you can make two kernels - linux-2.6-xen0
90 and linux-2.6-xenU - which are smaller builds containing only selected
91 modules, intended primarily for developers that don't like to wait
92 for a full -xen kernel to build. The -xenU kernel is particularly small,
93 as it does not contain any physical device drivers, and hence is
94 only useful for guest domains.
96 To make these two kernels, simply specify
98 KERNELS="linux-2.6-xen0 linux-2.6-xenU"
100 in the make command line.
102 4. To rebuild an existing tree without modifying the config:
103 # make dist
105 This will build and install xen, kernels, tools, and
106 docs into the local dist/ directory.
108 You can override the destination for make install by setting DISTDIR
109 to some value.
111 make install and make dist differ in that make install does the
112 right things for your local machine (installing the appropriate
113 version of hotplug or udev scripts, for example), but make dist
114 includes all versions of those scripts, so that you can copy the dist
115 directory to another machine and install from that distribution.
117 5. To rebuild a kernel with a modified config:
119 # make linux-2.6-xen-config CONFIGMODE=menuconfig (or xconfig)
120 # make linux-2.6-xen-build
121 # make linux-2.6-xen-install
123 Depending on your config, you may need to use 'mkinitrd' to create
124 an initial ram disk, just like a native system e.g.
125 # depmod 2.6.18-xen
126 # mkinitrd -v -f --with=aacraid --with=sd_mod --with=scsi_mod initrd-2.6.18-xen.img 2.6.18-xen
128 Other systems may requires the use of 'mkinitramfs' to create the
129 ram disk.
130 # depmod 2.6.18-xen
131 # mkinitramfs -o initrd-2.6.18-xen.img 2.6.18-xen
134 Python Runtime Libraries
135 ========================
137 Xend (the Xen daemon) has the following runtime dependencies:
139 * Python 2.3 or later.
140 In many distros, the XML-aspects to the standard library
141 (xml.dom.minidom etc) are broken out into a separate python-xml package.
142 This is also required.
144 URL: http://www.python.org/
145 Debian: python, python-xml
147 * For optional SSL support, pyOpenSSL:
148 URL: http://pyopenssl.sourceforge.net/
149 Debian: python-pyopenssl
151 * For optional PAM support, PyPAM:
152 URL: http://www.pangalactic.org/PyPAM/
153 Debian: python-pam
155 * For optional XenAPI support in XM, PyXML:
156 URL: http://pyxml.sourceforge.net
157 YUM: PyXML
160 Intel(R) Trusted Execution Technology Support
161 =============================================
163 Intel's technology for safer computing, Intel(R) Trusted Execution Technology
164 (Intel(R) TXT), defines platform-level enhancements that provide the building
165 blocks for creating trusted platforms. For more information, see
166 http://www.intel.com/technology/security/.
168 Intel(R) TXT support is provided by the Trusted Boot (tboot) module in
169 conjunction with minimal logic in the Xen hypervisor.
171 Tboot is an open source, pre- kernel/VMM module that uses Intel(R) TXT to
172 perform a measured and verified launch of an OS kernel/VMM.
174 The Trusted Boot module is available from
175 http://sourceforge.net/projects/tboot. This project hosts the code in a
176 mercurial repo at http://tboot.sourceforge.net/hg/tboot.hg and contains
177 tarballs of the source. Instructions in the tboot README describe how
178 to modify grub.conf to use tboot to launch Xen.
180 There are optional targets as part of Xen's top-level makefile that will
181 download and build tboot: install-tboot, build-tboot, dist-tboot, clean-tboot.
182 These will download the latest tar file from the SourceForge site using wget,
183 then build/install/dist according to Xen's settings.