Petit guide du logiciel Jigdo de Débian

Copyright © 2001 Peter Jay Salzman <p@dirac.org> pour la version originale.

Copyright © 2004 Philippe Lhardy, Claude Thomassin et Jean-Philippe Guérard pour la version française.

Vous avez l'autorisation de copier, de distribuer et de modifier ce document selon les termes définis par la version 1.1 de la licence « Open Software Licence » (OSL), exception faite des provisions indiquées dans le dernier paragraphe. J'ai horreur des guides pratiques qui incluent la licence : c'est un gâchis d'arbres. La licence OSL est consultable en anglais à l'adresse suivante : http://opensource.org/licenses/osl-1.1.txt.

This document is copyright (c) 2001 Peter Jay Salzman, <p@dirac.org>. Permission is granted to copy, distribute and/or modify this document under the terms of the Open Software License (OSL), version 1.1, except for the provisions I list in the next paragraph. I hate HOWTO's that include the license; it's a tree killer. You can read the OSL at http://opensource.org/licenses/osl-1.1.txt.

Si vous désirez créer un travail dérivant de ce guide pratique ou bien publier ce guide pratique à des fins commerciales, j'apprécierais que vous me contactiez d'abord. Cela me donnera une chance de vous en fournir la version la plus récente. J'apprécierais également soit une copie de ce que vous faites, soit une pizza épinard, ail, champignon, féta et cœur d'artichaut.

If you want to create a derivative work or publish this HOWTO for commercial purposes, I would appreciate it if you contact me first. This will give me a chance to give you the most recent version. I'd also appreciate either a copy of whatever it is you're doing or a spinach, garlic, mushroom, feta cheese and artichoke heart pizza.

Le document source servant à créer les différents formats de ce guide pratique est disponible sur le site du projet traduc.org.

Initialement, je voulais simplement remercier l'auteur de Jigdo, Richard Atterer <atterer CHEZ debian POINT org>, d'avoir écrit Jigdo. Toute personne ayant obtenu des images Iso Débian par une autre méthode comprendra pourquoi. Cependant, mes remerciements se doivent d'aller plus loin. Ce guide pratique a démarré à partir de quelques pages web que j'avais rédigés sur mon expérience de Jigdo. Richard a pris le temps de m'envoyer par courrier électronique des corrections, des clarifications et des réponses très complètes à mes questions sur Jigdo. Depuis lors, il a relu mon travail plusieurs fois. Richard est un développeur qui ne se contente pas de s'occuper de son travail, mais qui s'intéresse aussi aux gens qui l'utilisent. C'est triste, mais c'est devenu de moins en moins courant dans le monde industrieux où nous vivons. Merci Richard !

Je désirerais remercier également Conrad Wood <cnw CHEZ conradwood POINT net>, Elcio Mello <mello CHEZ ajato POINT com POINT br>, Marcelo Ramos <mramos CHEZ montevideo POINT com POINT uy>, Yufeng Wang <ipzh CHEZ 163 POINT net> et Tsukasa Yamaguchi <tyamagch CHEZ bd POINT mbn POINT or POINT jp> pour avoir traduit ce petit guide. Je me sens vraiment honoré qu'ils aient trouvé que mes mots méritaient leur temps et leurs efforts. Merci, les gars !

Pour finir je voudrais remercier Mark van Lent <mark CHEZ panic POINT et POINT tudelft POINT nl> pour ses paroles pleines de gentillesse et ses corrections si nécessaire.

Je porte beaucoup d'attention aux personnes qui utilisent ce document. L'écriture, même de petits guides, demande beaucoup de temps, et je ne voudrais pas avoir investi autant d'efforts dans quelque chose que personne ne comprenne. Si vous avez des commentaires, des corrections ou bien des suggestions, même relatives à mon style dans la version originale, n'hésitez pas à m'envoyer un courrier électronique. Aussi longtemps que je ne serai pas totalement englué dans ma dissertation de doctorat et dans le livre que j'écris sur le débogage de code avec GDB et DDD pour No Starch Press, je ferai de mon mieux pour répondre à chacun des courriers que je recevrai [en anglais] à propos de ce petit guide.

