--- /dev/null
+
+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.