Building AFS into the Digital UNIX Kernel

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.

   # cd /usr/sys/conf
   
   # cp machine_name AFS   

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:

          .                   .
          .                   .
       options               UFS
       options               NFS
       options               AFS
          .                   .
          .                   .   

Add an entry for AFS to two places in the /usr/sys/conf/files file.

• Add a line for AFS to the list of OPTIONS, so that the result looks like the following:

  . . . . . . OPTIONS/nfs optional nfs define_dynamic OPTIONS/afs optional afs define_dynamic OPTIONS/cdfs optional cdfs define_dynamic . . . . . .

• Add an entry for AFS to the list of MODULES, so that the result looks like the following:

  . . . . . . . . # MODULE/nfs_server optional nfs_server Binary nfs/nfs_server.c module nfs_server optimize -g3 nfs/nfs3_server.c module nfs_server optimize -g3 # MODULE/afs optional afs Binary afs/libafs.c module afs #

Add an entry for AFS to two places in the /usr/sys/vfs/vfs_conf.c file.

• Add AFS to the list of defined file systems, so that the result looks like the following:

  . . . . #include <afs.h> #if defined(AFS) && AFS extern struct vfsops afs_vfsops; #endif . . . .

• Put a declaration for AFS in the vfssw[] table's MOUNT_ADDON slot, so that the result looks like the following:

  . . . . . . &fdfs_vfsops, "fdfs", /* 12 = MOUNT_FDFS */ #if defined(AFS) &afs_vfsops, "afs", #else (struct vfsops *)0, "", /* 13 = MOUNT_ADDON */ #endif #if NFS && INFS_DYNAMIC &nfs3_vfsops, "nfsv3", /* 14 = MOUNT_NFS3 */

Access the AFS distribution by changing directory as indicated. Substitute "alpha_dux40" for the sysname variable.

• If you copied the contents of the root.client directory into AFS (in Step 6 of Storing Binaries in AFS), change directory as indicated.

  # cd /afs/cellname/sysname/usr/afsws/root.client

• If copying files from the CD-ROM, mount the CD-ROM for this machine's system type on the local /cdrom directory. For instructions on mounting CD-ROMs (either locally or remotely via NFS), consult the operating system documentation. Then change directory as indicated.

  # cd /cdrom/sysname/root.client

• If accessing the distribution electronically, you possibly already downloaded it in Storing Binaries in AFS. If so, it is still in the temp_afs36_dir directory. If not, download it and run any commands necessary to uncompress or unpack the distribution. Place it in a temporary location (temp_afs36_dir), and change directory to the indicated subdirectory.

  # cd temp_afs36_dir/root.client

Because you ran AFS 3.5 on this machine, the appropriate AFS initialization file possibly already exists as /sbin/init.d/afs. Compare it to the version in the root.client/usr/vice/etc directory of the AFS 3.6 distribution to see if any changes are needed. If the initialization file is not already in place, copy it now. Note the removal of the .rc extension as you copy.

    # cp  -p  usr/vice/etc/afs.rc  /sbin/init.d/afs   

Copy the AFS kernel module to the local /usr/sys/BINARY directory.

The AFS 3.6 distribution includes only the libafs.nonfs.o version of the library, because Digital UNIX machines are not supported as NFS/AFS Translator machines.

   # cp  -p  bin/libafs.nonfs.o  /usr/sys/BINARY/afs.mod   

Configure and build the kernel. Respond to any prompts by pressing <Return>. The resulting kernel is in the file /sys/AFS/vmunix.

   # doconfig -c AFS   

Rename the existing kernel file and copy the new, AFS-modified file to the standard location.

   # mv  /vmunix  /vmunix_orig
   
   # cp  -p  /sys/AFS/vmunix  /vmunix   

Verify the existence of the symbolic links specified in the following commands, which incorporate the AFS initialization script into the Digital UNIX startup and shutdown sequence. If necessary, issue the commands to create the links.

   # ln -s  ../init.d/afs  /sbin/rc3.d/S67afs
   
   # ln -s  ../init.d/afs  /sbin/rc0.d/K66afs   

(Optional) If the machine is configured as a client, there are now copies of the AFS initialization file in both the /usr/vice/etc and /sbin/init.d directories. If you want to avoid potential confusion by guaranteeing that they are always the same, create a link between them. You can always retrieve the original script from the AFS distribution if necessary.

   # cd  /usr/vice/etc
   
   # rm  afs.rc
  
   # ln -s  /sbin/init.d/afs  afs.rc   

Reboot the machine.

   # shutdown -r now   

If you are upgrading a server machine, login again as the local superuser root, then return to Step 6 in Upgrading Server Machines.

   login: root
   Password: root_password