N'hésitez pas à faire parvenir tout commentaire relatif à la version française de ce document à <commentaires CHEZ traduc POINT org> en précisant le titre et la version de ce document.

La version anglaise et toutes ses traductions sont disponibles sur mon site web : http://www.dirac.org/linux/debian/jigdo. Si vous désirez traduire ce petit guide dans une autre langue, je vous remercie de me contacter [en anglais] à l'adresse <p CHEZ dirac POINT org>.

La version anglaise stable de ce document est disponible sur le site du Projet de documentation Linux (LDP) http://tldp.org/docs.html dans la section « howto ». Si vous désirez voir le travail en cours, vous trouverez la toute dernière version de ce document sur http://www.dirac.org/linux/debian/jigdo.

La dernière version française de ce document est disponible sur le site du projet traduc.org.

Si vous désirez votre propre jeu de CD Débian, il y a de multiples façons de procéder. Vous pouvez les acheter depuis la liste des sociétés qui distribuent des CD Débian. Cela vaut vraiment la peine car ces sociétés reversent des subsides au projet Débian. Vos dons contribuent donc à pérenniser ce projet.

Un autre moyen d'obtenir un jeu de CD Débian est de les graver vous-même. Pour cela, il faut d'abord obtenir l'image Iso puis la graver sur un CD-ROM vierge. Avant Jigdo, il était possible de créer des CD Débian de deux façons différentes :

Ce document présente un outil appelé Jigdo, qui est la nouvelle meilleure façon d'obtenir des images Iso Débian. En fait, le kit pseudo-image est aujourd'hui officiellement mort et les parties le concernant ont été supprimées de ce document. Jigdo est la méthode canonique pour obtenir une image Iso Débian.

Il existe des sites miroirs qui permettent de télécharger des images Iso Débian via les protocoles HTTP et FTP. Le problème est qu'il y a très peu de sites miroirs et que leur bande passante n'est pas suffisante pour tous ceux qui désirent télécharger des images Iso Débian. Par exemple, il a été rapporté que le site fsn.hu avait saturé la connexion de son fournisseur d'accès. Le débit sortant atteint quelques téraoctets par mois !

De plus, les distributions testing et instable de Débian sont fréquemment mises à jour. Vos images Iso risquent d'être déjà obsolètes le jour même de leur téléchargement, à moins que vous ne trouviez quelque moyen tordu de les mettre à jour, par exemple en les montant sur un périphérique de bouclage (loopback) et en utilisant rsync (ce que faisait le kit pseudo image). Donc si vous désirez des images à jour, vous devrez télécharger un nouveau jeu de CD chaque jour. Clairement, ce n'est pas la bonne façon de procéder !

Même si vous désirez télécharger une image Iso de la distribution stable Débian, ces images seront tout de même mises à jour après quelques mois. Télécharger des images Iso vous donnera donc des images à jour pour seulement quelques mois. À chaque sortie d'une nouvelle révision de la distribution stable Débian, vous devrez recommencer à zéro le pénible processus de téléchargement de l'ensemble des images. Ça n'est ni une bonne utilisation de votre temps, ni des ressources du miroir.

