Getting Started with OpenAFS for Windows at RAL
Important note for CMS users:
The CMS data area is NOT BACKED UP by the eScience department
1. If it's not already installed, you need to install OpenAFS.
- go to http://www.openafs.org/ ,
- click "Download Latest Release" (top right)
- choose "Windows 2000/XP/2003"
- download the "OpenAFSforWindows-x-x-x.exe" file (where "x-x-x" is the current version)
2. Run the exe file to install the program
I've no idea what most of the options do, so I left them on their defaults; except for:
- 5th screen - change the AFS cell name to "rl.ac.uk"
4. Initial setup:
- From the start menu, choose Programs>OpenAFS>Client>Authentication.
(Notice that a padlock icon appears in the taskbar when the AFS service starts)
- in the AFS Client window, choose "Advanced"
- ensure that the cell name is "rl.ac.uk"
- ensure that "Obtain AFS tokens when logging into Windows" is checked (assuming you don't want to have to enter the password every time)
- ensure that "Show the AFS client icon in the taskbar" is checked (if you want)
- click "OK"
5. To map an AFS network drive:
- In the AFS Client window, choose "Drive Letters"
- Click the "Add..." button
- in the dialog box:
- choose a drive letter:
-in the AFS path box: type the path you've been given (eg afs\rl.ac.uk\user\f\fred)
- in the Submount box: type the name for the network drive (eg. MyAFSDrive)
- click "OK" - the drive should mount
- click on the "Tokens" tab and then back on the "Drive Letters" tab. The drive should have appeared in the list
6. AFS drive Commands, Properties, and Administration
If you right-click on an AFS file, folder, or drive, you will notice an "AFS" submenu, containing a number of AFS commands. The most useful of these is probably the "Access Control Lists..." which works like the Windows "Permissions" dialog.
You can also issue AFS commands via the standard Windows Command Prompt. (Start>Programs>Accessories>Command Prompt)
- for example, if your drive is mapped to F:, you can query the permissions by typing fs listacl F:
A full list of commands is available in the OpenAFS documentation (Start>Programs>OpenAFS>Documentation)
7. Change Password
to change your password,
- open a Windows Command Prompt (Start>Programs>Accessories>Command Prompt)
- type kpasswd
- type your old password
- type your new password
8. Getting Help
There are two help sections:
i) for general help on AFS, choose Start>Programs>OpenAFS>Documentation
ii) for specific help on the AFS client, click the help button in the AFS client window
iii) help from the e-science team: see http://www.e-science.clrc.ac.uk/web/services/afs