+++ /dev/null
-
-Copyright (C) Kern E. Sibbald, 2009
-
-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 ...
-
-Packages needed:
-apt-get install syslinux mbr
-
-
-1. Start by editing the "config" file. 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 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
-
-5. Edit the file "config" 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 3GB or bigger key. It may work for a 2GB key,
- but you might want to reduce the size of the second partition.
-
-
- 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
-
-6. Mount your USB key and detar the kubuntu8.tar.gz image
- into the first partition. Do this with:
-
- ./write_usb_boot_partition
-
- 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).
-
-8. 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.
-
-9. Before booting, you might want to remove the USB key, using the
- remove safely mode, then plug it back in so that you can access
- the home-rw partition. Here you can put anything you want from
- your system. However, you must use care to ensure that the files
- are written with UID=1000 and GID=1000, which is ubuntu:ubuntu when
- your boot the USB key.
-
-10. Finally, if you are running with a KDE desktop on Kubuntu 8.04,
- you can copy it to the key with:
-
- ./copy_kubuntu_desktop_to_usb
-
- If you are not using Kubuntu, you can modify the script to
- adapt it to your situation or simply create a new script.
-
-===
-
-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).
-
-If you want to add something to your USB home directory simply mount
-the home-rw partition and write to it in the appropriate place as noted
-in item #9 above.
-
-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.