My knoppix remastering howto

HOW I BUILT A CUSTOM DEBIAN CD FROM KNOPPIX

Sunil Thomas Thonikuzhiyil
Update:May 2008- This is an old document and one of the first documents on remastering. I lost interest in maintaining it long back. The original document was hosted at http://gnubox.dyndns.org:8080/~sunil/knoppix.php. Now that, I got a new domain , I am putting it back on net. I hope I will be able to rewrite it for current Knoppix .

The original document was last updated on 10th January 2003.
Introduction

Knoppix is a live cd distribution based on debian GNU/Linux.It contains a large number of applications which can come in handy even on minimal hardware.Knoppix supports a large number of graphics cards sound cards scsi and USB devices.It can be used as a Linux demo, educational cd, rescue system or adapted and used as a platform for commercial product demo. It is not necessary to install anything to hard disk There is an installation program which can install the entire cd to a hard disk, if you like. It means that you have a full fledged debian installation in 20 minutes. This document describes how I built a custom live cd from knoppix. My primary motivation to build this cd was to include some of my favorite applications which are missing from stock knoppix CD. If you find any errors in this document please drop me a mail here
Requirements
a) Software

To start with you have to download knoppix image from knoppix site. There is a release every one or two week. There are 2 images: German and English. I did my setup based on 31-10-2002-EN release.

If you already have an image you can try to rsync it to the most recent version as below. However don’t expect much bandwidth saving since the knoppix image is compressed. If you have a knoppix cdrom create an image by #dd if=/dev/cdrom of=knoppix.iso)

Rename the Knoppix iso image to reflect the current release name.
Example
I have downloaded KNOPPIX_V3.1-23-10-2002-EN.iso
I want to update it to KNOPPIX_V3.1-31-10-2002-EN.iso
Rename KNOPPIX_V3.1-23-10-2002-EN.iso to KNOPPIX_V3.1-31-10-2002-EN.iso
Then
rsync -P –stats ftp.leo.org::Knoppix/KNOPPIX_V3.1-31-10-2002-EN.iso .
( you can use any other rsync site of knoppix. Always check the site for latest release)
b) Hardware

A Computer with tons of free hard disk space and memory. I did this on a Pentium 3 950MHZ machine with 128 mb RAM.
Initial setup

Make a lot of disk space free You need a lot of real estate for re-mastering KNOPPIX CD
I made two fresh partitions on my 20 GB Hard disk
hda2 with 2GB for swap
hda3 with 5 GB for re-mastering work ( you can also use an existing Linux partition if it has sufficient free space)

Now boot the machine with Knoppix cd ( You can also do the re-mastering after a hard disk install of knoppix . A how to for hard disk install can be found here )

At boot prompt press enter. Knoppix now boots into GUI. The default is KDE . You can change it at boot prompt if you want . I did re-mastering while booted to KDE. It is assumed that you are somewhat familiar with Knoppix. Read Knoppix cheat codes on the CD for more information on booting.
a) Configure networking from the KDE menu
Click on
K/Knoppix/network-Internet/Network-card-configuration

I am connected to a Lan and I configured IP address, netmask, name server and gateway This step is very important since you have to get the custom stuff to be installed from else where
b) Setup partitions

Open a root shell from KDE menu (K/Knoppix/Root-shell) You will get # prompt

Run cfdisk

Next you have to make the necessary partitions . I created two partitions hda2 with 2 GB and hda3 with 5 GB

Make the 2GB partitions type as swap ( /hda2 in my case)

Make the 5 GB partitions type as Linux native( ext2) (hda3 here)
Save the modified partition information

Quit cfdisk

For creating compressed file system we need a lot of swap space . I created the swap with
# mkswap /dev/hda2
# swapon /dev/hda2
( it is also possible to use a swap file )

Create an ext2 file system on the 5GB partition
# mke2fs /dev/hda3

Mount the 5GB partition to the Knoppix file system
# mount /dev/hda3 /mnt/hda3

The basic setup for re-mastering is ready
Installing and Removing Software

The knoppix CD is organized somewhat like the figure below ( Correct me if I am wrong. it may look different when you look at it from windows or another Linux distro)

/–demos
|–talks
|–index.html
|–autorun.bat
|–autorun.inf
|–knoppix.ico
|–KNOPPIX
|–KNOPPIX
|–boot.img
|–background.gif
|- (Some more files here)

The file KNOPPIX in /KNOPPIX directory on the cd is approxiamtley 700MB. The file contains a compressed image of the file system. We have to modify this file alone and can leave the rest of the cd intact (unless you want to modify boot image startup files etc).
a) Copy Knoppix file system to hard disk
When Knoppix CD is booted compressed image file is mounted at /KNOPPIX You have to copy it to your target partition.I did a
# cp -Rp /KNOPPIX /mnt/hda3/
( -R option is for recursive copying -p is for preserving ownership time stamp etc) This places all the files you need to make a custom cd on your hard disk at /mnt/hda3/KNOPPIX/ directory . Take a look at it

