|  | @@ -0,0 +1,62 @@
 | 
		
	
		
			
			|  | 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 | +
 |