Verifying the AFS Initialization Script

At this point you run the AFS initialization script to verify that it correctly invokes all of the necessary programs and AFS processes, and that they start correctly. The following are the relevant commands:

On system types that use a dynamic loader program, you must reboot the machine before running the initialization script, so that it can freshly load AFS modifications into the kernel.

If there are problems during the initialization, attempt to resolve them. The OpenAFS mailing lists can provide assistance if necessary.

  1. Issue the bos shutdown command to shut down the AFS server processes other than the BOS Server. Include the -wait flag to delay return of the command shell prompt until all processes shut down completely.

       # /usr/afs/bin/bos shutdown <machine name> -wait
    
  2. Issue the ps command to learn the bosserver process's process ID number (PID), and then the kill command to stop it.

       # ps appropriate_ps_options | grep bosserver
       # kill bosserver_PID
    
  3. Issue the appropriate commands to run the AFS initialization script for this system type.

    On AIX systems:

    1. Reboot the machine and log in again as the local superuser root.

         # cd /
         # shutdown -r now
         login: root
         Password: root_password
      
    2. Run the AFS initialization script.

         # /etc/rc.afs
      

    On HP-UX systems:

    1. Run the AFS initialization script.

         # /sbin/init.d/afs  start
      

    On IRIX systems:

    1. If you have configured the machine to use the ml dynamic loader program, reboot the machine and log in again as the local superuser root.

         # cd /
         # shutdown -i6 -g0 -y
         login: root
         Password: root_password
      
    2. Issue the chkconfig command to activate the afsserver and afsclient configuration variables.

         # /etc/chkconfig -f afsserver on
         # /etc/chkconfig -f afsclient on 
      
    3. Run the AFS initialization script.

         # /etc/init.d/afs  start
      

    On Linux systems:

    1. Reboot the machine and log in again as the local superuser root.

         # cd /
         # shutdown -r now
         login: root
         Password: root_password
      
    2. Run the AFS initialization scripts.

         # /etc/rc.d/init.d/openafs-client  start
         # /etc/rc.d/init.d/openafs-server  start
      

    On Solaris systems:

    1. Reboot the machine and log in again as the local superuser root.

         # cd /
         # shutdown -i6 -g0 -y
         login: root
         Password: root_password
      
    2. Run the AFS initialization script.

         # /etc/init.d/afs  start
      
  4. Wait for the message that confirms that Cache Manager initialization is complete.

    On machines that use a disk cache, it can take a while to initialize the Cache Manager for the first time, because the afsd program must create all of the Vn files in the cache directory. Subsequent Cache Manager initializations do not take nearly as long, because the Vn files already exist.

  5. If you are working with an existing cell which uses kaserver for authentication, please recall the note in Using this Appendix detailing the substitution of kinit and aklog with klog.

    As a basic test of correct AFS functioning, issue the kinit and aklog commands to authenticate as the admin user. Provide the password (admin_passwd) you defined in Initializing Cell Security.

       # kinit admin
       Password:  admin_passwd
       # aklog
    
  6. Issue the tokens command to verify that the aklog command worked correctly. If it did, the output looks similar to the following example for the example.com cell, where admin's AFS UID is 1. If the output does not seem correct, resolve the problem. Changes to the AFS initialization script are possibly necessary. The OpenAFS mailing lists can provide assistance as necessary.

       # tokens
       Tokens held by the Cache Manager:
       User's (AFS ID 1) tokens for afs@example.com [Expires May 22 11:52]
           --End of list--
    
  7. Issue the bos status command to verify that the output for each process reads Currently running normally.

       # /usr/afs/bin/bos status <machine name>
    

  8. Change directory to the local file system root (/) and issue the fs checkvolumes command.

       # cd /
       # /usr/afs/bin/fs checkvolumes