bitkeeper revision 1.1159.152.4 (4188f5d8214qWxCDmCbxEQwQcQ3hww)

Doc update

3 files changed, 57 insertions, 19 deletions

diff --git a/.rootkeys b/.rootkeys
index 7f41bc10c8..0d410cbee0 100644
--- a/.rootkeys
+++ b/.rootkeys
@@ -293,7 +293,6 @@
 4124b307P3bZBkTFm6r-3XTbf0phAA tools/check/check_curl_lib
 4124b307u-FeKvFP9kZnh0rLV0XjGg tools/check/check_logging
 4124b307tRTjLqzRy60QrUoqN2Fhuw tools/check/check_python
-4124b307KcYJMtZ7r48AF-wyhyw-SQ tools/check/check_ssl_lib
 4124b307XdznSNCv97lrT3RpOdMM1A tools/check/check_twisted
 4124b307lnAATmulpXYa0M-dzxLBDA tools/check/check_zlib_devel
 4124b308ly20ptMKQoiztPyP_X68Mw tools/check/check_zlib_lib
diff --git a/README b/README
index a45e7f3213..a648e64607 100644
--- a/README
+++ b/README
@@ -8,25 +8,74 @@ __  __            ____    ___
 ###############################
 
 University of Cambridge Computer Laboratory
-29 October 2004
+3 November 2004
 
 http://www.cl.cam.ac.uk/netos/xen/
 
-About the Xen Virtual Machine Monitor
-=====================================
+What is Xen?
+============
 
 Xen is a Virtual Machine Monitor (VMM) originally developed by the
 Systems Research Group of the University of Cambridge Computer
 Laboratory, as part of the UK-EPSRC funded XenoServers project.
+Xen is freely-distributable Open Source software, released under the
+GNU GPL.
 
 The 2.0 release offers excellent performance, hardware support and
 enterprise-grade features such as live migration. Linux 2.6, 2.4 and
 NetBSD 2.0 are already available for Xen, with more operating system
 ports on the way.
 
-Xen is freely-distributable Open Source software, released under the
-GNU GPL.
+This file contains some quick-start instructions to install Xen on
+your system. For full documentation, see the Xen User Manual. If this
+is a pre-built release then you can find the manual at:
+ dist/install/usr/share/doc/xen/pdf/user.pdf
+If you have a source release, then 'make -C docs' will build the
+manual at docs/pdf/user.pdf.
+
+Quick-Start Guide - Pre-Built Binary Release
+============================================
+
+[NB. Unless noted otherwise, all the following steps should be
+performed with root privileges.]
+
+1. Install the binary distribution onto your filesystem:
+    # sh ./install.sh
+   Amongst other things, this will install Xen and XenLinux kernel
+   files in /boot, kernel modules and Python packages in /lib, and
+   various control tools in standard 'bin' directories.
+
+2. Configure your bootloader to boot Xen and an initial Linux virtual
+   machine. Note that Xen currently only works with GRUB: less common
+   alternatives such as LILO are *not* supported. You can most likely
+   find your GRUB menu file at /boot/grub/menu.lst: edit this file to
+   include an entry like the following:
+    # title Xen 2.0 / XenLinux 2.6.9
+    #   kernel /boot/xen.gz dom0_mem=<mem-kb> console=vga
+    #   module /boot/vmlinuz-2.6.9-xen0 root=<root-dev> ro console=tty0
+   For <mem-kb> you should specify the amount of memory, in kilobytes,
+   to allocate for use by your initial XenLinux virtual machine. Note
+   that Xen itself reserves about 32MB memory for internal use, which
+   is not available for allocation to virtual machines.
+   For <root-dev>, specify your usual root partition (e.g., /dev/hda1).
+
+3. Reboot your system and select the "Xen 2.0 / XenLinux 2.6.9" menu
+   option. After booting Xen, XenLinux will start and your
+   initialisation scripts should execute in the usual way.
+
+Quick-Start Guide - Source Release
+==================================
+
+First, there are a number of prerequisites for building a Xen source
+release. Make sure you have all the following installed, either by
+visiting the project webpage or installing a pre-built package
+provided by your Linux distributor:
+    * GCC (preferably v3.2.x or v3.3.x; older versions are unsupported) 
+    * GNU Make
+    * GNU Binutils
+    * Development install of libcurl (e.g., libcurl-dev)
+    * Development install of zlib (e.g., zlib-dev)
+    * Development install of Python v2.2 or later (e.g., python-dev)
 
-For full documentation, see the Xen User Manual in docs/pdf/user.pdf
-(after running make -C docs) or the Documentation page on the Xen
-website.
+[NB. Unless noted otherwise, all the following steps should be
+performed with root privileges.]
diff --git a/tools/check/check_ssl_lib b/tools/check/check_ssl_lib
deleted file mode 100755
index ecd64d4a54..0000000000
--- a/tools/check/check_ssl_lib
+++ /dev/null
@@ -1,10 +0,0 @@
-#!/bin/bash
-# CHECK-BUILD CHECK-INSTALL
-
-function error {
-    echo "Check for ssl library failed."
-    exit 1
-}
-
-set -e
-ldconfig -p | grep libssl.so || error
\ No newline at end of file