doc/xml/QuickStartUnix/c5467.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >Installing Additional Server Machines</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
   9 REL="HOME"
  10 TITLE="AFS Quick Beginnings"
  11 HREF="book1.html"><LINK
  12 REL="PREVIOUS"
  13 TITLE="Installing the First AFS Machine"
  14 HREF="c371.html"><LINK
  15 REL="NEXT"
  16 TITLE="Installing Additional Client Machines"
  17 HREF="c8044.html"></HEAD
  18 ><BODY
  19 CLASS="chapter"
  20 BGCOLOR="#FFFFFF"
  21 TEXT="#000000"
  22 LINK="#0000FF"
  23 VLINK="#840084"
  24 ALINK="#0000FF"
  25 ><DIV
  26 CLASS="NAVHEADER"
  27 ><TABLE
  28 SUMMARY="Header navigation table"
  29 WIDTH="100%"
  30 BORDER="0"
  31 CELLPADDING="0"
  32 CELLSPACING="0"
  33 ><TR
  34 ><TH
  35 COLSPAN="3"
  36 ALIGN="center"
  37 >AFS Quick Beginnings: Version 3.6</TH
  38 ></TR
  39 ><TR
  40 ><TD
  41 WIDTH="10%"
  42 ALIGN="left"
  43 VALIGN="bottom"
  44 ><A
  45 HREF="c371.html"
  46 ACCESSKEY="P"
  47 >Prev</A
  48 ></TD
  49 ><TD
  50 WIDTH="80%"
  51 ALIGN="center"
  52 VALIGN="bottom"
  53 ></TD
  54 ><TD
  55 WIDTH="10%"
  56 ALIGN="right"
  57 VALIGN="bottom"
  58 ><A
  59 HREF="c8044.html"
  60 ACCESSKEY="N"
  61 >Next</A
  62 ></TD
  63 ></TR
  64 ></TABLE
  65 ><HR
  66 ALIGN="LEFT"
  67 WIDTH="100%"></DIV
  68 ><DIV
  69 CLASS="chapter"
  70 ><H1
  71 ><A
  72 NAME="HDRWQ99"
  73 ></A
  74 >Chapter 3. Installing Additional Server Machines</H1
  75 ><P
  76 >Instructions for the following procedures appear in the indicated section of this chapter. <UL
  77 ><LI
  78 ><P
  79 ><A
  80 HREF="c5467.html#HDRWQ100"
  81 >Installing an Additional File Server Machine</A
  82 ></P
  83 ></LI
  84 ><LI
  85 ><P
  86 ><A
  87 HREF="c5467.html#HDRWQ114"
  88 >Installing Database Server Functionality</A
  89 ></P
  90 ></LI
  91 ><LI
  92 ><P
  93 ><A
  94 HREF="c5467.html#HDRWQ125"
  95 >Removing Database Server Functionality</A
  96 ></P
  97 ></LI
  98 ></UL
  99 ></P
 100 ><P
 101 >The instructions make the following assumptions. <UL
 102 ><LI
 103 ><P
 104 >You have already installed your cell's first file server machine by following the instructions in <A
 105 HREF="c371.html"
 106 >Installing the First AFS Machine</A
 107 ></P
 108 ></LI
 109 ><LI
 110 ><P
 111 >You are logged in as the local superuser <SPAN
 112 CLASS="bold"
 113 ><B
 114 CLASS="emphasis"
 115 >root</B
 116 ></SPAN
 117 ></P
 118 ></LI
 119 ><LI
 120 ><P
 121 >You are working at the console</P
 122 ></LI
 123 ><LI
 124 ><P
 125 >A standard version of one of the operating systems supported by the current version of AFS is running on the
 126         machine</P
 127 ></LI
 128 ><LI
 129 ><P
 130 >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
 131         attached to a machine that is accessible by network</P
 132 ></LI
 133 ></UL
 134 ></P
 135 ><DIV
 136 CLASS="sect1"
 137 ><H1
 138 CLASS="sect1"
 139 ><A
 140 NAME="HDRWQ100"
 141 >Installing an Additional File Server Machine</A
 142 ></H1
 143 ><P
 144 >The procedure for installing a new file server machine is similar to installing the first file server machine in your
 145     cell. There are a few parts of the installation that differ depending on whether the machine is the same AFS system type as an
 146     existing file server machine or is the first file server machine of its system type in your cell. The differences mostly concern
 147     the source for the needed binaries and files, and what portions of the Update Server you install: <UL
 148 ><LI
 149 ><P
 150 >On a new system type, you must load files and binaries from the AFS CD-ROM. You install the server portion of the
 151           Update Server to make this machine the binary distribution machine for its system type.</P
 152 ></LI
 153 ><LI
 154 ><P
 155 >On an existing system type, you can copy files and binaries from a previously installed file server machine, rather
 156           than from the CD-ROM. You install the client portion of the Update Server to accept updates of binaries, because a
 157           previously installed machine of this type was installed as the binary distribution machine.</P
 158 ></LI
 159 ></UL
 160 ></P
 161 ><P
 162 >These instructions are brief; for more detailed information, refer to the corresponding steps in <A
 163 HREF="c371.html"
 164 >Installing the First AFS Machine</A
 165 >. </P
 166 ><P
 167 >To install a new file server machine, perform the following procedures: <OL
 168 TYPE="1"
 169 ><LI
 170 ><P
 171 >Copy needed binaries and files onto this machine's local disk</P
 172 ></LI
 173 ><LI
 174 ><P
 175 >Incorporate AFS modifications into the kernel</P
 176 ></LI
 177 ><LI
 178 ><P
 179 >Configure partitions for storing volumes</P
 180 ></LI
 181 ><LI
 182 ><P
 183 >Replace the standard <SPAN
 184 CLASS="bold"
 185 ><B
 186 CLASS="emphasis"
 187 >fsck</B
 188 ></SPAN
 189 > utility with the AFS-modified version on some system
 190           types</P
 191 ></LI
 192 ><LI
 193 ><P
 194 >Start the Basic OverSeer (BOS) Server</P
 195 ></LI
 196 ><LI
 197 ><P
 198 >Start the appropriate portion of the Update Server</P
 199 ></LI
 200 ><LI
 201 ><P
 202 >Start the <SPAN
 203 CLASS="bold"
 204 ><B
 205 CLASS="emphasis"
 206 >fs</B
 207 ></SPAN
 208 > process, which incorporates three component processes: the File
 209           Server, Volume Server, and Salvager</P
 210 ></LI
 211 ><LI
 212 ><P
 213 >Start the controller process (called <SPAN
 214 CLASS="bold"
 215 ><B
 216 CLASS="emphasis"
 217 >runntp</B
 218 ></SPAN
 219 >) for the Network Time Protocol Daemon,
 220           which synchronizes clocks</P
 221 ></LI
 222 ></OL
 223 ></P
 224 ><P
 225 >After completing the instructions in this section, you can install database server functionality on the machine according
 226     to the instructions in <A
 227 HREF="c5467.html#HDRWQ114"
 228 >Installing Database Server Functionality</A
 229 >.             </P
 230 ><DIV
 231 CLASS="sect2"
 232 ><H2
 233 CLASS="sect2"
 234 ><A
 235 NAME="Header_99"
 236 >Creating AFS Directories and Performing Platform-Specific Procedures</A
 237 ></H2
 238 ><P
 239 >Create the <SPAN
 240 CLASS="bold"
 241 ><B
 242 CLASS="emphasis"
 243 >/usr/afs</B
 244 ></SPAN
 245 > and <SPAN
 246 CLASS="bold"
 247 ><B
 248 CLASS="emphasis"
 249 >/usr/vice/etc</B
 250 ></SPAN
 251 > directories on
 252       the local disk. Subsequent instructions copy files from the AFS distribution CD-ROM into them, at the appropriate point for
 253       each system type.</P
 254 ><PRE
 255 CLASS="programlisting"
 256 >&#13;   # <SPAN
 257 CLASS="bold"
 258 ><B
 259 CLASS="emphasis"
 260 >mkdir /usr/afs</B
 261 ></SPAN
 262 >
 263    # <SPAN
 264 CLASS="bold"
 265 ><B
 266 CLASS="emphasis"
 267 >mkdir /usr/afs/bin</B
 268 ></SPAN
 269 >
 270    # <SPAN
 271 CLASS="bold"
 272 ><B
 273 CLASS="emphasis"
 274 >mkdir /usr/vice</B
 275 ></SPAN
 276 >
 277    # <SPAN
 278 CLASS="bold"
 279 ><B
 280 CLASS="emphasis"
 281 >mkdir /usr/vice/etc</B
 282 ></SPAN
 283 >
 284    # <SPAN
 285 CLASS="bold"
 286 ><B
 287 CLASS="emphasis"
 288 >mkdir /cdrom</B
 289 ></SPAN
 290 >
 291 </PRE
 292 ><P
 293 >As on the first file server machine, the initial procedures in installing an additional file server machine vary a good
 294       deal from platform to platform. For convenience, the following sections group together all of the procedures for a system
 295       type. Most of the remaining procedures are the same on every system type, but differences are noted as appropriate. The
 296       initial procedures are the following. <UL
 297 ><LI
 298 ><P
 299 >Incorporate AFS modifications into the kernel, either by using a dynamic kernel loader program or by building a
 300             new static kernel</P
 301 ></LI
 302 ><LI
 303 ><P
 304 >Configure server partitions to house AFS volumes</P
 305 ></LI
 306 ><LI
 307 ><P
 308 >Replace the operating system vendor's <SPAN
 309 CLASS="bold"
 310 ><B
 311 CLASS="emphasis"
 312 >fsck</B
 313 ></SPAN
 314 > program with a version that recognizes
 315             AFS data </P
 316 ></LI
 317 ><LI
 318 ><P
 319 >If the machine is to remain an AFS client machine, modify the machine's authentication system so that users obtain
 320             an AFS token as they log into the local file system. (For this procedure only, the instructions direct you to the
 321             platform-specific section in <A
 322 HREF="c371.html"
 323 >Installing the First AFS Machine</A
 324 >.)</P
 325 ></LI
 326 ></UL
 327 ></P
 328 ><P
 329 >To continue, proceed to the section for this system type: <UL
 330 ><LI
 331 ><P
 332 ><A
 333 HREF="c5467.html#HDRWQ101"
 334 >Getting Started on AIX Systems</A
 335 ></P
 336 ></LI
 337 ><LI
 338 ><P
 339 ><A
 340 HREF="c5467.html#HDRWQ102"
 341 >Getting Started on Digital UNIX Systems</A
 342 ></P
 343 ></LI
 344 ><LI
 345 ><P
 346 ><A
 347 HREF="c5467.html#HDRWQ103"
 348 >Getting Started on HP-UX Systems</A
 349 ></P
 350 ></LI
 351 ><LI
 352 ><P
 353 ><A
 354 HREF="c5467.html#HDRWQ104"
 355 >Getting Started on IRIX Systems</A
 356 ></P
 357 ></LI
 358 ><LI
 359 ><P
 360 ><A
 361 HREF="c5467.html#HDRWQ106"
 362 >Getting Started on Linux Systems</A
 363 ></P
 364 ></LI
 365 ><LI
 366 ><P
 367 ><A
 368 HREF="c5467.html#HDRWQ107"
 369 >Getting Started on Solaris Systems</A
 370 ></P
 371 ></LI
 372 ></UL
 373 ></P
 374 ><DIV
 375 CLASS="sect3"
 376 ><H3
 377 CLASS="sect3"
 378 ><A
 379 NAME="HDRWQ101"
 380 >Getting Started on AIX Systems</A
 381 ></H3
 382 ><P
 383 >Begin by running the AFS initialization script to call the AIX kernel extension facility, which dynamically loads AFS
 384         modifications into the kernel. Then configure partitions and replace the AIX <SPAN
 385 CLASS="bold"
 386 ><B
 387 CLASS="emphasis"
 388 >fsck</B
 389 ></SPAN
 390 > program
 391         with a version that correctly handles AFS volumes. <OL
 392 TYPE="1"
 393 ><LI
 394 ><P
 395 >Mount the AFS CD-ROM for AIX on the local <SPAN
 396 CLASS="bold"
 397 ><B
 398 CLASS="emphasis"
 399 >/cdrom</B
 400 ></SPAN
 401 > directory. For instructions on
 402               mounting CD-ROMs (either locally or remotely via NFS), see your AIX documentation. Then change directory as indicated.
 403               <PRE
 404 CLASS="programlisting"
 405 >&#13;   # <SPAN
 406 CLASS="bold"
 407 ><B
 408 CLASS="emphasis"
 409 >cd  /cdrom/rs_aix42/root.client/usr/vice/etc</B
 410 ></SPAN
 411 >
 412 </PRE
 413 ></P
 414 ></LI
 415 ><LI
 416 ><P
 417 >Copy the AFS kernel library files to the local <SPAN
 418 CLASS="bold"
 419 ><B
 420 CLASS="emphasis"
 421 >/usr/vice/etc/dkload</B
 422 ></SPAN
 423 > directory,
 424               and the AFS initialization script to the <SPAN
 425 CLASS="bold"
 426 ><B
 427 CLASS="emphasis"
 428 >/etc</B
 429 ></SPAN
 430 > directory. <PRE
 431 CLASS="programlisting"
 432 >&#13;   # <SPAN
 433 CLASS="bold"
 434 ><B
 435 CLASS="emphasis"
 436 >cp -rp  dkload  /usr/vice/etc</B
 437 ></SPAN
 438 >
 439    # <SPAN
 440 CLASS="bold"
 441 ><B
 442 CLASS="emphasis"
 443 >cp -p  rc.afs  /etc/rc.afs</B
 444 ></SPAN
 445 >
 446 </PRE
 447 ></P
 448 ></LI
 449 ><LI
 450 ><P
 451 >Edit the <SPAN
 452 CLASS="bold"
 453 ><B
 454 CLASS="emphasis"
 455 >/etc/rc.afs</B
 456 ></SPAN
 457 > script, setting the <SAMP
 458 CLASS="computeroutput"
 459 >NFS</SAMP
 460 >
 461               variable as indicated.</P
 462 ><P
 463 >If the machine is not to function as an NFS/AFS Translator, set the <SAMP
 464 CLASS="computeroutput"
 465 >NFS</SAMP
 466 >
 467               variable as follows.</P
 468 ><PRE
 469 CLASS="programlisting"
 470 >&#13;   NFS=$NFS_NONE
 471 </PRE
 472 ><P
 473 >If the machine is to function as an NFS/AFS Translator and is running AIX 4.2.1 or higher, set the
 474               <SAMP
 475 CLASS="computeroutput"
 476 >NFS</SAMP
 477 > variable as follows. Note that NFS must already be loaded into the kernel, which
 478               happens automatically on systems running AIX 4.1.1 and later, as long as the file <SPAN
 479 CLASS="bold"
 480 ><B
 481 CLASS="emphasis"
 482 >/etc/exports</B
 483 ></SPAN
 484 > exists.</P
 485 ><PRE
 486 CLASS="programlisting"
 487 >&#13;   NFS=$NFS_IAUTH
 488 </PRE
 489 ></LI
 490 ><LI
 491 ><P
 492 >Invoke the <SPAN
 493 CLASS="bold"
 494 ><B
 495 CLASS="emphasis"
 496 >/etc/rc.afs</B
 497 ></SPAN
 498 > script to load AFS modifications into the kernel. You
 499               can ignore any error messages about the inability to start the BOS Server or the Cache Manager or AFS client.
 500               <PRE
 501 CLASS="programlisting"
 502 >&#13;   # <SPAN
 503 CLASS="bold"
 504 ><B
 505 CLASS="emphasis"
 506 >/etc/rc.afs</B
 507 ></SPAN
 508 >
 509 </PRE
 510 >    </P
 511 ></LI
 512 ><LI
 513 ><P
 514 >Create a directory called <SPAN
 515 CLASS="bold"
 516 ><B
 517 CLASS="emphasis"
 518 >/vicep</B
 519 ></SPAN
 520 ><VAR
 521 CLASS="replaceable"
 522 >xx</VAR
 523 > for each AFS
 524               server partition you are configuring (there must be at least one). Repeat the command for each partition.
 525               <PRE
 526 CLASS="programlisting"
 527 >&#13;   # <SPAN
 528 CLASS="bold"
 529 ><B
 530 CLASS="emphasis"
 531 >mkdir /vicep</B
 532 ></SPAN
 533 ><VAR
 534 CLASS="replaceable"
 535 >xx</VAR
 536 >
 537 </PRE
 538 ></P
 539 ></LI
 540 ><LI
 541 ><P
 542 >Use the <SPAN
 543 CLASS="bold"
 544 ><B
 545 CLASS="emphasis"
 546 >SMIT</B
 547 ></SPAN
 548 > program to create a journaling file system on each partition to be
 549               configured as an AFS server partition.</P
 550 ></LI
 551 ><LI
 552 ><P
 553 >Mount each partition at one of the <SPAN
 554 CLASS="bold"
 555 ><B
 556 CLASS="emphasis"
 557 >/vicep</B
 558 ></SPAN
 559 ><VAR
 560 CLASS="replaceable"
 561 >xx</VAR
 562 >
 563               directories. Choose one of the following three methods: <UL
 564 ><LI
 565 ><P
 566 >Use the <SPAN
 567 CLASS="bold"
 568 ><B
 569 CLASS="emphasis"
 570 >SMIT</B
 571 ></SPAN
 572 > program</P
 573 ></LI
 574 ><LI
 575 ><P
 576 >Use the <SPAN
 577 CLASS="bold"
 578 ><B
 579 CLASS="emphasis"
 580 >mount -a</B
 581 ></SPAN
 582 > command to mount all partitions at once</P
 583 ></LI
 584 ><LI
 585 ><P
 586 >Use the <SPAN
 587 CLASS="bold"
 588 ><B
 589 CLASS="emphasis"
 590 >mount</B
 591 ></SPAN
 592 > command on each partition in turn</P
 593 ></LI
 594 ></UL
 595 ></P
 596 ><P
 597 >Also configure the partitions so that they are mounted automatically at each reboot. For more information, refer
 598               to the AIX documentation.    </P
 599 ></LI
 600 ><LI
 601 ><P
 602 >Move the AIX <SPAN
 603 CLASS="bold"
 604 ><B
 605 CLASS="emphasis"
 606 >fsck</B
 607 ></SPAN
 608 > program helper to a safe location and install the version
 609               from the AFS distribution in its place. The AFS CD-ROM must still be mounted at the <SPAN
 610 CLASS="bold"
 611 ><B
 612 CLASS="emphasis"
 613 >/cdrom</B
 614 ></SPAN
 615 > directory. <PRE
 616 CLASS="programlisting"
 617 >&#13;   # <SPAN
 618 CLASS="bold"
 619 ><B
 620 CLASS="emphasis"
 621 >cd /sbin/helpers</B
 622 ></SPAN
 623 >
 624    # <SPAN
 625 CLASS="bold"
 626 ><B
 627 CLASS="emphasis"
 628 >mv v3fshelper v3fshelper.noafs</B
 629 ></SPAN
 630 >
 631    # <SPAN
 632 CLASS="bold"
 633 ><B
 634 CLASS="emphasis"
 635 >cp -p /cdrom/rs_aix42/root.server/etc/v3fshelper v3fshelper</B
 636 ></SPAN
 637 >
 638 </PRE
 639 ></P
 640 ></LI
 641 ><LI
 642 ><P
 643 >If the machine is to remain an AFS client, incorporate AFS into its authentication system, following the
 644               instructions in <A
 645 HREF="c371.html#HDRWQ25"
 646 >Enabling AFS Login on AIX Systems</A
 647 >.</P
 648 ></LI
 649 ><LI
 650 ><P
 651 >Proceed to <A
 652 HREF="c5467.html#HDRWQ108"
 653 >Starting Server Programs</A
 654 >.</P
 655 ></LI
 656 ></OL
 657 ></P
 658 ></DIV
 659 ><DIV
 660 CLASS="sect3"
 661 ><H3
 662 CLASS="sect3"
 663 ><A
 664 NAME="HDRWQ102"
 665 >Getting Started on Digital UNIX Systems</A
 666 ></H3
 667 ><P
 668 >Begin by building AFS modifications into the kernel, then configure server partitions and replace the Digital UNIX
 669         <SPAN
 670 CLASS="bold"
 671 ><B
 672 CLASS="emphasis"
 673 >fsck</B
 674 ></SPAN
 675 > program with a version that correctly handles AFS volumes.</P
 676 ><P
 677 >If the machine's hardware and software configuration exactly matches another Digital UNIX machine on which AFS is
 678         already built into the kernel, you can copy the kernel from that machine to this one. In general, however, it is better to
 679         build AFS modifications into the kernel on each machine according to the following instructions. <OL
 680 TYPE="1"
 681 ><LI
 682 ><P
 683 >Create a copy called <SPAN
 684 CLASS="bold"
 685 ><B
 686 CLASS="emphasis"
 687 >AFS</B
 688 ></SPAN
 689 > of the basic kernel configuration file included in the
 690               Digital UNIX distribution as <SPAN
 691 CLASS="bold"
 692 ><B
 693 CLASS="emphasis"
 694 >/usr/sys/conf/</B
 695 ></SPAN
 696 ><VAR
 697 CLASS="replaceable"
 698 >machine_name</VAR
 699 >,
 700               where <VAR
 701 CLASS="replaceable"
 702 >machine_name</VAR
 703 > is the machine's hostname in all uppercase letters. <PRE
 704 CLASS="programlisting"
 705 >&#13;   # <SPAN
 706 CLASS="bold"
 707 ><B
 708 CLASS="emphasis"
 709 >cd /usr/sys/conf</B
 710 ></SPAN
 711 >
 712    # <SPAN
 713 CLASS="bold"
 714 ><B
 715 CLASS="emphasis"
 716 >cp</B
 717 ></SPAN
 718 > <VAR
 719 CLASS="replaceable"
 720 >machine_name</VAR
 721 > <SPAN
 722 CLASS="bold"
 723 ><B
 724 CLASS="emphasis"
 725 >AFS</B
 726 ></SPAN
 727 >
 728 </PRE
 729 ></P
 730 ></LI
 731 ><LI
 732 ><P
 733 >Add AFS to the list of options in the configuration file you created in the previous step, so that the result
 734               looks like the following: <PRE
 735 CLASS="programlisting"
 736 >&#13;          .                   .
 737           .                   .
 738        options               UFS
 739        options               NFS
 740        options               AFS
 741           .                   .
 742           .                   .
 743 </PRE
 744 ></P
 745 ></LI
 746 ><LI
 747 ><P
 748 >Add an entry for AFS to two places in the file <SPAN
 749 CLASS="bold"
 750 ><B
 751 CLASS="emphasis"
 752 >/usr/sys/conf/files</B
 753 ></SPAN
 754 >.
 755               <UL
 756 ><LI
 757 ><P
 758 >Add a line for AFS to the list of <SAMP
 759 CLASS="computeroutput"
 760 >OPTIONS</SAMP
 761 >, so that the result looks like
 762                     the following: <PRE
 763 CLASS="programlisting"
 764 >&#13;             .                .      .
 765              .                .      .
 766       OPTIONS/nfs          optional nfs
 767       OPTIONS/afs          optional afs
 768       OPTIONS/nfs_server   optional nfs_server
 769              .                .      .
 770              .                .      .
 771 </PRE
 772 ></P
 773 ></LI
 774 ><LI
 775 ><P
 776 >Add an entry for AFS to the list of <SAMP
 777 CLASS="computeroutput"
 778 >MODULES</SAMP
 779 >, so that the result looks
 780                     like the following: <PRE
 781 CLASS="programlisting"
 782 >&#13;             .                  .        .          .
 783              .                  .        .          .
 784       #
 785       MODULE/nfs_server     optional nfs_server Binary
 786       nfs/nfs_server.c      module nfs_server optimize -g3
 787       nfs/nfs3_server.c     module nfs_server optimize -g3
 788       #
 789       MODULE/afs            optional afs Binary
 790       afs/libafs.c          module afs
 791       #
 792 </PRE
 793 ></P
 794 ></LI
 795 ></UL
 796 ></P
 797 ></LI
 798 ><LI
 799 ><P
 800 >Add an entry for AFS to two places in the file <SPAN
 801 CLASS="bold"
 802 ><B
 803 CLASS="emphasis"
 804 >/usr/sys/vfs/vfs_conf.c</B
 805 ></SPAN
 806 >.
 807               <UL
 808 ><LI
 809 ><P
 810 >Add AFS to the list of defined file systems, so that the result looks like the following: <PRE
 811 CLASS="programlisting"
 812 >&#13;        .       .
 813         .       .
 814      #include &#60;afs.h&#62;
 815      #if defined(AFS) &#38;&#38; AFS
 816             extern struct vfsops afs_vfsops;
 817      #endif
 818         .       .
 819         .       .
 820 </PRE
 821 ></P
 822 ></LI
 823 ><LI
 824 ><P
 825 >Put a declaration for AFS in the <SPAN
 826 CLASS="bold"
 827 ><B
 828 CLASS="emphasis"
 829 >vfssw[]</B
 830 ></SPAN
 831 > table's MOUNT_ADDON slot, so
 832                     that the result looks like the following: <PRE
 833 CLASS="programlisting"
 834 >&#13;        .                          .              .
 835         .                          .              .
 836       &#38;fdfs_vfsops,         "fdfs",   /* 12 = MOUNT_FDFS */
 837    #if  defined(AFS)
 838       &#38;afs_vfsops,          "afs",
 839    #else
 840       (struct vfsops *)0,   "",       /* 13 = MOUNT_ADDON */
 841    #endif
 842    #if NFS &#38;&#38; INFS_DYNAMIC
 843        &#38;nfs3_vfsops,        "nfsv3",  /* 14 = MOUNT_NFS3 */
 844 </PRE
 845 ></P
 846 ></LI
 847 ></UL
 848 ></P
 849 ></LI
 850 ><LI
 851 ><P
 852 >Mount the AFS CD-ROM for Digital UNIX on the local <SPAN
 853 CLASS="bold"
 854 ><B
 855 CLASS="emphasis"
 856 >/cdrom</B
 857 ></SPAN
 858 > directory. For
 859               instructions on mounting CD-ROMs (either locally or remotely via NFS), see your Digital UNIX documentation. Then
 860               change directory as indicated. <PRE
 861 CLASS="programlisting"
 862 >&#13;   # <SPAN
 863 CLASS="bold"
 864 ><B
 865 CLASS="emphasis"
 866 >cd /cdrom/alpha_dux40/root.client</B
 867 ></SPAN
 868 >
 869 </PRE
 870 ></P
 871 ></LI
 872 ><LI
 873 ><P
 874 >Copy the AFS initialization script to the local directory for initialization files (by convention, <SPAN
 875 CLASS="bold"
 876 ><B
 877 CLASS="emphasis"
 878 >/sbin/init.d</B
 879 ></SPAN
 880 > on Digital UNIX machines). Note the removal of the <SPAN
 881 CLASS="bold"
 882 ><B
 883 CLASS="emphasis"
 884 >.rc</B
 885 ></SPAN
 886 > extension as you copy the script. <PRE
 887 CLASS="programlisting"
 888 >&#13;   # <SPAN
 889 CLASS="bold"
 890 ><B
 891 CLASS="emphasis"
 892 >cp usr/vice/etc/afs.rc  /sbin/init.d/afs</B
 893 ></SPAN
 894 >
 895 </PRE
 896 ></P
 897 ></LI
 898 ><LI
 899 ><P
 900 >Copy the AFS kernel module to the local <SPAN
 901 CLASS="bold"
 902 ><B
 903 CLASS="emphasis"
 904 >/usr/sys/BINARY</B
 905 ></SPAN
 906 > directory.</P
 907 ><P
 908 >If the machine's kernel supports NFS server functionality:</P
 909 ><PRE
 910 CLASS="programlisting"
 911 >&#13;   # <SPAN
 912 CLASS="bold"
 913 ><B
 914 CLASS="emphasis"
 915 >cp bin/libafs.o /usr/sys/BINARY/afs.mod</B
 916 ></SPAN
 917 >
 918 </PRE
 919 ><P
 920 >If the machine's kernel does not support NFS server functionality:</P
 921 ><PRE
 922 CLASS="programlisting"
 923 >&#13;   # <SPAN
 924 CLASS="bold"
 925 ><B
 926 CLASS="emphasis"
 927 >cp bin/libafs.nonfs.o /usr/sys/BINARY/afs.mod</B
 928 ></SPAN
 929 >
 930 </PRE
 931 ></LI
 932 ><LI
 933 ><P
 934 >Configure and build the kernel. Respond to any prompts by pressing &#60;<SPAN
 935 CLASS="bold"
 936 ><B
 937 CLASS="emphasis"
 938 >Return</B
 939 ></SPAN
 940 >&#62;. The resulting kernel resides in the file <SPAN
 941 CLASS="bold"
 942 ><B
 943 CLASS="emphasis"
 944 >/sys/AFS/vmunix</B
 945 ></SPAN
 946 >. <PRE
 947 CLASS="programlisting"
 948 >&#13;   # <SPAN
 949 CLASS="bold"
 950 ><B
 951 CLASS="emphasis"
 952 >doconfig -c AFS</B
 953 ></SPAN
 954 >
 955 </PRE
 956 ></P
 957 ></LI
 958 ><LI
 959 ><P
 960 >Rename the existing kernel file and copy the new, AFS-modified file to the standard location. <PRE
 961 CLASS="programlisting"
 962 >&#13;   # <SPAN
 963 CLASS="bold"
 964 ><B
 965 CLASS="emphasis"
 966 >mv /vmunix /vmunix_noafs</B
 967 ></SPAN
 968 >
 969    # <SPAN
 970 CLASS="bold"
 971 ><B
 972 CLASS="emphasis"
 973 >cp /sys/AFS/vmunix /vmunix</B
 974 ></SPAN
 975 >
 976 </PRE
 977 ></P
 978 ></LI
 979 ><LI
 980 ><P
 981 >Reboot the machine to start using the new kernel, and login again as the superuser <SPAN
 982 CLASS="bold"
 983 ><B
 984 CLASS="emphasis"
 985 >root</B
 986 ></SPAN
 987 >. <PRE
 988 CLASS="programlisting"
 989 >&#13;   # <SPAN
 990 CLASS="bold"
 991 ><B
 992 CLASS="emphasis"
 993 >cd /</B
 994 ></SPAN
 995 >
 996    # <SPAN
 997 CLASS="bold"
 998 ><B
 999 CLASS="emphasis"
