[an error occurred while processing this directive]

NCSA NT AFS Installation/Upgrade Guide

This document is for installing or upgrading the AFS client on machines running Windows NT in the NCSA environment. Please read through these instructions once before installing AFS so you are familiar with some of the setup options. You will need to have admin access on the machine when running the setup program. If there are any questions or problems with this document, or an installation, then please contact afs@ncsa.uiuc.edu. This is going to require you to reboot your machine after the installation.


Warning - Windows 2000 users

The AFS client currently does NOT work on Windows 2000 systems. We will notify users via Headline News and the afs-info mailing list when Transarc releases the client for Windows 2000.



Previous Version of AFS Client

If you have a earlier version of the AFS client installed, version 3.4a, you will need to do the following before installing the 3.5 client. If you have already installed an earlier version of the 3.5 client then you can follow the install instructions up to the "Configuring the Client" section to upgrade.

Uninstalling the 3.4a client:
The 3.4a client needs to be uninstalled before installing the 3.5 client. We first want to stop the AFS service. To do this select Start -> Settings -> Control Panel. Double click on the Services icon and the list of services will come up. Scroll through the list until you find the "Transarc AFS Client" service, select it and then click on the "Stop" button. You can now close this and continue with the uninstall.

In Control Panel folder start the "Add/Remove Programs" file. In the list of software find the "AFS Client Patch", select it and then click on the "Add/Remove..." button. When this is done it will prompt you to reboot the machine. Do not reboot at this time, we first want to finish uninstalling the AFS client. In the Add/Remove Programs window select the "AFS Client" and click on the "Add/Remove..." button. Once if finishes uninstalling the AFS client go ahead and reboot. You should now be able to install the 3.5 client below.


Installing the Client

The AFS NT Client software is located in the following directory on the NCSA file-server:
  \\File-server\Software-PC\Commercial Software\AFS Client
If you cannot access this directory then please send mail to afs@ncsa.uiuc.edu. NCSA has a site license for our NT clients so the above directory on the file-server should be available to all NCSA users.

There are three folders in the AFS Client folder:

AFS Client folder

The 3.4a and 3.4a Patches folders are for earlier versions. We need to install the client in the 3.5 folder.

AFS 3.5 Client folder

In the 3.5 folder there is a shortcut called "Current release", select that and it will take you to the directory of the most current working release. Once in that directory there is an executable called setup.exe. Run that file and it will begin the afs installation.

The installation is pretty straight forward. The only option you have to choose is what components you want installed. Just select the AFS Client (unselect everything else):

AFS Components

If you want to install it in a directory other than the default, then you can select Browse... to set the path. Otherwise select Next > and it will install the client.

Once it is installed it prompts you if you want to reboot the machine, select Finish to reboot.

If this was an upgrade, and not an initial install of the 3.5 client, then you will not have to do any more configuration and are done.


Configuring the Client

Once the computer comes back up, the AFS client will now be installed. It will then prompt you to configure the AFS Client. You will need to run the AFS Client in the Control Panel. Start -> Settings -> Control Panel, then select AFS Client Configuration.

AFS Client Configuration

In the General section of the AFS Client Configuration, put in ncsa.uiuc.edu as the "Cell Name". Also make sure that the "Obtain AFS tokens...", and "Provide an AFS Light Gateway" are not checked. Once this is done then you can click on the "Start Service" button.

With the AFS client running, you can now set up drive letters to mount paths in AFS. Select the "Drive Letters" tab and select "Add...". If you had a previously installed AFS client you may already have drives mapped. If they are set up correclty then you are done with this section. Otherwise continue with the following.

AFS Map Drive Letter

In the "Map Drive Letter" window select a "Drive Letter" and an "AFS Path". You can add a "Description" if you like. If this is going to be a drive mapping you will always want, then make sure the "Restore this mapping whenever I logon" is checked. After you have added a couple of mappings your Drive Letters section should look like:

AFS Drive mappings

Here I have mapped /afs/ncsa.uiuc.edu to drive F: and my home directory /afs/ncsa.uiuc.edu/.u3/jbarlow to drive Y:.


Getting AFS Tokens

You will not get a token when logging into your system. Please refer to the Getting an AFS token on Windows document to learn how to get an AFS token.

Note:
If you had a previous version of AFS installed on your machine be sure to check the above web page to make sure you are using the correct version of the Kerberos distribution. Earlier versions will not work with the 3.5 AFS client.

[an error occurred while processing this directive]