?TableOfContents

Translations: [:DebianEeePCFrench/HowTo/CustomInstaller:French]

What is special about the custom installer?

All that is customized is the addition of some hardware-specific support not in the standard installer. It is a 16M network-based installer image suitable for use on a USB key, external hard drive or SD/SDHC card.

The installation process itself is exactly as documented for the standard [:DebianInstaller:Debian-Installer].

We have found this works for the great majority of our users. The custom installer can get you up and running with all hardware working sooner than otherwise.

This installer boots with and installs on the target system:

We are working towards getting all of this support into the standard installer. That is, we know we're done when we no longer need eeepc.debian.net for extra packages and everything "just works".

Installing over wireless

This installer has the option of installing over wireless (on models which include wifi modules in the installer -- see above) as well as ethernet. It only supports open and WEP authentication at the moment, but WPA is supported by ["DebianEeePC/HowTo/WPAInstaller-Beta"].

How did you get it so small? What is left out?

Unlike the 'netinst' installer which is 130M and contains everything needed to do a 'base' install, ours is a 'monolithic' installer which includes the whole installer in the initial ramdisk. It is limited in that it can only work with the packages that are included in that ramdisk and cannot extend itself with packages outside. Thus, it is not suitable for special install scenarios like pppoe, lvm, crypto or special accessibility needs. Fortunately, most users do not need these things, and if they do, they can use the standard installer instead.

Development

The exact process for mastering the image linked from ["DebianEeePC/HowTo/Install"] basically followed ["DebianInstaller/Modify/CustomKernel"] to build a Lenny installer. A few extra steps were required to include the atl2 module. The following instructions assume a sid build system. You may wish to prepare a sid chroot to do this using cdebootstrap or debootstrap so that your build system will not be 'tainted' by the installation of the kernel for the custom installer. So cd to the directory where you want the chroot, and do:

debootstrap sid sid http://ftp.debian.org/debian/

Building the image

The process is automated with the build-eeepc.sh script available at git://git.debian.org/git/debian-eeepc/installer.git [http://git.debian.org/?p=debian-eeepc/installer.git;a=log web], though to make it work in a sid chroot, a few things are missing:

do_symlinks = Yes
do_initrd = Yes

chroot sid
apt-get update
apt-get install locales
dkpg-reconfigure locales

chroot sid
apt-get update
apt-get install initramfs-tools

cp build-eeepc.sh sid/
chroot sid/
touch /etc/fstab
mount -t proc proc /proc
mount -t sysfs sys /sys

* and build:

./build-eeepc.sh

If all goes well, after a while test/debian-eeepc.img should be created.

If it doesn't go well, please contact us on the mailing list or via irc. We dont neccesarily keep the script constantly up to date, so if you notice errors, we would be happy to know.

Testing your build

It is a good idea to test the initial boot stages with qemu just to see if it works correctly without any very noticible glitches, then testing it by dd'ing to a usb or sd card.