Gentoo Archives: gentoo-doc-cvs

From: Xavier Neys <neysx@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: gentoo-sparc-netboot-howto.xml
Date: Thu, 18 Aug 2005 14:27:54
Message-Id: 200508181427.j7IERf60029962@robin.gentoo.org
1 neysx 05/08/18 14:27:28
2
3 Modified: xml/htdocs/doc/en gentoo-sparc-netboot-howto.xml
4 Log:
5 Improved coding style **No content change**
6
7 Revision Changes Path
8 1.8 +170 -166 xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml
9
10 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml?rev=1.8&content-type=text/x-cvsweb-markup&cvsroot=gentoo
11 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml?rev=1.8&content-type=text/plain&cvsroot=gentoo
12 diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml.diff?r1=1.7&r2=1.8&cvsroot=gentoo
13
14 Index: gentoo-sparc-netboot-howto.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml,v
17 retrieving revision 1.7
18 retrieving revision 1.8
19 diff -u -r1.7 -r1.8
20 --- gentoo-sparc-netboot-howto.xml 18 Aug 2005 13:59:23 -0000 1.7
21 +++ gentoo-sparc-netboot-howto.xml 18 Aug 2005 14:27:28 -0000 1.8
22 @@ -1,15 +1,20 @@
23 <?xml version='1.0' encoding="UTF-8"?>
24 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml,v 1.7 2005/08/18 13:59:23 neysx Exp $ -->
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-sparc-netboot-howto.xml,v 1.8 2005/08/18 14:27:28 neysx Exp $ -->
27
28 <guide link="/doc/en/gentoo-sparc-netboot-howto.xml">
29 +
30 <title>Gentoo Linux based Netboot HOWTO</title>
31 +
32 <author title="SPARC Developer">
33 <mail link="weeve@g.o">Jason Wever</mail>
34 </author>
35 +
36 <abstract>
37 -Guide for setting up a netboot server for use with the Gentoo/SPARC netboot installation images.
38 +Guide for setting up a netboot server for use with the Gentoo/SPARC netboot
39 +installation images.
40 </abstract>
41 +
42 <!-- The content of this document is licensed under the CC-BY-SA license -->
43 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
44 <license/>
45 @@ -23,21 +28,21 @@
46 <body>
47
48 <note>
49 -This howto is currently very SPARC-centric and expecting that you will be
50 +This howto is currently very SPARC-centric and expecting that you will be
51 setting up your netboot server on an existing Gentoo Linux machine.
52 </note>
53
54 <p>
55 -This document will describe how to setup a network booting environment for a
56 -Sun Microsystems SPARC or UltraSPARC based computer. The document assumes that
57 +This document will describe how to setup a network booting environment for a
58 +Sun Microsystems SPARC or UltraSPARC based computer. The document assumes that
59 you have an existing Gentoo Linux computer available to act as the netboot
60 server.
61 </p>
62
63 <p>
64 -Both the netboot server and netboot client will need to be on the same
65 -network subnet, as the ARP protocol is typically not forwarded across
66 -different network subnets.
67 +Both the netboot server and netboot client will need to be on the same network
68 +subnet, as the ARP protocol is typically not forwarded across different network
69 +subnets.
70 </p>
71
72 <p>
73 @@ -46,18 +51,14 @@
74
75 <ol>
76 <li>
77 - Client machine sends out a reverse ARP (RARP) request to get an IP address.
78 - </li>
79 - <li>
80 - A server machine returns a response to the client with the IP address.
81 - </li>
82 - <li>
83 - The client then attempts to download a boot image from the RARP server
84 - using the tftp protocol.
85 + Client machine sends out a reverse ARP (RARP) request to get an IP address
86 </li>
87 + <li>A server machine returns a response to the client with the IP address</li>
88 <li>
89 - Once the image is downloaded, the netboot client then boots the image.
90 + The client then attempts to download a boot image from the RARP server
91 + using the tftp protocol
92 </li>
93 + <li>Once the image is downloaded, the netboot client then boots the image</li>
94 </ol>
95
96 <p>
97 @@ -75,9 +76,8 @@
98 <title>The Reverse ARP Daemon</title>
99 <body>
100
101 -
102 <p>
103 -Currently, there are two choices for a reverse ARP daemon. They are
104 +Currently, there are two choices for a reverse ARP daemon. They are
105 net-misc/iputils (installed as part of the system profile) and net-misc/rarpd.
106 </p>
107
108 @@ -91,31 +91,31 @@
109 </p>
110
111 <p>
112 -No matter which rarpd you choose to use, you will need to setup the
113 -<path>/etc/ethers</path> file. This file indicates which hosts rarpd should
114 +No matter which rarpd you choose to use, you will need to setup the
115 +<path>/etc/ethers</path> file. This file indicates which hosts rarpd should
116 respond to when a request is seen, and what address to reply with.
117 </p>
118
119 <p>
120 -The format of <path>/etc/ethers</path> is MAC address of the NIC the machine
121 -will be netbooting from and the hostname. Whitespace delimits the MAC address
122 -from the hostname, and each entry should have its own line. The following
123 +The format of <path>/etc/ethers</path> is MAC address of the NIC the machine
124 +will be netbooting from and the hostname. Whitespace delimits the MAC address
125 +from the hostname, and each entry should have its own line. The following
126 example is for a host named sparc-netboot.gentoo.org:
127 </p>
128
129 <pre caption="Example /etc/ethers">
130 -08:00:20:77:1f:3e sparc-netboot.gentoo.org
131 +08:00:20:77:1f:3e sparc-netboot.gentoo.org
132 </pre>
133
134 <note>
135 -If a given hexidecimal number in the MAC address starts or is 0, you can
136 -chose to omit the first 0 (i.e. 08:00:20:77:1f:3e becomes 8:0:20:77:1f:3e).
137 +If a given hexadecimal number in the MAC address starts or is 0, you can chose
138 +to omit the first 0 (i.e. 08:00:20:77:1f:3e becomes 8:0:20:77:1f:3e).
139 </note>
140
141 <p>
142 -If you desire to add additional hosts to <path>/etc/ethers</path>, you do not need to
143 -restart the rarpd services as the file is checked each time a request is
144 -received.
145 +If you desire to add additional hosts to <path>/etc/ethers</path>, you do not
146 +need to restart the rarpd services as the file is checked each time a request
147 +is received.
148 </p>
149
150 <p>
151 @@ -123,16 +123,17 @@
152 </p>
153
154 <p>
155 -Since each entry in <path>/etc/ethers</path> has a hostname, the netboot server needs to
156 -be able to resolve the hostname into its IP address. This can be done two
157 -ways, <path>/etc/hosts</path> or the nameserver the netboot server uses.
158 +Since each entry in <path>/etc/ethers</path> has a hostname, the netboot server
159 +needs to be able to resolve the hostname into its IP address. This can be done
160 +two ways, <path>/etc/hosts</path> or the nameserver the netboot server uses.
161 </p>
162
163 <p>
164 -An <path>/etc/hosts</path> entry for resolving a hostname will look very similar to the one
165 -that probably exists from when you installed Gentoo on the netboot server.
166 -For our example host, sparc-netboot.gentoo.org, we'll assume that it has an IP
167 -address of 10.0.1.15. So the <path>/etc/hosts</path> entry would look like;
168 +An <path>/etc/hosts</path> entry for resolving a hostname will look very
169 +similar to the one that probably exists from when you installed Gentoo on the
170 +netboot server. For our example host, sparc-netboot.gentoo.org, we'll assume
171 +that it has an IP address of 10.0.1.15. So the <path>/etc/hosts</path> entry
172 +would look like;
173 </p>
174
175 <pre caption="/etc/hosts">
176 @@ -142,33 +143,33 @@
177
178 <note>
179 Depending on the environment, you may need to consult your network
180 -administrator to get an appropriate IP address or addresses to netboot
181 -the host with.
182 +administrator to get an appropriate IP address or addresses to netboot the host
183 +with.
184 </note>
185
186 <p>
187 -If you use a nameserver, then the DNS server administrator will need to add a
188 -record for the hostname, in our example sparc-netboot.gentoo.org, to point to
189 -the appropriate IP address.
190 -Please consult your DNS server administrator and/or the documentation for the
191 -DNS server's DNS software for how to add the entry.
192 +If you use a nameserver, then the DNS server administrator will need to add a
193 +record for the hostname, in our example sparc-netboot.gentoo.org, to point to
194 +the appropriate IP address. Please consult your DNS server administrator and/or
195 +the documentation for the DNS server's DNS software for how to add the entry.
196 </p>
197
198 <note>
199 -If both <path>/etc/hosts</path> and the nameserver have an entry for the host to be
200 -netbooted, <path>/etc/hosts</path> will be used first (granted the order of
201 -<path>/etc/nsswitch.conf</path> has not been changed from the default).
202 +If both <path>/etc/hosts</path> and the nameserver have an entry for the host
203 +to be netbooted, <path>/etc/hosts</path> will be used first (granted the order
204 +of <path>/etc/nsswitch.conf</path> has not been changed from the default).
205 </note>
206
207 <p>
208 <b>Setting up net-misc/iputils rarpd</b>
209 </p>
210
211 -<p>First, we will need to determine the options to use for rarpd. While there
212 -are more options than we'll cover here, these options should get you started
213
214
215
216 --
217 gentoo-doc-cvs@g.o mailing list