[an error occurred while processing this directive]

NCSA HP-UX 10.20 AFS Client Upgrade Guide

This document is for machines that already have the AFS client running on HP-UX 10.20 in the NCSA environment, and want to upgrade to the latest version. Please read through these instructions once before upgrading the AFS client so you are familiar with some of the setup options. If there are any questions or problems with this document, or an upgrade, then please contact afs@ncsa.uiuc.edu. If this is the first time installing AFS on this machine, then please refer to the AFS installation guide. This installation requires the user to be "root" and the machine is going to need to be rebooted.

Upgrading client from script

There is currently no script available to update the kernel.

Replacing client files onto the local disk

Most of the client setup has already been done when it was initially installed. All we need to do is replace a few client binaries and change a symbolic link.

First we want to back up the old version of the AFS client: 

  # mv /usr/vice/etc/afsd /usr/vice/etc/afsd.old

Go to the following directory. 

  # cd /afs/ncsa/hp_ux102
Once you are in the above directory then 
  # cd usr/afsws/root.client/usr/vice/etc
Warning: Make sure you do not cd to /usr/afsws/root.client/usr/vice/etc above, (the / is in front of the usr) or else you could get the wrong versions of the binaries.

Now copy the new versions of the client binaries: 

  # cp afsd /usr/vice/etc/
  # chmod 755 /usr/vice/etc/afsd
We can test the following files and see if there are any differences. If so then we will want to replace the files with the latest copy. 
  # diff /usr/vice/etc/CellServDB /afs/ncsa/service/etc/CellServDB
  # diff /sbin/init.d/afs /afs/ncsa/service/etc/rc/hp_afs.rc
If there are differences on any of the above files then replace the local copy with the newer copy from AFS.

Copying the Kernel Modules

First change to the appropriate root.client directory in AFS: 
  # cd /afs/ncsa/hp_ux102
  # cd usr/afsws/root.client/usr/vice/etc
Warning: Make sure you do not cd to /usr/afsws/root.client/usr/vice/etc above, (the / is in front of the usr) or else you could get the wrong versions of the binaries.

Now copy the new Kernel modules: 

  # cp /usr/vice/etc/afs.driver /usr/vice/etc/afs.driver.old
  # cp afs.driver /usr/vice/etc
  # cp afs.driver /usr/conf/master.d/afs

Now change to the root.client/bin directory: 

  # cd ../../../bin
At this point execute a pwd command to make sure that you are in /afs/ncsa/hp_ux102/<client version>/root.client/bin

Now copy the new kernel mod:

If the machine supports NFS server functionality: 

  # cp /usr/vice/etc/libafs.a /usr/vice/etc/libafs.a.old
  # cp libafs.a /usr/vice/etc/libafs.a
  # cp libafs.a /usr/conf/lib/libafs.a
If the machine does not support NFS server functionality: 
  # cp /usr/vice/etc/libafs.nonfs.a /usr/vice/etc/libafs.nonfs.a.old
  # cp libafs.nonfs.a /usr/vice/etc/libafs.nonfs.a
  # cp libafs.nonfs.a /usr/conf/lib/libafs.a

Replacing AFS binary paths and the AFS login

 Now you need to change the path for accessing all of the afs binaries. 
  # mv /usr/afsws /usr/afsws.old
  # ln -s /afs/ncsa/(hw type)/usr/afsws /usr/afsws
Replace (hw type) with the system type of the machine which was determined above (ie. /afs/ncsa/hp_ux102/usr/afsws).

We want to replace the old AFS login program. 

  # mv /bin/login.afs /bin/login.afs.old
  # cp /usr/afsws/bin/login /bin/login.afs

Installing the new Kernel

 Backup the existing kernel and configuration files to a safe place: 
  # cp /stand/vmunix /stand/vmunix.prev
  # cp /stand/system /stand/system.prev
Now use method A or B to install the new kernel.

(A) Using SAM to install the AFS kernel

 Issue the following command to invoke SAM: 
  # sam -display your_display:0
Where your_display represents the hostname of the machine on which you are invoking SAM.

Choose the Kernel Configuration icon.
Choose the Drivers icon.

Pull down the Actions menu.
Choose Create a New Kernel.

Confirm your choices by choosing Yes and OK when prompted by subsequent popup windows. SAM will rebuild the kernel and reboot the system.

(B) Installing the AFS kernel manually

Edit /stand/system by adding a line with afs to the Subsystems section.

Change directories to /stand/build and build the kernel. 

  # cd /stand/build
  # mk_kernel

Save the original kernel to a safe location, move the new kernel into /stand/vmunix, and reboot. 

  # mv /stand/vmunix /stand/vmunix.orig
  # mv /stand/build/vmunix_test /stand/vmunix
  # reboot

Testing to see if the newest version of the client is installed

You can run the following script which will tell you if you are running the latest version of the AFS client: 
  # /afs/ncsa/common/bin/afs_version
[an error occurred while processing this directive]