437 lines
11 KiB
HTML
437 lines
11 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||
<HTML
|
||
><HEAD
|
||
><TITLE
|
||
>Updating Your Image</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="Downloading Your First Image (In 5 Easy Steps)"
|
||
HREF="downloadingyourfirstimage.html"><LINK
|
||
REL="NEXT"
|
||
TITLE="Frequently Asked Questions"
|
||
HREF="faq.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="downloadingyourfirstimage.html"
|
||
ACCESSKEY="P"
|
||
>Prev</A
|
||
></TD
|
||
><TD
|
||
WIDTH="80%"
|
||
ALIGN="center"
|
||
VALIGN="bottom"
|
||
></TD
|
||
><TD
|
||
WIDTH="10%"
|
||
ALIGN="right"
|
||
VALIGN="bottom"
|
||
><A
|
||
HREF="faq.html"
|
||
ACCESSKEY="N"
|
||
>Next</A
|
||
></TD
|
||
></TR
|
||
></TABLE
|
||
><HR
|
||
ALIGN="LEFT"
|
||
WIDTH="100%"></DIV
|
||
><DIV
|
||
CLASS="SECT1"
|
||
><H1
|
||
CLASS="SECT1"
|
||
><A
|
||
NAME="UPDATINGYOURIMAGE"
|
||
></A
|
||
>5. Updating Your Image</H1
|
||
><P
|
||
>Presumably, you've read the last section, followed the instructions, burned your newly
|
||
created ISO files onto CD and are feeling warm and fuzzy. Sooner or later, some packages will get
|
||
updated and now you want to donate your old CDs to some newbie at your local LUG's installfest and
|
||
burn yourself a set of updated CDs. Since you're well on the way to becoming a jigdo-guru, we
|
||
won't go into as much painful detail as we did in the last section.</P
|
||
><P
|
||
>The first step is to download the .jigdo and .template files, again, for the images you want
|
||
to update. You may wonder why you need to download them a second time. The reason is because the
|
||
updated image you want to download has changed. Files may have been added or deleted, but even if
|
||
not, any updated packages or files will have a different checksum from the checksum listed in the
|
||
.jigdo and .template files you used when you first downloaded the images.</P
|
||
><P
|
||
>At this point, you're either holding an outdated Debian CD in your hand or you have the CD's
|
||
outdated ISO image on your hard drive. Let's go through the steps of getting an updated ISO file.
|
||
If you have a CD, put it in your CD drive and mount it:</P
|
||
><TABLE
|
||
BORDER="1"
|
||
BGCOLOR="#E0E0E0"
|
||
WIDTH="100%"
|
||
><TR
|
||
><TD
|
||
><FONT
|
||
COLOR="#000000"
|
||
><PRE
|
||
CLASS="SCREEN"
|
||
> $ mount /cdrom
|
||
</PRE
|
||
></FONT
|
||
></TD
|
||
></TR
|
||
></TABLE
|
||
><P
|
||
>On the other hand, if you have an ISO file you'd like to update, mount it as a loop device
|
||
(you may need to be root to do this). Using Woody as an example:</P
|
||
><TABLE
|
||
BORDER="1"
|
||
BGCOLOR="#E0E0E0"
|
||
WIDTH="100%"
|
||
><TR
|
||
><TD
|
||
><FONT
|
||
COLOR="#000000"
|
||
><PRE
|
||
CLASS="SCREEN"
|
||
> # mount -o loop woody-i386-1.iso /mnt
|
||
</PRE
|
||
></FONT
|
||
></TD
|
||
></TR
|
||
></TABLE
|
||
><P
|
||
>Now run <SPAN
|
||
CLASS="APPLICATION"
|
||
>jigdo-lite</SPAN
|
||
> with the <TT
|
||
CLASS="FILENAME"
|
||
>.jigdo</TT
|
||
> file as
|
||
an argument.</P
|
||
><TABLE
|
||
BORDER="1"
|
||
BGCOLOR="#E0E0E0"
|
||
WIDTH="100%"
|
||
><TR
|
||
><TD
|
||
><FONT
|
||
COLOR="#000000"
|
||
><PRE
|
||
CLASS="SCREEN"
|
||
> $ jigdo-lite woody-i386-1.jigdo
|
||
|
||
-----------------------------------------------------------------
|
||
Jigsaw Download "lite"
|
||
Copyright 2001-2002 by Richard Atterer <jigdo@atterer.net>
|
||
Loading settings from `/home/p/.jigdo-lite'
|
||
|
||
-----------------------------------------------------------------
|
||
Images offered by `woody-i386-1.jigdo':
|
||
1: Debian GNU/Linux 3.0 r0 Woody
|
||
- Official i386 Binary-1 CD (debian-30r0-i386-binary-1.iso)
|
||
|
||
Further information about `debian-30r0-i386-binary-1.iso':
|
||
Generated on Thu, 18 Jul 2002 14:34:12 +0100
|
||
|
||
-----------------------------------------------------------------
|
||
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 on the new image, and you do not need to download them
|
||
again. You found the secret message; you're a very careful
|
||
reader. 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 the download of any remaining files.
|
||
|
||
You can also enter a single digit from the list below to
|
||
select the respective entry for scanning:
|
||
1: /mnt
|
||
Files to scan:
|
||
</PRE
|
||
></FONT
|
||
></TD
|
||
></TR
|
||
></TABLE
|
||
><P
|
||
>jigdo-lite is asking us to give it the location of your mounted CD (if you're updating a CD)
|
||
or your loop mounted ISO file (if you're using the ISO file). I'm using an ISO file loop mounted
|
||
on <TT
|
||
CLASS="FILENAME"
|
||
>/mnt</TT
|
||
>, so I'll enter <TT
|
||
CLASS="FILENAME"
|
||
>/mnt</TT
|
||
>. If you're updating a CD, enter the mount directory of your CD,
|
||
which is most likely <TT
|
||
CLASS="LITERAL"
|
||
>/cdrom</TT
|
||
>. In either case,
|
||
<SPAN
|
||
CLASS="APPLICATION"
|
||
>jigdo-lite</SPAN
|
||
> will scan the directory of your mounted media, determine
|
||
which files need updating and re-use the files which don't need updating. See also <A
|
||
HREF="errata.html#MORE-ABOUT-SCAN"
|
||
>Section 7.2</A
|
||
>, "More About Scan Sources".</P
|
||
><P
|
||
>You may see something like:</P
|
||
><TABLE
|
||
BORDER="1"
|
||
BGCOLOR="#E0E0E0"
|
||
WIDTH="100%"
|
||
><TR
|
||
><TD
|
||
><FONT
|
||
COLOR="#000000"
|
||
><PRE
|
||
CLASS="SCREEN"
|
||
> Files to scan: /mnt/other
|
||
|
||
Not downloading .template file - `woody-i386-1.template' already present
|
||
jigdo-file: Output file `debian-30r0-i386-binary-1.iso' already exists - delete
|
||
it or use --force
|
||
jigdo-file failed with code 3 - aborting.
|
||
</PRE
|
||
></FONT
|
||
></TD
|
||
></TR
|
||
></TABLE
|
||
><P
|
||
>What happened? Actually, I wanted to show you this because you'll bump into it sooner or
|
||
later. I'm updating an ISO file, but the outdated image file is in the same directory I'm working
|
||
in. Jigdo-lite wants to generate a file called <TT
|
||
CLASS="FILENAME"
|
||
>woody-i386-1.iso</TT
|
||
> but there's
|
||
already a file by that name in the current directory (the outdated image). Jigdo-lite doesn't
|
||
want to destroy that file, so it bails and lets me know that I can either delete that file or use
|
||
<TT
|
||
CLASS="LITERAL"
|
||
>--force</TT
|
||
> to overwrite the file. You could also rename or move the file too,
|
||
but I guess <SPAN
|
||
CLASS="APPLICATION"
|
||
>jigdo-lite</SPAN
|
||
> assumes we already know this. <20> :-)</P
|
||
><P
|
||
>Don't be timid about moving or renaming the image file just because it's loop mounted. The
|
||
filesystem uses inodes under the hood, and even if you move or rename the file, the inode stays
|
||
the same. You won't hurt the filesystem mounted under <TT
|
||
CLASS="FILENAME"
|
||
>/mnt</TT
|
||
>.
|
||
As for deleting the ISO file, that won't hurt the mounted filesystem either. A file's inode gets
|
||
deallocated only when the inode's reference count drops to zero. Mounting the ISO image bumps the
|
||
reference count up, so the file really gets deleted only after you <B
|
||
CLASS="COMMAND"
|
||
>rm</B
|
||
> the file
|
||
<EM
|
||
>and</EM
|
||
> umount the loop device. All you people who are updating the CD don't
|
||
have to worry about any of this. :-)</P
|
||
><P
|
||
>I'll rename the ISO file to <TT
|
||
CLASS="FILENAME"
|
||
>woody-i386-1.iso.old</TT
|
||
> and run
|
||
<SPAN
|
||
CLASS="APPLICATION"
|
||
>jigdo-lite</SPAN
|
||
> again. Let's try again:</P
|
||
><TABLE
|
||
BORDER="1"
|
||
BGCOLOR="#E0E0E0"
|
||
WIDTH="100%"
|
||
><TR
|
||
><TD
|
||
><FONT
|
||
COLOR="#000000"
|
||
><PRE
|
||
CLASS="SCREEN"
|
||
> $ jigdo-lite woody-i386-1.jigdo
|
||
|
||
-----------------------------------------------------------------
|
||
Jigsaw Download "lite"
|
||
Copyright 2001-2002 by Richard Atterer <jigdo@atterer.net>
|
||
Loading settings from `/home/p/.jigdo-lite'
|
||
|
||
-----------------------------------------------------------------
|
||
Images offered by `woody-i386-1.jigdo':
|
||
1: Debian GNU/Linux 3.0 r0 Woody - Official i386 Binary-1 CD
|
||
(debian-30r0-i386-binary-1.iso)
|
||
|
||
Further information about `debian-30r0-i386-binary-1.iso':
|
||
Generated on Thu, 18 Jul 2002 14:34:12 +0100
|
||
|
||
-----------------------------------------------------------------
|
||
If you already have a previous version of the image you are
|
||
downloading, jigdo can re-use files on the old image that are also
|
||
present on 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 the download of any remaining files.
|
||
You can also enter a single digit from the list below to
|
||
select the respective entry for scanning:
|
||
1: /mnt
|
||
Files to scan: /mnt
|
||
Not downloading .template file - `woody-i386-1.template' already present
|
||
...
|
||
Found 1200 of the 1224 files required by the template
|
||
...</PRE
|
||
></FONT
|
||
></TD
|
||
></TR
|
||
></TABLE
|
||
><P
|
||
>jigdo-lite remembers that I wanted to scan <TT
|
||
CLASS="FILENAME"
|
||
>/mnt</TT
|
||
> and
|
||
tells me I can either type <TT
|
||
CLASS="LITERAL"
|
||
>1</TT
|
||
> to scan that directory or type the directory in
|
||
again. Since I'm a perverse person, I type the name of the directory again.</P
|
||
><P
|
||
>The ellipsis represent some text that changes rapidly. The first ellipsis is a dynamic list
|
||
of what files jigdo-lite is scanning. The second ellipses denotes progress in writing
|
||
<TT
|
||
CLASS="FILENAME"
|
||
>woody-i386-1.iso.tmp</TT
|
||
>. Once jigdo-lite finishes scanning the files and
|
||
writing the temporary ISO file, it prints:</P
|
||
><TABLE
|
||
BORDER="1"
|
||
BGCOLOR="#E0E0E0"
|
||
WIDTH="100%"
|
||
><TR
|
||
><TD
|
||
><FONT
|
||
COLOR="#000000"
|
||
><PRE
|
||
CLASS="SCREEN"
|
||
> Copied input files to temporary file `woody-i386-1.iso.tmp'
|
||
- repeat command and supply more files to continue
|
||
|
||
-----------------------------------------------------------------
|
||
If you already have a previous version of the image you are
|
||
downloading, jigdo can re-use files on the old image that are also
|
||
present on 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 the download of any remaining files.
|
||
You can also enter a single digit from the list below to
|
||
select the respective entry for scanning:
|
||
1: /mnt
|
||
Files to scan:
|
||
</PRE
|
||
></FONT
|
||
></TD
|
||
></TR
|
||
></TABLE
|
||
><P
|
||
>Since you normally don't have another source of files to scan other than your loop mounted
|
||
ISO file (or your CD), press <B
|
||
CLASS="KEYCAP"
|
||
>ENTER</B
|
||
>. Jigdo-lite will then ask you about which
|
||
mirrors you want to use, just like it did when you downloaded your ISO for the first time. You've
|
||
already answered these questions before, but if you truly don't remember, you might want to
|
||
re-read <A
|
||
HREF="downloadingyourfirstimage.html#SPECIFYAMIRROR"
|
||
>Section 4.4</A
|
||
>.</P
|
||
><P
|
||
>At this point, you'll see <SPAN
|
||
CLASS="APPLICATION"
|
||
>jigdo-lite</SPAN
|
||
> working its magic. Now
|
||
wasn't that easy?</P
|
||
></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="downloadingyourfirstimage.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="faq.html"
|
||
ACCESSKEY="N"
|
||
>Next</A
|
||
></TD
|
||
></TR
|
||
><TR
|
||
><TD
|
||
WIDTH="33%"
|
||
ALIGN="left"
|
||
VALIGN="top"
|
||
>Downloading Your First Image (In 5 Easy Steps)</TD
|
||
><TD
|
||
WIDTH="34%"
|
||
ALIGN="center"
|
||
VALIGN="top"
|
||
> </TD
|
||
><TD
|
||
WIDTH="33%"
|
||
ALIGN="right"
|
||
VALIGN="top"
|
||
>Frequently Asked Questions</TD
|
||
></TR
|
||
></TABLE
|
||
></DIV
|
||
></BODY
|
||
></HTML
|
||
> |