Translations: ?French

A Debian live demo for the Eee PC

Introduction & Status

Eeepc-live is a DebianLive based live demo system.

Version 1.0~b3 (and prereleases) should work both over ethernet and wifi with all models.

Download the latest image and then follow the user's guide:

The guide is intended for use with 1.0~b3 which is as of this writing, still being prepared for release. If you're using it with an earlier release, many of the instructions will not match what is in the image.

Features

Future

USB/HDD images

See Changelog.

binary.img (<256M)

bootable USB prerelease of 1.0~b3: please check .img.md5 and include it in any reports

binary.*

related files (same extensions as below)

eeepc-live-1.0~b2.img (~250M)

bootable USB

eeepc-live-1.0~b2.img.md5

the md5sum of the .img to verify download integrity

eeepc-live-1.0~b2.list

the list of files included in the .img

eeepc-live-1.0~b2.packages

the list of packages included in the .img

Source

The source code repository for the live-helper config is at http://git.debian.org/?p=debian-eeepc/eeepc-live.git;a=summary

The source for the image is available as well.

eeepc-live-1.0~b2.tar.gz (~894M)

the complete source tarball for the binary .img

eeepc-live-1.0~b2.tar.gz.md5

the md5sum of the tarball to verify download integrity

eeepc-live-1.0~b2.source.list

the list of files in the tarball

Testing the image

Just dd the .img file to a USB key or SD card (assuming the USB device is /dev/sdc -- replace this with the actual device*) which will replace its entire contents with this image:

dd if=eeepc-live-1.0~b2.img of=/dev/sdc
sync

Notes:

The best way to test the image is on the hardware itself. Just insert the key or card, reboot, press the 'esc' key during the BIOS splash screen, and when the boot device menu is shown, select the key or card to boot from.

Testing the image in QEMU is useful in a limited way. Of course, none of the hardware-specific stuff will work. However, you can check that the rest of the live system works correctly.

Development

Building the image

FIXME: Build instructions TBA. The following are obsolete:

We recommend you use a deb caching proxy like 'approx' if you're going to be building a lot of live-helper images from the supplied conf. That way, you will not re-download the package files each time you do a new build (though live-helper itself does some caching; still, sometimes you need to lh_config --purge which deletes this cache, so using approx will help here).

To use the proxy, you'll need to configure it properly on your build host and then adjust the archive URL in ./config/bootstrap to point at your proxy URL (e.g. "deb http://192.168.1.2:9999/debian lenny main contrib"). Likewise, you can use the proxy for our custom repo in ./config/chroot_sources/eeepc.chroot.

Building the image is then as simple as the following. We assume a sid build system; lenny will work too, but then you should use the live-helper from sid.

sudo apt-get install debootstrap live-helper git-core
git clone git://git.debian.org/git/debian-eeepc/eeepc-live.git
cd eeepc-live
lh_config
sudo lh_build 2>&1 | tee build.log

When you're done you should have a binary.img and build.log will contain the log of the build in case of errors. Test your new image as per above.

Using development versions of packages

Note: sometimes latest versions of packages from sid/git may be needed to build correctly.

Developing the live config

For each change to ./config you should sudo lh_clean before doing another lh_build (although depending on what you changed, lh_clean options such as --binary or --purge may be more appropriate).

When making changes to the image, don't manually change the files outside of ./config (e.g. ./chroot) as they are generated files and will be cleaned up by lh_clean. You may find it instructive to create a new directory and run 'lh_config' in it to generate a default live-helper config. Then diff -r the default config tree with eeepc-live/config to see what we've done to customize it.

For more help on developing this live config, see #debian-eeepc @ irc.oftc.net or use our mailing list.