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
|
|||
|
>
|