Copyright (C) 2009-2010 Bacula Systems SA

This directory is used to build a USB key containing a Xubuntu 9.04 LiveCD
with persistent OS files and persistent /home files.

You will need to run as root for most things ...

Packages needed:
apt-get install syslinux mbr parted wget

Please make sure they are installed on your system before
continuing.

1. Start by editing the "config" file (DO NOT EDIT config2).  Be
   sure to get your USB_DEV definition correct.  Note: you can
   see what devices you have connected by running:

      lsscsi

   For example, I get:

   $ lsscsi
    [1:0:0:0]    cd/dvd  _NEC     DVD+RW ND-1100A  108B  /dev/scd0
    [1:0:1:0]    cd/dvd  PHILIPS  DVD+-RW DVD8631  9D03  /dev/scd1
    [9:0:0:0]    disk    Kingston DataTraveler 2.0 PMAP  /dev/sda

   and in my case, the USB device is the Kingston DataTraveler on
   device /dev/sda.

   Alternatively you can do:

       fdisk -l

2. The scripts you need to partition the key and 
   to write the boot image to it are all in this (usb) directory. 

3. 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

4. The next step is to get a copy of rescue.gz and rw.tar.gz,
   which are the USB boot image and the read-write partition.

   To do so execute  

   ./get_files.sh script

   from within this directory.


   It will download the required files to the "files" subdirectory  
   of this directory.  You need only do this command once.  Once
   you are finished building any and all USB keys, you can conserve
   disk space by deleting:

     files/rw.tar.gz
     files/rescue.gz

5. If you have not already done so, edit the file "config" 
  (never edit config2) and fill in the values that correspond 
  to your setup.

6. 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 4GB or bigger key.  


   The partition_usb_key script creates three partitions:

    1. xubuntu9  -- USB boot partition containing the OS
    2. casper-rw -- A writable ext3 partition for saving OS changes
    3. bacula-rescue -- The actual place of our rescue scripts
                        and saved data


6. Mount your USB key and copy the files to the key.
   Do this with:

   ./copy_bacula-rescue_to_key

   This can take a good amount of time (5 mins) since it must format
   the new partitions then copy the boot image.

7. 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).

   for older machines you can boot on a cd that will point to your usb key

   you can find such a cd at
 
   http://bacula.org/downloads/cd-boot-liveusb2.iso

   burn the iso to cd, then boot on the cd and on the graphical
   menu select usb (be sure to have no other usb devices than the key
   attached at boot time)

   wait for a while sometimes it doesn't pick up fast
   but with a bit of patience it works



===

If you want to add additional OS tools to your USB stick, there
are two ways:

1. Remaster the iso boot image (a bit complicated) see README.technotes
2. Simply use sudo apt-get install ... when booted into your USB stick. 
   The changes will be written to the casper-rw partition (the
   read/write OS partition).


One slightly annoying thing about the USB key is that the casper-rw
and the home-rw partitions must be ext3 (with journaling turned on),
and journaling is not really the best way to run with USB keys that
have a finite write lifetime.  Switching the partitions to ext2 seems
to prevent them from being written correctly, which means a lot of
things such as starting X do not work.