xml-docbook-documentation-first-pass-20060915
[openafs.git] / doc / xml / QuickStartUnix / auqbg006.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <chapter id="HDRWQ99">
3   <title>Installing Additional Server Machines</title>
4
5   <indexterm>
6     <primary>instructions</primary>
7
8     <secondary>file server machine after first</secondary>
9   </indexterm>
10
11   <indexterm>
12     <primary>installing</primary>
13
14     <secondary>file server machine after first</secondary>
15   </indexterm>
16
17   <indexterm>
18     <primary>server machine after first</primary>
19
20     <see>file server machine, additional</see>
21   </indexterm>
22
23   <para>Instructions for the following procedures appear in the indicated section of this chapter. <itemizedlist>
24       <listitem>
25         <para><link linkend="HDRWQ100">Installing an Additional File Server Machine</link></para>
26       </listitem>
27
28       <listitem>
29         <para><link linkend="HDRWQ114">Installing Database Server Functionality</link></para>
30       </listitem>
31
32       <listitem>
33         <para><link linkend="HDRWQ125">Removing Database Server Functionality</link></para>
34       </listitem>
35     </itemizedlist></para>
36
37   <para>The instructions make the following assumptions. <itemizedlist>
38       <listitem>
39         <para>You have already installed your cell's first file server machine by following the instructions in <link
40         linkend="HDRWQ17">Installing the First AFS Machine</link></para>
41       </listitem>
42
43       <listitem>
44         <para>You are logged in as the local superuser <emphasis role="bold">root</emphasis></para>
45       </listitem>
46
47       <listitem>
48         <para>You are working at the console</para>
49       </listitem>
50
51       <listitem>
52         <para>A standard version of one of the operating systems supported by the current version of AFS is running on the
53         machine</para>
54       </listitem>
55
56       <listitem>
57         <para>You can access the data on the AFS CD-ROMs, either through a local CD-ROM drive or via an NFS mount of a CD-ROM drive
58         attached to a machine that is accessible by network</para>
59       </listitem>
60     </itemizedlist></para>
61
62   <indexterm>
63     <primary>requirements</primary>
64
65     <secondary>file server machine (additional)</secondary>
66   </indexterm>
67
68   <sect1 id="HDRWQ100">
69     <title>Installing an Additional File Server Machine</title>
70
71     <para>The procedure for installing a new file server machine is similar to installing the first file server machine in your
72     cell. There are a few parts of the installation that differ depending on whether the machine is the same AFS system type as an
73     existing file server machine or is the first file server machine of its system type in your cell. The differences mostly concern
74     the source for the needed binaries and files, and what portions of the Update Server you install: <itemizedlist>
75         <listitem>
76           <para>On a new system type, you must load files and binaries from the AFS CD-ROM. You install the server portion of the
77           Update Server to make this machine the binary distribution machine for its system type.</para>
78         </listitem>
79
80         <listitem>
81           <para>On an existing system type, you can copy files and binaries from a previously installed file server machine, rather
82           than from the CD-ROM. You install the client portion of the Update Server to accept updates of binaries, because a
83           previously installed machine of this type was installed as the binary distribution machine.</para>
84         </listitem>
85       </itemizedlist></para>
86
87     <para>These instructions are brief; for more detailed information, refer to the corresponding steps in <link
88     linkend="HDRWQ17">Installing the First AFS Machine</link>. <indexterm>
89         <primary>overview</primary>
90
91         <secondary>installing server machine after first</secondary>
92       </indexterm></para>
93
94     <para>To install a new file server machine, perform the following procedures: <orderedlist>
95         <listitem>
96           <para>Copy needed binaries and files onto this machine's local disk</para>
97         </listitem>
98
99         <listitem>
100           <para>Incorporate AFS modifications into the kernel</para>
101         </listitem>
102
103         <listitem>
104           <para>Configure partitions for storing volumes</para>
105         </listitem>
106
107         <listitem>
108           <para>Replace the standard <emphasis role="bold">fsck</emphasis> utility with the AFS-modified version on some system
109           types</para>
110         </listitem>
111
112         <listitem>
113           <para>Start the Basic OverSeer (BOS) Server</para>
114         </listitem>
115
116         <listitem>
117           <para>Start the appropriate portion of the Update Server</para>
118         </listitem>
119
120         <listitem>
121           <para>Start the <emphasis role="bold">fs</emphasis> process, which incorporates three component processes: the File
122           Server, Volume Server, and Salvager</para>
123         </listitem>
124
125         <listitem>
126           <para>Start the controller process (called <emphasis role="bold">runntp</emphasis>) for the Network Time Protocol Daemon,
127           which synchronizes clocks</para>
128         </listitem>
129       </orderedlist></para>
130
131     <para>After completing the instructions in this section, you can install database server functionality on the machine according
132     to the instructions in <link linkend="HDRWQ114">Installing Database Server Functionality</link>. <indexterm>
133         <primary>CD-ROM</primary>
134
135         <secondary>creating /cdrom directory</secondary>
136
137         <tertiary>server machine after first</tertiary>
138       </indexterm> <indexterm>
139         <primary>cdrom directory</primary>
140
141         <secondary>server machine after first</secondary>
142       </indexterm> <indexterm>
143         <primary>file server machine, additional</primary>
144
145         <secondary>/cdrom directory</secondary>
146       </indexterm> <indexterm>
147         <primary>creating</primary>
148
149         <secondary>/cdrom directory</secondary>
150
151         <tertiary>server machine after first</tertiary>
152       </indexterm> <indexterm>
153         <primary>usr/afs directory</primary>
154
155         <secondary>server machine after first</secondary>
156       </indexterm> <indexterm>
157         <primary>file server machine, additional</primary>
158
159         <secondary>/usr/afs directory</secondary>
160       </indexterm> <indexterm>
161         <primary>creating</primary>
162
163         <secondary>/usr/afs directory</secondary>
164
165         <tertiary>server machine after first</tertiary>
166       </indexterm> <indexterm>
167         <primary>usr/afs/bin directory</primary>
168
169         <secondary>server machine after first</secondary>
170       </indexterm> <indexterm>
171         <primary>file server machine, additional</primary>
172
173         <secondary>/usr/afs/bin directory</secondary>
174       </indexterm> <indexterm>
175         <primary>creating</primary>
176
177         <secondary>/usr/afs/bin directory</secondary>
178
179         <tertiary>server machine after first</tertiary>
180       </indexterm> <indexterm>
181         <primary>usr/vice/etc directory</primary>
182
183         <secondary>server machine after first</secondary>
184       </indexterm> <indexterm>
185         <primary>file server machine, additional</primary>
186
187         <secondary>/usr/vice/etc directory</secondary>
188       </indexterm> <indexterm>
189         <primary>creating</primary>
190
191         <secondary>/usr/vice/etc directory</secondary>
192
193         <tertiary>server machine after first</tertiary>
194       </indexterm></para>
195
196     <sect2 id="Header_99">
197       <title>Creating AFS Directories and Performing Platform-Specific Procedures</title>
198
199       <para>Create the <emphasis role="bold">/usr/afs</emphasis> and <emphasis role="bold">/usr/vice/etc</emphasis> directories on
200       the local disk. Subsequent instructions copy files from the AFS distribution CD-ROM into them, at the appropriate point for
201       each system type.</para>
202
203       <programlisting>
204    # <emphasis role="bold">mkdir /usr/afs</emphasis>
205    # <emphasis role="bold">mkdir /usr/afs/bin</emphasis>
206    # <emphasis role="bold">mkdir /usr/vice</emphasis>
207    # <emphasis role="bold">mkdir /usr/vice/etc</emphasis>
208    # <emphasis role="bold">mkdir /cdrom</emphasis>     
209 </programlisting>
210
211       <para>As on the first file server machine, the initial procedures in installing an additional file server machine vary a good
212       deal from platform to platform. For convenience, the following sections group together all of the procedures for a system
213       type. Most of the remaining procedures are the same on every system type, but differences are noted as appropriate. The
214       initial procedures are the following. <itemizedlist>
215           <listitem>
216             <para>Incorporate AFS modifications into the kernel, either by using a dynamic kernel loader program or by building a
217             new static kernel</para>
218           </listitem>
219
220           <listitem>
221             <para>Configure server partitions to house AFS volumes</para>
222           </listitem>
223
224           <listitem>
225             <para>Replace the operating system vendor's <emphasis role="bold">fsck</emphasis> program with a version that recognizes
226             AFS data <indexterm>
227                 <primary>file server machine, additional</primary>
228
229                 <secondary>AFS login</secondary>
230
231                 <see>first AFS machine</see>
232               </indexterm></para>
233           </listitem>
234
235           <listitem>
236             <para>If the machine is to remain an AFS client machine, modify the machine's authentication system so that users obtain
237             an AFS token as they log into the local file system. (For this procedure only, the instructions direct you to the
238             platform-specific section in <link linkend="HDRWQ17">Installing the First AFS Machine</link>.)</para>
239           </listitem>
240         </itemizedlist></para>
241
242       <para>To continue, proceed to the section for this system type: <itemizedlist>
243           <listitem>
244             <para><link linkend="HDRWQ101">Getting Started on AIX Systems</link></para>
245           </listitem>
246
247           <listitem>
248             <para><link linkend="HDRWQ102">Getting Started on Digital UNIX Systems</link></para>
249           </listitem>
250
251           <listitem>
252             <para><link linkend="HDRWQ103">Getting Started on HP-UX Systems</link></para>
253           </listitem>
254
255           <listitem>
256             <para><link linkend="HDRWQ104">Getting Started on IRIX Systems</link></para>
257           </listitem>
258
259           <listitem>
260             <para><link linkend="HDRWQ106">Getting Started on Linux Systems</link></para>
261           </listitem>
262
263           <listitem>
264             <para><link linkend="HDRWQ107">Getting Started on Solaris Systems</link></para>
265           </listitem>
266         </itemizedlist></para>
267
268       <sect3 id="HDRWQ101">
269         <title>Getting Started on AIX Systems</title>
270
271         <para>Begin by running the AFS initialization script to call the AIX kernel extension facility, which dynamically loads AFS
272         modifications into the kernel. Then configure partitions and replace the AIX <emphasis role="bold">fsck</emphasis> program
273         with a version that correctly handles AFS volumes. <orderedlist>
274             <indexterm>
275               <primary>incorporating AFS kernel extensions</primary>
276
277               <secondary>server machine after first</secondary>
278
279               <tertiary>AIX</tertiary>
280             </indexterm>
281
282             <indexterm>
283               <primary>AFS kernel extensions</primary>
284
285               <secondary>on server machine after first</secondary>
286
287               <tertiary>AIX</tertiary>
288             </indexterm>
289
290             <indexterm>
291               <primary>file server machine, additional</primary>
292
293               <secondary>AFS kernel extensions</secondary>
294
295               <tertiary>on AIX</tertiary>
296             </indexterm>
297
298             <indexterm>
299               <primary>AIX</primary>
300
301               <secondary>AFS kernel extensions</secondary>
302
303               <tertiary>on add'l server machine</tertiary>
304             </indexterm>
305
306             <listitem>
307               <para>Mount the AFS CD-ROM for AIX on the local <emphasis role="bold">/cdrom</emphasis> directory. For instructions on
308               mounting CD-ROMs (either locally or remotely via NFS), see your AIX documentation. Then change directory as indicated.
309               <programlisting>
310    # <emphasis role="bold">cd  /cdrom/rs_aix42/root.client/usr/vice/etc</emphasis>
311 </programlisting></para>
312             </listitem>
313
314             <listitem>
315               <para>Copy the AFS kernel library files to the local <emphasis role="bold">/usr/vice/etc/dkload</emphasis> directory,
316               and the AFS initialization script to the <emphasis role="bold">/etc</emphasis> directory. <programlisting>
317    # <emphasis role="bold">cp -rp  dkload  /usr/vice/etc</emphasis>
318    # <emphasis role="bold">cp -p  rc.afs  /etc/rc.afs</emphasis>
319 </programlisting></para>
320             </listitem>
321
322             <listitem>
323               <para>Edit the <emphasis role="bold">/etc/rc.afs</emphasis> script, setting the <computeroutput>NFS</computeroutput>
324               variable as indicated.</para>
325
326               <para>If the machine is not to function as an NFS/AFS Translator, set the <computeroutput>NFS</computeroutput>
327               variable as follows.</para>
328
329               <programlisting>
330    NFS=$NFS_NONE
331 </programlisting>
332
333               <para>If the machine is to function as an NFS/AFS Translator and is running AIX 4.2.1 or higher, set the
334               <computeroutput>NFS</computeroutput> variable as follows. Note that NFS must already be loaded into the kernel, which
335               happens automatically on systems running AIX 4.1.1 and later, as long as the file <emphasis
336               role="bold">/etc/exports</emphasis> exists.</para>
337
338               <programlisting>
339    NFS=$NFS_IAUTH
340 </programlisting>
341             </listitem>
342
343             <listitem>
344               <para>Invoke the <emphasis role="bold">/etc/rc.afs</emphasis> script to load AFS modifications into the kernel. You
345               can ignore any error messages about the inability to start the BOS Server or the Cache Manager or AFS client.
346               <programlisting>
347    # <emphasis role="bold">/etc/rc.afs</emphasis>
348 </programlisting> <indexterm>
349                   <primary>configuring</primary>
350
351                   <secondary>AFS server partition on server machine after first</secondary>
352
353                   <tertiary>AIX</tertiary>
354                 </indexterm> <indexterm>
355                   <primary>AFS server partition</primary>
356
357                   <secondary>configuring on server machine after first</secondary>
358
359                   <tertiary>AIX</tertiary>
360                 </indexterm> <indexterm>
361                   <primary>file server machine, additional</primary>
362
363                   <secondary>AFS server partition</secondary>
364
365                   <tertiary>on AIX</tertiary>
366                 </indexterm> <indexterm>
367                   <primary>AIX</primary>
368
369                   <secondary>AFS server partition</secondary>
370
371                   <tertiary>on add'l server machine</tertiary>
372                 </indexterm></para>
373             </listitem>
374
375             <listitem>
376               <para>Create a directory called <emphasis role="bold">/vicep</emphasis><replaceable>xx</replaceable> for each AFS
377               server partition you are configuring (there must be at least one). Repeat the command for each partition.
378               <programlisting>
379    # <emphasis role="bold">mkdir /vicep</emphasis><replaceable>xx</replaceable>
380 </programlisting></para>
381             </listitem>
382
383             <listitem>
384               <para>Use the <emphasis role="bold">SMIT</emphasis> program to create a journaling file system on each partition to be
385               configured as an AFS server partition.</para>
386             </listitem>
387
388             <listitem>
389               <para>Mount each partition at one of the <emphasis role="bold">/vicep</emphasis><replaceable>xx</replaceable>
390               directories. Choose one of the following three methods: <itemizedlist>
391                   <listitem>
392                     <para>Use the <emphasis role="bold">SMIT</emphasis> program</para>
393                   </listitem>
394
395                   <listitem>
396                     <para>Use the <emphasis role="bold">mount -a</emphasis> command to mount all partitions at once</para>
397                   </listitem>
398
399                   <listitem>
400                     <para>Use the <emphasis role="bold">mount</emphasis> command on each partition in turn</para>
401                   </listitem>
402                 </itemizedlist></para>
403
404               <para>Also configure the partitions so that they are mounted automatically at each reboot. For more information, refer
405               to the AIX documentation. <indexterm>
406                   <primary>replacing fsck program</primary>
407
408                   <secondary>server machine after first</secondary>
409
410                   <tertiary>AIX</tertiary>
411                 </indexterm> <indexterm>
412                   <primary>fsck program</primary>
413
414                   <secondary>on server machine after first</secondary>
415
416                   <tertiary>AIX</tertiary>
417                 </indexterm> <indexterm>
418                   <primary>file server machine, additional</primary>
419
420                   <secondary>fsck program</secondary>
421
422                   <tertiary>on AIX</tertiary>
423                 </indexterm> <indexterm>
424                   <primary>AIX</primary>
425
426                   <secondary>fsck program</secondary>
427
428                   <tertiary>on add'l server machine</tertiary>
429                 </indexterm></para>
430             </listitem>
431
432             <listitem>
433               <para>Move the AIX <emphasis role="bold">fsck</emphasis> program helper to a safe location and install the version
434               from the AFS distribution in its place. The AFS CD-ROM must still be mounted at the <emphasis
435               role="bold">/cdrom</emphasis> directory. <programlisting>
436    # <emphasis role="bold">cd /sbin/helpers</emphasis>
437    # <emphasis role="bold">mv v3fshelper v3fshelper.noafs</emphasis>
438    # <emphasis role="bold">cp -p /cdrom/rs_aix42/root.server/etc/v3fshelper v3fshelper</emphasis>
439 </programlisting></para>
440             </listitem>
441
442             <listitem>
443               <para>If the machine is to remain an AFS client, incorporate AFS into its authentication system, following the
444               instructions in <link linkend="HDRWQ25">Enabling AFS Login on AIX Systems</link>.</para>
445             </listitem>
446
447             <listitem>
448               <para>Proceed to <link linkend="HDRWQ108">Starting Server Programs</link>.</para>
449             </listitem>
450           </orderedlist></para>
451       </sect3>
452
453       <sect3 id="HDRWQ102">
454         <title>Getting Started on Digital UNIX Systems</title>
455
456         <para>Begin by building AFS modifications into the kernel, then configure server partitions and replace the Digital UNIX
457         <emphasis role="bold">fsck</emphasis> program with a version that correctly handles AFS volumes.</para>
458
459         <para>If the machine's hardware and software configuration exactly matches another Digital UNIX machine on which AFS is
460         already built into the kernel, you can copy the kernel from that machine to this one. In general, however, it is better to
461         build AFS modifications into the kernel on each machine according to the following instructions. <orderedlist>
462             <indexterm>
463               <primary>incorporating AFS kernel extensions</primary>
464
465               <secondary>server machine after first</secondary>
466
467               <tertiary>Digital UNIX</tertiary>
468             </indexterm>
469
470             <indexterm>
471               <primary>AFS kernel extensions</primary>
472
473               <secondary>on server machine after first</secondary>
474
475               <tertiary>Digital UNIX</tertiary>
476             </indexterm>
477
478             <indexterm>
479               <primary>file server machine, additional</primary>
480
481               <secondary>AFS kernel extensions</secondary>
482
483               <tertiary>on Digital UNIX</tertiary>
484             </indexterm>
485
486             <indexterm>
487               <primary>Digital UNIX</primary>
488
489               <secondary>AFS-modified kernel</secondary>
490
491               <tertiary>on add'l server machine</tertiary>
492             </indexterm>
493
494             <listitem>
495               <para>Create a copy called <emphasis role="bold">AFS</emphasis> of the basic kernel configuration file included in the
496               Digital UNIX distribution as <emphasis role="bold">/usr/sys/conf/</emphasis><replaceable>machine_name</replaceable>,
497               where <replaceable>machine_name</replaceable> is the machine's hostname in all uppercase letters. <programlisting>
498    # <emphasis role="bold">cd /usr/sys/conf</emphasis>
499    # <emphasis role="bold">cp</emphasis> <replaceable>machine_name</replaceable> <emphasis role="bold">AFS</emphasis>
500 </programlisting></para>
501             </listitem>
502
503             <listitem>
504               <para>Add AFS to the list of options in the configuration file you created in the previous step, so that the result
505               looks like the following: <programlisting>
506           .                   .
507           .                   .
508        options               UFS
509        options               NFS
510        options               AFS
511           .                   .
512           .                   .
513 </programlisting></para>
514             </listitem>
515
516             <listitem>
517               <para>Add an entry for AFS to two places in the file <emphasis role="bold">/usr/sys/conf/files</emphasis>.
518               <itemizedlist>
519                   <listitem>
520                     <para>Add a line for AFS to the list of <computeroutput>OPTIONS</computeroutput>, so that the result looks like
521                     the following: <programlisting>
522              .                .      .
523              .                .      .
524       OPTIONS/nfs          optional nfs 
525       OPTIONS/afs          optional afs 
526       OPTIONS/nfs_server   optional nfs_server
527              .                .      .
528              .                .      .
529 </programlisting></para>
530                   </listitem>
531
532                   <listitem>
533                     <para>Add an entry for AFS to the list of <computeroutput>MODULES</computeroutput>, so that the result looks
534                     like the following: <programlisting>
535              .                  .        .          .
536              .                  .        .          .
537       #
538       MODULE/nfs_server     optional nfs_server Binary
539       nfs/nfs_server.c      module nfs_server optimize -g3
540       nfs/nfs3_server.c     module nfs_server optimize -g3
541       #
542       MODULE/afs            optional afs Binary
543       afs/libafs.c          module afs
544       #
545 </programlisting></para>
546                   </listitem>
547                 </itemizedlist></para>
548             </listitem>
549
550             <listitem>
551               <para>Add an entry for AFS to two places in the file <emphasis role="bold">/usr/sys/vfs/vfs_conf.c</emphasis>.
552               <itemizedlist>
553                   <listitem>
554                     <para>Add AFS to the list of defined file systems, so that the result looks like the following: <programlisting>
555         .       .              
556         .       .              
557      #include &lt;afs.h&gt;
558      #if defined(AFS) &amp;&amp; AFS
559             extern struct vfsops afs_vfsops;
560      #endif  
561         .       .              
562         .       .              
563 </programlisting></para>
564                   </listitem>
565
566                   <listitem>
567                     <para>Put a declaration for AFS in the <emphasis role="bold">vfssw[]</emphasis> table's MOUNT_ADDON slot, so
568                     that the result looks like the following: <programlisting>
569         .                          .              .
570         .                          .              .
571       &amp;fdfs_vfsops,         "fdfs",   /* 12 = MOUNT_FDFS */
572    #if  defined(AFS)
573       &amp;afs_vfsops,          "afs",
574    #else
575       (struct vfsops *)0,   "",       /* 13 = MOUNT_ADDON */
576    #endif
577    #if NFS &amp;&amp; INFS_DYNAMIC   
578        &amp;nfs3_vfsops,        "nfsv3",  /* 14 = MOUNT_NFS3 */         
579 </programlisting></para>
580                   </listitem>
581                 </itemizedlist></para>
582             </listitem>
583
584             <listitem>
585               <para>Mount the AFS CD-ROM for Digital UNIX on the local <emphasis role="bold">/cdrom</emphasis> directory. For
586               instructions on mounting CD-ROMs (either locally or remotely via NFS), see your Digital UNIX documentation. Then
587               change directory as indicated. <programlisting>
588    # <emphasis role="bold">cd /cdrom/alpha_dux40/root.client</emphasis>
589 </programlisting></para>
590             </listitem>
591
592             <listitem>
593               <para>Copy the AFS initialization script to the local directory for initialization files (by convention, <emphasis
594               role="bold">/sbin/init.d</emphasis> on Digital UNIX machines). Note the removal of the <emphasis
595               role="bold">.rc</emphasis> extension as you copy the script. <programlisting>
596    # <emphasis role="bold">cp usr/vice/etc/afs.rc  /sbin/init.d/afs</emphasis>
597 </programlisting></para>
598             </listitem>
599
600             <listitem>
601               <para>Copy the AFS kernel module to the local <emphasis role="bold">/usr/sys/BINARY</emphasis> directory.</para>
602
603               <para>If the machine's kernel supports NFS server functionality:</para>
604
605               <programlisting>
606    # <emphasis role="bold">cp bin/libafs.o /usr/sys/BINARY/afs.mod</emphasis>   
607 </programlisting>
608
609               <para>If the machine's kernel does not support NFS server functionality:</para>
610
611               <programlisting>
612    # <emphasis role="bold">cp bin/libafs.nonfs.o /usr/sys/BINARY/afs.mod</emphasis>
613 </programlisting>
614             </listitem>
615
616             <listitem>
617               <para>Configure and build the kernel. Respond to any prompts by pressing &lt;<emphasis
618               role="bold">Return</emphasis>&gt;. The resulting kernel resides in the file <emphasis
619               role="bold">/sys/AFS/vmunix</emphasis>. <programlisting>
620    # <emphasis role="bold">doconfig -c AFS</emphasis>
621 </programlisting></para>
622             </listitem>
623
624             <listitem>
625               <para>Rename the existing kernel file and copy the new, AFS-modified file to the standard location. <programlisting>
626    # <emphasis role="bold">mv /vmunix /vmunix_noafs</emphasis>
627    # <emphasis role="bold">cp /sys/AFS/vmunix /vmunix</emphasis>
628 </programlisting></para>
629             </listitem>
630
631             <listitem>
632               <para>Reboot the machine to start using the new kernel, and login again as the superuser <emphasis
633               role="bold">root</emphasis>. <programlisting>
634    # <emphasis role="bold">cd /</emphasis>
635    # <emphasis role="bold">shutdown -r now</emphasis>
636    login: <emphasis role="bold">root</emphasis>
637    Password: <replaceable>root_password</replaceable>
638 </programlisting> <indexterm>
639                   <primary>configuring</primary>
640
641                   <secondary>AFS server partition on server machine after first</secondary>
642
643                   <tertiary>Digital UNIX</tertiary>
644                 </indexterm> <indexterm>
645                   <primary>AFS server partition</primary>
646
647                   <secondary>configuring on server machine after first</secondary>
648
649                   <tertiary>Digital UNIX</tertiary>
650                 </indexterm> <indexterm>
651                   <primary>file server machine, additional</primary>
652
653                   <secondary>AFS server partition</secondary>
654
655                   <tertiary>on Digital UNIX</tertiary>
656                 </indexterm> <indexterm>
657                   <primary>Digital UNIX</primary>
658
659                   <secondary>AFS server partition</secondary>
660
661                   <tertiary>on add'l server machine</tertiary>
662                 </indexterm></para>
663             </listitem>
664
665             <listitem>
666               <para>Create a directory called <emphasis role="bold">/vicep</emphasis><replaceable>xx</replaceable> for each AFS
667               server partition you are configuring (there must be at least one). Repeat the command for each partition.
668               <programlisting>
669    # <emphasis role="bold">mkdir /vicep</emphasis><replaceable>xx</replaceable>
670 </programlisting></para>
671             </listitem>
672
673             <listitem>
674               <para>Add a line with the following format to the file systems registry file, <emphasis
675               role="bold">/etc/fstab</emphasis>, for each directory just created. The entry maps the directory name to the disk
676               partition to be mounted on it. <programlisting>
677    /dev/<replaceable>disk</replaceable> /vicep<replaceable>xx</replaceable> ufs rw 0 2
678 </programlisting></para>
679
680               <para>The following is an example for the first partition being configured.</para>
681
682               <programlisting>
683    /dev/rz3a /vicepa ufs rw 0 2
684 </programlisting>
685             </listitem>
686
687             <listitem>
688               <para>Create a file system on each partition that is to be mounted at a <emphasis
689               role="bold">/vicep</emphasis><replaceable>xx</replaceable> directory. The following command is probably appropriate,
690               but consult the Digital UNIX documentation for more information. <programlisting>
691    # <emphasis role="bold">newfs -v /dev/</emphasis><replaceable>disk</replaceable>
692 </programlisting></para>
693             </listitem>
694
695             <listitem>
696               <para>Mount each partition by issuing either the <emphasis role="bold">mount -a</emphasis> command to mount all
697               partitions at once or the <emphasis role="bold">mount</emphasis> command to mount each partition in turn. <indexterm>
698                   <primary>replacing fsck program</primary>
699
700                   <secondary>server machine after first</secondary>
701
702                   <tertiary>Digital UNIX</tertiary>
703                 </indexterm> <indexterm>
704                   <primary>fsck program</primary>
705
706                   <secondary>on server machine after first</secondary>
707
708                   <tertiary>Digital UNIX</tertiary>
709                 </indexterm> <indexterm>
710                   <primary>file server machine, additional</primary>
711
712                   <secondary>fsck program</secondary>
713
714                   <tertiary>on Digital UNIX</tertiary>
715                 </indexterm> <indexterm>
716                   <primary>Digital UNIX</primary>
717
718                   <secondary>fsck program</secondary>
719
720                   <tertiary>on add'l server machine</tertiary>
721                 </indexterm></para>
722             </listitem>
723
724             <listitem>
725               <para>Install the <emphasis role="bold">vfsck</emphasis> binary to the <emphasis role="bold">/sbin</emphasis> and
726               <emphasis role="bold">/usr/sbin</emphasis> directories. The AFS CD-ROM must still be mounted at the <emphasis
727               role="bold">/cdrom</emphasis> directory. <programlisting>
728    # <emphasis role="bold">cd /cdrom/alpha_dux40/root.server/etc</emphasis>
729    # <emphasis role="bold">cp vfsck /sbin/vfsck</emphasis>
730    # <emphasis role="bold">cp vfsck /usr/sbin/vfsck</emphasis>
731 </programlisting></para>
732             </listitem>
733
734             <listitem>
735               <para>Rename the Digital UNIX <emphasis role="bold">fsck</emphasis> binaries and create symbolic links to the
736               <emphasis role="bold">vfsck</emphasis> program. <programlisting>
737    # <emphasis role="bold">cd /sbin</emphasis>
738    # <emphasis role="bold">mv ufs_fsck ufs_fsck.noafs</emphasis>
739    # <emphasis role="bold">ln -s vfsck ufs_fsck</emphasis>
740    # <emphasis role="bold">cd /usr/sbin</emphasis>
741    # <emphasis role="bold">mv ufs_fsck ufs_fsck.noafs</emphasis>
742    # <emphasis role="bold">ln -s vfsck ufs_fsck</emphasis>
743 </programlisting></para>
744             </listitem>
745
746             <listitem>
747               <para>If the machine is to remain an AFS client, incorporate AFS into its authentication system, following the
748               instructions in <link linkend="HDRWQ30">Enabling AFS Login on Digital UNIX Systems</link>.</para>
749             </listitem>
750
751             <listitem>
752               <para>Proceed to <link linkend="HDRWQ108">Starting Server Programs</link>.</para>
753             </listitem>
754           </orderedlist></para>
755       </sect3>
756
757       <sect3 id="HDRWQ103">
758         <title>Getting Started on HP-UX Systems</title>
759
760         <para>Begin by building AFS modifications into the kernel, then configure server partitions and replace the HP-UX <emphasis
761         role="bold">fsck</emphasis> program with a version that correctly handles AFS volumes.</para>
762
763         <para>If the machine's hardware and software configuration exactly matches another HP-UX machine on which AFS is already
764         built into the kernel, you can copy the kernel from that machine to this one. In general, however, it is better to build AFS
765         modifications into the kernel on each machine according to the following instructions. <orderedlist>
766             <indexterm>
767               <primary>incorporating AFS kernel extensions</primary>
768
769               <secondary>server machine after first</secondary>
770
771               <tertiary>HP-UX</tertiary>
772             </indexterm>
773
774             <indexterm>
775               <primary>AFS kernel extensions</primary>
776
777               <secondary>on server machine after first</secondary>
778
779               <tertiary>HP-UX</tertiary>
780             </indexterm>
781
782             <indexterm>
783               <primary>file server machine, additional</primary>
784
785               <secondary>AFS kernel extensions</secondary>
786
787               <tertiary>on HP-UX</tertiary>
788             </indexterm>
789
790             <indexterm>
791               <primary>HP-UX</primary>
792
793               <secondary>AFS-modified kernel</secondary>
794
795               <tertiary>on add'l server machine</tertiary>
796             </indexterm>
797
798             <listitem>
799               <para>Move the existing kernel-related files to a safe location. <programlisting>
800    # <emphasis role="bold">cp /stand/vmunix /stand/vmunix.noafs</emphasis>
801    # <emphasis role="bold">cp /stand/system /stand/system.noafs</emphasis>
802 </programlisting></para>
803             </listitem>
804
805             <listitem>
806               <para>Mount the AFS CD-ROM for HP-UX on the local <emphasis role="bold">/cdrom</emphasis> directory. For instructions
807               on mounting CD-ROMs (either locally or remotely via NFS), see your HP-UX documentation. Then change directory as
808               indicated. <programlisting>
809    # <emphasis role="bold">cd /cdrom/hp_ux110/root.client</emphasis>
810 </programlisting></para>
811             </listitem>
812
813             <listitem>
814               <para>Copy the AFS initialization file to the local directory for initialization files (by convention, <emphasis
815               role="bold">/sbin/init.d</emphasis> on HP-UX machines). Note the removal of the <emphasis role="bold">.rc</emphasis>
816               extension as you copy the file. <programlisting>
817    # <emphasis role="bold">cp usr/vice/etc/afs.rc  /sbin/init.d/afs</emphasis>
818 </programlisting></para>
819             </listitem>
820
821             <listitem>
822               <para>Copy the file <emphasis role="bold">afs.driver</emphasis> to the local <emphasis
823               role="bold">/usr/conf/master.d</emphasis> directory, changing its name to <emphasis role="bold">afs</emphasis> as you
824               do. <programlisting>
825    # <emphasis role="bold">cp  usr/vice/etc/afs.driver  /usr/conf/master.d/afs</emphasis>
826 </programlisting></para>
827             </listitem>
828
829             <listitem>
830               <para>Copy the AFS kernel module to the local <emphasis role="bold">/usr/conf/lib</emphasis> directory.</para>
831
832               <para>If the machine's kernel supports NFS server functionality:</para>
833
834               <programlisting>
835    # <emphasis role="bold">cp bin/libafs.a /usr/conf/lib</emphasis>   
836 </programlisting>
837
838               <para>If the machine's kernel does not support NFS server functionality, change the file's name as you copy it:</para>
839
840               <programlisting>
841    # <emphasis role="bold">cp bin/libafs.nonfs.a /usr/conf/lib/libafs.a</emphasis>
842 </programlisting>
843             </listitem>
844
845             <listitem>
846               <para>Incorporate the AFS driver into the kernel, either using the <emphasis role="bold">SAM</emphasis> program or a
847               series of individual commands. <itemizedlist>
848                   <listitem>
849                     <para>To use the <emphasis role="bold">SAM</emphasis> program: <orderedlist>
850                         <listitem>
851                           <para>Invoke the <emphasis role="bold">SAM</emphasis> program, specifying the hostname of the local
852                           machine as <replaceable>local_hostname</replaceable>. The <emphasis role="bold">SAM</emphasis> graphical
853                           user interface pops up. <programlisting>
854    # <emphasis role="bold">sam -display</emphasis> <replaceable>local_hostname</replaceable><emphasis role="bold">:0</emphasis> 
855 </programlisting></para>
856                         </listitem>
857
858                         <listitem>
859                           <para>Choose the <emphasis role="bold">Kernel Configuration</emphasis> icon, then the <emphasis
860                           role="bold">Drivers</emphasis> icon. From the list of drivers, select <emphasis
861                           role="bold">afs</emphasis>.</para>
862                         </listitem>
863
864                         <listitem>
865                           <para>Open the pull-down <emphasis role="bold">Actions</emphasis> menu and choose the <emphasis
866                           role="bold">Add Driver to Kernel</emphasis> option.</para>
867                         </listitem>
868
869                         <listitem>
870                           <para>Open the <emphasis role="bold">Actions</emphasis> menu again and choose the <emphasis
871                           role="bold">Create a New Kernel</emphasis> option.</para>
872                         </listitem>
873
874                         <listitem>
875                           <para>Confirm your choices by choosing <emphasis role="bold">Yes</emphasis> and <emphasis
876                           role="bold">OK</emphasis> when prompted by subsequent pop-up windows. The <emphasis
877                           role="bold">SAM</emphasis> program builds the kernel and reboots the system.</para>
878                         </listitem>
879
880                         <listitem>
881                           <para>Login again as the superuser <emphasis role="bold">root</emphasis>. <programlisting>
882    login: <emphasis role="bold">root</emphasis>
883    Password: <replaceable>root_password</replaceable>
884 </programlisting></para>
885                         </listitem>
886                       </orderedlist></para>
887                   </listitem>
888
889                   <listitem>
890                     <para>To use individual commands: <orderedlist>
891                         <listitem>
892                           <para>Edit the file <emphasis role="bold">/stand/system</emphasis>, adding an entry for <emphasis
893                           role="bold">afs</emphasis> to the <computeroutput>Subsystems</computeroutput> section.</para>
894                         </listitem>
895
896                         <listitem>
897                           <para>Change to the <emphasis role="bold">/stand/build</emphasis> directory and issue the <emphasis
898                           role="bold">mk_kernel</emphasis> command to build the kernel. <programlisting>
899    # <emphasis role="bold">cd /stand/build</emphasis>
900    # <emphasis role="bold">mk_kernel</emphasis>
901 </programlisting></para>
902                         </listitem>
903
904                         <listitem>
905                           <para>Move the new kernel to the standard location (<emphasis role="bold">/stand/vmunix</emphasis>),
906                           reboot the machine to start using it, and login again as the superuser <emphasis
907                           role="bold">root</emphasis>. <programlisting>
908    # <emphasis role="bold">mv /stand/build/vmunix_test /stand/vmunix</emphasis>
909    # <emphasis role="bold">cd /</emphasis>
910    # <emphasis role="bold">shutdown -r now</emphasis>             
911    login: <emphasis role="bold">root</emphasis>
912    Password: <replaceable>root_password</replaceable>
913 </programlisting></para>
914                         </listitem>
915                       </orderedlist></para>
916                   </listitem>
917                 </itemizedlist></para>
918
919               <indexterm>
920                 <primary>configuring</primary>
921
922                 <secondary>AFS server partition on server machine after first</secondary>
923
924                 <tertiary>HP-UX</tertiary>
925               </indexterm>
926
927               <indexterm>
928                 <primary>AFS server partition</primary>
929
930                 <secondary>configuring on server machine after first</secondary>
931
932                 <tertiary>HP-UX</tertiary>
933               </indexterm>
934
935               <indexterm>
936                 <primary>file server machine, additional</primary>
937
938                 <secondary>AFS server partition</secondary>
939
940                 <tertiary>on HP-UX</tertiary>
941               </indexterm>
942
943               <indexterm>
944                 <primary>HP-UX</primary>
945
946                 <secondary>AFS server partition</secondary>
947
948                 <tertiary>on add'l server machine</tertiary>
949               </indexterm>
950             </listitem>
951
952             <listitem>
953               <para>Create a directory called <emphasis role="bold">/vicep</emphasis><replaceable>xx</replaceable> for each AFS
954               server partition you are configuring (there must be at least one). Repeat the command for each partition.
955               <programlisting>
956    # <emphasis role="bold">mkdir /vicep</emphasis><replaceable>xx</replaceable>
957 </programlisting></para>
958             </listitem>
959
960             <listitem>
961               <para>Use the <emphasis role="bold">SAM</emphasis> program to create a file system on each partition. For
962               instructions, consult the HP-UX documentation.</para>
963             </listitem>
964
965             <listitem>
966               <para>On some HP-UX systems that use logical volumes, the <emphasis role="bold">SAM</emphasis> program automatically
967               mounts the partitions. If it has not, mount each partition by issuing either the <emphasis role="bold">mount
968               -a</emphasis> command to mount all partitions at once or the <emphasis role="bold">mount</emphasis> command to mount
969               each partition in turn. <indexterm>
970                   <primary>replacing fsck program</primary>
971
972                   <secondary>server machine after first</secondary>
973
974                   <tertiary>HP-UX</tertiary>
975                 </indexterm> <indexterm>
976                   <primary>fsck program</primary>
977
978                   <secondary>on server machine after first</secondary>
979
980                   <tertiary>HP-UX</tertiary>
981                 </indexterm> <indexterm>
982                   <primary>file server machine, additional</primary>
983
984                   <secondary>fsck program</secondary>
985
986                   <tertiary>on HP-UX</tertiary>
987                 </indexterm> <indexterm>
988                   <primary>HP-UX</primary>
989
990                   <secondary>fsck program</secondary>
991
992                   <tertiary>on add'l server machine</tertiary>
993                 </indexterm></para>
994             </listitem>
995
996             <listitem>
997               <para>Create the command configuration file <emphasis role="bold">/sbin/lib/mfsconfig.d/afs</emphasis>. Use a text
998               editor to place the indicated two lines in it: <programlisting>
999    format_revision 1
1000    fsck            0        m,P,p,d,f,b:c:y,n,Y,N,q,
1001 </programlisting></para>
1002             </listitem>
1003
1004             <listitem>
1005               <para>Create and change directory to an AFS-specific command directory called <emphasis
1006               role="bold">/sbin/fs/afs</emphasis>. <programlisting>
1007    # <emphasis role="bold">mkdir /sbin/fs/afs</emphasis>
1008    # <emphasis role="bold">cd  /sbin/fs/afs</emphasis>
1009 </programlisting></para>
1010             </listitem>
1011
1012             <listitem>
1013               <para>Copy the AFS-modified version of the <emphasis role="bold">fsck</emphasis> program (the <emphasis
1014               role="bold">vfsck</emphasis> binary) and related files from the distribution directory to the new AFS-specific command
1015               directory. <programlisting>
1016    # <emphasis role="bold">cp -p /cdrom/hp_ux110/root.server/etc/*  .</emphasis>
1017 </programlisting></para>
1018             </listitem>
1019
1020             <listitem>
1021               <para>Change the <emphasis role="bold">vfsck</emphasis> binary's name to <emphasis role="bold">fsck</emphasis> and set
1022               the mode bits appropriately on all of the files in the <emphasis role="bold">/sbin/fs/afs</emphasis> directory.
1023               <programlisting>
1024    # <emphasis role="bold">mv  vfsck  fsck</emphasis>
1025    # <emphasis role="bold">chmod  755  *</emphasis>
1026 </programlisting></para>
1027             </listitem>
1028
1029             <listitem>
1030               <para>Edit the <emphasis role="bold">/etc/fstab</emphasis> file, changing the file system type for each AFS server
1031               partition from <computeroutput>hfs</computeroutput> to <computeroutput>afs</computeroutput>. This ensures that the
1032               AFS-modified <emphasis role="bold">fsck</emphasis> program runs on the appropriate partitions.</para>
1033
1034               <para>The sixth line in the following example of an edited file shows an AFS server partition, <emphasis
1035               role="bold">/vicepa</emphasis>.</para>
1036
1037               <programlisting>
1038    /dev/vg00/lvol1 / hfs defaults 0 1
1039    /dev/vg00/lvol4 /opt hfs defaults 0 2
1040    /dev/vg00/lvol5 /tmp hfs defaults 0 2
1041    /dev/vg00/lvol6 /usr hfs defaults 0 2
1042    /dev/vg00/lvol8 /var hfs defaults 0 2
1043    /dev/vg00/lvol9 /vicepa afs defaults 0 2
1044    /dev/vg00/lvol7 /usr/vice/cache hfs defaults 0 2
1045 </programlisting>
1046             </listitem>
1047
1048             <listitem>
1049               <para>If the machine is to remain an AFS client, incorporate AFS into its authentication system, following the
1050               instructions in <link linkend="HDRWQ35">Enabling AFS Login on HP-UX Systems</link>.</para>
1051             </listitem>
1052
1053             <listitem>
1054               <para>Proceed to <link linkend="HDRWQ108">Starting Server Programs</link>.</para>
1055             </listitem>
1056           </orderedlist></para>
1057       </sect3>
1058
1059       <sect3 id="HDRWQ104">
1060         <title>Getting Started on IRIX Systems</title>
1061
1062         <para>Begin by incorporating AFS modifications into the kernel. Either use the <emphasis role="bold">ml</emphasis> dynamic
1063         loader program, or build a static kernel. Then configure partitions to house AFS volumes. AFS supports use of both EFS and
1064         XFS partitions for housing AFS volumes. SGI encourages use of XFS partitions. <indexterm>
1065             <primary>file server machine, additional</primary>
1066
1067             <secondary>fsck program</secondary>
1068
1069             <tertiary>on IRIX</tertiary>
1070           </indexterm> <indexterm>
1071             <primary>fsck program</primary>
1072
1073             <secondary>on server machine after first</secondary>
1074
1075             <tertiary>IRIX</tertiary>
1076           </indexterm></para>
1077
1078         <para>You do not need to replace IRIX <emphasis role="bold">fsck</emphasis> program, because the version that SGI
1079         distributes handles AFS volumes properly. <orderedlist>
1080             <indexterm>
1081               <primary>incorporating AFS kernel extensions</primary>
1082
1083               <secondary>server machine after first</secondary>
1084
1085               <tertiary>IRIX</tertiary>
1086             </indexterm>
1087
1088             <indexterm>
1089               <primary>AFS kernel extensions</primary>
1090
1091               <secondary>on server machine after first</secondary>
1092
1093               <tertiary>IRIX</tertiary>
1094             </indexterm>
1095
1096             <indexterm>
1097               <primary>file server machine, additional</primary>
1098
1099               <secondary>AFS kernel extensions</secondary>
1100
1101               <tertiary>on IRIX</tertiary>
1102             </indexterm>
1103
1104             <listitem>
1105               <para>Prepare for incorporating AFS into the kernel by performing the following procedures. <orderedlist>
1106                   <listitem>
1107                     <para>Mount the AFS CD-ROM for IRIX on the <emphasis role="bold">/cdrom</emphasis> directory. For instructions
1108                     on mounting CD-ROMs (either locally or remotely via NFS), see your IRIX documentation. Then change directory as
1109                     indicated. <programlisting>
1110    # <emphasis role="bold">cd  /cdrom/sgi_65/root.client</emphasis>
1111 </programlisting></para>
1112                   </listitem>
1113
1114                   <listitem>
1115                     <para>Copy the AFS initialization script to the local directory for initialization files (by convention,
1116                     <emphasis role="bold">/etc/init.d</emphasis> on IRIX machines). Note the removal of the <emphasis
1117                     role="bold">.rc</emphasis> extension as you copy the script. <programlisting>
1118    # <emphasis role="bold">cp -p   usr/vice/etc/afs.rc  /etc/init.d/afs</emphasis>
1119 </programlisting></para>
1120                   </listitem>
1121
1122                   <listitem>
1123                     <para>Issue the <emphasis role="bold">uname -m</emphasis> command to determine the machine's CPU board type. The
1124                     <emphasis role="bold">IP</emphasis><replaceable>xx</replaceable> value in the output must match one of the
1125                     supported CPU board types listed in the <emphasis>IBM AFS Release Notes</emphasis> for the current version of
1126                     AFS. <programlisting>
1127    # <emphasis role="bold">uname -m</emphasis>
1128 </programlisting></para>
1129                   </listitem>
1130                 </orderedlist></para>
1131             </listitem>
1132
1133             <listitem>
1134               <para>Incorporate AFS into the kernel, either using the <emphasis role="bold">ml</emphasis> program or by building AFS
1135               modifications into a static kernel. <itemizedlist>
1136                   <indexterm>
1137                     <primary>IRIX</primary>
1138
1139                     <secondary>AFS kernel extensions</secondary>
1140
1141                     <tertiary>on server machine after first</tertiary>
1142                   </indexterm>
1143
1144                   <listitem>
1145                     <para>To use the <emphasis role="bold">ml</emphasis> program: <indexterm>
1146                         <primary>afsml variable (IRIX)</primary>
1147
1148                         <secondary>server machine after first</secondary>
1149                       </indexterm> <indexterm>
1150                         <primary>variables</primary>
1151
1152                         <secondary>afsml (IRIX)</secondary>
1153
1154                         <tertiary>server machine after first</tertiary>
1155                       </indexterm> <indexterm>
1156                         <primary>IRIX</primary>
1157
1158                         <secondary>afsml variable</secondary>
1159
1160                         <tertiary>server machine after first</tertiary>
1161                       </indexterm> <indexterm>
1162                         <primary>afsxnfs variable (IRIX)</primary>
1163
1164                         <secondary>server machine after first</secondary>
1165                       </indexterm> <indexterm>
1166                         <primary>variables</primary>
1167
1168                         <secondary>afsxnfs (IRIX)</secondary>
1169
1170                         <tertiary>server machine after first</tertiary>
1171                       </indexterm> <indexterm>
1172                         <primary>IRIX</primary>
1173
1174                         <secondary>afsxnfs variable</secondary>
1175
1176                         <tertiary>server machine after first</tertiary>
1177                       </indexterm> <orderedlist>
1178                         <listitem>
1179                           <para>Create the local <emphasis role="bold">/usr/vice/etc/sgiload</emphasis> directory to house the AFS
1180                           kernel library file. <programlisting>
1181    # <emphasis role="bold">mkdir /usr/vice/etc/sgiload</emphasis>
1182 </programlisting></para>
1183                         </listitem>
1184
1185                         <listitem>
1186                           <para>Copy the appropriate AFS kernel library file to the <emphasis
1187                           role="bold">/usr/vice/etc/sgiload</emphasis> directory. The <emphasis
1188                           role="bold">IP</emphasis><replaceable>xx</replaceable> portion of the library file name must match the
1189                           value previously returned by the <emphasis role="bold">uname -m</emphasis> command. Also choose the file
1190                           appropriate to whether the machine's kernel supports NFS server functionality (NFS must be supported for
1191                           the machine to act as an NFS/AFS Translator). Single- and multiprocessor machines use the same library
1192                           file.</para>
1193
1194                           <para>(You can choose to copy all of the kernel library files into the <emphasis
1195                           role="bold">/usr/vice/etc/sgiload</emphasis> directory, but they require a significant amount of
1196                           space.)</para>
1197
1198                           <para>If the machine's kernel supports NFS server functionality:</para>
1199
1200                           <programlisting>
1201    # <emphasis role="bold">cp -p  usr/vice/etc/sgiload/libafs.IP</emphasis><replaceable>xx</replaceable><emphasis role="bold">.o  /usr/vice/etc/sgiload</emphasis>   
1202 </programlisting>
1203
1204                           <para>If the machine's kernel does not support NFS server functionality:</para>
1205
1206                           <programlisting>
1207    # <emphasis role="bold">cp -p  usr/vice/etc/sgiload/libafs.IP</emphasis><replaceable>xx</replaceable><emphasis role="bold">.nonfs.o</emphasis>   \
1208                    <emphasis role="bold">/usr/vice/etc/sgiload</emphasis>
1209 </programlisting>
1210                         </listitem>
1211
1212                         <listitem>
1213                           <para>Issue the <emphasis role="bold">chkconfig</emphasis> command to activate the <emphasis
1214                           role="bold">afsml</emphasis> configuration variable. <programlisting>
1215    # <emphasis role="bold">/etc/chkconfig -f afsml on</emphasis>   
1216 </programlisting></para>
1217
1218                           <para>If the machine is to function as an NFS/AFS Translator and the kernel supports NFS server
1219                           functionality, activate the <emphasis role="bold">afsxnfs</emphasis> variable.</para>
1220
1221                           <programlisting>
1222    # <emphasis role="bold">/etc/chkconfig -f afsxnfs on</emphasis>
1223 </programlisting>
1224                         </listitem>
1225
1226                         <listitem>
1227                           <para>Run the <emphasis role="bold">/etc/init.d/afs</emphasis> script to load AFS extensions into the
1228                           kernel. The script invokes the <emphasis role="bold">ml</emphasis> command, automatically determining
1229                           which kernel library file to use based on this machine's CPU type and the activation state of the
1230                           <emphasis role="bold">afsxnfs</emphasis> variable.</para>
1231
1232                           <para>You can ignore any error messages about the inability to start the BOS Server or the Cache Manager
1233                           or AFS client.</para>
1234
1235                           <programlisting>
1236    # <emphasis role="bold">/etc/init.d/afs start</emphasis>
1237 </programlisting>
1238                         </listitem>
1239
1240                         <listitem>
1241                           <para>Proceed to Step <link linkend="LIWQ105">3</link>.</para>
1242                         </listitem>
1243                       </orderedlist></para>
1244
1245                     <indexterm>
1246                       <primary>IRIX</primary>
1247
1248                       <secondary>AFS-modified kernel</secondary>
1249
1250                       <tertiary>on add'l server machine</tertiary>
1251                     </indexterm>
1252                   </listitem>
1253
1254                   <listitem>
1255                     <para>If you prefer to build a kernel, and the machine's hardware and software configuration exactly matches
1256                     another IRIX machine on which AFS is already built into the kernel, you can copy the kernel from that machine to
1257                     this one. In general, however, it is better to build AFS modifications into the kernel on each machine according
1258                     to the following instructions. <orderedlist>
1259                         <listitem>
1260                           <para>Copy the kernel initialization file <emphasis role="bold">afs.sm</emphasis> to the local <emphasis
1261                           role="bold">/var/sysgen/system</emphasis> directory, and the kernel master file <emphasis
1262                           role="bold">afs</emphasis> to the local <emphasis role="bold">/var/sysgen/master.d</emphasis> directory.
1263                           <programlisting>
1264    # <emphasis role="bold">cp -p  bin/afs.sm  /var/sysgen/system</emphasis>
1265    # <emphasis role="bold">cp -p  bin/afs  /var/sysgen/master.d</emphasis>
1266 </programlisting></para>
1267                         </listitem>
1268
1269                         <listitem>
1270                           <para>Copy the appropriate AFS kernel library file to the local file <emphasis
1271                           role="bold">/var/sysgen/boot/afs.a</emphasis>; the <emphasis
1272                           role="bold">IP</emphasis><replaceable>xx</replaceable> portion of the library file name must match the
1273                           value previously returned by the <emphasis role="bold">uname -m</emphasis> command. Also choose the file
1274                           appropriate to whether the machine's kernel supports NFS server functionality (NFS must be supported for
1275                           the machine to act as an NFS/AFS Translator). Single- and multiprocessor machines use the same library
1276                           file.</para>
1277
1278                           <para>If the machine's kernel supports NFS server functionality:</para>
1279
1280                           <programlisting>
1281    # <emphasis role="bold">cp -p   bin/libafs.IP</emphasis><replaceable>xx</replaceable><emphasis role="bold">.a   /var/sysgen/boot/afs.a</emphasis>   
1282 </programlisting>
1283
1284                           <para>If the machine's kernel does not support NFS server functionality:</para>
1285
1286                           <programlisting>
1287    # <emphasis role="bold">cp -p  bin/libafs.IP</emphasis><replaceable>xx</replaceable><emphasis role="bold">.nonfs.a  /var/sysgen/boot/afs.a</emphasis>
1288 </programlisting>
1289                         </listitem>
1290
1291                         <listitem>
1292                           <para>Issue the <emphasis role="bold">chkconfig</emphasis> command to deactivate the <emphasis
1293                           role="bold">afsml</emphasis> configuration variable. <programlisting>
1294    # <emphasis role="bold">/etc/chkconfig -f afsml off</emphasis>   
1295 </programlisting></para>
1296
1297                           <para>If the machine is to function as an NFS/AFS Translator and the kernel supports NFS server
1298                           functionality, activate the <emphasis role="bold">afsxnfs</emphasis> variable.</para>
1299
1300                           <programlisting>
1301    # <emphasis role="bold">/etc/chkconfig -f afsxnfs on</emphasis>
1302 </programlisting>
1303                         </listitem>
1304
1305                         <listitem>
1306                           <para>Copy the existing kernel file, <emphasis role="bold">/unix</emphasis>, to a safe location. Compile
1307                           the new kernel, which is created in the file <emphasis role="bold">/unix.install</emphasis>. It overwrites
1308                           the existing <emphasis role="bold">/unix</emphasis> file when the machine reboots in the next step.
1309                           <programlisting>
1310    # <emphasis role="bold">cp /unix /unix_noafs</emphasis>
1311    # <emphasis role="bold">autoconfig</emphasis>
1312 </programlisting></para>
1313                         </listitem>
1314
1315                         <listitem>
1316                           <para>Reboot the machine to start using the new kernel, and login again as the superuser <emphasis
1317                           role="bold">root</emphasis>. <programlisting>
1318    # <emphasis role="bold">cd /</emphasis>
1319    # <emphasis role="bold">shutdown -i6 -g0 -y</emphasis>
1320    login: <emphasis role="bold">root</emphasis>
1321    Password: <replaceable>root_password</replaceable>
1322 </programlisting></para>
1323                         </listitem>
1324                       </orderedlist></para>
1325                   </listitem>
1326                 </itemizedlist></para>
1327
1328               <indexterm>
1329                 <primary>configuring</primary>
1330
1331                 <secondary>AFS server partition on server machine after first</secondary>
1332
1333                 <tertiary>IRIX</tertiary>
1334               </indexterm>
1335
1336               <indexterm>
1337                 <primary>AFS server partition</primary>
1338
1339                 <secondary>configuring on server machine after first</secondary>
1340
1341                 <tertiary>IRIX</tertiary>
1342               </indexterm>
1343
1344               <indexterm>
1345                 <primary>file server machine, additional</primary>
1346
1347                 <secondary>AFS server partition</secondary>
1348
1349                 <tertiary>on IRIX</tertiary>
1350               </indexterm>
1351
1352               <indexterm>
1353                 <primary>IRIX</primary>
1354
1355                 <secondary>AFS server partition</secondary>
1356
1357                 <tertiary>on add'l server machine</tertiary>
1358               </indexterm>
1359             </listitem>
1360
1361             <listitem>
1362               <para><anchor id="LIWQ105" />Create a directory called <emphasis
1363               role="bold">/vicep</emphasis><replaceable>xx</replaceable> for each AFS server partition you are configuring (there
1364               must be at least one). Repeat the command for each partition. <programlisting>
1365    # <emphasis role="bold">mkdir /vicep</emphasis><replaceable>xx</replaceable>
1366 </programlisting></para>
1367             </listitem>
1368
1369             <listitem>
1370               <para>Add a line with the following format to the file systems registry file, <emphasis
1371               role="bold">/etc/fstab</emphasis>, for each partition (or logical volume created with the XLV volume manager) to be
1372               mounted on one of the directories created in the previous step.</para>
1373
1374               <para>For an XFS partition or logical volume:</para>
1375
1376               <programlisting>
1377    /dev/dsk/<replaceable>disk</replaceable>  /vicep<replaceable>xx</replaceable>  xfs  rw,raw=/dev/rdsk/<replaceable>disk</replaceable>  0  0   
1378 </programlisting>
1379
1380               <para>For an EFS partition:</para>
1381
1382               <programlisting>
1383    /dev/dsk/<replaceable>disk</replaceable>  /vicep<replaceable>xx</replaceable>  efs  rw,raw=/dev/rdsk/<replaceable>disk</replaceable>  0  0   
1384 </programlisting>
1385
1386               <para>The following are examples of an entry for each file system type:</para>
1387
1388               <programlisting>
1389    /dev/dsk/dks0d2s6 /vicepa  xfs rw,raw=/dev/rdsk/dks0d2s6  0 0
1390    /dev/dsk/dks0d3s1 /vicepb  efs rw,raw=/dev/rdsk/dks0d3s1  0 0
1391 </programlisting>
1392             </listitem>
1393
1394             <listitem>
1395               <para>Create a file system on each partition that is to be mounted on a <emphasis
1396               role="bold">/vicep</emphasis><replaceable>xx</replaceable> directory. The following commands are probably appropriate,
1397               but consult the IRIX documentation for more information. In both cases, <replaceable>raw_device</replaceable> is a raw
1398               device name like <emphasis role="bold">/dev/rdsk/dks0d0s0</emphasis> for a single disk partition or <emphasis
1399               role="bold">/dev/rxlv/xlv0</emphasis> for a logical volume.</para>
1400
1401               <para>For XFS file systems, include the indicated options to configure the partition or logical volume with inodes
1402               large enough to accommodate AFS-specific information:</para>
1403
1404               <programlisting>
1405    # <emphasis role="bold">mkfs -t xfs -i size=512 -l size=4000b</emphasis> <replaceable>raw_device</replaceable>   
1406 </programlisting>
1407
1408               <para>For EFS file systems:</para>
1409
1410               <programlisting>
1411    # <emphasis role="bold">mkfs -t efs</emphasis> <replaceable>raw_device</replaceable>
1412 </programlisting>
1413             </listitem>
1414
1415             <listitem>
1416               <para>Mount each partition by issuing either the <emphasis role="bold">mount -a</emphasis> command to mount all
1417               partitions at once or the <emphasis role="bold">mount</emphasis> command to mount each partition in turn.</para>
1418             </listitem>
1419
1420             <listitem>
1421               <para><emphasis role="bold">(Optional)</emphasis> If you have configured partitions or logical volumes to use XFS,
1422               issue the following command to verify that the inodes are configured properly (are large enough to accommodate
1423               AFS-specific information). If the configuration is correct, the command returns no output. Otherwise, it specifies the
1424               command to run in order to configure each partition or logical volume properly. <programlisting>
1425    # <emphasis role="bold">/usr/afs/bin/xfs_size_check</emphasis>
1426 </programlisting></para>
1427             </listitem>
1428
1429             <listitem>
1430               <para>If the machine is to remain an AFS client, incorporate AFS into its authentication system, following the
1431               instructions in <link linkend="HDRWQ40">Enabling AFS Login on IRIX Systems</link>.</para>
1432             </listitem>
1433
1434             <listitem>
1435               <para>Proceed to <link linkend="HDRWQ108">Starting Server Programs</link>.</para>
1436             </listitem>
1437           </orderedlist></para>
1438       </sect3>
1439
1440       <sect3 id="HDRWQ106">
1441         <title>Getting Started on Linux Systems</title>
1442
1443         <indexterm>
1444           <primary>file server machine, additional</primary>
1445
1446           <secondary>fsck program</secondary>
1447
1448           <tertiary>on Linux</tertiary>
1449         </indexterm>
1450
1451         <indexterm>
1452           <primary>fsck program</primary>
1453
1454           <secondary>on server machine after first</secondary>
1455
1456           <tertiary>Linux</tertiary>
1457         </indexterm>
1458
1459         <para>Begin by running the AFS initialization script to call the <emphasis role="bold">insmod</emphasis> program, which
1460         dynamically loads AFS modifications into the kernel. Then create partitions for storing AFS volumes. You do not need to
1461         replace the Linux <emphasis role="bold">fsck</emphasis> program. <orderedlist>
1462             <indexterm>
1463               <primary>incorporating AFS kernel extensions</primary>
1464
1465               <secondary>server machine after first</secondary>
1466
1467               <tertiary>Linux</tertiary>
1468             </indexterm>
1469
1470             <indexterm>
1471               <primary>AFS kernel extensions</primary>
1472
1473               <secondary>on server machine after first</secondary>
1474
1475               <tertiary>Linux</tertiary>
1476             </indexterm>
1477
1478             <indexterm>
1479               <primary>file server machine, additional</primary>
1480
1481               <secondary>AFS kernel extensions</secondary>
1482
1483               <tertiary>on Linux</tertiary>
1484             </indexterm>
1485
1486             <indexterm>
1487               <primary>Linux</primary>
1488
1489               <secondary>AFS kernel extensions</secondary>
1490
1491               <tertiary>on add'l server machine</tertiary>
1492             </indexterm>
1493
1494             <listitem>
1495               <para>Mount the AFS CD-ROM for Linux on the local <emphasis role="bold">/cdrom</emphasis> directory. For instructions
1496               on mounting CD-ROMs (either locally or remotely via NFS), see your Linux documentation. Then change directory as
1497               indicated. <programlisting>
1498    # <emphasis role="bold">cd  /cdrom/i386_linux22/root.client/usr/vice/etc</emphasis>
1499 </programlisting></para>
1500             </listitem>
1501
1502             <listitem>
1503               <para>Copy the AFS kernel library files to the local <emphasis role="bold">/usr/vice/etc/modload</emphasis> directory.
1504               The filenames for the libraries have the format <emphasis
1505               role="bold">libafs-</emphasis><replaceable>version</replaceable><emphasis role="bold">.o</emphasis>, where
1506               <replaceable>version</replaceable> indicates the kernel build level. The string <emphasis role="bold">.mp</emphasis>
1507               in the <replaceable>version</replaceable> indicates that the file is appropriate for machines running a multiprocessor
1508               kernel. <programlisting>
1509    # <emphasis role="bold">cp -rp  modload  /usr/vice/etc</emphasis>
1510 </programlisting></para>
1511             </listitem>
1512
1513             <listitem>
1514               <para>Copy the AFS initialization script to the local directory for initialization files (by convention, <emphasis
1515               role="bold">/etc/rc.d/init.d</emphasis> on Linux machines). Note the removal of the <emphasis
1516               role="bold">.rc</emphasis> extension as you copy the script. <programlisting>
1517    # <emphasis role="bold">cp -p   afs.rc  /etc/rc.d/init.d/afs</emphasis> 
1518 </programlisting></para>
1519             </listitem>
1520
1521             <listitem>
1522               <para>Run the AFS initialization script to load AFS extensions into the kernel. You can ignore any error messages
1523               about the inability to start the BOS Server or the Cache Manager or AFS client. <programlisting>
1524    # <emphasis role="bold">/etc/rc.d/init.d/afs  start</emphasis>
1525 </programlisting> <indexterm>
1526                   <primary>configuring</primary>
1527
1528                   <secondary>AFS server partition on server machine after first</secondary>
1529
1530                   <tertiary>Linux</tertiary>
1531                 </indexterm> <indexterm>
1532                   <primary>AFS server partition</primary>
1533
1534                   <secondary>configuring on server machine after first</secondary>
1535
1536                   <tertiary>Linux</tertiary>
1537                 </indexterm> <indexterm>
1538                   <primary>file server machine, additional</primary>
1539
1540                   <secondary>AFS server partition</secondary>
1541
1542                   <tertiary>on Linux</tertiary>
1543                 </indexterm> <indexterm>
1544                   <primary>Linux</primary>
1545
1546                   <secondary>AFS server partition</secondary>
1547
1548                   <tertiary>on add'l server machine</tertiary>
1549                 </indexterm></para>
1550             </listitem>
1551
1552             <listitem>
1553               <para>Create a directory called <emphasis role="bold">/vicep</emphasis><replaceable>xx</replaceable> for each AFS
1554               server partition you are configuring (there must be at least one). Repeat the command for each partition.
1555               <programlisting>
1556    # <emphasis role="bold">mkdir /vicep</emphasis><replaceable>xx</replaceable>
1557 </programlisting></para>
1558             </listitem>
1559
1560             <listitem>
1561               <para>Add a line with the following format to the file systems registry file, <emphasis
1562               role="bold">/etc/fstab</emphasis>, for each directory just created. The entry maps the directory name to the disk
1563               partition to be mounted on it. <programlisting>
1564    /dev/<replaceable>disk</replaceable>  /vicep<replaceable>xx</replaceable>  ext2  defaults  0  2   
1565 </programlisting></para>
1566
1567               <para>The following is an example for the first partition being configured.</para>
1568
1569               <programlisting>
1570    /dev/sda8 /vicepa ext2 defaults 0 2
1571 </programlisting>
1572             </listitem>
1573
1574             <listitem>
1575               <para>Create a file system on each partition that is to be mounted at a <emphasis
1576               role="bold">/vicep</emphasis><replaceable>xx</replaceable> directory. The following command is probably appropriate,
1577               but consult the Linux documentation for more information. <programlisting>
1578    # <emphasis role="bold">mkfs -v /dev/</emphasis><replaceable>disk</replaceable>
1579 </programlisting></para>
1580             </listitem>
1581
1582             <listitem>
1583               <para>Mount each partition by issuing either the <emphasis role="bold">mount -a</emphasis> command to mount all
1584               partitions at once or the <emphasis role="bold">mount</emphasis> command to mount each partition in turn.</para>
1585             </listitem>
1586
1587             <listitem>
1588               <para>If the machine is to remain an AFS client, incorporate AFS into its authentication system, following the
1589               instructions in <link linkend="HDRWQ44">Enabling AFS Login on Linux Systems</link>.</para>
1590             </listitem>
1591
1592             <listitem>
1593               <para>Proceed to <link linkend="HDRWQ108">Starting Server Programs</link>.</para>
1594             </listitem>
1595           </orderedlist></para>
1596       </sect3>
1597
1598       <sect3 id="HDRWQ107">
1599         <title>Getting Started on Solaris Systems</title>
1600
1601         <para>Begin by running the AFS initialization script to call the <emphasis role="bold">modload</emphasis> program, which
1602         dynamically loads AFS modifications into the kernel. Then configure partitions and replace the Solaris <emphasis
1603         role="bold">fsck</emphasis> program with a version that correctly handles AFS volumes. <orderedlist>
1604             <indexterm>
1605               <primary>incorporating AFS kernel extensions</primary>
1606
1607               <secondary>server machine after first</secondary>
1608
1609               <tertiary>Solaris</tertiary>
1610             </indexterm>
1611
1612             <indexterm>
1613               <primary>AFS kernel extensions</primary>
1614
1615               <secondary>on server machine after first</secondary>
1616
1617               <tertiary>Solaris</tertiary>
1618             </indexterm>
1619
1620             <indexterm>
1621               <primary>file server machine, additional</primary>
1622
1623               <secondary>AFS kernel extensions</secondary>
1624
1625               <tertiary>Solaris</tertiary>
1626             </indexterm>
1627
1628             <indexterm>
1629               <primary>Solaris</primary>
1630
1631               <secondary>AFS kernel extensions</secondary>
1632
1633               <tertiary>on add'l server machine</tertiary>
1634             </indexterm>
1635
1636             <listitem>
1637               <para>Mount the AFS CD-ROM for Solaris on the <emphasis role="bold">/cdrom</emphasis> directory. For instructions on
1638               mounting CD-ROMs (either locally or remotely via NFS), see your Solaris documentation. Then change directory as
1639               indicated. <programlisting>
1640    # <emphasis role="bold">cd  /cdrom/sun4x_56/root.client/usr/vice/etc</emphasis>
1641 </programlisting></para>
1642             </listitem>
1643
1644             <listitem>
1645               <para>Copy the AFS initialization script to the local directory for initialization files (by convention, <emphasis
1646               role="bold">/etc/init.d</emphasis> on Solaris machines). Note the removal of the <emphasis role="bold">.rc</emphasis>
1647               extension as you copy the script. <programlisting>
1648    # <emphasis role="bold">cp -p  afs.rc  /etc/init.d/afs</emphasis>
1649 </programlisting></para>
1650             </listitem>
1651
1652             <listitem>
1653               <para>Copy the appropriate AFS kernel library file to the local file <emphasis
1654               role="bold">/kernel/fs/afs</emphasis>.</para>
1655
1656               <para>If the machine is running Solaris 2.6 or the 32-bit version of Solaris 7, its kernel supports NFS server
1657               functionality, and the <emphasis role="bold">nfsd</emphasis> process is running:</para>
1658
1659               <programlisting>
1660    # <emphasis role="bold">cp -p modload/libafs.o /kernel/fs/afs</emphasis>   
1661 </programlisting>
1662
1663               <para>If the machine is running Solaris 2.6 or the 32-bit version of Solaris 7, and its kernel does not support NFS
1664               server functionality or the <emphasis role="bold">nfsd</emphasis> process is not running:</para>
1665
1666               <programlisting>
1667    # <emphasis role="bold">cp -p modload/libafs.nonfs.o /kernel/fs/afs</emphasis>   
1668 </programlisting>
1669
1670               <para>If the machine is running the 64-bit version of Solaris 7, its kernel supports NFS server functionality, and the
1671               <emphasis role="bold">nfsd</emphasis> process is running:</para>
1672
1673               <programlisting>
1674    # <emphasis role="bold">cp -p modload/libafs64.o /kernel/fs/sparcv9/afs</emphasis>   
1675 </programlisting>
1676
1677               <para>If the machine is running the 64-bit version of Solaris 7, and its kernel does not support NFS server
1678               functionality or the <emphasis role="bold">nfsd</emphasis> process is not running:</para>
1679
1680               <programlisting>
1681    # <emphasis role="bold">cp -p modload/libafs64.nonfs.o /kernel/fs/sparcv9/afs</emphasis>
1682 </programlisting>
1683             </listitem>
1684
1685             <listitem>
1686               <para>Run the AFS initialization script to load AFS modifications into the kernel. You can ignore any error messages
1687               about the inability to start the BOS Server or the Cache Manager or AFS client. <programlisting>
1688    # <emphasis role="bold">/etc/init.d/afs start</emphasis>   
1689 </programlisting></para>
1690
1691               <para>When an entry called <computeroutput>afs</computeroutput> does not already exist in the local <emphasis
1692               role="bold">/etc/name_to_sysnum</emphasis> file, the script automatically creates it and reboots the machine to start
1693               using the new version of the file. If this happens, log in again as the superuser <emphasis
1694               role="bold">root</emphasis> after the reboot and run the initialization script again. This time the required entry
1695               exists in the <emphasis role="bold">/etc/name_to_sysnum</emphasis> file, and the <emphasis
1696               role="bold">modload</emphasis> program runs.</para>
1697
1698               <programlisting>
1699    login: <emphasis role="bold">root</emphasis>
1700    Password: <replaceable>root_password</replaceable>
1701    # <emphasis role="bold">/etc/init.d/afs start</emphasis>
1702 </programlisting>
1703
1704               <indexterm>
1705                 <primary>replacing fsck program</primary>
1706
1707                 <secondary>server machine after first</secondary>
1708
1709                 <tertiary>Solaris</tertiary>
1710               </indexterm>
1711
1712               <indexterm>
1713                 <primary>fsck program</primary>
1714
1715                 <secondary>on server machine after first</secondary>
1716
1717                 <tertiary>Solaris</tertiary>
1718               </indexterm>
1719
1720               <indexterm>
1721                 <primary>file server machine, additional</primary>
1722
1723                 <secondary>fsck program</secondary>
1724
1725                 <tertiary>on Solaris</tertiary>
1726               </indexterm>
1727
1728               <indexterm>
1729                 <primary>Solaris</primary>
1730
1731                 <secondary>fsck program</secondary>
1732
1733                 <tertiary>on add'l server machine</tertiary>
1734               </indexterm>
1735             </listitem>
1736
1737             <listitem>
1738               <para>Create the <emphasis role="bold">/usr/lib/fs/afs</emphasis> directory to house the AFS-modified <emphasis
1739               role="bold">fsck</emphasis> program and related files. <programlisting>
1740    # <emphasis role="bold">mkdir /usr/lib/fs/afs</emphasis>
1741    # <emphasis role="bold">cd /usr/lib/fs/afs</emphasis>  
1742 </programlisting></para>
1743             </listitem>
1744
1745             <listitem>
1746               <para>Copy the <emphasis role="bold">vfsck</emphasis> binary to the newly created directory, changing the name as you
1747               do so. <programlisting>
1748    # <emphasis role="bold">cp  /cdrom/sun4x_56/root.server/etc/vfsck  fsck</emphasis>
1749 </programlisting></para>
1750             </listitem>
1751
1752             <listitem>
1753               <para>Working in the <emphasis role="bold">/usr/lib/fs/afs</emphasis> directory, create the following links to Solaris
1754               libraries: <programlisting>
1755    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/clri</emphasis>  
1756    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/df</emphasis>
1757    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/edquota</emphasis>
1758    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/ff</emphasis>
1759    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/fsdb</emphasis>  
1760    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/fsirand</emphasis>
1761    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/fstyp</emphasis>
1762    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/labelit</emphasis>
1763    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/lockfs</emphasis>
1764    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/mkfs</emphasis>  
1765    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/mount</emphasis>
1766    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/ncheck</emphasis>
1767    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/newfs</emphasis>
1768    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/quot</emphasis>
1769    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/quota</emphasis>
1770    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/quotaoff</emphasis>
1771    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/quotaon</emphasis>
1772    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/repquota</emphasis>
1773    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/tunefs</emphasis>
1774    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/ufsdump</emphasis>
1775    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/ufsrestore</emphasis>
1776    # <emphasis role="bold">ln -s /usr/lib/fs/ufs/volcopy</emphasis>
1777 </programlisting></para>
1778             </listitem>
1779
1780             <listitem>
1781               <para>Append the following line to the end of the file <emphasis role="bold">/etc/dfs/fstypes</emphasis>.
1782               <programlisting>
1783    afs AFS Utilities
1784 </programlisting></para>
1785             </listitem>
1786
1787             <listitem>
1788               <para>Edit the <emphasis role="bold">/sbin/mountall</emphasis> file, making two changes. <itemizedlist>
1789                   <listitem>
1790                     <para>Add an entry for AFS to the <computeroutput>case</computeroutput> statement for option 2, so that it reads
1791                     as follows: <programlisting>
1792    case "$2" in
1793    ufs)    foptions="-o p"
1794            ;;
1795    afs)    foptions="-o p"
1796            ;;
1797    s5)     foptions="-y -t /var/tmp/tmp$$ -D"
1798            ;;
1799    *)      foptions="-y"
1800            ;;
1801 </programlisting></para>
1802                   </listitem>
1803
1804                   <listitem>
1805                     <para>Edit the file so that all AFS and UFS partitions are checked in parallel. Replace the following section of
1806                     code: <programlisting>
1807    # For  fsck purposes, we make a distinction between ufs and
1808    # other file systems
1809    #
1810    if [ "$fstype" = "ufs" ]; then
1811         ufs_fscklist="$ufs_fscklist $fsckdev"
1812         saveentry $fstype "$OPTIONS" $special $mountp
1813         continue
1814    fi  
1815 </programlisting></para>
1816
1817                     <para>with the following section of code:</para>
1818
1819                     <programlisting>
1820    # For fsck purposes, we make a distinction between ufs/afs
1821    # and other file systems.
1822    #
1823    if [ "$fstype" = "ufs" -o "$fstype" = "afs" ]; then
1824         ufs_fscklist="$ufs_fscklist $fsckdev"
1825         saveentry $fstype "$OPTIONS" $special $mountp
1826         continue
1827    fi
1828 </programlisting>
1829                   </listitem>
1830                 </itemizedlist></para>
1831
1832               <indexterm>
1833                 <primary>configuring</primary>
1834
1835                 <secondary>AFS server partition on server machine after first</secondary>
1836
1837                 <tertiary>Solaris</tertiary>
1838               </indexterm>
1839
1840               <indexterm>
1841                 <primary>AFS server partition</primary>
1842
1843                 <secondary>configuring on server machine after first</secondary>
1844
1845                 <tertiary>Solaris</tertiary>
1846               </indexterm>
1847
1848               <indexterm>
1849                 <primary>file server machine, additional</primary>
1850
1851                 <secondary>AFS server partition</secondary>
1852
1853                 <tertiary>on Solaris</tertiary>
1854               </indexterm>
1855
1856               <indexterm>
1857                 <primary>Solaris</primary>
1858
1859                 <secondary>AFS server partition</secondary>
1860
1861                 <tertiary>on add'l server machine</tertiary>
1862               </indexterm>
1863             </listitem>
1864
1865             <listitem>
1866               <para>Create a directory called <emphasis role="bold">/vicep</emphasis><replaceable>xx</replaceable> for each AFS
1867               server partition you are configuring (there must be at least one). Repeat the command for each partition.
1868               <programlisting>
1869    # <emphasis role="bold">mkdir /vicep</emphasis><replaceable>xx</replaceable>
1870 </programlisting></para>
1871             </listitem>
1872
1873             <listitem>
1874               <para>Add a line with the following format to the file systems registry file, <emphasis
1875               role="bold">/etc/vfstab</emphasis>, for each partition to be mounted on a directory created in the previous step. Note
1876               the value <computeroutput>afs</computeroutput> in the fourth field, which tells Solaris to use the AFS-modified
1877               <emphasis role="bold">fsck</emphasis> program on this partition. <programlisting>
1878    /dev/dsk/<replaceable>disk</replaceable>   /dev/rdsk/<replaceable>disk</replaceable>   /vicep<replaceable>xx</replaceable>   afs   <replaceable>boot_order</replaceable>  yes  
1879 </programlisting></para>
1880
1881               <para>The following is an example for the first partition being configured.</para>
1882
1883               <programlisting>
1884    /dev/dsk/c0t6d0s1 /dev/rdsk/c0t6d0s1 /vicepa afs 3 yes
1885 </programlisting>
1886             </listitem>
1887
1888             <listitem>
1889               <para>Create a file system on each partition that is to be mounted at a <emphasis
1890               role="bold">/vicep</emphasis><replaceable>xx</replaceable> directory. The following command is probably appropriate,
1891               but consult the Solaris documentation for more information. <programlisting>
1892    # <emphasis role="bold">newfs -v /dev/rdsk/</emphasis><replaceable>disk</replaceable>
1893 </programlisting></para>
1894             </listitem>
1895
1896             <listitem>
1897               <para>Issue the <emphasis role="bold">mountall</emphasis> command to mount all partitions at once.</para>
1898             </listitem>
1899
1900             <listitem>
1901               <para>If the machine is to remain an AFS client, incorporate AFS into its authentication system, following the
1902               instructions in <link linkend="HDRWQ49">Enabling AFS Login and Editing the File Systems Clean-up Script on Solaris
1903               Systems</link>.</para>
1904             </listitem>
1905
1906             <listitem>
1907               <para>Proceed to <link linkend="HDRWQ108">Starting Server Programs</link>.</para>
1908             </listitem>
1909           </orderedlist></para>
1910
1911         <indexterm>
1912           <primary>file server machine, additional</primary>
1913
1914           <secondary>server functionality</secondary>
1915         </indexterm>
1916
1917         <indexterm>
1918           <primary>installing</primary>
1919
1920           <secondary>server functionality</secondary>
1921
1922           <tertiary>server machine after first</tertiary>
1923         </indexterm>
1924       </sect3>
1925     </sect2>
1926
1927     <sect2 id="HDRWQ108">
1928       <title>Starting Server Programs</title>
1929
1930       <para>In this section you initialize the BOS Server, the Update Server, the controller process for NTPD, and the <emphasis
1931       role="bold">fs</emphasis> process. You begin by copying the necessary server files to the local disk. <orderedlist>
1932           <indexterm>
1933             <primary>copying</primary>
1934
1935             <secondary>server files to local disk</secondary>
1936
1937             <tertiary>server machine after first</tertiary>
1938           </indexterm>
1939
1940           <indexterm>
1941             <primary>CD-ROM</primary>
1942
1943             <secondary>copying server files from</secondary>
1944
1945             <tertiary>server machine after first</tertiary>
1946           </indexterm>
1947
1948           <indexterm>
1949             <primary>file server machine, additional</primary>
1950
1951             <secondary>copying</secondary>
1952
1953             <tertiary>server files to local disk</tertiary>
1954           </indexterm>
1955
1956           <listitem>
1957             <para>Copy file server binaries to the local <emphasis role="bold">/usr/afs/bin</emphasis> directory. <itemizedlist>
1958                 <listitem>
1959                   <para>On a machine of an existing system type, you can either load files from the AFS CD-ROM or use a remote file
1960                   transfer protocol to copy files from an existing server machine of the same system type. To load from the CD-ROM,
1961                   see the instructions just following for a machine of a new system type. If using a remote file transfer protocol,
1962                   copy the complete contents of the existing server machine's <emphasis role="bold">/usr/afs/bin</emphasis>
1963                   directory.</para>
1964                 </listitem>
1965
1966                 <listitem>
1967                   <para>On a machine of a new system type, you must use the following instructions to copy files from the AFS
1968                   CD-ROM. <orderedlist>
1969                       <listitem>
1970                         <para>On the local <emphasis role="bold">/cdrom</emphasis> directory, mount the AFS CD-ROM for this
1971                         machine's system type, if it is not already. For instructions on mounting CD-ROMs (either locally or
1972                         remotely via NFS), consult the operating system documentation.</para>
1973                       </listitem>
1974
1975                       <listitem>
1976                         <para>Copy files from the CD-ROM to the local <emphasis role="bold">/usr/afs</emphasis> directory.
1977                         <programlisting>
1978    # <emphasis role="bold">cd /cdrom/</emphasis><replaceable>sysname</replaceable><emphasis role="bold">/root.server/usr/afs</emphasis>
1979    # <emphasis role="bold">cp -rp  *  /usr/afs</emphasis>
1980 </programlisting></para>
1981                       </listitem>
1982                     </orderedlist></para>
1983                 </listitem>
1984               </itemizedlist></para>
1985
1986             <indexterm>
1987               <primary>usr/afs/etc directory</primary>
1988
1989               <secondary>server machine after first</secondary>
1990             </indexterm>
1991
1992             <indexterm>
1993               <primary>file server machine, additional</primary>
1994
1995               <secondary>/usr/afs/etc directory</secondary>
1996             </indexterm>
1997
1998             <indexterm>
1999               <primary>creating</primary>
2000
2001               <secondary>/usr/afs/etc directory</secondary>
2002
2003               <tertiary>server machine after first</tertiary>
2004             </indexterm>
2005
2006             <indexterm>
2007               <primary>creating</primary>
2008
2009               <secondary>CellServDB file (server)</secondary>
2010
2011               <tertiary>server machine after first</tertiary>
2012             </indexterm>
2013
2014             <indexterm>
2015               <primary>UserList file</primary>
2016
2017               <secondary>server machine after first</secondary>
2018             </indexterm>
2019
2020             <indexterm>
2021               <primary>KeyFile file</primary>
2022
2023               <secondary>server machine after first</secondary>
2024             </indexterm>
2025
2026             <indexterm>
2027               <primary>CellServDB file (server)</primary>
2028
2029               <secondary>creating</secondary>
2030
2031               <tertiary>on server machine after first</tertiary>
2032             </indexterm>
2033
2034             <indexterm>
2035               <primary>database server machine</primary>
2036
2037               <secondary>entry in server CellServDB file</secondary>
2038
2039               <tertiary>on server machine after first</tertiary>
2040             </indexterm>
2041
2042             <indexterm>
2043               <primary>ThisCell file (server)</primary>
2044
2045               <secondary>server machine after first</secondary>
2046             </indexterm>
2047
2048             <indexterm>
2049               <primary>file server machine, additional</primary>
2050
2051               <secondary>cell membership, defining</secondary>
2052
2053               <tertiary>for server processes</tertiary>
2054             </indexterm>
2055
2056             <indexterm>
2057               <primary>setting</primary>
2058
2059               <secondary>cell name in server ThisCell file</secondary>
2060
2061               <tertiary>server machine after first</tertiary>
2062             </indexterm>
2063
2064             <indexterm>
2065               <primary>file server machine, additional</primary>
2066
2067               <secondary>ThisCell file (server)</secondary>
2068             </indexterm>
2069           </listitem>
2070
2071           <listitem>
2072             <para>Copy the contents of the <emphasis role="bold">/usr/afs/etc</emphasis> directory from an existing file server
2073             machine, using a remote file transfer protocol such as <emphasis role="bold">ftp</emphasis> or NFS. If you use a system
2074             control machine, it is best to copy the contents of its <emphasis role="bold">/usr/afs/etc</emphasis> directory. If you
2075             choose not to run a system control machine, copy the directory's contents from any existing file server machine.
2076             <indexterm>
2077                 <primary>BOS Server</primary>
2078
2079                 <secondary>starting</secondary>
2080
2081                 <tertiary>server machine after first</tertiary>
2082               </indexterm> <indexterm>
2083                 <primary>starting</primary>
2084
2085                 <secondary>BOS Server</secondary>
2086
2087                 <tertiary>server machine after first</tertiary>
2088               </indexterm> <indexterm>
2089                 <primary>file server machine, additional</primary>
2090
2091                 <secondary>BOS Server</secondary>
2092               </indexterm> <indexterm>
2093                 <primary>authorization checking (disabling)</primary>
2094
2095                 <secondary>server machine after first</secondary>
2096               </indexterm> <indexterm>
2097                 <primary>disabling authorization checking</primary>
2098
2099                 <secondary>server machine after first</secondary>
2100               </indexterm> <indexterm>
2101                 <primary>file server machine, additional</primary>
2102
2103                 <secondary>authorization checking (disabling)</secondary>
2104               </indexterm></para>
2105           </listitem>
2106
2107           <listitem>
2108             <para>Change to the <emphasis role="bold">/usr/afs/bin</emphasis> directory and start the BOS Server (<emphasis
2109             role="bold">bosserver</emphasis> process). Include the <emphasis role="bold">-noauth</emphasis> flag to prevent the AFS
2110             processes from performing authorization checking. This is a grave compromise of security; finish the remaining
2111             instructions in this section in an uninterrupted pass. <programlisting>
2112    # <emphasis role="bold">cd /usr/afs/bin</emphasis>
2113    # <emphasis role="bold">./bosserver -noauth &amp;</emphasis>
2114 </programlisting> <indexterm>
2115                 <primary>BosConfig file</primary>
2116
2117                 <secondary>adding entries</secondary>
2118
2119                 <tertiary>server machine after first</tertiary>
2120               </indexterm> <indexterm>
2121                 <primary>adding</primary>
2122
2123                 <secondary>entries to BosConfig file</secondary>
2124
2125                 <tertiary>server machine after first</tertiary>
2126               </indexterm> <indexterm>
2127                 <primary>Update Server</primary>
2128
2129                 <secondary>starting client portion</secondary>
2130               </indexterm> <indexterm>
2131                 <primary>upclient process</primary>
2132               </indexterm> <indexterm>
2133                 <primary>starting</primary>
2134
2135                 <secondary>Update Server client portion</secondary>
2136               </indexterm> <indexterm>
2137                 <primary>file server machine, additional</primary>
2138
2139                 <secondary>Update Server client portion</secondary>
2140               </indexterm></para>
2141           </listitem>
2142
2143           <listitem>
2144             <para><anchor id="LIWQ109" />If you run a system control machine, create the <emphasis
2145             role="bold">upclientetc</emphasis> process as an instance of the client portion of the Update Server. It accepts updates
2146             of the common configuration files stored in the system control machine's <emphasis role="bold">/usr/afs/etc</emphasis>
2147             directory from the <emphasis role="bold">upserver</emphasis> process (server portion of the Update Server) running on
2148             that machine. The cell's first file server machine was installed as the system control machine in <link
2149             linkend="HDRWQ61">Starting the Server Portion of the Update Server</link>. (If you do not run a system control machine,
2150             you must update the contents of the <emphasis role="bold">/usr/afs/etc</emphasis> directory on each file server machine,
2151             using the appropriate <emphasis role="bold">bos</emphasis> commands.)</para>
2152
2153             <para>By default, the Update Server performs updates every 300 seconds (five minutes). Use the <emphasis
2154             role="bold">-t</emphasis> argument to specify a different number of seconds. For the
2155             <replaceable>machine&nbsp;name</replaceable> argument, substitute the name of the machine you are installing. The
2156             command appears on multiple lines here only for legibility reasons.</para>
2157
2158             <programlisting>
2159    # <emphasis role="bold">./bos create</emphasis>  &lt;<replaceable>machine name</replaceable>&gt; <emphasis role="bold">upclientetc simple</emphasis>  \ 
2160          <emphasis role="bold">"/usr/afs/bin/upclient</emphasis>  &lt;<replaceable>system control machine</replaceable>&gt;  \  
2161          [<emphasis role="bold">-t</emphasis>  &lt;<replaceable>time</replaceable>&gt;]  <emphasis role="bold">/usr/afs/etc" -cell</emphasis>  &lt;<replaceable>cell name</replaceable>&gt;  <emphasis
2162                 role="bold">-noauth</emphasis>
2163 </programlisting>
2164
2165             <indexterm>
2166               <primary>Update Server</primary>
2167
2168               <secondary>starting server portion</secondary>
2169
2170               <tertiary>server machine after first</tertiary>
2171             </indexterm>
2172
2173             <indexterm>
2174               <primary>starting</primary>
2175
2176               <secondary>Update Server server portion</secondary>
2177
2178               <tertiary>server machine after first</tertiary>
2179             </indexterm>
2180
2181             <indexterm>
2182               <primary>file server machine, additional</primary>
2183
2184               <secondary>Update Server server portion</secondary>
2185             </indexterm>
2186           </listitem>
2187
2188           <listitem>
2189             <para><anchor id="LIWQ110" />Create an instance of the Update Server to handle distribution of the file server binaries
2190             stored in the <emphasis role="bold">/usr/afs/bin</emphasis> directory. <itemizedlist>
2191                 <listitem>
2192                   <para>If this is the first file server machine of its AFS system type, create the <emphasis
2193                   role="bold">upserver</emphasis> process as an instance of the server portion of the Update Server. It distributes
2194                   its copy of the file server process binaries to the other file server machines of this system type that you
2195                   install in future. Creating this process makes this machine the binary distribution machine for its type.
2196                   <programlisting>
2197    # <emphasis role="bold">./bos create</emphasis>  &lt;<replaceable>machine name</replaceable>&gt; <emphasis role="bold">upserver  simple</emphasis>  \ 
2198          <emphasis role="bold">"/usr/afs/bin/upserver -clear /usr/afs/bin"</emphasis>   \
2199          <emphasis role="bold">-cell</emphasis> &lt;<replaceable>cell name</replaceable>&gt;  <emphasis role="bold">-noauth</emphasis>
2200 </programlisting></para>
2201                 </listitem>
2202
2203                 <listitem>
2204                   <para>If this machine is an existing system type, create the <emphasis role="bold">upclientbin</emphasis> process
2205                   as an instance of the client portion of the Update Server. It accepts updates of the AFS binaries from the
2206                   <emphasis role="bold">upserver</emphasis> process running on the binary distribution machine for its system type.
2207                   For distribution to work properly, the <emphasis role="bold">upserver</emphasis> process must already by running
2208                   on that machine.</para>
2209
2210                   <para>Use the <emphasis role="bold">-clear</emphasis> argument to specify that the <emphasis
2211                   role="bold">upclientbin</emphasis> process requests unencrypted transfer of the binaries in the <emphasis
2212                   role="bold">/usr/afs/bin</emphasis> directory. Binaries are not sensitive and encrypting them is
2213                   time-consuming.</para>
2214
2215                   <para>By default, the Update Server performs updates every 300 seconds (five minutes). Use the <emphasis
2216                   role="bold">-t</emphasis> argument to specify an different number of seconds.</para>
2217
2218                   <programlisting>
2219    # <emphasis role="bold">./bos create</emphasis>  &lt;<replaceable>machine name</replaceable>&gt; <emphasis role="bold">upclientbin simple</emphasis>  \ 
2220         <emphasis role="bold">"/usr/afs/bin/upclient</emphasis> &lt;<replaceable>binary distribution machine</replaceable>&gt;   \
2221         [<emphasis role="bold">-t</emphasis> &lt;<replaceable>time</replaceable>&gt;] <emphasis role="bold">-clear /usr/afs/bin" -cell</emphasis> &lt;<replaceable>cell name</replaceable>&gt;  <emphasis
2222                       role="bold">-noauth</emphasis>
2223 </programlisting>
2224                 </listitem>
2225               </itemizedlist></para>
2226
2227             <indexterm>
2228               <primary>runntp process</primary>
2229
2230               <secondary>server machine after first</secondary>
2231             </indexterm>
2232
2233             <indexterm>
2234               <primary>starting</primary>
2235
2236               <secondary>runntp process</secondary>
2237
2238               <tertiary>server machine after first</tertiary>
2239             </indexterm>
2240
2241             <indexterm>
2242               <primary>file server machine, additional</primary>
2243
2244               <secondary>runntp process</secondary>
2245             </indexterm>
2246
2247             <indexterm>
2248               <primary>NTPD</primary>
2249
2250               <secondary>server machine after first</secondary>
2251             </indexterm>
2252           </listitem>
2253
2254           <listitem>
2255             <para>Start the <emphasis role="bold">runntp</emphasis> process, which configures the Network Time Protocol Daemon
2256             (NTPD) to choose a database server machine chosen randomly from the local <emphasis
2257             role="bold">/usr/afs/etc/CellServDB</emphasis> file as its time source. In the standard configuration, the first
2258             database server machine installed in your cell refers to a time source outside the cell, and serves as the basis for
2259             clock synchronization on all server machines. <programlisting>
2260    # <emphasis role="bold">./bos create</emphasis>  &lt;<replaceable>machine name</replaceable>&gt; <emphasis role="bold">runntp simple</emphasis>  \ 
2261          <emphasis role="bold">/usr/afs/bin/runntp -cell</emphasis> &lt;<replaceable>cell name</replaceable>&gt;  <emphasis
2262                   role="bold">-noauth</emphasis>
2263 </programlisting></para>
2264
2265             <note>
2266               <para>Do not run the <emphasis role="bold">runntp</emphasis> process if NTPD or another time synchronization protocol
2267               is already running on the machine. Some versions of some operating systems run a time synchronization program by
2268               default, as detailed in the <emphasis>IBM AFS Release Notes</emphasis>.</para>
2269
2270               <para>Attempting to run multiple instances of the NTPD causes an error. Running NTPD together with another time
2271               synchronization protocol is unnecessary and can cause instability in the clock setting.</para>
2272             </note>
2273
2274             <indexterm>
2275               <primary>File Server</primary>
2276
2277               <secondary>server machine after first</secondary>
2278             </indexterm>
2279
2280             <indexterm>
2281               <primary>starting</primary>
2282
2283               <secondary>File Server</secondary>
2284
2285               <tertiary>server machine after first</tertiary>
2286             </indexterm>
2287
2288             <indexterm>
2289               <primary>file server machine, additional</primary>
2290
2291               <secondary>File Server</secondary>
2292             </indexterm>
2293
2294             <indexterm>
2295               <primary>Volume Server</primary>
2296
2297               <secondary>server machine after first</secondary>
2298             </indexterm>
2299
2300             <indexterm>
2301               <primary>starting</primary>
2302
2303               <secondary>Volume Server</secondary>
2304
2305               <tertiary>server machine after first</tertiary>
2306             </indexterm>
2307
2308             <indexterm>
2309               <primary>file server machine, additional</primary>
2310
2311               <secondary>Volume Server</secondary>
2312             </indexterm>
2313
2314             <indexterm>
2315               <primary>Salvager (salvager process)</primary>
2316
2317               <secondary>server machine after first</secondary>
2318             </indexterm>
2319
2320             <indexterm>
2321               <primary>fs process</primary>
2322
2323               <secondary>server machine after first</secondary>
2324             </indexterm>
2325
2326             <indexterm>
2327               <primary>starting</primary>
2328
2329               <secondary>fs process</secondary>
2330
2331               <tertiary>server machine after first</tertiary>
2332             </indexterm>
2333
2334             <indexterm>
2335               <primary>file server machine, additional</primary>
2336
2337               <secondary>fs process</secondary>
2338             </indexterm>
2339           </listitem>
2340
2341           <listitem>
2342             <para>Start the <emphasis role="bold">fs</emphasis> process, which binds together the File Server, Volume Server, and
2343             Salvager. <programlisting>
2344    # <emphasis role="bold">./bos create</emphasis>  &lt;<replaceable>machine name</replaceable>&gt; <emphasis role="bold">fs fs</emphasis>   \ 
2345          <emphasis role="bold">/usr/afs/bin/fileserver /usr/afs/bin/volserver</emphasis>  \ 
2346          <emphasis role="bold">/usr/afs/bin/salvager -cell</emphasis> &lt;<replaceable>cell name</replaceable>&gt;  <emphasis
2347                   role="bold">-noauth</emphasis>
2348 </programlisting></para>
2349           </listitem>
2350         </orderedlist></para>
2351
2352       <indexterm>
2353         <primary>installing</primary>
2354
2355         <secondary>client functionality</secondary>
2356
2357         <tertiary>server machine after first</tertiary>
2358       </indexterm>
2359
2360       <indexterm>
2361         <primary>file server machine, additional</primary>
2362
2363         <secondary>client functionality</secondary>
2364       </indexterm>
2365     </sect2>
2366
2367     <sect2 id="HDRWQ111">
2368       <title>Installing Client Functionality</title>
2369
2370       <para>If you want this machine to be a client as well as a server, follow the instructions in this section. Otherwise, skip to
2371       <link linkend="HDRWQ112">Completing the Installation</link>.</para>
2372
2373       <para>Begin by loading the necessary client files to the local disk. Then create the necessary configuration files and start
2374       the Cache Manager. For more detailed explanation of the procedures involved, see the corresponding instructions in <link
2375       linkend="HDRWQ17">Installing the First AFS Machine</link> (in the sections following <link linkend="HDRWQ63">Overview:
2376       Installing Client Functionality</link>).</para>
2377
2378       <para>If another AFS machine of this machine's system type exists, the AFS binaries are probably already accessible in your
2379       AFS filespace (the conventional location is <emphasis role="bold">/afs/</emphasis><replaceable>cellname</replaceable><emphasis
2380       role="bold">/</emphasis><replaceable>sysname</replaceable><emphasis role="bold">/usr/afsws</emphasis>). If not, or if this is
2381       the first AFS machine of its type, copy the AFS binaries for this system type into an AFS volume by following the instructions
2382       in <link linkend="HDRWQ83">Storing AFS Binaries in AFS</link>. Because this machine is not yet an AFS client, you must perform
2383       the procedure on an existing AFS machine. However, remember to perform the final step (linking the local directory <emphasis
2384       role="bold">/usr/afsws</emphasis> to the appropriate location in the AFS file tree) on this machine itself. If you also want
2385       to create AFS volumes to house UNIX system binaries for the new system type, see <link linkend="HDRWQ88">Storing System
2386       Binaries in AFS</link>. <indexterm>
2387           <primary>CD-ROM</primary>
2388
2389           <secondary>copying client files from</secondary>
2390
2391           <tertiary>server machine after first</tertiary>
2392         </indexterm> <indexterm>
2393           <primary>file server machine, additional</primary>
2394
2395           <secondary>copying</secondary>
2396
2397           <tertiary>client files to local disk</tertiary>
2398         </indexterm> <indexterm>
2399           <primary>copying</primary>
2400
2401           <secondary>client files to local disk</secondary>
2402
2403           <tertiary>server machine after first</tertiary>
2404         </indexterm> <orderedlist>
2405           <listitem>
2406             <para>Copy client binaries and files to the local disk. <itemizedlist>
2407                 <listitem>
2408                   <para>On a machine of an existing system type, you can either load files from the AFS CD-ROM or use a remote file
2409                   transfer protocol to copy files from an existing server machine of the same system type. To load from the CD-ROM,
2410                   see the instructions just following for a machine of a new system type. If using a remote file transfer protocol,
2411                   copy the complete contents of the existing client machine's <emphasis role="bold">/usr/vice/etc</emphasis>
2412                   directory.</para>
2413                 </listitem>
2414
2415                 <listitem>
2416                   <para>On a machine of a new system type, you must use the following instructions to copy files from the AFS
2417                   CD-ROM. <orderedlist>
2418                       <listitem>
2419                         <para>On the local <emphasis role="bold">/cdrom</emphasis> directory, mount the AFS CD-ROM for this
2420                         machine's system type, if it is not already. For instructions on mounting CD-ROMs (either locally or
2421                         remotely via NFS), consult the operating system documentation.</para>
2422                       </listitem>
2423
2424                       <listitem>
2425                         <para>Copy files to the local <emphasis role="bold">/usr/vice/etc</emphasis> directory.</para>
2426
2427                         <para>This step places a copy of the AFS initialization script (and related files, if applicable) into the
2428                         <emphasis role="bold">/usr/vice/etc</emphasis> directory. In the preceding instructions for incorporating
2429                         AFS into the kernel, you copied the script directly to the operating system's conventional location for
2430                         initialization files. When you incorporate AFS into the machine's startup sequence in a later step, you can
2431                         choose to link the two files.</para>
2432
2433                         <para>On some system types that use a dynamic kernel loader program, you previously copied AFS library files
2434                         into a subdirectory of the <emphasis role="bold">/usr/vice/etc</emphasis> directory. On other system types,
2435                         you copied the appropriate AFS library file directly to the directory where the operating system accesses
2436                         it. The following commands do not copy or recopy the AFS library files into the <emphasis
2437                         role="bold">/usr/vice/etc</emphasis> directory, because on some system types the library files consume a
2438                         large amount of space. If you want to copy them, add the <emphasis role="bold">-r</emphasis> flag to the
2439                         first <emphasis role="bold">cp</emphasis> command and skip the second <emphasis role="bold">cp</emphasis>
2440                         command.</para>
2441
2442                         <programlisting>
2443    # <emphasis role="bold">cd /cdrom/</emphasis><replaceable>sysname</replaceable><emphasis role="bold">/root.client/usr/vice/etc</emphasis>
2444    # <emphasis role="bold">cp -p  *  /usr/vice/etc</emphasis>
2445    # <emphasis role="bold">cp -rp  C  /usr/vice/etc</emphasis>
2446 </programlisting>
2447                       </listitem>
2448                     </orderedlist></para>
2449                 </listitem>
2450               </itemizedlist></para>
2451
2452             <indexterm>
2453               <primary>cell name</primary>
2454
2455               <secondary>setting in client ThisCell file</secondary>
2456
2457               <tertiary>server machine after first</tertiary>
2458             </indexterm>
2459
2460             <indexterm>
2461               <primary>cell name</primary>
2462
2463               <secondary>setting in server ThisCell file</secondary>
2464
2465               <tertiary>server machine after first</tertiary>
2466             </indexterm>
2467
2468             <indexterm>
2469               <primary>setting</primary>
2470
2471               <secondary>cell name in client ThisCell file</secondary>
2472
2473               <tertiary>server machine after first</tertiary>
2474             </indexterm>
2475
2476             <indexterm>
2477               <primary>file server machine, additional</primary>
2478
2479               <secondary>ThisCell file (client)</secondary>
2480             </indexterm>
2481
2482             <indexterm>
2483               <primary>file server machine, additional</primary>
2484
2485               <secondary>cell membership, defining</secondary>
2486
2487               <tertiary>for client processes</tertiary>
2488             </indexterm>
2489
2490             <indexterm>
2491               <primary>ThisCell file (client)</primary>
2492
2493               <secondary>server machine after first</secondary>
2494             </indexterm>
2495           </listitem>
2496
2497           <listitem>
2498             <para>Change to the <emphasis role="bold">/usr/vice/etc</emphasis> directory and create the <emphasis
2499             role="bold">ThisCell</emphasis> file as a copy of the <emphasis role="bold">/usr/afs/etc/ThisCell</emphasis> file. You
2500             must first remove the symbolic link to the <emphasis role="bold">/usr/afs/etc/ThisCell</emphasis> file that the BOS
2501             Server created automatically in <link linkend="HDRWQ108">Starting Server Programs</link>. <programlisting>
2502    # <emphasis role="bold">cd  /usr/vice/etc</emphasis>
2503    # <emphasis role="bold">rm  ThisCell</emphasis>
2504    # <emphasis role="bold">cp  /usr/afs/etc/ThisCell  ThisCell</emphasis>
2505 </programlisting></para>
2506           </listitem>
2507
2508           <listitem>
2509             <para>Remove the symbolic link to the <emphasis role="bold">/usr/afs/etc/CellServDB</emphasis> file. <programlisting>
2510    # <emphasis role="bold">rm  CellServDB</emphasis>
2511 </programlisting> <indexterm>
2512                 <primary>database server machine</primary>
2513
2514                 <secondary>entry in client CellServDB file</secondary>
2515
2516                 <tertiary>on server machine after first</tertiary>
2517               </indexterm> <indexterm>
2518                 <primary>CellServDB file (client)</primary>
2519
2520                 <secondary>creating</secondary>
2521
2522                 <tertiary>on server machine after first</tertiary>
2523               </indexterm> <indexterm>
2524                 <primary>creating</primary>
2525
2526                 <secondary>CellServDB file (client)</secondary>
2527
2528                 <tertiary>server machine after first</tertiary>
2529               </indexterm></para>
2530           </listitem>
2531
2532           <listitem>
2533             <para>Create the <emphasis role="bold">/usr/vice/etc/CellServDB</emphasis> file. Use a network file transfer program
2534             such as <emphasis role="bold">ftp</emphasis> or NFS to copy it from one of the following sources, which are listed in
2535             decreasing order of preference: <itemizedlist>
2536                 <listitem>
2537                   <para>Your cell's central <emphasis role="bold">CellServDB</emphasis> source file (the conventional location is
2538                   <emphasis role="bold">/afs/</emphasis><replaceable>cellname</replaceable><emphasis
2539                   role="bold">/common/etc/CellServDB</emphasis>)</para>
2540                 </listitem>
2541
2542                 <listitem>
2543                   <para>The global <emphasis role="bold">CellServDB</emphasis> file maintained by the AFS Product Support
2544                   group</para>
2545                 </listitem>
2546
2547                 <listitem>
2548                   <para>An existing client machine in your cell</para>
2549                 </listitem>
2550
2551                 <listitem>
2552                   <para>The <emphasis role="bold">CellServDB.sample</emphasis> file included in the
2553                   <replaceable>sysname</replaceable><emphasis role="bold">/root.client/usr/vice/etc</emphasis> directory of each AFS
2554                   CD-ROM; add an entry for the local cell by following the instructions in <link linkend="HDRWQ66">Creating the
2555                   Client CellServDB File</link></para>
2556                 </listitem>
2557               </itemizedlist></para>
2558
2559             <indexterm>
2560               <primary>cache</primary>
2561
2562               <secondary>configuring</secondary>
2563
2564               <tertiary>server machine after first</tertiary>
2565             </indexterm>
2566
2567             <indexterm>
2568               <primary>configuring</primary>
2569
2570               <secondary>cache</secondary>
2571
2572               <tertiary>server machine after first</tertiary>
2573             </indexterm>
2574
2575             <indexterm>
2576               <primary>setting</primary>
2577
2578               <secondary>cache size and location</secondary>
2579
2580               <tertiary>server machine after first</tertiary>
2581             </indexterm>
2582
2583             <indexterm>
2584               <primary>file server machine, additional</primary>
2585
2586               <secondary>cache size and location</secondary>
2587             </indexterm>
2588           </listitem>
2589
2590           <listitem>
2591             <para>Create the <emphasis role="bold">cacheinfo</emphasis> file for either a disk cache or a memory cache. For a
2592             discussion of the appropriate values to record in the file, see <link linkend="HDRWQ67">Configuring the
2593             Cache</link>.</para>
2594
2595             <para>To configure a disk cache, issue the following commands. If you are devoting a partition exclusively to caching,
2596             as recommended, you must also configure it, make a file system on it, and mount it at the directory created in this
2597             step.</para>
2598
2599             <programlisting>
2600    # <emphasis role="bold">mkdir /usr/vice/cache</emphasis>
2601    # <emphasis role="bold">echo "/afs:/usr/vice/cache:</emphasis><replaceable>#blocks</replaceable><emphasis role="bold">" &gt; cacheinfo</emphasis>   
2602 </programlisting>
2603
2604             <para>To configure a memory cache:</para>
2605
2606             <programlisting>
2607    # <emphasis role="bold">echo "/afs:/usr/vice/cache:</emphasis><replaceable>#blocks</replaceable><emphasis role="bold">" &gt; cacheinfo</emphasis>
2608 </programlisting>
2609
2610             <indexterm>
2611               <primary>Cache Manager</primary>
2612
2613               <secondary>server machine after first</secondary>
2614             </indexterm>
2615
2616             <indexterm>
2617               <primary>configuring</primary>
2618
2619               <secondary>Cache Manager</secondary>
2620
2621               <tertiary>server machine after first</tertiary>
2622             </indexterm>
2623
2624             <indexterm>
2625               <primary>file server machine, additional</primary>
2626
2627               <secondary>Cache Manager</secondary>
2628             </indexterm>
2629
2630             <indexterm>
2631               <primary>afs (/afs) directory</primary>
2632
2633               <secondary>creating</secondary>
2634
2635               <tertiary>server machine after first</tertiary>
2636             </indexterm>
2637
2638             <indexterm>
2639               <primary>AFS initialization script</primary>
2640
2641               <secondary>setting afsd parameters</secondary>
2642
2643               <tertiary>server machine after first</tertiary>
2644             </indexterm>
2645
2646             <indexterm>
2647               <primary>file server machine, additional</primary>
2648
2649               <secondary>afsd command parameters</secondary>
2650             </indexterm>
2651           </listitem>
2652
2653           <listitem>
2654             <para>Create the local directory on which to mount the AFS filespace, by convention <emphasis
2655             role="bold">/afs</emphasis>. If the directory already exists, verify that it is empty. <programlisting>
2656    # <emphasis role="bold">mkdir /afs</emphasis>
2657 </programlisting></para>
2658           </listitem>
2659
2660           <listitem>
2661             <para>On AIX systems, add the following line to the <emphasis role="bold">/etc/vfs</emphasis> file. It enables AIX to
2662             unmount AFS correctly during shutdown. <programlisting>
2663    afs     4     none     none
2664 </programlisting></para>
2665           </listitem>
2666
2667           <listitem>
2668             <para>On Linux systems, copy the <emphasis role="bold">afsd</emphasis> options file from the <emphasis
2669             role="bold">/usr/vice/etc</emphasis> directory to the <emphasis role="bold">/etc/sysconfig</emphasis> directory,
2670             removing the <emphasis role="bold">.conf</emphasis> extension as you do so. <programlisting>
2671    # <emphasis role="bold">cp /usr/vice/etc/afs.conf /etc/sysconfig/afs</emphasis>
2672 </programlisting></para>
2673           </listitem>
2674
2675           <listitem>
2676             <para>Edit the machine's AFS initialization script or <emphasis role="bold">afsd</emphasis> options file to set
2677             appropriate values for <emphasis role="bold">afsd</emphasis> command parameters. The script resides in the indicated
2678             location on each system type: <itemizedlist>
2679                 <listitem>
2680                   <para>On AIX systems, <emphasis role="bold">/etc/rc.afs</emphasis></para>
2681                 </listitem>
2682
2683                 <listitem>
2684                   <para>On Digital UNIX systems, <emphasis role="bold">/sbin/init.d/afs</emphasis></para>
2685                 </listitem>
2686
2687                 <listitem>
2688                   <para>On HP-UX systems, <emphasis role="bold">/sbin/init.d/afs</emphasis></para>
2689                 </listitem>
2690
2691                 <listitem>
2692                   <para>On IRIX systems, <emphasis role="bold">/etc/init.d/afs</emphasis></para>
2693                 </listitem>
2694
2695                 <listitem>
2696                   <para>On Linux systems, <emphasis role="bold">/etc/sysconfig/afs</emphasis> (the <emphasis
2697                   role="bold">afsd</emphasis> options file)</para>
2698                 </listitem>
2699
2700                 <listitem>
2701                   <para>On Solaris systems, <emphasis role="bold">/etc/init.d/afs</emphasis></para>
2702                 </listitem>
2703               </itemizedlist></para>
2704
2705             <para>Use one of the methods described in <link linkend="HDRWQ70">Configuring the Cache Manager</link> to add the
2706             following flags to the <emphasis role="bold">afsd</emphasis> command line. If you intend for the machine to remain an
2707             AFS client, also set any performance-related arguments you wish. <itemizedlist>
2708                 <listitem>
2709                   <para>Add the <emphasis role="bold">-nosettime</emphasis> flag, because this is a file server machine that is also
2710                   a client.</para>
2711                 </listitem>
2712
2713                 <listitem>
2714                   <para>Add the <emphasis role="bold">-memcache</emphasis> flag if the machine is to use a memory cache.</para>
2715                 </listitem>
2716
2717                 <listitem>
2718                   <para>Add the <emphasis role="bold">-verbose</emphasis> flag to display a trace of the Cache Manager's
2719                   initialization on the standard output stream.</para>
2720                 </listitem>
2721               </itemizedlist></para>
2722           </listitem>
2723
2724           <listitem>
2725             <para>If appropriate, follow the instructions in <link linkend="HDRWQ83">Storing AFS Binaries in AFS</link> to copy the
2726             AFS binaries for this system type into an AFS volume. See the introduction to this section for further
2727             discussion.</para>
2728           </listitem>
2729         </orderedlist></para>
2730     </sect2>
2731
2732     <sect2 id="HDRWQ112">
2733       <title>Completing the Installation</title>
2734
2735       <para>At this point you run the machine's AFS initialization script to verify that it correctly loads AFS modifications into
2736       the kernel and starts the BOS Server, which starts the other server processes. If you have installed client files, the script
2737       also starts the Cache Manager. If the script works correctly, perform the steps that incorporate it into the machine's startup
2738       and shutdown sequence. If there are problems during the initialization, attempt to resolve them. The AFS Product Support group
2739       can provide assistance if necessary.</para>
2740
2741       <para>If the machine is configured as a client using a disk cache, it can take a while for the <emphasis
2742       role="bold">afsd</emphasis> program to create all of the <emphasis role="bold">V</emphasis><replaceable>n</replaceable> files
2743       in the cache directory. Messages on the console trace the initialization process. <orderedlist>
2744           <listitem>
2745             <para>Issue the <emphasis role="bold">bos shutdown</emphasis> command to shut down the AFS server processes other than
2746             the BOS Server. Include the <emphasis role="bold">-wait</emphasis> flag to delay return of the command shell prompt
2747             until all processes shut down completely. <programlisting>
2748    # <emphasis role="bold">/usr/afs/bin/bos shutdown</emphasis> &lt;<replaceable>machine name</replaceable>&gt; <emphasis
2749                   role="bold">-wait</emphasis>
2750 </programlisting></para>
2751           </listitem>
2752
2753           <listitem>
2754             <para>Issue the <emphasis role="bold">ps</emphasis> command to learn the BOS Server's process ID number (PID), and then
2755             the <emphasis role="bold">kill</emphasis> command to stop the <emphasis role="bold">bosserver</emphasis> process.
2756             <programlisting>
2757    # <emphasis role="bold">ps</emphasis> <replaceable>appropriate_ps_options</replaceable> <emphasis role="bold">| grep bosserver</emphasis>
2758    # <emphasis role="bold">kill</emphasis> <replaceable>bosserver_PID</replaceable>
2759 </programlisting> <indexterm>
2760                 <primary>AFS initialization script</primary>
2761
2762                 <secondary>adding to machine startup sequence</secondary>
2763
2764                 <tertiary>server machine after first</tertiary>
2765               </indexterm> <indexterm>
2766                 <primary>AFS initialization script</primary>
2767
2768                 <secondary>running</secondary>
2769
2770                 <tertiary>server machine after first</tertiary>
2771               </indexterm> <indexterm>
2772                 <primary>file server machine, additional</primary>
2773
2774                 <secondary>AFS initialization script</secondary>
2775               </indexterm> <indexterm>
2776                 <primary>running AFS init. script</primary>
2777
2778                 <secondary>server machine after first</secondary>
2779               </indexterm> <indexterm>
2780                 <primary>installing</primary>
2781
2782                 <secondary>AFS initialization script</secondary>
2783
2784                 <tertiary>server machine after first</tertiary>
2785               </indexterm> <indexterm>
2786                 <primary>AIX</primary>
2787
2788                 <secondary>AFS initialization script</secondary>
2789
2790                 <tertiary>on add'l server machine</tertiary>
2791               </indexterm></para>
2792           </listitem>
2793
2794           <listitem>
2795             <para>Run the AFS initialization script by issuing the appropriate commands for this system type.</para>
2796
2797             <para><emphasis role="bold">On AIX systems:</emphasis> <orderedlist>
2798                 <listitem>
2799                   <para>Reboot the machine and log in again as the local superuser <emphasis role="bold">root</emphasis>.
2800                   <programlisting>
2801    # <emphasis role="bold">cd /</emphasis>
2802    # <emphasis role="bold">shutdown -r now</emphasis>
2803    login: <emphasis role="bold">root</emphasis>
2804    Password: <replaceable>root_password</replaceable>
2805 </programlisting></para>
2806                 </listitem>
2807
2808                 <listitem>
2809                   <para>Run the AFS initialization script. <programlisting>
2810    # <emphasis role="bold">/etc/rc.afs</emphasis>
2811 </programlisting></para>
2812                 </listitem>
2813
2814                 <listitem>
2815                   <para>Edit the AIX initialization file, <emphasis role="bold">/etc/inittab</emphasis>, adding the following line
2816                   to invoke the AFS initialization script. Place it just after the line that starts NFS daemons. <programlisting>
2817    rcafs:2:wait:/etc/rc.afs &gt; /dev/console 2&gt;&amp;1 # Start AFS services
2818 </programlisting></para>
2819                 </listitem>
2820
2821                 <listitem>
2822                   <para><emphasis role="bold">(Optional)</emphasis> There are now copies of the AFS initialization file in both the
2823                   <emphasis role="bold">/usr/vice/etc</emphasis> and <emphasis role="bold">/etc</emphasis> directories. If you want
2824                   to avoid potential confusion by guaranteeing that they are always the same, create a link between them. You can
2825                   always retrieve the original script from the AFS CD-ROM if necessary. <programlisting>
2826    # <emphasis role="bold">cd  /usr/vice/etc</emphasis>
2827    # <emphasis role="bold">rm  rc.afs</emphasis>
2828    # <emphasis role="bold">ln -s  /etc/rc.afs</emphasis>
2829 </programlisting></para>
2830                 </listitem>
2831
2832                 <listitem>
2833                   <para>Proceed to Step <link linkend="LIWQ113">4</link>.</para>
2834                 </listitem>
2835               </orderedlist></para>
2836
2837             <indexterm>
2838               <primary>Digital UNIX</primary>
2839
2840               <secondary>AFS initialization script</secondary>
2841
2842               <tertiary>on add'l server machine</tertiary>
2843             </indexterm>
2844
2845             <para><emphasis role="bold">On Digital UNIX systems:</emphasis> <orderedlist>
2846                 <listitem>
2847                   <para>Run the AFS initialization script. <programlisting>
2848    # <emphasis role="bold">/sbin/init.d/afs  start</emphasis>
2849 </programlisting></para>
2850                 </listitem>
2851
2852                 <listitem>
2853                   <para>Change to the <emphasis role="bold">/sbin/init.d</emphasis> directory and issue the <emphasis role="bold">ln
2854                   -s</emphasis> command to create symbolic links that incorporate the AFS initialization script into the Digital
2855                   UNIX startup and shutdown sequence. <programlisting>
2856    # <emphasis role="bold">cd  /sbin/init.d</emphasis>
2857    # <emphasis role="bold">ln -s  ../init.d/afs  /sbin/rc3.d/S67afs</emphasis>
2858    # <emphasis role="bold">ln -s  ../init.d/afs  /sbin/rc0.d/K66afs</emphasis>
2859 </programlisting></para>
2860                 </listitem>
2861
2862                 <listitem>
2863                   <para><emphasis role="bold">(Optional)</emphasis> There are now copies of the AFS initialization file in both the
2864                   <emphasis role="bold">/usr/vice/etc</emphasis> and <emphasis role="bold">/sbin/init.d</emphasis> directories. If
2865                   you want to avoid potential confusion by guaranteeing that they are always the same, create a link between them.
2866                   You can always retrieve the original script from the AFS CD-ROM if necessary. <programlisting>
2867    # <emphasis role="bold">cd /usr/vice/etc</emphasis>
2868    # <emphasis role="bold">rm afs.rc</emphasis>
2869    # <emphasis role="bold">ln -s  /sbin/init.d/afs  afs.rc</emphasis>
2870 </programlisting></para>
2871                 </listitem>
2872
2873                 <listitem>
2874                   <para>Proceed to Step <link linkend="LIWQ113">4</link>.</para>
2875                 </listitem>
2876               </orderedlist></para>
2877
2878             <indexterm>
2879               <primary>HP-UX</primary>
2880
2881               <secondary>AFS initialization script</secondary>
2882
2883               <tertiary>on add'l server machine</tertiary>
2884             </indexterm>
2885
2886             <para><emphasis role="bold">On HP-UX systems:</emphasis> <orderedlist>
2887                 <listitem>
2888                   <para>Run the AFS initialization script. <programlisting>
2889    # <emphasis role="bold">/sbin/init.d/afs  start</emphasis>
2890 </programlisting></para>
2891                 </listitem>
2892
2893                 <listitem>
2894                   <para>Change to the <emphasis role="bold">/sbin/init.d</emphasis> directory and issue the <emphasis role="bold">ln
2895                   -s</emphasis> command to create symbolic links that incorporate the AFS initialization script into the HP-UX
2896                   startup and shutdown sequence. <programlisting>
2897    # <emphasis role="bold">cd /sbin/init.d</emphasis>
2898    # <emphasis role="bold">ln -s ../init.d/afs /sbin/rc2.d/S460afs</emphasis>
2899    # <emphasis role="bold">ln -s ../init.d/afs /sbin/rc2.d/K800afs</emphasis>
2900 </programlisting></para>
2901                 </listitem>
2902
2903                 <listitem>
2904                   <para><emphasis role="bold">(Optional)</emphasis> There are now copies of the AFS initialization file in both the
2905                   <emphasis role="bold">/usr/vice/etc</emphasis> and <emphasis role="bold">/sbin/init.d</emphasis> directories. If
2906                   you want to avoid potential confusion by guaranteeing that they are always the same, create a link between them.
2907                   You can always retrieve the original script from the AFS CD-ROM if necessary. <programlisting>
2908    # <emphasis role="bold">cd /usr/vice/etc</emphasis>
2909    # <emphasis role="bold">rm afs.rc</emphasis>
2910    # <emphasis role="bold">ln -s  /sbin/init.d/afs  afs.rc</emphasis>
2911 </programlisting></para>
2912                 </listitem>
2913
2914                 <listitem>
2915                   <para>Proceed to Step <link linkend="LIWQ113">4</link>.</para>
2916                 </listitem>
2917               </orderedlist></para>
2918
2919             <indexterm>
2920               <primary>IRIX</primary>
2921
2922               <secondary>AFS initialization script</secondary>
2923
2924               <tertiary>on add'l server machine</tertiary>
2925             </indexterm>
2926
2927             <indexterm>
2928               <primary>afsclient variable (IRIX)</primary>
2929
2930               <secondary>server machine after first</secondary>
2931             </indexterm>
2932
2933             <indexterm>
2934               <primary>variables</primary>
2935
2936               <secondary>afsclient (IRIX)</secondary>
2937
2938               <tertiary>server machine after first</tertiary>
2939             </indexterm>
2940
2941             <indexterm>
2942               <primary>IRIX</primary>
2943
2944               <secondary>afsclient variable</secondary>
2945
2946               <tertiary>server machine after first</tertiary>
2947             </indexterm>
2948
2949             <indexterm>
2950               <primary>afsserver variable (IRIX)</primary>
2951
2952               <secondary>server machine after first</secondary>
2953             </indexterm>
2954
2955             <indexterm>
2956               <primary>variables</primary>
2957
2958               <secondary>afsserver (IRIX)</secondary>
2959
2960               <tertiary>server machine after first</tertiary>
2961             </indexterm>
2962
2963             <indexterm>
2964               <primary>IRIX</primary>
2965
2966               <secondary>afsserver variable</secondary>
2967
2968               <tertiary>server machine after first</tertiary>
2969             </indexterm>
2970
2971             <para><emphasis role="bold">On IRIX systems:</emphasis> <orderedlist>
2972                 <listitem>
2973                   <para>If you have configured the machine to use the <emphasis role="bold">ml</emphasis> dynamic loader program,
2974                   reboot the machine and log in again as the local superuser <emphasis role="bold">root</emphasis>. <programlisting>
2975    # <emphasis role="bold">cd /</emphasis>
2976    # <emphasis role="bold">shutdown -i6 -g0 -y</emphasis>
2977    login: <emphasis role="bold">root</emphasis>
2978    Password: <replaceable>root_password</replaceable>
2979 </programlisting></para>
2980                 </listitem>
2981
2982                 <listitem>
2983                   <para>Issue the <emphasis role="bold">chkconfig</emphasis> command to activate the <emphasis
2984                   role="bold">afsserver</emphasis> configuration variable. <programlisting>
2985    # <emphasis role="bold">/etc/chkconfig -f afsserver on</emphasis>   
2986 </programlisting></para>
2987
2988                   <para>If you have configured this machine as an AFS client and want to it remain one, also issue the <emphasis
2989                   role="bold">chkconfig</emphasis> command to activate the <emphasis role="bold">afsclient</emphasis> configuration
2990                   variable.</para>
2991
2992                   <programlisting>
2993    # <emphasis role="bold">/etc/chkconfig -f afsclient on</emphasis> 
2994 </programlisting>
2995                 </listitem>
2996
2997                 <listitem>
2998                   <para>Run the AFS initialization script. <programlisting>
2999    # <emphasis role="bold">/etc/init.d/afs  start</emphasis>
3000 </programlisting></para>
3001                 </listitem>
3002
3003                 <listitem>
3004                   <para>Change to the <emphasis role="bold">/etc/init.d</emphasis> directory and issue the <emphasis role="bold">ln
3005                   -s</emphasis> command to create symbolic links that incorporate the AFS initialization script into the IRIX
3006                   startup and shutdown sequence. <programlisting>
3007    # <emphasis role="bold">cd /etc/init.d</emphasis>
3008    # <emphasis role="bold">ln -s ../init.d/afs /etc/rc2.d/S35afs</emphasis>
3009    # <emphasis role="bold">ln -s ../init.d/afs /etc/rc0.d/K35afs</emphasis>
3010 </programlisting></para>
3011                 </listitem>
3012
3013                 <listitem>
3014                   <para><emphasis role="bold">(Optional)</emphasis> There are now copies of the AFS initialization file in both the
3015                   <emphasis role="bold">/usr/vice/etc</emphasis> and <emphasis role="bold">/etc/init.d</emphasis> directories. If
3016                   you want to avoid potential confusion by guaranteeing that they are always the same, create a link between them.
3017                   You can always retrieve the original script from the AFS CD-ROM if necessary. <programlisting>
3018    # <emphasis role="bold">cd /usr/vice/etc</emphasis>
3019    # <emphasis role="bold">rm afs.rc</emphasis>
3020    # <emphasis role="bold">ln -s  /etc/init.d/afs  afs.rc</emphasis>
3021 </programlisting></para>
3022                 </listitem>
3023
3024                 <listitem>
3025                   <para>Proceed to Step <link linkend="LIWQ113">4</link>.</para>
3026                 </listitem>
3027               </orderedlist></para>
3028
3029             <indexterm>
3030               <primary>Linux</primary>
3031
3032               <secondary>AFS initialization script</secondary>
3033
3034               <tertiary>on add'l server machine</tertiary>
3035             </indexterm>
3036
3037             <para><emphasis role="bold">On Linux systems:</emphasis> <orderedlist>
3038                 <listitem>
3039                   <para>Reboot the machine and log in again as the local superuser <emphasis role="bold">root</emphasis>.
3040                   <programlisting>
3041    # <emphasis role="bold">cd /</emphasis>
3042    # <emphasis role="bold">shutdown -r now</emphasis>
3043    login: <emphasis role="bold">root</emphasis>
3044    Password: <replaceable>root_password</replaceable>
3045 </programlisting></para>
3046                 </listitem>
3047
3048                 <listitem>
3049                   <para>Run the AFS initialization script. <programlisting>
3050    # <emphasis role="bold">/etc/rc.d/init.d/afs  start</emphasis>
3051 </programlisting></para>
3052                 </listitem>
3053
3054                 <listitem>
3055                   <para>Issue the <emphasis role="bold">chkconfig</emphasis> command to activate the <emphasis
3056                   role="bold">afs</emphasis> configuration variable. Based on the instruction in the AFS initialization file that
3057                   begins with the string <computeroutput>#chkconfig</computeroutput>, the command automatically creates the symbolic
3058                   links that incorporate the script into the Linux startup and shutdown sequence. <programlisting>
3059    # <emphasis role="bold">/sbin/chkconfig  --add afs</emphasis>
3060 </programlisting></para>
3061                 </listitem>
3062
3063                 <listitem>
3064                   <para><emphasis role="bold">(Optional)</emphasis> There are now copies of the AFS initialization file in both the
3065                   <emphasis role="bold">/usr/vice/etc</emphasis> and <emphasis role="bold">/etc/rc.d/init.d</emphasis> directories,
3066                   and copies of the <emphasis role="bold">afsd</emphasis> options file in both the <emphasis
3067                   role="bold">/usr/vice/etc</emphasis> and <emphasis role="bold">/etc/sysconfig</emphasis> directories. If you want
3068                   to avoid potential confusion by guaranteeing that the two copies of each file are always the same, create a link
3069                   between them. You can always retrieve the original script or options file from the AFS CD-ROM if necessary.
3070                   <programlisting>
3071    # <emphasis role="bold">cd /usr/vice/etc</emphasis>
3072    # <emphasis role="bold">rm afs.rc afs.conf</emphasis>
3073    # <emphasis role="bold">ln -s  /etc/rc.d/init.d/afs  afs.rc</emphasis>
3074    # <emphasis role="bold">ln -s  /etc/sysconfig/afs  afs.conf</emphasis>
3075 </programlisting></para>
3076                 </listitem>
3077
3078                 <listitem>
3079                   <para>Proceed to Step <link linkend="LIWQ113">4</link>.</para>
3080                 </listitem>
3081               </orderedlist></para>
3082
3083             <indexterm>
3084               <primary>Solaris</primary>
3085
3086               <secondary>AFS initialization script</secondary>
3087
3088               <tertiary>on add'l server machine</tertiary>
3089             </indexterm>
3090
3091             <para><emphasis role="bold">On Solaris systems:</emphasis> <orderedlist>
3092                 <listitem>
3093                   <para>Reboot the machine and log in again as the local superuser <emphasis role="bold">root</emphasis>.
3094                   <programlisting>
3095    # <emphasis role="bold">cd /</emphasis>
3096    # <emphasis role="bold">shutdown -i6 -g0 -y</emphasis>
3097    login: <emphasis role="bold">root</emphasis>
3098    Password: <replaceable>root_password</replaceable>
3099 </programlisting></para>
3100                 </listitem>
3101
3102                 <listitem>
3103                   <para>Run the AFS initialization script. <programlisting>
3104    # <emphasis role="bold">/etc/init.d/afs  start</emphasis>
3105 </programlisting></para>
3106                 </listitem>
3107
3108                 <listitem>
3109                   <para>Change to the <emphasis role="bold">/etc/init.d</emphasis> directory and issue the <emphasis role="bold">ln
3110                   -s</emphasis> command to create symbolic links that incorporate the AFS initialization script into the Solaris
3111                   startup and shutdown sequence. <programlisting>
3112    # <emphasis role="bold">cd /etc/init.d</emphasis>
3113    # <emphasis role="bold">ln -s ../init.d/afs /etc/rc3.d/S99afs</emphasis>
3114    # <emphasis role="bold">ln -s ../init.d/afs /etc/rc0.d/K66afs</emphasis>
3115 </programlisting></para>
3116                 </listitem>
3117
3118                 <listitem>
3119                   <para><emphasis role="bold">(Optional)</emphasis> There are now copies of the AFS initialization file in both the
3120                   <emphasis role="bold">/usr/vice/etc</emphasis> and <emphasis role="bold">/etc/init.d</emphasis> directories. If
3121                   you want to avoid potential confusion by guaranteeing that they are always the same, create a link between them.
3122                   You can always retrieve the original script from the AFS CD-ROM if necessary. <programlisting>
3123    # <emphasis role="bold">cd /usr/vice/etc</emphasis>
3124    # <emphasis role="bold">rm afs.rc</emphasis>
3125    # <emphasis role="bold">ln -s  /etc/init.d/afs  afs.rc</emphasis>
3126 </programlisting></para>
3127                 </listitem>
3128               </orderedlist></para>
3129           </listitem>
3130
3131           <listitem>
3132             <para><anchor id="LIWQ113" />Verify that <emphasis role="bold">/usr/afs</emphasis> and its subdirectories on the new
3133             file server machine meet the ownership and mode bit requirements outlined in <link linkend="HDRWQ96">Protecting
3134             Sensitive AFS Directories</link>. If necessary, use the <emphasis role="bold">chmod</emphasis> command to correct the
3135             mode bits.</para>
3136           </listitem>
3137
3138           <listitem>
3139             <para>To configure this machine as a database server machine, proceed to <link linkend="HDRWQ114">Installing Database
3140             Server Functionality</link>.</para>
3141           </listitem>
3142         </orderedlist></para>
3143
3144       <indexterm>
3145         <primary>database server machine</primary>
3146
3147         <secondary>requirements for installation</secondary>
3148       </indexterm>
3149
3150       <indexterm>
3151         <primary>requirements</primary>
3152
3153         <secondary>database server machine</secondary>
3154       </indexterm>
3155     </sect2>
3156   </sect1>
3157
3158   <sect1 id="HDRWQ114">
3159     <title>Installing Database Server Functionality</title>
3160
3161     <para>This section explains how to install database server functionality. Database server machines have two defining
3162     characteristics. First, they run the Authentication Server, Protection Server, and Volume Location (VL) Server processes. They
3163     also run the Backup Server if the cell uses the AFS Backup System, as is assumed in these instructions. Second, they appear in
3164     the <emphasis role="bold">CellServDB</emphasis> file of every machine in the cell (and of client machines in foreign cells, if
3165     they are to access files in this cell).</para>
3166
3167     <para>Note the following requirements for database server machines. <itemizedlist>
3168         <listitem>
3169           <para>In the conventional configuration, database server machines also serve as file server machines (run the File Server,
3170           Volume Server and Salvager processes). If you choose not to run file server functionality on a database server machine,
3171           then the kernel does not have to incorporate AFS modifications, but the local <emphasis role="bold">/usr/afs</emphasis>
3172           directory must house most of the standard files and subdirectories. In particular, the <emphasis
3173           role="bold">/usr/afs/etc/KeyFile</emphasis> file must contain the same keys as all other server machines in the cell. If
3174           you run a system control machine, run the <emphasis role="bold">upclientetc</emphasis> process on every database server
3175           machine other than the system control machine; if you do not run a system control machine, use the <emphasis
3176           role="bold">bos addkey</emphasis> command as instructed in the chapter in the <emphasis>IBM AFS Administration
3177           Guide</emphasis> about maintaining server encryption keys.</para>
3178
3179           <para>The instructions in this section assume that the machine on which you are installing database server functionality
3180           is already a file server machine. Contact the AFS Product Support group to learn how to install database server
3181           functionality on a non-file server machine.</para>
3182         </listitem>
3183
3184         <listitem>
3185           <para>During the installation of database server functionality, you must restart all of the database server machines to
3186           force the election of a new Ubik coordinator (synchronization site) for each database server process. This can cause a
3187           system outage, which usually lasts less than 5 minutes.</para>
3188         </listitem>
3189
3190         <listitem>
3191           <para>Updating the kernel memory list of database server machines on each client machine is generally the most
3192           time-consuming part of installing a new database server machine. It is, however, crucial for correct functioning in your
3193           cell. Incorrect knowledge of your cell's database server machines can prevent your users from authenticating, accessing
3194           files, and issuing AFS commands.</para>
3195
3196           <para>You update a client's kernel memory list by changing the <emphasis role="bold">/usr/vice/etc/CellServDB</emphasis>
3197           file and then either rebooting or issuing the <emphasis role="bold">fs newcell</emphasis> command. For instructions, see
3198           the chapter in the <emphasis>IBM AFS Administration Guide</emphasis> about administering client machines.</para>
3199
3200           <para>The point at which you update your clients' knowledge of database server machines depends on which of the database
3201           server machines has the lowest IP address. The following instructions indicate the appropriate place to update your client
3202           machines in either case. <itemizedlist>
3203               <listitem>
3204                 <para>If the new database server machine has a lower IP address than any existing database server machine, update
3205                 the <emphasis role="bold">CellServDB</emphasis> file on every client machine before restarting the database server
3206                 processes. If you do not, users can become unable to update (write to) any of the AFS databases. This is because the
3207                 machine with the lowest IP address is usually elected as the Ubik coordinator, and only the Coordinator accepts
3208                 database writes. On client machines that do not have the new list of database server machines, the Cache Manager
3209                 cannot locate the new coordinator. (Be aware that if clients contact the new coordinator before it is actually in
3210                 service, they experience a timeout before contacting another database server machine. This is a minor, and
3211                 temporary, problem compared to being unable to write to the database.)</para>
3212               </listitem>
3213
3214               <listitem>
3215                 <para>If the new database server machine does not have the lowest IP address of any database server machine, then it
3216                 is better to update clients after restarting the database server processes. Client machines do not start using the
3217                 new database server machine until you update their kernel memory list, but that does not usually cause timeouts or
3218                 update problems (because the new machine is not likely to become the coordinator).</para>
3219               </listitem>
3220             </itemizedlist></para>
3221         </listitem>
3222       </itemizedlist></para>
3223
3224     <indexterm>
3225       <primary>overview</primary>
3226
3227       <secondary>installing additional database server machine</secondary>
3228     </indexterm>
3229
3230     <sect2 id="Header_110">
3231       <title>Summary of Procedures</title>
3232
3233       <para>To install a database server machine, perform the following procedures. <orderedlist>
3234           <listitem>
3235             <para>Install the <emphasis role="bold">bos</emphasis> suite of commands locally, as a precaution</para>
3236           </listitem>
3237
3238           <listitem>
3239             <para>Add the new machine to the <emphasis role="bold">/usr/afs/etc/CellServDB</emphasis> file on existing file server
3240             machines</para>
3241           </listitem>
3242
3243           <listitem>
3244             <para>Update your cell's central <emphasis role="bold">CellServDB</emphasis> source file and the file you make available
3245             to foreign cells</para>
3246           </listitem>
3247
3248           <listitem>
3249             <para>Update every client machine's <emphasis role="bold">/usr/vice/etc/CellServDB</emphasis> file and kernel memory
3250             list of database server machines</para>
3251           </listitem>
3252
3253           <listitem>
3254             <para>Start the database server processes (Authentication Server, Backup Server, Protection Server, and Volume Location
3255             Server)</para>
3256           </listitem>
3257
3258           <listitem>
3259             <para>Restart the database server processes on every database server machine</para>
3260           </listitem>
3261
3262           <listitem>
3263             <para>Notify the AFS Product Support group that you have installed a new database server machine</para>
3264           </listitem>
3265         </orderedlist></para>
3266
3267       <indexterm>
3268         <primary>database server machine</primary>
3269
3270         <secondary>installing</secondary>
3271
3272         <tertiary>additional</tertiary>
3273       </indexterm>
3274
3275       <indexterm>
3276         <primary>instructions</primary>
3277
3278         <secondary>database server machine, installing additional</secondary>
3279       </indexterm>
3280
3281       <indexterm>
3282         <primary>installing</primary>
3283
3284         <secondary>database server machine</secondary>
3285
3286         <tertiary>additional</tertiary>
3287       </indexterm>
3288     </sect2>
3289
3290     <sect2 id="Header_111">
3291       <title>Instructions</title>
3292
3293       <note>
3294         <para>It is assumed that your PATH environment variable includes the directory that houses the AFS command binaries. If not,
3295         you possibly need to precede the command names with the appropriate pathname.</para>
3296       </note>
3297
3298       <orderedlist>
3299         <listitem>
3300           <para>You can perform the following instructions on either a server or client machine. Login as an AFS administrator who
3301           is listed in the <emphasis role="bold">/usr/afs/etc/UserList</emphasis> file on all server machines. <programlisting>
3302    % <emphasis role="bold">klog</emphasis> <replaceable>admin_user</replaceable>
3303    Password: <replaceable>admin_password</replaceable>
3304 </programlisting></para>
3305         </listitem>
3306
3307         <listitem>
3308           <para>If you are working on a client machine configured in the conventional manner, the <emphasis
3309           role="bold">bos</emphasis> command suite resides in the <emphasis role="bold">/usr/afsws/bin</emphasis> directory, a
3310           symbolic link to an AFS directory. An error during installation can potentially block access to AFS, in which case it is
3311           helpful to have a copy of the <emphasis role="bold">bos</emphasis> binary on the local disk. This step is not necessary if
3312           you are working on a server machine, where the binary resides in the local <emphasis role="bold">/usr/afs/bin</emphasis>
3313           directory. <programlisting>
3314    % <emphasis role="bold">cp  /usr/afsws/bin/bos   /tmp</emphasis>
3315 </programlisting> <indexterm>
3316               <primary>bos commands</primary>
3317
3318               <secondary>addhost</secondary>
3319             </indexterm> <indexterm>
3320               <primary>commands</primary>
3321
3322               <secondary>bos addhost</secondary>
3323             </indexterm> <indexterm>
3324               <primary>database server machine</primary>
3325
3326               <secondary>entry in server CellServDB file</secondary>
3327
3328               <tertiary>for new db-server machine</tertiary>
3329             </indexterm> <indexterm>
3330               <primary>CellServDB file (server)</primary>
3331
3332               <secondary>adding entry for new db-server machine</secondary>
3333             </indexterm> <indexterm>
3334               <primary>adding</primary>
3335
3336               <secondary>new db-server machine to CellServDB files</secondary>
3337             </indexterm></para>
3338         </listitem>
3339
3340         <listitem>
3341           <para><anchor id="LIWQ115" />Issue the <emphasis role="bold">bos addhost</emphasis> command to add the new database server
3342           machine to the <emphasis role="bold">/usr/afs/etc/CellServDB</emphasis> file on existing server machines (as well as the
3343           new database server machine itself).</para>
3344
3345           <para>Substitute the new database server machine's fully-qualified hostname for the <replaceable>host name</replaceable>
3346           argument. If you run a system control machine, substitute its fully-qualified hostname for the
3347           <replaceable>machine&nbsp;name</replaceable> argument. If you do not run a system control machine, repeat the <emphasis
3348           role="bold">bos addhost</emphasis> command once for each server machine in your cell (including the new database server
3349           machine itself), by substituting each one's fully-qualified hostname for the <replaceable>machine&nbsp;name</replaceable>
3350           argument in turn.</para>
3351
3352           <programlisting>
3353    % <emphasis role="bold">bos addhost</emphasis> &lt;<replaceable>machine name</replaceable>&gt;  &lt;<replaceable>host name</replaceable>&gt;   
3354 </programlisting>
3355
3356           <para>If you run a system control machine, wait for the Update Server to distribute the new <emphasis
3357           role="bold">CellServDB</emphasis> file, which takes up to five minutes by default. If you are issuing individual <emphasis
3358           role="bold">bos addhost</emphasis> commands, attempt to issue all of them within five minutes.</para>
3359
3360           <note>
3361             <para>It is best to maintain a one-to-one mapping between hostnames and IP addresses on a multihomed database server
3362             machine (the conventional configuration for any AFS machine). The BOS Server uses the <emphasis
3363             role="bold">gethostbyname(&nbsp;)</emphasis> routine to obtain the IP address associated with the <replaceable>host
3364             name</replaceable> argument. If there is more than one address, the BOS Server records in the <emphasis
3365             role="bold">CellServDB</emphasis> entry the one that appears first in the list of addresses returned by the routine. The
3366             routine possibly returns addresses in a different order on different machines, which can create inconsistency.</para>
3367           </note>
3368         </listitem>
3369
3370         <listitem>
3371           <para><emphasis role="bold">(Optional)</emphasis> Issue the <emphasis role="bold">bos listhosts</emphasis> command on each
3372           server machine to verify that the new database server machine appears in its <emphasis role="bold">CellServDB</emphasis>
3373           file. <programlisting>
3374    % <emphasis role="bold">bos listhosts</emphasis> &lt;<replaceable>machine name</replaceable>&gt;
3375 </programlisting></para>
3376         </listitem>
3377
3378         <listitem>
3379           <para><anchor id="LIWQ116" />Add the new database server machine to your cell's central <emphasis
3380           role="bold">CellServDB</emphasis> source file, if you use one. The standard location is <emphasis
3381           role="bold">/afs/</emphasis><replaceable>cellname</replaceable><emphasis
3382           role="bold">/common/etc/CellServDB</emphasis>.</para>
3383
3384           <para>If you are willing to make your cell accessible to users in foreign cells, add the new database server machine to
3385           the file that lists your cell's database server machines. The conventional location is <emphasis
3386           role="bold">/afs/</emphasis><replaceable>cellname</replaceable><emphasis
3387           role="bold">/service/etc/CellServDB.local</emphasis>. <indexterm>
3388               <primary>database server machine</primary>
3389
3390               <secondary>entry in client CellServDB file</secondary>
3391
3392               <tertiary>for new db-server machine</tertiary>
3393             </indexterm> <indexterm>
3394               <primary>CellServDB file (client)</primary>
3395
3396               <secondary>adding entry</secondary>
3397
3398               <tertiary>for new db-server machine</tertiary>
3399             </indexterm> <indexterm>
3400               <primary>client machine</primary>
3401
3402               <secondary>CellServDB file</secondary>
3403
3404               <tertiary>adding entry</tertiary>
3405             </indexterm></para>
3406         </listitem>
3407
3408         <listitem>
3409           <para><anchor id="LIWQ117" />If this machine's IP address is lower than any existing database server machine's, update
3410           every client machine's <emphasis role="bold">/usr/vice/etc/CellServDB</emphasis> file and kernel memory list to include
3411           this machine. (If this machine's IP address is not the lowest, it is acceptable to wait until Step <link
3412           linkend="LIWQ123">12</link>.)</para>
3413
3414           <para>There are several ways to update the <emphasis role="bold">CellServDB</emphasis> file on client machines, as
3415           detailed in the chapter of the <emphasis>IBM AFS Administration Guide</emphasis> about administering client machines. One
3416           option is to copy over the central update source (which you updated in Step <link linkend="LIWQ116">5</link>), with or
3417           without using the <emphasis role="bold">package</emphasis> program. To update the machine's kernel memory list, you can
3418           either reboot after changing the <emphasis role="bold">CellServDB</emphasis> file or issue the <emphasis role="bold">fs
3419           newcell</emphasis> command. <indexterm>
3420               <primary>Authentication Server</primary>
3421
3422               <secondary>starting</secondary>
3423
3424               <tertiary>new db-server machine</tertiary>
3425             </indexterm> <indexterm>
3426               <primary>starting</primary>
3427
3428               <secondary>Authentication Server</secondary>
3429
3430               <tertiary>new db-server machine</tertiary>
3431             </indexterm> <indexterm>
3432               <primary>database server machine</primary>
3433
3434               <secondary>starting database server processes</secondary>
3435             </indexterm> <indexterm>
3436               <primary>BosConfig file</primary>
3437
3438               <secondary>adding entries</secondary>
3439
3440               <tertiary>database server machine</tertiary>
3441             </indexterm> <indexterm>
3442               <primary>adding</primary>
3443
3444               <secondary>entries to BosConfig file</secondary>
3445
3446               <tertiary>database server machine</tertiary>
3447             </indexterm></para>
3448         </listitem>
3449
3450         <listitem>
3451           <para><anchor id="LIWQ118" />Start the Authentication Server (the <emphasis role="bold">kaserver</emphasis> process).
3452           <programlisting>
3453    % <emphasis role="bold">bos create</emphasis> &lt;<replaceable>machine name</replaceable>&gt; <emphasis role="bold">kaserver simple /usr/afs/bin/kaserver</emphasis>
3454 </programlisting> <indexterm>
3455               <primary>Backup Server</primary>
3456
3457               <secondary>starting</secondary>
3458
3459               <tertiary>new db-server machine</tertiary>
3460             </indexterm> <indexterm>
3461               <primary>starting</primary>
3462
3463               <secondary>Backup Server</secondary>
3464
3465               <tertiary>new db-server machine</tertiary>
3466             </indexterm></para>
3467         </listitem>
3468
3469         <listitem>
3470           <para><anchor id="LIWQ119" />Start the Backup Server (the <emphasis role="bold">buserver</emphasis> process). You must
3471           perform other configuration procedures before actually using the AFS Backup System, as detailed in the <emphasis>IBM AFS
3472           Administration Guide</emphasis>. <programlisting>
3473    % <emphasis role="bold">bos create</emphasis> &lt;<replaceable>machine name</replaceable>&gt; <emphasis role="bold">buserver simple /usr/afs/bin/buserver</emphasis>
3474 </programlisting> <indexterm>
3475               <primary>Protection Server</primary>
3476
3477               <secondary>starting</secondary>
3478
3479               <tertiary>new db-server machine</tertiary>
3480             </indexterm> <indexterm>
3481               <primary>starting</primary>
3482
3483               <secondary>Protection Server</secondary>
3484
3485               <tertiary>new db-server machine</tertiary>
3486             </indexterm></para>
3487         </listitem>
3488
3489         <listitem>
3490           <para><anchor id="LIWQ120" />Start the Protection Server (the <emphasis role="bold">ptserver</emphasis> process).
3491           <programlisting>
3492    % <emphasis role="bold">bos create</emphasis> &lt;<replaceable>machine name</replaceable>&gt; <emphasis role="bold">ptserver simple /usr/afs/bin/ptserver</emphasis>
3493 </programlisting> <indexterm>
3494               <primary>VL Server (vlserver process)</primary>
3495
3496               <secondary>starting</secondary>
3497
3498               <tertiary>new db-server machine</tertiary>
3499             </indexterm> <indexterm>
3500               <primary>starting</primary>
3501
3502               <secondary>VL Server</secondary>
3503
3504               <tertiary>new db-server machine</tertiary>
3505             </indexterm></para>
3506         </listitem>
3507
3508         <listitem>
3509           <para><anchor id="LIWQ121" />Start the Volume Location (VL) Server (the <emphasis role="bold">vlserver</emphasis>
3510           process). <programlisting>
3511    % <emphasis role="bold">bos create</emphasis> &lt;<replaceable>machine name</replaceable>&gt; <emphasis role="bold">vlserver simple /usr/afs/bin/vlserver</emphasis>
3512 </programlisting> <indexterm>
3513               <primary>commands</primary>
3514
3515               <secondary>bos restart</secondary>
3516
3517               <tertiary>on new db-server machine</tertiary>
3518             </indexterm> <indexterm>
3519               <primary>bos commands</primary>
3520
3521               <secondary>restart</secondary>
3522
3523               <tertiary>on new db-server machine</tertiary>
3524             </indexterm> &l