6711
Comment:
|
6640
|
Deletions are marked like this. | Additions are marked like this. |
Line 31: | Line 31: |
||[[http://people.debian.org/~synrg/debian-eeepc/eeepc-live/binary.img|binary.*]] || related files (same extensions as below) || | ||binary.* || related files (same extensions as below) || |
Translations: ?French
A Debian live demo for the Eee PC
Contents
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:
?DebianEeePC/Live/UsersGuide
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
- A bootable .img that can be put on an SD card or USB device using dd.
- Small image size, suitable for use on 256M USB keys. Note: not all 256M keys provide the full 256M, (we have seen keys as small as 243M,) so some of our test images may not fit. We are aware of the problem and plan to make the final release fit on the smallest 256M key we have available for testing.
Squeeze + 2.6.32 kernel (1.0~b3 / prerelease version only ... earlier versions were lenny-based) so that all ethernet + wifi in all models are supported.
- Lightweight, LXDE-based desktop.
Future
- Other flavours are planned: minimal, rescue, gnome, kde.
We also plan to add an installer. Until that is delivered, use the one on DebianEeePC/HowTo/Install instead.
See http://lists.debian.org/debian-live/2009/08/msg00029.html for Kai Hendry's repost of Chris Lamb's HOWTO for incorporating the live installer in a debian-live-based USB image.
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 |
the md5sum of the .img to verify download integrity |
|
the list of files included in the .img |
|
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 |
the md5sum of the tarball to verify download integrity |
|
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:
- If you don't know which device your USB key or SD card is, you can look for it in /dev/disk/by-id/ (assuming your system has udev).
- Make sure that no filesystems on the device are mounted when you do the dd. Your system may automount any detected filesystems. Check 'df' to ensure none are mounted and 'umount' each one that is. If you fail to do this, the copy you make to the device with dd will probably end up corrupted and unbootable.
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.