Premièrement installez le paquet jigdo-file :

# apt-get install jigdo-file

Jigdo est en plein développement. Les corrections et les améliorations sont constantes. En conséquence, si vous utilisez les distributions Débian stable ou testing, récupérez jigdo-file depuis la distribution instable http://packages.debian.org/unstable/utils/jigdo-file.html. Au 28 février 2003 c'était la version 0.6.9. C'est cette version qui est utilisée pour les exemples de ce guide pratique.

Note aux utilisateurs de la distribution Woody (stable) : la version de jigdo-lite (révision 1) qui est incluse dans la distribution Woody n'est pas capable de télécharger les distributions Sarge (testing) et Sid (instable). Voir la Section 6.11, «  [10 février 2003] : J'ai des difficultés à télécharger la distribution Sarge ou Sid avec Jigdo  ». Une version corrigée de jigdo 0.6.5 a été soumise, afin de devenir une future version 0.6.5 révision 2.

Pour chacune des images Iso que vous désirez récupérer, vous aurez besoins des deux fichiers .jigdo et .template de cette image. Les noms des deux fichiers suivent la même convention d'écriture :

distro-arch-n.jigdo
distro-arch-n.template

où distro est le nom de la distribution (par exemple « sarge »), arch est l'architecture de votre système (par exemple « i386 ») et n est le numéro du disque (comme par exemple « 1 »).

Par exemple, sarge a 8 images, vous devrez donc télécharger 8 fichiers .jigdo et 8 fichiers .template. Ils peuvent être téléchargés depuis http://www.debian.org/CD/jigdo-cd/. Les premiers fichiers .jigdo et .template file sont nommés sarge-i386-1.jigdo et sarge-i386-1.template respectivement.

Lancez jigdo-lite et indiquez-lui le fichier .jigdo de l'image que vous désirez télécharger. Prenons par exemple la distribution Woody :

lucifer$ ls
sarge-i386-1.jigdo  sarge-i386-1.template
lucifer$ jigdo-lite sarge-i386-1.jigdo 
     
Jigsaw Download "lite"
Copyright 2001-2003 by Richard Atterer <jigdo@atterer.net>
Getting mirror information from /etc/apt/sources.list
      
-----------------------------------------------------------------
Images offered by `sarge-i386-1.jigdo':
1: 'Debian GNU/Linux testing "Sarge" - Official Snapshot i386 Binary-1 CD' (sarge-i386-1.iso)

Further information about `sarge-i386-1.iso':
Generated on Fri, 7 Feb 2003 20:31:28 -0700

