Update doc

[bacula/rescue] / rescue / linux / usb / README.usb

diff --git a/rescue/linux/usb/README.usb b/rescue/linux/usb/README.usb
index f2f914c31e261fa266d010c22573c93add5b22e1..31bbf902257143b32425458c7e3868d55688f605 100644 (file)
--- a/rescue/linux/usb/README.usb
+++ b/rescue/linux/usb/README.usb
@@ -2,6 +2,7 @@
 This directory is used to build a USB key containing a Kubuntu 8.04 LiveCD
 with persistent OS files and persistent /home files.
 
+You will need to run as root for most things ...
 
 Start by editing the "config" file. Be sure to get your USB_DEV
 definition correct.  The scripts you need to partition the key and 
@@ -11,11 +12,24 @@ After editing the config file, run:
 
   ./partition_usb_key
 
-Note, this script assumes that you have a 3GB or bigger key.  It
-may work for a 2GB key, but you might want to reduce the size of
-the second partition.
+Note, this script will destroy *all* data on the key, and assumes
+that you have a 3GB or bigger key.  It may work for a 2GB key,
+but you might want to reduce the size of the second partition.
 
-This script creates three partitions:
+====
+If you ever want to put the key back to its prior state, *before*
+running the partition_usb_key, you might consider doing a:
+
+  sfdisk -d /dev/key-device >save_me  
+
+where key-device is the key device name (e.g. sda).  The
+output file can be fed back into sfdisk to recreate the original
+with:
+
+ sfdisk /dev/key-device <save_me
+====
+
+The partition_usb_key script creates three partitions:
 
  1. kubuntu8  -- USB boot partition containing the OS
  2. casper-rw -- A writable ext3 partition for saving OS changes
@@ -25,6 +39,34 @@ When the key is booted, assuming you choose the first option
 (LiveCD), you will be running as user "ubuntu" the password is
 "bacula", and you will be in /home/ubuntu.  
 
+The next step is to get a copy of kubuntu8.tar.gz, which is the
+USB boot image. Currently, it can be downloaded from:
+
+  www.bacula.org/downloads/kubuntu8.tar.gz
+
+or from:
+
+  www.sibbald.com/download/kubuntu8.tar.gz
+
+I recommend that you download it into the rescue/linux/usb directory.
+
+Finally, mount your USB key and detar the kubuntu8.tar.gz image 
+into the first partition.  Do this with:
+
+   ./write_usb_boot_partition
+
+You should now have a USB stick that can be booted providing the
+machine permits booting from the USB port -- this can be adjusted
+by modifying the BIOS boot sequence.  On Dell machines, you can 
+enter the BIOS setup by pressing F2 just after power on.  
+
+Alternatively, most machines let you boot from an alternate device.
+For example if you press F11 while a Sony Viao is powering up, it 
+will boot from the USB port. 
+
+On Dell machines during power on, if you press F12, you will be
+able to select any boot device (one time only) other than the one
+that is the default (normally the CDROM or HDD).
 
 
 ====