summaryrefslogtreecommitdiffstats
path: root/contrib/rom-o-matic/README
blob: b68cf775e93262514288155d3ec6bf8c47fe94ec (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
ROM-o-matic web interface for building iPXE ROMs
------------------------------------------------

This web application generates iPXE images and sends them to a web
browser.

Available as part of the iPXE source code distribution, which can be
downlaoded from http://etherboot.org/

Author:  Marty Connor <mdc@etherboot.org>
License: GPLv2
Support: http://etherboot.org/mailman/listinfo/ipxe
         Please send support questions to the iPXE mailing list

System Requirements
-------------------
- Apache web server
- PHP 4+
- Tools required to build iPXE installed on the server
  - gcc, mtools, syslinux, perl, etc.

Setup
-----
As distributed, it is expected that the rom-o-matic source code
directory is in the contrib directory of a iPXE source distribution.

The easiest way to do this is to simply put a iPXE source distribution
in a web server accessible directory.

If this is not the case, you will need to either edit the file

    "globals.php"

or create a file called

    "local-config.php"

containing the following lines:

<?php
$src_dir = "../../src";
?>

Then change the line beginning "$src_dir = " to the path of your iPXE
source code tree.

To make build times shorter, before you run rom-o-matic for the first time
you should cd to the ipxe "src" directory and enter the following
commands:

  $ make
  $ make bin/NIC

This will pro-compile most object files and will make your rom-o-matic
builds much faster.

Running rom-o-matic from a web browser
--------------------------------------
Enter a URL like:

   http://example.com/ipxe-1.x.x/contrib/rom-o-matic