X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=rescue%2Flinux%2Fusb%2FREADME.usb;h=31bbf902257143b32425458c7e3868d55688f605;hb=6bae50775269c6d0c2c83ffb174a444351d26472;hp=71d16f54024a05b19c5e399604588f3507d932f1;hpb=7ac5267e468ba46ff5b9aaa7ca2497162ba6a3c1;p=bacula%2Frescue

diff --git a/rescue/linux/usb/README.usb b/rescue/linux/usb/README.usb
index 71d16f5..31bbf90 100644
--- a/rescue/linux/usb/README.usb
+++ b/rescue/linux/usb/README.usb
@@ -2,6 +2,82 @@
 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 
+to write the boot image to it are all in this (usb) directory. 
+
+After editing the config file, run:
+
+  ./partition_usb_key
+
+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.
+
+====
+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
+ 3. home-rw   -- A writable ext3 partition for saving /home
+
+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).
+
+
+====
+
+The directory "remaster" contains the scripts that allow picking
+apart a Kubuntu Hardy ISO and then updating and recombining the
+parts into a USB boot image.  The information below is somewhat
+low level and should not be needed unless you want to do your
+own remastering either starting from the Kubuntu release or from
+the Bacula remastered release.
+
 Note, the sqfs.tar.gz is the whole squashfs unsquashed.  
 
 The kernel image (vmlinuz) is a copy of the most recent kernel i.e.
@@ -39,7 +115,6 @@ Kubuntu boot tricks:
    casper-rw is used to store changed OS files, and home-rw is the
    home directory.
 
-
 Bugs with Kubuntu boot process:
 1. The initrd.gz image must be opened, fixed and the repacked.
 2. The fix involves removing the ,mode=755 from the mount line for