Browse Source

[contrib] Add README file to rom-o-matic

Signed-off-by: Marty Connor <mdc@etherboot.org>
tags/v1.0.0-rc1
Marty Connor 14 years ago
parent
commit
272cfac8af
1 changed files with 62 additions and 0 deletions
  1. 62
    0
      contrib/rom-o-matic/README

+ 62
- 0
contrib/rom-o-matic/README View File

@@ -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
+

Loading…
Cancel
Save