b) Chroot

You have to install/uninstall software under this tree ( if you don’t have networking copy your sources to (say) /mnt/hda3/KNOPPIX/root/ and if you have debs copy them to /mnt/hda3/KNOPPIX/var/cache/apt/archives)
Now we are going to change the root of the file system to /mn/hda3/KNOPPIX
#chroot /mnt/hda3/KNOPPIX

you will get back # prompt ( If you get /dev/null permission denied message here just press control C)
You are at / ( chrooted to /mnt/hda3/KNOPPIX)

Next mount the proc file system
#mount -t proc /proc proc
c) Setup networking
Add to /etc/resolv.conf
nameserver ip-of-ur-nameserver

( I had a curious problem /etc/resolv.conf was a symlink to /etc/dhcp/resolv.conf. Ping did not work. I removed the symlink and created a /etc/resolv.conf afresh and it worked. Make sure that you restore the symlink once you are finished)

Verify your ip address now with ifconfig. (It should be same as what you have out side chroot) Then try ping google.com. If you can ping google.com your network setup is ok under chroot.Do an apt get update
d) Install/Uninstall

You can install /uninstall whatever software you need using apt. Since the original Cd has a lot of software installed it may not be an easy task.The following is a partial list of packages I removed
Games
falconseye-data
rocks-n-diamonds
amor
nethack-x11
gnome-games-locale
xboard
gnocatan-client
imaze
kmahjongg
gnome-gnibbles
freeciv-gtk
ktuberling
gnocatan-help
ksirtet
gnome-gnobots2
jumpnbump
ksnake
xgalaga
lskat
katomic
kshisen
konquest
chromium
ktux
moon-buggy
kmoon
ksame
gnuchess
ktron
frozen-bubblekjumpingcube
fortune-mod
kodo
gnocatan-ai
gnocatan-server-console
gnocatan-server-data
nethack
821
fortunes
searchandrescue
xbill
kspaceduel
libkdegames
tipptrainer-data-dexconq
gcompris
gnome-chess
tuxracer-data
abuse-frabs
gnome-gnotski
frotz
kblackbox
gnome-games
gnome-gtali
gnome-iagno
gnome-stones
gnocatan-server-gtk
lxdoom-x11
maelstrom
kabalone
gnome-gnotravex
fortunes-min
chromium-data
kdegames
pingus-data
task-kde-games
stax
gnome-card-games
xtris
xtux
kjezz
lxdoom
Non -free
x3270
xanim festlex-oald
netscape-java-477
j2re1.3
3270-common
tgif
giflib-bin
frotz xfractint
giflib3g communicator-smotif-477
netscape-base-477
maelstrom communicator-base-477
gimp1.2-nonfree
acroread
lha
unarj
xsnow
Misc
tetex-base
tetex-extra
j2re1.3
lyx
acroread
qcad
rocks-n-diamonds
kde-i18n-da
kde-i18n-it
kde-i18n-de
kde-i18n-fr
kde-i18n-ru
kde-i18n-nl
kde-i18n-ja
kde-i18n-es
kde-i18n-cs
kde-i18n-pl
kde-i18n-tr
xfonts-intl-chinese
kword
kpresenter
abiword-gtk
karbon
kchart
kformula
kivio
koffice-libs
kontour
koshell
kspread

I copied the above list to a file ( say kicklist) then did
#dpkg -P `cat kicklist`
It removed all files listed (notice the back quote above )

If you are looking for big installed packages
# dpkg-awk “Status: .* installed$” — Package Installed-Size| awk ‘{print $2}’ | egrep -v ‘^$’ | xargs -n2 echo | perl -pe ‘s/(\S+)\s(\S+)/$2 $1/’ | sort -rg
will list the packages with size in descending order.

Finally run deborphan to check if there are any orphaned packages
#deborphan > /tmp/orphanlist
#dpkg -P `cat /tmp/orphanlist`
# rm /tmp/orphanlist

An alternate method is to use synaptic and add/remove packages from GUI. Synaptic is good graphical front end to apt

For this do
# apt-get install synaptic
You have to export DISPLAY environment variable for synaptic to work properly
#DISPLAY=myip:0.0 ( replace my ip with your actual IP)
#export DISPLAY
#synaptic

It will start synaptic
Enjoy apt through synaptic

Once you are finished with synaptic you can re master the cd. If you are working from a hard disk install of knoppix and want synaptic to work, look in/etc/X11/xinit/xserverrc and see that -nolisten tcp is removed.Also do xhost + as a non root user)

Unmount proc ( This is very important)
#umount /proc

Press control D to leave chrooted environment

Further Customization
1 Installing applications compiled from source

Download the software source inside chroot environment. Compile and install as usual . If it is an X11 application export display before you test
I use checkininstall to install and maintain home brew debs
Remember to remove the sources once you are finished (it will take up space on your CD).
2) Changing user settings

It is possible to set password for users. Just set it under chrooted environment
3) Changing backgrounds

/usr/local/lib/knoppix.gif is the default background image in X
4) Modifying Boot Screen

