From Fedora Project Wiki

(CentOS 6)
(must stop using rawread script since Fedora "ISO" files are in general no longer true ISOs (see bug 585006 and bug 727387))
Line 28: Line 28:


<pre>applydeltaiso /dev/dvd deltaiso newiso</pre>
<pre>applydeltaiso /dev/dvd deltaiso newiso</pre>
Alternatively, the [http://www.troubleshooters.com/linux/coasterless.htm#rawread rawread script] ([https://fedoraproject.org/wiki/File:Rawread.sh download]) can be used to read the disc image into a file, as follows:
<pre>rawread /dev/dvd > oldiso</pre>
This can be done while the delta ISO is downloading, and the resulting ISO file can be verified (both in terms of integrity, and to make sure the correct image is being used for <code>oldiso</code>).  When the download is finished, using <code>applydeltaiso</code> on the ISO file will save time compared to using the optical disc.


== Creating Delta ISOs ==
== Creating Delta ISOs ==
Line 41: Line 35:
<pre>makedeltaiso oldiso newiso deltaiso</pre>
<pre>makedeltaiso oldiso newiso deltaiso</pre>


Here, unlike the <code>applydeltaiso</code> command, <code>oldiso</code> should always refer to an ISO file, never a CD/DVD disc ({{bz|569499}}).  If necessary, the [http://www.troubleshooters.com/linux/coasterless.htm#rawread rawread script] ([https://fedoraproject.org/wiki/File:Rawread.sh download]) can be used to read a CD/DVD disc image into an ISO file.
Here, unlike the <code>applydeltaiso</code> command, <code>oldiso</code> should always refer to an ISO file, never a CD/DVD disc ({{bz|569499}}).


If the delta ISO is intended for a large audience, then run and time the <code>applydeltaiso</code> command and verify that <code>newiso</code> is correctly generated.  There are two reasons for this.
If the delta ISO is intended for a large audience, then run and time the <code>applydeltaiso</code> command and verify that <code>newiso</code> is correctly generated.  There are two reasons for this.

Revision as of 20:30, 2 August 2011

A delta ISO is a file that contains the differences between two ISO files, and can be used to convert one into the other. It makes use of delta RPMs between RPM files in the old and new ISOs, and so is only useful if these ISOs mainly consist of RPM files (as is the case for Fedora install images, but not live images).

Idea.png
If you like delta RPMs, you will like delta ISOs
Using delta ISOs saves bandwidth and time.

System Requirements

Fedora

Important.png
xz compression change in Fedora 15
If you want to use delta ISOs for F15 or above on a system running F14 or below, see this on how to either build executables, or download prebuilt executables, to use in place of those in the native deltaiso package (which will not work on F14 or below).
  • Fedora 11 or later: RPM packages in Fedora 12 and later use xz compression (RPMs in older versions use gzip compression). In order to either create or use delta ISOs between ISOs containing xz-compressed RPMs, Fedora 11 or later is required. (Fedora 10 or below does not work because there is not a deltarpm package with xz support.)
  • In Fedora 11, the deltarpm package must be installed, and it should be the updated version (deltarpm-3.5-0.4.20090913git.fc11.1), not the deltarpm-3.4-16.fc11 release version that does not contain xz support.
  • In Fedora 12 or later, the deltaiso package must be installed. (In Fedora 11, delta ISO support is contained in the deltarpm package, and there is no separate deltaiso package.)

RHEL/CentOS

  • RHEL/CentOS 4 or later. In RHEL/CentOS 4 and 5, the EPEL repository must be enabled.
  • In RHEL/CentOS 4, the deltarpm package must be installed. Note that the available version (deltarpm-3.4) does not include xz support which is required for working with delta ISOs between recent versions of Fedora (12 or later).
  • In RHEL/CentOS 5 or later, the deltaiso package must be installed. (In RHEL/CentOS 4, deltaiso support is contained in the deltarpm package, and there is no separate deltaiso package.)

Using Delta ISOs

The applydeltaiso command is used. The syntax is:

applydeltaiso oldiso deltaiso newiso

If oldiso is on a mounted CD/DVD disc, the following also works, but runs more slowly due to the optical drive's greater access time:

applydeltaiso /dev/dvd deltaiso newiso

Creating Delta ISOs

The makedeltaiso command is used. The syntax is

makedeltaiso oldiso newiso deltaiso

Here, unlike the applydeltaiso command, oldiso should always refer to an ISO file, never a CD/DVD disc (RHBZ #569499).

If the delta ISO is intended for a large audience, then run and time the applydeltaiso command and verify that newiso is correctly generated. There are two reasons for this.

  1. Telling users the estimated run time for applydeltaiso lets them determine whether the download time saved by using a delta ISO is likely to be greater than the time required to run applydeltaiso.
  2. Around the time of xz compression changes, certain delta ISOs may be nonfunctional as a result of not all RPMs in newiso using the same compression. Hence the delta ISO should be checked. When applydeltaiso finishes running, there should be a message similar to this:
iso successfully re-created, md5sum: f90d7a6d19a2cc5428a95892d5e2ca84

The md5sum is that of newiso, which is stored in the delta ISO for later verification. On the other hand, a failed reconstruction shows this message:

md5sum mismatch, iso is corrupt

and in this case the delta ISO should not be used.

External Links