-----------------------------------------------------------------
If you already have a previous version of the CD you are
downloading, jigdo can re-use files on the old CD that are also
present in the new image, and you do not need to download them
again. Mount the old CD ROM and enter the path it is mounted under
(e.g. `/mnt/cdrom').
Alternatively, just press enter if you want to start downloading
the remaining files.
Files to scan: 

Si vous suspendiez jigdo-lite avec Ctrl-z (ne le faites pas, je vais vous dire ce que vous verriez) et regardiez le résultat d'un commande ls, vous trouveriez dans le répertoire un nouveau fichier nommé sarge-i386-1.jigdo.unpacked. En effet, les fichiers .jigdo sont compressés avec gzip. Ce fichier est simplement la version décompressée du fichier .jigdo.

Là où nous en sommes arrivé, jigdo-lite nous explique que, si nous disposons d'une version antérieure du premier CD de la distribution Sarge, nous devrions lui indiquer le chemin vers ce CD. C'est de cette façon qu'il est possible de mettre à jour une image Iso (ou de terminer un téléchargement incomplet). Comme nous supposons que vous partez de zéro et que vous ne disposez d'aucune image Iso Débian, vous n'avez rien à indiquer ici. Nous verrons cela dans la Section 5, « Mettre à jour votre image », donc contentez-vous d'appuyer sur ENTRÉE.

Vous allez voir :

-----------------------------------------------------------------
The jigdo file refers to files stored on Debian mirrors. Please
choose a Debian mirror as follows: Either enter a complete URL
pointing to a mirror (in the form
`ftp://ftp.debian.org/debian/'), or enter any regular expression
for searching through the list of mirrors: Try a two-letter
country code such as `de', or a country name like `United
States', or a server name like `sunsite'.
Debian mirror [http://linux.csua.berkeley.edu/debian/]: 

jigdo-lite est assez malin pour utiliser le même site miroir que celui que vous avez défini pour les mises à jour Débian en le récupérant dans le fichier /etc/apt/sources.list^[1]. Si vous désirez utiliser un autre site miroir, vous pouvez le faire ici en suivant ces instructions. Si le miroir indiqué est celui que vous désirez, appuyez sur ENTRÉE. Jigdo-lite écrira alors un fichier ~/.jigdo-lite dans votre répertoire personnel.

Ensuite, si le fichier .jigdo que vous utilisez mentionne un paquet qui doit être téléchargé depuis un serveur Non-US^[2], jigdo-lite va vous demander d'indiquer un miroir Débian Non-US. Le message affiché (et votre réponse) seront très similaires au dialogue qui a été décrit au paragraphe précédant (mais cette fois pour un miroir Non-US (-: ).

-----------------------------------------------------------------
The jigdo file also refers to the Non-US section of the Debian
archive. Please repeat the mirror selection for Non-US. Do not
simply copy the URL you entered above; this does not work because
the path on the servers differs!
Debian non-US mirror [http://linux.csua.berkeley.edu/debian-non-US//]: 

Jigdo-lite va enregistrer votre choix dans le fichier ~/.jigdo-lite. Cependant, si l'image que vous êtes sur le point de télécharger ne contient pas de logiciels non-US, cette question ne vous sera pas posée.

Si, ultérieurement, vous désirez changer les miroirs par défaut utilisés par Jigdo, il suffira de modifier les deux lignes suivantes :

debianMirror='http://un-miroir-a-utiliser/debian/'
nonusMirror='http://un-autre-miroir/debian-non-US/'

dans le fichier ~/.jigdo-lite.

Lorsque vous aurez indiqué à jigdo-lite les sites miroirs, jigdo-lite va commencer à télécharger les fichiers pour reconstruire l'image Iso :

Not downloading .template file - `sarge-i386-1.template' already present

-----------------------------------------------------------------
Merging parts from `file:' URIs, if any...
Found 0 of the 826 files required by the template
Will not create image or temporary file - try again with different input files
--09:35:12--  http://linux.csua.berkeley.edu/debian/pool/main/p/pack/pack_3.10-1_i386.deb
    => `sarge-i386-1.iso.tmpdir/linux.csua.berkeley.edu/debian/pool/main/p/pack/pack_3.10-1_i386.deb'
Resolving linux.csua.berkeley.edu... done.
Connecting to linux.csua.berkeley.edu[128.32.112.231]:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1,911,624 [application/x-debian-package]

19% [======>                              ] 378,304      149.87K/s    ETA 00:09

De nombreux messages vont défiler sur votre écran ; si c'est très perturbant pour vous, reportez-vous à la Section 6.12, «  Jigdo-lite est trop bavard. Comment puis-je supprimer tous ces messages ?  ». Pendant que jigdo-lite télécharge les paquets, basculez vers une autre console (ou bien ouvrez un autre xterm) et lancez un ls dans le répertoire d'où vous exécutez jigdo-lite. Il devrait maintenant y avoir 6 fichiers dans ce répertoire :

Le répertoire sarge-i386-1.iso.tmpdir/ contient tous les paquets Débian téléchargés par Jigdo. Assez régulièrement, ce répertoire est vidé et les fichiers qu'il contient sont écrits dans sarge-i386-1.iso.tmp. Ce fichier est une version temporaire incomplète de l'image Iso que vous êtes en train de récupérer. Notez que sarge-i386-1.iso.tmp n'apparaîtra qu'à partir de la première fois où sarge-i386-1.iso.tmpdir/ aura été vidé.

jigdo-file-cache.db est un fichier de base de données Berkeley (format Berkeley DB) contenant une somme de contrôle md5 pour chacun des fichiers lus dans les répertoires que vous avez indiqués à la question Files to scan:. Il est décrit dans la Section 7.3, « jigdo-file-cache.db ».

Lorsque vous en serez arrivés là, allez faire une partie de Quake III, car cela va prendre un certain temps. Et vous feriez mieux de jouer sur une autre machine car Jigdo utilise le disque de manière intensive lorsqu'il vide les fichiers dans le fichier .iso.tmp. Au bout d'un moment, le téléchargement se terminera et vous verrez ceci :

FINISHED --13:32:58--
Downloaded: 7,469,872 bytes in 9 files
Found 9 of the 9 files required by the template                              
Successfully created `sarge-i386-3.raw'

-----------------------------------------------------------------
Finished!
The fact that you got this far is a strong indication that `sarge-i386-3.raw'
was generated correctly. I will perform an additional, final check,
which you can interrupt safely with Ctrl-C if you do not want to wait.

OK: Checksums match, image is good!   

Ce qui signifie que jigdo-lite a fini de créer l'image. Après vous avoir proposé d'arrêter là (avec Ctrl-c), il a réalisé une vérification supplémentaire pour s'assurer que l'image était correcte. Pour cela, il a calculé la somme de contrôle de l'image et vérifié qu'elle correspondait bien à la valeur attendue. L'image téléchargée est donc valide.