The Knoppix Cd uses syslinux to boot. If you want to change the boot screen/messages do the following. Make a temporary directory on your hard disk (I did mkdir /mnt/hda3/image)
Copy the boot.img file from Knoppix directory of your knoppix cd
#cp /KNOPPIX/boot.img /mnt/hda3
Mount the image as follows
# mount -t msdos -o loop /mnt/hda3/boot.img /mnt/hda3/image
Now look in the image directory you created. There are a number of interesting files in this directory
a) Boot logo
logo.16 is the image displayed on boot screen. It is encoded in a special format. For replacing it grab a 640*400 16 color image. I downloaded an image from gnu.org. Convert the image to a png file ( call it logo.png)

#pngtopnm logo.pnm

#ppmtolss16 logo.16

# cp logo.16 /mnt/hda3/image/logo.16

(Keep the size of the final log.16 around 50 k). Unmount image directory. Copy the boot.img to a floppy
#dd if=boot.img of=/dev/fd0
Boot the machine from the floppy you have made. If it boots up properly you are done
b) syslinux.cfg
By modifying syslinux.cfg you can change a number of parameters passwd on to the kernel. Read the man pages of syslinux for more details
5)Modifying kernel ( ****Untested ****)

Make a new custom kernel using kernel package . Keep the kernel size small. Copy the kernel to and modules to boot.img file. replace /lib/modules/2.4.19-xfs with modules of your new kernel
Replace files in /boot
6)Changing default GUI to Gnome/ icewm
Changing default gui to something else is quite easy
Under the chrooted environment open the file
/etc/init.d/knoppix-autoconfig

Look for the following lines
—————————————

#Also read desired desktop, if any

DESKTOP=”$(getbootparam desktop 2>/dev/null)”

# Allow only supported window managers

case “$DESKTOP” in gnome|kde|larswm|xfce|windowmaker|wmaker|icewm|fluxbox|twm) ;; *)

DESKTOP=”KDE”; ;; esac
——– ^^ ————————————–

Change the KDE above to gnome and that is all
7) Remove any temporary files
a) Look in /root for hidden files such as .bash_history .viminfo
b) Nuke all deb files in /var/cache/apt/archives
c) Run the knoppix.clean script ( Be careful and run it only from chrooted environmant)

(* link to the script goes here*)
Re mastering the CD
a)Make an ISO image

1) Make a new directory on /mnt/hda3
I called it NewCd
Copy Everything except Compressed image file(KNOPPIX) from knoppix cd (look at /cdrom). You can safely delete the directories demos and talks
2) Create the compressed Image
#mkisofs -R /mnt/hda3/KNOPPIX | create_compressed_fs – 65536 > /mnt/hda3/NewCD/KNOPPIX/KNOPPIX

3) Recreate the bootable CD
#cd /mnt/hda3

#mkisofs -r -J -b KNOPPIX/boot.img -c KNOPPIX/boot.cat -o myknoppix.iso NewCd
b)Testing the image

Create a boot floppy
# dd if=/mnt/hda3/KNOPPIX/boot.img of=/dev/fd0
Copy the compressed file you created to a directory /KNOPPIX on any partition. The boot floppy i will look for /KNOPPIX/KNOPPIX on hard disk partitions.This makes your testing easy. Once you are satisfied with your image burn itto a CD
FAQ

1) How do I stop konquerer at startup
To stop konquerers you have to modify
/etc/X11/Xsession.d/45xsession
Look for the following lines

——————————————-
if [ -e “$INDEXFILE” ]; then
cat >> $HOME/Desktop/KNOPPIX.desktop <
[Desktop Entry]
Name=KNOPPIX
Exec=kfmclient openProfile webbrowsing $INDEXFILE
Type=Application
Icon=html
Terminal=0
EOF
ln $HOME/Desktop/KNOPPIX.desktop $HOME/.kde/Autostart/showindex.desktop
fi
—————————————–

It makes an autostart file. Comment it out

2) I have booted knoppix cd and mounted a hard disk how do i copy something via scp to the hard disk
Open a shell
set a password for user knoppix
start ssh (/etc/init.d/ssh start)
Then copy with scp

3 I am at $ prompt I want to su
Do sudo passwd
set a root password
then su

4) default text mode boots up in frame buffer and characters are very small how do I fix it
Mount boot.img
look for syslinux.cfg
under Default vmlinuz
change VGA=791 to VGA=normal

5 )My keyboard lay out is German. How do i change it to English
Open KDE control center select system ->keyboard and change it to US English
References
I have adapted lot of material from the following links. Also #knoppix on irc.freenode.net is a good source of information
1)Tech2k home page
Ken Burk helped me a lot on irc to improve this document . His site has excellent information which you can always rely on. His kix remastering page is also very good
2) Knoppix.net
The unofficial knoppix site is a great source of information. Lots of new stuff regarding re-mastering appear there regularly
3) Knoppix forum at linuxtag
This site mixture of German and English . Very good source on Knoppix