Knoppix Documentation Wiki - User contributions [en]

Knoppix Remastering Howto French

2005-04-23T15:58:46Z

FrE: un '''Bold text''' qui n'avait rien a faire là a été envlevé

== Traductions: ==
* Version Anglaise: [[Knoppix Remastering Howto]]
* Version Allemande: [[Knoppix Remastering Howto Deutsch]]
* Version Espagnole: [[Knoppix Remastering Howto Spanish]] en espagnol
----
== Voir aussi : ==
* Si vous voulez ajouter un noyau personnalisé, regardez le [[Knoppix Custom Kernel Howto]]
* Il y a aussi un guide aux éditions O'reilly sur le même sujet : [[http://linux.oreillynet.com/lpt/a/4323 Utiliser et personnaliser Knoppix]]
----
=== Ceci est un guide qui va vous montrer comment remasteriser KNOPPIX ===
(Notes : Les commandes doivent apparaitre sur une ligne, maximisez la fenêtre s'il vous plait. Si vous avez des commentaires/suggestions, merci de les poster ci-dessous.)

Vous voulez peut être commencer à partir d'une Knoppix déjà personnalisée, si tel est le cas vous n'avez probablement pas autant de travail à faire (comme enlever des programmes). Si vous êtes dans ce cas, voir [[Knoppix Customizations]].

==== Système Requis: ====
*CD-ISO
** Au moins 1 GB de mémoire RAM+Swap libre totale (ex 256M ram, et 750M swap DISPONIBLE) (à moins que vous utilisiez un programme de compression différent - voir cette page pour [[http://projects.openoffice.nl/downloads/compressloop/ compressloop]])
** 3 GB de libre sur une partition '''Linux filesystem (ext2/3, xfs, etc.)''' formattée
*DVD-ISO
** 5 GB de RAM + swap libre (pour le DVD en entier)
** 15 GB de libre sur une partition '''Linux filesystem (ext2/3, xfs, etc.)''' formattée

==== Instructions: ====

# Booter à partir du ''Knoppix CD''
# Ouvrir un shell root :
** Menu: Kmenu->Knoppix->Shell Root
** Note: Toutes les commandes ci-dessous s'éxecutent à partir de ce shell root.
# Configurer votre connexion internet (nous en aurons besoin plus tard). Si vous utilisez DHCP, cela devrait déjà être configuré.
** Note: Executez '''ifconfig''' pour vérifier.
# Trouver la partition que vous utiliserez pour travailler. Dans cet exemple, elle est appellée '''hda1''' . La partition devrait avoir au minimum 3 GB d'espace libre.
# Monter la partition:
** '''mount -rw /dev/hda1 /mnt/hda1'''
** Note: Soyez sûr d'avoir les droits en lecture/écriture ou vous aurez des erreurs lors du chroot plus tard. Pour vérifier: éxecuter '''mount'''
# Créer un repertoire racine pour travailler dedans:
** '''mkdir /mnt/hda1/knx'''
** Si vous mettez tous vos fichiers ici, ils seront plus facile à nettoyer
# Si vous n'avez pas 1 GB de RAM ('''cat /proc/meminfo''' (physical+swap)) alors vous devrez avoir un fichier de swap:
** '''cd /mnt/hda1/knx ; dd if=/dev/zero of=swapfile bs=1M count=750 ; mkswap swapfile ; swapon swapfile'''
# Créer 2 repertoires, un pour votre nouveau Master CD, un pour les sources, sur une partition. Créer également des répertoires additionnels sous celui-ci nommé KNOPPIX:
** '''mkdir -p /mnt/hda1/knx/master/KNOPPIX'''
** '''mkdir -p /mnt/hda1/knx/source/KNOPPIX'''
# Maintenant, copiez les fichiers KNOPPIX vers votre répertoire source :
'''cp -Rp /KNOPPIX/*''' '''/mnt/hda1/knx/source/KNOPPIX '''
** Note: Cela peut prendre un petit momment
# Copier la page HTML principale pour la page de démarrage :
** '''cp /cdrom/index.html /mnt/hda1/knx/master/ '''
# Copier tout les fichiers nécessaires execpté le fichier KNOPPIX de ~700 Mb .
** < 3.4: '''cd /cdrom/KNOPPIX;find . -size -10000k -type f -exec cp -p --parents '{}' /mnt/hda1/knx/master/KNOPPIX/ \;'''
** 3.4: '''cd /cdrom;find . -size -10000k -type f -exec cp -p --parents '{}' /mnt/hda1/knx/master/ \;'''
# Maintenant, vous pouvez "chrooter" dans l'arborescence copiée du fichier KNOPPIX:
** '''chroot /mnt/hda1/knx/source/KNOPPIX'''

Si vous avez un ensemble d'erreurs '''/dev/null permission denied''', vous devriez faire ce qui suit. Ceci peut arriver si vous sauvez vos données configurées pour la Knoppix sur la même partition que celle que vous utilisez, ET si vous démarrrez Knoppix avec '''knoppix home=scan'''.

Vérifiez l'état de vos montages si vous rencontrez le probleme: '''mount /dev/hdaX on /mnt/hdaX type ext3 (rw,nosuid,nodev)''' (remplacer X par le numéro de votre partition) où "nodev" signifie que vous n'avez pas accès au système de fichier monté et que vous ne pouvez ainsi pas acceder à /dev/null. Alors que cetains scripts ont besoin de rediriger leur sortie vers /dev/null ... Pour résoudre ceci, vous devez monter la partiton cible avant de "chrooter", comme ca :
^d # control+d sortira de l'environnement chroot
mount /dev/hda1 /mnt/hda1
Vous devriez ensuite voir:
mount /dev/hda1 on /mnt/hda1 type ext3 (rw)

Si les erreurs "/dev/null" persistent, faites alors avant le chroot :
mount --bind /dev /mnt/hda1/knx/source/KNOPPIX/dev
Vous devez démonter /mnt/hda1/knx/source/KNOPPIX/dev avant de construire l'image du CD ou bien votre répertoire /dev sur le CD sera en bordel !

Ensuite vous pouvez continuer et chrooter.

* Vous êtes maintenant "chrooter". "/" est en fait "/mnt/hda1/knx/source/KNOPPIX"
* Pour utiliser votre connexion internet you devez monter proc '''mount -t proc /proc proc'''
* Maintenant éditer /etc/resolv.conf et ajouter votre serveur de nom ou "sortir" du chroot et copier le fichier resolve.conf dans le dossier chrooté: '''cp /etc/dhcpc/resolv.conf vers /mnt/hda1/knx/source/KNOPPIX/etc/dhcpc/resolv.conf'''
* Changer aussi smb.conf vers votre groupe MS si vous voulez le support smbd (MSHOME pour XP Familliale édition, et WORKGROUP pour les Windows 9x).
* Vérifiez votre connection internet chrootée : '''ping google.com'''
* Mettez à jour votre list de paquet avec '''apt-get update'''
* Maintenant vous pouvez changer des trucs.
* '''Attention''': apt-get upgrade est une MAUVAISE IDEE. Cela va, très probablement, rendre votre KNOPPIX remasterisée inbootable, ou cassée en quelque sorte. Une méthode bien plus sûre est de seulement mettre à jour les paquets nécessaires
** Avant de pouvoir ajouter des choses, vous aurez probablement besoin d'enlever quelques packages. Pour avoir une liste des packages installé, tapez ce qui suit:
'''*''' '''dpkg-query -l'''
** Si vous voulez une liste triée par taille (de cette façon vous vous pourrez vous débarassez des plus encombrants), tapez :
'''*''' '''dpkg-query -W --showformat='${Installed-Size} ${Package}\n' | sort -n'''
** Pour enlever un paquet (et toutes ses dépendances), tapez:
'''*''' '''apt-get remove <name-of-package-to-remove>'''
** Pour vérifier les paquets orphelins, tapez:
'''*''' '''deborphan'''
** Pour vouloir économiser plus de place en se débarrassant de ces irritants orphelins (comme c'est cruel!), tapez ('''Attention''', vous n'aurez pas à confirmer pour enlever ces paquets. Quand vous pressez Entrée après cette commande, ces paquets '''seront partis'''):
'''*''' '''deborphan | xargs apt-get -y remove'''
** Si vous êtes incertain quand à la commande précèdente et voulez voir ce qu'il va se passer sans faire de changement, ajoutez simplement l'option '''-s''' à la commande apt-get comme cela (vous pouvez faire ça avec toutes les commandes apt-get, et c'est une bonne habitude d'utiliser cette option avant des opérations "massive" comme celle la):
'''*''' '''deborphan | xargs apt-get -s -y remove'''
** Maintenant les bonnes choses. Si vous voulez ajouter un package, tapez:
'''*''' '''apt-get install <name-of-package-to-install>'''
** Quoi, vous ne savez pas quel paquet installer ? Tapez cela. Quand la liste apparait, vous pouvez lire attentivement (13000 lignes !) ou chercher des termes en utilisant '''/<terme-a-recherher>''':
'''*''' '''apt-cache search .* | sort | less'''
** Quand vous avez fini d'enlever et d'ajouter des paquets, un bon moyen de nettoyer est de taper:
'''*''' '''COLUMNS=200 dpkg -l |grep ^rc |awk '{print $2} ' | xargs dpkg -P'''
** De même,parce que le système des paquets Debian garde en cache ce qui a été téléchargé, vous pouvez éxecuter la commande suivante pour faire le ménage :
'''*''' '''apt-get clean'''
** les paramètres utilisateurs sont dans /etc/skel
** astuce: ne mettez pas de fichiers dans /root ils seront seulement disponible (durant l'éxecution) dans /KNOPPIX/root
* Unmount /proc - très important! '''umount /proc'''
* Presser '''CTRL+D''' pour quitter l'environnement chrooté.

==== Notes : ====

Quand vous testez des programmes basés sur X, vous aurez a faire '''export DISPLAY=localhost:0.0'''

Quand vous voulez auto-éxecuter quelques programmes, créez un script et placez le dans le repertoire /etc/rc5.d/ (Ceci charge seulement les items avant que X ne se charge)

trucs interessants dans /etc/init.d/knoppix-autoconfig :
* Le fichier fond d'écran est /cdrom/KNOPPIX/background.gif '''(dans knoppix 3.4: background.jpg)'''
* Comme pour floppyconfig, il existe cdromconfig qui lancera cdrom/KNOPPIX/knoppix.sh

trucs intéressants dans /etc/init.d/xsession :
* Ca place également le fond d'écran dans /usr/local/lib/knoppix.gif

Maintenant, la création de l'image ISO :

* nous avons fini de personnaliser et sommes prêt à graver !
* d'abord faire quelques nettoyages : ''' enlever le fichier .bash_history , les fichiers tmp etc '''
* '''rm -rf /mnt/hda1/knx/source/KNOPPIX/.rr_moved'''
* Maintenant, nous allons faire un gros fichier KNOPPIX qui est un système de fichier ISO 9660 cloop (compress loopback) compressé (cloop compressed ISO 9660 filesystem) : '''mkisofs -R -U -V "KNOPPIX.net filesystem" -publisher "KNOPPIX www.knoppix.net" -hide-rr-moved -cache-inodes -no-bak -pad /mnt/hda1/knx/source/KNOPPIX | nice -5 /usr/bin/create_compressed_fs - 65536 > /mnt/hda1/knx/master/KNOPPIX/KNOPPIX'''

le "www.knoppix.net" et le "Knoppix.net filesystem" peuvent être changé par le nom que vous voulez donner au fichier. Vous aurez une erreur si vous ne respectez les standards de la norme ISO9660, sans trop grande importance.

Dans Knoppix 3.4 le script create_compressed_fs a été mis à jour, utilisez le pour obtenir les meilleurs résultats.
Il possède une nouvelle option '''-b''' (best), qui permet une meilleure compression en utilisant différents arrangement de compression et essaye d'optimiser ce processus, mais soyez vigilant, parce que cette option est lente (10x plus lente).

* Si tout va bien, faisons l'image du CD final :
* '''cd /mnt/hda1/knx/master'''
* '''rm -f KNOPPIX/md5sums; find -type f -not -name md5sums -not -name boot.cat -not -name isolinux.bin -exec md5sum '{}' \; >> KNOPPIX/md5sums''' (ceci va mettre à jour les hashages md5 des fichiers inclus dans l'ISO, utilisé pour les vérifications d'intégrité)
* Pour Knoppix <= 3.3: '''mkisofs -pad -l -r -J -v -V "KNOPPIX" -b KNOPPIX/boot.img -c KNOPPIX/boot.cat -hide-rr-moved -o /mnt/hda1/knx/knoppix.iso /mnt/hda1/knx/master''' (the ISO is stored in /mnt/hda1/knx/knoppix.iso)
* Pour Knoppix >= 3.4 ou autre distribution basée sur isolinux, faites:
'''mkisofs -pad -l -r -J -v -V "KNOPPIX" -no-emul-boot -boot-load-size 4 -boot-info-table -b boot/isolinux/isolinux.bin -c boot/isolinux/boot.cat -hide-rr-moved -o /mnt/hda1/knx/knoppix.iso /mnt/hda1/knx/master''' (l'ISO est stockée dans /mnt/hda1/knx/knoppix.iso)
* Voila !

=== Astuces ===
Si vous êtes à la recherche des gros paquets installés, alors la commande
: 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
listera les paquets par taille en ordre décroissant.
Cette commande est 10 fois plus rapide

: dpkg-query -W --showformat='${Installed-Size} ${Package}\n' | sort -n

et vous n'avez pas besoin de dpkg-awk ou awk ou perl.

Si vous avez des problèmes avec la commande de tri précèdente, essayez d'utiliser KPackage, elle parcoure les arborescences et trie par taille à la recherche de gros paquets.

Regardez du côté du programme "deborphan", il liste les paquets orphelins que vous pouvez enlever, ces paquets étaient utilisés par des paquets qui sont maintenant enlevés.

J'ai eu des bons résultats de remastering à partir du cd en tant que root, travaillant à partir de fluxbox. Choisir "knoppix 2" lors du boot et le système va démarrer sur une invite de commande root où vous pourrez dire "startx /usr/bin/fluxbox". J'aime utiliser le shell unicode xterm.

Lors du travail en chroot pour le remastering, j'aime bien utiliser "apt-get remove --purge nom-du-paquet" pour enlever les paquets parce que avant de faire quoi que ce soit cela va stopper et montrer les détails sur ce que apt va supprimer; il faut confirmer par "oui" ou "non".

Si vous n'utilisez pas l'instruction "apt-get" ci dessus et si vous avez beaucoup de ménage à faire, la façon la plus simple de faire est :
"COLUMNS=200 dpkg -l |grep ^rc |awk '{print $2} ' >topurge". Ceci fera une liste de tout les paquets enlevés à purger et ensuite vous n'avez plus qu'a faire "dpkg -P `cat topurge `" et voila.
"COLUMNS=200 dpkg -l |grep ^rc |awk '{print $2} ' | xargs dpkg -P" est la même chose en une ligne.
Aussi "deborphan >orphaned" puis "dpkg -P `cat orphaned `". "deborphan | xargs dpkg -P " est une version en une seule ligne de cela.

Ca y est. Ceci est une version mise à jour de mon précèdent howto. Il n'est pas destiné aux débutant sous linux, vous devriez avoir une bonne connaissance de linux pour tout faire fonctionner. Je le metterais à jour via des corrections et des améliorations bientôt.

Merci a aay, charan, Tech2k, and #knoppix pour les quelques corrections, astuces et idées. Libre à vous d'éditer ou de compléter ce how-to
Note à propose de la swap:<br>
Vous n'avez pas réellement besoin d'1G de swap puisque il y a deux nouveaux outils de compressions de système de fichiers. Voila deux candidats pour faire des système de fichiers ''compressés'':
* Réecriture de Valentijn [http://projects.openoffice.nl/downloads/compressloop/]
* Port de compressloop par Quozl's pour la Knoppix 3.4 [http://quozl.linux.org.au/compressloop-1.9-64bit.c]
* Compressloop répartis par Quozl's (utiliser plus d'un processeur pour accelerer les choses) [http://quozl.linux.org.au/knoppix/compressloop/] or [http://quozl.netrek.org/knoppix/compressloop/]
* Patch de Justin [http://s.bouncybouncy.net/~justin/code/] (lien cassé) J'ai également écrit un compresseur réparti cloop (ou pour smp) C'est dans le même repertoire.

==== Astuce, tester le cd-image sans graver le cd ====

Si vous avez une partition avec au moins 700MB d'espace libre formattée en ext2, ext3 ou Vfat, vous pouvez l'utiliser pour tester en démarrant à partir d'une disquette. Une disquette de démarrage recherchera une partition avec /KNOPPIX dans la racine, et l'image compressée /KNOPPIX/KNOPPIX. Au lieu d'utiliser le sous répertoire /mnt/hda1/knx/master/KNOPPIX/ comme décrit précèdemment, il devrait être appellé /mnt/hda2/KNOPPIX/ . La racine index.html sera située dans /mnt/hda2/index.html et l'image compressée sera dans /mnt/hda2/KNOPPIX/KNOPPIX . Maintenant vous pouvez booter à partir de la disquette et utiliser /mnt/hda2 comme image. Pour plus d'informations voir [[Hd BasedHowTo]].

Si vous n'avez pas de partitions supplémentaires ou si vous ne voulez pas en faire autant, vous pouvez utiliser Qemu (voir
[http://fabrice.bellard.free.fr/qemu/] ) avec l'image ISO comme ça:
'''qemu -m 128 -cdrom /temp/knoppix-custom.iso -boot d -user-net'''
Vous n'avez même pas à créer une image sur le disque dur avant, seulement installer Qemu et l'essayer. Stupéfiant!

==== Démarrer les images Knoppix avec GRUB ====
* D'abord copier /boot du cd Knoppix cd vers votre partition de boot (ou même votre partition dos). J'ai nommé la mienne boot.knoppix
''' Copier le répertoire /KNOPPIX vers votre '''répertoire racine* d'un des diques dur. Vous pouvez le placer ailleurs que dans une partition de boot. (ext2/3, reiserfs, vfat sont supportés)
* Mettre les éléments suivants dans votre /boot/grub/menu.lst:
title KNOPPIX
root (hd0,0)
kernel /boot.knoppix/vmlinuz 2 fromhd=/dev/hda4 lang=us
initrd /boot.knoppix/miniroot.gz
* Remarquer le paramètre "fromhd": c'est l'emplacement du repertoire /KNOPPIX
* redémarrez et appreciez.

Si mon how-to est trop confus, ou si vous voulez une secondes opinion, regardez le très joli remastering howto de charan :
http://gnubox.dyndns.org:8080/~sunil/knoppix.php .
Un autre howto est disponible à l'adresse http://www.stirnimann.com/mystuff/doc/knoppix.txt

Il y a un assistant qui connais toutes les démarches d'installation, compression et gravure de CD mentionnées ici. Il propose également un shell ou vous pouvez mettre à jour la KNOPPIX décompressée en utilisant les outils standards Debian d'installation de logiciel. Il s'appelle mmkcdrom et fait partie du packaqe plugscript: [http://rcswww.urz.tu-dresden.de/~holzhey/plugscript]

Encore un autre Howto, pour les adeptes du shell sur http://quozl.linux.org.au/knoppix/

Soyez sûr de jeter un oeil à [http://knoppix.net/forum/viewforum.php?f=2 Knoppix Customization Forum] pour des idées et de l'aide concernant le remastering.
----
Une l'arborescence recommandée pour remasteriser une KNOPPIX:
. (invoke ../remaster from here)
|-- master (invoke ../../[[u]]mountbootimage from here)
| |-- KNOPPIX
| | |-- KNOPPIX (compressed image)
| | |-- boot.img (boot floppy image)
| | `-- (other files snipped)
| `-- index.html
`-- source
`-- KNOPPIX (this directory can be chrooted into)
|-- bin
|-- boot
|-- cdrom
|-- dev
|-- etc
|-- floppy
|-- home
|-- initrd
|-- lib
|-- mnt
|-- none
|-- opt
|-- proc
|-- root
|-- sbin
|-- tmp -> /var/tmp
|-- usr
|-- var
`-- vmlinuz -> boot/vmlinuz-2.4.22-xfs
----
Le script suivant "remaster" fera le processus de remasterisation à votre place. Lancez le en tant que root, ou il se terminera avec des erreurs d'accès sur l'image.

Le script a été essayé sur une Debian sid le 02-04-2002

#!/bin/bash -x
# This script builds a new KNOPPIX ISO image.
# Copyright (C) 2004 by Marc Haber <mh+knoppix-remaster@zugschlus.de>
# License: GPL V2

ROOT="$PWD"
SOURCE="$ROOT/source/KNOPPIX"
MASTER="$ROOT/master"
CLOOPTARGET="$ROOT/master/KNOPPIX/KNOPPIX"
TARGET="$ROOT"
EXCLUDELIST="$ROOT/source/excludelist"

rm -rf $SOURCE/.rr_moved

cd $SOURCE
mkisofs -R -U -V "KNOPPIX.net filesystem" \
-P "KNOPPIX www.knoppix.net" \
-hide-rr-moved -cache-inodes -no-bak -pad \
-exclude-list $EXCLUDELIST \
. | nice -5 /usr/bin/create''compressed''fs - 65536 > $CLOOPTARGET

cd $MASTER
rm -f KNOPPIX/md5sums
find -type f -not -name md5sums -not -name boot.cat -exec md5sum {} \; >> KNOPPIX/md5sums
mkisofs -pad -l -r -J -v -V "KNOPPIX" -b KNOPPIX/boot.img \
-c KNOPPIX/boot.cat -hide-rr-moved -o $TARGET/knoppix.iso $MASTER
----
The following script will loop-mount boot floppy image and initrd image for modification. The umount function will build a new initrd image and put it back on the boot floppy image.

The script has last been tried out on Debian sid on 2004-01-13.

#!/bin/bash -x
# This script will loop-mount boot floppy and initrd image
# Copyright (C) 2004 by Marc Haber <mh+knoppix-remaster@zugschlus.de>
# License: GPL V2
unset CDPATH || true

# if not root, re-invoke self as root
if [[ "`id -u`" -ne 0 ]]; then
export LOCUSER="$USER"
export LOCHOME="$HOME"
if [[ "${SHELLOPTS/xtrace/}" != "$SHELLOPTS" ]]; then
sudo bash -x $0 $@
exit $?
else
sudo $0 $@
exit $?
fi
else
LOCUSER="${LOCUSER:-$USER}"
LOCHOME="${LOCHOME:-$HOME}"
fi
set -e

KNOPPIXDIR="KNOPPIX"
BOOTIMGFILE="$KNOPPIXDIR/boot.img"
BOOTIMGFS="vfat"
BOOTIMGDIR="boot.img"
INITRDGZ="$BOOTIMGDIR/miniroot.gz"
INITRDFILE="$KNOPPIXDIR/miniroot"
INITRDFS="ext2"
INITRDDIR="miniroot"

mountbootimage() {
if ! modprobe loop; then
echo >&2 "ERR: cannot load loop module"
exit 1
fi

if ! [[ -e "$BOOTIMGFILE" ]]; then
echo >&2 "ERR: no $BOOTIMGFILE found"
exit 1
fi

for nofile in $BOOTIMGDIR $INITRDGZ $INITRDFILE $INITRDDIR; do
if [[ -e "$nofile" ]]; then
echo >&2 "ERR: $nofile already exists"
exit 1
fi
done

mkdir -p $BOOTIMGDIR
mount -o loop,uid=$LOCUSER -t $BOOTIMGFS $BOOTIMGFILE $BOOTIMGDIR

< $INITRDGZ gunzip > $INITRDFILE
mkdir -p $INITRDDIR
mount -o loop -t $INITRDFS $INITRDFILE $INITRDDIR
}

umountbootimage() {
dd if=/dev/zero of=$INITRDDIR/nullfile || true
sync
rm $INITRDDIR/nullfile
umount $INITRDDIR
rmdir $INITRDDIR
< $INITRDFILE gzip --best > $INITRDGZ
rm -f $INITRDFILE

umount $BOOTIMGDIR
rmdir $BOOTIMGDIR

syslinux KNOPPIX/boot.img
}

case "`basename $0`" in
mountbootimage)
mountbootimage
;;
umountbootimage)
umountbootimage
;;
*)
echo >&2 "ERR: called with unknown name `basename $0`"
exit 1
;;
esac

Knoppix Remastering Howto

2005-04-23T15:55:17Z

FrE: removed a '''Bold text''' that was notthing to do there

== Translations: ==
* German Version: [[Knoppix Remastering Howto Deutsch]]
* Spanish Version: [[Knoppix Remastering Howto Spanish]] en español
* French Version: [[Knoppix Remastering Howto French]]
* Indonesian Version: [[Knoppix Remastering Howto Indonesian]]
* Russian Version: [[Knoppix Remastering Howto Russian]]
----

== See also : ==
* If you want to add a custom kernel, check out the [[Knoppix Custom Kernel Howto]]
* There also a guide at O'Reilly on the same topic : [http://linux.oreillynet.com/lpt/a/4323 Using and Customizing Knoppix]
----
=== This is a guide that will show you how to remaster KNOPPIX ===
(Notes : commands should appear on one line, so please maximize the window. If you have any comments/suggestions please post below.)

You may wish to start from an already customized Knoppix, so you don't have to do as much work (such as removing programs). If so, see [[Knoppix Customizations]].

==== System Requirements: ====
*CD-ISO
** at least 1 GB of FREE RAM+Swap total (e.g. 256M ram, and 750M swap AVAILABLE) (unless you use a different compression program - look in this page for compressloop)
** 3 GB free on a '''Linux filesystem (ext2/3, xfs, etc.)''' formatted disk partition
*DVD-ISO
** 5 GB free RAM + swap (for fullsized DVD)
** 15 GB free on a '''Linux filesystem (ext2/3, xfs, etc.)''' formatted disk partition

==== Instructions: ====

# Boot from the ''Knoppix CD''
# Open a root shell:
** Menu: Kmenu->Knoppix->Root Shell
** Note: All commands below are run from this root shell.
# Configure your Internet connection (we'll need this later). If you use DHCP, it should already be configured.
** Note: Run '''ifconfig''' to check.
# Find the partition you will use to work on. In this example it is called '''hda1''' . The partition should have a minimum of 3 GB free space
# Mount the partition:
** '''mount -rw /dev/hda1 /mnt/hda1'''
** Note: Make sure that it is read/write or you will get errors when you later chroot. To check: run '''mount'''
# Create a root directory to work in:
** '''mkdir /mnt/hda1/knx'''
** If you put all your files here and it will be easy to clean up
# If you don't have 1 GB RAM ('''cat /proc/meminfo''' (physical+swap)) then you will need a swapfile:
** '''cd /mnt/hda1/knx ; dd if=/dev/zero of=swapfile bs=1M count=750 ; mkswap swapfile ; swapon swapfile'''
# Make 2 directories, one for your new Master CD, one for the source, on a disk partition. Also, make additional directories under these named KNOPPIX:
** '''mkdir -p /mnt/hda1/knx/master/KNOPPIX'''
** '''mkdir -p /mnt/hda1/knx/source/KNOPPIX'''
# Now, copy the KNOPPIX files to your source directory :
'''cp -Rp /KNOPPIX/*''' '''/mnt/hda1/knx/source/KNOPPIX '''
** Note: This will take a little while
# Copy the main HTML page for the startup page:
** '''cp /cdrom/index.html /mnt/hda1/knx/master/ '''
# Copy everything necessary files except the ~700 Mb KNOPPIX file.
** < 3.4: '''cd /cdrom/KNOPPIX && find . -size -10000k -type f -exec cp -p --parents '{}' /mnt/hda1/knx/master/KNOPPIX/ \;'''
** 3.4: '''cd /cdrom && find . -size -10000k -type f -exec cp -p --parents '{}' /mnt/hda1/knx/master/ \;'''
# Now you can "chroot" into the copied KNOPPIX:
** '''chroot /mnt/hda1/knx/source/KNOPPIX'''

If you get a whole lot of '''/dev/null permission denied'''
errors, you should do the following. This can happen if you save your Knoppix configure data to the same partition that you are using here, AND if you start with Knoppix with '''knoppix home=scan'''.

Check your mount status if you met the problem: '''mount /dev/hdaX on /mnt/hdaX type ext3 (rw,nosuid,nodev)''' (replace X with your partiton number ) where "nodev" means that you are not accessible on mounted filesystem and you can not access /dev/null. And some scripts get output redirect
to /dev/null... To solve this you should mount the target partition before you do chroot
like this:
^d # control+d will exit the chroot
mount /dev/hda1 /mnt/hda1
You should then see:
mount /dev/hda1 on /mnt/hda1 type ext3 (rw)

If the /dev/null warnings persist then before the chroot do :
mkdir /mnt/hda1/knx/source/KNOPPIX/KNOPPIX
mount --bind /KNOPPIX /mnt/hda1/knx/source/KNOPPIX
mount --bind /dev /mnt/hda1/knx/source/KNOPPIX/dev
'''Better to reboot your box or you have to umount /mnt/hda1/knx/source/KNOPPIX/dev and rm /mnt/hda1/knx/source/KNOPPIX/KNOPPIX before building the CD image or your /dev directory on the CD will be messed up! then you can carry on and chroot.'''

* You are now chrooted. "/" is actually "/mnt/hda1/knx/source/KNOPPIX"
* To use the internet you need to mount proc '''mount -t proc /proc proc'''
* Now edit /etc/resolv.conf and add your nameserver or "exit" chroot and copy the resolve.conf into the chroot folder: '''cp /etc/dhcpc/resolv.conf to /mnt/hda1/knx/source/KNOPPIX/etc/dhcpc/resolv.conf'''
* Also change smb.conf to your MS group if you want smbd support (MSHOME is XP Home ed. usually, and WORKGROUP is 9x Windows.
* check your chrooted internet connection : '''ping google.com'''
* Update your package list with '''apt-get update'''
* '''Note:''' If ''''apt-get update''' fails with "FATAL -> Could not set non-blocking flag Bad file descriptor", you need to make sure your chrooted environment is mounted without the "nodev" option. (see above where it talks about the /dev/null errors when entering the chroot environment for the first time)
* Now you can change stuff.
* '''Warning''': apt-get upgrade is a BAD IDEA. It will, quite probably, render your KNOPPIX remaster unbootable, or broken in some way. A far safer method is to only upgrade packages as necessary
** Before you can add stuff, you will probably need to remove some packages. To get a list of packages installed, type this:
'''*''' '''dpkg-query -l'''
** If you want that list sorted by size (this way you can get rid of the biggies), type this:
'''*''' '''dpkg-query -W --showformat='${Installed-Size} ${Package}\n' | sort -n'''
** To remove a package (and all packages dependant on it), type this:
'''*''' '''apt-get remove --purge <name-of-package-to-remove>'''
** To check for orphaned packages, type this:
'''*''' '''deborphan'''
** Want to save more space by getting rid of those pesky orphans (how cruel!), type this ('''Warning''', you won't be prompted yes/no to remove these packages. When you press Enter after this command, those packages '''will be gone'''):
'''*''' '''deborphan | xargs apt-get -y remove'''
** If you're uncertain about the previous command and want to see what will happen without making any changes, just add the '''-s''' option to the apt-get command like this (you can do this with all of the apt-get commands, and it's a good habit to use this option before mass operations like this one):
'''*''' '''deborphan | xargs apt-get -s -y remove'''
** Now the good stuff. If you wish to add a package, type this:
'''*''' '''apt-get install <name-of-package-to-install>'''
** What, don't know what packages to install? Type this. When the list appears, you can peruse (over 13k lines!) or search for things using '''/<search-term>''':
'''*''' '''apt-cache search .* | sort | less'''
** When you're done removing and adding packages, a good way to clean up is by typing this:
'''*''' '''COLUMNS=200 dpkg -l |grep ^rc |awk '{print $2} ' | xargs dpkg -P'''
** Also, because the Debian package system keeps a cache of downloaded packages, you may want to run the following to clear out those spare files:
'''*''' '''apt-get clean'''
** user settings are in /etc/skel
** tip: don't put files in /root they will be only available (at runtime) in /KNOPPIX/root
* Unmount /proc - very important! '''umount /proc'''
* Press '''CTRL+D''' to leave being chrooted.

==== Notes : ====

When testing X-based programs, you will have to '''export DISPLAY=localhost:0.0'''

When you want to autorun some programs, one can create a script and put it in the directory /etc/rc5.d/ (This only loads items before X loads)

interesting stuff in /etc/init.d/knoppix-autoconfig :

* The X background file is /cdrom/KNOPPIX/background.gif '''(in knoppix 3.4: background.jpg)'''
* As well as floppyconfig, there is cdromconfig which will run cdrom/KNOPPIX/knoppix.sh

interesting stuff in /etc/init.d/xsession :
* it ALSO sets background as /usr/local/lib/knoppix.gif

Now, onto creating the ISO file :

* we've finished customizing and ready to burn!
* first do some cleanup : ''' remove .bash_history files, tmp files etc '''
* '''rm -rf /mnt/hda1/knx/source/KNOPPIX/.rr_moved'''
* Now we'll make the big KNOPPIX file which is a cloop compressed ISO 9660 filesystem : '''mkisofs -R -U -V "KNOPPIX.net filesystem" -publisher "KNOPPIX www.knoppix.net" -hide-rr-moved -cache-inodes -no-bak -pad /mnt/hda1/knx/source/KNOPPIX | nice -5 /usr/bin/create_compressed_fs - 65536 > /mnt/hda1/knx/master/KNOPPIX/KNOPPIX'''

the "www.knoppix.net" and "Knoppix.net filesystem" can be changed to what you want to call the file. You will get an error that it doesn't conform to ISO standards, you can ignore this.

In Knoppix 3.4 the create_compressed_fs script has been updated so be sure to use it to obtain the best result.
It has a new option '''-b''' (best), which enables the best compression by using
different compression schemes and tries to optimize that way, but be careful, because that option is slow (10x slower).

* if all went well, onto making the final CD-ROM Image :
* '''cd /mnt/hda1/knx/master'''
* '''rm -f KNOPPIX/md5sums; find -type f -not -name md5sums -not -name boot.cat -not -name isolinux.bin -exec md5sum '{}' \; >> KNOPPIX/md5sums''' (this will update the md5 hashes of the files included in the ISO, used for integrity checking)
* for Knoppix <= 3.3: '''mkisofs -pad -l -r -J -v -V "KNOPPIX" -b KNOPPIX/boot.img -c KNOPPIX/boot.cat -hide-rr-moved -o /mnt/hda1/knx/knoppix.iso /mnt/hda1/knx/master''' (the ISO is stored in /mnt/hda1/knx/knoppix.iso)
* For Knoppix >= 3.4 or other isolinux based distributions do:
'''mkisofs -pad -l -r -J -v -V "KNOPPIX" -no-emul-boot -boot-load-size 4 -boot-info-table -b boot/isolinux/isolinux.bin -c boot/isolinux/boot.cat -hide-rr-moved -o /mnt/hda1/knx/knoppix.iso /mnt/hda1/knx/master''' (the ISO is stored in /mnt/hda1/knx/knoppix.iso)
* all done!

=== Tips ===
If you are looking for big installed packages then the command
: 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.
At least ten times faster is the command

: dpkg-query -W --showformat='${Installed-Size} ${Package}\n' | sort -n

and you don't need dpkg-awk or awk or perl.

If you have trouble with the above sort command, try using KPackage, expanded all the trees and sorted by the size column to find big packages.

Check out the program "deborphan", it will list orphaned packages that you can remove, these packages were used by packages that are now removed.

I have had good results remastering working from the cd as root working from fluxbox. Just say "knoppix 2" at the boot prompt and it will boot you to a root prompt where you can then say "startx /usr/bin/fluxbox". I like to use the xterm unicode shell.

While working chroot doing the remastering I like to use "apt-get remove --purge pkg-name" to remove packages because before it does anything it will stop and show detials on what it is fixing to remove and let you say "yes or no".

If you don't use the above "apt-get" instructions and have a lot to cleanup and purge, here's the easy way to do it: "COLUMNS=200 dpkg -l |grep ^rc |awk '{print $2} ' >topurge". That will make a list of all removed packages to purge and then you just say "dpkg -P `cat topurge `" and your all done. "COLUMNS=200 dpkg -l |grep ^rc |awk '{print $2} ' | xargs dpkg -P" is a one-line version of this.
Also use "deborphan >orphaned" then "dpkg -P `cat orphaned `". "deborphan | xargs dpkg -P " is a one line version for that.

Thats it. This is an updated version of my previous howto. This is not meant for linux beginners, you will need to know your way around linux to get this to work. I'll update this as corrections/improvements/etc come through.

Thanks to aay, charan, Tech2k, and #knoppix for some corrections and tips and ideas. Feel free to edit or add to this howto.
Note about swap:<br>
You don't really need 1G swap as there are two new tools to create compressed filesystems. Here are some candidates to make''compressed''fs:
* Valentijn's rewrite [http://projects.openoffice.nl/downloads/compressloop/]
* Quozl's port of compressloop for Knoppix 3.4 [http://quozl.linux.org.au/compressloop-1.9-64bit.c]
* Quozl's distributed compressloop (use more than one processor to speed things up) [http://quozl.linux.org.au/knoppix/compressloop/] or [http://quozl.netrek.org/knoppix/compressloop/]
* Justin's patch [http://s.bouncybouncy.net/~justin/code/] (link broken) I also just wrote a distributed cloop compressor(or for smp) It's in that same directory.

==== Tip, test cd-image without recording cd ====

If you have a spare partition with at least 700MB free space formatted with ext2, ext3 or Vfat, you can use this for test by booting from a floppy disk. A floppy boot will look for a partiton with /KNOPPIX/ in the root, and the compressed image /KNOPPIX/KNOPPIX. Instead of using the sub-directory /mnt/hda1/knx/master/KNOPPIX/ as described above, it should be called /mnt/hda2/KNOPPIX/ . The root index.html will then be located at /mnt/hda2/index.html and the compressed image will be at /mnt/hda2/KNOPPIX/KNOPPIX . Now you can boot from floppy and use /mnt/hda2 as your image. For further information see [[Hd BasedHowTo]].

If you don't have an extra partition or you don't want to do so much for it, you can use Qemu ( see [http://fabrice.bellard.free.fr/qemu/] ) with the ISO image like this:
'''qemu -m 128 -cdrom /temp/knoppix-custom.iso -boot d -user-net'''
You even do not have to build a hard disk image before, just install Qemu and try this. Amazing!

==== Booting Knoppix images with GRUB ====
* First copy /boot of the Knoppix cd to your boot partition (or even your dos partition). I named mine boot.knoppix
''' Copy the /KNOPPIX directory to your '''root directory* of any hard disk. You may place it somewhere other than the boot partition. (ext2/3, reiserfs, vfat are supported)
* put the following in your /boot/grub/menu.lst:
title KNOPPIX
root (hd0,0)
kernel /boot.knoppix/vmlinuz 2 fromhd=/dev/hda4 lang=us
initrd /boot.knoppix/miniroot.gz
* notice the fromhd parameter: it's the location of the /KNOPPIX directory
* reboot and have fun.

If my howto is too confusing, or you'd like a second opinion, check out charan's very nice remastering howto : http://gnubox.dyndns.org:8080/~sunil/knoppix.php .
Another Howto is at http://www.stirnimann.com/mystuff/doc/knoppix.txt

There is a wizard, which knows all the unpacking, compressing and CD-recording steps mentioned here. It also shows a shell where you can update the uncompressed KNOPPIX system using debian's standard software installation tools. It is called mmkcdrom and part of the plugscript package: [http://rcswww.urz.tu-dresden.de/~holzhey/plugscript]

Yet another HOWTO, for shell freaks, is at http://quozl.linux.org.au/knoppix/

Be sure to check out the [http://knoppix.net/forum/viewforum.php?f=2 Knoppix Customization Forum] for ideas and help with remastering.
----
This is the recommended directory layout for remastering KNOPPIX:
. (invoke ../remaster from here)
|-- master (invoke ../../[[u]]mountbootimage from here)
| |-- KNOPPIX
| | |-- KNOPPIX (compressed image)
| | |-- boot.img (boot floppy image)
| | `-- (other files snipped)
| `-- index.html
`-- source
`-- KNOPPIX (this directory can be chrooted into)
|-- bin
|-- boot
|-- cdrom
|-- dev
|-- etc
|-- floppy
|-- home
|-- initrd
|-- lib
|-- mnt
|-- none
|-- opt
|-- proc
|-- root
|-- sbin
|-- tmp -> /var/tmp
|-- usr
|-- var
`-- vmlinuz -> boot/vmlinuz-2.4.22-xfs
----
the following script "remaster" will do the remaster process for you. Use as root, or you will end up with wrong access rights in the image.

The script has last been tried out on Debian sid on 2004-04-02.

#!/bin/bash -x
# This script builds a new KNOPPIX ISO image.
# Copyright (C) 2004 by Marc Haber <mh+knoppix-remaster@zugschlus.de>
# License: GPL V2

ROOT="$PWD"
SOURCE="$ROOT/source/KNOPPIX"
MASTER="$ROOT/master"
CLOOPTARGET="$ROOT/master/KNOPPIX/KNOPPIX"
TARGET="$ROOT"
EXCLUDELIST="$ROOT/source/excludelist"

rm -rf $SOURCE/.rr_moved

cd $SOURCE
mkisofs -R -U -V "KNOPPIX.net filesystem" \
-P "KNOPPIX www.knoppix.net" \
-hide-rr-moved -cache-inodes -no-bak -pad \
-exclude-list $EXCLUDELIST \
. | nice -5 /usr/bin/create''compressed''fs - 65536 > $CLOOPTARGET

cd $MASTER
rm -f KNOPPIX/md5sums
find -type f -not -name md5sums -not -name boot.cat -exec md5sum {} \; >> KNOPPIX/md5sums
mkisofs -pad -l -r -J -v -V "KNOPPIX" -b KNOPPIX/boot.img \
-c KNOPPIX/boot.cat -hide-rr-moved -o $TARGET/knoppix.iso $MASTER
----
The following script will loop-mount boot floppy image and initrd image for modification. The umount function will build a new initrd image and put it back on the boot floppy image.

The script has last been tried out on Debian sid on 2004-01-13.

#!/bin/bash -x
# This script will loop-mount boot floppy and initrd image
# Copyright (C) 2004 by Marc Haber <mh+knoppix-remaster@zugschlus.de>
# License: GPL V2
unset CDPATH || true

# if not root, re-invoke self as root
if [[ "`id -u`" -ne 0 ]]; then
export LOCUSER="$USER"
export LOCHOME="$HOME"
if [[ "${SHELLOPTS/xtrace/}" != "$SHELLOPTS" ]]; then
sudo bash -x $0 $@
exit $?
else
sudo $0 $@
exit $?
fi
else
LOCUSER="${LOCUSER:-$USER}"
LOCHOME="${LOCHOME:-$HOME}"
fi
set -e

KNOPPIXDIR="KNOPPIX"
BOOTIMGFILE="$KNOPPIXDIR/boot.img"
BOOTIMGFS="vfat"
BOOTIMGDIR="boot.img"
INITRDGZ="$BOOTIMGDIR/miniroot.gz"
INITRDFILE="$KNOPPIXDIR/miniroot"
INITRDFS="ext2"
INITRDDIR="miniroot"

mountbootimage() {
if ! modprobe loop; then
echo >&2 "ERR: cannot load loop module"
exit 1
fi

if ! [[ -e "$BOOTIMGFILE" ]]; then
echo >&2 "ERR: no $BOOTIMGFILE found"
exit 1
fi

for nofile in $BOOTIMGDIR $INITRDGZ $INITRDFILE $INITRDDIR; do
if [[ -e "$nofile" ]]; then
echo >&2 "ERR: $nofile already exists"
exit 1
fi
done

mkdir -p $BOOTIMGDIR
mount -o loop,uid=$LOCUSER -t $BOOTIMGFS $BOOTIMGFILE $BOOTIMGDIR

< $INITRDGZ gunzip > $INITRDFILE
mkdir -p $INITRDDIR
mount -o loop -t $INITRDFS $INITRDFILE $INITRDDIR
}

umountbootimage() {
dd if=/dev/zero of=$INITRDDIR/nullfile || true
sync
rm $INITRDDIR/nullfile
umount $INITRDDIR
rmdir $INITRDDIR
< $INITRDFILE gzip --best > $INITRDGZ
rm -f $INITRDFILE

umount $BOOTIMGDIR
rmdir $BOOTIMGDIR

syslinux KNOPPIX/boot.img
}

case "`basename $0`" in
mountbootimage)
mountbootimage
;;
umountbootimage)
umountbootimage
;;
*)
echo >&2 "ERR: called with unknown name `basename $0`"
exit 1
;;
esac

==== Tips around apt-get to install/update/remove applications ====
(by gnarvaja)
* If you booted from CD, even on a HD install (example: Pivot Install) instead of copying the original CD and KNOPPIX directory to the HD, you can use them directly from their mount points.
* Another alternative is to mount an ISO image of the original CD as a loop device and mount the KNOPPIX image as a '''cloop''' device. You will save close to 2GB of space. Script to mount from an ISO image:

#!/bin/bash
# Assumes that the current directory is the working space
# original.iso is an image of the CD we will be using as master
mount -t iso9660 original.iso ./oldcd -o ro,loop
# initialize the compressed loop device
losetup /dev/cloop1 ./oldcd/KNOPPIX/KNOPPIX
mount -t iso9660 /dev/cloop1 ./KNOPPIX -o ro,loop

* Get '''apt-spy''' and use it to modify the sources.list file with the best mirrors for your particular region. This will speed up the downloading. Backup the original '''sources.list''' just in case.
* Another technique is to modify '''sources.list'''. Replace the string '''.de.''' in the ftp addresses (ftp.de.debian.org) with the code corresponding to your country. Examples: USA -> .us. (ftp.us.debian.org), Brazil -> .br. (ftp.br.debian.org). Check the Debian site for debian.org mirrors in your country.
* Remember to uncomment the '''linuxtag''' ftp addresses to get the latest and greatest from Knoppix
* Use '''apt-get update''' to get the lists with the latest releases and patches. Do not update a package if you don't need to, it may lead to the use of additional disk space (precious commodity when you want to keep everything below 700MB) and you may brake something else without knowing. Abuse the '''-s''' option to simulate the installation.
* Before doing the update, I modified my default releases to '''testing''', that means that the software I'll be using will have a good balance of stability and features. Knoppix uses '''unstable''' by default, which is too risky for my personal taste.
* Get '''[apt-get install] locale''' and configure it with the locales you are going to use. It will save lots of space when downloading applications with plenty of locale modules and localized manual pages.
* I use '''aptitude''' to get/remove applications, it is character based so it works with init 2. As you mark packages for install/update/removal, it will tell you how much disk space you will save/use, try to solve depencies problems and give you plenty control to fix them manually when possible.
* When installing applications it is likely that your '''/etc/rc?.d''' directories will have new entries, many of them unwanted or unplanned. Make sure you check them and remove the new entries based on your preferences. I usually leave '''/etc/rc2.d''' and '''/etc/rc5.d''' as close as the originals as possible and modify '''/etc/rc3.d''' and '''/etc/rc4.d''' to test new stuff. '''Example:''' You may want to have ntfs installed, but not necessarily running by default. Same with apache, mysql and many others.
* When removing/purging applications, they may leave behind non-empty directories. Usually this is announced by aptitude, apt-get or any other installation utilty. Make sure to check the messages and manually remove those directories.
* After you are done, '''aptitude''' may leave some files behind. Here's a clean up script I use:

# !/bin/bash
# Clean package files generated by aptitude
rm /var/log/aptitude
rm /var/lib/apt/lists/*debian*
rm /var/lib/apt/lists/*knoppix*