| 1 | ROM-o-matic web interface for building iPXE ROMs
|
|---|
| 2 | ------------------------------------------------
|
|---|
| 3 |
|
|---|
| 4 | This web application generates iPXE images and sends them to a web
|
|---|
| 5 | browser.
|
|---|
| 6 |
|
|---|
| 7 | Available as part of the iPXE 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/ipxe
|
|---|
| 13 | Please send support questions to the iPXE mailing list
|
|---|
| 14 |
|
|---|
| 15 | System Requirements
|
|---|
| 16 | -------------------
|
|---|
| 17 | - Apache web server
|
|---|
| 18 | - PHP 4+
|
|---|
| 19 | - Tools required to build iPXE 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 iPXE source distribution.
|
|---|
| 26 |
|
|---|
| 27 | The easiest way to do this is to simply put a iPXE 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 iPXE
|
|---|
| 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 ipxe "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/ipxe-1.x.x/contrib/rom-o-matic
|
|---|
| 62 |
|
|---|