1000 >shutdown -r now</B
1001 ></SPAN
1002 >
1003    login: <SPAN
1004 CLASS="bold"
1005 ><B
1006 CLASS="emphasis"
1007 >root</B
1008 ></SPAN
1009 >
1010    Password: <VAR
1011 CLASS="replaceable"
1012 >root_password</VAR
1013 >
1014 </PRE
1015 >    </P
1016 ></LI
1017 ><LI
1018 ><P
1019 >Create a directory called <SPAN
1020 CLASS="bold"
1021 ><B
1022 CLASS="emphasis"
1023 >/vicep</B
1024 ></SPAN
1025 ><VAR
1026 CLASS="replaceable"
1027 >xx</VAR
1028 > for each AFS
1029               server partition you are configuring (there must be at least one). Repeat the command for each partition.
1030               <PRE
1031 CLASS="programlisting"
1032 >&#13;   # <SPAN
1033 CLASS="bold"
1034 ><B
1035 CLASS="emphasis"
1036 >mkdir /vicep</B
1037 ></SPAN
1038 ><VAR
1039 CLASS="replaceable"
1040 >xx</VAR
1041 >
1042 </PRE
1043 ></P
1044 ></LI
1045 ><LI
1046 ><P
1047 >Add a line with the following format to the file systems registry file, <SPAN
1048 CLASS="bold"
1049 ><B
1050 CLASS="emphasis"
1051 >/etc/fstab</B
1052 ></SPAN
1053 >, for each directory just created. The entry maps the directory name to the disk
1054               partition to be mounted on it. <PRE
1055 CLASS="programlisting"
1056 >&#13;   /dev/<VAR
1057 CLASS="replaceable"
1058 >disk</VAR
1059 > /vicep<VAR
1060 CLASS="replaceable"
1061 >xx</VAR
1062 > ufs rw 0 2
1063 </PRE
1064 ></P
1065 ><P
1066 >The following is an example for the first partition being configured.</P
1067 ><PRE
1068 CLASS="programlisting"
1069 >&#13;   /dev/rz3a /vicepa ufs rw 0 2
1070 </PRE
1071 ></LI
1072 ><LI
1073 ><P
1074 >Create a file system on each partition that is to be mounted at a <SPAN
1075 CLASS="bold"
1076 ><B
1077 CLASS="emphasis"
1078 >/vicep</B
1079 ></SPAN
1080 ><VAR
1081 CLASS="replaceable"
1082 >xx</VAR
1083 > directory. The following command is probably appropriate,
1084               but consult the Digital UNIX documentation for more information. <PRE
1085 CLASS="programlisting"
1086 >&#13;   # <SPAN
1087 CLASS="bold"
1088 ><B
1089 CLASS="emphasis"
1090 >newfs -v /dev/</B
1091 ></SPAN
1092 ><VAR
1093 CLASS="replaceable"
1094 >disk</VAR
1095 >
1096 </PRE
1097 ></P
1098 ></LI
1099 ><LI
1100 ><P
1101 >Mount each partition by issuing either the <SPAN
1102 CLASS="bold"
1103 ><B
1104 CLASS="emphasis"
1105 >mount -a</B
1106 ></SPAN
1107 > command to mount all
1108               partitions at once or the <SPAN
1109 CLASS="bold"
1110 ><B
1111 CLASS="emphasis"
1112 >mount</B
1113 ></SPAN
1114 > command to mount each partition in turn.    </P
1115 ></LI
1116 ><LI
1117 ><P
1118 >Install the <SPAN
1119 CLASS="bold"
1120 ><B
1121 CLASS="emphasis"
1122 >vfsck</B
1123 ></SPAN
1124 > binary to the <SPAN
1125 CLASS="bold"
1126 ><B
1127 CLASS="emphasis"
1128 >/sbin</B
1129 ></SPAN
1130 > and
1131               <SPAN
1132 CLASS="bold"
1133 ><B
1134 CLASS="emphasis"
1135 >/usr/sbin</B
1136 ></SPAN
1137 > directories. The AFS CD-ROM must still be mounted at the <SPAN
1138 CLASS="bold"
1139 ><B
1140 CLASS="emphasis"
1141 >/cdrom</B
1142 ></SPAN
1143 > directory. <PRE
1144 CLASS="programlisting"
1145 >&#13;   # <SPAN
1146 CLASS="bold"
1147 ><B
1148 CLASS="emphasis"
1149 >cd /cdrom/alpha_dux40/root.server/etc</B
1150 ></SPAN
1151 >
1152    # <SPAN
1153 CLASS="bold"
1154 ><B
1155 CLASS="emphasis"
1156 >cp vfsck /sbin/vfsck</B
1157 ></SPAN
1158 >
1159    # <SPAN
1160 CLASS="bold"
1161 ><B
1162 CLASS="emphasis"
1163 >cp vfsck /usr/sbin/vfsck</B
1164 ></SPAN
1165 >
1166 </PRE
1167 ></P
1168 ></LI
1169 ><LI
1170 ><P
1171 >Rename the Digital UNIX <SPAN
1172 CLASS="bold"
1173 ><B
1174 CLASS="emphasis"
1175 >fsck</B
1176 ></SPAN
1177 > binaries and create symbolic links to the
1178               <SPAN
1179 CLASS="bold"
1180 ><B
1181 CLASS="emphasis"
1182 >vfsck</B
1183 ></SPAN
1184 > program. <PRE
1185 CLASS="programlisting"
1186 >&#13;   # <SPAN
1187 CLASS="bold"
1188 ><B
1189 CLASS="emphasis"
1190 >cd /sbin</B
1191 ></SPAN
1192 >
1193    # <SPAN
1194 CLASS="bold"
1195 ><B
1196 CLASS="emphasis"
1197 >mv ufs_fsck ufs_fsck.noafs</B
1198 ></SPAN
1199 >
1200    # <SPAN
1201 CLASS="bold"
1202 ><B
1203 CLASS="emphasis"
1204 >ln -s vfsck ufs_fsck</B
1205 ></SPAN
1206 >
1207    # <SPAN
1208 CLASS="bold"
1209 ><B
1210 CLASS="emphasis"
1211 >cd /usr/sbin</B
1212 ></SPAN
1213 >
1214    # <SPAN
1215 CLASS="bold"
1216 ><B
1217 CLASS="emphasis"
1218 >mv ufs_fsck ufs_fsck.noafs</B
1219 ></SPAN
1220 >
1221    # <SPAN
1222 CLASS="bold"
1223 ><B
1224 CLASS="emphasis"
1225 >ln -s vfsck ufs_fsck</B
1226 ></SPAN
1227 >
1228 </PRE
1229 ></P
1230 ></LI
1231 ><LI
1232 ><P
1233 >If the machine is to remain an AFS client, incorporate AFS into its authentication system, following the
1234               instructions in <A
1235 HREF="c371.html#HDRWQ30"
1236 >Enabling AFS Login on Digital UNIX Systems</A
1237 >.</P
1238 ></LI
1239 ><LI
1240 ><P
1241 >Proceed to <A
1242 HREF="c5467.html#HDRWQ108"
1243 >Starting Server Programs</A
1244 >.</P
1245 ></LI
1246 ></OL
1247 ></P
1248 ></DIV
1249 ><DIV
1250 CLASS="sect3"
1251 ><H3
1252 CLASS="sect3"
1253 ><A
1254 NAME="HDRWQ103"
1255 >Getting Started on HP-UX Systems</A
1256 ></H3
1257 ><P
1258 >Begin by building AFS modifications into the kernel, then configure server partitions and replace the HP-UX <SPAN
1259 CLASS="bold"
1260 ><B
1261 CLASS="emphasis"
1262 >fsck</B
1263 ></SPAN
1264 > program with a version that correctly handles AFS volumes.</P
1265 ><P
1266 >If the machine's hardware and software configuration exactly matches another HP-UX machine on which AFS is already
1267         built into the kernel, you can copy the kernel from that machine to this one. In general, however, it is better to build AFS
1268         modifications into the kernel on each machine according to the following instructions. <OL
1269 TYPE="1"
1270 ><LI
1271 ><P
1272 >Move the existing kernel-related files to a safe location. <PRE
1273 CLASS="programlisting"
1274 >&#13;   # <SPAN
1275 CLASS="bold"
1276 ><B
1277 CLASS="emphasis"
1278 >cp /stand/vmunix /stand/vmunix.noafs</B
1279 ></SPAN
1280 >
1281    # <SPAN
1282 CLASS="bold"
1283 ><B
1284 CLASS="emphasis"
1285 >cp /stand/system /stand/system.noafs</B
1286 ></SPAN
1287 >
1288 </PRE
1289 ></P
1290 ></LI
1291 ><LI
1292 ><P
1293 >Mount the AFS CD-ROM for HP-UX on the local <SPAN
1294 CLASS="bold"
1295 ><B
1296 CLASS="emphasis"
1297 >/cdrom</B
1298 ></SPAN
1299 > directory. For instructions
1300               on mounting CD-ROMs (either locally or remotely via NFS), see your HP-UX documentation. Then change directory as
1301               indicated. <PRE
1302 CLASS="programlisting"
1303 >&#13;   # <SPAN
1304 CLASS="bold"
1305 ><B
1306 CLASS="emphasis"
1307 >cd /cdrom/hp_ux110/root.client</B
1308 ></SPAN
1309 >
1310 </PRE
1311 ></P
1312 ></LI
1313 ><LI
1314 ><P
1315 >Copy the AFS initialization file to the local directory for initialization files (by convention, <SPAN
1316 CLASS="bold"
1317 ><B
1318 CLASS="emphasis"
1319 >/sbin/init.d</B
1320 ></SPAN
1321 > on HP-UX machines). Note the removal of the <SPAN
1322 CLASS="bold"
1323 ><B
1324 CLASS="emphasis"
1325 >.rc</B
1326 ></SPAN
1327 >
1328               extension as you copy the file. <PRE
1329 CLASS="programlisting"
1330 >&#13;   # <SPAN
1331 CLASS="bold"
1332 ><B
1333 CLASS="emphasis"
1334 >cp usr/vice/etc/afs.rc  /sbin/init.d/afs</B
1335 ></SPAN
1336 >
1337 </PRE
1338 ></P
1339 ></LI
1340 ><LI
1341 ><P
1342 >Copy the file <SPAN
1343 CLASS="bold"
1344 ><B
1345 CLASS="emphasis"
1346 >afs.driver</B
1347 ></SPAN
1348 > to the local <SPAN
1349 CLASS="bold"
1350 ><B
1351 CLASS="emphasis"
1352 >/usr/conf/master.d</B
1353 ></SPAN
1354 > directory, changing its name to <SPAN
1355 CLASS="bold"
1356 ><B
1357 CLASS="emphasis"
1358 >afs</B
1359 ></SPAN
1360 > as you
1361               do. <PRE
1362 CLASS="programlisting"
1363 >&#13;   # <SPAN
1364 CLASS="bold"
1365 ><B
1366 CLASS="emphasis"
1367 >cp  usr/vice/etc/afs.driver  /usr/conf/master.d/afs</B
1368 ></SPAN
1369 >
1370 </PRE
1371 ></P
1372 ></LI
1373 ><LI
1374 ><P
1375 >Copy the AFS kernel module to the local <SPAN
1376 CLASS="bold"
1377 ><B
1378 CLASS="emphasis"
1379 >/usr/conf/lib</B
1380 ></SPAN
1381 > directory.</P
1382 ><P
1383 >If the machine's kernel supports NFS server functionality:</P
1384 ><PRE
1385 CLASS="programlisting"
1386 >&#13;   # <SPAN
1387 CLASS="bold"
1388 ><B
1389 CLASS="emphasis"
1390 >cp bin/libafs.a /usr/conf/lib</B
1391 ></SPAN
1392 >
1393 </PRE
1394 ><P
1395 >If the machine's kernel does not support NFS server functionality, change the file's name as you copy it:</P
1396 ><PRE
1397 CLASS="programlisting"
1398 >&#13;   # <SPAN
1399 CLASS="bold"
1400 ><B
1401 CLASS="emphasis"
1402 >cp bin/libafs.nonfs.a /usr/conf/lib/libafs.a</B
1403 ></SPAN
1404 >
1405 </PRE
1406 ></LI
1407 ><LI
1408 ><P
1409 >Incorporate the AFS driver into the kernel, either using the <SPAN
1410 CLASS="bold"
1411 ><B
1412 CLASS="emphasis"
1413 >SAM</B
1414 ></SPAN
1415 > program or a
1416               series of individual commands. <UL
1417 ><LI
1418 ><P
1419 >To use the <SPAN
1420 CLASS="bold"
1421 ><B
1422 CLASS="emphasis"
1423 >SAM</B
1424 ></SPAN
1425 > program: <OL
1426 TYPE="a"
1427 ><LI
1428 ><P
1429 >Invoke the <SPAN
1430 CLASS="bold"
1431 ><B
1432 CLASS="emphasis"
1433 >SAM</B
1434 ></SPAN
1435 > program, specifying the hostname of the local
1436                           machine as <VAR
1437 CLASS="replaceable"
1438 >local_hostname</VAR
1439 >. The <SPAN
1440 CLASS="bold"
1441 ><B
1442 CLASS="emphasis"
1443 >SAM</B
1444 ></SPAN
1445 > graphical
1446                           user interface pops up. <PRE
1447 CLASS="programlisting"
1448 >&#13;   # <SPAN
1449 CLASS="bold"
1450 ><B
1451 CLASS="emphasis"
1452 >sam -display</B
1453 ></SPAN
1454 > <VAR
1455 CLASS="replaceable"
1456 >local_hostname</VAR
1457 ><SPAN
1458 CLASS="bold"
1459 ><B
1460 CLASS="emphasis"
1461 >:0</B
1462 ></SPAN
1463 >
1464 </PRE
1465 ></P
1466 ></LI
1467 ><LI
1468 ><P
1469 >Choose the <SPAN
1470 CLASS="bold"
1471 ><B
1472 CLASS="emphasis"
1473 >Kernel Configuration</B
1474 ></SPAN
1475 > icon, then the <SPAN
1476 CLASS="bold"
1477 ><B
1478 CLASS="emphasis"
1479 >Drivers</B
1480 ></SPAN
1481 > icon. From the list of drivers, select <SPAN
1482 CLASS="bold"
1483 ><B
1484 CLASS="emphasis"
1485 >afs</B
1486 ></SPAN
1487 >.</P
1488 ></LI
1489 ><LI
1490 ><P
1491 >Open the pull-down <SPAN
1492 CLASS="bold"
1493 ><B
1494 CLASS="emphasis"
1495 >Actions</B
1496 ></SPAN
1497 > menu and choose the <SPAN
1498 CLASS="bold"
1499 ><B
1500 CLASS="emphasis"
1501 >Add Driver to Kernel</B
1502 ></SPAN
1503 > option.</P
1504 ></LI
1505 ><LI
1506 ><P
1507 >Open the <SPAN
1508 CLASS="bold"
1509 ><B
1510 CLASS="emphasis"
1511 >Actions</B
1512 ></SPAN
1513 > menu again and choose the <SPAN
1514 CLASS="bold"
1515 ><B
1516 CLASS="emphasis"
1517 >Create a New Kernel</B
1518 ></SPAN
1519 > option.</P
1520 ></LI
1521 ><LI
1522 ><P
1523 >Confirm your choices by choosing <SPAN
1524 CLASS="bold"
1525 ><B
1526 CLASS="emphasis"
1527 >Yes</B
1528 ></SPAN
1529 > and <SPAN
1530 CLASS="bold"
1531 ><B
1532 CLASS="emphasis"
1533 >OK</B
1534 ></SPAN
1535 > when prompted by subsequent pop-up windows. The <SPAN
1536 CLASS="bold"
1537 ><B
1538 CLASS="emphasis"
1539 >SAM</B
1540 ></SPAN
1541 > program builds the kernel and reboots the system.</P
1542 ></LI
1543 ><LI
1544 ><P
1545 >Login again as the superuser <SPAN
1546 CLASS="bold"
1547 ><B
1548 CLASS="emphasis"
1549 >root</B
1550 ></SPAN
1551 >. <PRE
1552 CLASS="programlisting"
1553 >&#13;   login: <SPAN
1554 CLASS="bold"
1555 ><B
1556 CLASS="emphasis"
1557 >root</B
1558 ></SPAN
1559 >
1560    Password: <VAR
1561 CLASS="replaceable"
1562 >root_password</VAR
1563 >
1564 </PRE
1565 ></P
1566 ></LI
1567 ></OL
1568 ></P
1569 ></LI
1570 ><LI
1571 ><P
1572 >To use individual commands: <OL
1573 TYPE="a"
1574 ><LI
1575 ><P
1576 >Edit the file <SPAN
1577 CLASS="bold"
1578 ><B
1579 CLASS="emphasis"
1580 >/stand/system</B
1581 ></SPAN
1582 >, adding an entry for <SPAN
1583 CLASS="bold"
1584 ><B
1585 CLASS="emphasis"
1586 >afs</B
1587 ></SPAN
1588 > to the <SAMP
1589 CLASS="computeroutput"
1590 >Subsystems</SAMP
1591 > section.</P
1592 ></LI
1593 ><LI
1594 ><P
1595 >Change to the <SPAN
1596 CLASS="bold"
1597 ><B
1598 CLASS="emphasis"
1599 >/stand/build</B
1600 ></SPAN
1601 > directory and issue the <SPAN
1602 CLASS="bold"
1603 ><B
1604 CLASS="emphasis"
1605 >mk_kernel</B
1606 ></SPAN
1607 > command to build the kernel. <PRE
1608 CLASS="programlisting"
1609 >&#13;   # <SPAN
1610 CLASS="bold"
1611 ><B
1612 CLASS="emphasis"
1613 >cd /stand/build</B
1614 ></SPAN
1615 >
1616    # <SPAN
1617 CLASS="bold"
1618 ><B
1619 CLASS="emphasis"
1620 >mk_kernel</B
1621 ></SPAN
1622 >
1623 </PRE
1624 ></P
1625 ></LI
1626 ><LI
1627 ><P
1628 >Move the new kernel to the standard location (<SPAN
1629 CLASS="bold"
1630 ><B
1631 CLASS="emphasis"
1632 >/stand/vmunix</B
1633 ></SPAN
1634 >),
1635                           reboot the machine to start using it, and login again as the superuser <SPAN
1636 CLASS="bold"
1637 ><B
1638 CLASS="emphasis"
1639 >root</B
1640 ></SPAN
1641 >. <PRE
1642 CLASS="programlisting"
1643 >&#13;   # <SPAN
1644 CLASS="bold"
1645 ><B
1646 CLASS="emphasis"
1647 >mv /stand/build/vmunix_test /stand/vmunix</B
1648 ></SPAN
1649 >
1650    # <SPAN
1651 CLASS="bold"
1652 ><B
1653 CLASS="emphasis"
1654 >cd /</B
1655 ></SPAN
1656 >
1657    # <SPAN
1658 CLASS="bold"
1659 ><B
1660 CLASS="emphasis"
1661 >shutdown -r now</B
1662 ></SPAN
1663 >
1664    login: <SPAN
1665 CLASS="bold"
1666 ><B
1667 CLASS="emphasis"
1668 >root</B
1669 ></SPAN
1670 >
1671    Password: <VAR
1672 CLASS="replaceable"
1673 >root_password</VAR
1674 >
1675 </PRE
1676 ></P
1677 ></LI
1678 ></OL
1679 ></P
1680 ></LI
1681 ></UL
1682 ></P
1683 ></LI
1684 ><LI
1685 ><P
1686 >Create a directory called <SPAN
1687 CLASS="bold"
1688 ><B
1689 CLASS="emphasis"
1690 >/vicep</B
1691 ></SPAN
1692 ><VAR
1693 CLASS="replaceable"
1694 >xx</VAR
1695 > for each AFS
1696               server partition you are configuring (there must be at least one). Repeat the command for each partition.
1697               <PRE
1698 CLASS="programlisting"
1699 >&#13;   # <SPAN
1700 CLASS="bold"
1701 ><B
1702 CLASS="emphasis"
1703 >mkdir /vicep</B
1704 ></SPAN
1705 ><VAR
1706 CLASS="replaceable"
1707 >xx</VAR
1708 >
1709 </PRE
1710 ></P
1711 ></LI
1712 ><LI
1713 ><P
1714 >Use the <SPAN
1715 CLASS="bold"
1716 ><B
1717 CLASS="emphasis"
1718 >SAM</B
1719 ></SPAN
1720 > program to create a file system on each partition. For
1721               instructions, consult the HP-UX documentation.</P
1722 ></LI
1723 ><LI
1724 ><P
1725 >On some HP-UX systems that use logical volumes, the <SPAN
1726 CLASS="bold"
1727 ><B
1728 CLASS="emphasis"
1729 >SAM</B
1730 ></SPAN
1731 > program automatically
1732               mounts the partitions. If it has not, mount each partition by issuing either the <SPAN
1733 CLASS="bold"
1734 ><B
1735 CLASS="emphasis"
1736 >mount
1737               -a</B
1738 ></SPAN
1739 > command to mount all partitions at once or the <SPAN
1740 CLASS="bold"
1741 ><B
1742 CLASS="emphasis"
1743 >mount</B
1744 ></SPAN
1745 > command to mount
1746               each partition in turn.    </P
1747 ></LI
1748 ><LI
1749 ><P
1750 >Create the command configuration file <SPAN
1751 CLASS="bold"
1752 ><B
1753 CLASS="emphasis"
1754 >/sbin/lib/mfsconfig.d/afs</B
1755 ></SPAN
1756 >. Use a text
1757               editor to place the indicated two lines in it: <PRE
1758 CLASS="programlisting"
1759 >&#13;   format_revision 1
1760    fsck            0        m,P,p,d,f,b:c:y,n,Y,N,q,
1761 </PRE
1762 ></P
1763 ></LI
1764 ><LI
1765 ><P
1766 >Create and change directory to an AFS-specific command directory called <SPAN
1767 CLASS="bold"
1768 ><B
1769 CLASS="emphasis"
1770 >/sbin/fs/afs</B
1771 ></SPAN
1772 >. <PRE
1773 CLASS="programlisting"
1774 >&#13;   # <SPAN
1775 CLASS="bold"
1776 ><B
1777 CLASS="emphasis"
1778 >mkdir /sbin/fs/afs</B
1779 ></SPAN
1780 >
1781    # <SPAN
1782 CLASS="bold"
1783 ><B
1784 CLASS="emphasis"
1785 >cd  /sbin/fs/afs</B
1786 ></SPAN
1787 >
1788 </PRE
1789 ></P
1790 ></LI
1791 ><LI
1792 ><P
1793 >Copy the AFS-modified version of the <SPAN
1794 CLASS="bold"
1795 ><B
1796 CLASS="emphasis"
1797 >fsck</B
1798 ></SPAN
1799 > program (the <SPAN
1800 CLASS="bold"
1801 ><B
1802 CLASS="emphasis"
1803 >vfsck</B
1804 ></SPAN
1805 > binary) and related files from the distribution directory to the new AFS-specific command
1806               directory. <PRE
1807 CLASS="programlisting"
1808 >&#13;   # <SPAN
1809 CLASS="bold"
1810 ><B
1811 CLASS="emphasis"
1812 >cp -p /cdrom/hp_ux110/root.server/etc/*  .</B
1813 ></SPAN
1814 >
1815 </PRE
1816 ></P
1817 ></LI
1818 ><LI
1819 ><P
1820 >Change the <SPAN
1821 CLASS="bold"
1822 ><B
1823 CLASS="emphasis"
1824 >vfsck</B
1825 ></SPAN
1826 > binary's name to <SPAN
1827 CLASS="bold"
1828 ><B
1829 CLASS="emphasis"
1830 >fsck</B
1831 ></SPAN
1832 > and set
1833               the mode bits appropriately on all of the files in the <SPAN
1834 CLASS="bold"
1835 ><B
1836 CLASS="emphasis"
1837 >/sbin/fs/afs</B
1838 ></SPAN
1839 > directory.
1840               <PRE
1841 CLASS="programlisting"
1842 >&#13;   # <SPAN
1843 CLASS="bold"
1844 ><B
1845 CLASS="emphasis"
1846 >mv  vfsck  fsck</B
1847 ></SPAN
1848 >
1849    # <SPAN
1850 CLASS="bold"
1851 ><B
1852 CLASS="emphasis"
1853 >chmod  755  *</B
1854 ></SPAN
1855 >
1856 </PRE
1857 ></P
1858 ></LI
1859 ><LI
1860 ><P
1861 >Edit the <SPAN
1862 CLASS="bold"
1863 ><B
1864 CLASS="emphasis"
1865 >/etc/fstab</B
1866 ></SPAN
1867 > file, changing the file system type for each AFS server
1868               partition from <SAMP
1869 CLASS="computeroutput"
1870 >hfs</SAMP
1871 > to <SAMP
1872 CLASS="computeroutput"
1873 >afs</SAMP
1874 >. This ensures that the
1875               AFS-modified <SPAN
1876 CLASS="bold"
1877 ><B
1878 CLASS="emphasis"
1879 >fsck</B
1880 ></SPAN
1881 > program runs on the appropriate partitions.</P
1882 ><P
1883 >The sixth line in the following example of an edited file shows an AFS server partition, <SPAN
1884 CLASS="bold"
1885 ><B
1886 CLASS="emphasis"
1887 >/vicepa</B
1888 ></SPAN
1889 >.</P
1890 ><PRE
1891 CLASS="programlisting"
1892 >&#13;   /dev/vg00/lvol1 / hfs defaults 0 1
1893    /dev/vg00/lvol4 /opt hfs defaults 0 2
1894    /dev/vg00/lvol5 /tmp hfs defaults 0 2
1895    /dev/vg00/lvol6 /usr hfs defaults 0 2
1896    /dev/vg00/lvol8 /var hfs defaults 0 2
1897    /dev/vg00/lvol9 /vicepa afs defaults 0 2
1898    /dev/vg00/lvol7 /usr/vice/cache hfs defaults 0 2
1899 </PRE
1900 ></LI
1901 ><LI
1902 ><P
1903 >If the machine is to remain an AFS client, incorporate AFS into its authentication system, following the
1904               instructions in <A
1905 HREF="c371.html#HDRWQ35"
1906 >Enabling AFS Login on HP-UX Systems</A
1907 >.</P
1908 ></LI
1909 ><LI
1910 ><P
1911 >Proceed to <A
1912 HREF="c5467.html#HDRWQ108"
1913 >Starting Server Programs</A
1914 >.</P
1915 ></LI
1916 ></OL
1917 ></P
1918 ></DIV
1919 ><DIV
1920 CLASS="sect3"
1921 ><H3
1922 CLASS="sect3"
1923 ><A
1924 NAME="HDRWQ104"
1925 >Getting Started on IRIX Systems</A
1926 ></H3
1927 ><P
1928 >Begin by incorporating AFS modifications into the kernel. Either use the <SPAN
1929 CLASS="bold"
1930 ><B
1931 CLASS="emphasis"
1932 >ml</B
1933 ></SPAN
1934 > dynamic
1935         loader program, or build a static kernel. Then configure partitions to house AFS volumes. AFS supports use of both EFS and
1936         XFS partitions for housing AFS volumes. SGI encourages use of XFS partitions.  </P
1937 ><P
1938 >You do not need to replace IRIX <SPAN
1939 CLASS="bold"
1940 ><B
1941 CLASS="emphasis"
1942 >fsck</B
1943 ></SPAN
1944 > program, because the version that SGI
1945         distributes handles AFS volumes properly. <OL
1946 TYPE="1"
1947 ><LI
1948 ><P
1949 >Prepare for incorporating AFS into the kernel by performing the following procedures. <OL
1950 TYPE="a"
1951 ><LI
1952 ><P
1953 >Mount the AFS CD-ROM for IRIX on the <SPAN
1954 CLASS="bold"
1955 ><B
1956 CLASS="emphasis"
1957 >/cdrom</B
1958 ></SPAN
1959 > directory. For instructions
1960                     on mounting CD-ROMs (either locally or remotely via NFS), see your IRIX documentation. Then change directory as
1961                     indicated. <PRE
1962 CLASS="programlisting"
1963 >&#13;   # <SPAN
1964 CLASS="bold"
1965 ><B
1966 CLASS="emphasis"
1967 >cd  /cdrom/sgi_65/root.client</B
1968 ></SPAN
1969 >
1970 </PRE
1971 ></P
1972 ></LI
1973 ><LI
1974 ><P
1975 >Copy the AFS initialization script to the local directory for initialization files (by convention,
1976                     <SPAN
1977 CLASS="bold"
1978 ><B
1979 CLASS="emphasis"
1980 >/etc/init.d</B
1981 ></SPAN
1982 > on IRIX machines). Note the removal of the <SPAN
1983 CLASS="bold"
1984 ><B
1985 CLASS="emphasis"
1986 >.rc</B
1987 ></SPAN
1988 > extension as you copy the script. <PRE
1989 CLASS="programlisting"
1990 >&#13;   # <SPAN
1991 CLASS="bold"
1992 ><B
1993 CLASS="emphasis"
1994 >cp -p   usr/vice/etc/afs.rc  /etc/init.d/afs</B
1995 ></SPAN
1996 >
1997 </PRE
1998 ></P
1999 ></LI
2000 ><LI
2001 ><P
2002 >Issue the <SPAN
2003 CLASS="bold"
2004 ><B
2005 CLASS="emphasis"
2006 >uname -m</B
2007 ></SPAN
2008 > command to determine the machine's CPU board type. The
2009                     <SPAN
2010 CLASS="bold"
2011 ><B
2012 CLASS="emphasis"
2013 >IP</B
2014 ></SPAN
2015 ><VAR
2016 CLASS="replaceable"
2017 >xx</VAR
2018 > value in the output must match one of the
2019                     supported CPU board types listed in the <SPAN
2020 CLASS="emphasis"
2021 ><I
2022 CLASS="emphasis"
2023 >IBM AFS Release Notes</I
2024 ></SPAN
2025 > for the current version of
2026                     AFS. <PRE
2027 CLASS="programlisting"
2028 >&#13;   # <SPAN
2029 CLASS="bold"
2030 ><B
2031 CLASS="emphasis"
2032 >uname -m</B
2033 ></SPAN
2034 >
2035 </PRE
2036 ></P
2037 ></LI
2038 ></OL
2039 ></P
2040 ></LI
2041 ><LI
2042 ><P
2043 >Incorporate AFS into the kernel, either using the <SPAN
2044 CLASS="bold"
2045 ><B
2046 CLASS="emphasis"
2047 >ml</B
2048 ></SPAN
2049 > program or by building AFS
2050               modifications into a static kernel. <UL
2051 ><LI
2052 ><P
2053 >To use the <SPAN
2054 CLASS="bold"
2055 ><B
2056 CLASS="emphasis"
2057 >ml</B
2058 ></SPAN
2059 > program:       <OL
2060 TYPE="a"
2061 ><LI
2062 ><P
2063 >Create the local <SPAN
2064 CLASS="bold"
2065 ><B
2066 CLASS="emphasis"
2067 >/usr/vice/etc/sgiload</B
2068 ></SPAN
2069 > directory to house the AFS
2070                           kernel library file. <PRE
2071 CLASS="programlisting"
2072 >&#13;   # <SPAN
2073 CLASS="bold"
2074 ><B
2075 CLASS="emphasis"
2076 >mkdir /usr/vice/etc/sgiload</B
2077 ></SPAN
2078 >
2079 </PRE
2080 ></P
2081 ></LI
2082 ><LI
2083 ><P
2084 >Copy the appropriate AFS kernel library file to the <SPAN
2085 CLASS="bold"
2086 ><B
2087 CLASS="emphasis"
2088 >/usr/vice/etc/sgiload</B
2089 ></SPAN
2090 > directory. The <SPAN
2091 CLASS="bold"
2092 ><B
2093 CLASS="emphasis"
2094 >IP</B
2095 ></SPAN
2096 ><VAR
2097 CLASS="replaceable"
2098 >xx</VAR
2099 > portion of the library file name must match the
2100                           value previously returned by the <SPAN
2101 CLASS="bold"
2102 ><B
2103 CLASS="emphasis"
2104 >uname -m</B
2105 ></SPAN
2106 > command. Also choose the file
2107                           appropriate to whether the machine's kernel supports NFS server functionality (NFS must be supported for
2108                           the machine to act as an NFS/AFS Translator). Single- and multiprocessor machines use the same library
2109                           file.</P
2110 ><P
2111 >(You can choose to copy all of the kernel library files into the <SPAN
2112 CLASS="bold"
2113 ><B
2114 CLASS="emphasis"
2115 >/usr/vice/etc/sgiload</B
2116 ></SPAN
2117 > directory, but they require a significant amount of
2118                           space.)</P
2119 ><P
2120 >If the machine's kernel supports NFS server functionality:</P
2121 ><PRE
2122 CLASS="programlisting"
2123 >&#13;   # <SPAN
2124 CLASS="bold"
2125 ><B
2126 CLASS="emphasis"
2127 >cp -p  usr/vice/etc/sgiload/libafs.IP</B
2128 ></SPAN
2129 ><VAR
2130 CLASS="replaceable"
2131 >xx</VAR
2132 ><SPAN
2133 CLASS="bold"
2134 ><B
2135 CLASS="emphasis"
2136 >.o  /usr/vice/etc/sgiload</B
2137 ></SPAN
2138 >
2139 </PRE
2140 ><P
2141 >If the machine's kernel does not support NFS server functionality:</P
2142 ><PRE
2143 CLASS="programlisting"
2144 >&#13;   # <SPAN
2145 CLASS="bold"
2146 ><B
2147 CLASS="emphasis"
2148 >cp -p  usr/vice/etc/sgiload/libafs.IP</B
2149 ></SPAN
2150 ><VAR
2151 CLASS="replaceable"
2152 >xx</VAR
2153 ><SPAN
2154 CLASS="bold"
2155 ><B
2156 CLASS="emphasis"
2157 >.nonfs.o</B
2158 ></SPAN
2159 >   \
2160                    <SPAN
2161 CLASS="bold"
2162 ><B
2163 CLASS="emphasis"
2164 >/usr/vice/etc/sgiload</B
2165 ></SPAN
2166 >
2167 </PRE
2168 ></LI
2169 ><LI
2170 ><P
2171 >Issue the <SPAN
2172 CLASS="bold"
2173 ><B
2174 CLASS="emphasis"
2175 >chkconfig</B
2176 ></SPAN
2177 > command to activate the <SPAN
2178 CLASS="bold"
2179 ><B
2180 CLASS="emphasis"
2181 >afsml</B
2182 ></SPAN
2183 > configuration variable. <PRE
2184 CLASS="programlisting"
2185 >&#13;   # <SPAN
2186 CLASS="bold"
2187 ><B
2188 CLASS="emphasis"
2189 >/etc/chkconfig -f afsml on</B
2190 ></SPAN
2191 >
2192 </PRE
2193 ></P
2194 ><P
2195 >If the machine is to function as an NFS/AFS Translator and the kernel supports NFS server
2196                           functionality, activate the <SPAN
2197 CLASS="bold"
2198 ><B
2199 CLASS="emphasis"
2200 >afsxnfs</B
2201 ></SPAN
2202 > variable.</P
2203 ><PRE
2204 CLASS="programlisting"
2205 >&#13;   # <SPAN
2206 CLASS="bold"
2207 ><B
2208 CLASS="emphasis"
2209 >/etc/chkconfig -f afsxnfs on</B
2210 ></SPAN
2211 >
2212 </PRE
2213 ></LI
2214 ><LI
2215 ><P
2216 >Run the <SPAN
2217 CLASS="bold"
2218 ><B
2219 CLASS="emphasis"
2220 >/etc/init.d/afs</B
2221 ></SPAN
2222 > script to load AFS extensions into the
2223                           kernel. The script invokes the <SPAN
2224 CLASS="bold"
2225 ><B
2226 CLASS="emphasis"
2227 >ml</B
2228 ></SPAN
2229 > command, automatically determining
2230                           which kernel library file to use based on this machine's CPU type and the activation state of the
2231                           <SPAN
2232 CLASS="bold"
2233 ><B
2234 CLASS="emphasis"
2235 >afsxnfs</B
2236 ></SPAN
2237 > variable.</P
2238 ><P
2239 >You can ignore any error messages about the inability to start the BOS Server or the Cache Manager
2240                           or AFS client.</P
2241 ><PRE
2242 CLASS="programlisting"
2243 >&#13;   # <SPAN
2244 CLASS="bold"
2245 ><B
2246 CLASS="emphasis"
2247 >/etc/init.d/afs start</B
2248 ></SPAN
2249 >
2250 </PRE
2251 ></LI
2252 ><LI
2253 ><P
2254 >Proceed to Step <A
2255 HREF="c5467.html#LIWQ105"
2256 >3</A
2257 >.</P
2258 ></LI
2259 ></OL
2260 ></P
2261 ></LI
2262 ><LI
2263 ><P
2264 >If you prefer to build a kernel, and the machine's hardware and software configuration exactly matches
2265                     another IRIX machine on which AFS is already built into the kernel, you can copy the kernel from that machine to
2266                     this one. In general, however, it is better to build AFS modifications into the kernel on each machine according
2267                     to the following instructions. <OL
2268 TYPE="a"
2269 ><LI
2270 ><P
2271 >Copy the kernel initialization file <SPAN
2272 CLASS="bold"
2273 ><B
2274 CLASS="emphasis"
2275 >afs.sm</B
2276 ></SPAN
2277 > to the local <SPAN
2278 CLASS="bold"
2279 ><B
2280 CLASS="emphasis"
2281 >/var/sysgen/system</B
2282 ></SPAN
2283 > directory, and the kernel master file <SPAN
2284 CLASS="bold"
2285 ><B
2286 CLASS="emphasis"
2287 >afs</B
2288 ></SPAN
2289 > to the local <SPAN
2290 CLASS="bold"
2291 ><B
2292 CLASS="emphasis"
2293 >/var/sysgen/master.d</B
2294 ></SPAN
2295 > directory.
2296                           <PRE
2297 CLASS="programlisting"
2298 >&#13;   # <SPAN
2299 CLASS="bold"
2300 ><B
2301 CLASS="emphasis"
2302 >cp -p  bin/afs.sm  /var/sysgen/system</B
2303 ></SPAN
2304 >
2305    # <SPAN
2306 CLASS="bold"
2307 ><B
2308 CLASS="emphasis"
2309 >cp -p  bin/afs  /var/sysgen/master.d</B
2310 ></SPAN
2311 >
2312 </PRE
2313 ></P
2314 ></LI
2315 ><LI
2316 ><P
2317 >Copy the appropriate AFS kernel library file to the local file <SPAN
2318 CLASS="bold"
2319 ><B
2320 CLASS="emphasis"
2321 >/var/sysgen/boot/afs.a</B
2322 ></SPAN
2323 >; the <SPAN
2324 CLASS="bold"
2325 ><B
2326 CLASS="emphasis"
2327 >IP</B
2328 ></SPAN
2329 ><VAR
2330 CLASS="replaceable"
2331 >xx</VAR
2332 > portion of the library file name must match the
2333                           value previously returned by the <SPAN
2334 CLASS="bold"
2335 ><B
2336 CLASS="emphasis"
2337 >uname -m</B
2338 ></SPAN
2339 > command. Also choose the file
2340                           appropriate to whether the machine's kernel supports NFS server functionality (NFS must be supported for
2341                           the machine to act as an NFS/AFS Translator). Single- and multiprocessor machines use the same library
2342                           file.</P
2343 ><P
2344 >If the machine's kernel supports NFS server functionality:</P
2345 ><PRE
2346 CLASS="programlisting"
2347 >&#13;   # <SPAN
2348 CLASS="bold"
2349 ><B
2350 CLASS="emphasis"
2351 >cp -p   bin/libafs.IP</B
2352 ></SPAN
2353 ><VAR
2354 CLASS="replaceable"
2355 >xx</VAR
2356 ><SPAN
2357 CLASS="bold"
2358 ><B
2359 CLASS="emphasis"
2360 >.a   /var/sysgen/boot/afs.a</B
2361 ></SPAN
2362 >
2363 </PRE
2364 ><P
2365 >If the machine's kernel does not support NFS server functionality:</P
2366 ><PRE
2367 CLASS="programlisting"
2368 >&#13;   # <SPAN
2369 CLASS="bold"
2370 ><B
2371 CLASS="emphasis"
2372 >cp -p  bin/libafs.IP</B
2373 ></SPAN
2374 ><VAR
2375 CLASS="replaceable"
2376 >xx</VAR
2377 ><SPAN
2378 CLASS="bold"
2379 ><B
2380 CLASS="emphasis"
2381 >.nonfs.a  /var/sysgen/boot/afs.a</B
2382 ></SPAN
2383 >
2384 </PRE
2385 ></LI
2386 ><LI
2387 ><P
2388 >Issue the <SPAN
2389 CLASS="bold"
2390 ><B
2391 CLASS="emphasis"
2392 >chkconfig</B
2393 ></SPAN
2394 > command to deactivate the <SPAN
2395 CLASS="bold"
2396 ><B
2397 CLASS="emphasis"
2398 >afsml</B
2399 ></SPAN
2400 > configuration variable. <PRE
2401 CLASS="programlisting"
2402 >&#13;   # <SPAN
2403 CLASS="bold"
2404 ><B
2405 CLASS="emphasis"
2406 >/etc/chkconfig -f afsml off</B
2407 ></SPAN
2408 >
2409 </PRE
2410 ></P
2411 ><P
2412 >If the machine is to function as an NFS/AFS Translator and the kernel supports NFS server
2413                           functionality, activate the <SPAN
2414 CLASS="bold"
2415 ><B
2416 CLASS="emphasis"
2417 >afsxnfs</B
2418 ></SPAN
2419 > variable.</P
2420 ><PRE
2421 CLASS="programlisting"
2422 >&#13;   # <SPAN
2423 CLASS="bold"
2424 ><B
2425 CLASS="emphasis"
2426 >/etc/chkconfig -f afsxnfs on</B
2427 ></SPAN
2428 >
2429 </PRE
2430 ></LI
2431 ><LI
2432 ><P
2433 >Copy the existing kernel file, <SPAN
2434 CLASS="bold"
2435 ><B
2436 CLASS="emphasis"
2437 >/unix</B
2438 ></SPAN
2439 >, to a safe location. Compile
2440                           the new kernel, which is created in the file <SPAN
2441 CLASS="bold"
2442 ><B
2443 CLASS="emphasis"
2444 >/unix.install</B
2445 ></SPAN
2446 >. It overwrites
2447                           the existing <SPAN
2448 CLASS="bold"
2449 ><B
2450 CLASS="emphasis"
2451 >/unix</B
2452 ></SPAN
2453 > file when the machine reboots in the next step.
2454                           <PRE
2455 CLASS="programlisting"
2456 >&#13;   # <SPAN
2457 CLASS="bold"
2458 ><B
2459 CLASS="emphasis"
2460 >cp /unix /unix_noafs</B
2461 ></SPAN
2462 >
2463    # <SPAN
2464 CLASS="bold"
2465 ><B
2466 CLASS="emphasis"
2467 >autoconfig</B
2468 ></SPAN
2469 >
2470 </PRE
2471 ></P
2472 ></LI
2473 ><LI
2474 ><P
2475 >Reboot the machine to start using the new kernel, and login again as the superuser <SPAN
2476 CLASS="bold"
2477 ><B
2478 CLASS="emphasis"
2479 >root</B
2480 ></SPAN
2481 >. <PRE
2482 CLASS="programlisting"
2483 >&#13;   # <SPAN
2484 CLASS="bold"
2485 ><B
2486 CLASS="emphasis"
2487 >cd /</B
2488 ></SPAN
2489 >
2490    # <SPAN
2491 CLASS="bold"
2492 ><B
2493 CLASS="emphasis"
2494 >shutdown -i6 -g0 -y</B
2495 ></SPAN
2496 >
2497    login: <SPAN
2498 CLASS="bold"
2499 ><B
2500 CLASS="emphasis"
2501 >root</B
2502 ></SPAN
2503 >
2504    Password: <VAR
2505 CLASS="replaceable"
2506 >root_password</VAR
2507 >
2508 </PRE
2509 ></P
2510 ></LI
2511 ></OL
2512 ></P
2513 ></LI
2514 ></UL
2515 ></P
2516 ></LI
2517 ><LI
2518 ><P
2519 ><A
2520 NAME="LIWQ105"
2521 ></A
2522 >Create a directory called <SPAN
2523 CLASS="bold"
2524 ><B
2525 CLASS="emphasis"
2526 >/vicep</B
2527 ></SPAN
2528 ><VAR
2529 CLASS="replaceable"
2530 >xx</VAR
2531 > for each AFS server partition you are configuring (there
2532               must be at least one). Repeat the command for each partition. <PRE
2533 CLASS="programlisting"
2534 >&#13;   # <SPAN
2535 CLASS="bold"
2536 ><B
2537 CLASS="emphasis"
2538 >mkdir /vicep</B
2539 ></SPAN
2540 ><VAR
2541 CLASS="replaceable"
2542 >xx</VAR
2543 >
2544 </PRE
2545 ></P
2546 ></LI
2547 ><LI
2548 ><P
2549 >Add a line with the following format to the file systems registry file, <SPAN
2550 CLASS="bold"
2551 ><B
2552 CLASS="emphasis"
2553 >/etc/fstab</B
2554 ></SPAN
2555 >, for each partition (or logical volume created with the XLV volume manager) to be
2556               mounted on one of the directories created in the previous step.</P
2557 ><P
2558 >For an XFS partition or logical volume:</P
2559 ><PRE
2560 CLASS="programlisting"
2561 >&#13;   /dev/dsk/<VAR
2562 CLASS="replaceable"
2563 >disk</VAR
2564 >  /vicep<VAR
2565 CLASS="replaceable"
2566 >xx</VAR
2567 >  xfs  rw,raw=/dev/rdsk/<VAR
2568 CLASS="replaceable"
2569 >disk</VAR
2570 >  0  0
2571 </PRE
2572 ><P
2573 >For an EFS partition:</P
2574 ><PRE
2575 CLASS="programlisting"
2576 >&#13;   /dev/dsk/<VAR
2577 CLASS="replaceable"
2578 >disk</VAR
2579 >  /vicep<VAR
2580 CLASS="replaceable"
2581 >xx</VAR
2582 >  efs  rw,raw=/dev/rdsk/<VAR
2583 CLASS="replaceable"
2584 >disk</VAR
2585 >  0  0
2586 </PRE
2587 ><P
2588 >The following are examples of an entry for each file system type:</P
2589 ><PRE
2590 CLASS="programlisting"
2591 >&#13;   /dev/dsk/dks0d2s6 /vicepa  xfs rw,raw=/dev/rdsk/dks0d2s6  0 0
2592    /dev/dsk/dks0d3s1 /vicepb  efs rw,raw=/dev/rdsk/dks0d3s1  0 0
2593 </PRE
2594 ></LI
2595 ><LI
2596 ><P
2597 >Create a file system on each partition that is to be mounted on a <SPAN
2598 CLASS="bold"
2599 ><B
2600 CLASS="emphasis"
2601 >/vicep</B
2602 ></SPAN
2603 ><VAR
2604 CLASS="replaceable"
2605 >xx</VAR
2606 > directory. The following commands are probably appropriate,
2607               but consult the IRIX documentation for more information. In both cases, <VAR
2608 CLASS="replaceable"
2609 >raw_device</VAR
2610 > is a raw
2611               device name like <SPAN
2612 CLASS="bold"
2613 ><B
2614 CLASS="emphasis"
2615 >/dev/rdsk/dks0d0s0</B
2616 ></SPAN
2617 > for a single disk partition or <SPAN
2618 CLASS="bold"
2619 ><B
2620 CLASS="emphasis"
2621 >/dev/rxlv/xlv0</B
2622 ></SPAN
2623 > for a logical volume.</P
2624 ><P
2625 >For XFS file systems, include the indicated options to configure the partition or logical volume with inodes
2626               large enough to accommodate AFS-specific information:</P
2627 ><PRE
2628 CLASS="programlisting"
2629 >&#13;   # <SPAN
2630 CLASS="bold"
2631 ><B
2632 CLASS="emphasis"
2633 >mkfs -t xfs -i size=512 -l size=4000b</B
2634 ></SPAN
2635 > <VAR
2636 CLASS="replaceable"
2637 >raw_device</VAR
2638 >
2639 </PRE
2640 ><P
2641 >For EFS file systems:</P
2642 ><PRE
2643 CLASS="programlisting"
2644 >&#13;   # <SPAN
2645 CLASS="bold"
2646 ><B
2647 CLASS="emphasis"
2648 >mkfs -t efs</B
2649 ></SPAN
2650 > <VAR
2651 CLASS="replaceable"
2652 >raw_device</VAR
2653 >
2654 </PRE
2655 ></LI
2656 ><LI
2657 ><P
2658 >Mount each partition by issuing either the <SPAN
2659 CLASS="bold"
2660 ><B
2661 CLASS="emphasis"
2662 >mount -a</B
2663 ></SPAN
2664 > command to mount all
2665               partitions at once or the <SPAN
2666 CLASS="bold"
2667 ><B
2668 CLASS="emphasis"
2669 >mount</B
2670 ></SPAN
2671 > command to mount each partition in turn.</P
2672 ></LI
2673 ><LI
2674 ><P
2675 ><SPAN
2676 CLASS="bold"
2677 ><B
2678 CLASS="emphasis"
2679 >(Optional)</B
2680 ></SPAN
2681 > If you have configured partitions or logical volumes to use XFS,
2682               issue the following command to verify that the inodes are configured properly (are large enough to accommodate
2683               AFS-specific information). If the configuration is correct, the command returns no output. Otherwise, it specifies the
2684               command to run in order to configure each partition or logical volume properly. <PRE
2685 CLASS="programlisting"
2686 >&#13;   # <SPAN
2687 CLASS="bold"
2688 ><B
2689 CLASS="emphasis"
2690 >/usr/afs/bin/xfs_size_check</B
2691 ></SPAN
2692 >
2693 </PRE
2694 ></P
2695 ></LI
2696 ><LI
2697 ><P
2698 >If the machine is to remain an AFS client, incorporate AFS into its authentication system, following the
2699               instructions in <A
2700 HREF="c371.html#HDRWQ40"
2701 >Enabling AFS Login on IRIX Systems</A
2702 >.</P
2703 ></LI
2704 ><LI
2705 ><P
2706 >Proceed to <A
2707 HREF="c5467.html#HDRWQ108"
2708 >Starting Server Programs</A
2709 >.</P
2710 ></LI
2711 ></OL
2712 ></P
2713 ></DIV
2714 ><DIV
2715 CLASS="sect3"
2716 ><H3
2717 CLASS="sect3"
2718 ><A
2719 NAME="HDRWQ106"
2720 >Getting Started on Linux Systems</A
2721 ></H3
2722 ><P
2723 >Begin by running the AFS initialization script to call the <SPAN
2724 CLASS="bold"
2725 ><B
2726 CLASS="emphasis"
2727 >insmod</B
2728 ></SPAN
2729 > program, which
2730         dynamically loads AFS modifications into the kernel. Then create partitions for storing AFS volumes. You do not need to
2731         replace the Linux <SPAN
2732 CLASS="bold"
2733 ><B
2734 CLASS="emphasis"
2735 >fsck</B
2736 ></SPAN
2737 > program. <OL
2738 TYPE="1"
2739 ><LI
2740 ><P
2741 >Mount the AFS CD-ROM for Linux on the local <SPAN
2742 CLASS="bold"
2743 ><B
2744 CLASS="emphasis"
2745 >/cdrom</B
2746 ></SPAN
2747 > directory. For instructions
2748               on mounting CD-ROMs (either locally or remotely via NFS), see your Linux documentation. Then change directory as
2749               indicated. <PRE
2750 CLASS="programlisting"
2751 >&#13;   # <SPAN
2752 CLASS="bold"
2753 ><B
2754 CLASS="emphasis"
2755 >cd  /cdrom/i386_linux22/root.client/usr/vice/etc</B
2756 ></SPAN
2757 >
2758 </PRE
2759 ></P
2760 ></LI
2761 ><LI
2762 ><P
2763 >Copy the AFS kernel library files to the local <SPAN
2764 CLASS="bold"
2765 ><B
2766 CLASS="emphasis"
2767 >/usr/vice/etc/modload</B
2768 ></SPAN
2769 > directory.
2770               The filenames for the libraries have the format <SPAN
2771 CLASS="bold"
2772 ><B
2773 CLASS="emphasis"
2774 >libafs-</B
2775 ></SPAN
2776 ><VAR
2777 CLASS="replaceable"
2778 >version</VAR
2779 ><SPAN
2780 CLASS="bold"
2781 ><B
2782 CLASS="emphasis"
2783 >.o</B
2784 ></SPAN
2785 >, where
2786               <VAR
2787 CLASS="replaceable"
2788 >version</VAR
2789 > indicates the kernel build level. The string <SPAN
2790 CLASS="bold"
2791 ><B
2792 CLASS="emphasis"
2793 >.mp</B
2794 ></SPAN
2795 >
2796               in the <VAR
2797 CLASS="replaceable"
2798 >version</VAR
2799 > indicates that the file is appropriate for machines running a multiprocessor
2800               kernel. <PRE
2801 CLASS="programlisting"
2802 >&#13;   # <SPAN
2803 CLASS="bold"
2804 ><B
2805 CLASS="emphasis"
2806 >cp -rp  modload  /usr/vice/etc</B
2807 ></SPAN
2808 >
2809 </PRE
2810 ></P
2811 ></LI
2812 ><LI
2813 ><P
2814 >Copy the AFS initialization script to the local directory for initialization files (by convention, <SPAN
2815 CLASS="bold"
2816 ><B
2817 CLASS="emphasis"
2818 >/etc/rc.d/init.d</B
2819 ></SPAN
2820 > on Linux machines). Note the removal of the <SPAN
2821 CLASS="bold"
2822 ><B
2823 CLASS="emphasis"
2824 >.rc</B
2825 ></SPAN
2826 > extension as you copy the script. <PRE
2827 CLASS="programlisting"
2828 >&#13;   # <SPAN
2829 CLASS="bold"
2830 ><B
2831 CLASS="emphasis"
2832 >cp -p   afs.rc  /etc/rc.d/init.d/afs</B
2833 ></SPAN
2834 >
2835 </PRE
2836 ></P
2837 ></LI
2838 ><LI
2839 ><P
2840 >Run the AFS initialization script to load AFS extensions into the kernel. You can ignore any error messages
2841               about the inability to start the BOS Server or the Cache Manager or AFS client. <PRE
2842 CLASS="programlisting"
2843 >&#13;   # <SPAN
2844 CLASS="bold"
2845 ><B
2846 CLASS="emphasis"
2847 >/etc/rc.d/init.d/afs  start</B
2848 ></SPAN
2849 >
2850 </PRE
2851 >    </P
2852 ></LI
2853 ><LI
2854 ><P
2855 >Create a directory called <SPAN
2856 CLASS="bold"
2857 ><B
2858 CLASS="emphasis"
2859 >/vicep</B
2860 ></SPAN
2861 ><VAR
2862 CLASS="replaceable"
2863 >xx</VAR
2864 > for each AFS
2865               server partition you are configuring (there must be at least one). Repeat the command for each partition.
2866               <PRE
2867 CLASS="programlisting"
2868 >&#13;   # <SPAN
2869 CLASS="bold"
2870 ><B
2871 CLASS="emphasis"
2872 >mkdir /vicep</B
2873 ></SPAN
2874 ><VAR
2875 CLASS="replaceable"
2876 >xx</VAR
2877 >
2878 </PRE
2879 ></P
2880 ></LI
2881 ><LI
2882 ><P
2883 >Add a line with the following format to the file systems registry file, <SPAN
2884 CLASS="bold"
2885 ><B
2886 CLASS="emphasis"
2887 >/etc/fstab</B
2888 ></SPAN
2889 >, for each directory just created. The entry maps the directory name to the disk
2890               partition to be mounted on it. <PRE
2891 CLASS="programlisting"
2892 >&#13;   /dev/<VAR
2893 CLASS="replaceable"
2894 >disk</VAR
2895 >  /vicep<VAR
2896 CLASS="replaceable"
2897 >xx</VAR
2898 >  ext2  defaults  0  2
2899 </PRE
2900 ></P
2901 ><P
2902 >The following is an example for the first partition being configured.</P
2903 ><PRE
2904 CLASS="programlisting"
2905 >&#13;   /dev/sda8 /vicepa ext2 defaults 0 2
2906 </PRE
2907 ></LI
2908 ><LI
2909 ><P
2910 >Create a file system on each partition that is to be mounted at a <SPAN
2911 CLASS="bold"
2912 ><B
2913 CLASS="emphasis"
2914 >/vicep</B
2915 ></SPAN
2916 ><VAR
2917 CLASS="replaceable"
2918 >xx</VAR
2919 > directory. The following command is probably appropriate,
2920               but consult the Linux documentation for more information. <PRE
2921 CLASS="programlisting"
2922 >&#13;   # <SPAN
2923 CLASS="bold"
2924 ><B
2925 CLASS="emphasis"
2926 >mkfs -v /dev/</B
2927 ></SPAN
2928 ><VAR
2929 CLASS="replaceable"
2930 >disk</VAR
2931 >
2932 </PRE
2933 ></P
2934 ></LI
2935 ><LI
2936 ><P
2937 >Mount each partition by issuing either the <SPAN
2938 CLASS="bold"
2939 ><B
2940 CLASS="emphasis"
2941 >mount -a</B
2942 ></SPAN
2943 > command to mount all
2944               partitions at once or the <SPAN
2945 CLASS="bold"
2946 ><B
2947 CLASS="emphasis"
2948 >mount</B
2949 ></SPAN
2950 > command to mount each partition in turn.</P
2951 ></LI
2952 ><LI
2953 ><P
2954 >If the machine is to remain an AFS client, incorporate AFS into its authentication system, following the
2955               instructions in <A
2956 HREF="c371.html#HDRWQ44"
2957 >Enabling AFS Login on Linux Systems</A
2958 >.</P
2959 ></LI
2960 ><LI
2961 ><P
2962 >Proceed to <A
2963 HREF="c5467.html#HDRWQ108"
2964 >Starting Server Programs</A
2965 >.</P
2966 ></LI
2967 ></OL
2968 ></P
2969 ></DIV
2970 ><DIV
2971 CLASS="sect3"
2972 ><H3
2973 CLASS="sect3"
2974 ><A
2975 NAME="HDRWQ107"
2976 >Getting Started on Solaris Systems</A
2977 ></H3
2978 ><P
2979 >Begin by running the AFS initialization script to call the <SPAN
2980 CLASS="bold"
2981 ><B
2982 CLASS="emphasis"
2983 >modload</B
2984 ></SPAN
2985 > program, which
2986         dynamically loads AFS modifications into the kernel. Then configure partitions and replace the Solaris <SPAN
2987 CLASS="bold"
2988 ><B
2989 CLASS="emphasis"
2990 >fsck</B
2991 ></SPAN
2992 > program with a version that correctly handles AFS volumes. <OL
2993 TYPE="1"
2994 ><LI
2995 ><P
2996 >Mount the AFS CD-ROM for Solaris on the <SPAN
2997 CLASS="bold"
2998 ><B
2999 CLASS="emphasis"
3000 >/cdrom</B
3001 ></SPAN
3002 > directory. For instructions on
3003               mounting CD-ROMs (either locally or remotely via NFS), see your Solaris documentation. Then change directory as
3004               indicated. <PRE
3005 CLASS="programlisting"
3006 >&#13;   # <SPAN
3007 CLASS="bold"
3008 ><B
3009 CLASS="emphasis"
3010 >cd  /cdrom/sun4x_56/root.client/usr/vice/etc</B
3011 ></SPAN
3012 >
3013 </PRE
3014 ></P
3015 ></LI
3016 ><LI
3017 ><P
3018 >Copy the AFS initialization script to the local directory for initialization files (by convention, <SPAN
3019 CLASS="bold"
3020 ><B
3021 CLASS="emphasis"
3022 >/etc/init.d</B
3023 ></SPAN
3024 > on Solaris machines). Note the removal of the <SPAN
3025 CLASS="bold"
3026 ><B
3027 CLASS="emphasis"
3028 >.rc</B
3029 ></SPAN
3030 >
3031               extension as you copy the script. <PRE
3032 CLASS="programlisting"
3033 >&#13;   # <SPAN
3034 CLASS="bold"
3035 ><B
3036 CLASS="emphasis"
3037 >cp -p  afs.rc  /etc/init.d/afs</B
3038 ></SPAN
3039 >
3040 </PRE
3041 ></P
3042 ></LI
3043 ><LI
3044 ><P
3045 >Copy the appropriate AFS kernel library file to the local file <SPAN
3046 CLASS="bold"
3047 ><B
3048 CLASS="emphasis"
3049 >/kernel/fs/afs</B
3050 ></SPAN
3051 >.</P
3052 ><P
3053 >If the machine is running Solaris 2.6 or the 32-bit version of Solaris 7, its kernel supports NFS server
3054               functionality, and the <SPAN
3055 CLASS="bold"
3056 ><B
3057 CLASS="emphasis"
3058 >nfsd</B
3059 ></SPAN
3060 > process is running:</P
3061 ><PRE
3062 CLASS="programlisting"
3063 >&#13;   # <SPAN
3064 CLASS="bold"
3065 ><B
3066 CLASS="emphasis"
3067 >cp -p modload/libafs.o /kernel/fs/afs</B
3068 ></SPAN
3069 >
3070 </PRE
3071 ><P
3072 >If the machine is running Solaris 2.6 or the 32-bit version of Solaris 7, and its kernel does not support NFS
3073               server functionality or the <SPAN
3074 CLASS="bold"
3075 ><B
3076 CLASS="emphasis"
3077 >nfsd</B
3078 ></SPAN
3079 > process is not running:</P
3080 ><PRE
3081 CLASS="programlisting"
3082 >&#13;   # <SPAN
3083 CLASS="bold"
3084 ><B
3085 CLASS="emphasis"
3086 >cp -p modload/libafs.nonfs.o /kernel/fs/afs</B
3087 ></SPAN
3088 >
3089 </PRE
3090 ><P
3091 >If the machine is running the 64-bit version of Solaris 7, its kernel supports NFS server functionality, and the
3092               <SPAN
3093 CLASS="bold"
3094 ><B
3095 CLASS="emphasis"
3096 >nfsd</B
3097 ></SPAN
3098 > process is running:</P
3099 ><PRE
3100 CLASS="programlisting"
3101 >&#13;   # <SPAN
3102 CLASS="bold"
3103 ><B
3104 CLASS="emphasis"
3105 >cp -p modload/libafs64.o /kernel/fs/sparcv9/afs</B
3106 ></SPAN
3107 >
3108 </PRE
3109 ><P
3110 >If the machine is running the 64-bit version of Solaris 7, and its kernel does not support NFS server
3111               functionality or the <SPAN
3112 CLASS="bold"
3113 ><B
3114 CLASS="emphasis"
3115 >nfsd</B
3116 ></SPAN
3117 > process is not running:</P
3118 ><PRE
3119 CLASS="programlisting"
3120 >&#13;   # <SPAN
3121 CLASS="bold"
3122 ><B
3123 CLASS="emphasis"
3124 >cp -p modload/libafs64.nonfs.o /kernel/fs/sparcv9/afs</B
3125 ></SPAN
3126 >
3127 </PRE
3128 ></LI
3129 ><LI
3130 ><P
3131 >Run the AFS initialization script to load AFS modifications into the kernel. You can ignore any error messages
3132               about the inability to start the BOS Server or the Cache Manager or AFS client. <PRE
3133 CLASS="programlisting"
3134 >&#13;   # <SPAN
3135 CLASS="bold"
3136 ><B
3137 CLASS="emphasis"
3138 >/etc/init.d/afs start</B
3139 ></SPAN
3140 >
3141 </PRE
3142 ></P
3143 ><P
3144 >When an entry called <SAMP
3145 CLASS="computeroutput"
3146 >afs</SAMP
3147 > does not already exist in the local <SPAN
3148 CLASS="bold"
3149 ><B
3150 CLASS="emphasis"
3151 >/etc/name_to_sysnum</B
3152 ></SPAN
3153 > file, the script automatically creates it and reboots the machine to start
3154               using the new version of the file. If this happens, log in again as the superuser <SPAN
3155 CLASS="bold"
3156 ><B
3157 CLASS="emphasis"
3158 >root</B
3159 ></SPAN
3160 > after the reboot and run the initialization script again. This time the required entry
3161               exists in the <SPAN
3162 CLASS="bold"
3163 ><B
3164 CLASS="emphasis"
3165 >/etc/name_to_sysnum</B
3166 ></SPAN
3167 > file, and the <SPAN
3168 CLASS="bold"
3169 ><B
3170 CLASS="emphasis"
3171 >modload</B
3172 ></SPAN
3173 > program runs.</P
3174 ><PRE
3175 CLASS="programlisting"
3176 >&#13;   login: <SPAN
3177 CLASS="bold"
3178 ><B
3179 CLASS="emphasis"
3180 >root</B
3181 ></SPAN
3182 >
3183    Password: <VAR
3184 CLASS="replaceable"
3185 >root_password</VAR
3186 >
3187    # <SPAN
3188 CLASS="bold"
3189 ><B
3190 CLASS="emphasis"
3191 >/etc/init.d/afs start</B
3192 ></SPAN
3193 >
3194 </PRE
3195 ></LI
3196 ><LI
3197 ><P
3198 >Create the <SPAN
3199 CLASS="bold"
3200 ><B
3201 CLASS="emphasis"
3202 >/usr/lib/fs/afs</B
3203 ></SPAN
3204 > directory to house the AFS-modified <SPAN
3205 CLASS="bold"
3206 ><B
3207 CLASS="emphasis"
3208 >fsck</B
3209 ></SPAN
3210 > program and related files. <PRE
3211 CLASS="programlisting"
3212 >&#13;   # <SPAN
3213 CLASS="bold"
3214 ><B
3215 CLASS="emphasis"
3216 >mkdir /usr/lib/fs/afs</B
3217 ></SPAN
3218 >
3219    # <SPAN
3220 CLASS="bold"
3221 ><B
3222 CLASS="emphasis"
3223 >cd /usr/lib/fs/afs</B
3224 ></SPAN
3225 >
3226 </PRE
3227 ></P
3228 ></LI
3229 ><LI
3230 ><P
3231 >Copy the <SPAN
3232 CLASS="bold"
3233 ><B
3234 CLASS="emphasis"
3235 >vfsck</B
3236 ></SPAN
3237 > binary to the newly created directory, changing the name as you
3238               do so. <PRE
3239 CLASS="programlisting"
3240 >&#13;   # <SPAN
3241 CLASS="bold"
3242 ><B
3243 CLASS="emphasis"
3244 >cp  /cdrom/sun4x_56/root.server/etc/vfsck  fsck</B
3245 ></SPAN
3246 >
3247 </PRE
3248 ></P
3249 ></LI
3250 ><LI
3251 ><P
3252 >Working in the <SPAN
3253 CLASS="bold"
3254 ><B
3255 CLASS="emphasis"
3256 >/usr/lib/fs/afs</B
3257 ></SPAN
3258 > directory, create the following links to Solaris
3259               libraries: <PRE
3260 CLASS="programlisting"
3261 >&#13;   # <SPAN
3262 CLASS="bold"
3263 ><B
3264 CLASS="emphasis"
3265 >ln -s /usr/lib/fs/ufs/clri</B
3266 ></SPAN
3267 >
3268    # <SPAN
3269 CLASS="bold"
3270 ><B
3271 CLASS="emphasis"
3272 >ln -s /usr/lib/fs/ufs/df</B
3273 ></SPAN
3274 >
3275    # <SPAN
3276 CLASS="bold"
3277 ><B
3278 CLASS="emphasis"
3279 >ln -s /usr/lib/fs/ufs/edquota</B
3280 ></SPAN
3281 >
3282    # <SPAN
3283 CLASS="bold"
3284 ><B
3285 CLASS="emphasis"
3286 >ln -s /usr/lib/fs/ufs/ff</B
3287 ></SPAN
3288 >
3289    # <SPAN
3290 CLASS="bold"
3291 ><B
3292 CLASS="emphasis"
3293 >ln -s /usr/lib/fs/ufs/fsdb</B
3294 ></SPAN
3295 >
3296    # <SPAN
3297 CLASS="bold"
3298 ><B
3299 CLASS="emphasis"
3300 >ln -s /usr/lib/fs/ufs/fsirand</B
3301 ></SPAN
3302 >
3303    # <SPAN
3304 CLASS="bold"
3305 ><B
3306 CLASS="emphasis"
3307 >ln -s /usr/lib/fs/ufs/fstyp</B
3308 ></SPAN
3309 >
3310    # <SPAN
3311 CLASS="bold"
3312 ><B
3313 CLASS="emphasis"
3314 >ln -s /usr/lib/fs/ufs/labelit</B
3315 ></SPAN
3316 >
3317    # <SPAN
3318 CLASS="bold"
3319 ><B
3320 CLASS="emphasis"
3321 >ln -s /usr/lib/fs/ufs/lockfs</B
3322 ></SPAN
3323 >
3324    # <SPAN
3325 CLASS="bold"
3326 ><B
3327 CLASS="emphasis"
3328 >ln -s /usr/lib/fs/ufs/mkfs</B
3329 ></SPAN
3330 >
3331    # <SPAN
3332 CLASS="bold"
3333 ><B
3334 CLASS="emphasis"
3335 >ln -s /usr/lib/fs/ufs/mount</B
3336 ></SPAN
3337 >
3338    # <SPAN
3339 CLASS="bold"
3340 ><B
3341 CLASS="emphasis"
3342 >ln -s /usr/lib/fs/ufs/ncheck</B
3343 ></SPAN
3344 >
3345    # <SPAN
3346 CLASS="bold"
3347 ><B
3348 CLASS="emphasis"
3349 >ln -s /usr/lib/fs/ufs/newfs</B
3350 ></SPAN
3351 >
3352    # <SPAN
3353 CLASS="bold"
3354 ><B
3355 CLASS="emphasis"
3356 >ln -s /usr/lib/fs/ufs/quot</B
3357 ></SPAN
3358 >
3359    # <SPAN
3360 CLASS="bold"
3361 ><B
3362 CLASS="emphasis"
3363 >ln -s /usr/lib/fs/ufs/quota</B
3364 ></SPAN
3365 >
3366    # <SPAN
3367 CLASS="bold"
3368 ><B
3369 CLASS="emphasis"
3370 >ln -s /usr/lib/fs/ufs/quotaoff</B
3371 ></SPAN
3372 >
3373    # <SPAN
3374 CLASS="bold"
3375 ><B
3376 CLASS="emphasis"
3377 >ln -s /usr/lib/fs/ufs/quotaon</B
3378 ></SPAN
3379 >
3380    # <SPAN
3381 CLASS="bold"
3382 ><B
3383 CLASS="emphasis"
3384 >ln -s /usr/lib/fs/ufs/repquota</B
3385 ></SPAN
3386 >
3387    # <SPAN
3388 CLASS="bold"
3389 ><B
3390 CLASS="emphasis"
3391 >ln -s /usr/lib/fs/ufs/tunefs</B
3392 ></SPAN
3393 >
3394    # <SPAN
3395 CLASS="bold"
3396 ><B
3397 CLASS="emphasis"
3398 >ln -s /usr/lib/fs/ufs/ufsdump</B
3399 ></SPAN
3400 >
3401    # <SPAN
3402 CLASS="bold"
3403 ><B
3404 CLASS="emphasis"
3405 >ln -s /usr/lib/fs/ufs/ufsrestore</B
3406 ></SPAN
3407 >
3408    # <SPAN
3409 CLASS="bold"
3410 ><B
3411 CLASS="emphasis"
3412 >ln -s /usr/lib/fs/ufs/volcopy</B
3413 ></SPAN
3414 >
3415 </PRE
3416 ></P
3417 ></LI
3418 ><LI
3419 ><P
3420 >Append the following line to the end of the file <SPAN
3421 CLASS="bold"
3422 ><B
3423 CLASS="emphasis"
3424 >/etc/dfs/fstypes</B
3425 ></SPAN
3426 >.
3427               <PRE
3428 CLASS="programlisting"
3429 >&#13;   afs AFS Utilities
3430 </PRE
3431 ></P
3432 ></LI
3433 ><LI
3434 ><P
3435 >Edit the <SPAN
3436 CLASS="bold"
3437 ><B
3438 CLASS="emphasis"
3439 >/sbin/mountall</B
3440 ></SPAN
3441 > file, making two changes. <UL
3442 ><LI
3443 ><P
3444 >Add an entry for AFS to the <SAMP
3445 CLASS="computeroutput"
3446 >case</SAMP
3447 > statement for option 2, so that it reads
3448                     as follows: <PRE
3449 CLASS="programlisting"
3450 >&#13;   case "$2" in
3451    ufs)    foptions="-o p"
3452            ;;
3453    afs)    foptions="-o p"
3454            ;;
3455    s5)     foptions="-y -t /var/tmp/tmp$$ -D"
3456            ;;
3457    *)      foptions="-y"
3458            ;;
3459 </PRE
3460 ></P
3461 ></LI
3462 ><LI
3463 ><P
3464 >Edit the file so that all AFS and UFS partitions are checked in parallel. Replace the following section of
3465                     code: <PRE
3466 CLASS="programlisting"
3467 >&#13;   # For  fsck purposes, we make a distinction between ufs and
3468    # other file systems
3469    #
3470    if [ "$fstype" = "ufs" ]; then
3471         ufs_fscklist="$ufs_fscklist $fsckdev"
3472         saveentry $fstype "$OPTIONS" $special $mountp
3473         continue
3474    fi
3475 </PRE
3476 ></P
3477 ><P
3478 >with the following section of code:</P
3479 ><PRE
3480 CLASS="programlisting"
3481 >&#13;   # For fsck purposes, we make a distinction between ufs/afs
3482    # and other file systems.
3483    #
3484    if [ "$fstype" = "ufs" -o "$fstype" = "afs" ]; then
3485         ufs_fscklist="$ufs_fscklist $fsckdev"
3486         saveentry $fstype "$OPTIONS" $special $mountp
3487         continue
3488    fi
3489 </PRE
3490 ></LI
3491 ></UL
3492 ></P
3493 ></LI
3494 ><LI
3495 ><P
3496 >Create a directory called <SPAN
3497 CLASS="bold"
3498 ><B
3499 CLASS="emphasis"
3500 >/vicep</B
3501 ></SPAN
3502 ><VAR
3503 CLASS="replaceable"
3504 >xx</VAR
3505 > for each AFS
3506               server partition you are configuring (there must be at least one). Repeat the command for each partition.
3507               <PRE
3508 CLASS="programlisting"
3509 >&#13;   # <SPAN
3510 CLASS="bold"
3511 ><B
3512 CLASS="emphasis"
3513 >mkdir /vicep</B
3514 ></SPAN
3515 ><VAR
3516 CLASS="replaceable"
3517 >xx</VAR
3518 >
3519 </PRE
3520 ></P
3521 ></LI
3522 ><LI
3523 ><P
3524 >Add a line with the following format to the file systems registry file, <SPAN
3525 CLASS="bold"
3526 ><B
3527 CLASS="emphasis"
3528 >/etc/vfstab</B
3529 ></SPAN
3530 >, for each partition to be mounted on a directory created in the previous step. Note
3531               the value <SAMP
3532 CLASS="computeroutput"
3533 >afs</SAMP
3534 > in the fourth field, which tells Solaris to use the AFS-modified
3535               <SPAN
3536 CLASS="bold"
3537 ><B
3538 CLASS="emphasis"
3539 >fsck</B
3540 ></SPAN
3541 > program on this partition. <PRE
3542 CLASS="programlisting"
3543 >&#13;   /dev/dsk/<VAR
3544 CLASS="replaceable"
3545 >disk</VAR
3546 >   /dev/rdsk/<VAR
3547 CLASS="replaceable"
3548 >disk</VAR
3549 >   /vicep<VAR
3550 CLASS="replaceable"
3551 >xx</VAR
3552 >   afs   <VAR
3553 CLASS="replaceable"
3554 >boot_order</VAR
3555 >  yes
3556 </PRE
3557 ></P
3558 ><P
3559 >The following is an example for the first partition being configured.</P
3560 ><PRE
3561 CLASS="programlisting"
3562 >&#13;   /dev/dsk/c0t6d0s1 /dev/rdsk/c0t6d0s1 /vicepa afs 3 yes
3563 </PRE
3564 ></LI
3565 ><LI
3566 ><P
3567 >Create a file system on each partition that is to be mounted at a <SPAN
3568 CLASS="bold"
3569 ><B
3570 CLASS="emphasis"
3571 >/vicep</B
3572 ></SPAN
3573 ><VAR
3574 CLASS="replaceable"
3575 >xx</VAR
3576 > directory. The following command is probably appropriate,
3577               but consult the Solaris documentation for more information. <PRE
3578 CLASS="programlisting"
3579 >&#13;   # <SPAN
3580 CLASS="bold"
3581 ><B
3582 CLASS="emphasis"
3583 >newfs -v /dev/rdsk/</B
3584 ></SPAN
3585 ><VAR
3586 CLASS="replaceable"
3587 >disk</VAR
3588 >
3589 </PRE
3590 ></P
3591 ></LI
3592 ><LI
3593 ><P
3594 >Issue the <SPAN
3595 CLASS="bold"
3596 ><B
3597 CLASS="emphasis"
3598 >mountall</B
3599 ></SPAN
3600 > command to mount all partitions at once.</P
3601 ></LI
3602 ><LI
3603 ><P
3604 >If the machine is to remain an AFS client, incorporate AFS into its authentication system, following the
3605               instructions in <A
3606 HREF="c371.html#HDRWQ49"
3607 >Enabling AFS Login and Editing the File Systems Clean-up Script on Solaris
3608               Systems</A
3609 >.</P
3610 ></LI
3611 ><LI
3612 ><P
3613 >Proceed to <A
3614 HREF="c5467.html#HDRWQ108"
3615 >Starting Server Programs</A
3616 >.</P
3617 ></LI
3618 ></OL
3619 ></P
3620 ></DIV
3621 ></DIV
3622 ><DIV
3623 CLASS="sect2"
3624 ><H2
3625 CLASS="sect2"
3626 ><A
3627 NAME="HDRWQ108"
3628 >Starting Server Programs</A
3629 ></H2
3630 ><P
3631 >In this section you initialize the BOS Server, the Update Server, the controller process for NTPD, and the <SPAN
3632 CLASS="bold"
3633 ><B
3634 CLASS="emphasis"
3635 >fs</B
3636 ></SPAN
3637 > process. You begin by copying the necessary server files to the local disk. <OL
3638 TYPE="1"
3639 ><LI
3640 ><P
3641 >Copy file server binaries to the local <SPAN
3642 CLASS="bold"
3643 ><B
3644 CLASS="emphasis"
3645 >/usr/afs/bin</B
3646 ></SPAN
3647 > directory. <UL
3648 ><LI
3649 ><P
3650 >On a machine of an existing system type, you can either load files from the AFS CD-ROM or use a remote file
3651                   transfer protocol to copy files from an existing server machine of the same system type. To load from the CD-ROM,
3652                   see the instructions just following for a machine of a new system type. If using a remote file transfer protocol,
3653                   copy the complete contents of the existing server machine's <SPAN
3654 CLASS="bold"
3655 ><B
3656 CLASS="emphasis"
3657 >/usr/afs/bin</B
3658 ></SPAN
3659 >
3660                   directory.</P
3661 ></LI
3662 ><LI
3663 ><P
3664 >On a machine of a new system type, you must use the following instructions to copy files from the AFS
3665                   CD-ROM. <OL
3666 TYPE="a"
3667 ><LI
3668 ><P
3669 >On the local <SPAN
3670 CLASS="bold"
3671 ><B
3672 CLASS="emphasis"
3673 >/cdrom</B
3674 ></SPAN
3675 > directory, mount the AFS CD-ROM for this
3676                         machine's system type, if it is not already. For instructions on mounting CD-ROMs (either locally or
3677                         remotely via NFS), consult the operating system documentation.</P
3678 ></LI
3679 ><LI
3680 ><P
3681 >Copy files from the CD-ROM to the local <SPAN
3682 CLASS="bold"
3683 ><B
3684 CLASS="emphasis"
3685 >/usr/afs</B
3686 ></SPAN
3687 > directory.
3688                         <PRE
3689 CLASS="programlisting"
3690 >&#13;   # <SPAN
3691 CLASS="bold"
3692 ><B
3693 CLASS="emphasis"
3694 >cd /cdrom/</B
3695 ></SPAN
3696 ><VAR
3697 CLASS="replaceable"
3698 >sysname</VAR
3699 ><SPAN
3700 CLASS="bold"
3701 ><B
3702 CLASS="emphasis"
3703 >/root.server/usr/afs</B
3704 ></SPAN
3705 >
3706    # <SPAN
3707 CLASS="bold"
3708 ><B
3709 CLASS="emphasis"
3710 >cp -rp  *  /usr/afs</B
3711 ></SPAN
3712 >
3713 </PRE
3714 ></P
3715 ></LI
3716 ></OL
3717 ></P
3718 ></LI
3719 ></UL
3720 ></P
3721 ></LI
3722 ><LI
3723 ><P
3724 >Copy the contents of the <SPAN
3725 CLASS="bold"
3726 ><B
3727 CLASS="emphasis"
3728 >/usr/afs/etc</B
3729 ></SPAN
3730 > directory from an existing file server
3731             machine, using a remote file transfer protocol such as <SPAN
3732 CLASS="bold"
3733 ><B
3734 CLASS="emphasis"
3735 >ftp</B
3736 ></SPAN
3737 > or NFS. If you use a system
3738             control machine, it is best to copy the contents of its <SPAN
3739 CLASS="bold"
3740 ><B
3741 CLASS="emphasis"
3742 >/usr/afs/etc</B
3743 ></SPAN
3744 > directory. If you
3745             choose not to run a system control machine, copy the directory's contents from any existing file server machine.
3746                  </P
3747 ></LI
3748 ><LI
3749 ><P
3750 >Change to the <SPAN
3751 CLASS="bold"
3752 ><B
3753 CLASS="emphasis"
3754 >/usr/afs/bin</B
3755 ></SPAN
3756 > directory and start the BOS Server (<SPAN
3757 CLASS="bold"
3758 ><B
3759 CLASS="emphasis"
3760 >bosserver</B
3761 ></SPAN
3762 > process). Include the <SPAN
3763 CLASS="bold"
3764 ><B
3765 CLASS="emphasis"
3766 >-noauth</B
3767 ></SPAN
3768 > flag to prevent the AFS
3769             processes from performing authorization checking. This is a grave compromise of security; finish the remaining
3770             instructions in this section in an uninterrupted pass. <PRE
3771 CLASS="programlisting"
3772 >&#13;   # <SPAN
3773 CLASS="bold"
3774 ><B
3775 CLASS="emphasis"
3776 >cd /usr/afs/bin</B
3777 ></SPAN
3778 >
3779    # <SPAN
3780 CLASS="bold"
3781 ><B
3782 CLASS="emphasis"
3783 >./bosserver -noauth &#38;</B
3784 ></SPAN
3785 >
3786 </PRE
3787 >      </P
3788 ></LI
3789 ><LI
3790 ><P
3791 ><A
3792 NAME="LIWQ109"
3793 ></A
3794 >If you run a system control machine, create the <SPAN
3795 CLASS="bold"
3796 ><B
3797 CLASS="emphasis"
3798 >upclientetc</B
3799 ></SPAN
3800 > process as an instance of the client portion of the Update Server. It accepts updates
3801             of the common configuration files stored in the system control machine's <SPAN
3802 CLASS="bold"
3803 ><B
3804 CLASS="emphasis"
3805 >/usr/afs/etc</B
3806 ></SPAN
3807 >
3808             directory from the <SPAN
3809 CLASS="bold"
3810 ><B
3811 CLASS="emphasis"
3812 >upserver</B
3813 ></SPAN
3814 > process (server portion of the Update Server) running on
3815             that machine. The cell's first file server machine was installed as the system control machine in <A
3816 HREF="c371.html#HDRWQ61"
3817 >Starting the Server Portion of the Update Server</A
3818 >. (If you do not run a system control machine,
3819             you must update the contents of the <SPAN
3820 CLASS="bold"
3821 ><B
3822 CLASS="emphasis"
3823 >/usr/afs/etc</B
3824 ></SPAN
3825 > directory on each file server machine,
3826             using the appropriate <SPAN
3827 CLASS="bold"
3828 ><B
3829 CLASS="emphasis"
3830 >bos</B
3831 ></SPAN
3832 > commands.)</P
3833 ><P
3834 >By default, the Update Server performs updates every 300 seconds (five minutes). Use the <SPAN
3835 CLASS="bold"
3836 ><B
3837 CLASS="emphasis"
3838 >-t</B
3839 ></SPAN
3840 > argument to specify a different number of seconds. For the
3841             <VAR
3842 CLASS="replaceable"
3843 >machine name</VAR
3844 > argument, substitute the name of the machine you are installing. The
3845             command appears on multiple lines here only for legibility reasons.</P
3846 ><PRE
3847 CLASS="programlisting"
3848 >&#13;   # <SPAN
3849 CLASS="bold"
3850 ><B
3851 CLASS="emphasis"
3852 >./bos create</B
3853 ></SPAN
3854 >  &#60;<VAR
3855 CLASS="replaceable"
3856 >machine name</VAR
3857 >&#62; <SPAN
3858 CLASS="bold"
3859 ><B
3860 CLASS="emphasis"
3861 >upclientetc simple</B
3862 ></SPAN
3863 >  \
3864          <SPAN
3865 CLASS="bold"
3866 ><B
3867 CLASS="emphasis"
3868 >"/usr/afs/bin/upclient</B
3869 ></SPAN
3870 >  &#60;<VAR
3871 CLASS="replaceable"
3872 >system control machine</VAR
3873 >&#62;  \
3874          [<SPAN
3875 CLASS="bold"
3876 ><B
3877 CLASS="emphasis"
3878 >-t</B
3879 ></SPAN
3880 >  &#60;<VAR
3881 CLASS="replaceable"
3882 >time</VAR
3883 >&#62;]  <SPAN
3884 CLASS="bold"
3885 ><B
3886 CLASS="emphasis"
3887 >/usr/afs/etc" -cell</B
3888 ></SPAN
3889 >  &#60;<VAR
3890 CLASS="replaceable"
3891 >cell name</VAR
3892 >&#62;  <SPAN
3893 CLASS="bold"
3894 ><B
3895 CLASS="emphasis"
3896 >-noauth</B
3897 ></SPAN
3898 >
3899 </PRE
3900 ></LI
3901 ><LI
3902 ><P
3903 ><A
3904 NAME="LIWQ110"
3905 ></A
3906 >Create an instance of the Update Server to handle distribution of the file server binaries
3907             stored in the <SPAN
3908 CLASS="bold"
3909 ><B
3910 CLASS="emphasis"
3911 >/usr/afs/bin</B
3912 ></SPAN
3913 > directory. <UL
3914 ><LI
3915 ><P
3916 >If this is the first file server machine of its AFS system type, create the <SPAN
3917 CLASS="bold"
3918 ><B
3919 CLASS="emphasis"
3920 >upserver</B
3921 ></SPAN
3922 > process as an instance of the server portion of the Update Server. It distributes
3923                   its copy of the file server process binaries to the other file server machines of this system type that you
3924                   install in future. Creating this process makes this machine the binary distribution machine for its type.
3925                   <PRE
3926 CLASS="programlisting"
3927 >&#13;   # <SPAN
3928 CLASS="bold"
3929 ><B
3930 CLASS="emphasis"
3931 >./bos create</B
3932 ></SPAN
3933 >  &#60;<VAR
3934 CLASS="replaceable"
3935 >machine name</VAR
3936 >&#62; <SPAN
3937 CLASS="bold"
3938 ><B
3939 CLASS="emphasis"
3940 >upserver  simple</B
3941 ></SPAN
3942 >  \
3943          <SPAN
3944 CLASS="bold"
3945 ><B
3946 CLASS="emphasis"
3947 >"/usr/afs/bin/upserver -clear /usr/afs/bin"</B
3948 ></SPAN
3949 >   \
3950          <SPAN
3951 CLASS="bold"
3952 ><B
3953 CLASS="emphasis"
3954 >-cell</B
3955 ></SPAN
3956 > &#60;<VAR
3957 CLASS="replaceable"
3958 >cell name</VAR
3959 >&#62;  <SPAN
3960 CLASS="bold"
3961 ><B
3962 CLASS="emphasis"
3963 >-noauth</B
3964 ></SPAN
3965 >
3966 </PRE
3967 ></P
3968 ></LI
3969 ><LI
3970 ><P
3971 >If this machine is an existing system type, create the <SPAN
3972 CLASS="bold"
3973 ><B
3974 CLASS="emphasis"
3975 >upclientbin</B
3976 ></SPAN
3977 > process
3978                   as an instance of the client portion of the Update Server. It accepts updates of the AFS binaries from the
3979                   <SPAN
3980 CLASS="bold"
3981 ><B
3982 CLASS="emphasis"
3983 >upserver</B
3984 ></SPAN
3985 > process running on the binary distribution machine for its system type.
3986                   For distribution to work properly, the <SPAN
3987 CLASS="bold"
3988 ><B
3989 CLASS="emphasis"
3990 >upserver</B
3991 ></SPAN
3992 > process must already by running
3993                   on that machine.</P
3994 ><P
3995 >Use the <SPAN
3996 CLASS="bold"
3997 ><B
3998 CLASS="emphasis"
3999 >-clear</B
4000 ></SPAN
4001 > argument to specify that the <SPAN
4002 CLASS="bold"
4003 ><B
4004 CLASS="emphasis"
4005 >upclientbin</B
4006 ></SPAN
4007 > process requests unencrypted transfer of the binaries in the <SPAN
4008 CLASS="bold"
4009 ><B
4010 CLASS="emphasis"
4011 >/usr/afs/bin</B
4012 ></SPAN
4013 > directory. Binaries are not sensitive and encrypting them is
4014                   time-consuming.</P
4015 ><P
4016 >By default, the Update Server performs updates every 300 seconds (five minutes). Use the <SPAN
4017 CLASS="bold"
4018 ><B
4019 CLASS="emphasis"
4020 >-t</B
4021 ></SPAN
4022 > argument to specify an different number of seconds.</P
4023 ><PRE
4024 CLASS="programlisting"
4025 >&#13;   # <SPAN
4026 CLASS="bold"
4027 ><B
4028 CLASS="emphasis"
4029 >./bos create</B
4030 ></SPAN
4031 >  &#60;<VAR
4032 CLASS="replaceable"
4033 >machine name</VAR
4034 >&#62; <SPAN
4035 CLASS="bold"
4036 ><B
4037 CLASS="emphasis"
4038 >upclientbin simple</B
4039 ></SPAN
4040 >  \
4041         <SPAN
4042 CLASS="bold"
4043 ><B
4044 CLASS="emphasis"
4045 >"/usr/afs/bin/upclient</B
4046 ></SPAN
4047 > &#60;<VAR
4048 CLASS="replaceable"
4049 >binary distribution machine</VAR
4050 >&#62;   \
4051         [<SPAN
4052 CLASS="bold"
4053 ><B
4054 CLASS="emphasis"
4055 >-t</B
4056 ></SPAN
4057 > &#60;<VAR
4058 CLASS="replaceable"
4059 >time</VAR
4060 >&#62;] <SPAN
4061 CLASS="bold"
4062 ><B
4063 CLASS="emphasis"
4064 >-clear /usr/afs/bin" -cell</B
4065 ></SPAN
4066 > &#60;<VAR
4067 CLASS="replaceable"
4068 >cell name</VAR
4069 >&#62;  <SPAN
4070 CLASS="bold"
4071 ><B
4072 CLASS="emphasis"
4073 >-noauth</B
4074 ></SPAN
4075 >
4076 </PRE
4077 ></LI
4078 ></UL
4079 ></P
4080 ></LI
4081 ><LI
4082 ><P
4083 >Start the <SPAN
4084 CLASS="bold"
4085 ><B
4086 CLASS="emphasis"
4087 >runntp</B
4088 ></SPAN
4089 > process, which configures the Network Time Protocol Daemon
4090             (NTPD) to choose a database server machine chosen randomly from the local <SPAN
4091 CLASS="bold"
4092 ><B
4093 CLASS="emphasis"
4094 >/usr/afs/etc/CellServDB</B
4095 ></SPAN
4096 > file as its time source. In the standard configuration, the first
4097             database server machine installed in your cell refers to a time source outside the cell, and serves as the basis for
4098             clock synchronization on all server machines. <PRE
4099 CLASS="programlisting"
4100 >&#13;   # <SPAN
4101 CLASS="bold"
4102 ><B
4103 CLASS="emphasis"
4104 >./bos create</B
4105 ></SPAN
4106 >  &#60;<VAR
4107 CLASS="replaceable"
4108 >machine name</VAR
4109 >&#62; <SPAN
4110 CLASS="bold"
4111 ><B
4112 CLASS="emphasis"
4113 >runntp simple</B
4114 ></SPAN
4115 >  \
4116          <SPAN
4117 CLASS="bold"
4118 ><B
4119 CLASS="emphasis"
4120 >/usr/afs/bin/runntp -cell</B
4121 ></SPAN
4122 > &#60;<VAR
4123 CLASS="replaceable"
4124 >cell name</VAR
4125 >&#62;  <SPAN
4126 CLASS="bold"
4127 ><B
4128 CLASS="emphasis"
4129 >-noauth</B
4130 ></SPAN
4131 >
4132 </PRE
4133 ></P
4134 ><DIV
4135 CLASS="note"
4136 ><BLOCKQUOTE
4137 CLASS="note"
4138 ><P
4139 ><B
4140 >Note: </B
4141 >Do not run the <SPAN
4142 CLASS="bold"
4143 ><B
4144 CLASS="emphasis"
4145 >runntp</B
4146 ></SPAN
4147 > process if NTPD or another time synchronization protocol
4148               is already running on the machine. Some versions of some operating systems run a time synchronization program by
4149               default, as detailed in the <SPAN
4150 CLASS="emphasis"
4151 ><I
4152 CLASS="emphasis"
4153 >IBM AFS Release Notes</I
4154 ></SPAN
4155 >.</P
4156 ><P
4157 >Attempting to run multiple instances of the NTPD causes an error. Running NTPD together with another time
4158               synchronization protocol is unnecessary and can cause instability in the clock setting.</P
4159 ></BLOCKQUOTE
4160 ></DIV
4161 ></LI
4162 ><LI
4163 ><P
4164 >Start the <SPAN
4165 CLASS="bold"
4166 ><B
4167 CLASS="emphasis"
4168 >fs</B
4169 ></SPAN
4170 > process, which binds together the File Server, Volume Server, and
4171             Salvager. <PRE
4172 CLASS="programlisting"
4173 >&#13;   # <SPAN
4174 CLASS="bold"
4175 ><B
4176 CLASS="emphasis"
4177 >./bos create</B
4178 ></SPAN
4179 >  &#60;<VAR
4180 CLASS="replaceable"
4181 >machine name</VAR
4182 >&#62; <SPAN
4183 CLASS="bold"
4184 ><B
4185 CLASS="emphasis"
4186 >fs fs</B
4187 ></SPAN
4188 >   \
4189          <SPAN
4190 CLASS="bold"
4191 ><B
4192 CLASS="emphasis"
4193 >/usr/afs/bin/fileserver /usr/afs/bin/volserver</B
4194 ></SPAN
4195 >  \
4196          <SPAN
4197 CLASS="bold"
4198 ><B
4199 CLASS="emphasis"
4200 >/usr/afs/bin/salvager -cell</B
4201 ></SPAN
4202 > &#60;<VAR
4203 CLASS="replaceable"
4204 >cell name</VAR
4205 >&#62;  <SPAN
4206 CLASS="bold"
4207 ><B
4208 CLASS="emphasis"
4209 >-noauth</B
4210 ></SPAN
4211 >
4212 </PRE
4213 ></P
4214 ></LI
4215 ></OL
4216 ></P
4217 ></DIV
4218 ><DIV
4219 CLASS="sect2"
4220 ><H2
4221 CLASS="sect2"
4222 ><A
4223 NAME="HDRWQ111"
4224 >Installing Client Functionality</A
4225 ></H2
4226 ><P
4227 >If you want this machine to be a client as well as a server, follow the instructions in this section. Otherwise, skip to
4228       <A
4229 HREF="c5467.html#HDRWQ112"
4230 >Completing the Installation</A
4231 >.</P
4232 ><P
4233 >Begin by loading the necessary client files to the local disk. Then create the necessary configuration files and start
4234       the Cache Manager. For more detailed explanation of the procedures involved, see the corresponding instructions in <A
4235 HREF="c371.html"
4236 >Installing the First AFS Machine</A
4237 > (in the sections following <A
4238 HREF="c371.html#HDRWQ63"
4239 >Overview:
4240       Installing Client Functionality</A
4241 >).</P
4242 ><P
4243 >If another AFS machine of this machine's system type exists, the AFS binaries are probably already accessible in your
4244       AFS filespace (the conventional location is <SPAN
4245 CLASS="bold"
4246 ><B
4247 CLASS="emphasis"
4248 >/afs/</B
4249 ></SPAN
4250 ><VAR
4251 CLASS="replaceable"
4252 >cellname</VAR
4253 ><SPAN
4254 CLASS="bold"
4255 ><B
4256 CLASS="emphasis"
4257 >/</B
4258 ></SPAN
4259 ><VAR
4260 CLASS="replaceable"
4261 >sysname</VAR
4262 ><SPAN
4263 CLASS="bold"
4264 ><B
4265 CLASS="emphasis"
4266 >/usr/afsws</B
4267 ></SPAN
4268 >). If not, or if this is
4269       the first AFS machine of its type, copy the AFS binaries for this system type into an AFS volume by following the instructions
4270       in <A
4271 HREF="c371.html#HDRWQ83"
4272 >Storing AFS Binaries in AFS</A
4273 >. Because this machine is not yet an AFS client, you must perform
4274       the procedure on an existing AFS machine. However, remember to perform the final step (linking the local directory <SPAN
4275 CLASS="bold"
4276 ><B
4277 CLASS="emphasis"
4278 >/usr/afsws</B
4279 ></SPAN
4280 > to the appropriate location in the AFS file tree) on this machine itself. If you also want
4281       to create AFS volumes to house UNIX system binaries for the new system type, see <A
4282 HREF="c371.html#HDRWQ88"
4283 >Storing System
4284       Binaries in AFS</A
4285 >.    <OL
4286 TYPE="1"
4287 ><LI
4288 ><P
4289 >Copy client binaries and files to the local disk. <UL
4290 ><LI
4291 ><P
4292 >On a machine of an existing system type, you can either load files from the AFS CD-ROM or use a remote file
4293                   transfer protocol to copy files from an existing server machine of the same system type. To load from the CD-ROM,
4294                   see the instructions just following for a machine of a new system type. If using a remote file transfer protocol,
4295                   copy the complete contents of the existing client machine's <SPAN
4296 CLASS="bold"
4297 ><B
4298 CLASS="emphasis"
4299 >/usr/vice/etc</B
4300 ></SPAN
4301 >
4302                   directory.</P
4303 ></LI
4304 ><LI
4305 ><P
4306 >On a machine of a new system type, you must use the following instructions to copy files from the AFS
4307                   CD-ROM. <OL
4308 TYPE="a"
4309 ><LI
4310 ><P
4311 >On the local <SPAN
4312 CLASS="bold"
4313 ><B
4314 CLASS="emphasis"
4315 >/cdrom</B
4316 ></SPAN
4317 > directory, mount the AFS CD-ROM for this
4318                         machine's system type, if it is not already. For instructions on mounting CD-ROMs (either locally or
4319                         remotely via NFS), consult the operating system documentation.</P
4320 ></LI
4321 ><LI
4322 ><P
4323 >Copy files to the local <SPAN
4324 CLASS="bold"
4325 ><B
4326 CLASS="emphasis"
4327 >/usr/vice/etc</B
4328 ></SPAN
4329 > directory.</P
4330 ><P
4331 >This step places a copy of the AFS initialization script (and related files, if applicable) into the
4332                         <SPAN
4333 CLASS="bold"
4334 ><B
4335 CLASS="emphasis"
4336 >/usr/vice/etc</B
4337 ></SPAN
4338 > directory. In the preceding instructions for incorporating
4339                         AFS into the kernel, you copied the script directly to the operating system's conventional location for
4340                         initialization files. When you incorporate AFS into the machine's startup sequence in a later step, you can
4341                         choose to link the two files.</P
4342 ><P
4343 >On some system types that use a dynamic kernel loader program, you previously copied AFS library files
4344                         into a subdirectory of the <SPAN
4345 CLASS="bold"
4346 ><B
4347 CLASS="emphasis"
4348 >/usr/vice/etc</B
4349 ></SPAN
4350 > directory. On other system types,
4351                         you copied the appropriate AFS library file directly to the directory where the operating system accesses
4352                         it. The following commands do not copy or recopy the AFS library files into the <SPAN
4353 CLASS="bold"
4354 ><B
4355 CLASS="emphasis"
4356 >/usr/vice/etc</B
4357 ></SPAN
4358 > directory, because on some system types the library files consume a
4359                         large amount of space. If you want to copy them, add the <SPAN
4360 CLASS="bold"
4361 ><B
4362 CLASS="emphasis"
4363 >-r</B
4364 ></SPAN
4365 > flag to the
4366                         first <SPAN
4367 CLASS="bold"
4368 ><B
4369 CLASS="emphasis"
4370 >cp</B
4371 ></SPAN
4372 > command and skip the second <SPAN
4373 CLASS="bold"
4374 ><B
4375 CLASS="emphasis"
4376 >cp</B
4377 ></SPAN
4378 >
4379                         command.</P
4380 ><PRE
4381 CLASS="programlisting"
4382 >&#13;   # <SPAN
4383 CLASS="bold"
4384 ><B
4385 CLASS="emphasis"
4386 >cd /cdrom/</B
4387 ></SPAN
4388 ><VAR
4389 CLASS="replaceable"
4390 >sysname</VAR
4391 ><SPAN
4392 CLASS="bold"
4393 ><B
4394 CLASS="emphasis"
4395 >/root.client/usr/vice/etc</B
4396 ></SPAN
4397 >
4398    # <SPAN
4399 CLASS="bold"
4400 ><B
4401 CLASS="emphasis"
4402 >cp -p  *  /usr/vice/etc</B
4403 ></SPAN
4404 >
4405    # <SPAN
4406 CLASS="bold"
4407 ><B
4408 CLASS="emphasis"
4409 >cp -rp  C  /usr/vice/etc</B
4410 ></SPAN
4411 >
4412 </PRE
4413 ></LI
4414 ></OL
4415 ></P
4416 ></LI
4417 ></UL
4418 ></P
4419 ></LI
4420 ><LI
4421 ><P
4422 >Change to the <SPAN
4423 CLASS="bold"
4424 ><B
4425 CLASS="emphasis"
4426 >/usr/vice/etc</B
4427 ></SPAN
4428 > directory and create the <SPAN
4429 CLASS="bold"
4430 ><B
4431 CLASS="emphasis"
4432 >ThisCell</B
4433 ></SPAN
4434 > file as a copy of the <SPAN
4435 CLASS="bold"
4436 ><B
4437 CLASS="emphasis"
4438 >/usr/afs/etc/ThisCell</B
4439 ></SPAN
4440 > file. You
4441             must first remove the symbolic link to the <SPAN
4442 CLASS="bold"
4443 ><B
4444 CLASS="emphasis"
4445 >/usr/afs/etc/ThisCell</B
4446 ></SPAN
4447 > file that the BOS
4448             Server created automatically in <A
4449 HREF="c5467.html#HDRWQ108"
4450 >Starting Server Programs</A
4451 >. <PRE
4452 CLASS="programlisting"
4453 >&#13;   # <SPAN
4454 CLASS="bold"
4455 ><B
4456 CLASS="emphasis"
4457 >cd  /usr/vice/etc</B
4458 ></SPAN
4459 >
4460    # <SPAN
4461 CLASS="bold"
4462 ><B
4463 CLASS="emphasis"
4464 >rm  ThisCell</B
4465 ></SPAN
4466 >
4467    # <SPAN
4468 CLASS="bold"
4469 ><B
4470 CLASS="emphasis"
4471 >cp  /usr/afs/etc/ThisCell  ThisCell</B
4472 ></SPAN
4473 >
4474 </PRE
4475 ></P
4476 ></LI
4477 ><LI
4478 ><P
4479 >Remove the symbolic link to the <SPAN
4480 CLASS="bold"
4481 ><B
4482 CLASS="emphasis"
4483 >/usr/afs/etc/CellServDB</B
4484 ></SPAN
4485 > file. <PRE
4486 CLASS="programlisting"
4487 >&#13;   # <SPAN
4488 CLASS="bold"
4489 ><B
4490 CLASS="emphasis"
4491 >rm  CellServDB</B
4492 ></SPAN
4493 >
4494 </PRE
4495 >   </P
4496 ></LI
4497 ><LI
4498 ><P
4499 >Create the <SPAN
4500 CLASS="bold"
4501 ><B
4502 CLASS="emphasis"
4503 >/usr/vice/etc/CellServDB</B
4504 ></SPAN
4505 > file. Use a network file transfer program
4506             such as <SPAN
4507 CLASS="bold"
4508 ><B
4509 CLASS="emphasis"
4510 >ftp</B
4511 ></SPAN
4512 > or NFS to copy it from one of the following sources, which are listed in
4513             decreasing order of preference: <UL
4514 ><LI
4515 ><P
4516 >Your cell's central <SPAN
4517 CLASS="bold"
4518 ><B
4519 CLASS="emphasis"
4520 >CellServDB</B
4521 ></SPAN
4522 > source file (the conventional location is
4523                   <SPAN
4524 CLASS="bold"
4525 ><B
4526 CLASS="emphasis"
4527 >/afs/</B
4528 ></SPAN
4529 ><VAR
4530 CLASS="replaceable"
4531 >cellname</VAR
4532 ><SPAN
4533 CLASS="bold"
4534 ><B
4535 CLASS="emphasis"
4536 >/common/etc/CellServDB</B
4537 ></SPAN
4538 >)</P
4539 ></LI
4540 ><LI
4541 ><P
4542 >The global <SPAN
4543 CLASS="bold"
4544 ><B
4545 CLASS="emphasis"
4546 >CellServDB</B
4547 ></SPAN
4548 > file maintained by the AFS Product Support
4549                   group</P
4550 ></LI
4551 ><LI
4552 ><P
4553 >An existing client machine in your cell</P
4554 ></LI
4555 ><LI
4556 ><P
4557 >The <SPAN
4558 CLASS="bold"
4559 ><B
4560 CLASS="emphasis"
4561 >CellServDB.sample</B
4562 ></SPAN
4563 > file included in the
4564                   <VAR
4565 CLASS="replaceable"
4566 >sysname</VAR
4567 ><SPAN
4568 CLASS="bold"
4569 ><B
4570 CLASS="emphasis"
4571 >/root.client/usr/vice/etc</B
4572 ></SPAN
4573 > directory of each AFS
4574                   CD-ROM; add an entry for the local cell by following the instructions in <A
4575 HREF="c371.html#HDRWQ66"
4576 >Creating the
4577                   Client CellServDB File</A
4578 ></P
4579 ></LI
4580 ></UL
4581 ></P
4582 ></LI
4583 ><LI
4584 ><P
4585 >Create the <SPAN
4586 CLASS="bold"
4587 ><B
4588 CLASS="emphasis"
4589 >cacheinfo</B
4590 ></SPAN
4591 > file for either a disk cache or a memory cache. For a
4592             discussion of the appropriate values to record in the file, see <A
4593 HREF="c371.html#HDRWQ67"
4594 >Configuring the
4595             Cache</A
4596 >.</P
4597 ><P
4598 >To configure a disk cache, issue the following commands. If you are devoting a partition exclusively to caching,
4599             as recommended, you must also configure it, make a file system on it, and mount it at the directory created in this
4600             step.</P
4601 ><PRE
4602 CLASS="programlisting"
4603 >&#13;   # <SPAN
4604 CLASS="bold"
4605 ><B
4606 CLASS="emphasis"
4607 >mkdir /usr/vice/cache</B
4608 ></SPAN
4609 >
4610    # <SPAN
4611 CLASS="bold"
4612 ><B
4613 CLASS="emphasis"
4614 >echo "/afs:/usr/vice/cache:</B
4615 ></SPAN
4616 ><VAR
4617 CLASS="replaceable"
4618 >#blocks</VAR
4619 ><SPAN
4620 CLASS="bold"
4621 ><B
4622 CLASS="emphasis"
4623 >" &#62; cacheinfo</B
4624 ></SPAN
4625 >
4626 </PRE
4627 ><P
4628 >To configure a memory cache:</P
4629 ><PRE
4630 CLASS="programlisting"
4631 >&#13;   # <SPAN
4632 CLASS="bold"
4633 ><B
4634 CLASS="emphasis"
4635 >echo "/afs:/usr/vice/cache:</B
4636 ></SPAN
4637 ><VAR
4638 CLASS="replaceable"
4639 >#blocks</VAR
4640 ><SPAN
4641 CLASS="bold"
4642 ><B
4643 CLASS="emphasis"
4644 >" &#62; cacheinfo</B
4645 ></SPAN
4646 >
4647 </PRE
4648 ></LI
4649 ><LI
4650 ><P
4651 >Create the local directory on which to mount the AFS filespace, by convention <SPAN
4652 CLASS="bold"
4653 ><B
4654 CLASS="emphasis"
4655 >/afs</B
4656 ></SPAN
4657 >. If the directory already exists, verify that it is empty. <PRE
4658 CLASS="programlisting"
4659 >&#13;   # <SPAN
4660 CLASS="bold"
4661 ><B
4662 CLASS="emphasis"
4663 >mkdir /afs</B
4664 ></SPAN
4665 >
4666 </PRE
4667 ></P
4668 ></LI
4669 ><LI
4670 ><P
4671 >On AIX systems, add the following line to the <SPAN
4672 CLASS="bold"
4673 ><B
4674 CLASS="emphasis"
4675 >/etc/vfs</B
4676 ></SPAN
4677 > file. It enables AIX to
4678             unmount AFS correctly during shutdown. <PRE
4679 CLASS="programlisting"
4680 >&#13;   afs     4     none     none
4681 </PRE
4682 ></P
4683 ></LI
4684 ><LI
4685 ><P
4686 >On Linux systems, copy the <SPAN
4687 CLASS="bold"
4688 ><B
4689 CLASS="emphasis"
4690 >afsd</B
4691 ></SPAN
4692 > options file from the <SPAN
4693 CLASS="bold"
4694 ><B
4695 CLASS="emphasis"
4696 >/usr/vice/etc</B
4697 ></SPAN
4698 > directory to the <SPAN
4699 CLASS="bold"
4700 ><B
4701 CLASS="emphasis"
4702 >/etc/sysconfig</B
4703 ></SPAN
4704 > directory,
4705             removing the <SPAN
4706 CLASS="bold"
4707 ><B
4708 CLASS="emphasis"
4709 >.conf</B
4710 ></SPAN
4711 > extension as you do so. <PRE
4712 CLASS="programlisting"
4713 >&#13;   # <SPAN
4714 CLASS="bold"
4715 ><B
4716 CLASS="emphasis"
4717 >cp /usr/vice/etc/afs.conf /etc/sysconfig/afs</B
4718 ></SPAN
4719 >
4720 </PRE
4721 ></P
4722 ></LI
4723 ><LI
4724 ><P
4725 >Edit the machine's AFS initialization script or <SPAN
4726 CLASS="bold"
4727 ><B
4728 CLASS="emphasis"
4729 >afsd</B
4730 ></SPAN
4731 > options file to set
4732             appropriate values for <SPAN
4733 CLASS="bold"
4734 ><B
4735 CLASS="emphasis"
4736 >afsd</B
4737 ></SPAN
4738 > command parameters. The script resides in the indicated
4739             location on each system type: <UL
4740 ><LI
4741 ><P
4742 >On AIX systems, <SPAN
4743 CLASS="bold"
4744 ><B
4745 CLASS="emphasis"
4746 >/etc/rc.afs</B
4747 ></SPAN
4748 ></P
4749 ></LI
4750 ><LI
4751 ><P
4752 >On Digital UNIX systems, <SPAN
4753 CLASS="bold"
4754 ><B
4755 CLASS="emphasis"
4756 >/sbin/init.d/afs</B
4757 ></SPAN
4758 ></P
4759 ></LI
4760 ><LI
4761 ><P
4762 >On HP-UX systems, <SPAN
4763 CLASS="bold"
4764 ><B
4765 CLASS="emphasis"
4766 >/sbin/init.d/afs</B
4767 ></SPAN
4768 ></P
4769 ></LI
4770 ><LI
4771 ><P
4772 >On IRIX systems, <SPAN
4773 CLASS="bold"
4774 ><B
4775 CLASS="emphasis"
4776 >/etc/init.d/afs</B
4777 ></SPAN
4778 ></P
4779 ></LI
4780 ><LI
4781 ><P
4782 >On Linux systems, <SPAN
4783 CLASS="bold"
4784 ><B
4785 CLASS="emphasis"
4786 >/etc/sysconfig/afs</B
4787 ></SPAN
4788 > (the <SPAN
4789 CLASS="bold"
4790 ><B
4791 CLASS="emphasis"
4792 >afsd</B
4793 ></SPAN
4794 > options file)</P
4795 ></LI
4796 ><LI
4797 ><P
4798 >On Solaris systems, <SPAN
4799 CLASS="bold"
4800 ><B
4801 CLASS="emphasis"
4802 >/etc/init.d/afs</B
4803 ></SPAN
4804 ></P
4805 ></LI
4806 ></UL
4807 ></P
4808 ><P
4809 >Use one of the methods described in <A
4810 HREF="c371.html#HDRWQ70"
4811 >Configuring the Cache Manager</A
4812 > to add the
4813             following flags to the <SPAN
4814 CLASS="bold"
4815 ><B
4816 CLASS="emphasis"
4817 >afsd</B
4818 ></SPAN
4819 > command line. If you intend for the machine to remain an
4820             AFS client, also set any performance-related arguments you wish. <UL
4821 ><LI
4822 ><P
4823 >Add the <SPAN
4824 CLASS="bold"
4825 ><B
4826 CLASS="emphasis"
4827 >-nosettime</B
4828 ></SPAN
4829 > flag, because this is a file server machine that is also
4830                   a client.</P
4831 ></LI
4832 ><LI
4833 ><P
4834 >Add the <SPAN
4835 CLASS="bold"
4836 ><B
4837 CLASS="emphasis"
4838 >-memcache</B
4839 ></SPAN
4840 > flag if the machine is to use a memory cache.</P
4841 ></LI
4842 ><LI
4843 ><P
4844 >Add the <SPAN
4845 CLASS="bold"
4846 ><B
4847 CLASS="emphasis"
4848 >-verbose</B
4849 ></SPAN
4850 > flag to display a trace of the Cache Manager's
4851                   initialization on the standard output stream.</P
4852 ></LI
4853 ></UL
4854 ></P
4855 ></LI
4856 ><LI
4857 ><P
4858 >If appropriate, follow the instructions in <A
4859 HREF="c371.html#HDRWQ83"
4860 >Storing AFS Binaries in AFS</A
4861 > to copy the
4862             AFS binaries for this system type into an AFS volume. See the introduction to this section for further
4863             discussion.</P
4864 ></LI
4865 ></OL
4866 ></P
4867 ></DIV
4868 ><DIV
4869 CLASS="sect2"
4870 ><H2
4871 CLASS="sect2"
4872 ><A
4873 NAME="HDRWQ112"
4874 >Completing the Installation</A
4875 ></H2
4876 ><P
4877 >At this point you run the machine's AFS initialization script to verify that it correctly loads AFS modifications into
4878       the kernel and starts the BOS Server, which starts the other server processes. If you have installed client files, the script
4879       also starts the Cache Manager. If the script works correctly, perform the steps that incorporate it into the machine's startup
4880       and shutdown sequence. If there are problems during the initialization, attempt to resolve them. The AFS Product Support group
4881       can provide assistance if necessary.</P
4882 ><P
4883 >If the machine is configured as a client using a disk cache, it can take a while for the <SPAN
4884 CLASS="bold"
4885 ><B
4886 CLASS="emphasis"
4887 >afsd</B
4888 ></SPAN
4889 > program to create all of the <SPAN
4890 CLASS="bold"
4891 ><B
4892 CLASS="emphasis"
4893 >V</B
4894 ></SPAN
4895 ><VAR
4896 CLASS="replaceable"
4897 >n</VAR
4898 > files
4899       in the cache directory. Messages on the console trace the initialization process. <OL
4900 TYPE="1"
4901 ><LI
4902 ><P
4903 >Issue the <SPAN
4904 CLASS="bold"
4905 ><B
4906 CLASS="emphasis"
4907 >bos shutdown</B
4908 ></SPAN
4909 > command to shut down the AFS server processes other than
4910             the BOS Server. Include the <SPAN
4911 CLASS="bold"
4912 ><B
4913 CLASS="emphasis"
4914 >-wait</B
4915 ></SPAN
4916 > flag to delay return of the command shell prompt
4917             until all processes shut down completely. <PRE
4918 CLASS="programlisting"
4919 >&#13;   # <SPAN
4920 CLASS="bold"
4921 ><B
4922 CLASS="emphasis"
4923 >/usr/afs/bin/bos shutdown</B
4924 ></SPAN
4925 > &#60;<VAR
4926 CLASS="replaceable"
4927 >machine name</VAR
4928 >&#62; <SPAN
4929 CLASS="bold"
4930 ><B
4931 CLASS="emphasis"
4932 >-wait</B
4933 ></SPAN
4934 >
4935 </PRE
4936 ></P
4937 ></LI
4938 ><LI
4939 ><P
4940 >Issue the <SPAN
4941 CLASS="bold"
4942 ><B
4943 CLASS="emphasis"
4944 >ps</B
4945 ></SPAN
4946 > command to learn the BOS Server's process ID number (PID), and then
4947             the <SPAN
4948 CLASS="bold"
4949 ><B
4950 CLASS="emphasis"
4951 >kill</B
4952 ></SPAN
4953 > command to stop the <SPAN
4954 CLASS="bold"
4955 ><B
4956 CLASS="emphasis"
4957 >bosserver</B
4958 ></SPAN
4959 > process.
4960             <PRE
4961 CLASS="programlisting"
4962 >&#13;   # <SPAN
4963 CLASS="bold"
4964 ><B
4965 CLASS="emphasis"
4966 >ps</B
4967 ></SPAN
4968 > <VAR
4969 CLASS="replaceable"
4970 >appropriate_ps_options</VAR
4971 > <SPAN
4972 CLASS="bold"
4973 ><B
4974 CLASS="emphasis"
4975 >| grep bosserver</B
4976 ></SPAN
4977 >
4978    # <SPAN
4979 CLASS="bold"
4980 ><B
4981 CLASS="emphasis"
4982 >kill</B
4983 ></SPAN
4984 > <VAR
4985 CLASS="replaceable"
4986 >bosserver_PID</VAR
4987 >
4988 </PRE
4989 >      </P
4990 ></LI
4991 ><LI
4992 ><P
4993 >Run the AFS initialization script by issuing the appropriate commands for this system type.</P
4994 ><P
4995 ><SPAN
4996 CLASS="bold"
4997 ><B
4998 CLASS="emphasis"
4999 >On AIX systems:</B
5000 ></SPAN
5001 > <OL
5002 TYPE="a"
5003 ><LI
5004 ><P
5005 >Reboot the machine and log in again as the local superuser <SPAN
5006 CLASS="bold"
5007 ><B
5008 CLASS="emphasis"
5009 >root</B
5010 ></SPAN
5011 >.
5012                   <PRE
5013 CLASS="programlisting"
5014 >&#13;   # <SPAN
5015 CLASS="bold"
5016 ><B
5017 CLASS="emphasis"
5018 >cd /</B
5019 ></SPAN
5020 >
5021    # <SPAN
5022 CLASS="bold"
5023 ><B
5024 CLASS="emphasis"
5025 >shutdown -r now</B
5026 ></SPAN
5027 >
5028    login: <SPAN
5029 CLASS="bold"
5030 ><B
5031 CLASS="emphasis"
5032 >root</B
5033 ></SPAN
5034 >
5035    Password: <VAR
5036 CLASS="replaceable"
5037 >root_password</VAR
5038 >
5039 </PRE
5040 ></P
5041 ></LI
5042 ><LI
5043 ><P
5044 >Run the AFS initialization script. <PRE
5045 CLASS="programlisting"
5046 >&#13;   # <SPAN
5047 CLASS="bold"
5048 ><B
5049 CLASS="emphasis"
5050 >/etc/rc.afs</B
5051 ></SPAN
5052 >
5053 </PRE
5054 ></P
5055 ></LI
5056 ><LI
5057 ><P
5058 >Edit the AIX initialization file, <SPAN
5059 CLASS="bold"
5060 ><B
5061 CLASS="emphasis"
5062 >/etc/inittab</B
5063 ></SPAN
5064 >, adding the following line
5065                   to invoke the AFS initialization script. Place it just after the line that starts NFS daemons. <PRE
5066 CLASS="programlisting"
5067 >&#13;   rcafs:2:wait:/etc/rc.afs &#62; /dev/console 2&#62;&#38;1 # Start AFS services
5068 </PRE
5069 ></P
5070 ></LI
5071 ><LI
5072 ><P
5073 ><SPAN
5074 CLASS="bold"
5075 ><B
5076 CLASS="emphasis"
5077 >(Optional)</B
5078 ></SPAN
5079 > There are now copies of the AFS initialization file in both the
5080                   <SPAN
5081 CLASS="bold"
5082 ><B
5083 CLASS="emphasis"
5084 >/usr/vice/etc</B
5085 ></SPAN
5086 > and <SPAN
5087 CLASS="bold"
5088 ><B
5089 CLASS="emphasis"
5090 >/etc</B
5091 ></SPAN
5092 > directories. If you want
5093                   to avoid potential confusion by guaranteeing that they are always the same, create a link between them. You can
5094                   always retrieve the original script from the AFS CD-ROM if necessary. <PRE
5095 CLASS="programlisting"
5096 >&#13;   # <SPAN
5097 CLASS="bold"
5098 ><B
5099 CLASS="emphasis"
5100 >cd  /usr/vice/etc</B
5101 ></SPAN
5102 >
5103    # <SPAN
5104 CLASS="bold"
5105 ><B
5106 CLASS="emphasis"
5107 >rm  rc.afs</B
5108 ></SPAN
5109 >
5110    # <SPAN
5111 CLASS="bold"
5112 ><B
5113 CLASS="emphasis"
5114 >ln -s  /etc/rc.afs</B
5115 ></SPAN
5116 >
5117 </PRE
5118 ></P
5119 ></LI
5120 ><LI
5121 ><P
5122 >Proceed to Step <A
5123 HREF="c5467.html#LIWQ113"
5124 >4</A
5125 >.</P
5126 ></LI
5127 ></OL
5128 ></P
5129 ><P
5130 ><SPAN
5131 CLASS="bold"
5132 ><B
5133 CLASS="emphasis"
5134 >On Digital UNIX systems:</B
5135 ></SPAN
5136 > <OL
5137 TYPE="a"
5138 ><LI
5139 ><P
5140 >Run the AFS initialization script. <PRE
5141 CLASS="programlisting"
5142 >&#13;   # <SPAN
5143 CLASS="bold"
5144 ><B
5145 CLASS="emphasis"
5146 >/sbin/init.d/afs  start</B
5147 ></SPAN
5148 >
5149 </PRE
5150 ></P
5151 ></LI
5152 ><LI
5153 ><P
5154 >Change to the <SPAN
5155 CLASS="bold"
5156 ><B
5157 CLASS="emphasis"
5158 >/sbin/init.d</B
5159 ></SPAN
5160 > directory and issue the <SPAN
5161 CLASS="bold"
5162 ><B
5163 CLASS="emphasis"
5164 >ln
5165                   -s</B
5166 ></SPAN
5167 > command to create symbolic links that incorporate the AFS initialization script into the Digital
5168                   UNIX startup and shutdown sequence. <PRE
5169 CLASS="programlisting"
5170 >&#13;   # <SPAN
5171 CLASS="bold"
5172 ><B
5173 CLASS="emphasis"
5174 >cd  /sbin/init.d</B
5175 ></SPAN
5176 >
5177    # <SPAN
5178 CLASS="bold"
5179 ><B
5180 CLASS="emphasis"
5181 >ln -s  ../init.d/afs  /sbin/rc3.d/S67afs</B
5182 ></SPAN
5183 >
5184    # <SPAN
5185 CLASS="bold"
5186 ><B
5187 CLASS="emphasis"
5188 >ln -s  ../init.d/afs  /sbin/rc0.d/K66afs</B
5189 ></SPAN
5190 >
5191 </PRE
5192 ></P
5193 ></LI
5194 ><LI
5195 ><P
5196 ><SPAN
5197 CLASS="bold"
5198 ><B
5199 CLASS="emphasis"
5200 >(Optional)</B
5201 ></SPAN
5202 > There are now copies of the AFS initialization file in both the
5203                   <SPAN
5204 CLASS="bold"
5205 ><B
5206 CLASS="emphasis"
5207 >/usr/vice/etc</B
5208 ></SPAN
5209 > and <SPAN
5210 CLASS="bold"
5211 ><B
5212 CLASS="emphasis"
5213 >/sbin/init.d</B
5214 ></SPAN
5215 > directories. If
5216                   you want to avoid potential confusion by guaranteeing that they are always the same, create a link between them.
5217                   You can always retrieve the original script from the AFS CD-ROM if necessary. <PRE
5218 CLASS="programlisting"
5219 >&#13;   # <SPAN
5220 CLASS="bold"
5221 ><B
5222 CLASS="emphasis"
5223 >cd /usr/vice/etc</B
5224 ></SPAN
5225 >
5226    # <SPAN
5227 CLASS="bold"
5228 ><B
5229 CLASS="emphasis"
5230 >rm afs.rc</B
5231 ></SPAN
5232 >
5233    # <SPAN
5234 CLASS="bold"
5235 ><B
5236 CLASS="emphasis"
5237 >ln -s  /sbin/init.d/afs  afs.rc</B
5238 ></SPAN
5239 >
5240 </PRE
5241 ></P
5242 ></LI
5243 ><LI
5244 ><P
5245 >Proceed to Step <A
5246 HREF="c5467.html#LIWQ113"
5247 >4</A
5248 >.</P
5249 ></LI
5250 ></OL
5251 ></P
5252 ><P
5253 ><SPAN
5254 CLASS="bold"
5255 ><B
5256 CLASS="emphasis"
5257 >On HP-UX systems:</B
5258 ></SPAN
5259 > <OL
5260 TYPE="a"
5261 ><LI
5262 ><P
5263 >Run the AFS initialization script. <PRE
5264 CLASS="programlisting"
5265 >&#13;   # <SPAN
5266 CLASS="bold"
5267 ><B
5268 CLASS="emphasis"
5269 >/sbin/init.d/afs  start</B
5270 ></SPAN
5271 >
5272 </PRE
5273 ></P
5274 ></LI
5275 ><LI
5276 ><P
5277 >Change to the <SPAN
5278 CLASS="bold"
5279 ><B
5280 CLASS="emphasis"
5281 >/sbin/init.d</B
5282 ></SPAN
5283 > directory and issue the <SPAN
5284 CLASS="bold"
5285 ><B
5286 CLASS="emphasis"
5287 >ln
5288                   -s</B
5289 ></SPAN
5290 > command to create symbolic links that incorporate the AFS initialization script into the HP-UX
5291                   startup and shutdown sequence. <PRE
5292 CLASS="programlisting"
5293 >&#13;   # <SPAN
5294 CLASS="bold"
5295 ><B
5296 CLASS="emphasis"
5297 >cd /sbin/init.d</B
5298 ></SPAN
5299 >
5300    # <SPAN
5301 CLASS="bold"
5302 ><B
5303 CLASS="emphasis"
5304 >ln -s ../init.d/afs /sbin/rc2.d/S460afs</B
5305 ></SPAN
5306 >
5307    # <SPAN
5308 CLASS="bold"
5309 ><B
5310 CLASS="emphasis"
5311 >ln -s ../init.d/afs /sbin/rc2.d/K800afs</B
5312 ></SPAN
5313 >
5314 </PRE
5315 ></P
5316 ></LI
5317 ><LI
5318 ><P
5319 ><SPAN
5320 CLASS="bold"
5321 ><B
5322 CLASS="emphasis"
5323 >(Optional)</B
5324 ></SPAN
5325 > There are now copies of the AFS initialization file in both the
5326                   <SPAN
5327 CLASS="bold"
5328 ><B
5329 CLASS="emphasis"
5330 >/usr/vice/etc</B
5331 ></SPAN
5332 > and <SPAN
5333 CLASS="bold"
5334 ><B
5335 CLASS="emphasis"
5336 >/sbin/init.d</B
5337 ></SPAN
5338 > directories. If
5339                   you want to avoid potential confusion by guaranteeing that they are always the same, create a link between them.
5340                   You can always retrieve the original script from the AFS CD-ROM if necessary. <PRE
5341 CLASS="programlisting"
5342 >&#13;   # <SPAN
5343 CLASS="bold"
5344 ><B
5345 CLASS="emphasis"
5346 >cd /usr/vice/etc</B
5347 ></SPAN
5348 >
5349    # <SPAN
5350 CLASS="bold"
5351 ><B
5352 CLASS="emphasis"
5353 >rm afs.rc</B
5354 ></SPAN
5355 >
5356    # <SPAN
5357 CLASS="bold"
5358 ><B
5359 CLASS="emphasis"
5360 >ln -s  /sbin/init.d/afs  afs.rc</B
5361 ></SPAN
5362 >
5363 </PRE
5364 ></P
5365 ></LI
5366 ><LI
5367 ><P
5368 >Proceed to Step <A
5369 HREF="c5467.html#LIWQ113"
5370 >4</A
5371 >.</P
5372 ></LI
5373 ></OL
5374 ></P
5375 ><P
5376 ><SPAN
5377 CLASS="bold"
5378 ><B
5379 CLASS="emphasis"
5380 >On IRIX systems:</B
5381 ></SPAN
5382 > <OL
5383 TYPE="a"
5384 ><LI
5385 ><P
5386 >If you have configured the machine to use the <SPAN
5387 CLASS="bold"
5388 ><B
5389 CLASS="emphasis"
5390 >ml</B
5391 ></SPAN
5392 > dynamic loader program,
5393                   reboot the machine and log in again as the local superuser <SPAN
5394 CLASS="bold"
5395 ><B
5396 CLASS="emphasis"
5397 >root</B
5398 ></SPAN
5399 >. <PRE
5400 CLASS="programlisting"
5401 >&#13;   # <SPAN
5402 CLASS="bold"
5403 ><B
5404 CLASS="emphasis"
5405 >cd /</B
5406 ></SPAN
5407 >
5408    # <SPAN
5409 CLASS="bold"
5410 ><B
5411 CLASS="emphasis"
5412 >shutdown -i6 -g0 -y</B
5413 ></SPAN
5414 >
5415    login: <SPAN
5416 CLASS="bold"
5417 ><B
5418 CLASS="emphasis"
5419 >root</B
5420 ></SPAN
5421 >
5422    Password: <VAR
5423 CLASS="replaceable"
5424 >root_password</VAR
5425 >
5426 </PRE
5427 ></P
5428 ></LI
5429 ><LI
5430 ><P
5431 >Issue the <SPAN
5432 CLASS="bold"
5433 ><B
5434 CLASS="emphasis"
5435 >chkconfig</B
5436 ></SPAN
5437 > command to activate the <SPAN
5438 CLASS="bold"
5439 ><B
5440 CLASS="emphasis"
5441 >afsserver</B
5442 ></SPAN
5443 > configuration variable. <PRE
5444 CLASS="programlisting"
5445 >&#13;   # <SPAN
5446 CLASS="bold"
5447 ><B
5448 CLASS="emphasis"
5449 >/etc/chkconfig -f afsserver on</B
5450 ></SPAN
5451 >
5452 </PRE
5453 ></P
5454 ><P
5455 >If you have configured this machine as an AFS client and want to it remain one, also issue the <SPAN
5456 CLASS="bold"
5457 ><B
5458 CLASS="emphasis"
5459 >chkconfig</B
5460 ></SPAN
5461 > command to activate the <SPAN
5462 CLASS="bold"
5463 ><B
5464 CLASS="emphasis"
5465 >afsclient</B
5466 ></SPAN
5467 > configuration
5468                   variable.</P
5469 ><PRE
5470 CLASS="programlisting"
5471 >&#13;   # <SPAN
5472 CLASS="bold"
5473 ><B
5474 CLASS="emphasis"
5475 >/etc/chkconfig -f afsclient on</B
5476 ></SPAN
5477 >
5478 </PRE
5479 ></LI
5480 ><LI
5481 ><P
5482 >Run the AFS initialization script. <PRE
5483 CLASS="programlisting"
5484 >&#13;   # <SPAN
5485 CLASS="bold"
5486 ><B
5487 CLASS="emphasis"
5488 >/etc/init.d/afs  start</B
5489 ></SPAN
5490 >
5491 </PRE
5492 ></P
5493 ></LI
5494 ><LI
5495 ><P
5496 >Change to the <SPAN
5497 CLASS="bold"
5498 ><B
5499 CLASS="emphasis"
5500 >/etc/init.d</B
5501 ></SPAN
5502 > directory and issue the <SPAN
5503 CLASS="bold"
5504 ><B
5505 CLASS="emphasis"
5506 >ln
5507                   -s</B
5508 ></SPAN
5509 > command to create symbolic links that incorporate the AFS initialization script into the IRIX
5510                   startup and shutdown sequence. <PRE
5511 CLASS="programlisting"
5512 >&#13;   # <SPAN
5513 CLASS="bold"
5514 ><B
5515 CLASS="emphasis"
5516 >cd /etc/init.d</B
5517 ></SPAN
5518 >
5519    # <SPAN
5520 CLASS="bold"
5521 ><B
5522 CLASS="emphasis"
5523 >ln -s ../init.d/afs /etc/rc2.d/S35afs</B
5524 ></SPAN
5525 >
5526    # <SPAN
5527 CLASS="bold"
5528 ><B
5529 CLASS="emphasis"
5530 >ln -s ../init.d/afs /etc/rc0.d/K35afs</B
5531 ></SPAN
5532 >
5533 </PRE
5534 ></P
5535 ></LI
5536 ><LI
5537 ><P
5538 ><SPAN
5539 CLASS="bold"
5540 ><B
5541 CLASS="emphasis"
5542 >(Optional)</B
5543 ></SPAN
5544 > There are now copies of the AFS initialization file in both the
5545                   <SPAN
5546 CLASS="bold"
5547 ><B
5548 CLASS="emphasis"
5549 >/usr/vice/etc</B
5550 ></SPAN
5551 > and <SPAN
5552 CLASS="bold"
5553 ><B
5554 CLASS="emphasis"
5555 >/etc/init.d</B
5556 ></SPAN
5557 > directories. If
5558                   you want to avoid potential confusion by guaranteeing that they are always the same, create a link between them.
5559                   You can always retrieve the original script from the AFS CD-ROM if necessary. <PRE
5560 CLASS="programlisting"
5561 >&#13;   # <SPAN
5562 CLASS="bold"
5563 ><B
5564 CLASS="emphasis"
5565 >cd /usr/vice/etc</B
5566 ></SPAN
5567 >
5568    # <SPAN
5569 CLASS="bold"
5570 ><B
5571 CLASS="emphasis"
5572 >rm afs.rc</B
5573 ></SPAN
5574 >
5575    # <SPAN
5576 CLASS="bold"
5577 ><B
5578 CLASS="emphasis"
5579 >ln -s  /etc/init.d/afs  afs.rc</B
5580 ></SPAN
5581 >
5582 </PRE
5583 ></P
5584 ></LI
5585 ><LI
5586 ><P
5587 >Proceed to Step <A
5588 HREF="c5467.html#LIWQ113"
5589 >4</A
5590 >.</P
5591 ></LI
5592 ></OL
5593 ></P
5594 ><P
5595 ><SPAN
5596 CLASS="bold"
5597 ><B
5598 CLASS="emphasis"
5599 >On Linux systems:</B
5600 ></SPAN
5601 > <OL
5602 TYPE="a"
5603 ><LI
5604 ><P
5605 >Reboot the machine and log in again as the local superuser <SPAN
5606 CLASS="bold"
5607 ><B
5608 CLASS="emphasis"
5609 >root</B
5610 ></SPAN
5611 >.
5612                   <PRE
5613 CLASS="programlisting"
5614 >&#13;   # <SPAN
5615 CLASS="bold"
5616 ><B
5617 CLASS="emphasis"
5618 >cd /</B
5619 ></SPAN
5620 >
5621    # <SPAN
5622 CLASS="bold"
5623 ><B
5624 CLASS="emphasis"
5625 >shutdown -r now</B
5626 ></SPAN
5627 >
5628    login: <SPAN
5629 CLASS="bold"
5630 ><B
5631 CLASS="emphasis"
5632 >root</B
5633 ></SPAN
5634 >
5635    Password: <VAR
5636 CLASS="replaceable"
5637 >root_password</VAR
5638 >
5639 </PRE
5640 ></P
5641 ></LI
5642 ><LI
5643 ><P
5644 >Run the AFS initialization script. <PRE
5645 CLASS="programlisting"
5646 >&#13;   # <SPAN
5647 CLASS="bold"
5648 ><B
5649 CLASS="emphasis"
5650 >/etc/rc.d/init.d/afs  start</B
5651 ></SPAN
5652 >
5653 </PRE
5654 ></P
5655 ></LI
5656 ><LI
5657 ><P
5658 >Issue the <SPAN
5659 CLASS="bold"
5660 ><B
5661 CLASS="emphasis"
5662 >chkconfig</B
5663 ></SPAN
5664 > command to activate the <SPAN
5665 CLASS="bold"
5666 ><B
5667 CLASS="emphasis"
5668 >afs</B
5669 ></SPAN
5670 > configuration variable. Based on the instruction in the AFS initialization file that
5671                   begins with the string <SAMP
5672 CLASS="computeroutput"
5673 >#chkconfig</SAMP
5674 >, the command automatically creates the symbolic
5675                   links that incorporate the script into the Linux startup and shutdown sequence. <PRE
5676 CLASS="programlisting"
5677 >&#13;   # <SPAN
5678 CLASS="bold"
5679 ><B
5680 CLASS="emphasis"
5681 >/sbin/chkconfig  --add afs</B
5682 ></SPAN
5683 >
5684 </PRE
5685 ></P
5686 ></LI
5687 ><LI
5688 ><P
5689 ><SPAN
5690 CLASS="bold"
5691 ><B
5692 CLASS="emphasis"
5693 >(Optional)</B
5694 ></SPAN
5695 > There are now copies of the AFS initialization file in both the
5696                   <SPAN
5697 CLASS="bold"
5698 ><B
5699 CLASS="emphasis"
5700 >/usr/vice/etc</B
5701 ></SPAN
5702 > and <SPAN
5703 CLASS="bold"
5704 ><B
5705 CLASS="emphasis"
5706 >/etc/rc.d/init.d</B
5707 ></SPAN
5708 > directories,
5709                   and copies of the <SPAN
5710 CLASS="bold"
5711 ><B
5712 CLASS="emphasis"
5713 >afsd</B
5714 ></SPAN
5715 > options file in both the <SPAN
5716 CLASS="bold"
5717 ><B
5718 CLASS="emphasis"
5719 >/usr/vice/etc</B
5720 ></SPAN
5721 > and <SPAN
5722 CLASS="bold"
5723 ><B
5724 CLASS="emphasis"
5725 >/etc/sysconfig</B
5726 ></SPAN
5727 > directories. If you want
5728                   to avoid potential confusion by guaranteeing that the two copies of each file are always the same, create a link
5729                   between them. You can always retrieve the original script or options file from the AFS CD-ROM if necessary.
5730                   <PRE
5731 CLASS="programlisting"
5732 >&#13;   # <SPAN
5733 CLASS="bold"
5734 ><B
5735 CLASS="emphasis"
5736 >cd /usr/vice/etc</B
5737 ></SPAN
5738 >
5739    # <SPAN
5740 CLASS="bold"
5741 ><B
5742 CLASS="emphasis"
5743 >rm afs.rc afs.conf</B
5744 ></SPAN
5745 >
5746    # <SPAN
5747 CLASS="bold"
5748 ><B
5749 CLASS="emphasis"
5750 >ln -s  /etc/rc.d/init.d/afs  afs.rc</B
5751 ></SPAN
5752 >
5753    # <SPAN
5754 CLASS="bold"
5755 ><B
5756 CLASS="emphasis"
5757 >ln -s  /etc/sysconfig/afs  afs.conf</B
5758 ></SPAN
5759 >
5760 </PRE
5761 ></P
5762 ></LI
5763 ><LI
5764 ><P
5765 >Proceed to Step <A
5766 HREF="c5467.html#LIWQ113"
5767 >4</A
5768 >.</P
5769 ></LI
5770 ></OL
5771 ></P
5772 ><P
5773 ><SPAN
5774 CLASS="bold"
5775 ><B
5776 CLASS="emphasis"
5777 >On Solaris systems:</B
5778 ></SPAN
5779 > <OL
5780 TYPE="a"
5781 ><LI
5782 ><P
5783 >Reboot the machine and log in again as the local superuser <SPAN
5784 CLASS="bold"
5785 ><B
5786 CLASS="emphasis"
5787 >root</B
5788 ></SPAN
5789 >.
5790                   <PRE
5791 CLASS="programlisting"
5792 >&#13;   # <SPAN
5793 CLASS="bold"
5794 ><B
5795 CLASS="emphasis"
5796 >cd /</B
5797 ></SPAN
5798 >
5799    # <SPAN
5800 CLASS="bold"
5801 ><B
5802 CLASS="emphasis"
5803 >shutdown -i6 -g0 -y</B
5804 ></SPAN
5805 >
5806    login: <SPAN
5807 CLASS="bold"
5808 ><B
5809 CLASS="emphasis"
5810 >root</B
5811 ></SPAN
5812 >
5813    Password: <VAR
5814 CLASS="replaceable"
5815 >root_password</VAR
5816 >
5817 </PRE
5818 ></P
5819 ></LI
5820 ><LI
5821 ><P
5822 >Run the AFS initialization script. <PRE
5823 CLASS="programlisting"
5824 >&#13;   # <SPAN
5825 CLASS="bold"
5826 ><B
5827 CLASS="emphasis"
5828 >/etc/init.d/afs  start</B
5829 ></SPAN
5830 >
5831 </PRE
5832 ></P
5833 ></LI
5834 ><LI
5835 ><P
5836 >Change to the <SPAN
5837 CLASS="bold"
5838 ><B
5839 CLASS="emphasis"
5840 >/etc/init.d</B
5841 ></SPAN
5842 > directory and issue the <SPAN
5843 CLASS="bold"
5844 ><B
5845 CLASS="emphasis"
5846 >ln
5847                   -s</B
5848 ></SPAN
5849 > command to create symbolic links that incorporate the AFS initialization script into the Solaris
5850                   startup and shutdown sequence. <PRE
5851 CLASS="programlisting"
5852 >&#13;   # <SPAN
5853 CLASS="bold"
5854 ><B
5855 CLASS="emphasis"
5856 >cd /etc/init.d</B
5857 ></SPAN
5858 >
5859    # <SPAN
5860 CLASS="bold"
5861 ><B
5862 CLASS="emphasis"
5863 >ln -s ../init.d/afs /etc/rc3.d/S99afs</B
5864 ></SPAN
5865 >
5866    # <SPAN
5867 CLASS="bold"
5868 ><B
5869 CLASS="emphasis"
5870 >ln -s ../init.d/afs /etc/rc0.d/K66afs</B
5871 ></SPAN
5872 >
5873 </PRE
5874 ></P
5875 ></LI
5876 ><LI
5877 ><P
5878 ><SPAN
5879 CLASS="bold"
5880 ><B
5881 CLASS="emphasis"
5882 >(Optional)</B
5883 ></SPAN
5884 > There are now copies of the AFS initialization file in both the
5885                   <SPAN
5886 CLASS="bold"
5887 ><B
5888 CLASS="emphasis"
5889 >/usr/vice/etc</B
5890 ></SPAN
5891 > and <SPAN
5892 CLASS="bold"
5893 ><B
5894 CLASS="emphasis"
5895 >/etc/init.d</B
5896 ></SPAN
5897 > directories. If
5898                   you want to avoid potential confusion by guaranteeing that they are always the same, create a link between them.
5899                   You can always retrieve the original script from the AFS CD-ROM if necessary. <PRE
5900 CLASS="programlisting"
5901 >&#13;   # <SPAN
5902 CLASS="bold"
5903 ><B
5904 CLASS="emphasis"
5905 >cd /usr/vice/etc</B
5906 ></SPAN
5907 >
5908    # <SPAN
5909 CLASS="bold"
5910 ><B
5911 CLASS="emphasis"
5912 >rm afs.rc</B
5913 ></SPAN
5914 >
5915    # <SPAN
5916 CLASS="bold"
5917 ><B
5918 CLASS="emphasis"
5919 >ln -s  /etc/init.d/afs  afs.rc</B
5920 ></SPAN
5921 >
5922 </PRE
5923 ></P
5924 ></LI
5925 ></OL
5926 ></P
5927 ></LI
5928 ><LI
5929 ><P
5930 ><A
5931 NAME="LIWQ113"
5932 ></A
5933 >Verify that <SPAN
5934 CLASS="bold"
5935 ><B
5936 CLASS="emphasis"
5937 >/usr/afs</B
5938 ></SPAN
5939 > and its subdirectories on the new
5940             file server machine meet the ownership and mode bit requirements outlined in <A
5941 HREF="c371.html#HDRWQ96"
5942 >Protecting
5943             Sensitive AFS Directories</A
5944 >. If necessary, use the <SPAN
5945 CLASS="bold"
5946 ><B
5947 CLASS="emphasis"
5948 >chmod</B
5949 ></SPAN
5950 > command to correct the
5951             mode bits.</P
5952 ></LI
5953 ><LI
5954 ><P
5955 >To configure this machine as a database server machine, proceed to <A
5956 HREF="c5467.html#HDRWQ114"
5957 >Installing Database
5958             Server Functionality</A
5959 >.</P
5960 ></LI
5961 ></OL
5962 ></P
5963 ></DIV
5964 ></DIV
5965 ><DIV
5966 CLASS="sect1"
5967 ><H1
5968 CLASS="sect1"
5969 ><A
5970 NAME="HDRWQ114"
5971 >Installing Database Server Functionality</A
5972 ></H1
5973 ><P
5974 >This section explains how to install database server functionality. Database server machines have two defining
5975     characteristics. First, they run the Authentication Server, Protection Server, and Volume Location (VL) Server processes. They
5976     also run the Backup Server if the cell uses the AFS Backup System, as is assumed in these instructions. Second, they appear in
5977     the <SPAN
5978 CLASS="bold"
5979 ><B
5980 CLASS="emphasis"
5981 >CellServDB</B
5982 ></SPAN
5983 > file of every machine in the cell (and of client machines in foreign cells, if
5984     they are to access files in this cell).</P
5985 ><P
5986 >Note the following requirements for database server machines. <UL
5987 ><LI
5988 ><P
5989 >In the conventional configuration, database server machines also serve as file server machines (run the File Server,
5990           Volume Server and Salvager processes). If you choose not to run file server functionality on a database server machine,
5991           then the kernel does not have to incorporate AFS modifications, but the local <SPAN
5992 CLASS="bold"
5993 ><B
5994 CLASS="emphasis"
5995 >/usr/afs</B
5996 ></SPAN
5997 >
5998           directory must house most of the standard files and subdirectories. In particular, the <SPAN
5999 CLASS="bold"
6000 ><B
6001 CLASS="emphasis"
6002 >/usr/afs/etc/KeyFile</B
6003 ></SPAN
6004 > file must contain the same keys as all other server machines in the cell. If
6005           you run a system control machine, run the <SPAN
6006 CLASS="bold"
6007 ><B
6008 CLASS="emphasis"
6009 >upclientetc</B
6010 ></SPAN
6011 > process on every database server
6012           machine other than the system control machine; if you do not run a system control machine, use the <SPAN
6013 CLASS="bold"
6014 ><B
6015 CLASS="emphasis"
6016 >bos addkey</B
6017 ></SPAN
6018 > command as instructed in the chapter in the <SPAN
6019 CLASS="emphasis"
6020 ><I
6021 CLASS="emphasis"
6022 >IBM AFS Administration
6023           Guide</I
6024 ></SPAN
6025 > about maintaining server encryption keys.</P
6026 ><P
6027 >The instructions in this section assume that the machine on which you are installing database server functionality
6028           is already a file server machine. Contact the AFS Product Support group to learn how to install database server
6029           functionality on a non-file server machine.</P
6030 ></LI
6031 ><LI
6032 ><P
6033 >During the installation of database server functionality, you must restart all of the database server machines to
6034           force the election of a new Ubik coordinator (synchronization site) for each database server process. This can cause a
6035           system outage, which usually lasts less than 5 minutes.</P
6036 ></LI
6037 ><LI
6038 ><P
6039 >Updating the kernel memory list of database server machines on each client machine is generally the most
6040           time-consuming part of installing a new database server machine. It is, however, crucial for correct functioning in your
6041           cell. Incorrect knowledge of your cell's database server machines can prevent your users from authenticating, accessing
6042           files, and issuing AFS commands.</P
6043 ><P
6044 >You update a client's kernel memory list by changing the <SPAN
6045 CLASS="bold"
6046 ><B
6047 CLASS="emphasis"
6048 >/usr/vice/etc/CellServDB</B
6049 ></SPAN
6050 >
6051           file and then either rebooting or issuing the <SPAN
6052 CLASS="bold"
6053 ><B
6054 CLASS="emphasis"
6055 >fs newcell</B
6056 ></SPAN
6057 > command. For instructions, see
6058           the chapter in the <SPAN
6059 CLASS="emphasis"
6060 ><I
6061 CLASS="emphasis"
6062 >IBM AFS Administration Guide</I
6063 ></SPAN
6064 > about administering client machines.</P
6065 ><P
6066 >The point at which you update your clients' knowledge of database server machines depends on which of the database
6067           server machines has the lowest IP address. The following instructions indicate the appropriate place to update your client
6068           machines in either case. <UL
6069 ><LI
6070 ><P
6071 >If the new database server machine has a lower IP address than any existing database server machine, update
6072                 the <SPAN
6073 CLASS="bold"
6074 ><B
6075 CLASS="emphasis"
6076 >CellServDB</B
6077 ></SPAN
6078 > file on every client machine before restarting the database server
6079                 processes. If you do not, users can become unable to update (write to) any of the AFS databases. This is because the
6080                 machine with the lowest IP address is usually elected as the Ubik coordinator, and only the Coordinator accepts
6081                 database writes. On client machines that do not have the new list of database server machines, the Cache Manager
6082                 cannot locate the new coordinator. (Be aware that if clients contact the new coordinator before it is actually in
6083                 service, they experience a timeout before contacting another database server machine. This is a minor, and
6084                 temporary, problem compared to being unable to write to the database.)</P
6085 ></LI
6086 ><LI
6087 ><P
6088 >If the new database server machine does not have the lowest IP address of any database server machine, then it
6089                 is better to update clients after restarting the database server processes. Client machines do not start using the
6090                 new database server machine until you update their kernel memory list, but that does not usually cause timeouts or
6091                 update problems (because the new machine is not likely to become the coordinator).</P
6092 ></LI
6093 ></UL
6094 ></P
6095 ></LI
6096 ></UL
6097 ></P
6098 ><DIV
6099 CLASS="sect2"
6100 ><H2
6101 CLASS="sect2"
6102 ><A
6103 NAME="Header_110"
6104 >Summary of Procedures</A
6105 ></H2
6106 ><P
6107 >To install a database server machine, perform the following procedures. <OL
6108 TYPE="1"
6109 ><LI
6110 ><P
6111 >Install the <SPAN
6112 CLASS="bold"
6113 ><B
6114 CLASS="emphasis"
6115 >bos</B
6116 ></SPAN
6117 > suite of commands locally, as a precaution</P
6118 ></LI
6119 ><LI
6120 ><P
6121 >Add the new machine to the <SPAN
6122 CLASS="bold"
6123 ><B
6124 CLASS="emphasis"
6125 >/usr/afs/etc/CellServDB</B
6126 ></SPAN
6127 > file on existing file server
6128             machines</P
6129 ></LI
6130 ><LI
6131 ><P
6132 >Update your cell's central <SPAN
6133 CLASS="bold"
6134 ><B
6135 CLASS="emphasis"
6136 >CellServDB</B
6137 ></SPAN
6138 > source file and the file you make available
6139             to foreign cells</P
6140 ></LI
6141 ><LI
6142 ><P
6143 >Update every client machine's <SPAN
6144 CLASS="bold"
6145 ><B
6146 CLASS="emphasis"
6147 >/usr/vice/etc/CellServDB</B
6148 ></SPAN
6149 > file and kernel memory
6150             list of database server machines</P
6151 ></LI
6152 ><LI
6153 ><P
6154 >Start the database server processes (Authentication Server, Backup Server, Protection Server, and Volume Location
6155             Server)</P
6156 ></LI
6157 ><LI
6158 ><P
6159 >Restart the database server processes on every database server machine</P
6160 ></LI
6161 ><LI
6162 ><P
6163 >Notify the AFS Product Support group that you have installed a new database server machine</P
6164 ></LI
6165 ></OL
6166 ></P
6167 ></DIV
6168 ><DIV
6169 CLASS="sect2"
6170 ><H2
6171 CLASS="sect2"
6172 ><A
6173 NAME="Header_111"
6174 >Instructions</A
6175 ></H2
6176 ><DIV
6177 CLASS="note"
6178 ><BLOCKQUOTE
6179 CLASS="note"
6180 ><P
6181 ><B
6182 >Note: </B
6183 >It is assumed that your PATH environment variable includes the directory that houses the AFS command binaries. If not,
6184         you possibly need to precede the command names with the appropriate pathname.</P
6185 ></BLOCKQUOTE
6186 ></DIV
6187 ><OL
6188 TYPE="1"
6189 ><LI
6190 ><P
6191 >You can perform the following instructions on either a server or client machine. Login as an AFS administrator who
6192           is listed in the <SPAN
6193 CLASS="bold"
6194 ><B
6195 CLASS="emphasis"
6196 >/usr/afs/etc/UserList</B
6197 ></SPAN
6198 > file on all server machines. <PRE
6199 CLASS="programlisting"
6200 >&#13;   % <SPAN
6201 CLASS="bold"
6202 ><B
6203 CLASS="emphasis"
6204 >klog</B
6205 ></SPAN
6206 > <VAR
6207 CLASS="replaceable"
6208 >admin_user</VAR
6209 >
6210    Password: <VAR
6211 CLASS="replaceable"
6212 >admin_password</VAR
6213 >
6214 </PRE
6215 ></P
6216 ></LI
6217 ><LI
6218 ><P
6219 >If you are working on a client machine configured in the conventional manner, the <SPAN
6220 CLASS="bold"
6221 ><B
6222 CLASS="emphasis"
6223 >bos</B
6224 ></SPAN
6225 > command suite resides in the <SPAN
6226 CLASS="bold"
6227 ><B
6228 CLASS="emphasis"
6229 >/usr/afsws/bin</B
6230 ></SPAN
6231 > directory, a
6232           symbolic link to an AFS directory. An error during installation can potentially block access to AFS, in which case it is
6233           helpful to have a copy of the <SPAN
6234 CLASS="bold"
6235 ><B
6236 CLASS="emphasis"
6237 >bos</B
6238 ></SPAN
6239 > binary on the local disk. This step is not necessary if
6240           you are working on a server machine, where the binary resides in the local <SPAN
6241 CLASS="bold"
6242 ><B
6243 CLASS="emphasis"
6244 >/usr/afs/bin</B
6245 ></SPAN
6246 >
6247           directory. <PRE
6248 CLASS="programlisting"
6249 >&#13;   % <SPAN
6250 CLASS="bold"
6251 ><B
6252 CLASS="emphasis"
6253 >cp  /usr/afsws/bin/bos   /tmp</B
6254 ></SPAN
6255 >
6256 </PRE
6257 >     </P
6258 ></LI
6259 ><LI
6260 ><P
6261 ><A
6262 NAME="LIWQ115"
6263 ></A
6264 >Issue the <SPAN
6265 CLASS="bold"
6266 ><B
6267 CLASS="emphasis"
6268 >bos addhost</B
6269 ></SPAN
6270 > command to add the new database server
6271           machine to the <SPAN
6272 CLASS="bold"
6273 ><B
6274 CLASS="emphasis"
6275 >/usr/afs/etc/CellServDB</B
6276 ></SPAN
6277 > file on existing server machines (as well as the
6278           new database server machine itself).</P
6279 ><P
6280 >Substitute the new database server machine's fully-qualified hostname for the <VAR
6281 CLASS="replaceable"
6282 >host name</VAR
6283 >
6284           argument. If you run a system control machine, substitute its fully-qualified hostname for the
6285           <VAR
6286 CLASS="replaceable"
6287 >machine name</VAR
6288 > argument. If you do not run a system control machine, repeat the <SPAN
6289 CLASS="bold"
6290 ><B
6291 CLASS="emphasis"
6292 >bos addhost</B
6293 ></SPAN
6294 > command once for each server machine in your cell (including the new database server
6295           machine itself), by substituting each one's fully-qualified hostname for the <VAR
6296 CLASS="replaceable"
6297 >machine name</VAR
6298 >
6299           argument in turn.</P
6300 ><PRE
6301 CLASS="programlisting"
6302 >&#13;   % <SPAN
6303 CLASS="bold"
6304 ><B
6305 CLASS="emphasis"
6306 >bos addhost</B
6307 ></SPAN
6308 > &#60;<VAR
6309 CLASS="replaceable"
6310 >machine name</VAR
6311 >&#62;  &#60;<VAR
6312 CLASS="replaceable"
6313 >host name</VAR
6314 >&#62;
6315 </PRE
6316 ><P
6317 >If you run a system control machine, wait for the Update Server to distribute the new <SPAN
6318 CLASS="bold"
6319 ><B
6320 CLASS="emphasis"
6321 >CellServDB</B
6322 ></SPAN
6323 > file, which takes up to five minutes by default. If you are issuing individual <SPAN
6324 CLASS="bold"
6325 ><B
6326 CLASS="emphasis"
6327 >bos addhost</B
6328 ></SPAN
6329 > commands, attempt to issue all of them within five minutes.</P
6330 ><DIV
6331 CLASS="note"
6332 ><BLOCKQUOTE
6333 CLASS="note"
6334 ><P
6335 ><B
6336 >Note: </B
6337 >It is best to maintain a one-to-one mapping between hostnames and IP addresses on a multihomed database server
6338             machine (the conventional configuration for any AFS machine). The BOS Server uses the <SPAN
6339 CLASS="bold"
6340 ><B
6341 CLASS="emphasis"
6342 >gethostbyname( )</B
6343 ></SPAN
6344 > routine to obtain the IP address associated with the <VAR
6345 CLASS="replaceable"
6346 >host
6347             name</VAR
6348 > argument. If there is more than one address, the BOS Server records in the <SPAN
6349 CLASS="bold"
6350 ><B
6351 CLASS="emphasis"
6352 >CellServDB</B
6353 ></SPAN
6354 > entry the one that appears first in the list of addresses returned by the routine. The
6355             routine possibly returns addresses in a different order on different machines, which can create inconsistency.</P
6356 ></BLOCKQUOTE
6357 ></DIV
6358 ></LI
6359 ><LI
6360 ><P
6361 ><SPAN
6362 CLASS="bold"
6363 ><B
6364 CLASS="emphasis"
6365 >(Optional)</B
6366 ></SPAN
6367 > Issue the <SPAN
6368 CLASS="bold"
6369 ><B
6370 CLASS="emphasis"
6371 >bos listhosts</B
6372 ></SPAN
6373 > command on each
6374           server machine to verify that the new database server machine appears in its <SPAN
6375 CLASS="bold"
6376 ><B
6377 CLASS="emphasis"
6378 >CellServDB</B
6379 ></SPAN
6380 >
6381           file. <PRE
6382 CLASS="programlisting"
6383 >&#13;   % <SPAN
6384 CLASS="bold"
6385 ><B
6386 CLASS="emphasis"
6387 >bos listhosts</B
6388 ></SPAN
6389 > &#60;<VAR
6390 CLASS="replaceable"
6391 >machine name</VAR
6392 >&#62;
6393 </PRE
6394 ></P
6395 ></LI
6396 ><LI
6397 ><P
6398 ><A
6399 NAME="LIWQ116"
6400 ></A
6401 >Add the new database server machine to your cell's central <SPAN
6402 CLASS="bold"
6403 ><B
6404 CLASS="emphasis"
6405 >CellServDB</B
6406 ></SPAN
6407 > source file, if you use one. The standard location is <SPAN
6408 CLASS="bold"
6409 ><B
6410 CLASS="emphasis"
6411 >/afs/</B
6412 ></SPAN
6413 ><VAR
6414 CLASS="replaceable"
6415 >cellname</VAR
6416 ><SPAN
6417 CLASS="bold"
6418 ><B
6419 CLASS="emphasis"
6420 >/common/etc/CellServDB</B
6421 ></SPAN
6422 >.</P
6423 ><P
6424 >If you are willing to make your cell accessible to users in foreign cells, add the new database server machine to
6425           the file that lists your cell's database server machines. The conventional location is <SPAN
6426 CLASS="bold"
6427 ><B
6428 CLASS="emphasis"
6429 >/afs/</B
6430 ></SPAN
6431 ><VAR
6432 CLASS="replaceable"
6433 >cellname</VAR
6434 ><SPAN
6435 CLASS="bold"
6436 ><B
6437 CLASS="emphasis"
6438 >/service/etc/CellServDB.local</B
6439 ></SPAN
6440 >.   </P
6441 ></LI
6442 ><LI
6443 ><P
6444 ><A
6445 NAME="LIWQ117"
6446 ></A
6447 >If this machine's IP address is lower than any existing database server machine's, update
6448           every client machine's <SPAN
6449 CLASS="bold"
6450 ><B
6451 CLASS="emphasis"
6452 >/usr/vice/etc/CellServDB</B
6453 ></SPAN
6454 > file and kernel memory list to include
6455           this machine. (If this machine's IP address is not the lowest, it is acceptable to wait until Step <A
6456 HREF="c5467.html#LIWQ123"
6457 >12</A
6458 >.)</P
6459 ><P
6460 >There are several ways to update the <SPAN
6461 CLASS="bold"
6462 ><B
6463 CLASS="emphasis"
6464 >CellServDB</B
6465 ></SPAN
6466 > file on client machines, as
6467           detailed in the chapter of the <SPAN
6468 CLASS="emphasis"
6469 ><I
6470 CLASS="emphasis"
6471 >IBM AFS Administration Guide</I
6472 ></SPAN
6473 > about administering client machines. One
6474           option is to copy over the central update source (which you updated in Step <A
6475 HREF="c5467.html#LIWQ116"
6476 >5</A
6477 >), with or
6478           without using the <SPAN
6479 CLASS="bold"
6480 ><B
6481 CLASS="emphasis"
6482 >package</B
6483 ></SPAN
6484 > program. To update the machine's kernel memory list, you can
6485           either reboot after changing the <SPAN
6486 CLASS="bold"
6487 ><B
6488 CLASS="emphasis"
6489 >CellServDB</B
6490 ></SPAN
6491 > file or issue the <SPAN
6492 CLASS="bold"
6493 ><B
6494 CLASS="emphasis"
6495 >fs
6496           newcell</B
6497 ></SPAN
6498 > command.     </P
6499 ></LI
6500 ><LI
6501 ><P
6502 ><A
6503 NAME="LIWQ118"
6504 ></A
6505 >Start the Authentication Server (the <SPAN
6506 CLASS="bold"
6507 ><B
6508 CLASS="emphasis"
6509 >kaserver</B
6510 ></SPAN
6511 > process).
6512           <PRE
6513 CLASS="programlisting"
6514 >&#13;   % <SPAN
6515 CLASS="bold"
6516 ><B
6517 CLASS="emphasis"
6518 >bos create</B
6519 ></SPAN
6520 > &#60;<VAR
6521 CLASS="replaceable"
6522 >machine name</VAR
6523 >&#62; <SPAN
6524 CLASS="bold"
6525 ><B
6526 CLASS="emphasis"
6527 >kaserver simple /usr/afs/bin/kaserver</B
6528 ></SPAN
6529 >
6530 </PRE
6531 >  </P
6532 ></LI
6533 ><LI
6534 ><P
6535 ><A
6536 NAME="LIWQ119"
6537 ></A
6538 >Start the Backup Server (the <SPAN
6539 CLASS="bold"
6540 ><B
6541 CLASS="emphasis"
6542 >buserver</B
6543 ></SPAN
6544 > process). You must
6545           perform other configuration procedures before actually using the AFS Backup System, as detailed in the <SPAN
6546 CLASS="emphasis"
6547 ><I
6548 CLASS="emphasis"
6549 >IBM AFS
6550           Administration Guide</I
6551 ></SPAN
6552 >. <PRE
6553 CLASS="programlisting"
6554 >&#13;   % <SPAN
6555 CLASS="bold"
6556 ><B
6557 CLASS="emphasis"
6558 >bos create</B
6559 ></SPAN
6560 > &#60;<VAR
6561 CLASS="replaceable"
6562 >machine name</VAR
6563 >&#62; <SPAN
6564 CLASS="bold"
6565 ><B
6566 CLASS="emphasis"
6567 >buserver simple /usr/afs/bin/buserver</B
6568 ></SPAN
6569 >
6570 </PRE
6571 >  </P
6572 ></LI
6573 ><LI
6574 ><P
6575 ><A
6576 NAME="LIWQ120"
6577 ></A
6578 >Start the Protection Server (the <SPAN
6579 CLASS="bold"
6580 ><B
6581 CLASS="emphasis"
6582 >ptserver</B
6583 ></SPAN
6584 > process).
6585           <PRE
6586 CLASS="programlisting"
6587 >&#13;   % <SPAN
6588 CLASS="bold"
6589 ><B
6590 CLASS="emphasis"
6591 >bos create</B
6592 ></SPAN
6593 > &#60;<VAR
6594 CLASS="replaceable"
6595 >machine name</VAR
6596 >&#62; <SPAN
6597 CLASS="bold"
6598 ><B
6599 CLASS="emphasis"
6600 >ptserver simple /usr/afs/bin/ptserver</B
6601 ></SPAN
6602 >
6603 </PRE
6604 >  </P
6605 ></LI
6606 ><LI
6607 ><P
6608 ><A
6609 NAME="LIWQ121"
6610 ></A
6611 >Start the Volume Location (VL) Server (the <SPAN
6612 CLASS="bold"
6613 ><B
6614 CLASS="emphasis"
6615 >vlserver</B
6616 ></SPAN
6617 >
6618           process). <PRE
6619 CLASS="programlisting"
6620 >&#13;   % <SPAN
6621 CLASS="bold"
6622 ><B
6623 CLASS="emphasis"
6624 >bos create</B
6625 ></SPAN
6626 > &#60;<VAR
6627 CLASS="replaceable"
6628 >machine name</VAR
6629 >&#62; <SPAN
6630 CLASS="bold"
6631 ><B
6632 CLASS="emphasis"
6633 >vlserver simple /usr/afs/bin/vlserver</B
6634 ></SPAN
6635 >
6636 </PRE
6637 >    </P
6638 ></LI
6639 ><LI
6640 ><P
6641 ><A
6642 NAME="LIWQ122"
6643 ></A
6644 >Issue the <SPAN
6645 CLASS="bold"
6646 ><B
6647 CLASS="emphasis"
6648 >bos restart</B
6649 ></SPAN
6650 > command on every database server
6651           machine in the cell, including the new machine. The command restarts the Authentication, Backup, Protection, and VL
6652           Servers, which forces an election of a new Ubik coordinator for each process. The new machine votes in the election and is
6653           considered as a potential new coordinator.</P
6654 ><P
6655 >A cell-wide service outage is possible during the election of a new coordinator for the VL Server, but it normally
6656           lasts less than five minutes. Such an outage is particularly likely if you are installing your cell's second database
6657           server machine. Messages tracing the progress of the election appear on the console.</P
6658 ><P
6659 >Repeat this command on each of your cell's database server machines in quick succession. Begin with the machine with
6660           the lowest IP address.</P
6661 ><PRE
6662 CLASS="programlisting"
6663 >&#13;   %  <SPAN
6664 CLASS="bold"
6665 ><B
6666 CLASS="emphasis"
6667 >bos restart</B
6668 ></SPAN
6669 > &#60;<VAR
6670 CLASS="replaceable"
6671 >machine name</VAR
6672 >&#62; <SPAN
6673 CLASS="bold"
6674 ><B
6675 CLASS="emphasis"
6676 >kaserver buserver ptserver vlserver</B
6677 ></SPAN
6678 >
6679 </PRE
6680 ><P
6681 >If an error occurs, restart all server processes on the database server machines again by using one of the following
6682           methods: <UL
6683 ><LI
6684 ><P
6685 >Issue the <SPAN
6686 CLASS="bold"
6687 ><B
6688 CLASS="emphasis"
6689 >bos restart</B
6690 ></SPAN
6691 > command with the <SPAN
6692 CLASS="bold"
6693 ><B
6694 CLASS="emphasis"
6695 >-bosserver</B
6696 ></SPAN
6697 > flag for each database server machine</P
6698 ></LI
6699 ><LI
6700 ><P
6701 >Reboot each database server machine, either using the <SPAN
6702 CLASS="bold"
6703 ><B
6704 CLASS="emphasis"
6705 >bos exec</B
6706 ></SPAN
6707 > command or at
6708                 its console</P
6709 ></LI
6710 ></UL
6711 ></P
6712 ></LI
6713 ><LI
6714 ><P
6715 ><A
6716 NAME="LIWQ123"
6717 ></A
6718 >If you did not update the <SPAN
6719 CLASS="bold"
6720 ><B
6721 CLASS="emphasis"
6722 >CellServDB</B
6723 ></SPAN
6724 > file on client machines
6725           in Step <A
6726 HREF="c5467.html#LIWQ117"
6727 >6</A
6728 >, do so now.</P
6729 ></LI
6730 ><LI
6731 ><P
6732 ><A
6733 NAME="LIWQ124"
6734 ></A
6735 >Send the new database server machine's name and IP address to the AFS Product Support
6736           group.</P
6737 ><P
6738 >If you wish to participate in the AFS global name space, your cell's entry appear in a <SPAN
6739 CLASS="bold"
6740 ><B
6741 CLASS="emphasis"
6742 >CellServDB</B
6743 ></SPAN
6744 > file that the AFS Product Support group makes available to all AFS sites. Otherwise,
6745           they list your cell in a private file that they do not share with other AFS sites.</P
6746 ></LI
6747 ></OL
6748 ></DIV
6749 ></DIV
6750 ><DIV
6751 CLASS="sect1"
6752 ><H1
6753 CLASS="sect1"
6754 ><A
6755 NAME="HDRWQ125"
6756 >Removing Database Server Functionality</A
6757 ></H1
6758 ><P
6759 >Removing database server machine functionality is nearly the reverse of installing it.</P
6760 ><DIV
6761 CLASS="sect2"
6762 ><H2
6763 CLASS="sect2"
6764 ><A
6765 NAME="Header_113"
6766 >Summary of Procedures</A
6767 ></H2
6768 ><P
6769 >To decommission a database server machine, perform the following procedures. <OL
6770 TYPE="1"
6771 ><LI
6772 ><P
6773 >Install the <SPAN
6774 CLASS="bold"
6775 ><B
6776 CLASS="emphasis"
6777 >bos</B
6778 ></SPAN
6779 > suite of commands locally, as a precaution</P
6780 ></LI
6781 ><LI
6782 ><P
6783 >Notify the AFS Product Support group that you are decommissioning a database server machine</P
6784 ></LI
6785 ><LI
6786 ><P
6787 >Update your cell's central <SPAN
6788 CLASS="bold"
6789 ><B
6790 CLASS="emphasis"
6791 >CellServDB</B
6792 ></SPAN
6793 > source file and the file you make available
6794             to foreign cells</P
6795 ></LI
6796 ><LI
6797 ><P
6798 >Update every client machine's <SPAN
6799 CLASS="bold"
6800 ><B
6801 CLASS="emphasis"
6802 >/usr/vice/etc/CellServDB</B
6803 ></SPAN
6804 > file and kernel memory
6805             list of database server machines</P
6806 ></LI
6807 ><LI
6808 ><P
6809 >Remove the machine from the <SPAN
6810 CLASS="bold"
6811 ><B
6812 CLASS="emphasis"
6813 >/usr/afs/etc/CellServDB</B
6814 ></SPAN
6815 > file on file server
6816             machines</P
6817 ></LI
6818 ><LI
6819 ><P
6820 >Stop the database server processes and remove them from the <SPAN
6821 CLASS="bold"
6822 ><B
6823 CLASS="emphasis"
6824 >/usr/afs/local/BosConfig</B
6825 ></SPAN
6826 > file if desired</P
6827 ></LI
6828 ><LI
6829 ><P
6830 >Restart the database server processes on the remaining database server machines</P
6831 ></LI
6832 ></OL
6833 ></P
6834 ></DIV
6835 ><DIV
6836 CLASS="sect2"
6837 ><H2
6838 CLASS="sect2"
6839 ><A
6840 NAME="Header_114"
6841 >Instructions</A
6842 ></H2
6843 ><DIV
6844 CLASS="note"
6845 ><BLOCKQUOTE
6846 CLASS="note"
6847 ><P
6848 ><B
6849 >Note: </B
6850 >It is assumed that your PATH environment variable includes the directory that houses the AFS command binaries. If not,
6851         you possibly need to precede the command names with the appropriate pathname.</P
6852 ></BLOCKQUOTE
6853 ></DIV
6854 ><OL
6855 TYPE="1"
6856 ><LI
6857 ><P
6858 >You can perform the following instructions on either a server or client machine. Login as an AFS administrator who
6859           is listed in the <SPAN
6860 CLASS="bold"
6861 ><B
6862 CLASS="emphasis"
6863 >/usr/afs/etc/UserList</B
6864 ></SPAN
6865 > file on all server machines. <PRE
6866 CLASS="programlisting"
6867 >&#13;   % <SPAN
6868 CLASS="bold"
6869 ><B
6870 CLASS="emphasis"
6871 >klog</B
6872 ></SPAN
6873 > <VAR
6874 CLASS="replaceable"
6875 >admin_user</VAR
6876 >
6877    Password: <VAR
6878 CLASS="replaceable"
6879 >admin_password</VAR
6880 >
6881 </PRE
6882 ></P
6883 ></LI
6884 ><LI
6885 ><P
6886 >If you are working on a client machine configured in the conventional manner, the <SPAN
6887 CLASS="bold"
6888 ><B
6889 CLASS="emphasis"
6890 >bos</B
6891 ></SPAN
6892 > command suite resides in the <SPAN
6893 CLASS="bold"
6894 ><B
6895 CLASS="emphasis"
6896 >/usr/afsws/bin</B
6897 ></SPAN
6898 > directory, a
6899           symbolic link to an AFS directory. An error during installation can potentially block access to AFS, in which case it is
6900           helpful to have a copy of the <SPAN
6901 CLASS="bold"
6902 ><B
6903 CLASS="emphasis"
6904 >bos</B
6905 ></SPAN
6906 > binary on the local disk. This step is not necessary if
6907           you are working on a server machine, where the binary resides in the local <SPAN
6908 CLASS="bold"
6909 ><B
6910 CLASS="emphasis"
6911 >/usr/afs/bin</B
6912 ></SPAN
6913 >
6914           directory. <PRE
6915 CLASS="programlisting"
6916 >&#13;   % <SPAN
6917 CLASS="bold"
6918 ><B
6919 CLASS="emphasis"
6920 >cp  /usr/afsws/bin/bos   /tmp</B
6921 ></SPAN
6922 >
6923 </PRE
6924 ></P
6925 ></LI
6926 ><LI
6927 ><P
6928 ><A
6929 NAME="LIWQ126"
6930 ></A
6931 >Send the revised list of your cell's database server machines to the AFS Product Support
6932           group.</P
6933 ><P
6934 >This step is particularly important if your cell is included in the global <SPAN
6935 CLASS="bold"
6936 ><B
6937 CLASS="emphasis"
6938 >CellServDB</B
6939 ></SPAN
6940 > file. If the administrators in foreign cells do not learn about the change in your cell,
6941           they cannot update the <SPAN
6942 CLASS="bold"
6943 ><B
6944 CLASS="emphasis"
6945 >CellServDB</B
6946 ></SPAN
6947 > file on their client machines. Users in foreign cells
6948           continue to send database requests to the decommissioned machine, which creates needless network traffic and activity on
6949           the machine. Also, the users experience time-out delays while their request is forwarded to a valid database server
6950           machine.</P
6951 ></LI
6952 ><LI
6953 ><P
6954 ><A
6955 NAME="LIWQ127"
6956 ></A
6957 >Remove the decommissioned machine from your cell's central <SPAN
6958 CLASS="bold"
6959 ><B
6960 CLASS="emphasis"
6961 >CellServDB</B
6962 ></SPAN
6963 > source file, if you use one. The conventional location is <SPAN
6964 CLASS="bold"
6965 ><B
6966 CLASS="emphasis"
6967 >/afs/</B
6968 ></SPAN
6969 ><VAR
6970 CLASS="replaceable"
6971 >cellname</VAR
6972 ><SPAN
6973 CLASS="bold"
6974 ><B
6975 CLASS="emphasis"
6976 >/common/etc/CellServDB</B
6977 ></SPAN
6978 >.</P
6979 ><P
6980 >If you maintain a file that users in foreign cells can access to learn about your cell's database server machines,
6981           update it also. The conventional location is <SPAN
6982 CLASS="bold"
6983 ><B
6984 CLASS="emphasis"
6985 >/afs/</B
6986 ></SPAN
6987 ><VAR
6988 CLASS="replaceable"
6989 >cellname</VAR
6990 ><SPAN
6991 CLASS="bold"
6992 ><B
6993 CLASS="emphasis"
6994 >/service/etc/CellServDB.local</B
6995 ></SPAN
6996 >.    </P
6997 ></LI
6998 ><LI
6999 ><P
7000 ><A
7001 NAME="LIWQ128"
7002 ></A
7003 >Update every client machine's <SPAN
7004 CLASS="bold"
7005 ><B
7006 CLASS="emphasis"
7007 >/usr/vice/etc/CellServDB</B
7008 ></SPAN
7009 > file
7010           and kernel memory list to exclude this machine. Altering the <SPAN
7011 CLASS="bold"
7012 ><B
7013 CLASS="emphasis"
7014 >CellServDB</B
7015 ></SPAN
7016 > file and kernel
7017           memory list before stopping the actual database server processes avoids possible time-out delays that result when users
7018           send requests to a decommissioned database server machine that is still listed in the file.</P
7019 ><P
7020 >There are several ways to update the <SPAN
7021 CLASS="bold"
7022 ><B
7023 CLASS="emphasis"
7024 >CellServDB</B
7025 ></SPAN
7026 > file on client machines, as
7027           detailed in the chapter of the <SPAN
7028 CLASS="emphasis"
7029 ><I
7030 CLASS="emphasis"
7031 >IBM AFS Administration Guide</I
7032 ></SPAN
7033 > about administering client machines. One
7034           option is to copy over the central update source (which you updated in Step <A
7035 HREF="c5467.html#LIWQ116"
7036 >5</A
7037 >), with or
7038           without using the <SPAN
7039 CLASS="bold"
7040 ><B
7041 CLASS="emphasis"
7042 >package</B
7043 ></SPAN
7044 > program. To update the machine's kernel memory list, you can
7045           either reboot after changing the <SPAN
7046 CLASS="bold"
7047 ><B
7048 CLASS="emphasis"
7049 >CellServDB</B
7050 ></SPAN
7051 > file or issue the <SPAN
7052 CLASS="bold"
7053 ><B
7054 CLASS="emphasis"
7055 >fs
7056           newcell</B
7057 ></SPAN
7058 > command.    </P
7059 ></LI
7060 ><LI
7061 ><P
7062 ><A
7063 NAME="LIWQ129"
7064 ></A
7065 >Issue the <SPAN
7066 CLASS="bold"
7067 ><B
7068 CLASS="emphasis"
7069 >bos removehost</B
7070 ></SPAN
7071 > command to remove the
7072           decommissioned database server machine from the <SPAN
7073 CLASS="bold"
7074 ><B
7075 CLASS="emphasis"
7076 >/usr/afs/etc/CellServDB</B
7077 ></SPAN
7078 > file on server
7079           machines.</P
7080 ><P
7081 >Substitute the decommissioned database server machine's fully-qualified hostname for the <VAR
7082 CLASS="replaceable"
7083 >host
7084           name</VAR
7085 > argument. If you run a system control machine, substitute its fully-qualified hostname for the
7086           <VAR
7087 CLASS="replaceable"
7088 >machine name</VAR
7089 > argument. If you do not run a system control machine, repeat the <SPAN
7090 CLASS="bold"
7091 ><B
7092 CLASS="emphasis"
7093 >bos removehost</B
7094 ></SPAN
7095 > command once for each server machine in your cell (including the decommissioned
7096           database server machine itself), by substituting each one's fully-qualified hostname for the
7097           <VAR
7098 CLASS="replaceable"
7099 >machine name</VAR
7100 > argument in turn.</P
7101 ><PRE
7102 CLASS="programlisting"
7103 >&#13;   % <SPAN
7104 CLASS="bold"
7105 ><B
7106 CLASS="emphasis"
7107 >bos removehost</B
7108 ></SPAN
7109 > &#60;<VAR
7110 CLASS="replaceable"
7111 >machine name</VAR
7112 >&#62;  &#60;<VAR
7113 CLASS="replaceable"
7114 >host name</VAR
7115 >&#62;
7116 </PRE
7117 ><P
7118 >If you run a system control machine, wait for the Update Server to distribute the new <SPAN
7119 CLASS="bold"
7120 ><B
7121 CLASS="emphasis"
7122 >CellServDB</B
7123 ></SPAN
7124 > file, which takes up to five minutes by default. If issuing individual <SPAN
7125 CLASS="bold"
7126 ><B
7127 CLASS="emphasis"
7128 >bos removehost</B
7129 ></SPAN
7130 > commands, attempt to issue all of them within five minutes.</P
7131 ></LI
7132 ><LI
7133 ><P
7134 ><SPAN
7135 CLASS="bold"
7136 ><B
7137 CLASS="emphasis"
7138 >(Optional)</B
7139 ></SPAN
7140 > Issue the <SPAN
7141 CLASS="bold"
7142 ><B
7143 CLASS="emphasis"
7144 >bos listhosts</B
7145 ></SPAN
7146 > command on each
7147           server machine to verify that the decommissioned database server machine no longer appears in its <SPAN
7148 CLASS="bold"
7149 ><B
7150 CLASS="emphasis"
7151 >CellServDB</B
7152 ></SPAN
7153 > file. <PRE
7154 CLASS="programlisting"
7155 >&#13;   % <SPAN
7156 CLASS="bold"
7157 ><B
7158 CLASS="emphasis"
7159 >bos listhosts</B
7160 ></SPAN
7161 > &#60;<VAR
7162 CLASS="replaceable"
7163 >machine name</VAR
7164 >&#62;
7165 </PRE
7166 >       </P
7167 ></LI
7168 ><LI
7169 ><P
7170 ><A
7171 NAME="LIWQ130"
7172 ></A
7173 >Issue the <SPAN
7174 CLASS="bold"
7175 ><B
7176 CLASS="emphasis"
7177 >bos stop</B
7178 ></SPAN
7179 > command to stop the database server
7180           processes on the machine, by substituting its fully-qualified hostname for the
7181           <VAR
7182 CLASS="replaceable"
7183 >machine name</VAR
7184 > argument. The command changes each process's status in the <SPAN
7185 CLASS="bold"
7186 ><B
7187 CLASS="emphasis"
7188 >/usr/afs/local/BosConfig</B
7189 ></SPAN
7190 > file to <SAMP
7191 CLASS="computeroutput"
7192 >NotRun</SAMP
7193 >, but does not remove its
7194           entry from the file. <PRE
7195 CLASS="programlisting"
7196 >&#13;   % <SPAN
7197 CLASS="bold"
7198 ><B
7199 CLASS="emphasis"
7200 >bos stop</B
7201 ></SPAN
7202 > &#60;<VAR
7203 CLASS="replaceable"
7204 >machine name</VAR
7205 >&#62; <SPAN
7206 CLASS="bold"
7207 ><B
7208 CLASS="emphasis"
7209 >kaserver buserver ptserver vlserver</B
7210 ></SPAN
7211 >
7212 </PRE
7213 >     </P
7214 ></LI
7215 ><LI
7216 ><P
7217 ><A
7218 NAME="LIWQ131"
7219 ></A
7220 ><SPAN
7221 CLASS="bold"
7222 ><B
7223 CLASS="emphasis"
7224 >(Optional)</B
7225 ></SPAN
7226 > Issue the <SPAN
7227 CLASS="bold"
7228 ><B
7229 CLASS="emphasis"
7230 >bos
7231           delete</B
7232 ></SPAN
7233 > command to remove the entries for database server processes from the <SPAN
7234 CLASS="bold"
7235 ><B
7236 CLASS="emphasis"
7237 >BosConfig</B
7238 ></SPAN
7239 > file. This step is unnecessary if you plan to restart the database server functionality
7240           on this machine in future. <PRE
7241 CLASS="programlisting"
7242 >&#13;   % <SPAN
7243 CLASS="bold"
7244 ><B
7245 CLASS="emphasis"
7246 >bos delete</B
7247 ></SPAN
7248 > &#60;<VAR
7249 CLASS="replaceable"
7250 >machine name</VAR
7251 >&#62; <SPAN
7252 CLASS="bold"
7253 ><B
7254 CLASS="emphasis"
7255 >kaserver buserver ptserver vlserver</B
7256 ></SPAN
7257 >
7258 </PRE
7259 >    </P
7260 ></LI
7261 ><LI
7262 ><P
7263 ><A
7264 NAME="LIWQ132"
7265 ></A
7266 >Issue the <SPAN
7267 CLASS="bold"
7268 ><B
7269 CLASS="emphasis"
7270 >bos restart</B
7271 ></SPAN
7272 > command on every database server
7273           machine in the cell, to restart the Authentication, Backup, Protection, and VL Servers. This forces the election of a Ubik
7274           coordinator for each process, ensuring that the remaining database server processes recognize that the machine is no
7275           longer a database server.</P
7276 ><P
7277 >A cell-wide service outage is possible during the election of a new coordinator for the VL Server, but it normally
7278           lasts less than five minutes. Messages tracing the progress of the election appear on the console.</P
7279 ><P
7280 >Repeat this command on each of your cell's database server machines in quick succession. Begin with the machine with
7281           the lowest IP address.</P
7282 ><PRE
7283 CLASS="programlisting"
7284 >&#13;   %  <SPAN
7285 CLASS="bold"
7286 ><B
7287 CLASS="emphasis"
7288 >bos restart</B
7289 ></SPAN
7290 > &#60;<VAR
7291 CLASS="replaceable"
7292 >machine name</VAR
7293 >&#62; <SPAN
7294 CLASS="bold"
7295 ><B
7296 CLASS="emphasis"
7297 >kaserver buserver ptserver vlserver</B
7298 ></SPAN
7299 >
7300 </PRE
7301 ><P
7302 >If an error occurs, restart all server processes on the database server machines again by using one of the following
7303           methods: <UL
7304 ><LI
7305 ><P
7306 >Issue the <SPAN
7307 CLASS="bold"
7308 ><B
7309 CLASS="emphasis"
7310 >bos restart</B
7311 ></SPAN
7312 > command with the <SPAN
7313 CLASS="bold"
7314 ><B
7315 CLASS="emphasis"
7316 >-bosserver</B
7317 ></SPAN
7318 > flag for each database server machine</P
7319 ></LI
7320 ><LI
7321 ><P
7322 >Reboot each database server machine, either using the <SPAN
7323 CLASS="bold"
7324 ><B
7325 CLASS="emphasis"
7326 >bos exec</B
7327 ></SPAN
7328 > command or at
7329                 its console</P
7330 ></LI
7331 ></UL
7332 ></P
7333 ></LI
7334 ></OL
7335 ></DIV
7336 ></DIV
7337 ></DIV
7338 ><DIV
7339 CLASS="NAVFOOTER"
7340 ><HR
7341 ALIGN="LEFT"
7342 WIDTH="100%"><TABLE
7343 SUMMARY="Footer navigation table"
7344 WIDTH="100%"
7345 BORDER="0"
7346 CELLPADDING="0"
7347 CELLSPACING="0"
7348 ><TR
7349 ><TD
7350 WIDTH="33%"
7351 ALIGN="left"
7352 VALIGN="top"
7353 ><A
7354 HREF="c371.html"
7355 ACCESSKEY="P"
7356 >Prev</A
7357 ></TD
7358 ><TD
7359 WIDTH="34%"
7360 ALIGN="center"
7361 VALIGN="top"
7362 ><A
7363 HREF="book1.html"
7364 ACCESSKEY="H"
7365 >Home</A
7366 ></TD
7367 ><TD
7368 WIDTH="33%"
7369 ALIGN="right"
7370 VALIGN="top"
7371 ><A
7372 HREF="c8044.html"
7373 ACCESSKEY="N"
7374 >Next</A
7375 ></TD
7376 ></TR
7377 ><TR
7378 ><TD
7379 WIDTH="33%"
7380 ALIGN="left"
7381 VALIGN="top"
7382 >Installing the First AFS Machine</TD
7383 ><TD
7384 WIDTH="34%"
7385 ALIGN="center"
7386 VALIGN="top"
7387 >&nbsp;</TD
7388 ><TD
7389 WIDTH="33%"
7390 ALIGN="right"
7391 VALIGN="top"
7392 >Installing Additional Client Machines</TD
7393 ></TR
7394 ></TABLE
7395 ></DIV
7396 ></BODY
7397 ></HTML
7398 >