No edit summary |
(grammatical and clarity edits; some technical markup fixed/adjusted; some trimming; some consistency; some categories; more explanation in the Talk:Delta ISOs page.) |
||
Line 1: | Line 1: | ||
A Delta ISO is a file | A Delta ISO (deltaiso) 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 DeltaRPMs (deltarpm) 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). | ||
{{admon/tip|If you like DeltaRPMs, you will like Delta ISOs|Using deltaisos saves bandwidth and time.}} | |||
== System Requirements in Fedora == | == System Requirements in Fedora == | ||
RPM packages in Fedora 12 and later use xz compression (RPMs in older versions use gzip compression). In order to either create or use deltaisos between ISOs containing xz-compressed RPMs, Fedora 11 or later is required. (Fedora 10 or below | |||
* In Fedora 11, the deltarpm package must be the updated version, 3.5 or later (not the deltarpm-3.4-16.fc11 release version | * '''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 deltaisos 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 12 or later, the deltaiso package must be installed as well. (In Fedora 11, deltaiso support is contained in the deltarpm package, and there is no separate deltaiso package.) | * In Fedora 11, the <code>deltarpm</code> package must be the updated version, 3.5 or later (not the <code>deltarpm-3.4-16.fc11</code> release version that does not contain xz support). | ||
* In Fedora 12 or later, the <code>deltaiso</code> package must be installed as well. (In Fedora 11, deltaiso support is contained in the <code>deltarpm</code> package, and there is no separate <code>deltaiso</code> package.) | |||
== Using Delta ISOs == | == Using Delta ISOs == | ||
The <code>applydeltaiso</code> command is used. The syntax is | |||
The <code>applydeltaiso</code> command is used. The syntax is: | |||
<pre>applydeltaiso oldiso deltaiso newiso</pre> | <pre>applydeltaiso oldiso deltaiso newiso</pre> | ||
If <code>oldiso</code> is on a mounted CD/DVD disc, the following | |||
If <code>oldiso</code> is on a mounted CD/DVD disc, the following also works, but runs more slowly due to the optical drive's greater access time: | |||
<pre>applydeltaiso /dev/dvd deltaiso newiso</pre> | <pre>applydeltaiso /dev/dvd deltaiso newiso</pre> | ||
== Creating Delta ISOs == | == Creating Delta ISOs == | ||
The <code>makedeltaiso</code> command is used. The syntax is | The <code>makedeltaiso</code> command is used. The syntax is | ||
<pre>makedeltaiso oldiso newiso deltaiso</pre> | <pre>makedeltaiso oldiso newiso deltaiso</pre> | ||
If the deltaiso 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. | Here, unlike the <code>applydeltaiso</code> command, <code>oldiso</code> should always refer to an ISO file, never a CD/DVD disc. (https://bugzilla.redhat.com/show_bug.cgi?id=569499) | ||
If the deltaiso 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. | |||
# Telling users the estimated run time for <code>applydeltaiso</code> lets them determine whether the download time saved by using a deltaiso is likely to be greater than the time required to run <code>applydeltaiso</code>. | |||
# Due to the presence of some packages that were built improperly during Fedora 12 development, certain deltaisos may be nonfunctional. This should never happen when <code>oldiso</code> is Fedora 12 Final or later, and <code>newiso</code> is more recent than <code>oldiso</code>. Nevertheless, to be sure the deltaiso should be checked. When <code>applydeltaiso</code> finishes running, there should be a message similar to this: | |||
<pre>iso successfully re-created, md5sum: f90d7a6d19a2cc5428a95892d5e2ca84</pre> | <pre>iso successfully re-created, md5sum: f90d7a6d19a2cc5428a95892d5e2ca84</pre> | ||
The md5sum is that of <code>newiso</code>, which is stored in the deltaiso for later verification. On the other hand, a failed reconstruction shows this message: | |||
<pre>md5sum mismatch, iso is corrupt</pre> | <pre>md5sum mismatch, iso is corrupt</pre> | ||
For more details, | |||
For more details, refer to https://bugzilla.redhat.com/show_bug.cgi?id=548523. | |||
== External Links == | == External Links == | ||
*[http://en.wikipedia.org/wiki/Delta_ISO Wikipedia's Delta ISO page] | *[http://en.wikipedia.org/wiki/Delta_ISO Wikipedia's Delta ISO page] | ||
Line 25: | Line 45: | ||
*[http://man-wiki.net/index.php/8:applydeltaiso applydeltaiso man page] | *[http://man-wiki.net/index.php/8:applydeltaiso applydeltaiso man page] | ||
*[http://man-wiki.net/index.php/8:makedeltaiso makedeltaiso man page] | *[http://man-wiki.net/index.php/8:makedeltaiso makedeltaiso man page] | ||
[[Category:Draft documentation]] | |||
[[Category:How to]] | |||
[[Category:Delta ISOs]] |
Revision as of 02:16, 7 March 2010
A Delta ISO (deltaiso) 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 DeltaRPMs (deltarpm) 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).
System Requirements in Fedora
- 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 deltaisos 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 the updated version, 3.5 or later (not thedeltarpm-3.4-16.fc11
release version that does not contain xz support). - In Fedora 12 or later, the
deltaiso
package must be installed as well. (In Fedora 11, deltaiso support is contained in thedeltarpm
package, and there is no separatedeltaiso
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. (https://bugzilla.redhat.com/show_bug.cgi?id=569499)
If the deltaiso 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.
- Telling users the estimated run time for
applydeltaiso
lets them determine whether the download time saved by using a deltaiso is likely to be greater than the time required to runapplydeltaiso
. - Due to the presence of some packages that were built improperly during Fedora 12 development, certain deltaisos may be nonfunctional. This should never happen when
oldiso
is Fedora 12 Final or later, andnewiso
is more recent thanoldiso
. Nevertheless, to be sure the deltaiso should be checked. Whenapplydeltaiso
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 deltaiso for later verification. On the other hand, a failed reconstruction shows this message:
md5sum mismatch, iso is corrupt
For more details, refer to https://bugzilla.redhat.com/show_bug.cgi?id=548523.