ia64/xen-unstable

changeset 8229:1deae55b1f5c

Incorporating Alan's mods.
author kmself@ix.netcom.com
date Fri Dec 02 17:13:55 2005 -0700 (2005-12-02)
parents dcfeb9e234d1
children bc7567741a4c
files docs/src/user/debian.tex docs/src/user/fedora.tex docs/src/user/installation.tex docs/src/user/rhel.tex
line diff
     1.1 --- a/docs/src/user/debian.tex	Fri Dec 02 14:50:08 2005 -0700
     1.2 +++ b/docs/src/user/debian.tex	Fri Dec 02 17:13:55 2005 -0700
     1.3 @@ -1,158 +1,173 @@
     1.4 -\chapter{Installing Xen on Debian}
     1.5 +\chapter{Installing Xen/XenLinux on Debian}
     1.6  
     1.7 -The Debian project provides a tool called \path{debootstrap} which
     1.8 -allows a base Debian system to be installed into a filesystem without
     1.9 -requiring the host system to have any Debian-specific software (such as
    1.10 -\path{apt}).
    1.11 +This appendix describes installing Xen 3.0 on Debian Linux.
    1.12 +
    1.13 +Xen can be installed on Debian GNU/Linux using the following methods:
    1.14  
    1.15 -Here's some info on how to install Debian 3.1 (Sarge) for an
    1.16 -unprivileged Xen domain:
    1.17 -
    1.18 -\section{Filesystem Setup}
    1.19 -\begin{enumerate}
    1.20 -\item Set up Xen and test that it's working, as described earlier in
    1.21 -  this manual.
    1.22 +\begin{itemize}
    1.23 +\item From a binary tarball
    1.24 +\item From source 
    1.25 +\item From debs
    1.26 +\end{itemize}
    1.27  
    1.28 -\item Create disk images for rootfs and swap. Alternatively, you might
    1.29 -  create dedicated partitions, LVM logical volumes, etc.\ if that suits
    1.30 -  your setup.
    1.31 +\section{Installing from a binary tarball}
    1.32 +This section describes the process of installing Xen on Debian Sarge using the stable binary release tarball.
    1.33 +
    1.34 +\subsection{Required Packages}
    1.35 +Install these Debian packages:
    1.36 +
    1.37 +\begin{itemize}
    1.38 +\item bridge-utils
    1.39 +\item libcurl3-dev
    1.40 +\item iproute
    1.41 +\item zlib1g-dev
    1.42 +\item python-dev
    1.43 +\end{itemize}
    1.44 +
    1.45  \begin{verbatim}
    1.46 -dd if=/dev/zero of=/path/diskimage bs=1024k count=size_in_mbytes
    1.47 -dd if=/dev/zero of=/path/swapimage bs=1024k count=size_in_mbytes
    1.48 -\end{verbatim}
    1.49 -  If you're going to use this filesystem / disk image only as a
    1.50 -  `template' for other vm disk images, something like 300 MB should be
    1.51 -  enough. (of course it depends what kind of packages you are planning
    1.52 -  to install to the template)
    1.53 -
    1.54 -\item Create the filesystem and initialise the swap image
    1.55 -\begin{verbatim}
    1.56 -mkfs.ext3 /path/diskimage
    1.57 -mkswap /path/swapimage
    1.58 +apt-get install bridge-utils   libcurl3-dev iproute  zlib1g-dev python-dev
    1.59  \end{verbatim}
    1.60  
    1.61 -\item Mount the disk image for installation
    1.62 -\begin{verbatim}
    1.63 -mount -o loop /path/diskimage /mnt/disk
    1.64 -\end{verbatim}
    1.65 -\end{enumerate}
    1.66 -\section{Bootstrapping}
    1.67 -\begin{enumerate}
    1.68 -\item Install \path{debootstrap}. Make sure you have debootstrap
    1.69 -  installed on the host. If you are running Debian Sarge (3.1 / testing)
    1.70 -  or unstable you can install it by running \path{apt-get install
    1.71 -    debootstrap}. Otherwise, it can be downloaded from the Debian
    1.72 -  project website.
    1.73 +
    1.74 +\subsection{Download the binary tarball}
    1.75 +Download the Xen 3.0 binary tarball from the XenSource downloads
    1.76 +page:
    1.77  
    1.78 -\item Install Debian base to the disk image:
    1.79 +\begin{quote} {\tt http://www.xensource.com/downloads/}
    1.80 +\end{quote}
    1.81 + 
    1.82 +\subsection{Extract and Install}
    1.83  \begin{verbatim}
    1.84 -debootstrap --arch i386 sarge /mnt/disk  \
    1.85 -            http://ftp.<countrycode>.debian.org/debian
    1.86 -\end{verbatim}
    1.87 -  You may use any Debian mirror that you want.
    1.88 -\end{enumerate}
    1.89 -
    1.90 -\section{Configuration}
    1.91 -\begin{enumerate}
    1.92 -\item When debootstrap completes successfully, modify settings:
    1.93 -\begin{verbatim}
    1.94 -chroot /mnt/disk /bin/bash
    1.95 +#  tar zxvf 
    1.96 +xen-2.0.7-install-x86_32.tgz
    1.97 +# cd xen-2.0.7-install-x86_32.tgz
    1.98 +# ./install.sh
    1.99  \end{verbatim}
   1.100  
   1.101 -  Edit the following files using vi or nano and make any required
   1.102 -  changes:
   1.103 +If everything goes well, you should something like
   1.104 +
   1.105  \begin{verbatim}
   1.106 -/etc/hostname
   1.107 -/etc/hosts
   1.108 -/etc/resolv.conf
   1.109 -/etc/network/interfaces
   1.110 -/etc/networks
   1.111 -\end{verbatim}
   1.112 -
   1.113 -  Set up access to the services. Edit:
   1.114 -\begin{verbatim}
   1.115 -/etc/hosts.deny
   1.116 -/etc/hosts.allow
   1.117 -/etc/inetd.conf
   1.118 +Installing Xen from 
   1.119 +'./install' to '/'...
   1.120 +    All done.
   1.121 +    Checking to see whether prerequisite tools are installed...
   1.122 +    All done.
   1.123  \end{verbatim}
   1.124  
   1.125 -  Add Debian mirror to:
   1.126 -\begin{verbatim}
   1.127 -/etc/apt/sources.list
   1.128 -\end{verbatim}
   1.129  
   1.130 -  Create fstab like this:
   1.131 -\begin{verbatim}
   1.132 -/dev/sda1       /       ext3    errors=remount-ro       0       1
   1.133 -/dev/sda2       none    swap    sw                      0       0
   1.134 -proc            /proc   proc    defaults                0       0
   1.135 -\end{verbatim}
   1.136 +\subsection{Configure grub}
   1.137 +Make an entry in your grub configuration like below.
   1.138  
   1.139 -  Logout
   1.140 -
   1.141 -\item Unmount the disk image
   1.142 +{\small
   1.143  \begin{verbatim}
   1.144 -umount /mnt/disk
   1.145 +title          Xen on Debian
   1.146 +kernel         (hd0,5)/boot/xen.gz dom0_mem=131000
   1.147 +module         (hd0,5)/boot/vmlinuz-2.6-xen0 root=/dex/hda6 ro console=tty0
   1.148  \end{verbatim}
   1.149 +}
   1.150 +
   1.151 +You can now boot into Xen by by choosing the right option from grub menu.
   1.152 +
   1.153 +\section{Installing from source}
   1.154 +\subsection{Required Packages}
   1.155 +Besides packages mentioned under binary tarball install, you will need:
   1.156 +
   1.157 +\begin{itemize}
   1.158 +\item gcc v3.2.x or v3.3.x
   1.159 +\item binutils
   1.160 +\item GNU make
   1.161 +\end{itemize}
   1.162 +
   1.163  
   1.164 -\item Create Xen 3.0 configuration file for the new domain. You may use
   1.165 -  the example-configurations provided with Xen as a template.
   1.166 +\subsection{Download the source tree}
   1.167 +The Xen source tree is available as either a compressed source tarball
   1.168 +or as a clone of our master Mercurial repository.
   1.169  
   1.170 -  Make sure you have the correctly configured:
   1.171 +\begin{description}
   1.172 +\item[Obtaining the Source Tarball]\mbox{} \\
   1.173 +  Stable versions and daily snapshots of the Xen source tree are
   1.174 +  available from the Xen download page:
   1.175 +  \begin{quote} {\tt http://www.xensource.com/downloads/}
   1.176 +  \end{quote}
   1.177 +\item[Obtaining the source via Mercurial]\mbox{} \\
   1.178 +  The source tree may also be obtained via the public Mercurial
   1.179 +  repository hosted at:
   1.180 +  \begin{quote}{\tt http://xenbits.xensource.com}.
   1.181 +  \end{quote} See the instructions and the Getting Started Guide
   1.182 +  referenced at:
   1.183 +  \begin{quote}
   1.184 +    {\tt http://www.xensource.com/downloads/}.
   1.185 +  \end{quote}
   1.186 +\end{description}
   1.187 +
   1.188 +\subsection{Extract, build and install}
   1.189 +
   1.190  \begin{verbatim}
   1.191 -disk = [ 'file:/path/diskimage,sda1,w', 'file:/path/swapimage,sda2,w' ]
   1.192 -root = "/dev/sda1 ro"
   1.193 -\end{verbatim}
   1.194 -\end{enumerate}
   1.195 -
   1.196 -\section{Starting the New Domain}
   1.197 -\begin{enumerate}
   1.198 -\item Start the new domain
   1.199 -\begin{verbatim}
   1.200 -xm create -f domain_config_file
   1.201 +# tar zxvf xen-3.0.0-src.tgz
   1.202 +# cd xen-3.0
   1.203 +# make dist
   1.204 +#./install.sh
   1.205  \end{verbatim}
   1.206  
   1.207 -  Check that the new domain is running:
   1.208 +\section{Installing from debs}
   1.209 +This section describes the process of installing Xen on Debian Sarge using debs created by Edward Despard.
   1.210 +
   1.211 +\subsection{Edward's announcement to xen-user list}
   1.212 +"For part of my Google Summer of Code work I've put together debs for xen of 2.0.7 and of unstable. The unstable debs are built off of yesterday's hg tree, but I try to update them fairly regularly when new developments occur." 
   1.213 +
   1.214 +\subsection{Adding apt source}
   1.215 +Add the following lines to \path{/etc/apt/sources.list}:
   1.216 +
   1.217 +\begin{quote}
   1.218 +{\small
   1.219  \begin{verbatim}
   1.220 -xm list
   1.221 +deb http://tinyurl.com/8tpup
   1.222  \end{verbatim}
   1.223 +}
   1.224 +\end{quote}
   1.225 +   
   1.226 +Note: On Ubuntu, simple replace debian with ubuntu in the above. Replace xen-unstable with with xen-stable for a stable version.
   1.227  
   1.228 -\item Attach to the console of the new domain. You should see something
   1.229 -  like this when starting the new domain:
   1.230 +Now run \path{aptitude update} or \path{apt-get update}. Doing \path{apt-cache search xen}, you should see following packages in the output.
   1.231 +
   1.232 +\begin{itemize}
   1.233 +\item kernel-image-2.6.12-xen0 - Xen 2.6 kernel image
   1.234 +\item kernel-image-2.6.12-xenu - Xen 2.6 kernel image
   1.235 +\item kernel-patch-xen-2.6.12 - patch to kernel to support xen
   1.236 +\item libxen3.0 - control libraries for Xen
   1.237 +\item libxen-dev - development libraries for Xen
   1.238 +\item xen-doc - documentation for Xen
   1.239 +\item xen-hypervisor - Xen hypervisor kernel
   1.240 +\item xen-kernels - Xen kernels
   1.241 +\item xen - Package to install all of Xen
   1.242 +\item xen-tools - Tools for managing xen domains
   1.243 +\end{itemize}
   1.244 +
   1.245 +\subsection{Installing Xen}
   1.246 +You can now install xen using \path{apt-get}, \path{aptitude}, \path{synaptic}, etc. 
   1.247 + 
   1.248 +After doing \path{apt-get install xen}, you will have a working dom0 and should be able boot into it without any problem. By doing \path{apt-cache depends xen}, you will find that the following packages were also installed as a result of dependency.
   1.249  
   1.250  \begin{verbatim}
   1.251 -Started domain testdomain2, console on port 9626
   1.252 -\end{verbatim}
   1.253 -        
   1.254 -  You can see the ID of the console: 26. You can also list the consoles
   1.255 -  with \path{xm consoles}. ID is the last two digits of the port number.
   1.256 -
   1.257 -  Attach to the console:
   1.258 -
   1.259 -\begin{verbatim}
   1.260 -xm console 26
   1.261 +#  apt-cache  
   1.262 +depends  xen
   1.263 +       xen
   1.264 +           Depends: xen-doc
   1.265 +           Depends: xen-kernels
   1.266 +           Depends: xen-hypervisor
   1.267 +           Depends: xen-tools
   1.268  \end{verbatim}
   1.269  
   1.270 -  or by telnetting to the port 9626 of localhost. The xm console program
   1.271 -  works better.
   1.272  
   1.273 -\item Log in and run base-config
   1.274 -
   1.275 -  By default there is no password set for root.
   1.276 -
   1.277 -  Check that everything looks OK, and the system started without errors.
   1.278 -  Check that the swap is active, and the network settings are correct.
   1.279 -
   1.280 -  Run \path{/usr/sbin/base-config} to configure the Debian settings.
   1.281 +\subsection{xenkernels.conf}
   1.282 +To automate grub entry for xen, \path{/etc/xenkernels.conf} is used which is installed when the package in installed. Below is a sample entry
   1.283  
   1.284 -  Set the password for root using \path{passwd}.
   1.285 -
   1.286 -\item Done. You may exit the console by pressing {\path{Ctrl + ]}}
   1.287 -
   1.288 -\end{enumerate}
   1.289 +\begin{verbatim}
   1.290 +label=Xen(3.0-unstable082205)/Linux(2.6.12)--
   1.291 +          xen=/boot/xen-3.0-unstable082205.gz
   1.292 +          kernel=/boot/xen/dom0/vmlinuz-2.6.12-xen0
   1.293 +          mem=256000
   1.294 +          root=/dev/hda4
   1.295 +\end{verbatim}
   1.296  
   1.297 -If you need to create new domains, you can copy the contents of the
   1.298 -`template'-image to the new disk images, either by mounting the template
   1.299 -and the new image, and using \path{cp -a} or \path{tar} or by simply
   1.300 -copying the image file. Once this is done, modify the image-specific
   1.301 -settings (hostname, network settings, etc).
   1.302 +You have to run run \path{update-grub-xen} every time \path{xenkernels.conf} is modified. Read \path{man update-grub-xen} for more information.
     2.1 --- a/docs/src/user/fedora.tex	Fri Dec 02 14:50:08 2005 -0700
     2.2 +++ b/docs/src/user/fedora.tex	Fri Dec 02 17:13:55 2005 -0700
     2.3 @@ -1,66 +1,102 @@
     2.4 -\chapter{Installing Xen on Red~Hat or Fedora~Core}
     2.5 +\chapter{Installing Xen on Fedora~Core 4}
     2.6 +
     2.7 +This section will help you in installing Xen 3 on Fedora Core 4 using various methods.
     2.8 +
     2.9 +\section{Installing Xen from Source Package and binary package}
    2.10 +
    2.11 +\subsection{Required Packages}
    2.12 +bridge\_utils
    2.13 +
    2.14  
    2.15 -\section{Tips}
    2.16 -Here are a few pointers about using Xen / XenLinux on a Red~Hat or
    2.17 -Fedora~Core distribution:
    2.18 +\subsection{Installing}
    2.19 +
    2.20 +Download the source or binary tarballs available at \begin{quote} {\tt http://www.xensource.com/downloads } \end{quote}.
    2.21 +
    2.22 +Extract the archive using following command:
    2.23 +
    2.24 +\begin{verbatim}
    2.25 +tar -zxvf xen-*****-***.tgz
    2.26 +\end{verbatim}
    2.27 +
    2.28 +cd into the xen directory.
    2.29  
    2.30 -\begin{enumerate}
    2.31 -\item Note that, because domains greater than~0 don't have any
    2.32 -  privileged access at all, certain commands in the default boot
    2.33 -  sequence will fail e.g.\ attempts to update the hwclock, change the
    2.34 -  console font, update the keytable map, start apmd (power management),
    2.35 -  or gpm (mouse cursor). Either ignore the errors (they should be
    2.36 -  harmless), or remove them from the startup scripts. Deleting the
    2.37 -  following links are a good start: {\path{S24pcmcia}},
    2.38 -  {\path{S09isdn}}, {\path{S17keytable}}, {\path{S26apmd}},
    2.39 -  {\path{S85gpm}}.
    2.40 +To compile and install the source do
    2.41 +
    2.42 +\begin{verbatim}
    2.43 +     make dist
    2.44 +     make install
    2.45 +\end{verbatim}
    2.46 +
    2.47 +
    2.48 +To install the binary tarball, all you need to do is run the \path{install.sh} script.
    2.49  
    2.50 -\item If you want to use a single root file system that works cleanly
    2.51 -  for both domain~0 and unprivileged domains, a useful trick is to use
    2.52 -  different `init' run levels. For example, use run level 3 for
    2.53 -  domain~0, and run level 4 for other domains. This enables different
    2.54 -  startup scripts to be run in depending on the run level number passed
    2.55 -  on the kernel command line.
    2.56 +\begin{verbatim}
    2.57 +     #./install.sh
    2.58 +\end{verbatim}
    2.59 +
    2.60 +\subsection{Installing Xen using yum}
    2.61  
    2.62 -\item If using NFS root files systems mounted either from an external
    2.63 -  server or from domain0 there are a couple of other gotchas. The
    2.64 -  default {\path{/etc/sysconfig/iptables}} rules block NFS, so part way
    2.65 -  through the boot sequence things will suddenly go dead.
    2.66 +To install xen, type the command
    2.67 +
    2.68 +\begin{verbatim}
    2.69 +#yum install xen
    2.70 +\end{verbatim}
    2.71 +
    2.72 +This will download the following rpms and install them:
    2.73  
    2.74 -\item If you're planning on having a separate NFS {\path{/usr}}
    2.75 -  partition, the RH9 boot scripts don't make life easy - they attempt to
    2.76 -  mount NFS file systems way to late in the boot process. The easiest
    2.77 -  way I found to do this was to have a {\path{/linuxrc}} script run
    2.78 -  ahead of {\path{/sbin/init}} that mounts {\path{/usr}}:
    2.79 +\begin{itemize}
    2.80 +\item xen
    2.81 +\item bridge-utils
    2.82 +\item sysfsutils
    2.83 +\end{itemize}
    2.84 +
    2.85 +Next we need to install kernel-xen0 and kernel-xenU. Type the command:
    2.86  
    2.87 -  \begin{quote}
    2.88 -    \begin{small}\begin{verbatim}
    2.89 - #!/bin/bash
    2.90 - /sbin/ipconfig lo 127.0.0.1
    2.91 - /sbin/portmap
    2.92 - /bin/mount /usr
    2.93 - exec /sbin/init "$@" <>/dev/console 2>&1
    2.94 -\end{verbatim}\end{small}
    2.95 -  \end{quote}
    2.96 +\begin{verbatim}
    2.97 + yum install kernel-xen0 kernel-xenU 
    2.98 +\end{verbatim}
    2.99  
   2.100 -%% $ XXX SMH: font lock fix :-)
   2.101 +Note: This installs xen0 and xenU kernels and adds an entry in the grub configuration.
   2.102 +Getting Xen up and running
   2.103 +
   2.104 +Once this finishes, you have xen0 and xenU kernels installed in the /boot filesystem. To boot into Dom0, edit the grub configuration file, which is menu.lst
   2.105 +
   2.106 +Note: Installation using yum doesn't require the configuration of grub as mentioned below.
   2.107 +
   2.108 +An example grub entry would be like:
   2.109  
   2.110 -  The one slight complication with the above is that
   2.111 -  {\path{/sbin/portmap}} is dynamically linked against
   2.112 -  {\path{/usr/lib/libwrap.so.0}} Since this is in {\path{/usr}}, it
   2.113 -  won't work. This can be solved by copying the file (and link) below
   2.114 -  the {\path{/usr}} mount point, and just let the file be `covered' when
   2.115 -  the mount happens.
   2.116 +{\small
   2.117 +\begin{verbatim}
   2.118 +title Xen Unstable(From Fedora Core 4)
   2.119 +          root (hd0,0)
   2.120 +          kernel /fedora/xen.gz dom0\_mem=230000 console=vga
   2.121 +          module /fedora/vmlinuz-2.6-xen0 root=/dev/Vol1/LV3 ro console=tty0
   2.122 +          module /fedora/initrd-2.6.11-1.1369\_FC4smp.img
   2.123 +\end{verbatim}
   2.124 +}
   2.125 +
   2.126 +Also make sure that \path{/var/run/xenstored} and \path{/var/lib/xenstored} directories have been created. If they are not, manually create them.
   2.127 +
   2.128 +Now reboot and select the xen0 option from the GRUB menu.
   2.129 +
   2.130 +To check whether you are running the xen0 kernel, type \path{uname -r}
   2.131 +
   2.132 +Now start the xend process:
   2.133  
   2.134 -\item In some installations, where a shared read-only {\path{/usr}} is
   2.135 -  being used, it may be desirable to move other large directories over
   2.136 -  into the read-only {\path{/usr}}. For example, you might replace
   2.137 -  {\path{/bin}}, {\path{/lib}} and {\path{/sbin}} with links into
   2.138 -  {\path{/usr/root/bin}}, {\path{/usr/root/lib}} and
   2.139 -  {\path{/usr/root/sbin}} respectively. This creates other problems for
   2.140 -  running the {\path{/linuxrc}} script, requiring bash, portmap, mount,
   2.141 -  ifconfig, and a handful of other shared libraries to be copied below
   2.142 -  the mount point --- a simple statically-linked C program would solve
   2.143 -  this problem.
   2.144 +\begin{verbatim}
   2.145 +xend start
   2.146 +\end{verbatim}
   2.147 +
   2.148 +To check whether xend process is running or not, type the following command which lists the running domains.
   2.149  
   2.150 -\end{enumerate}
   2.151 \ No newline at end of file
   2.152 +\begin{verbatim}
   2.153 +#xm list
   2.154 +      Name              Id  Mem(MB)  CPU VCPU(s)  State  Time(s)
   2.155 +      Domain-0           0      219    0      1   r-----     28.9
   2.156 +\end{verbatim}
   2.157 +
   2.158 +Since you haven't created any guest domains yet, you would see only Domain0.
   2.159 +
   2.160 +Further Help and documentations
   2.161 +
   2.162 +Besides the usual resources, see the Fedora Quickstart Guide \begin{quote} {\tt http://www.fedoraproject.org/wiki/FedoraXenQuickstart } \end{quote}
     3.1 --- a/docs/src/user/installation.tex	Fri Dec 02 14:50:08 2005 -0700
     3.2 +++ b/docs/src/user/installation.tex	Fri Dec 02 17:13:55 2005 -0700
     3.3 @@ -35,9 +35,10 @@ if you wish to build from source.
     3.4  Once you have satisfied these prerequisites, you can now install either
     3.5  a binary or source distribution of Xen.
     3.6  
     3.7 +
     3.8  \section{Installing from Binary Tarball}
     3.9  
    3.10 -Pre-built tarballs are available for download from the XenSource downloads
    3.11 +Pre-built tarballs are available for download from the Xen download
    3.12  page:
    3.13  \begin{quote} {\tt http://www.xensource.com/downloads/}
    3.14  \end{quote}
    3.15 @@ -52,22 +53,7 @@ Once you've downloaded the tarball, simp
    3.16  Once you've installed the binaries you need to configure your system as
    3.17  described in Section~\ref{s:configure}.
    3.18  
    3.19 -\section{Installing from RPMs}
    3.20 -Pre-built RPMs are available for download from the XenSource downloads
    3.21 -page:
    3.22 -\begin{quote} {\tt http://www.xensource.com/downloads/}
    3.23 -\end{quote}
    3.24  
    3.25 -Once you've downloaded the RPMs, you typically install them via the RPM commands:
    3.26 -\begin{verbatim}
    3.27 -# rpm -ivh \emph{rpmname}
    3.28 -\end{verbatim}
    3.29 -
    3.30 -See the instructions and the Release Notes for each RPM set referenced at:
    3.31 -  \begin{quote}
    3.32 -    {\tt http://www.xensource.com/downloads/}.
    3.33 -  \end{quote}
    3.34 - 
    3.35  \section{Installing from Source}
    3.36  
    3.37  This section describes how to obtain, build and install Xen from source.
    3.38 @@ -102,9 +88,9 @@ or as a clone of our master Mercurial re
    3.39  % \item[\path{tools/}] Xen node controller daemon (Xend), command line
    3.40  %   tools, control libraries
    3.41  % \item[\path{xen/}] The Xen VMM.
    3.42 -% \item[\path{buildconfigs/}] Build configuration files
    3.43  % \item[\path{linux-*-xen-sparse/}] Xen support for Linux.
    3.44 -% \item[\path{patches/}] Experimental patches for Linux.
    3.45 +% \item[\path{linux-*-patches/}] Experimental patches for Linux.
    3.46 +% \item[\path{netbsd-*-xen-sparse/}] Xen support for NetBSD.
    3.47  % \item[\path{docs/}] Various documentation files for users and
    3.48  %   developers.
    3.49  % \item[\path{extras/}] Bonus extras.
    3.50 @@ -235,7 +221,7 @@ destinations.
    3.51  
    3.52  %% Files in \path{install/boot/} include:
    3.53  %% \begin{itemize}
    3.54 -%% \item \path{install/boot/xen-3.0.gz} Link to the Xen 3.0 'kernel'
    3.55 +%% \item \path{install/boot/xen-2.0.gz} Link to the Xen 'kernel'
    3.56  %% \item \path{install/boot/vmlinuz-2.6-xen0} Link to domain 0
    3.57  %%   XenLinux kernel
    3.58  %% \item \path{install/boot/vmlinuz-2.6-xenU} Link to unprivileged
    3.59 @@ -301,11 +287,9 @@ When installing a new kernel, it is reco
    3.60  existing menu options from \path{menu.lst}, as you may wish to boot your
    3.61  old Linux kernel in future, particularly if you have problems.
    3.62  
    3.63 -%% KMS: Additional configurations as an Appendix?
    3.64 -
    3.65  \subsection{Serial Console (optional)}
    3.66  
    3.67 -%% kernel /boot/xen-3.0.gz dom0_mem=131072 com1=115200,8n1
    3.68 +%% kernel /boot/xen-2.0.gz dom0_mem=131072 com1=115200,8n1
    3.69  %% module /boot/vmlinuz-2.6-xen0 root=/dev/sda4 ro
    3.70  
    3.71  In order to configure Xen serial console output, it is necessary to add
    3.72 @@ -327,9 +311,9 @@ necessary to add a line into \path{/etc/
    3.73  \begin{quote} {\small {\tt c:2345:respawn:/sbin/mingetty ttyS0}}
    3.74  \end{quote}
    3.75  
    3.76 -run \path{init q} to force init to re-examine \path{/etc/inittab}, and
    3.77 -you should be able to log in.  Add \path{ttyS0} to \path{/etc/securetty}
    3.78 -to allow root logins over serial console, if it is not already there.
    3.79 +and you should be able to log in. To successfully log in as root over
    3.80 +the serial line will require adding \path{ttyS0} to
    3.81 +\path{/etc/securetty} if it is not already there.
    3.82  
    3.83  \subsection{TLS Libraries}
    3.84  
     4.1 --- a/docs/src/user/rhel.tex	Fri Dec 02 14:50:08 2005 -0700
     4.2 +++ b/docs/src/user/rhel.tex	Fri Dec 02 17:13:55 2005 -0700
     4.3 @@ -1,3 +1,127 @@
     4.4 -\chapter{Installing Xen on Red Hat Enterprise Linux (RHEL)}
     4.5 +\chapter{Installing Xen on Red Hat Enterprise Linux (RHEL) 4.1}
     4.6 +
     4.7 +RedHat Enterprise Linux is the enterprise-grade, certified version of the Red Hat distribution. This section includes resolving dependencies using yum, installing Xen, and creating an initrd for Xen.
     4.8 +
     4.9 +Stable binary release install
    4.10 +Source install
    4.11 +\section{Stable binary release install}
    4.12 +
    4.13 +\subsection{Setup yum repository}
    4.14 +
    4.15 +Setup your yum repository to Dag's Yum Repository or similar. Dag's is recommended.
    4.16 +
    4.17 +\subsection{Required Packages}
    4.18 +
    4.19 +These packages are required:
    4.20 +
    4.21 +\begin{itemize}
    4.22 +\item bridge-utils
    4.23 +\item curl
    4.24 +\item libidn
    4.25 +\item sysfsutils
    4.26 +\end{itemize}
    4.27 +
    4.28 +Use yum to install these packages.
    4.29 +
    4.30 +\begin{verbatim}
    4.31 +yum install bridge-utils curl libidn sysfsutils
    4.32 +\end{verbatim}
    4.33 +
    4.34 +\subsection{Download Xen}
    4.35 +
    4.36 +\subsection{Download the binary tarball}
    4.37 +Download the Xen 3.0 binary tarball from the XenSource downloads page:
    4.38 +
    4.39 +\begin{quote} {\tt http://www.xensource.com/downloads/}
    4.40 +\end{quote}
    4.41 +
    4.42 +\subsection{Extract and Install}
    4.43 +
    4.44 +\begin{verbatim}
    4.45 +tar zxvf xen-unstable-install-x86\_32.tgz
    4.46 +
    4.47 +cd xen-unstable-install
    4.48 +
    4.49 +./install.sh 
    4.50 +\end{verbatim}
    4.51 +
    4.52 +
    4.53 +\subsection{Disable TLS}
    4.54 +
    4.55 +\begin{verbatim}
    4.56 +mv /lib/tls /lib/tls.disabled
    4.57 +\end{verbatim}
    4.58 +
    4.59 +\subsection{Creating initrd}
    4.60 +
    4.61 +You can use the distro's initrd. The following steps show you how to create one yourself for dom0 and domU. The example uses a Domain0 image, so to adatp it, simply use the appropriate image for DomainU.
    4.62 +
    4.63 +\begin{verbatim}
    4.64 +run depmod 2.x.y-xen0 to re-create modules dependency
    4.65 +
    4.66 +mkinitrd  /boot/initrd-2.x.y-xen0.img  2.x.y-xen0 
    4.67 +\end{verbatim}
    4.68  
    4.69 -Placeholder.
    4.70 +If you get an error
    4.71 +
    4.72 +\begin{verbatim}
    4.73 +   "No module xxx found for kernel 2.x.y-xen0, aborting."
    4.74 +\end{verbatim}
    4.75 +
    4.76 +uncheck xxx in \path{/etc/modprobe.conf} if you don't want support for xxx. If you know that its built into kernel (to check \path{grep -i xxx config-2.6.12-xen0}) you can do
    4.77 +
    4.78 +\begin{verbatim}
    4.79 +mkinitrd  --builtin=aic7xxx  ./2.6.12-xen0.img  2.6.12-xen0
    4.80 +\end{verbatim}
    4.81 +
    4.82 +If another yyy module is reported as "not found,"
    4.83 +
    4.84 +\begin{verbatim}
    4.85 +mkinitrd  --builtin=xxx --builtin=yyy ./2.6.12-xen0.img  2.6.12-xen0
    4.86 +\end{verbatim}
    4.87 +
    4.88 +\subsection{Grub Configuration}
    4.89 +
    4.90 +As usual, you need to make entry in grub configuration file for Xen. Here's a sample grub entry.
    4.91 +
    4.92 +{\small
    4.93 +\begin{verbatim}
    4.94 +title  Xen/RHEL 4.1
    4.95 +       kernel (hd0,5)/boot/xen.gz dom0\_mem=256000
    4.96 +       module (hd0,5)/boot/vmlinuz-2.6.11.12-xen0 root=/dev/hda6
    4.97 +       module (hd0,5)/boot/initrd-2.6.11.12-xen0.img
    4.98 +\end{verbatim}
    4.99 +}
   4.100 +
   4.101 +\section{Source install}
   4.102 +
   4.103 +
   4.104 +\subsection{Download Source Tarball}
   4.105 +
   4.106 +\subsection{Download the binary tarball}
   4.107 +Download the Xen 3.0 binary tarball from the XenSource downloads page:
   4.108 +
   4.109 +\begin{quote} {\tt http://www.xensource.com/downloads/}
   4.110 +\end{quote}
   4.111 +
   4.112 +\subsection{Pre-requisites to build from source}
   4.113 +
   4.114 +Make sure you have all packages. If you had chosen to install Development tools during the distro installation, you should not need to install any extra packages. If not, install the following:
   4.115 +
   4.116 +\begin{itemize}
   4.117 +\item gcc-3.4.3-22.1
   4.118 +\item python-devel-2.3.4-14.1
   4.119 +\item zlib-devel-1.2.1.2-1
   4.120 +\item curl-devel-7.12.1-5.rhel4
   4.121 +\end{itemize}
   4.122 +
   4.123 +\subsection{Install Xen}
   4.124 +
   4.125 +\begin{verbatim}
   4.126 +tar zxvf xen-unstable-src.tgz
   4.127 +cd xen-unstable/
   4.128 +make world
   4.129 +make install
   4.130 +\end{verbatim}
   4.131 +
   4.132 +The rest of the steps follow as with the binary tarball installation.