(Make sure that there is enough space available).
Use the default installation options.
(It may seem to get "stuck" at one point, but don't worry -- it will continue.)
The Windows AFS client can be used to access your AFS files from your Windows PC. Since it accesses files on the AFS fileservers directly, it is safer and faster than using the Windows Network Neighborhood (or My Network Places), which go through the AFS client on Linux computers. Installation is fairly straightforward.
Note: We encourage people to use a recent version of the Windows OpenAFS Client. Some users have had problems with old versions of the client. These instructions are written for version 1.5.66 and later versions of the Windows OpenAFS client.
First exit all other programs. You will reboot the computer as part of the installation.
Also, make sure that the clock on your computer is fairly accurate. If it's off by a lot, AFS won't know which is more up-to-date, files on the server or copies of those in the AFS cache on your computer. In that case, it won't let you access AFS until you have adjusted your clock.
You need two files to install the Windows AFS client: the installer file and our CellServDB file. There are 3 options (below) for getting the files. You can copy them to your desktop and delete them when you are finished with the installation.
CABI AFS download directory: If you already have the AFS client installed and are upgrading, you can copy the installation file and the CellServDB file from the download directory in our AFS filesystem. The path is \\afs\cabi\download\winxp\OpenAFSforWindows. Copy the CellServDB file and the installer file appropriate for your PC. If your PC is 32-bit, the installer file is the .exe file. If your PC is 64-bit, the installer file is the .msi file.
CABI FTP site: You can copy the installation file and the CellServDB file from our FTP site on claymore. Log in to the FTP site, then cd to download/OpenAFSforWindows. Get the CellServDB file and the installer file appropriate for your PC. If your PC is 32-bit, the installer file is the .exe file. If your PC is 64-bit, the installer file is the .msi file.
Latest version of the AFS installer from openafs.org: AFS is continually being improved. If you want to install the latest version of AFS, go to www.openafs.org. In the left column, under "Downloads", click "1.5.x Features Release" and then go to the Windows section at the bottom of the page. Right click on the appropriate installer file and choose Save Link As... or Save Target As... to save it to your PC. You will still need our version of the CellServDB file. You can download the CellServDB file to your desktop to use it (right-click, Save Link As...).
| Double-click the installer icon and choose Run. | |
| The setup wizard starts; click next. | |
| Agree to the license. | |
| Use the defaults for the components to install. Note: the defaults may change from those shown here. | |
| Choose the installation location -- the default is fine. (Make sure that there is enough space available). |
|
| For the CellServDB configuration, choose "Select a file", click on the box with the ellipses (...), navigate to the CellServDB that you got above, and select it. | |
| For the Client Cell Name Configuration, use cabi.rfmh.org. Use the default installation options. |
|
| Use the default AFS Credentials Configuration. | |
| Click on Install. The installation may take several seconds or a few minutes or more. (It may seem to get "stuck" at one point, but don't worry -- it will continue.) |
|
| Click "Finish" to reboot. | |
After the computer has rebooted, log in to Windows.
| In the taskbar (bottom right of screen) there should be a padlock icon with a red cross. The red cross means that you haven't authenticated yet to AFS. |  |
| The AFS authentication window should open automatically when you log in to Windows. Enter your AFS login information and click OK. When you are authenticated, AFS will give you a token, which will give you access to your files. |  |
If the AFS authentication window didn't open automatically, click the padlock icon in the taskbar to open the AFS authentication window. If the AFS authentication window didn't open automatically and there is no padlock icon in the taskbar, open the AFS authentication window via the start menu:
Start -> Programs -> OpenAFS -> Client -> Authentication.
You can map drive letters to directories in the AFS filespace. Prior to OpenAFS 1.5.66, the configuration for the drive mapping was accessible via the AFS Client window.
Starting with OpenAFS 1.5.66, the Windows client GUI just has the Tokens tab. In order to get to the configuration options that were in the Advanced tab, use the "AFS Client Configuration" in the Control Panel. In order to map an AFS directory to a drive letter, use Windows Explorer. These changes were implemented because of changes in Windows Vista and beyond. How to map an AFS directory to a drive letter:
| Open Windows Explorer or double-click My Computer. |  |
|
Choose Map Network Drive from the Tools menu.
Choose the drive letter from the drop-down menu.
We usually use letters at the end of the alphabet for AFS drive mappings, such as U: for the home directory. For Folder, type the pathname of the AFS directory that you want to map. |
 |
For example, if your username is smith and you want to map your AFS home directory to the U: drive, type
\\afs\cabi.rfmh.org\usr\smith
for the "folder" and then click Finish.
| In addition to mapping a drive letter to your home directory in AFS, it is also useful to map a drive letter to the whole CABI cell. This will allow you to navigate to other users' home directories, to the download directory, and to the AFS temp directory. |  |
| Now you have access to the AFS filespace as if it were a drive on your PC. |  |
| You can rename the drive -- right click on the drive's name and choose Rename. |  |
Instead of mapping an AFS drive to a drive letter, you can have an AFS directory show up as a folder under "My Network Places". Double-click the "My Network Places" icon on the desktop, double-click "Add Network Place", and use the wizard. Use "Choose another network location". For "Internet or network address", use the pathname of the AFS directory as above.
If everything works you can delete the installation file and the CellServDB file from your PC.
 |
This page was last updated on 4/14/2010. |