ia64/xen-unstable

changeset 2649:7f08e61ddff5

bitkeeper revision 1.1159.1.239 (41700370a12BGC5Fm9y82vYtXAmK8w)

Merge ssh://srg//auto/groups/xeno/BK/xeno-unstable.bk
into equilibrium.research:/home/irchomes/mwilli2/xeno-docs.bk
author mwilli2@equilibrium.research
date Fri Oct 15 17:05:52 2004 +0000 (2004-10-15)
parents 4c9db2750868 db9510b8c982
children d7ee91c5f868
files docs/user.tex
line diff
     1.1 --- a/docs/user.tex	Fri Oct 15 17:04:44 2004 +0000
     1.2 +++ b/docs/user.tex	Fri Oct 15 17:05:52 2004 +0000
     1.3 @@ -587,6 +587,34 @@ the {\tt xmdefconfig} file.  The tool us
     1.4  \path{/etc/xen/xmdefconfig} file, since no custom configuration file
     1.5  was specified on the command line.
     1.6  
     1.7 +\section{Example: ttylinux}
     1.8 +
     1.9 +Ttylinux is a very small Linux distribution, designed to
    1.10 +require very few resources.  We will use it as a concrete example of
    1.11 +how to start a Xen domain.  Most users will probably want to install a
    1.12 +more complex mainstream distribution once they have mastered the
    1.13 +basics.
    1.14 +
    1.15 +\begin{enumerate}
    1.16 +\item Download the ttylinux disk image from XXX where from?
    1.17 +\item Create a configuration file like the following:
    1.18 +\begin{verbatim}
    1.19 +kernel = "/boot/vmlinuz-2.6.8.1-xenU" # or a 2.4 kernel or a xen0 kernel
    1.20 +memory = 64
    1.21 +name = "ttylinux"
    1.22 +cpu = -1 # leave to Xen to pick
    1.23 +nics=1
    1.24 +ip="1.2.3.4"
    1.25 +disk = ['file:/path/to/ttylinux-disk,sda1,w']
    1.26 +root = "/dev/sda1 ro"
    1.27 +\end{verbatim}
    1.28 +\item Now start the domain and connect to its console:
    1.29 +\begin{verbatim}
    1.30 +xm create -f configfile -c
    1.31 +\end{verbatim}
    1.32 +\item Login as root, password root.
    1.33 +\end{enumerate}
    1.34 +
    1.35  \section{Starting / Stopping domains automatically}
    1.36  
    1.37  It is possible to have certain domains start automatically at boot
    1.38 @@ -594,11 +622,11 @@ time and to have dom0 wait for all runni
    1.39  it shuts down the system.
    1.40  
    1.41  To specify a domain is to start at boot-time, place its
    1.42 -configuration file (or a link to it) under /etc/xen/auto/.
    1.43 +configuration file (or a link to it) under \path{/etc/xen/auto/}.
    1.44  
    1.45  A Sys-V style init script for RedHat and LSB-compliant systems is
    1.46 -provided and will be automatically copied to /etc/init.d/ during
    1.47 -install.  You can then enable it in the appriate way for your
    1.48 +provided and will be automatically copied to \path{/etc/init.d/}
    1.49 +during install.  You can then enable it in the appriate way for your
    1.50  distribution.
    1.51  
    1.52  For instance, on RedHat:
    1.53 @@ -608,7 +636,7 @@ For instance, on RedHat:
    1.54  By default, this will start the boot-time domains in runlevels 3, 4
    1.55  and 5.
    1.56  
    1.57 -You can also use the "service" command to run this script manually, e.g:
    1.58 +You can also use the {\tt service} command to run this script manually, e.g:
    1.59  
    1.60  \verb_# service xendomains start_
    1.61  
    1.62 @@ -901,6 +929,10 @@ The available commands are as follows:
    1.63                             since it is responsible for managing multiple
    1.64                             ``supervisor'' kernels.
    1.65  
    1.66 +\item[Live migration]      A technique for moving a running virtual
    1.67 +                           machine to another physical host, without
    1.68 +			   stopping it or the services running on it.
    1.69 +
    1.70  \item[Microkernel]         A small base of code running at the highest
    1.71                             hardware privilege level.  A microkernel is
    1.72                             responsible for sharing CPU and memory (and
    1.73 @@ -920,6 +952,13 @@ The available commands are as follows:
    1.74                             binary compatibility for user space
    1.75                             applications.
    1.76  
    1.77 +\item[Shadow pagetables]   A technique for hiding the layout of machine
    1.78 +                           memory from a virtual machine's operating
    1.79 +			   system.  Used in some {\bf VMM}s to provide
    1.80 +			   the illusion of contiguous physical memory,
    1.81 +			   in Xen this is used during
    1.82 +			   {\bf live migration}.
    1.83 +
    1.84  \item[Virtual Machine]     The environment in which a hosted operating
    1.85                             system runs, providing the abstraction of a
    1.86                             dedicated machine.  A virtual machine may