4.3. Préparation des fichiers pour un amorçage avec une clé USB

To prepare the USB stick, we recommend to use a system where GNU/Linux is already running and where USB is supported. With current GNU/Linux systems the USB stick should be automatically recognized when you insert it. If it is not you should check that the usb-storage kernel module is loaded. When the USB stick is inserted, it will be mapped to a device named /dev/sdX, where the « X » is a letter in the range a-z. You should be able to see to which device the USB stick was mapped by running the command lsblk before and after inserting it. (The output of dmesg (as root) is another possible method for that.) To write to your stick, you may have to turn off its write protection switch.

[Avertissement] Avertissement

The procedures described in this section will destroy anything already on the device! Make very sure that you use the correct device name for your USB stick. If you use the wrong device the result could be that all information on, for example, a hard disk is lost.

4.3.1. Préparation d'une clé USB utilisant une image hybride de CD ou DVD

Debian installation images for this architecture are created using the isohybrid technology; that means they can be written directly to a USB stick, which is a very easy way to make an installation media. Simply choose an image (such as the netinst, CD or DVD-1) that will fit on your USB stick. See Section 4.1, « images d'installation Debian GNU/Linux officielles » to get an installation image.

Pour les clés de très petite taille (quelques mégaoctets), vous pouvez télécharger l'image mini.iso qui se trouve dans le répertoire netboot (son adresse précise est mentionnée dans la Section 4.2.1, « Où trouver les fichiers d'installation ? »)

L'image d'installation que vous avez choisie peut être transférée directement sur la clé. Toutes les données existantes sont détruites. Par exemple, avec un système GNU/Linux, après avoir vérifié que la clé n'est pas montée, vous pouvez copier l'image de cette manière :

# cp debian.iso /dev/sdX
# sync

Des informations sur la méthode à utiliser avec d'autres systèmes d'exploitation sont disponibles à la page de la FAQ de Debian CD.

[Important] Important

L'image doit être copiée sur le disque complet, et pas sur une partition. Par exemple /dev/sdb et non pas /dev/sdb1. N'utilisez pas d'outils qui modifient l'image, tels que unetbootin.

[Important] Important

Cette façon de faire devrait convenir à la plupart des utilisateurs. Les méthodes qui suivent sont plus complexes et sont destinées à des utilisateurs aux besoins spécifiques.

L'image hybride n'occupe pas toute la place sur la clé. Si vous n'avez qu'une seule clé ou si vous souhaitez mettre tout ce qui vous est nécessaire sur un seul périphérique, il peut être intéressant d'utiliser l'espace libre pour stocker d'autres fichiers, microprogrammes, paquets, etc.

To do so, use cfdisk or any other partitioning tool to create an additional partition on the stick. Then create a (FAT) filesystem on the partition, mount it and copy or unpack the firmware onto it, for example with:

# mkdosfs -n FIRMWARE /dev/sdX3
# mount /dev/sdX3 /mnt
# cd /mnt
# tar zxvf /path/to/firmware.tar.gz
# cd /
# umount /mnt

Take care that you use the correct device name for your USB stick. The mkdosfs command is contained in the dosfstools Debian package.

[Note] Note

If you have chosen the mini.iso to be written to the USB stick, the second partition doesn't have to be created, as - very nicely - it will already be present. Unplugging and replugging the USB stick should make the two partitions visible.

4.3.2. Copie des fichiers — méthode simple

Prior to isohybrid technology being used for Debian installation images, the methods documented in the chapters below were used to prepare media for booting from USB devices. These have been superseded by the technique in Section 4.3.1, « Préparation d'une clé USB utilisant une image hybride de CD ou DVD », but have been left here for educational and historical purposes and in case they are useful to some user.

An alternative to the method described in Section 4.3.1, « Préparation d'une clé USB utilisant une image hybride de CD ou DVD » is to manually copy the installer files, and also an installation image to the stick. Note that the USB stick should be at least 1 GB in size (smaller setups are possible using the files from netboot, following Section 4.3.3, « Copie des fichiers — méthode détaillée »).

There is an all-in-one file hd-media/boot.img.gz which contains all the installer files (including the kernel) as well as syslinux and its configuration file.

