OpenAFS Client Installation Guide for Windows

Introduction

This document walks you through the process of installing the OpenAFS Client for Windows 64-bit on a campus computer running Windows 7, Windows 8 or Windows 10. It also includes configuration information for connecting to the ITS AFS file space (isis.unc.edu). AFS is only supported on computers physically attached to the campus network or connected through Virtual Private Networking (VPN). Please see VPN Installation and Clients document for more information about VPN.

Historically, only the OpenAFS client itself was required. Windows clients now require a combination of 3 applications that interact to provide access to AFS. They are the OpenAFS client, the Network Identity Manager application and a Heimdal application. A kerberos configuration file is also required. ITS has created a self extracting executable that unifies the installation into a single package.

Note that on March 30, 2016, clients must utilize this new package. Previous installations using only the OpenAFS client will no longer be able to access the ITS AFS cell isis.unc.edu.
Windows 32-bit users, please use SFTP to connect to your AFS space.  Please visit the document https://help.unc.edu/help/connecting-to-isis-unc-edu-and-your-h-drive-using-sshsftp-secure-shell-in-windows/ for installation/connection instructions.

It is recommended that you read these instructions completely before installing OpenAFS.

Downloading the OpenAFS client

The OpenAFS client for Windows 64-bit is available to download from https://shareware.unc.edu/pub/win/afs.exe.
Download

Installing and Configuring the OpenAFS client for UNC.

  • The installation instructions are based on OpenAFS Version 1.7.x for Win 7 (64-bit).
  • Win 8 and Win 10 installs will be a similar process but may look a little different then the Win 7 (64-bit) install.
Open your “Downloads” folder and Right-click the downloaded file “AFS.exe” and select “Run as administrator”.
Critical! If you do not select the “Run as administrator” option, the installation will not work correctly.
A new command window (example below) will open and then close automatically once the installation is complete.

AFS CMD WIndow
Critical! Once the command window closes, please restart the computer for the installation to complete.

Obtaining Tokens and Mapping the drive for OpenAFS Client

When your computer finishes rebooting, log back in with the same username you used to install the software. By default, AFS will be running when you log in.

Open the application “Network Identity Manager” from the Start Menu

start_network_manager

Right-Click the entry for “onyen@ISIS.UNC.EDU” and select “Obtain new credentials” from the drop down menu.

network_identity

Enter your password and click “Finish”

creds

If there is no entry for “onyen@ISIS.UNC.EDU” then do the following extra steps.

Select Options – Identities from the drop-down menu

keystore_options

A new window called Network Identity Manager Configuration will open. Click the button “Add new identity…”

keystore_newidentity2

In the new window, enter your Onyen on the Username field. Select “ISIS.UNC.EDU” from the dropdown for the Realm field. Click finish and then OK for the previous window.

keystore_realm

Select Credential – New credentials – Obtain new credentials for myOnyen@ISIS.UNC.EDU

keystore_newcreds2

Enter your password in the field provided then click Finish

keystore_pw

Next you will need to map the AFS drive.

Click the WindowsStart Menu, chooseComputer, and then clickMap network drive from the menu bar.

Select a Drive letter from the drop down menu and enter the path of the directory you wish to access. The default path for your personal H drive is in the form of afsisis.unc.eduhomeononyen; replace the ‘o’ with the first character of your Onyen, replace the ‘n’ with the second letter of your Onyen, then replace ‘onyen’ with your full Onyen.

Your AFS drives are now ready to use. If you navigate to Computer or Windows Explorer, you will see your mapped drives.

If you have further questions or encounter problems, please contact the ITS Service desk at 919-962-HELP (962-4357) or 1-866-962-4457 (US and Puerto Rico), or submit a help request at http://help.unc.edu for assistance.