Jigdo (qui signifie « Jigsaw Download » c'est-à-dire « téléchargement pièce par pièce ») a été écrit par Richard Atterer <atterer CHEZ debian POINT org> et est diffusé sous la licence publique générale GNU (GPL). C'est un outil qui permet le téléchargement et la mise à jour efficace des images Iso. De n'importe quelle image. Jigdo n'est pas spécifique à Débian. Débian l'a cependant choisi comme méthode officielle de téléchargement pour ses images Iso.

Une erreur très répandue est de croire que Jigdo crée des images Iso : il ne le fait pas. Examinons la façon de procéder de Jigdo pour obtenir une image Iso. Appelons Alain la personne qui diffuse l'image Iso (peut-être est-il le responsable de la publication des nouvelles versions de la distribution Débian). Et Béatrice, la personne qui veut télécharger l'image Iso (c'est peut-être une utilisatrice de la distribution Débian).

L'outil Jigdo contient deux utilitaires : jigdo-file et jigdo-lite. jigdo-file sera utilisé par Alain pour créer les fichiers .template et .jigdo à partir de son image Iso. Jigdo-lite sera utilisé par Béatrice pour télécharger l'image en utilisant les fichiers .jigdo et .template. Si la seule chose que vous désiriez est de télécharger des images Iso Débian, vous n'aurez besoin que de jigdo-lite. Vous pouvez même oublier que jigdo-file existe :-)

Jigdo permet de s'affranchir des problèmes des autres méthodes de téléchargement d'images Iso Débian :

Jigdo est sans l'ombre d'un doute la meilleure façon d'obtenir des images Iso Débian.

Une image CD est un système de fichiers appelé iso9660. Pour cette discussion, nous pouvons sans risque parler d'une image CD comme étant un gros fichier (de près de 650 Mo) appelé « image Iso » qui contient des fichiers à des positions différentes. Par exemple, si un CD contient un fichier de 567 octets nommé LISEZ.MOI, l'image Iso peut inclure le contenu de ce fichier entre les positions (offset) 20480000 et 20480566. Vous pouvez vous représenter une image CD comme ceci :

              -----------------------------------------------
Image Iso :   |xx| fichier-0 |x| fichier-1 |x| fichier-2 |xx|
              -----------------------------------------------

Les zones avec des « x » de l'image contiennent des choses telles que le contenu des répertoires, du remplissage par des zéro, le nom du disque, le bloc d'amorçage, et cætera.

jigdo-file utilise deux choses en entrée : l'image complète du CD (donc l'image Iso doit avoir été faite) et un ensemble de fichiers qui peuvent se trouver ou non dans l'image. Voici une représentation de ce qui est fourni en entrée à jigdo-file :

Image  -----------------------------------------------
 Iso : |xx| fichier-0 |x| fichier-1 |x| fichier-2 |xx|
       -----------------------------------------------
Fichiers  ------------- -------------                -------------
 libres : | fichier-0 | | fichier-1 |                | fichier-3 |
          ------------- -------------                -------------

Comme par magie, jigo-file retrouvera quels fichiers libres sont contenus dans l'image Iso et leur position (offset) à l'intérieur du fichier Iso. Il générera deux fichiers : un fichier « .template » et un fichier « .jigdo ».

Partant d'une image Iso et d'un ensemble de fichiers (contenus ou non dans l'image Iso), jigdo-file générera un fichier .template pour cette image Iso. Voici à quoi ressemble ce fichier .template :

             -----------------------------------------------
.template :  |xx|  md5-0    |x|  md5-1    |x|ccccccccccc|xx|
             -----------------------------------------------

jigdo-file a déterminé que les fichiers fichier-0 et fichier-1 étaient contenus dans l'image Iso. Il a supprimé le contenu de ces fichiers et l'a remplacé par la somme de vérification md5 de chaque fichier (md5-0 et md5-1).

Les données représentées par des « x » (contenu des répertoires, remplissage par zéro, et cætera) contenues dans l'image Iso sont compressées et écrites dans le fichier .template. Pour terminer, tous les fichiers contenus dans l'image Iso mais non fournis parmi les fichiers libres (tel que fichier-2) sont également compressés et écrits dans le fichier .template. Ceci est représenté par les « c » dans la représentation du fichier .template.

Les fichiers libres qui étaient fournis à jigdo-file et qui n'ont pas été trouvés dans l'image Iso (tel fichier-3) sont ignorés.

À partir d'une image Iso et d'un ensemble de fichiers qui peuvent se trouver ou non dans l'image Iso, jigdo-file génère un fichier .jigdo correspondant à cette image Iso. Les fichiers .jigdo Débian sont compressés avec gzip, vous devrez donc utiliser zcat ou zless pour visualiser leur contenu. Voici à quoi ressemble ce fichier une fois décompressé avec gunzip :

md5-0=http://un_miroir.org/fichier-0
md5-1=http://un_miroir.org/fichier-1
md5-2=http://un_miroir.org/fichier-2

Le fichier .jigdo fournit tout simplement une correspondance entre la somme de contrôle md5 du fichier contenu dans l'image Iso et l'URL où télécharger ce fichier. Il y a d'autres choses à l'intérieur du fichier .jigdo  si vous y regardez de plus près, vous verrez que le fichier .jigdo a le même format qu'un fichier « .ini ». Cela doit être compréhensible en soi, mais si vous désirez plus de détails, reportez-vous à la documentation de jigdo.

Le format montré ci-dessus n'est pas ce que vous verriez effectivement dans un fichier .jigdo normal, mais cela devrait fortement y ressembler. Si vous jetez un coup d'œil à la section [Servers] en bas du fichier .jigdo, vous verrez précisément ce qui diffère entre ce que j'ai montré ici et un vrai fichier .jigdo.

Après avoir utilisé jigdo-file pour générer les fichiers .jigdo et .template à partir d'une image Iso, n'importe qui peut utiliser jigdo-lite pour télécharger cette image. jigdo-lite utilise wget pour télécharger tous les fichiers inclus dans l'image Iso, les rassemble et crée à la volée une copie de l'image Iso originale.

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.

Éditez le fichier ~/.jigdo-lite (ou jigdo-lite-settings.txt pour la version Windows) dans un éditeur de texte et trouvez la ligne commençant par « wgetOpts ». Vous pouvez y ajouter les options suivantes :

-e ftp_proxy=http://mandataire-local:port/
-e http_proxy=http://mandataire-local:port/
--proxy-user=identifiant
--proxy-passwd=mot_de_passe

Substituez-y bien évidemment les valeurs correctes pour votre serveur mandataire. Les deux dernières options ne sont nécessaires que si votre mandataire utilise l'authentification par mots de passes. Les options doivent être ajoutées à la fin de la ligne wgetOpts et avant le caractère « ' » final. Toutes les options doivent se trouver sur une seule ligne.

Sous Linux, une autre façon de procéder est de définir les variables d'environnement ftp_proxy et http_proxy, par exemple en les ajoutant dans le fichier /etc/environment ou dans le fichier ~/.bashrc.

Évidemment, Cela ne devrait pas se produire™, mais pour des raison diverses et variées vous pourriez vous retrouver dans un état où un gros fichier « .iso.tmp » a déjà été généré et où jigdo-lite a apparemment des problèmes et vous répète continuellement de recommencer le téléchargement. Dans un tel cas, vous pouvez tentez plusieurs choses :

J'ai eu beaucoup de difficultés à faire publier les traductions de ce guide pratique par certains éditeurs des projets de documentation Linux (LDP) non-anglophones.

Marco Budde <Budde CHEZ tu TIRET harburg POINT de>, l'éditeur du projet de documentation Linux allemand, a refusé d'accepter la traduction allemande de ce document, car elle était écrite au format DocBook et non au format LinuxDoc. Ceci en dépit du fait que le format DocBook soit le format SGML préféré du Projet de documentation Linux anglophone. C'est une honte qu'il y ait au sein de la communauté des logiciels ouverts (open source) des gens qui sabotent notre communauté de l'intérieur.

L'éditeur LDP portugais, Alfredo Carvalho <ajpc CHEZ poli POINT org> a complètement ignoré la traduction en portugais que je lui ai fait parvenir.

Si vous tenez à avoir des documents du Projet de documentation Linux dans ces langues, je vous invite à écrire à ces éditeurs et à leur demander de bien vouloir agir d'une manière plus responsable lorsqu'ils reçoivent des documents traduits. En attendant, vous pouvez obtenir ces traductions sur mon site personnel, http://www.dirac.org/linux/debian/jigdo.

Le téléchargement peut être accéléré en utilisant un serveur HTTP au lieu d'un serveur FTP — FTP n'est pas très efficace pour le téléchargement d'un grand nombre de petits fichiers. Je vous recommande également de mettre à jour la version de wget que vous utilisez, car les dernières versions permettent les connexions HTTP persistantes, ce qui permet d'obtenir un petite accélération supplémentaire.

Malheureusement, même avec des connexions HTTP persistantes, la vitesse de téléchargement ne sera jamais aussi bonne qu'avec le téléchargement d'un unique fichier Iso. De telles vitesses ne peuvent être atteinte que par des transferts HTTP en série (pipelining) — La version en mode graphique de Jigdo permettra les transferts en série.

Si le téléchargement est interrompu, il vous suffit de relancer jigdo-lite et d'appuyer sur ENTRÉE à chaque question posée. Jigdo-lite reprendra là où il en était.

Il est possible que le fichier .jigdo que vous avez téléchargé soit défectueux. C'est très rare, mais cela arrive de temps en temps avec des cibles mouvantes telles que les distributions Débian testing et instable.

Si vous vous apercevez que le fichier .jigdo est défectueux, vous devrez télécharger un nouveau fichier .jigdo (lorsqu'un fichier corrigé sera disponible), mais vous n'aurez jamais besoin de télécharger à nouveau toutes les données de l'image Iso.

Vous pouvez utiliser la même astuce de montage en boucle que nous avons utilisé pour mettre à jour notre image Iso. La différence est que vous ne disposez pas d'une image .iso complète pour démarrer. Cependant, le fichier .iso.tmp est également une image Iso et peut être utilisé pour recommencer le téléchargement sans avoir à re-télécharger toutes les données précédemment téléchargées.

Montez simplement en boucle (loop) le fichier .iso.tmp sur /mnt. Lorsque vous relancerez jigdo-lite avec le fichier .jigdo corrigé, dites simplement à Jigdo de parcourir le répertoire /mnt. N'oubliez pas de renommer ou de déplacer le fichier .iso.tmp afin qu'il n'interfère pas avec la création d'un nouveau .iso.tmp par jigdo-lite.

Absolument ! Le procédé est identique au téléchargement d'une image de CD. La seule différence est qu'il vous faudra télécharger les fichiers .jigdo et .template correspondant aux DVD Débian au lieu de ceux correspondant aux CD. Vous pourrez trouver les fichiers .jigdo et .template permettant de télécharger des images de DVD Débian sur http://www.debian.org/CD/jigdo-cd/.

Notez que vous devrez disposer d'un noyau Linux en version 2.4 ou supérieure pour créer des fichiers images de la taille d'un DVD. Sous Windows, il est impossible pour le moment de créer des images de la taille d'un DVD du fait de la non-compatibilité avec les fichiers de grande taille de la bibliothèque C++ utilisé la version mingw de gcc.

Grâce à Gordon Huff et David Anselmi, nous savons maintenant que la réponse est « oui vous pouvez ». Mais, plus important, Gordon nous a donné une bonne raison de vouloir le faire. Paraphrasons Gordon :

Jigdo marche très bien — Le fichier .tmp.iso a dès le début sa taille finale, mais est rempli de zéros. Plus tard, des morceaux de cette image seront remplacées par les données téléchargées.

Vous pouvez vous rendre compte que Jigdo progresse en regardant les messages « Found X of the Y files required by the template^[6] » qui sont affichés de temps à autre. La seconde valeur « Y » doit décroître. Quand elle atteindra zéro, le téléchargement sera terminé.

Voyez la Section 7.1, « jigdo-easy ».

Si vous utilisez une distribution Débian version Potato ou Woody : suite à un changement dans Jigdo, les versions de jigdo-lite des distributions Potato et Woody (r0 et r1) ne peuvent pas télécharger les images des distributions Sid et Sarge. Les paquets jigdo-file des distributions Sarge (version 0.7.0-2) et Sid (version 0.7.0-2) peuvent télécharger des images Sarge et Sid. De même une version corrigée de jigdo-file (0.6.5) a été proposée afin d'être incluse dans la 2^e révision de la distribution Woody. Elle sera, espérons-le, incluse dans la Woody r2 lorsque celle-ci sortira. Cependant, du fait des corrections et des améliorations qu'elles contiennent, je vous incite à utiliser le jigdo-file de Sarge ou de Sid.

Si vous utilisez Sarge ou Sid, alors vous risquez d'avoir besoin d'aide. Parcourez les archives de la liste de discussion debian-cd, et si cela ne résout pas votre problème envoyez-leur une demande d'aide (cf. la Section 7.4, « Ressources »).

Jigdo-lite utilise wget, et les messages affichés par wget peut être très verbeux. Si cela vous dérange, vous pouvez rendre wget plus silencieux en ajoutant --non-verbose au commutateur wgetOpts dans votre fichier ~/.jigdo-lite. Si vous voulez que wget n'affiche aucun message, utilisez --quiet dans le commutateur wgetOpts.

Certainement. Si vous êtes intéressés par la distribution Woody ou Potato et que vous êtes sous Windows, le vieux SunOS, HP-UX ou IRIX, vous pouvez utiliser jigdo-easy. Reportez-vous à la Section 7.1, « jigdo-easy » et à la Section 7.4, « Ressources ».

Si vous désirez télécharger la distribution Potato, Woody, Sarge ou Sid depuis Microsoft Windows, jigdo-lite a été porté sur cette plate-forme et peut être obtenu depuis le site principal de Jigdo (cf. la Section 7.4, « Ressources »).

Sous Windows, il se peut que vous vous aperceviez que jigdo-lite télécharge quelques fichiers mais échoue lors de la lecture de leur contenu. Cela produira un message d'erreur « No such file or directory » (impossible de trouver le fichier ou le répertoire).

Il semble que cela se produise si les noms des fichiers lus par Jigdo dépassent une certaine taille. La solution est de déplacer ce qui a déjà été téléchargé dans un dossier plus proche de la racine du disque. Ceci afin de limiter la taille du nom complet du fichier.

Lorsque vous créez des images DVD sous Windows en utilisant jigdo-win, vous devez être conscient qu'il existe une limite de 2 Go pour la taille des fichiers. Ceci est causé par la bibliothèque C++ du compilateur mingw32 qui est utilisé pour compiler jigdo-win. Apparemment, cette bibliothèque n'est pas compatible avec les fichiers de grande taille du fait d'une omission de ses développeurs. Ce qui implique que cette limite de 2 Go sera présente même sous le système de fichier NTFS.

Il est probable que cette limitation sera corrigée dans une version à venir de mingw32.

Jigdo-easy, de Anne Bezemer, est un logiciel dérivé de jigdo-lite qui est portable sur un plus grand nombre de plates-formes, dont Windows, le vieux SunOS, HP-UX et IRIX. Jigdo-easy est aussi plus simple à utiliser que jigdo-lite. Cependant, du fait des changements récents apportés à Jigdo, Jigdo-easy ne marche que pour télécharger les distributions Potato et Woody. Jigdo-easy ne permet pas de télécharger une image Iso de Sarge ou de Sid. Voir la Section 7.4, « Ressources » et la Section 6.13, «  Puis-je utiliser Jigdo sur d'autres plates-formes que Linux ?  ».

Une interface graphique GTK+ pour Jigdo est en cours de développement. Elle n'est pas encore totalement fonctionnelle, mais finira par être disponible. Il y aura une interface graphique pour Linux et pour Windows.

Ce fichier de base de données contient les sommes de contrôle md5 des fichiers lus lorsque vous indiquez un répertoire en réponse à la question Files to scan:. Si vous faites parcourir à jigdo-file une seconde fois le même répertoire, son parcours sera très rapide.

Ce fichier peut se révéler très utile dans le cas suivant : la révision 0 de votre distribution est mise à jour et devient une rév. 1. Dans les images CD de la rév. 1, des paquets peuvent avoir été déplacés du CD n au CD n+1 ou vice-versa. Si vous avez une liaison particulièrement lente (un modem), vous souhaiterez sans doute éviter de télécharger à nouveau ces paquets. Pour cette raison, lorsque vous téléchargerez une nouvelle version du CD n, vous ferez parcourir à jigdo-lite les trois CD n-1, n et n+1 (voire même les 8 CD si vous voulez être sûr à 100%).

Si jidgo-lite doit parcourir le même CD encore et encore alors qu'il met à jour les 8 images, cette base de données empêchera toutes les données présentes sur le CD d'être lues plusieurs fois.

Cette base de données est bien plus importante quand on génère des fichiers .jigdo, car vous ne voudrez pas relire l'intégralité de votre miroir Débian de 50 Go chaque fois que vous générez un nouveau fichier .jigdo.

Ce guide pratique tire à sa fin, mais j'ai pensé que je ne vous laisserai partir qu'avec quelques liens et références pour en savoir plus sur les outils Jigdo et la façon dont ils fonctionnent.