ia64/xen-unstable

changeset 8228:dcfeb9e234d1

Applied Robb Roman's patches to upstream.
author kmself@ix.netcom.com
date Fri Dec 02 14:50:08 2005 -0700 (2005-12-02)
parents 57d5f6c9b9ef
children 1deae55b1f5c
files docs/src/user.tex docs/src/user/installation.tex docs/src/user/start_addl_dom.tex
line diff
     1.1 --- a/docs/src/user.tex	Fri Dec 02 14:29:26 2005 -0700
     1.2 +++ b/docs/src/user.tex	Fri Dec 02 14:50:08 2005 -0700
     1.3 @@ -1,3 +1,4 @@
     1.4 +\batchmode
     1.5  \documentclass[11pt,twoside,final,openright]{report}
     1.6  \usepackage{a4,graphicx,html,parskip,setspace,times,xspace}
     1.7  \setstretch{1.15}
     2.1 --- a/docs/src/user/installation.tex	Fri Dec 02 14:29:26 2005 -0700
     2.2 +++ b/docs/src/user/installation.tex	Fri Dec 02 14:50:08 2005 -0700
     2.3 @@ -35,10 +35,9 @@ if you wish to build from source.
     2.4  Once you have satisfied these prerequisites, you can now install either
     2.5  a binary or source distribution of Xen.
     2.6  
     2.7 -
     2.8  \section{Installing from Binary Tarball}
     2.9  
    2.10 -Pre-built tarballs are available for download from the Xen download
    2.11 +Pre-built tarballs are available for download from the XenSource downloads
    2.12  page:
    2.13  \begin{quote} {\tt http://www.xensource.com/downloads/}
    2.14  \end{quote}
    2.15 @@ -53,7 +52,22 @@ Once you've downloaded the tarball, simp
    2.16  Once you've installed the binaries you need to configure your system as
    2.17  described in Section~\ref{s:configure}.
    2.18  
    2.19 +\section{Installing from RPMs}
    2.20 +Pre-built RPMs are available for download from the XenSource downloads
    2.21 +page:
    2.22 +\begin{quote} {\tt http://www.xensource.com/downloads/}
    2.23 +\end{quote}
    2.24  
    2.25 +Once you've downloaded the RPMs, you typically install them via the RPM commands:
    2.26 +\begin{verbatim}
    2.27 +# rpm -ivh \emph{rpmname}
    2.28 +\end{verbatim}
    2.29 +
    2.30 +See the instructions and the Release Notes for each RPM set referenced at:
    2.31 +  \begin{quote}
    2.32 +    {\tt http://www.xensource.com/downloads/}.
    2.33 +  \end{quote}
    2.34 + 
    2.35  \section{Installing from Source}
    2.36  
    2.37  This section describes how to obtain, build and install Xen from source.
    2.38 @@ -88,9 +102,9 @@ or as a clone of our master Mercurial re
    2.39  % \item[\path{tools/}] Xen node controller daemon (Xend), command line
    2.40  %   tools, control libraries
    2.41  % \item[\path{xen/}] The Xen VMM.
    2.42 +% \item[\path{buildconfigs/}] Build configuration files
    2.43  % \item[\path{linux-*-xen-sparse/}] Xen support for Linux.
    2.44 -% \item[\path{linux-*-patches/}] Experimental patches for Linux.
    2.45 -% \item[\path{netbsd-*-xen-sparse/}] Xen support for NetBSD.
    2.46 +% \item[\path{patches/}] Experimental patches for Linux.
    2.47  % \item[\path{docs/}] Various documentation files for users and
    2.48  %   developers.
    2.49  % \item[\path{extras/}] Bonus extras.
    2.50 @@ -221,7 +235,7 @@ destinations.
    2.51  
    2.52  %% Files in \path{install/boot/} include:
    2.53  %% \begin{itemize}
    2.54 -%% \item \path{install/boot/xen-2.0.gz} Link to the Xen 'kernel'
    2.55 +%% \item \path{install/boot/xen-3.0.gz} Link to the Xen 3.0 'kernel'
    2.56  %% \item \path{install/boot/vmlinuz-2.6-xen0} Link to domain 0
    2.57  %%   XenLinux kernel
    2.58  %% \item \path{install/boot/vmlinuz-2.6-xenU} Link to unprivileged
    2.59 @@ -287,9 +301,11 @@ When installing a new kernel, it is reco
    2.60  existing menu options from \path{menu.lst}, as you may wish to boot your
    2.61  old Linux kernel in future, particularly if you have problems.
    2.62  
    2.63 +%% KMS: Additional configurations as an Appendix?
    2.64 +
    2.65  \subsection{Serial Console (optional)}
    2.66  
    2.67 -%% kernel /boot/xen-2.0.gz dom0_mem=131072 com1=115200,8n1
    2.68 +%% kernel /boot/xen-3.0.gz dom0_mem=131072 com1=115200,8n1
    2.69  %% module /boot/vmlinuz-2.6-xen0 root=/dev/sda4 ro
    2.70  
    2.71  In order to configure Xen serial console output, it is necessary to add
    2.72 @@ -311,9 +327,9 @@ necessary to add a line into \path{/etc/
    2.73  \begin{quote} {\small {\tt c:2345:respawn:/sbin/mingetty ttyS0}}
    2.74  \end{quote}
    2.75  
    2.76 -and you should be able to log in. To successfully log in as root over
    2.77 -the serial line will require adding \path{ttyS0} to
    2.78 -\path{/etc/securetty} if it is not already there.
    2.79 +run \path{init q} to force init to re-examine \path{/etc/inittab}, and
    2.80 +you should be able to log in.  Add \path{ttyS0} to \path{/etc/securetty}
    2.81 +to allow root logins over serial console, if it is not already there.
    2.82  
    2.83  \subsection{TLS Libraries}
    2.84  
     3.1 --- a/docs/src/user/start_addl_dom.tex	Fri Dec 02 14:29:26 2005 -0700
     3.2 +++ b/docs/src/user/start_addl_dom.tex	Fri Dec 02 14:50:08 2005 -0700
     3.3 @@ -1,7 +1,7 @@
     3.4  \chapter{Starting Additional Domains}
     3.5  
     3.6  The first step in creating a new domain is to prepare a root
     3.7 -filesystem for it to boot from.  Typically, this might be stored in a
     3.8 +filesystem for it to boot.  Typically, this might be stored in a
     3.9  normal partition, an LVM or other volume manager partition, a disk
    3.10  file or on an NFS server.  A simple way to do this is simply to boot
    3.11  from your standard OS install CD and install the distribution into
    3.12 @@ -12,6 +12,10 @@ To start the \xend\ control daemon, type
    3.13    \verb!# xend start!
    3.14  \end{quote}
    3.15  
    3.16 +%% KMS: If we're going to use '# cmd' syntax we should be consistent
    3.17 +%% about it and have a conventions section noting that '#' == root
    3.18 +%% prompt.
    3.19 +
    3.20  If you wish the daemon to start automatically, see the instructions in
    3.21  Section~\ref{s:xend}. Once the daemon is running, you can use the
    3.22  \path{xm} tool to monitor and maintain the domains running on your
    3.23 @@ -70,11 +74,21 @@ you may wish to edit include:
    3.24  You may also want to edit the {\bf vif} variable in order to choose
    3.25  the MAC address of the virtual ethernet interface yourself.  For
    3.26  example:
    3.27 +%% KMS:  We should indicate "safe" ranges to use.
    3.28  \begin{quote}
    3.29  \verb_vif = ['mac=00:06:AA:F6:BB:B3']_
    3.30  \end{quote}
    3.31  If you do not set this variable, \xend\ will automatically generate a
    3.32 -random MAC address from an unused range.
    3.33 +random MAC address from the range 00:16:3E:xx:xx:xx.  Generated MACs are
    3.34 +not tested for possible collisions, however likelihood of this is low at
    3.35 +\begin{math} 1:2^{48}.\end{math}  XenSource Inc.  gives permission for
    3.36 +anyone to use addresses randomly allocated from this range for use by
    3.37 +their Xen domains.
    3.38 +
    3.39 +
    3.40 +For a list of IEEE
    3.41 +assigned MAC organizationally unique identifiers (OUI), see \newline
    3.42 +{\tt http://standards.ieee.org/regauth/oui/oui.txt}
    3.43  
    3.44  
    3.45  \section{Booting the Domain}