Supponiamo di partire da zero e non di non avere già disponibile alcuna ISO Debian. Una volta masterizzato il proprio set di immagini ISO è possibile usare jigdo-file per aggiornarlo. L'aggiornamento delle immagini ISO sarà trattato nella prossima sezione.
Prima si installa il pacchetto jigdo-file:
# apt-get install jigdo-file
Jigdo è in pieno sviluppo. Correzioni e miglioramenti sono costanti, se si sta usando la versione stabile o di prova, si può scaricare la versione instabile di jigdo-file all'indirizzo http://packages.debian.org/unstable/utils/jigdo-file.html. Al 28 Novembre 2005 essa è alla versione 0.7.2-2.
Per ogni immagine ISO che si vuol scaricare, c'è bisogno dei relativi file .template e .jigdo. Il nome di entrambi i file è dato con la stessa convenzione:
distro-arch-n.jigdo
distro-arch-n.template
dove distro è il mome della distribuzione (come “sarge”), arch è l'architettura (come”i386) e n è il numero del disco (come”1”).
Per esempio, sarge ha otto immagini, quindi è necessario scaricare 8 file .jigdo e 8 file .template. Questi possono essere scaricati da http://www.debian.org/CD/jigdo-cd/. Il primo file .jigdo e .template hanno nome rispettivamente sarge-i386-1.jigdo e sarge-i386-1.template
Lanciare jigdo-lite e fornire il file .jigdo dell'immagine che si vuol scaricare. Usando Sarge come nell'esempio:
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:
Se si interrompe jigdo-lite con control+z (non si deve fare; è per mostrare cosa succede) e si osserva l'output del comando ls, si trova un nuovo file nella directory chiamato sarge-i386-1.jigdo.unpacked. Ciò svela che il file .jigdo è compresso con gzip. Questo file è semplicemente una versione decompressa del file .jigdo .
Quando jigdo-lite chiede se si ha una versione precedente del primo CD di sarge, si dovrà dare il percorso al CD. Questo è il modo per aggiornare le proprie immagini ISO (o completare i download incompleti). Poiché stiamo supponendo di partire da zero e di non avere ancora ISO Debian ISO, non abbiamo nulla da indagare. Questo è trattato nella la Sezione 5, quindi basta premere ENTER.
Si veda anche la Sezione 7.2.
Si vedrà:
-----------------------------------------------------------------
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/]:
Normalmente, jigdo-lite estrae il server dal proprio /etc/apt/sources.list. Volendo usare un server diverso, si deve specificare qui. Se questo è il server che si vuole usare, premere ENTER. Jigdo-lite scriverà quindi un file .jigdo-lite nella cartella home dell'utente.
Dopo, se il file .jigdo che si sta usando si riferisce a un pacchetto che bisogna scaricare da un server mirror Non-US, jigdo-lite vi chiederà un server mirror Debian Non-US. Il messaggio che appare (e la propria risposta) sarà molto simile alla finestra di dialogo del server mirror del paragrafo precedente.
-----------------------------------------------------------------
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 scriverà la vostra scelta in ~/.jigdo-lite. Comunque, se l'immagine che si sta per scaricare non contiene software Non-US non si vedrà questo messaggio.
Se in futuro e in qualunque momento si vuole cambiare il server predefinito usato con jigdo, si dovranno modificare queste due righe in ~/.jigdo-lite:
debianMirror='http://some-mirror-to-use/debian/'
nonusMirror='http://some-other-mirror/debian-non-US/'
Dopo aver specificato i server mirror, jigdo-lite inizierà il download dei file per assemblare l'immagine 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://mirror/debian/pool/main/p/pack/pack_3.10-1_i386.deb
=> `sarge-i386-1.iso.tmpdir/mirror/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
Ci saranno molti messaggi che scorrono sullo schermo; se confondono, consultare la la Sezione 6.13. Mentre jigdo-lite sta scaricando i pacchetti, aprire un'altra console (oppure aprite un altro xterm) ed eseguire ls nella cartella in cui è eseguito jigdo-lite. Ora ci dovrebbero essere sei file in questa cartella:
sarge-i386-1.iso.list
sarge-i386-1.iso.tmp
jigdo-file-cache.db
sarge-i386-1.iso.tmpdir/
sarge-i386-1.jigdo
sarge-i386-1.jigdo.unpacked
sarge-i386-1.template
La cartella sarge-i386-1.iso.tmpdir/ contiene tutti i pacchetti Debian che jigdo-lite scarica. Spesso la cartella si svuota e i file vengono scritti in sarge-i386-1.iso.tmp, che è una versione temporaneamente incompleta dell'immagine ISO che si vuole ottenere. Notare che sarge-i386-1.iso.tmp non apparirà fino a quando sarge-i386-1.iso.tmpdir/ non si svuota la prima volta.
jigdo-file-cache.db è un file Berkeley DB che contiene gli md5sum di ogni file letto in ingresso quando si specifica una cartella alla richiesta Files to scan:. Ciò è descritto in la Sezione 7.3.
A questo punto, si può giocare a Quake III perché questo porterà via un po' di tempo (si potrebbe giocare su un'altra macchina perché jigdo consuma molte risorse del disco quando riversa i file nel file .iso.tmp). A un certo punto il download terminerà e si vedrà:
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!