[Note] Note

Bien que pratique, cette méthode possède un inconvénient majeur : la taille logique du périphérique est limitée à 1 Go, même si la capacité de la clé est supérieure. Pour retrouver la taille réelle, il vous faudra repartitionner la clé et créer un nouveau système de fichiers.

Simply extract this image directly to your USB stick:

# zcat boot.img.gz > /dev/sdX

After that, mount the USB memory stick (mount /dev/sdX /mnt), which will now have a FAT filesystem on it, and copy a Debian ISO image (netinst or full CD; see Section 4.1, « images d'installation Debian GNU/Linux officielles ») to it. Unmount the stick (umount /mnt) and you are done.

4.3.3. Copie des fichiers — méthode détaillée

Si vous aimez la souplesse d'utilisation ou si vous voulez simplement savoir ce qui se passe, vous pouvez utiliser la méthode suivante pour placer les fichiers sur la clé. L'un des avantages de cette méthode est que, si la capacité de la clé est suffisante, vous pouvez copier n'importe quelle image ISO (même d'un DVD).

4.3.3.1. Partitioning and adding a boot loader

Nous montrerons comment utiliser seulement la première partition, au lieu de tout le périphérique.

Pour pouvoir lancer le noyau après l'amorçage sur la clé, nous y installons un programme d'amorçage. Tous les programmes d'amorçage fonctionnent, mais syslinux est préférable car il utilise une partition FAT16 et peut être reconfiguré en modifiant un simple fichier texte. On peut modifier la configuration du programme d'amorçage avec tous les systèmes d'exploitation qui acceptent le système de fichiers FAT.

First, you need to install the syslinux and mtools packages on your system.

[Note] Note

Since most USB sticks come pre-configured with a single FAT16 partition, you probably won't have to repartition or reformat the stick. If you have to do that anyway, use cfdisk or any other partitioning tool to create a FAT16 partition now[3], and then install an MBR using:

# cat /usr/lib/syslinux/mbr/mbr.bin 
>/dev/sdX

Now create the filesystem using:

# mkdosfs /dev/sdX1

Take care that you use the correct device name for your USB stick. The mkdosfs command is contained in the dosfstools Debian package.

Having a correctly partitioned USB stick (now), you need to put syslinux on the FAT16 partition with:

# syslinux /dev/sdX1

Again, take care that you use the correct device name. The partition must not be mounted when starting syslinux. This procedure writes a boot sector to the partition and creates the file ldlinux.sys which contains the boot loader code.

4.3.3.2. Adding the installer files

There are two different installation variants to choose here: The hd-media variant needs an installation ISO file on the stick, to load installer modules and the base system from. The netboot installer however will load all that from a Debian mirror.

According to your choice, you have to download some installer files from the hd-media or netboot subdirectory of debian/dists/bookworm/main/installer-amd64/current/images/ on any Debian mirror:

  • vmlinuz or linux (kernel binary)

  • initrd.gz (initial ramdisk image)

You can choose between either the text-based version of the installer (the files can be found directly in hd-media or netboot) or the graphical version (look in the respective gtk subdirectories).

Then mount the partition (mount /dev/sdX1 /mnt) and copy the downloaded files to the root directory of the stick.

Next you should create a text file named syslinux.cfg in the root directory of the stick as configuration file for syslinux, which at a bare minimum should contain the following line:

default vmlinuz initrd=initrd.gz

Change the name of the kernel binary to « linux » if you used files from netboot.

For the graphical installer (from gtk) you should add vga=788 at the end of the line. Other parameters can be appended as desired.

Pour que l'invite d'amorçage permette l'ajout de paramètres, créez une ligne prompt 1.

If you used files from hd-media, you should now copy the ISO file of a Debian installation image onto the stick. (For the netboot variant this is not needed.)

You can use either a netinst or a full CD/DVD image (see Section 4.1, « images d'installation Debian GNU/Linux officielles »). Be sure to select one that fits on your stick. Note that the « netboot mini.iso » image is not usable for this purpose.

When you are done, unmount the USB memory stick (umount /mnt).



[3] Don't forget to activate the « bootable » flag.