*** From Knoppix to KX Light ***

Reference: https://www.amigaforever.com/kxlight/ (kxlight.org)
Last change: 2007-11-02 mcb document version 2.0
Special thanks to Amir Ansari


*** Release notes ***

These notes are as in the original Amiga Forever release (KX Light 6.0), except that the bootsplash patch as released in Knoppix version 2.4.24 was unavailable in version 2.4.22.


*** Files ***

- AF6-Bootfiles.tgz: all files except those available from third parties (i.e. Linux kernel and patches, etc.)

- Theme-AF6.tgz: Amiga Forever bootsplash theme files


*** First steps ***

Start from version 3.3 build 2004-02-16 of Knoppix Live CD.

Boot from the Knoppix CD with "knoppix 2" boot string at syslinux prompt
# cfdisk
Partition your hard drive creating a 4GB partition on a free space. I assume it is /dev/sda1
# mke2fs /dev/sda1
# tune2fs -c 0 /dev/sda1
# mkdir /mnt/sda1
# mount /dev/sda1 /mnt/sda1
# cp -Rp /KNOPPIX/ /mnt/sda1
Wait for the copy to finish (it will take a long time)
# cd /mnt/sda1/
# mkdir -p NewCD/KNOPPIX/ NewCD/boot/isolinux/ myfiles/
Copy Emulation directory into /dev/sda1/NewCD/ and check if uae is executable.
# cd myfiles
# mkdir -p lists boot/kernel archives

Download and extract AF6-Bootfiles.tar.gz

Download into archives:
- Linux kernel 2.4.24 (linux-2.4.24.tar.bz2) from www.kernel.org
- XFS kernel patch (xfs-2.4.23-all-i386.bz2) from SGI website (ftp://oss.sgi.com/projects/xfs/patches/2.4.23/)
- Bootsplash kernel patch (bootsplash-3.0.7-2.4.24-vanilla.diff) and splash program source (splash.c) from suse ftp (ftp://ftp.suse.com/pub/people/stepan/bootsplash/kernel/)
- Syslinux 2.08 (syslinux-2.08.tar.bz2) from Freshmeat (http://freshmeat.net/projects/syslinux/)
(To enable ssh server use "/etc/init.d/ssh start" command and transfer them with scp, but remember to set root password first)
Extract syslinux and compile splash.c into boot directory.


*** Build new kernel ***

# mkdir kernel
# cd kernel
# tar jxf ../../archives/linux-2.4.24.tar.bz2
# cd linux-2.4.24
# bzcat ../../../xfs-2.4.23-all-i386.bz2 | patch -p 1
It will fail to patch Makefile. Add "EXTRAVERSION = -xfs" in the third line.
# patch -p 1 <../../../archives/bootsplash-3.0.7-2.4.24-vanilla.diff.bz2
# patch -p 1 </KNOPPIX/usr/src/knoppix-kernel.patch

# cp /KNOPPIX/usr/src/linux/.config .
# make oldconfig
Answer "y" when prompts for bootsplash option
(Or use config-2.4.24-xfs from AF6-Bootfiles.tar.gz)

# make dep && make clean && make bzImage
# rdev arch/i386/boot/bzImage /dev/ram
# cp arch/i386/boot/bzImage /mnt/sda1/NewCD/boot/isolinux/vmlinuz


*** Remove unwanted software ***

# cd /mnt/sda1/
# cp myfiles/lists/*remove.txt KNOPPIX/var/tmp/
# chroot KNOPPIX
# mount -t proc /proc proc
# rm /dev/null (I don't know why it doesn't work with null device!)
# :>/etc/apt/sources.list (To fix this knoppix bug in apt repository)
# dpkg -r --force-all samba xtel sslwrap nessus-plugins (To fix purge problems of this packages)
# dpkg -P `cat /tmp/toremove.txt`
# dpkg --configure -a (due to a problem in a package)
# umount proc
# exit
# cd KNOPPIX; rm -fr `cat ../myfiles/lists/manual-remove.txt`; cd ..
# cp -a /dev/null KNOPPIX/dev/null
# cp --parents /KNOPPIX/usr/share/zoneinfo/America/New_York .
# cp --parents /KNOPPIX/usr/share/zoneinfo/CET .
# cp /KNOPPIX/etc/services KNOPPIX/etc/


*** Prepare UAE startup and progress bar ***

Copy Emulation directory into NewCD
# tar zxvf myfiles/xinit-new.tgz -C KNOPPIX/
# patch -d KNOPPIX -p 1 myfiles/kxpatch/scripts.patch
(This patch was made by the command "diff -urNp orig new" in kxpatch directory)
# cp myfiles/boot/x-background.jpg KNOPPIX/usr/local/lib/knoppix.jpg


*** Build bootable cd ***

# cp /mnt/sda1/boot/AF6-Isolinux/* /mnt/sda1/boot/syslinux-2.08/isolinux.bin /mnt/sda1/NewCD/boot/isolinux/
# mkdir /mnt/bootfloppy
# mount -o loop /cdrom/KNOPPIX/boot.img /mnt/bootfloppy
# cp /mnt/bootfloppy/miniroot.gz /mnt/sda1/NewCD/boot/isolinux/
# umount /mnt/bootfloppy
(Or use the one in AF6-Bootfiles.tar.gz)

# mkdir -p /etc/bootsplash/themes/
# cp -r /mnt/sda1/boot/Themes/af /etc/bootsplash/themes/
# cd /mnt/sda1/myfiles/boot/
# ./splash -s -f /etc/bootsplash/themes/af/config/bootsplash-800x600.cfg >>/mnt/sda1/NewCD/boot/isolinux/miniroot.gz


*** Prepare iso file to burn ***

mkisofs -R ./KNOPPIX | create_compressed_fs - 65536 >./NewCD/KNOPPIX/KNOPPIX
mkisofs -r -J -o NewCD.iso -b boot/isolinux/isolinux.bin -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 -boot-info-table NewCD



*** Some notes on bootsplash theme build ***

Due to a limited support of jpg format, bootsplash image need to be built from png with the following command
# pngtopnm silent-800x600.png | ppmtobmp | cjpeg -optimize -quality 90 -outfile silent-600x600.jpg


*** BUGS ***

Mixer volume set to mute