Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
download [2008/09/27 09:31] mdc |
download [2011/09/12 18:58] (current) mdc [Source code (tarballs)] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Download ====== | ====== Download ====== | ||
| - | ==== Web-based image generator (http://rom-o-matic.net/)==== | + | ==== Prebuilt binaries ==== |
| - | Dynamically compiled gPXE or Etherboot images are available from: | + | Prebuilt gPXE images are available from [[http://rom-o-matic.net/]]. Images can be generated from official gPXE releases or from the current development tree. This is probably the easiest way to get started with gPXE. |
| - | * http://rom-o-matic.net/ | + | ==== Source code (git) ==== |
| - | Images can be generated from gPXE or Etherboot releases or from top-of-tree source code. | + | You can browse the current development tree at [[http://git.etherboot.org/?p=gpxe.git]], or check out a copy using: |
| - | + | ||
| - | The is often a convenient way to download an image for testing or production use. | + | |
| - | + | ||
| - | === gPXE Source Code === | + | |
| - | + | ||
| - | Source code for gPXE (our current and supported network bootloader) is available at: | + | |
| - | + | ||
| - | * [[http://git.etherboot.org/?p=gpxe.git]]. | + | |
| - | + | ||
| - | You can check out a copy of the source tree using the following command: | + | |
| git clone git://git.etherboot.org/scm/gpxe.git | git clone git://git.etherboot.org/scm/gpxe.git | ||
| - | === Etherboot (legacy) source code === | + | To update your checked out copy at any time, use: |
| - | Source code for Etherboot (our legacy bootloader, in maintenance-only mode) is available at: | + | git pull |
| - | * [[http://git.etherboot.org/?p=etherboot.git]]. | + | ==== Source code (tarballs) ==== |
| - | You can check out a copy of the source tree using the following command: | + | If you do not have ''git'' installed, you can download a tarball of the current development snapshot of gPXE from [[http://git.etherboot.org/?p=gpxe.git;a=snapshot]] or, a tarball of the most recent official release from [[http://etherboot.org/rel/gpxe/]] or [[http://kernel.org/pub/software/utils/boot/gpxe/]]. |
| - | git clone git://git.etherboot.org/scm/etherboot.git | + | ==== Extensions in development (gpxe-staging) ==== |
| - | === Tarballs === | + | A separate repository is kept for useful gPXE extensions and patches that have not been sufficiently tested and reviewed to be merged into gPXE mainline. See the [[staging|staging page]] if you'd like to help us test them. |
| - | + | ||
| - | == Git snapshots == | + | |
| - | + | ||
| - | If you don't have git installed, you can download a tarball of the current development snapshot of gPXE from: | + | |
| - | + | ||
| - | * [[http://git.etherboot.org/?p=gpxe.git;a=snapshot]] | + | |
| - | + | ||
| - | or the current top-of-tree for Etherboot from: | + | |
| - | + | ||
| - | * [[http://git.etherboot.org/?p=etherboot.git;a=snapshot]] | + | |
| - | + | ||
| - | == Release tarballs == | + | |
| - | + | ||
| - | * gPXE: [[http://kernel.org/pub/software/utils/boot/gpxe/]] (preferred, supported, PXE compatible) | + | |
| - | + | ||
| - | * Etherboot: [[http://kernel.org/pub/software/utils/boot/etherboot/]] (legacy, maintenance-mode support) | + | |
| ==== Building from Source ==== | ==== Building from Source ==== | ||
| - | A complete build of gPXE or Etherboot requires the ''syslinux'' and ''mtools'' packages in your development environment. ''syslinux'' is required in order to create ISO images. On RedHat/Fedora systems you can install the packages by saying: | + | A complete build of gPXE or Etherboot requires the ''syslinux'' and ''mtools'' packages in your development environment. ''syslinux'' is required in order to create ISO images. On RedHat/Fedora systems you can install these packages using: |
| - | + | ||
| - | $ sudo yum install syslinux mtools | + | |
| - | + | ||
| - | Once you have the code, you can do a complete build of gPXE using using: | + | |
| - | + | ||
| - | $ cd gpxe/src | + | |
| - | $ make | + | |
| - | + | ||
| - | or for Etherboot: | + | |
| - | + | ||
| - | $ cd etherboot/src | + | |
| - | $ make | + | |
| - | + | ||
| - | === Updating source code === | + | |
| - | + | ||
| - | To update your downloaded source tree at any time, use | + | |
| - | + | ||
| - | $ git pull | + | |
| - | This will fetch the latest changes and apply them to your tree. This command will work only if you obtained your source tree using ''git clone''; if you downloaded a tarball then the only way to update your tree is to download a new tarball. | + | sudo yum install syslinux mtools |
| - | === Source code for old versions of Etherboot === | + | You can then do a complete build of gPXE using: |
| - | Should you want it, the source code for older Etherboot releases is available from: | + | cd gpxe/src |
| + | make | ||
| - | * [[http://sourceforge.net/project/showfiles.php?group_id=4233&package_id=4250]] | + | **Centos 5 / Fedora 11 Notes** |
| + | You may need to set the value in the line 59 of src/arch/i386/Makefile correctly (/usr/share/syslinux/isolinux.bin), apparently the reference to /usr/lib/syslinux/isolinux.bin is incorrect, this has not been tested in other distros. ISOLINUX_BIN config has been missing for a while. | ||
| + | ---- | ||
| + | === Etherboot 5.4 and older releases === | ||
| + | Source code for Etherboot 5.4 (our legacy bootloader, in maintenance-only mode) is available at [[http://git.etherboot.org/?p=etherboot.git]]. | ||
| + | The source code for older Etherboot releases is available from [[http://sourceforge.net/project/showfiles.php?group_id=4233&package_id=4250]] | ||