AFSLore/BuildingAFSintotheDigitalUNIXKernel.mdwn

   1 The sysconfig program is the dynamic kernel loader provided for Digital UNIX systems.
   2
   3 For AFS to function correctly, the sysconfig program must run each time the machine reboots, so the AFS initialization script (included on the AFS CD-ROM) invokes it automatically. In this section you copy the appropriate AFS library file to the location where the sysconfig program accesses it and then run the script.
   4
   5 ## <a name="Building AFS into the Digital UN"></a> Building AFS into the Digital UNIX Kernel
   6
   7 Use the following instructions to build AFS modifications into the kernel on a Digital UNIX system.
   8
   9 1. Create a copy called AFS of the basic kernel configuration file included in the Digital UNIX distribution as /usr/sys/conf/machine\_name, where machine\_name is the machine's hostname in all uppercase letters.
  10
  11        # cd /usr/sys/conf
  12
  13        # cp machine_name AFS
  14
  15 1. Add AFS to the list of options in the configuration file you created in the previous step, so that the result looks like the following:
  16
  17               .                   .
  18               .                   .
  19            options               UFS
  20            options               NFS
  21            options               AFS
  22               .                   .
  23               .                   .
  24
  25 1. Add an entry for AFS to two places in the file /usr/sys/conf/files.
  26
  27 \* Add a line for AFS to the list of OPTIONS, so that the result looks like the following:
  28
  29                  .                .      .
  30                  .                .      .
  31           OPTIONS/nfs          optional nfs
  32           OPTIONS/afs          optional afs
  33           OPTIONS/nfs_server   optional nfs_server
  34                  .                .      .
  35                  .                .      .
  36
  37 \* Add an entry for AFS to the list of MODULES, so that the result looks like the following:
  38
  39                  .                  .        .          .
  40                  .                  .        .          .
  41           #
  42           MODULE/nfs_server       optional nfs_server Binary
  43           nfs/nfs_server.c      module nfs_server optimize -g3
  44           nfs/nfs3_server.c       module nfs_server optimize -g3
  45           #
  46           MODULE/afs            optional afs Binary
  47           afs/libafs.c          module afs
  48           #
  49
  50 1. Add an entry for AFS to two places in the file /usr/sys/vfs/vfs\_conf.c.
  51
  52 \* Add AFS to the list of defined file systems, so that the result looks like the following:
  53
  54             .       .
  55             .       .
  56          #include <afs.h>
  57          #if defined(AFS) && AFS
  58                 extern struct vfsops afs_vfsops;
  59          #endif
  60             .       .
  61             .       .
  62
  63 \* Put a declaration for AFS in the vfssw[] table's MOUNT\_ADDON slot, so that the result looks like the following:
  64
  65             .                          .              .
  66             .                          .              .
  67           &fdfs_vfsops,         "fdfs",   /* 12 = MOUNT_FDFS */
  68        #if   defined(AFS)
  69           &afs_vfsops,          "afs",
  70        #else
  71           (struct vfsops *)0,   "",       /* 13 = MOUNT_ADDON */
  72        #endif
  73        #if NFS && INFS_DYNAMIC
  74            &nfs3_vfsops,        "nfsv3",  /* 14 = MOUNT_NFS3 */
  75
  76 1. Mount the AFS CD-ROM for Digital UNIX on the local /cdrom directory. For instructions on mounting CD-ROMs (either locally or remotely via NFS), see your Digital UNIX documentation. Then change directory as indicated.
  77
  78        # cd /cdrom/alpha_dux40/root.client
  79
  80 1. Copy the AFS initialization script to the local directory for initialization files (by convention, /sbin/init.d on Digital UNIX machines). Note the removal of the .rc extension as you copy the script.
  81
  82        # cp usr/vice/etc/afs.rc  /sbin/init.d/afs
  83
  84 1. Copy the AFS kernel module to the local /usr/sys/BINARY directory.
  85
  86 If the machine's kernel supports NFS server functionality:
  87
  88        # cp bin/libafs.o /usr/sys/BINARY/afs.mod
  89
  90 If the machine's kernel does not support NFS server functionality:
  91
  92        # cp bin/libafs.nonfs.o /usr/sys/BINARY/afs.mod
  93
  94 1. Configure and build the kernel. Respond to any prompts by pressing . The resulting kernel resides in the file /sys/AFS/vmunix.
  95
  96        # doconfig -c AFS
  97
  98 1. Rename the existing kernel file and copy the new, AFS-modified file to the standard location.
  99
 100        # mv /vmunix /vmunix_noafs
 101
 102        # cp /sys/AFS/vmunix /vmunix
 103
 104 10. Reboot the machine to start using the new kernel, and login again as the superuser root.
 105
 106        # cd /
 107
 108        # shutdown -r now
 109
 110        login: root
 111        Password: root_password