/[gentoo]/xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml
Gentoo

Diff of /xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.12 Revision 1.13
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml,v 1.12 2010/03/03 01:37:41 nightmorph Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml,v 1.13 2010/10/05 21:54:55 nightmorph Exp $ -->
4 4
5<guide> 5<guide>
6<title>Gentoo Linux based Netboot HOWTO</title> 6<title>Gentoo Linux based Netboot HOWTO</title>
7 7
8<author title="SPARC Developer"> 8<author title="SPARC Developer">
19 19
20<!-- The content of this document is licensed under the CC-BY-SA license --> 20<!-- The content of this document is licensed under the CC-BY-SA license -->
21<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 21<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
22<license/> 22<license/>
23 23
24<version>1.4</version> 24<version>2</version>
25<date>2010-03-02</date> 25<date>2010-10-05</date>
26 26
27<chapter> 27<chapter>
28<title>Introduction</title> 28<title>Introduction</title>
29<section> 29<section>
30<body> 30<body>
77<section> 77<section>
78<title>The Reverse ARP Daemon</title> 78<title>The Reverse ARP Daemon</title>
79<body> 79<body>
80 80
81<p> 81<p>
82Currently, there are two choices for a reverse ARP daemon. They are 82A reverse ARP daemon is already installed on your system; it's part of the
83<c>net-misc/iputils</c> (installed as part of the system profile) and 83<c>net-misc/iputils</c> package
84<c>net-misc/rarpd</c>.
85</p> 84</p>
86
87<note>
88Installing <c>net-misc/rarpd</c> will overwrite the <c>rarpd</c> and
89<c>rarpd</c> manpage from <c>net-misc/iputils</c>.
90</note>
91 85
92<p> 86<p>
93<b>Setting up common rarpd elements</b>: <path>/etc/ethers</path> 87<b>Setting up common rarpd elements</b>: <path>/etc/ethers</path>
94</p> 88</p>
95 89
96<p> 90<p>
97No matter which <c>rarpd</c> you choose to use, you will need to setup the 91You will need to setup the <path>/etc/ethers</path> file. This file indicates
98<path>/etc/ethers</path> file. This file indicates which hosts <c>rarpd</c> 92which hosts <c>rarpd</c> should respond to when a request is seen, and what
99should respond to when a request is seen, and what address to reply with. 93address to reply with.
100</p> 94</p>
101 95
102<p> 96<p>
103The format of <path>/etc/ethers</path> is the MAC address of the NIC the 97The format of <path>/etc/ethers</path> is the MAC address of the NIC the
104machine will be netbooting and its hostname. Whitespace delimits the MAC 98machine will be netbooting and its hostname. Whitespace delimits the MAC
162to be netbooted, <path>/etc/hosts</path> will be used first (granted the order 156to be netbooted, <path>/etc/hosts</path> will be used first (granted the order
163of <path>/etc/nsswitch.conf</path> has not been changed from the default). 157of <path>/etc/nsswitch.conf</path> has not been changed from the default).
164</note> 158</note>
165 159
166<p> 160<p>
167<b>Setting up net-misc/iputils rarpd</b> 161<b>Setting up rarpd</b>
168</p> 162</p>
169 163
170<p> 164<p>
171First, we will need to determine the options to use for <c>rarpd</c>. While 165First, we will need to determine the options to use for <c>rarpd</c>. While
172there are more options than we'll cover here, these options should get you 166there are more options than we'll cover here, these options should get you
173started As there is currently no <path>init.d</path> script for the 167started As there is currently no <path>init.d</path> script for <c>rarpd</c>, an
174<c>net-misc/iputils</c> version of <c>rarpd</c>, an entry will need to be added 168entry will need to be added to <path>/etc/conf.d/local.start</path> if you want
175to <path>/etc/conf.d/local.start</path> if you want to enable <c>rarpd</c>
176services at boot time. A sample entry is as follows: 169to enable <c>rarpd</c> services at boot time. A sample entry is as follows:
177</p> 170</p>
178 171
179<pre caption="/etc/conf.d/local.start"> 172<pre caption="/etc/conf.d/local.start">
180/usr/sbin/rarpd -v -e eth0 173/usr/sbin/rarpd -v -e eth0
181</pre> 174</pre>
196 189
197<p> 190<p>
198For more options, consult <c>man 8 rarpd</c>. 191For more options, consult <c>man 8 rarpd</c>.
199</p> 192</p>
200 193
201<p>
202<b>Setting up net-misc/rarpd</b>
203</p>
204
205<p>
206Firstly, we'll need to install <c>rarpd</c> with the following command:
207</p>
208
209<pre caption="Installing rarpd">
210# <i>emerge net-misc/rarpd</i>
211</pre>
212
213<p>
214Next, options for <c>rarpd</c> will need to be set in
215<path>/etc/conf.d/rarpd</path>. For an equivalent configuration as the one used
216above for the <c>net-misc/iputils</c> <c>rarpd</c>, adjust
217<path>/etc/conf.d/rarpd</path> to look like the following
218</p>
219
220<pre caption="/etc/conf.d/rarpd">
221RARPD_OPTS="-v -i eth0"
222</pre>
223
224<p>
225An explanation of the above rarpd options (as taken from the man page);
226</p>
227
228<ul>
229 <li>
230 <c>-v</c> Be verbose. Show requests which the daemon is responding to
231 </li>
232 <li>
233 <c>-i</c> Bind to the named interface. By default <c>rarpd</c> binds to the
234 default interface for the local system type, if available
235 </li>
236</ul>
237
238<p>
239For more options, consult <c>man 8 rarpd</c> and <c>rarpd --help</c>.
240</p>
241
242</body> 194</body>
243</section> 195</section>
244<section> 196<section>
245<title>The tftpd Daemon</title> 197<title>The tftpd Daemon</title>
246<body> 198<body>
247 199
248<p> 200<p>
249Here there are three options for a TFTP daemon, <c>net-misc/atftp</c>, 201Here there are three options for a TFTP daemon, <c>net-ftp/atftp</c>,
250<c>net-misc/netkit-tftp</c> and <c>net-misc/tftp-hpa</c>. You only need to 202<c>net-ftp/netkit-tftp</c> and <c>net-ftp/tftp-hpa</c>. You only need to
251install one of the TFTP daemons for proper operation. 203install one of the TFTP daemons for proper operation.
252</p> 204</p>
253 205
254<p> 206<p>
255<b>Setting up common tftpd elements</b> 207<b>Setting up common tftpd elements</b>
287<section> 239<section>
288<title>The atftp Daemon</title> 240<title>The atftp Daemon</title>
289<body> 241<body>
290 242
291<p> 243<p>
292First, install the <c>net-misc/atftp</c> package as follows; 244First, install the <c>atftp</c> package as follows;
293</p> 245</p>
294 246
295<pre caption="Installing atftp"> 247<pre caption="Installing atftp">
296# <i>emerge net-misc/atftp</i> 248# <i>emerge atftp</i>
297</pre> 249</pre>
298 250
299<p> 251<p>
300After the <c>net-misc/atftp</c> package has been installed, it will need to be 252After the <c>atftp</c> package has been installed, it will need to be
301configured. If tftpd services are desired at boot time, an entry to 253configured. If tftpd services are desired at boot time, an entry to
302<path>/etc/conf.d/local.start</path> will need to be added as <c>atftp</c> has 254<path>/etc/conf.d/local.start</path> will need to be added as <c>atftp</c> has
303no <path>init.d</path>, <c>inetd</c> or <c>xinetd</c> scripts of its own. If you 255no <path>init.d</path>, <c>inetd</c> or <c>xinetd</c> scripts of its own. If you
304want to use <c>inetd</c> or <c>xinetd</c> for controlling the tftpd service, 256want to use <c>inetd</c> or <c>xinetd</c> for controlling the tftpd service,
305please see their respective man pages. 257please see their respective man pages.
313<pre caption="/etc/conf.d/local.start"> 265<pre caption="/etc/conf.d/local.start">
314/usr/sbin/in.tftpd -v --daemon /tftpboot 266/usr/sbin/in.tftpd -v --daemon /tftpboot
315</pre> 267</pre>
316 268
317<p> 269<p>
318An explanation of the above <c>rarpd</c> options (as taken from the man page); 270An explanation of the above options (as taken from the man page);
319</p> 271</p>
320 272
321<ul> 273<ul>
322 <li> 274 <li>
323 <c>-v</c> Increase or set the logging level. No args will increase by one 275 <c>-v</c> Increase or set the logging level. No args will increase by one
339<section> 291<section>
340<title>The netkit-tftp Daemon</title> 292<title>The netkit-tftp Daemon</title>
341<body> 293<body>
342 294
343<p> 295<p>
344First, install the <c>net-misc/netkit-tftp</c> package: 296First, install the <c>netkit-tftp</c> package:
345</p> 297</p>
346 298
347<pre caption="Installing netkit-tftp"> 299<pre caption="Installing netkit-tftp">
348# <i>emerge net-misc/netkit-tftp</i> 300# <i>emerge netkit-tftp</i>
349</pre> 301</pre>
350 302
351<p> 303<p>
352Second, install <c>sys-apps/xinetd</c> if it is not currently present. After 304Second, install <c>sys-apps/xinetd</c> if it is not currently present. After
353the <c>net-misc/netkit-tftp</c> and <c>sys-apps/xinetd</c> packages have been 305the <c>netkit-tftp</c> and <c>sys-apps/xinetd</c> packages have been
354installed, <c>netkit-tftp</c> will need to be configured. <c>netkit-tftp</c> 306installed, <c>netkit-tftp</c> will need to be configured. <c>netkit-tftp</c>
355needs to be run from <c>xinetd</c>, however it does not provide example scripts 307needs to be run from <c>xinetd</c>, however it does not provide example scripts
356of its own. A sample <c>xinetd</c> file is provided below: 308of its own. A sample <c>xinetd</c> file is provided below:
357</p> 309</p>
358 310
430<p> 382<p>
431First, install the <c>tftp-hpa</c> package: 383First, install the <c>tftp-hpa</c> package:
432</p> 384</p>
433 385
434<pre caption="Installing tftp-hpa"> 386<pre caption="Installing tftp-hpa">
435# <i>emerge net-misc/tftp-hpa</i> 387# <i>emerge tftp-hpa</i>
436</pre> 388</pre>
437 389
438<p> 390<p>
439<c>tftp-hpa</c> comes with an <path>init.d</path> and the accompanying 391<c>tftp-hpa</c> comes with an <path>init.d</path> and the accompanying
440<path>conf.d</path> configuration file. Check to make sure that INTFTPD_PATH 392<path>conf.d</path> configuration file. Check to make sure that INTFTPD_PATH

Legend:
Removed from v.1.12  
changed lines
  Added in v.1.13

  ViewVC Help
Powered by ViewVC 1.1.20