Makefile - updates - remove configure_BKO.sh
[people/warthog9/bko.git] / Troubleshooting.html
1 <html>
2   <head>
3   <link rel="stylesheet" type="text/css" href="BKOStylesteet.css" />
4  
5     <title>boot.kernel.org(BKO)</title>
6   </head>
7   <body>
8     <div id="logo">
9     <table border="0" width="100%" cellpadding="0" cellspacing="0">
10     <tr>
11       <td valign="middle" align="center">
12         <img src="boot.png" width="367" height="261">
13       </td>
14       <td valign="middle" align="left">
15         <span id="logotext">
16         <p>
17         boot.kernel.org(BKO) : Booting your machine over HTTP
18         </p>
19         </span>
20       </td>
21     </tr>
22     </table>
23     </div>
24     <div id="menubox">
25       <span id="menulink">
26         <a href="index.html">Home</a>
27       </span>
28       <span id="menulink">
29         <a href="index.html#download">Downloads</a>
30       </span>
31       <span id="menulink">
32         <a href="index.html#screenshots">Screenshots</a>
33       </span>
34       <span id="menulink">
35         <a href="index.html#howtouse">How to Use</a>
36       </span>
37       <span id="menulink">
38         Developer
39       </span>
40       <span id="menulink">
41         <a href="faq.html">FAQ</a>      
42       </span>
43       <span id="menuact">
44       Troubleshooting
45       </span>
46       <span id="menulink">
47         <a href="index.html#contactus">Contact US</a>
48       </span>
49     </div>
50
51     <center><h1>Troubleshooting</h1></center>    
52   <hr/>
53   This page is still under development.   We are looking forward for feedback from our
54   users which will give us good picture about the problems that one may face in booting with BKO. <br>
55   
56   We have tried to cover most of the problems that user may face in <a href="faq.html">FAQ</a> page.
57   <br/>
58 <ul>
59 <li><a href="#BKODownloads"> Types of gpxe images supported.</a><br/><br/></li>
60 <li><a href="#BKODhcp"> Script for DHCP networking</a><br/><br/></li>
61 <li><a href="#BKOStatic"> Script for static networking at boot time</a><br/><br/></li>
62 <li><a href="#BKOStaticCompile"> script for network configuration at compile time.</a><br/><br/></li>
63 <li><a href="#customizedGpxe"> Creating customized gpxe images</a><br/><br/></li>
64 </ul>
65
66 <a id="BKODownloads"></a><div class="qbox" >
67 <table class="qtable" width="100%" border="0" cellpadding="5" cellspacing="0">
68 <tr>
69 <td class="qmrk" width="1px"><span class="question">Q.</span></td>
70 <td class="qtd">
71 <div class="query"> Types of gpxe images supported.
72 </div>
73 </td>
74 </tr>
75 </table>
76 </div>
77 <div class="abox">
78 <table class="atable" width="100%" border="0" cellpadding="5" cellspacing="0">
79 <tr>
80 <td class="amrk" width="1px"><span class="answer">A.</span></td>
81 <td class="atd">
82 <div class="reply"> <p>Gpxe supports many types of gpxe images which can be used
83 depending on your needs.  You can downaload them at <a href="http://boot.kernel.org/gpxe_images/">gpxe images</a>
84
85 </p>
86
87
88
89
90
91
92 </div>
93 </td>
94 </tr>
95 </table>
96 </div><a id="BKODhcp"></a><div class="qbox" >
97 <table class="qtable" width="100%" border="0" cellpadding="5" cellspacing="0">
98 <tr>
99 <td class="qmrk" width="1px"><span class="question">Q.</span></td>
100 <td class="qtd">
101 <div class="query"> Script for DHCP networking
102 </div>
103 </td>
104 </tr>
105 </table>
106 </div>
107 <div class="abox">
108 <table class="atable" width="100%" border="0" cellpadding="5" cellspacing="0">
109 <tr>
110 <td class="amrk" width="1px"><span class="answer">A.</span></td>
111 <td class="atd">
112 <div class="reply"> <p> This gpxe script make sure that machine will boot with DHCP networking. 
113 <pre>#!gpxe
114
115 echo "Hi, We will be using BKO from URL http://boot.kernel.org/"
116
117 echo "It is assumed that you have dhcp networking"
118
119 ifopen net0
120
121 dhcp net0
122
123 set 209:string pxelinux.cfg/default
124
125 set 210:string http://boot.kernel.org/bko/
126
127 echo "Here we go"
128
129 chain http://boot.kernel.org/bko/pxelinux.0
130
131 echo "PxeKnife booting cancelled, using local disk instead.."
132
133  </pre>  
134
135 </p>
136
137
138
139
140 </div>
141 </td>
142 </tr>
143 </table>
144 </div><a id="BKOStatic"></a><div class="qbox" >
145 <table class="qtable" width="100%" border="0" cellpadding="5" cellspacing="0">
146 <tr>
147 <td class="qmrk" width="1px"><span class="question">Q.</span></td>
148 <td class="qtd">
149 <div class="query"> Script for static networking at boot time
150 </div>
151 </td>
152 </tr>
153 </table>
154 </div>
155 <div class="abox">
156 <table class="atable" width="100%" border="0" cellpadding="5" cellspacing="0">
157 <tr>
158 <td class="amrk" width="1px"><span class="answer">A.</span></td>
159 <td class="atd">
160 <div class="reply"> Following script provides you an interface at boot time, where you can provide the network configuration. 
161 <pre>#!gpxe
162
163 echo As you dont have DHCP, you need to give details about network configuration
164
165 echo Soon, you will be presented with interface to provide details about network configuration
166
167 echo Please provide, IP address, Netmask, Gateway and Router
168
169 ifopen net0
170
171 set net0/ip 10.0.2.15
172
173 set net0/netmask 255.255.255.0
174
175 set net0/gateway 10.0.2.2
176
177 set net0/dns 10.0.2.3
178
179 sleep 3
180
181 config net0
182
183 set 209:string pxelinux.cfg/default
184
185 set 210:string http://boot.kernel.org/bko/
186
187 echo "Here we go"
188
189 chain http://boot.kernel.org/bko/pxelinux.0
190
191 echo PxeKnife booting cancelled, using local disk instead..
192
193 </pre>
194
195 </p>
196
197
198
199
200 </div>
201 </td>
202 </tr>
203 </table>
204 </div><a id="BKOStaticCompile"></a><div class="qbox" >
205 <table class="qtable" width="100%" border="0" cellpadding="5" cellspacing="0">
206 <tr>
207 <td class="qmrk" width="1px"><span class="question">Q.</span></td>
208 <td class="qtd">
209 <div class="query"> script for network configuration at compile time.
210 </div>
211 </td>
212 </tr>
213 </table>
214 </div>
215 <div class="abox">
216 <table class="atable" width="100%" border="0" cellpadding="5" cellspacing="0">
217 <tr>
218 <td class="amrk" width="1px"><span class="answer">A.</span></td>
219 <td class="atd">
220 <div class="reply"> <p>
221 You can also provide your network configuration at pxe compilation time. This way
222
223 it will not prompt the user at boot time.
224
225 <pre>#!gpxe
226
227 ifopen net0
228
229 set net0/ip 10.0.2.15
230
231 set net0/netmask 255.255.255.0
232
233 set net0/gateway 10.0.2.2
234
235 set net0/dns 10.0.2.3
236
237 set 209:string pxelinux.cfg/default
238
239 set 210:string http://boot.kernel.org/bko/
240
241 echo "Here we go"
242
243 chain http://boot.kernel.org/bko/pxelinux.0
244
245 echo PxeKnife booting cancelled, using local disk instead..
246
247 </pre>
248
249 If you compare this script with above, we have just removed the <italic>config net0</italic> which 
250
251 is responsible for providing you with user interface.
252
253 <p>You can modify above scripts to suit your needs</p>
254
255 </p>
256
257
258
259
260 </div>
261 </td>
262 </tr>
263 </table>
264 </div><a id="customizedGpxe"></a><div class="qbox" >
265 <table class="qtable" width="100%" border="0" cellpadding="5" cellspacing="0">
266 <tr>
267 <td class="qmrk" width="1px"><span class="question">Q.</span></td>
268 <td class="qtd">
269 <div class="query"> Creating customized gpxe images
270 </div>
271 </td>
272 </tr>
273 </table>
274 </div>
275 <div class="abox">
276 <table class="atable" width="100%" border="0" cellpadding="5" cellspacing="0">
277 <tr>
278 <td class="amrk" width="1px"><span class="answer">A.</span></td>
279 <td class="atd">
280 <div class="reply"> <p>
281   You can create your own customized gpxe images tailered for your network card and
282
283    also add embedded script
284
285   which will use BKO for booting.  
286
287   This is extended <a href="http://rom-o-matic.net">rom-o-matic.net</a> to allow you
288
289   embedd any gpxe script.
290
291    Please visit <a href="http://rom.etherboot.org/share/pravin/rom-o-matic-BKO.net/">
292
293   BKO enabled rom-o-matic.net</a> for creating BKO enabled gpxe images.<br>
294
295   You can follow the <u>Configure</u> option which will let you add your own gpxe script.
296
297   We are providing few gpxe scripts here, which can be used to create customized gpxe with BKO support.
298
299   </p>
300
301
302
303
304 </div>
305 </td>
306 </tr>
307 </table>
308 </div><hr/>
309 </body>
310 </html>