619 lines
13 KiB
HTML
619 lines
13 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>Downloading Your First Image (In 5 Easy Steps)</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
|
|
REL="HOME"
|
|
TITLE="Debian Jigdo mini-HOWTO"
|
|
HREF="index.html"><LINK
|
|
REL="PREVIOUS"
|
|
TITLE="How Jigdo Works (optional)"
|
|
HREF="howjigdoworks.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="Updating Your Image"
|
|
HREF="updatingyourimage.html"></HEAD
|
|
><BODY
|
|
CLASS="SECT1"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="NAVHEADER"
|
|
><TABLE
|
|
SUMMARY="Header navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TH
|
|
COLSPAN="3"
|
|
ALIGN="center"
|
|
>Debian Jigdo mini-HOWTO</TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="left"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="howjigdoworks.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
></TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="updatingyourimage.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="SECT1"
|
|
><H1
|
|
CLASS="SECT1"
|
|
><A
|
|
NAME="DOWNLOADINGYOURFIRSTIMAGE"
|
|
></A
|
|
>4. Downloading Your First Image (In 5 Easy Steps)</H1
|
|
><P
|
|
>We'll assume that you're starting from scratch and don't have any Debian ISOs on hand. Once
|
|
you burn your set of ISOs, you can use jigdo-lite later to update them. We'll cover updating your
|
|
ISOs in the next section.</P
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN208"
|
|
></A
|
|
>4.1. Install Jigdo</H2
|
|
><P
|
|
>First install the jigdo-file package:</P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
> # apt-get install jigdo-file
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Jigdo is under aggressive development. Bug fixes and enhancements are constant, so if
|
|
you're using stable or testing, download jigdo-file from unstable at <A
|
|
HREF="http://packages.debian.org/unstable/utils/jigdo-file.html"
|
|
TARGET="_top"
|
|
>http://packages.debian.org/unstable/utils/jigdo-file.html</A
|
|
>. As of 28 Nov 2005 it's at
|
|
version 0.7.2-2.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="DOWNLOADTHE.TEMPLATEAND.JIGDOFILES"
|
|
></A
|
|
>4.2. Download The .template And .jigdo Files</H2
|
|
><P
|
|
>For each ISO image you want to download, you'll need both the .jigdo and .template file
|
|
for that image. Both files follow the same naming convention:</P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
> distro-arch-n.jigdo
|
|
distro-arch-n.template
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>where distro is the name of the distro (like "sarge"), arch is the architecture (like
|
|
"i386") and n is the disk number (like "1").</P
|
|
><P
|
|
>For example, sarge has 8 images, so you need to download 8 .jigdo files and 8 .template
|
|
files. They can be downloaded from <A
|
|
HREF="http://www.debian.org/CD/jigdo-cd/"
|
|
TARGET="_top"
|
|
>http://www.debian.org/CD/jigdo-cd/</A
|
|
>. The first .jigdo and .template file are named
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.jigdo</TT
|
|
> and <TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.template</TT
|
|
>
|
|
respectively.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="RUNJIGDO-LITE"
|
|
></A
|
|
>4.3. Run jigdo-lite</H2
|
|
><P
|
|
>Run <SPAN
|
|
CLASS="APPLICATION"
|
|
>jigdo-lite</SPAN
|
|
> and give it the <TT
|
|
CLASS="FILENAME"
|
|
>.jigdo</TT
|
|
>
|
|
file of the image you want to download. Using Sarge as an example:</P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
> 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:
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>If you suspended <SPAN
|
|
CLASS="APPLICATION"
|
|
>jigdo-lite</SPAN
|
|
> with <B
|
|
CLASS="KEYCAP"
|
|
>control</B
|
|
>+<B
|
|
CLASS="KEYCAP"
|
|
>z</B
|
|
>
|
|
(don't do this; I'll tell you what you'd see) and looked at the output of
|
|
<B
|
|
CLASS="COMMAND"
|
|
>ls</B
|
|
>, you'd find a new file in the directory named
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.jigdo.unpacked</TT
|
|
>. It turns out that .jigdo files are gzip'ed.
|
|
This file is simply a gunzip'ed version of the <TT
|
|
CLASS="FILENAME"
|
|
>.jigdo</TT
|
|
> file.</P
|
|
><P
|
|
>Right now, <SPAN
|
|
CLASS="APPLICATION"
|
|
>jigdo-lite</SPAN
|
|
> is telling us that if we have an
|
|
outdated version of first CD of sarge, we should give the pathname to the CD. This is how you
|
|
update your ISO images (or complete your incomplete downloads). Since we're assuming that
|
|
you're starting from scratch and have no Debian ISOs yet, we have nothing to scan. We'll
|
|
cover this in <A
|
|
HREF="updatingyourimage.html"
|
|
>Section 5</A
|
|
>, so just press <B
|
|
CLASS="KEYCAP"
|
|
>ENTER</B
|
|
>.</P
|
|
><P
|
|
>See also <A
|
|
HREF="errata.html#MORE-ABOUT-SCAN"
|
|
>Section 7.2</A
|
|
>, "More About Scan Sources".</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="SPECIFYAMIRROR"
|
|
></A
|
|
>4.4. Specify A Mirror</H2
|
|
><P
|
|
>You'll see:</P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
> -----------------------------------------------------------------
|
|
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/]:
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>By default, <SPAN
|
|
CLASS="APPLICATION"
|
|
>jigdo-lite</SPAN
|
|
> pulls the mirror from your
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>/etc/apt/sources.list</TT
|
|
>. If you want to use a different mirror, you would
|
|
specify a different mirror here. If this is the mirror you want to use, press
|
|
<B
|
|
CLASS="KEYCAP"
|
|
>ENTER</B
|
|
>. Jigdo-lite will then write a <TT
|
|
CLASS="FILENAME"
|
|
>.jigdo-lite</TT
|
|
> file in
|
|
your home directory.</P
|
|
><P
|
|
>Next, if the <TT
|
|
CLASS="FILENAME"
|
|
>.jigdo</TT
|
|
> file you're using references a package which
|
|
needs to be downloaded from a Non-US server, <SPAN
|
|
CLASS="APPLICATION"
|
|
>jigdo-lite</SPAN
|
|
> will prompt
|
|
you for a Debian Non-US mirror. The message displayed (and your response) will be very
|
|
similar to the mirror dialog in the previous paragraph.</P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
> -----------------------------------------------------------------
|
|
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//]:
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Jigdo-lite will write your choice to <TT
|
|
CLASS="FILENAME"
|
|
>~/.jigdo-lite</TT
|
|
>. However, if
|
|
the image you're about to download doesn't contain Non-US software you won't see this
|
|
dialog.</P
|
|
><P
|
|
>If you want to change the default mirrors you use with jigdo at any time in the future,
|
|
you can modify these two lines in <TT
|
|
CLASS="FILENAME"
|
|
>~/.jigdo-lite</TT
|
|
>:</P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
> debianMirror='http://some-mirror-to-use/debian/'
|
|
nonusMirror='http://some-other-mirror/debian-non-US/'
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="DOWNLOADINGOFTHEISO"
|
|
></A
|
|
>4.5. Downloading Of The ISO</H2
|
|
><P
|
|
>After you specify the mirror(s), <SPAN
|
|
CLASS="APPLICATION"
|
|
>jigdo-lite</SPAN
|
|
> will begin
|
|
downloading files to assemble the ISO image:</P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
> 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
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>There'll be a lot of messages flying across your screen; if this is confusing to you,
|
|
see <A
|
|
HREF="faq.html#WGETOPTIONS"
|
|
>Section 6.13</A
|
|
>. While jigdo-lite is downloading the packages, switch to
|
|
another console (or open another xterm) and do an <B
|
|
CLASS="COMMAND"
|
|
>ls</B
|
|
> in the directory
|
|
you're running jigdo-lite in. Now there should be 6 files in the directory:</P
|
|
><P
|
|
></P
|
|
><UL
|
|
><LI
|
|
><P
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.iso.list</TT
|
|
></P
|
|
></LI
|
|
><LI
|
|
><P
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.iso.tmp</TT
|
|
></P
|
|
></LI
|
|
><LI
|
|
><P
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>jigdo-file-cache.db</TT
|
|
></P
|
|
></LI
|
|
><LI
|
|
><P
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.iso.tmpdir/</TT
|
|
></P
|
|
></LI
|
|
><LI
|
|
><P
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.jigdo</TT
|
|
></P
|
|
></LI
|
|
><LI
|
|
><P
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.jigdo.unpacked</TT
|
|
></P
|
|
></LI
|
|
><LI
|
|
><P
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.template</TT
|
|
></P
|
|
></LI
|
|
></UL
|
|
><P
|
|
>The <TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.iso.tmpdir/</TT
|
|
> directory contains
|
|
all the Debian packages that <SPAN
|
|
CLASS="APPLICATION"
|
|
>jigdo-lite</SPAN
|
|
> downloads. Every so often,
|
|
the directory gets flushed and the files get written to
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.iso.tmp</TT
|
|
>, which is an temporarily incomplete version of the
|
|
ISO image you want. Note that <TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.iso.tmp</TT
|
|
> won't appear until
|
|
the first time <TT
|
|
CLASS="FILENAME"
|
|
>sarge-i386-1.iso.tmpdir/</TT
|
|
> gets
|
|
flushed.</P
|
|
><P
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>jigdo-file-cache.db</TT
|
|
> is a Berekeley DB file containing md5sums of
|
|
any files read in when you specify a directory at the <TT
|
|
CLASS="LITERAL"
|
|
>Files to scan:</TT
|
|
>
|
|
prompt. It's described in <A
|
|
HREF="errata.html#JIGDO-FILE-CACHE"
|
|
>Section 7.3</A
|
|
>.</P
|
|
><P
|
|
>At this point, go play some Quake III because this will take some time (you may want to
|
|
play on a different machine because jigdo is very disk intensive when it flushes files to the
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>.iso.tmp</TT
|
|
> file). At some point, the download will finish and you'll be
|
|
staring at:</P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
> 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!
|
|
</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
SUMMARY="Footer navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="howjigdoworks.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
ACCESSKEY="H"
|
|
>Home</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="updatingyourimage.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
>How Jigdo Works (optional)</TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Updating Your Image</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |