/[gentoo]/xml/htdocs/doc/en/openafs.xml
Gentoo

Diff of /xml/htdocs/doc/en/openafs.xml

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

Revision 1.13 Revision 1.14
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openafs.xml,v 1.13 2004/03/05 09:35:35 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openafs.xml,v 1.14 2004/04/11 10:52:16 cam Exp $ -->
3 3
4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5 5
6<guide link = "/doc/en/openafs.xml"> 6<guide link = "/doc/en/openafs.xml">
7<title>Gentoo Linux OpenAFS Guide</title> 7<title>Gentoo Linux OpenAFS Guide</title>
198 <section> 198 <section>
199 <title>Building the Server</title> 199 <title>Building the Server</title>
200 <body> 200 <body>
201 <p> 201 <p>
202 The following command will install all necessary binaries for setting up a AFS Server 202 The following command will install all necessary binaries for setting up a AFS Server
203 <i>and</i> Client 203 <e>and</e> Client.
204 </p> 204 </p>
205<pre> 205<pre>
206# <i>emerge net-fs/openafs</i> 206# <i>emerge net-fs/openafs</i>
207</pre> 207</pre>
208 </body> 208 </body>
221 Next you will run the <b>bosserver</b> command to initialize the Basic OverSeer (BOS) 221 Next you will run the <b>bosserver</b> command to initialize the Basic OverSeer (BOS)
222 Server, which monitors and controls other AFS server processes on its server 222 Server, which monitors and controls other AFS server processes on its server
223 machine. Think of it as init for the system. Include the <b>-noauth</b> 223 machine. Think of it as init for the system. Include the <b>-noauth</b>
224 flag to disable authorization checking, since you haven't added the admin user yet. 224 flag to disable authorization checking, since you haven't added the admin user yet.
225 </p> 225 </p>
226 <p>
227 <warn> 226 <warn>
228 Disabling authorization checking gravely compromises cell security. 227 Disabling authorization checking gravely compromises cell security.
229 You must complete all subsequent steps in one uninterrupted pass 228 You must complete all subsequent steps in one uninterrupted pass
230 and must not leave the machine unattended until you restart the BOS Server with 229 and must not leave the machine unattended until you restart the BOS Server with
231 authorization checking enabled. Well this is what the AFS documentation says :) 230 authorization checking enabled. Well this is what the AFS documentation says :)
232 </warn> 231 </warn>
233 </p>
234<pre> 232<pre>
235# <i>/usr/afs/bin/bosserver -noauth &amp;</i> 233# <i>/usr/afs/bin/bosserver -noauth &amp;</i>
236</pre> 234</pre>
237 <p> 235 <p>
238 Verify that the BOS Server created <path>/usr/vice/etc/CellServDB</path> 236 Verify that the BOS Server created <path>/usr/vice/etc/CellServDB</path>
250 <title>Defining Cell Name and Membership for Server Process</title> 248 <title>Defining Cell Name and Membership for Server Process</title>
251 <body> 249 <body>
252 <p> 250 <p>
253 Now assign your cells name. 251 Now assign your cells name.
254 </p> 252 </p>
255 <p>
256 <impo>There are some restrictions on the name format. 253 <impo>There are some restrictions on the name format.
257 Two of the most important restrictions are that the name 254 Two of the most important restrictions are that the name
258 cannot include uppercase letters or more than 64 characters. Remember that 255 cannot include uppercase letters or more than 64 characters. Remember that
259 your cell name will show up under <path>/afs</path>, so you might want to choose 256 your cell name will show up under <path>/afs</path>, so you might want to choose
260 a short one.</impo> 257 a short one.</impo>
261 </p>
262 <p>
263 <note>In the following and every instruction in this guide, for the <i>&lt;server name&gt;</i> 258 <note>In the following and every instruction in this guide, for the &lt;server name&gt;
264 argument substitute the full-qualified hostname 259 argument substitute the full-qualified hostname
265 (such as <b>afs.gentoo.org</b>) of the machine you are installing. 260 (such as <b>afs.gentoo.org</b>) of the machine you are installing.
266 For the <i>&lt;cell name&gt;</i> 261 For the &lt;cell name&gt;
267 argument substitute your cell's complete name (such as <b>gentoo</b>)</note> 262 argument substitute your cell's complete name (such as <b>gentoo</b>)</note>
268 </p>
269 <p> 263 <p>
270 Run the <b>bos setcellname</b> command to set the cell name: 264 Run the <b>bos setcellname</b> command to set the cell name:
271 </p> 265 </p>
272<pre> 266<pre>
273 # <i>/usr/afs/bin/bos setcellname &lt;server name&gt; &lt;cell name&gt; -noauth</i> 267# <i>/usr/afs/bin/bos setcellname &lt;server name&gt; &lt;cell name&gt; -noauth</i>
274</pre> 268</pre>
275 </body> 269 </body>
276 </section> 270 </section>
277 <section> 271 <section>
278 <title>Starting the Database Server Process</title> 272 <title>Starting the Database Server Process</title>
279 <body><p> 273 <body><p>
280 Next use the <b>bos create</b> command to create entries for the four database 274 Next use the <b>bos create</b> command to create entries for the four database
281 server processes in the 275 server processes in the
282 <path>/usr/afs/local/BosConfig</path> file. The four processes run on database 276 <path>/usr/afs/local/BosConfig</path> file. The four processes run on database
283 server machines only. 277 server machines only.
284 </p> 278 </p>
285 <p> 279
286 <table> 280 <table>
287 <tr> 281 <tr>
288 <ti>kaserver</ti> 282 <ti>kaserver</ti>
289 <ti>The Authentication Server maintains the Authentication Database. 283 <ti>The Authentication Server maintains the Authentication Database.
290 This can be replaced by a Kerberos 5 daemon. If anybody want's to try that 284 This can be replaced by a Kerberos 5 daemon. If anybody want's to try that
302 <ti>vlserver</ti> 296 <ti>vlserver</ti>
303 <ti>The Volume Location Server maintains the Volume Location Database (VLDB). 297 <ti>The Volume Location Server maintains the Volume Location Database (VLDB).
304 Very important :)</ti> 298 Very important :)</ti>
305 </tr> 299 </tr>
306 </table> 300 </table>
307 </p>
308<pre> 301<pre>
309# <i>/usr/afs/bin/bos create &lt;server name&gt; kaserver simple 302# <i>/usr/afs/bin/bos create &lt;server name&gt; kaserver simple
310 /usr/afs/bin/kaserver -cell &lt;cell name&gt; -noauth</i> 303 /usr/afs/bin/kaserver -cell &lt;cell name&gt; -noauth</i>
311# <i>/usr/afs/bin/bos create &lt;server name&gt; buserver simple 304# <i>/usr/afs/bin/bos create &lt;server name&gt; buserver simple
312 /usr/afs/bin/buserver -cell &lt;cell name&gt; -noauth</i> 305 /usr/afs/bin/buserver -cell &lt;cell name&gt; -noauth</i>
525# <i>/usr/afs/bin/fs setacl /afs system:anyuser rl</i> 518# <i>/usr/afs/bin/fs setacl /afs system:anyuser rl</i>
526</pre> 519</pre>
527 <p> 520 <p>
528 Then you need to create the root volume, mount it readonly on <path>/afs/&lt;cell name&gt;</path> and read/write 521 Then you need to create the root volume, mount it readonly on <path>/afs/&lt;cell name&gt;</path> and read/write
529 on <path>/afs/.&lt;cell name&gt;</path> 522 on <path>/afs/.&lt;cell name&gt;</path>
523 </p>
530<pre> 524<pre>
531# <i>/usr/afs/bin/vos create &lt;server name&gt;&lt;partition name&gt; root.cell</i> 525# <i>/usr/afs/bin/vos create &lt;server name&gt;&lt;partition name&gt; root.cell</i>
532# <i>/usr/afs/bin/fs mkmount /afs/&lt;cell name&gt; root.cell </i> 526# <i>/usr/afs/bin/fs mkmount /afs/&lt;cell name&gt; root.cell </i>
533# <i>/usr/afs/bin/fs setacl /afs/&lt;cell name&gt; system:anyuser rl</i> 527# <i>/usr/afs/bin/fs setacl /afs/&lt;cell name&gt; system:anyuser rl</i>
534# <i>/usr/afs/bin/fs mkmount /afs/.&lt;cell name&gt; root.cell -rw</i> 528# <i>/usr/afs/bin/fs mkmount /afs/.&lt;cell name&gt; root.cell -rw</i>
535</pre> 529</pre>
536 </p>
537 <p> 530 <p>
538 Finally you're done !!! You should now have a working AFS file server 531 Finally you're done !!! You should now have a working AFS file server
539 on your local network. Time to get a big 532 on your local network. Time to get a big
540 cup of coffee and print out the AFS documentation !!! 533 cup of coffee and print out the AFS documentation !!!
541 </p> 534 </p>

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

  ViewVC Help
Powered by ViewVC 1.1.20