contrib/rom-o-matic/README

   1 ROM-o-matic web interface for building gPXE ROMs
   2 ------------------------------------------------
   3
   4 This web application generates gPXE images and sends them to a web
   5 browser.
   6
   7 Available as part of the gPXE source code distribution, which can be
   8 downlaoded from http://etherboot.org/
   9
  10 Author:  Marty Connor <mdc@etherboot.org>
  11 License: GPLv2
  12 Support: http://etherboot.org/mailman/listinfo/gpxe
  13          Please send support questions to the gPXE mailing list
  14
  15 System Requirements
  16 -------------------
  17 - Apache web server
  18 - PHP 4+
  19 - Tools required to build gPXE installed on the server
  20   - gcc, mtools, syslinux, perl, etc.
  21
  22 Setup
  23 -----
  24 As distributed, it is expected that the rom-o-matic source code
  25 directory is in the contrib directory of a gPXE source distribution.
  26
  27 The easiest way to do this is to simply put a gPXE source distribution
  28 in a web server accessible directory.
  29
  30 If this is not the case, you will need to either edit the file
  31
  32     "globals.php"
  33
  34 or create a file called
  35
  36     "local-config.php"
  37
  38 containing the following lines:
  39
  40 <?php
  41 $src_dir = "../../src";
  42 ?>
  43
  44 Then change the line beginning "$src_dir = " to the path of your gPXE
  45 source code tree.
  46
  47 To make build times shorter, before you run rom-o-matic for the first time
  48 you should cd to the gpxe "src" directory and enter the following
  49 commands:
  50
  51   $ make
  52   $ make bin/NIC
  53
  54 This will pro-compile most object files and will make your rom-o-matic
  55 builds much faster.
  56
  57 Running rom-o-matic from a web browser
  58 --------------------------------------
  59 Enter a URL like:
  60
  61    http://example.com/gpxe-1.x.x/contrib/rom-o-matic
  62