Title:        afs_install
Author:       Paul Blackburn
Feedback to:  mpb@acm.org
Version:      2.1
Last updated: 1999/01/07
URL:          https://www.angelfire.com/hi/plutonic/afs_install.html

install

0 Table of Contents

1 Introduction
    1.1 Supported systems
    1.2 Summary of client install actions
2 Setting up afs_install at your site
    2.1 TFTP server
    2.2 Create a directory for AFS binaries
    2.3 Obtain afs_install.tar
    2.4 Unbundle afs_install.tar
    2.5 Copy AFS binaries to your TFTP server
    2.6 Create your site "afs client install" script
3 Are you licensed to use AFS?
4 More information on AFS
5 Conclusion
6 Change History

1 Introduction

Using afs_install, an AFS client can be installed with commands similar to:

        # ensure right time, date, and TIMEZONE # step0
        echo "installing AFS client"            # step1
        server=your.tftp.server.hostname        # step2
        xec=afs_client_install                  # step3
        dst=/tmp/$xec                           # step4
        src=/usr/local/sbin/$xec                # step5
        tftp -go $dst $server $src image        # step6
        chmod 755 $dst                          # step7
        $dst                                    # step8

1.1 Supported systems

    rs_aix32 for AIX 3.2
    rs_aix41 for AIX 4.1
    rs_aix42 for AIX 4.2
    rs_aix43 for AIX 4.3

1.2 Summary of client install actions

• Create /usr/vice/etc/
• Install AFS drivers in /usr/vice/etc/dkoad/
• Add AFS entry in /etc/vfs
• Create an idempotent /etc/rc.afs
• Change /etc/inittab to start AFS
• Define which AFS cell your system belongs to
• Create a disk based AFS cache (filesystem: /usr/vice/cache)
• Make sure bosboot image is current
• Start up AFS Cache Manager
• Install the AFS aware version of login (rs_aix32)
  For rs_aix41 and rs_aix42, rs_aix43 the AIX login program does not need to be changed.
• Disable timed
• Enable ftp with AFS authentication (rs_aix32)
• Create an AFS version of inetd.conf
• Start an AFS version of inetd for AFS authenticated rsh and rcp

2 Setting up afs_install at your site

2.1 TFTP server

        echo allow:/vol/afs34a/ >> /etc/tftpaccess.ctl

2.2 Create a directory for AFS binaries

To accomodate the four current versions (rs_aix32 rs_aix41 rs_aix42, rs_aix43)
/vol/afs34a needs to be about 64 megabytes in size. For example:

        crfs -vjfs -grootvg -asize=131072 -amount=true -prw -Ayes -m/vol/afs34a
        mount /vol/afs34a

Create subdirectories for each machine type:

        cd /vol/afs34a
        mkdir rs_aix32 rs_aix41 rs_aix42 rs_aix43

2.3 Obtain afs_install.tar

        https://www.angelfire.com/hi/plutonic/images/afs_install.tar

    file:///afs/transarc.com/public/afs-contrib/tools/afs_install/afs_install.tar

2.4 Unbundle afs_install.tar

        cd /; tar -xvf /vol/afs34a/afs_install.tar

        usr/local/etc/afs_install/
        usr/local/man/man1
        usr/local/sbin/

        /usr/local -> /afs/@cell/@sys/usr/local

        cd /afs/.@cell/@sys
        tar -xvf /vol/afs34a/afs_install.tar
        # Maybe a replicated volume? If so, do a vos release:
        volume=`fs lq | awk '{if (NR == 2) print $1}'`
        vos release $volume -verbose

2.5 Copy AFS binaries to your TFTP server

1. Using your Transarc AFS binary distribution tape, use mk-afs-readtape
   to create the compressed archive files in /vol/afs34a. For example:

           # load rs_aix41 tape in drive
           cd /vol/afs34a/rs_aix41
           /usr/local/sbin/mk-afs-readtape 
   

2. Using an existing /usr/afsws directory, use mk-afs-bundle
   to create the compressed archive files in /vol/afs34a. For example:

           cd /afs/@cell/rs_aix32/usr/afsws
           /usr/local/sbin/mk-afs-bundle /vol/afs34a/rs_aix32
   

2.6 Create your site "afs client install" script

        /usr/local/sbin/mk-afs-client-install

Nota Bene
You must modify mk-afs-client-install to work at your site.
Two recommendations:

1. Make a copy of mk-afs-client-install to afs_client_install.
   The advantage of doing this is that if you fetch a more up-to-date copy of
   afs_install.tar, you will not overwrite your site-specific copy of afs_client_install.

           cd /usr/local/sbin
           cp mk-afs-client-install afs_client_install
   

2. Modify your site-specific afs_client_install to suit your site conventions.

           $your_favourite_editor afs_client_install
   

   In particular, set the following variables to your requirements:

   # site configurable variables follow ---------------------------------------
   
           server=your.tftp.server.hostname
           afs_install=/vol/afs34a/afs_install.tar     # on your TFTP server
           defaultcachesize=16      # 16 Physical Partitions is 64 megabytes
           default_cellname=your_afs_cellname
   
   # end of site configurable variables section -------------------------------
   

   Also, check the rest of afs_install_client particularily below the following line:

   # further site configurable variables section ------------------------------
   

3 Are you licensed to use AFS?

If you are uncertain whether you have the right to use AFS, then check first
with your system administrator.

For details about AFS licenses, contact Transarc at:

    web:   http://www.transarc.com
    email: information@transarc.com
    phone: +1 (412) 338-4400

4 More information on AFS

• Transarc homepage
• AFS frequently asked questions (Transarc)
• info-afs@transarc.com mail archive (Stanford University)

5 Conclusion

It has certainly saved me lots of time installing new systems
and upgrading existing systems.

It should be simple to make it work on other system types.
If you would like to help make this possible, please let me know.

--
paul                             http://acm.org/~mpb

6 Change History