Personal tools
You are here: Home Fedora Solved Post Install Solutions Using Jigdo to Download ISO Images

Using Jigdo to Download ISO Images

by Corwyn last modified Apr 28, 2008 04:45 AM
Contributors: daMaestro

Jigdo Download Manager allows users the ability to download the Fedora Unity (and other) ISO's and large files. Jigdo Download Manager downloads the component files then uses them to build the ISO based on a pre-created template. This how-to describes how a user can download and build the Unity Re-Spin ISO images or Fedora release ISO images using the Jigdo Download Manager. This provides for using public mirrors or a local data source.

Applicable to Fedora Versions

  • Fedora Core 6+

Download Method

Requirements

  1. Jigdo Download Manager - http://atterer.org/jigdo/
  2. A jigdo file to download.
  3. For local repository:
    Make sure you point jigdo at the right location. Check file URIs in the [Parts] section to make sure you have given the correct path to the expected data.
  4. http:// ftp:// and file:// data sources may be used.

Doing the work

First, you'll need the Jigdo Download Manager installed. These instructions are for using yum to fetch and install jigdo on Fedora. Please follow the instructions for your platform if you are not using Fedora.

Get Jigdo Installed

  1. Open a terminal window
  2. Install Jigdo Download Manager:
  3. su -c 'yum install jigdo'
  4. Create a working directory for Jigdo:

    Please Note: This is just an example. You may use whatever directory you would like.

  5. mkdir ~/jigdo

Using Public Mirrors

If downloading a Fedora Unity jigdo image, the default jigdo image is set to download from Fedora public mirrors. The default download location will randomly send you to a different mirror close to you that has the file(s) you are needing to download. You may also specify which download mirror you would like to get files from.

Jigdo Defined Mirror Selection:

  1. Change to your jigdo working directory:
  2. cd ~/jigdo
  3. Run jigdo-lite:

    Please Note: Point jigdo-lite at a real jigdo file, this is just an example.

  4. jigdo-lite http://example.org/example-fedora-iso.jigdo
  5. Repeat these steps for each jigdo image you would like to download image from.

Using a Local or Specific Repository

If downloading a Fedora Unity jigdo image and you would like to use a local data source to assemble the image, you must change the jigdo file to point at your preferred data source. File, HTTP and FTP data sources are acceptable.

Manual Mirror Selection:
  1. Change to your jigdo working directory:
  2. cd ~/jigdo
  3. Download the .jigdo file:

    Please Note: Download a real jigdo file, this is just an example.

  4. wget http://example.org/example-fedora-iso.jigdo
  5. Using your favorite editor, edit the .jigdo file, in the [Server] section, point Core and Updates to your local data source or a mirror from the public mirror list:

    Note: Not all mirrors will have all needed files at all times. If the mirror you select does not have a file required to assemble the image, try another mirror or use the default download location. The default download location should always find all needed files during the lifetime of the spin.

  6. Change from:

 

    [Servers]
    Core=http://example.org/fedora/releases/7/Everything/i386/
    Updates=http://example.org/fedora/updates/7/i386/
    Change to (use your own appropriate directory structure and protocol):
    [Servers]
    Core=file://mnt/repomirror/fedora/releases/7/Everything/i386/
    Updates=file://mnt/repomirror/fedora/updates/7/i386/
  1. Run jigdo-lite, feeding it your .jigdo file:

    Note: Point at a real jigdo file. In most cases the .template file will need to be in the same directory, but would also be downloaded if needed.

  2. jigdo-lite example-fedora-iso.jigdo
  3. Repeat these steps for each jigdo image you would like to download images from.

Using Already Downloaded Data

An ideal way to use jigdo is to "patch" an existing ISO that you have downloaded in the past. This will reduce the amount of data needing to be downloaded. To be able to use this existing data do the following:

For an existing ISO image:
  1. Mount the image using a loop device:
    mount -t iso9660 -o loop /path/to/oldimage.iso /path/to/mount/point/
  2. Tell jigdo-lite where the media is mounted, when it asks. You can also pass the --scan option to specify a directory to scan for files.

For an image already written to media:

  1. Insert the media, take note of where it gets mounted. In Fedora, it should be mounted in /media/something.
  2. Tell jigdo-lite where the media is mounted, when it asks. You can also pass the --scan option to specify a directory to scan for files.

Troubleshooting

Common problems and fixes

One problem that has been seen is when using a local repo, the Core and/or Updates are not correctly pointed. A close eye must be kept on the directory structure of your repo, to be sure that the correct files are located.

You'll note an issue with this when you get messages "No such file or directory"
The way to fix this is to verify your repo directory structure and edit the .jigdo file appropriately to match your layout.

More Information

Disclaimer

We test this stuff on our own machines, really we do. But you may run into problems, if you do, come to #fedora on irc.freenode.net

Added Reading

 
Document Actions
Log in


Forgot your password?
New user?