Copyright: © IBM Corporation, 1999
Citation: AFS-3.6-ALH-031500


AFS
AFS®

AFS is an enterprise file system that provides consistent file access via a single, shared filespace.

Files are stored (distributed) on different machines in the computer network but are accessible from all machines.


AFS Access Permissions

AFS access permissions apply to the directory on which ACLs are placed and to the subdirectories and files contained in the directory.  See Directory-Level Access Control for more information.

Note:	Each permission has an accepted single-character abbreviation, which appears before the complete name in the following definitions.

l	Lookup

Users can view the names of subdirectories and files within a directory, display details of a directory's contents, examine the ACL for a directory, and access a directory's subdirectories (unless restricted by subdirectory ACLs).  Note that users cannot view the contents of subdirectories without first having Lookup permission on the parent directory.

Note:	If a user is denied Lookup permission, all other permissions are denied.

r	Read

Users can read the contents of the files in a directory.

i	Insert

Users can create new subdirectories and add files to a directory either by creating new files or by copying existing files.

d	Delete

Users can remove files and subdirectories from a directory.

w	Write

Users can modify the contents of the files in a directory.

k	Lock

Users can run programs that place advisory locks on files in a directory.

a	Administer

Users can change the ACL for a directory.  Users have the Administer permission on their home directory and its subdirectories.

Related Topics:

Other Variable Permissions

An Overview of Access Control Lists

Directory-Level Access Control

Setting Access Control Lists


AFS Cells Tab - Add Button
Add

Adds a cell to your machine's cell database.  You must specify the full cell name.  Abbreviated cell names are not accepted.

See Adding Cells to Your Cell Database.


AFS Cells Tab - Change Button
Change

Enables you to edit information about the selected cell.

See Changing Cell Information.


AFS Cells Tab - Remove Button
Remove

Removes the selected cell from the cell database.  When you choose the Remove button, AFS Light displays a message asking you to verify that you want to delete the selected cell.  Upon confirmation of this operation, you can no longer contact that cell.

See Removing Cells.


AFS File Storage Concepts

Cells and Sites

The cell is the administrative domain in AFS.  Each cell is autonomously administered.  The cell's administrator determines how client machines are configured and how much storage space on the File Server is available to each user.

A cell's domain can consist of a company, a department, or any custom-defined group of users.  From a hardware perspective, a cell is a grouping of client machines and server machines that are members of the same local cell.  An AFS site is a grouping of one or more related cells.

While AFS organizes and maintains the filespace by cells, each cell and each site can also connect with the filespace of other cells and sites running AFS on the same network.  The result is a huge filespace that enables file sharing within and across cells and sites.

Partitions, Volumes, and Mount Points

The disks in a computer are divided into sections called partitions.  AFS further divides partitions into subsections called volumes.  A volume houses a subtree of related files and directories.  The volume provides a convenient means for storing, backing up, and moving related files and directories.

Access to a volume is through the mount point.  A mount point is a special type of link between a directory location in the file tree and the volume that houses the elements in that directory.  In the file tree, an AFS directory looks like a regular directory.  When you move to a new directory, it is possible to cross a mount point without even knowing it.  When you cross a mount point, you move from one volume to another and possibly from one File Server and partition to another.  This transition is transparent to you because AFS interprets the mount points and retrieves the requested files and directories that you request from the appropriate location, making it unnecessary for you to know their volume, partition, and File Server locations.

Quotas

The files in your home directory are generally stored together in a single volume.  To divide your cell's available disk space as efficiently as possible, your system administrator sets a size limit, or quota, for each volume.  You cannot store more data in a volume than its quota allows.  If you are close to exceeding a volume's quota, it can be impossible to save changes to a file stored in that volume.  Similarly, sometimes it is not possible for you to save a file because the disk partition that contains your volume is full, even though your volume is well below its quota.

Check the quota of your home directory volume periodically to verify that you have adequate space.  Also, if you encounter problems saving a file, check the quota of the partition which houses the volume.  You can check quotas by choosing the Volume/Partition option from the AFS Menu.  Contact your system administrator if you are close to exceeding the quota on a volume or partition.

Related Topics

Volumes and Partitions

Mount Points

Showing File Servers

Showing Cells


AFS Light
About AFS Light

AFS® Light for Windows 95® and Windows 98® enables you to manage files and directories in the AFS filespace from a Windows 95 or Windows 98 machine.  When you request a file in the AFS filespace, AFS Light accesses shared AFS resources through an AFS Client for Windows NT® machine running an AFS Light Gateway.  A copy of the requested file is stored on your local disk.

Managing AFS files and directories is similar to managing files and directories on your local file system.  You can create, name, move, copy, select, delete, rename, print, and search for AFS files and directories as described in your Windows documentation.

As a Windows user, you maintain the option of using the command-line interface from a Command Prompt Window to manage files and directories in the AFS filespace.

Related Topics:

About AFS

Command Prompt Commands


AFS Light Configuration AFS Cells Tab Summary
AFS Light Configuration:  AFS Cells Tab

The following information is displayed on this tab:

The AFS Cells field displays all registered AFS cells.

From this tab you are able to perform the following functions:

Add new cells to AFS Light's cell database

Modify cell information that is currently in your cell database

Remove cells from your cell database

See AFS Light Configuration: AFS Cells Tab for more information


AFS Light Configuration Drive Letters Tab Summary
AFS Light Configuration: Drive Letters Tab

The following information is displayed on this tab:

Drive letters mapped to paths in AFS and their connection status

From this tab you are able to perform the following functions:

Map drive letters to paths in AFS

Modify mappings

Remove mappings

Connect network drive mappings

See AFS Light Configuration: Drive Letters Tab for more information.


AFS Light Configuration General Tab Summary
AFS Light Configuration: General Tab

From this tab you can perform the following functions:

Designate a Windows NT machine to serve as your gateway to the AFS filespace.

View the AFS cell in which AFS Light is configured.

Integrate your AFS logon with your Windows logon.

Show the AFS Light icon in the taskbar.

See AFS Light Configuration: General Tab for more information.


AFS Light Configuration Utility

The AFS Light Configuration utility is accessible from the Control Panel.

To access the AFS Light Configuration utility:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

The AFS Light Configuration utility appears.

Tabs

From the AFS Light Configuration utility, you can access the following three tabs:

  General

  Drive Letters

  AFS Cells


AFS Light Configuration:  AFS Cells Tab

The AFS Cells tab enables you to modify your machine's cell database.  The cell database is a list of all registered AFS cells.  AFS Light must register a cell before you can contact that cell.  The cell database is located in the afsdcell.ini file in the default Windows directory.  You must restart your machine for cell database changes to take effect.

The AFS Cells field displays all registered AFS cells.

The AFS Cells field provides options for adding new cells to AFS Light's cell database, modifying cell information that is currently in the cell database, and removing cells from the cell database.

  Add

  Change

  Remove

Related Topics:

Adding New Cells to your Cell Database

Changing Cell Information

Removing Cells from your Cell Database


AFS Light Configuration: Drive Letters Tab

The Drive Letters tab enables you to map drive letters to any AFS path.  This tab also displays drives that you currently have mapped to AFS and their respective pathnames.

Note:	In order to use AFS Light, you must have at least one drive mapped to the AFS filespace.

The Drive Letters tab displays the following information:

Drive letters currently mapped to paths in AFS:

The name of the drive is followed by the full AFS path.

The Connection Status of each drive:

If the check box is selected, the drive is currently connected to the AFS filespace.

If the check box is not selected, the drive is not connected to the AFS filespace.

Note:	Click an unselected check box to connect a drive.  See Connecting a Drive to the AFS Filespace.

The Drive Letters tab provides the following options:

  Add

  Change

  Remove


AFS Light Configuration: General Tab

The General tab enables you to designate a Windows NT machine to serve as a gateway to the AFS filespace, to integrate your AFS logon with your Windows logon, and to display the AFS Light icon in the taskbar.

The General tab offers the following configuration options:

  Gateway

  Cell Name

  Obtain AFS tokens when logging into Windows

  Show the AFS Light icon in the taskbar


AFS Light Program Group
The AFS Light Program Group

The AFS Light program group is added to the Programs menu when AFS Light is installed. The AFS Light program group provides commands available to AFS Light users.

To access the AFS Light program group:

1.	From the Start menu, find the IBM AFS (or IBM WebSphere) program group and choose the Light entry.

2.	The AFS Light program group is displayed.

The AFS Light program group provides the following commands:

  Authentication

  Online Help


AFS Light Program Group - Authentication
Authentication

Displays the Tokens tab on the AFS Light property box, which allows you to verify authentication, obtain tokens, and discard tokens.

See Authenticating to AFS for more information.


AFS Light Property Box

The AFS Light property box is accessed from the AFS Light icon located in the taskbar.  See Displaying the AFS Light Icon.

The AFS Light property box provides the AFS user with a convenient method of performing many AFS tasks.

To access the AFS Light Property Box:

1.	Display the AFS Light icon in the taskbar, which is located on the bottom right side of your monitor.

a.	From the Start menu, choose Settings, then choose Control Panel.

b.	Double-click the AFS Light Configuration icon to display the AFS Light Configuration utility.

c.	Select the General tab.

d.	Select Show the AFS Light icon in the taskbar.

e.	Select OK.

The AFS Light icon immediately appears as a small padlock in your taskbar.

2.	Click the AFS Light icon in the taskbar.

The AFS Light property box appears.

The following information is displayed on the AFS Light property box:

  Username

  Version

The following tabs are located on the AFS Light property box:

  Tokens

  Drive Letters


AFS Light Property Box - Version Field
Version

Displays the version of AFS Light that is currently installed on your Windows machine.


AFS Light Property Box:  Drive Letters Tab

The Drive Letters tab is accessed from the AFS Light icon on your taskbar.  See Displaying the AFS Light Icon for more information on how to display this icon in the taskbar of your Windows machine.

The Drive Letters tab displays the following information:

Drive letters currently mapped to paths in AFS:

The name of the drive is followed by the AFS pathname.

The Connection Status of each drive:

If the check box is selected, the drive is currently connected to the AFS filespace.

If the check box is not selected, the drive is not connected to the AFS filespace.

Note:	Click an unselected check box to connect a drive.  See Connecting a Drive to the AFS Filespace.

The Drive Letters tab provides the following options:

  Add

  Change

  Remove

Related Topics:

Mapping Network Drives to AFS


AFS Menu
The AFS Menu

The AFS Menu is added to your Windows Explorer when AFS Light is installed.  The AFS Menu provides commands available to AFS Light users.

To access the AFS Menu:

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click an AFS file or directory.

3.	Point to AFS.

The AFS Menu is displayed.

The AFS Menu provides the following commands.

Access Control Lists

Volume/Partition

Mount Point

Flush File/Dir

Flush Volume

Show File Servers

Show Cell

Show Server Status


AFS Overview
AFS®

AFS® is an enterprise file system that provides consistent file access via a single, shared filespace.  By joining the local file systems of several File Server machines, AFS presents a single filespace independent of machine boundaries.  Files are stored on different machines in the computer network but are accessible from all machines.  In this way, AFS makes it easy for users to share files.

AFS users do not need to know the physical location of files, even though a file can be stored on any number of File Server machines.  AFS files accessed by authorized users from their own desktops appear to be stored on their local machines.

As in any shared file system, you can perform tasks only on those files and directories for which you have the proper permissions.

Related Topics:

AFS File Storage Concepts

AFS Security Concepts

About AFS Light


AFS Security Concepts

Because AFS is accessed by many users, several methods are used to ensure system security.

Passwords and authentication are used to verify that only authorized users access AFS.

Access control lists enable individual users to restrict or allow access to their own directories.

Related Topics:

Authenticating to AFS

Access Control Lists


Access Control Lists

To secure files and directories in AFS, you must define access rights by using Access Control Lists (ACLs).  An ACL is a list of security attributes that are associated with an AFS directory.  ACL entries specify the operations that a user or group is permitted to perform on a particular directory and its files.  Each directory's ACL can have up to 20 ACL entries.

User entries

A user entry applies to the corresponding user only.

Group entries

A group entry applies to all members of the specified group.  A group can consist of both users and machines.  A user that is a member of a group has all of the permissions of that group.  A user who is logged into a machine that is a member of a group has all of the permissions of that group.

You can grant any combination of permissions to a user or group or specifically deny access to a user or group on an ACL.

Related Topics:

AFS Access Permissions

Directory-Level Access Control

Normal and Negative Entries

Setting Access Control Lists


Access Control Lists Command
The Access Control Lists Command

An Access Control List (ACL) is a list of security attributes associated with an AFS directory.  ACL entries specify the Access Permissions that control the operations a user or group is permitted to perform on a particular directory and its files.

The Access Control Lists command on the AFS Menu displays the Set AFS ACL dialog box, which displays ACL entries and enables you to edit and change permissions, add new entries to an ACL, delete entries from a list, copy the ACLs of other directories, and clean or update an ACL.

Note:	Access Control Lists are associated with AFS directories.  When you access the AFS Menu by right-clicking a file, the Access Control Lists command is not available.

Related Topics:

Setting ACLs

Directory-Level Access Control


Add ACL Entry Dialog Box
The Add ACL Entry Dialog Box

The Add ACL Entry dialog box contains the following information.

  Permissions

  Entry Type

  Name

Related Topics:

Adding ACL Entries

An Overview of Access Control Lists


Add ACL Entry Dialog Box - Entry Type Field
Entry Type

Sets the ACL entry to be either normal or negative.

Select Normal to set the entry type to be Normal, granting the user or group the specified permissions.  The ACL entry appears in the Normal Entries list on the Set AFS ACL dialog box.

Select Negative to set the entry type to be Negative, denying the user or group the specified permissions.  The ACL entry appears in the Negative Entries list on the Set AFS ACL dialog box.

See Normal and Negative Entries for more information.


Add ACL Entry Dialog Box - Name Field
Name

Sets the name of the user or group to be added to the access control list.


Add ACL Entry Dialog Box - Permissions Field
Permissions

A series of check boxes that enable you to set the AFS access permissions.

See AFS Access Permissions for more information.


Add Server Dialog Box

For each cell, you must specify one or more Volume Location Servers.

  Server Name

  Server Address

Related Topics:

Adding Server Information to a Cell


Add Server Dialog Box - Server Address Field
Server Address

Enables you to either provide a specific IP address for the Volume Location Server or to direct AFS to look up the address automatically.


Add Server Dialog Box - Server Name Field
Server Name

Specifies the name of the Volume Location Server  that you want to add to the Servers list.


Adding ACL Entries

You can add a new user entry or group entry to an access control list, granting that entry normal or negative permissions.  Each ACL can have up to 20 entries.

To add an ACL entry

Note:	To add an entry to a directory's ACL, you must have Administer permission on the directory.  See AFS Access Permissions.

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the AFS directory to which you want to add an ACL entry.

3.	Point to AFS.  The AFS Menu is displayed.

4.	Select Access Control Lists.

The Set AFS ACL dialog box appears.

5.	Select Add.

The Add ACL Entry dialog box appears.

6.	In the Name box, enter the name of the user or group that you want to add to the ACL.

7.	In the Entry Type box, select the entry type.  A normal entry grants the user or group the specified permissions; a negative entry denies the user or group the specified permissions.  See Normal and Negative Entries for more information.

Note:	You must add normal and negative permissions separately.

8.	In the Permissions box, select all AFS access permissions that you want to apply (normal rights) or deny (negative rights) to the directory.  See AFS Access Permissions for more information.

9.	Click OK to close the Add ACL Entry dialog box.

The ACL entry that you added now appears in the Normal or Negative permissions list on the Set AFS ACL dialog box.

Related Topics:

Copying ACLs

Removing ACL Entries

An Overview of Access Control Lists


Adding Cells to Your Cell Database

AFS Light includes a file with a list of all registered AFS cells.  This cell database is located in the afsdcell.ini file in the default Windows directory.  AFS Light must register a cell before you can contact that cell.

An identical cell entry must exist in the AFS Light Gateway's cell database (afsdcell.ini file) in order for the AFS Light user to authenticate to the cell.  The AFS Light Gateway machine must be able to reach a cell's Volume Location Server machines in order to access files from the cell.  Incorrect or missing information about a cell in the gateway machine's cell database renders your light client machine unable to access files.

To add a cell to your cell database:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the AFS Cells tab.

4.	Select Add.

The New Cell dialog box appears.

5.	In the AFS Cell box, enter the name of the new AFS cell.

6.	In the Description box, enter a description to identify the new cell.

7.	For each new cell, you must specify one or more Volume Location Servers.  Select the Add button to add server information.

The Add Server dialog box appears.

8.	In the Server Name box, enter the name of a Volume Location Server in the new cell.

9.	Select Use specific address and enter the IP address of the server or select Look up address automatically to have Windows look for the address.

10.	Click OK.

The server's name and address now appear in the Servers field on the New Cell dialog box.

Repeat Steps 7-10 for cells with multiple Volume Location Servers.

11.	Click OK to add the cell to the list of registered AFS cells on the AFS Cells tab.

Related Topics:

Changing Cell Information

Deleting Cells from the Cell Database


Adding Servers to Cells
Adding Server Information to a Cell

For each cell that is listed in AFS Light's cell database, AFS Light must be aware of at least one Volume Location Server in that cell.  Often, there are multiple Volume Location Servers in a cell.

When adding a new cell to AFS Light's cell database, you must specify one or more Volume Location Servers.  See Adding a New Cell to the Cell Database for more information.

You can add servers to cells that are already registered in AFS Light's cell database.

To add server information to an existing cell:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the AFS Cells tab.

4.	Double-click the cell to which you want to add server information.

The Cell Properties dialog box appears.

5.	Select Add.

The Add Server dialog box appears.

6.	In the Server Name box, enter the name of a Volume Location Server that you want to add to the specified cell.

7.	Select Use specific address and enter an IP address or select Look up address automatically to have Windows look for the address.

8.	Click OK.

The server's name and address now appear in the Servers field on the Cell Properties dialog box.

9.	Click OK to close the Cell Properties dialog box.

Related Topics:

Removing Server Information from a Cell

Changing Server Information

Changing Cell Information


Authenticating to AFS
Authenticating to AFS (Obtaining Tokens)

Authentication is the process of proving your identity to AFS by providing your username and the password associated with your username. When you authenticate to AFS, you are given a token that AFS Light uses when requesting services from AFS servers.  If you do not have a token, AFS considers you to be an anonymous user and severely limits your access to the AFS filespace.

In many systems, logging in and authenticating are combined into a one-step procedure.  If this is the case on your system, you are already authenticated to AFS.  Your system administrator can tell you which type of login your cell uses, or you can check for tokens after logging in.  See Verifying Authentication.

To authenticate to AFS

1.	Display the Tokens tab on the AFS Light property box using one of the following methods:

From the Start menu, find the IBM AFS (or IBM WebSphere) program group and the Light program subgroup.  Choose Authentication.

Click the AFS Light icon in the taskbar and select the Tokens tab.  See Displaying the AFS Light Icon for more information.

2.	From the Tokens tab, select Obtain New Tokens.

The Obtain New AFS Tokens dialog box appears.

3.	In the AFS Cell box, type the name of the cell to which you want to authenticate or accept the default cell, which is your local cell.

4.	Type your AFS username in the User Name box.

5.	Type your password in the Password box.  The password is not echoed on the screen.

6.	Click OK to authenticate.  The Tokens tab displays the new token information.  For more details on the information displayed in the Tokens tab, see Tokens tab.

Note: 	If you want to authenticate to more than one cell, repeat Steps 2 through 6 for each cell.

You can integrate your AFS authentication with your Windows logon.  See Integrated Logon for more information.

Related Topics:

Unauthenticating from AFS (Discarding Tokens)

Verifying Authentication


Cached Files

Copies of AFS files are stored on your machine's local disk.  AFS Light uses the local copies of the cached files so it does not need to continue sending network requests for data from the stored file.

You can discard the cached files from your client machine's local disk.

The AFS Menu provides the following commands for discarding ad files:

Flush File/Dir

This command forces AFS Light to discard the data it has stored for a specified file or for all files from a specified directory.  See Flushing Files and Directories for more information.

Flush Volume

This command forces AFS Light to discard the data it has stored for all elements in the cache that originate from the same volume as a specified file or directory.  See Flushing Volumes for more information.

Related Topics:

File Storage Concepts


Cell Database

AFS Light includes a file with a list of AFS cells and the names and IP addresses of Volume Location Servers within each cell.  This is AFS Light's cell database.  The cell database is located in the afsdcell.ini file in the default Windows directory.

A cell entry must also exist in the AFS Light Gateway's cell database (afsdcell.ini file) in order for the AFS Light user to authenticate to a cell.  The AFS Light Gateway machine must be able to reach a cell's Volume Location Server machines in order to access files from the cell.  Incorrect or missing information about a cell (in either the gateway's cell database or the client's cell database) renders your client machine unable to access files.

Note:	It is important to update and synchronize cell information whenever a cell's server information changes.

You can add cells to AFS Light's cell database, modify a cell's information, and remove cells from the cell database.  Use the AFS Cells tab on the AFS Light Configuration utility to perform these operations.

Related Topics:

Adding Cells to the Cell Database

Changing Cell Information

Deleting Cells from the Cell Database


Cell Properties Dialog Box

This dialog box appears when you choose the Change button from the AFS Cells tab on the AFS Light Configuration utility.  It contains information about a specified cell and enables you to modify the specified cell in AFS Light's cell database.

Note:	For each registered cell, you must specify one or more Volume Location Servers.

Using the Cell Properties dialog box, you can change information about registered AFS cells.

  AFS Cell

  Description

  Servers

The Cell Properties dialog box enables you to add database servers to a cell, modify a cell's database server information, and remove database servers from a cell.

  Add

  Change

  Remove

Related Topics:

Changing Cell Information


Changing Cell Information

You can modify a cell that has been registered in AFS Light's cell database.  You can change the name of a cell, the description that identifies the cell, and the Volume Location Server information for a cell.

An identical cell entry must exist in the AFS Light Gateway's cell database (afsdcell.ini file) in order for the AFS Light user to authenticate to the cell.  The AFS Light Gateway machine must be able to reach a cell's Volume Location Server machines in order to access files from the cell.  Incorrect or missing information about a cell in the gateway machine's cell database renders your light client machine unable to access files.  If you modify AFS Light's cell database, be sure make the same changes to the cell database on the AFS Light Gateway machine.

To change cell information:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the AFS Cells tab.

4.	Select the cell that you want to modify and select Change.

The Cell Properties dialog box appears, displaying information about the cell.

5.	In the AFS Cell box, make changes to the cell's name, if desired.

6.	In the Description box, make changes to the cell's description, if desired.

7.	Select Add to add a server entry to the cell.  See Adding Server Information to a Cell.

Select Change to modify server information.  See Changing Server Information.

Select Remove to delete a server entry from the cell.  See Removing Server Information from a Cell.

7.	Click OK.

Note:	Incorrect or missing information about a cell makes it impossible for your client machine to access files in that cell.  It is important to update cell information.

Related Information:

Adding Cells to the Cell Database

Deleting Cells from the Cell Database


Changing Network Drive Mappings

For easy access to files stored in the AFS filespace, you can map a drive directly to a specific place in the AFS filespace.

You can modify these mappings by changing the network drive letter, specifying a different AFS path, and changing the description.  You can also change the connection status of network drive mappings.

To change network drive mappings:

Note:	A network drive that is being used cannot be modified.

1.	Access the Drive Letters tab by using one of the following methods:

From the AFS Light Configuration utility:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the Drive Letters tab.

From the AFS Light property box:

1.	Click the AFS Light icon in the taskbar.  See Displaying the AFS Light Icon for more information.

2.	Select the Drive Letters tab.

2.	In the Drive Letters field, select the mapping that you want to modify.

3.	Select the Change button.

4.	The Map Drive Letter dialog box appears.  Modify the Drive Letter, AFS Path, and Description as necessary.

5.	Select or clear the Restore this mapping whenever I log on check box as desired.

6.	Click OK.

The changes appear on the Drive Letters tab.  The changes also appear in your Windows Explorer.

Related Topics:

Mapping Network Drives to AFS

Removing Network Drive Mappings


Changing Server Information

AFS Light contains a file with a list of all registered AFS cells and the names and IP addresses of Volume Location Servers within each cell.  This cell database is located in the afsdcell.ini file in the default Windows directory.

Whenever a cell's Volume Location Server machines change, you must update the cell database.

To change a cell's server information:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the AFS Cells tab.

4.	Select the cell whose server information you want to change, and select Change.

The Cell Properties dialog box appears.

5.	Select the server whose information you want to change, and select Change.

The Edit Server dialog box appears.

6.	In the Server Name box, enter the new name of the Volume Location Server, if necessary.

7.	In the Server Address box, enter the new IP address of the Volume Location Server, if necessary.

8.	Click OK.

The server's modified information now appears on the Servers list in the Cell Properties dialog box.

9.	Click OK to add the modified server information to the cell.

Related Topics:

Changing Cell Information

Removing Server Information from a Cell


Command Prompt Commands

AFS Light for Windows 98 provides several commands that enable you to manage your AFS files and directories from your command prompt.  In many cases, these commands provide an alternative method of managing your AFS files and directories, as many of the same operations can be performed by using the AFS graphic user interface on your desktop.  (Note that these command suites are not available when AFS Light is installed on a Windows 95 system.)

Available command prompt commands include:

fs command suite

vos command suite

bos command suite

kas command suite

pts command suite

klog

tokens

unlog

Related Topics:

Issuing Commands at the Command Prompt


Command Prompt Window

A command-line interface used to enter text commands.

To access a Command Prompt window from a PC running Windows 95 or Windows 98:

From the Start menu, choose Programs, then Command Prompt.


Connecting Drives to AFS
Connecting and Disconnecting Network Drive Mappings

A network drive that is mapped to the AFS filespace can either be connected or disconnected.

Note:	Disconnecting a network drive mapping does not delete it.

There are several options for connecting and disconnecting drives to AFS.

A newly created network drive mapping is automatically connected.

A deleted network drive mapping is immediately disconnected.

A network drive mapping created with the Restore this mapping whenever I log on option selected is automatically connected every time you log onto your Windows machine.  You can change this setting: see Changing Drive Mappings.

A disconnected mapping can be manually connected.

To connect network drive mappings:

1.	Access the Drive Letters tab by using one of the following methods:

From the AFS Light Configuration utility:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the Drive Letters tab.

From the AFS Light property box:

1.	Click the AFS Light icon in the taskbar.  See Displaying the AFS Light Icon for more information.

2.	Select the Drive Letters tab.

2.	Select the check box next to the drive letter that you want to connect to the AFS filespace.

The mapping is now connected, and the drive letter appears in your Windows Explorer.

A connected mapping can be manually disconnected:

To disconnect network drive mappings:

1.	Access the Drive Letters tab by using one of the following methods:

From the AFS Light Configuration utility:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the Drive Letters tab.

From the AFS Light property box:

1.	Click the AFS Light icon in the taskbar.  See Displaying the AFS Light Icon for more information.

2.	Select the Drive Letters tab.

2.	Clear the check box next to the drive letter that you want to disconnect.

The mapping is now disconnected, and the drive letter no longer appears in your Windows Explorer.

Related Topics:

Mapping Drives to AFS


Copy ACL Dialog Box

You can copy an access control list from a source directory to a destination directory.  If you specify a filename as the source directory, the ACL of the file's parent directory is used.

  Copy From

  Copy To

  Browse

  Clear Current Entries

Related Topics:

Copying Access Control Lists


Copy ACL Dialog Box - Browse Button
Browse

Allows you to browse for a destination directory.

Note:	When browsing for the destination directory, you must select a file that resides in the desired destination directory.   If you desire an empty directory for the destination directory, you must type the path in the Copy To box instead of using the Browse button.


Copy ACL Dialog Box - Clear Current Entries Check Box
Clear Current Entries

Enables you to remove all existing ACL entries from the destination directory's ACL before adding the source directory's entries.  If this box is not checked, the current ACL entries in the destination directory are not affected.


Copy ACL Dialog Box - Copy From Field
Copy From

Specifies the path and directory name of the source directory.

This information is supplied based on the AFS file or directory from which you accessed the AFS Menu.


Copy ACL Dialog Box - Copy To Field
Copy To

Specifies the path and directory name of the destination directory.


Copying ACLs

You can copy an access control list from a source directory to a destination directory.  If you specify a filename as the source directory, the ACL of the file's parent directory is copied to the destination directory.

To copy an ACL entry to a destination directory:

Note:	To copy an ACL entry, you must have Lookup permission on the source directory and Administer permission on the destination directory.  See AFS Access Permissions.

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the directory (or a file within that directory) whose ACL you want to copy.

3.	Select Access Control Lists from the AFS Menu.  The Set AFS ACL dialog box appears.

4.	Select Copy.

The Copy ACL dialog box appears, with the Copy From box containing the path of the source directory.

5.	 In the Copy To box, enter the pathname for the destination directory.

6.	Select the Clear Current Entries check box if you want to remove all existing ACL entries from the destination directory before adding the access permissions.

7.	Click OK to copy the ACL to the specified directory.

Related Topics:

An Overview of Access Control Lists

Adding ACL Entries

Removing ACL Entries


Definition of ACL Entry
ACL entry

An entry on an Access Control List that pairs one user or group of users with specific permissions, such as read, write, etc.  An entry can be normal, granting the user or group the specific permissions, or negative, denying the user or group the specific permissions.


Definition of AFS Light
AFS Light

Software that enables Windows 95 and Windows 98 users to access the AFS filespace using an AFS Light Gateway.

Note:	AFS Light Gateway is a component of the AFS Client for Windows NT product.


Definition of AFS Light Gateway
AFS Light Gateway

A service running on a Windows NT machine that allows AFS Light users to access AFS.

Note:	AFS Light Gateway is a component of the AFS Client for Windows NT product.


Definition of AFS UID
AFS UID

A unique identification number assigned to AFS users and AFS groups.


Definition of Access Control List
Access control list

A list associated with an AFS directory that specifies the actions a user or group is permitted to perform on a directory and its files.


Definition of Authenticated
Authenticated

The state of a principal whose identity has been verified by AFS.


Definition of Authentication
Authentication

Verification that a user or process is presenting a valid identity.

Authentication involves certifying that a password provided by the user is correct.


Definition of Callback
Callback

A promise from the File Server that it must contact AFS Light if the centrally stored copy of the file is changed while it is being used locally.  Callbacks ensure that you are working with the most current version of files and directories available.


Definition of Cell
Cell

An administratively independent site using AFS and consisting of a set of AFS server machines and AFS client machines.

A client machine can belong to only one cell at a time.


Definition of Cell Database
Cell Database

A file with a list of all registered AFS cells and the names and IP addresses of database servers within each cell.  This cell database is located in the afsdcell.ini file in the default Windows directory.

Note:	Your AFS Light must register a cell before you can contact that cell.


Definition of File Server
File Server

A type of machine used to store files and transfer requested files to client machines.


Definition of Local Cell
Local cell

The cell to which the local client machine belongs.  Even though a user can authenticate in a foreign cell or access files from it, the identity of the local cell remains the same throughout a login session.


Definition of Mount Point
Mount point

A special type of directory that connects a location in the AFS filespace with a volume.  A mount point looks like a standard directory; listing the directory shows the contents of the volume.

Note:	Each mount point corresponds to a single volume.


Definition of Network Drive
network drive

A connection to the hard drive of a remote computer, allowing you to access shared files and directories.  You can establish a network drive connection to a directory in the AFS filespace.


Definition of Partition
Partition

A logical section of a disk in a computer.


Definition of Password
Password

A unique, user-defined string of characters that validates the user's system identity.

The user must enter the password to authenticate to AFS.


Definition of Quota
quota

The size limit of a volume assigned by the system administrator and measured in 1-KB blocks.


Definition of Read-Only
Read-Only

A volume, and thus directories and files, that has been copied from a source volume and that cannot be modified.

Note:	Volumes containing frequently accessed files and directories are often copied and placed on multiple File Servers to improve system efficiency.


Definition of Read/Write
Read/Write

The modifiable version of a volume, and thus the files and directories contained within it.


Definition of Registered Cell
Registered cell

An AFS cell server information (names and IP addresses) is entered in the cell database.


Definition of Token
Token

A set of data that is granted after a user authenticates to AFS.  A token is used by AFS Light when requesting services from AFS servers.

A token has an associated lifetime and expires after a set period of time.  If your token expires, you no longer have authenticated access to AFS.  The standard token lifetime is 25 hours.


Definition of Username
Username

The name that uniquely identifies the user in the local cell.  The username is mapped to the user's AFS User ID (UID).


Definition of Volume
Volume

A set of related files and directories stored on a disk partition that is specific to AFS.


Definition of Volume Location Server
Volume Location Server

An AFS server process that maintains the Volume Location Database.

Your client machine contacts a cell's Volume Location Server to locate files and directories.


Deleting Cells from the Cell Database
Deleting Cells

You can delete a cell that has been registered in your machine's cell database.  Once a cell is removed from the cell database, you can no longer contact that cell.

To delete a cell:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the AFS Cells tab.

4.	Select the cell that you want to delete, and select Remove.

5.	AFS Light displays a message asking you to verify that you want to delete the selected cell.  Upon confirmation of this operation, you can no longer contact the specified cell.  Click OK to delete the cell.

6.	Click OK to close the AFS Light Configuration utility.

Note:	Files and directories housed by the deleted cell are no longer accessible.

Related Information:

Adding New Cells

Changing Cell Information


Directory-Level Access Control

In AFS, access permissions are defined at the directory level.  Directory-level access control has several consequences:

Files inherit the access permissions associated with the parent directory.  If you move a file to a different directory, the file inherits the access permissions of the directory in which you have placed the file.  If you change the ACL on a directory, the protection on all files within the directory also changes.

When you create a subdirectory, it inherits the access permissions of its parent directory.

Note:	After creating a subdirectory, you can set the subdirectory's ACL to be different from its parent.

If you make the ACL on a parent directory more restrictive than the ACL on a subdirectory, you can unintentionally deny users access to the subdirectory even though the users possess normal entries on the subdirectory.

Note:	As a general rule, designate fairly liberal access permissions on a home directory and then create subdirectories with more restrictive permissions to protect certain files more carefully.

Related Topics:

Setting Access Control Lists


Displaying Mount Points

You can view the Mount Points dialog box for a selected directory.  If the directory is a mount point, the Mount Point dialog box displays information about the mount point.

To display mount point information:

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the directory whose mount point you want to display.

3.	Choose AFS, then choose Mount Point, then choose Show.

The Mount Point dialog box appears.  This dialog box displays information about the mount point of the selected directory.  If the selected directory is not a mount point, the message

Directory is not a mount point

is displayed, where directory is the name of the selected directory.

Related Topics:

Mount Points

File Storage Concepts


Displaying Volume and Partition Information

The disks in a computer are divided into partitions.  AFS further divides partitions into volumes.  A volume houses a subtree of related files and directories.  You can view volume and partition properties.

To display volume information:

1.	From the Start menu, open your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the file or directory whose volume information you want to view.

3.	Choose AFS, then choose Volume/Partition, then choose Properties.

The Volume Information dialog box appears.  This dialog box displays information about the volume that houses the selected file or directory.

To display partition information:

1.	Display the Volume Information dialog box, as indicated above.

2.	From the Volume Information dialog box, select the Show Partition Info button.

The Partition Info dialog box appears.  This dialog box displays information about the partition that houses the selected volume.

Related Topics:

Volumes and Partitions


Displaying the AFS Light Icon

The AFS Light icon in your taskbar is used to display the AFS Light property box.  The AFS Light property box provides the AFS user with a convenient method of performing many AFS tasks.

Access to the AFS Light icon is from the AFS Light Configuration utility.

To display the AFS Light icon in the taskbar:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon to display the AFS Light Configuration utility.

3.	Select the General tab.

4.	Select Show the AFS Light icon in the taskbar.

5.	Click OK.

The AFS Light icon appears immediately as a small padlock in your taskbar.

Note:	The AFS Light icon now automatically appears in your taskbar each time you start AFS.


Drive Letters Tab - Add Button
Add

Displays the Map Drive Letter dialog box, which you can use to associate a particular drive letter on your Windows machine with the AFS filespace.  To access the AFS filespace, at least one drive must be mapped to a path in AFS.

See Mapping Drives to AFS for more information.


Drive Letters Tab - Change Button
Change

Displays the Map Drive Letter dialog box, which you can use to modify the drive letter or the AFS path of an existing mapping.

Note:	This option is not available for a drive that is currently in use.

See Changing Network Drive Mappings for more information.


Drive Letters Tab - Remove Button
Remove

Removes the mapping between the specified drive and AFS path.  As a result, the specified drive is immediately disconnected.

Note:	This option is not available for a drive that is currently in use.

See Removing Network Drive Mappings for more information.


Edit Server Dialog Box

Your client machine must be able to reach a cell's Volume Location Server machines in order to access files from the cell.  Incorrect or missing information about a cell makes it impossible for AFS Light to fetch files.

You can modify the server information associated with a cell that is registered in AFS Light's cell database.

Note:	It is important to update cell information whenever a cell's server information changes.

  Server Name

  Server Address

Related Topics:

Changing Server Information


Edit Server Dialog Box - Server Address Field
Server Address

Displays the specific IP address of the server that you are editing or indicates that Windows is supplying the IP address of the specified server automatically.


Edit Server Dialog Box - Server Name Field
Server Name

Displays the name of the server that you are editing.


Flush File/Dir Command
The Flush File/Dir Command

Flushing your files or directories often results in the copy of AFS material that is stored by AFS Light being updated.  This ensures that you are working with the most recent copy of a file.

The Flush File/Dir command is accessed through the AFS Menu.

This AFS Menu command forces AFS Light to discard the data and status information it has stored for specified files or directories.  The next time an application program requests the data, your client machine retrieves the latest version available at the File Server.

Note:	AFS has a mechanism to ensure that you access the most current version of files and directories available.  When the File Server sends a client machine a copy of a modifiable file, it also sends a callback.  If the centrally stored copy of a file is changed while you are using it, the File Server breaks the callback.  The next time you ask for more data from the file, AFS Light notices the broken callback and accesses an updated copy of the file from the File Server.

The Flush File/Dir command can be used in the rare case when you suspect that the callback mechanism is not working properly.

Related Topics:

Flushing Files and Directories

Flushing Volumes

AFS File Storage Concepts


Flush Volume Command
The Flush Volume Command

Flushing a specified volume ensures that you are working with the most recent copies of files by updating  the copies of AFS material stored by AFS Light.

The Flush Volume command is accessed through the AFS Menu.

This AFS Menu command forces AFS Light to discard the data it has stored for all elements in the cache that originate from the same volume as the specified files or directories.  The next time an application program requests the data, your client machine retrieves the latest version available at the File Server.

Note:	AFS has a mechanism to ensure that you access the most current version of files and directories available.  When the File Server sends a client machine a copy of a modifiable file, it also sends a callback.  If the centrally stored copy of a file is changed while you are using it, the File Server breaks the callback.  The next time you ask for more data from the file, AFS Light notices the broken callback and accesses an updated copy of the file from the File Server.

The Flush Volume command can be used in the rare case when you suspect that the callback mechanism is not working properly.

Related Topics:

AFS File Storage Concepts

Flushing Volumes

Flushing Files and Directories


Flushing Files and Directories
Flushing Files or Directories

Flushing your files or directories often results in the copy of AFS material that is stored by AFS Light being updated.  This ensures that you are working with the most recent copy of a file.

AFS ensures that client machines receive notification that their version of a file is no longer valid when the central version of the file changes on the File Server.  When the File Server sends a copy of a modifiable file, it also sends a callback.  If the centrally stored copy of a file is changed while you are using it, the File Server breaks the callback.  The next time you request data from the file, your client machine notices the broken callback and accesses an updated copy of the file from the File Server.  Callbacks automatically guarantee that your client machine has the most current version of files and directories available.

The Flush File/Dir command can be used in the rare case when you suspect that the callback mechanism is not working properly.  Use this option to force AFS Light to discard (flush) cached data.  The next time an application program requests the data, AFS Light retrieves the latest version available at the File Server.

To flush files or directories:

1.	From the Start menu, open your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click an AFS file or directory that you want to update.

3.	Choose AFS, then choose Flush File/Dir.

AFS Light discards stored data for the selected file or directory.

Related Topics:

AFS File Storage Concepts

Flushing Volumes


Flushing Volumes

Flushing a specified volume often results in copies of AFS material that AFS Light holds being updated.  This ensures that you are working with the most recent copies of files.

AFS ensures that client machines receive notification that their version of a file is no longer valid when the central version of the file changes on the File Server.  When the File Server sends a client machine a copy of a modifiable file, it also sends a callback.  If the centrally stored copy of a file is changed while you are using it, the File Server breaks the callback.  The next time you request data from the file, your client machine notices the broken callback and accesses an updated copy of the file from the File Server.  Callbacks automatically guarantee that AFS Light accesses the most current version of files and directories available.

The Flush Volume command can be used in the rare case when you suspect that the callback mechanism is not working properly.  Use this option to force AFS Light to discard (flush) cached data.  The next time an application program requests the data, your client machine retrieves the latest version available at the File Server.

To flush volumes:

1.	From the Start menu, open your Windows Explorer by selecting Programs, then choosing Windows Explorer.

2.	Right-click an AFS file or directory that resides on a volume that you want to flush.

3.	Choose AFS, then choose Flush Volume.

Related Topics:

AFS File Storage Concepts

Flushing Files and Directories


General Tab - Cell Name Field
Cell Name

Displays the name of the AFS cell in which your AFS Light machine is configured.

Note:	AFS Light belongs to the same cell as the AFS Client serving as its gateway.


General Tab - Gateway field
Gateway

Identifies a Windows NT machine that is configured as an AFS Light Gateway.

See Identifying an AFS Light Gateway for more information.


General Tab - Obtain AFS Tokens Check Box
Obtain AFS tokens when logging into Windows

Selecting this check box enables you to log into Windows and authenticate to AFS in a single step.  When signing onto Windows, enter the appropriate ID and password.  You are then logged into Windows and have an AFS token for the client machine's local cell.  No further authentication is necessary.

Note:	To take advantage of the integrated logon feature, your logon ID and password must be the same for AFS as for Windows.

Clearing this check box enables you to log onto Windows and authenticate to AFS separately.  Each time you log onto Windows, you must also authenticate to AFS.

See Integrated Logon for more information.


General Tab - Show the AFS Light Icon Check Box
Show the AFS Light icon in the taskbar

Selecting this check box displays the AFS Light icon in the taskbar (in the lower right side of your monitor).  The AFS Light icon serves as a shortcut to many AFS features.

See Displaying the AFS Light Icon for more information.


Getting Help
Online Help

The online help documentation provided with AFS Light describes features available from the AFS Light for Windows 95 and Windows 98 product.

To get help:

1.	From the Start menu, find the IBM AFS (or IBM WebSphere) program group and the Light program subgroup.

2.	Select Online Help.

The Help Topics dialog box appears.

Get help on topics by browsing the Contents page, using the Index to locate topics, or using Find, the online help search engine.

Note:	You can also get help on many topics by selecting the Help button that is located on most dialog boxes.


Getting Started

Before you can access the AFS filespace, you must configure AFS on your Windows 95 or 98 machine.

To configure AFS:

1.	Designate a Windows NT machine to serve as your gateway to the AFS filespace.  See Identifying an AFS Light Gateway.

2.	Connect a drive to the AFS filespace. See Mounting the AFS Filespace.

You can now access AFS; however, unauthenticated access to the AFS filespace is severely limited.  To work effectively in the filespace, you must authenticate to AFS.

3.	Establish your identity in AFS. See Authenticating to AFS.

Related Topics:

AFS Light Configuration Utility

About AFS Light


Glossary

A

access control list (ACL)

A list associated with an AFS directory that specifies the actions a user or group is permitted to perform on the directory and its files.

access permissions

There are seven access rights: Read, Lookup, Insert, Delete, Write, Lock, and Administer, each with a corresponding letter abbreviation, r, l, i, d, w, k, a.

ACL

See access control list.

ACL entry

An entry on an ACL that pairs one user or group of users with specific AFS access permissions.  An entry can be normal, granting the user or group the specific permissions, or negative, denying the user or group the specific permissions.

AFS

An enterprise file system that provides consistent file access via a single, shared filespace.  Files are stored (distributed) on different machines in the computer network but are accessible from all machines.

AFS Light

Software that enables Windows 95 and Windows 98 users to access the AFS filespace using an AFS Light Gateway.

AFS Light Gateway

A service running on a Windows NT machine that allows AFS Light users to access AFS.  AFS Light Gateway is a component of the AFS Client for Windows NT product.

AFS UID

A unique identification number assigned to AFS users and AFS groups.

authenticated

The state of a principal whose identity has been verified by AFS.

authentication

Verification that a user or process is presenting a valid identity.  Authentication involves certifying that the password provided by the user is correct.

C

callback

A promise from the File Server that it must contact AFS Light if the centrally stored copy of the file is changed while it is being used locally.  Callbacks ensure that you are working with the most current version of files and directories available.

cell

An administratively independent site using AFS and consisting of a set of AFS server machines and AFS client machines.  A client machine can belong to only one cell at a time.

cell database

A file with a list of all registered AFS cells and the names and IP addresses of database servers within each cell.  The cell database is located in the afsdcell.ini file in the default Windows directory.

command prompt

A command-line interface used to enter AFS text commands.

D

directory

A logical structure containing a collection of files and other directories.

F

file

A collection of related information stored and retrieved under a single name.

File Server

A type of machine used to store files and transfer requested files to client machines.

foreign cell

An AFS cell other than the one to which the local (client) machine belongs.

G

group entry

An ACL entry that applies to all members of a group.  A group can consist of both users and machines.  A user that is a member of a group has all of the permissions of the group.  A user who is logged into a machine that is a member of a group has all of the permissions of the group.

I

Integrated Logon

An AFS feature that enables you to log onto Windows and AFS in a single step.

L

local cell

The cell to which the local client machine belongs.  Even though a user can authenticate in a foreign cell or access files from it, the identity of the local cell remains the same throughout a login session.

M

mount point

A special type of directory that connects a location in the AFS filespace with a volume.  A mount point looks like a standard directory; listing the directory shows the contents of the volume.

N

negative entry

An ACL entry that explicitly denies a user or group permission to perform specified actions.

network drive

A connection to the hard drive of a remote computer, allowing you to access shared files and directories.  You can establish a network drive connection to a directory in the AFS filespace.

network drive mapping

A network drive that is mapped to a specific place in the AFS filespace, permitting easy access to files stored in AFS.

normal entry

An ACL entry that grants a user or a group permission to perform specified actions.

P

partition

A logical section of a disk in a computer.

password

A unique, user-defined string of characters that validates the user's system identity.

Q

quota

The size limit of a volume assigned by the system administrator and measured in one-KB blocks.

R

read-only Volume

A copy of a source volume, which cannot be modified.

read/write mount point

A mount point to a read/write volume.

read/write volume

A volume that houses modifiable versions of files and directories.

registered cell

An AFS cell whose Volume Location Server information is entered in the cell database.

regular mount point

A mount point to a volume of the same type as the volume in which the mount point is located.  For example, if you create a mount point from a read-only volume, AFS Light looks for data from read-only volumes when that mount point is accessed.

S

subdirectory

A directory that resides in another directory in the file system hierarchy.

system administrator

A user who is authorized to operate and administer AFS in a cell.

system:anyuser

A system-defined group that includes everyone who can gain access to the cell, including unauthenticated AFS users.

T

token

A set of data that is granted after a user authenticates to AFS.  A token is used by AFS Light when requesting services from AFS servers.  A token has an associated lifetime and expires after a set period of time.  If your token expires, you no longer have authenticated access to AFS.  The standard token lifetime is 25 hours.

U

unauthenticated

The state of a principal whose identity is not known to AFS.

user entry

An ACL entry that applies to the corresponding user only.

username

A name that uniquely identifies the user in the local cell.  The username is mapped to the user's AFS user ID.

V

volume

A set of related files and directories stored on a disk partition that is specific to AFS.

Volume Location Server

An AFS server process that maintains the Volume Location Database, which records location and other status information about all volumes in the cell.


Help
About Help

Audience and Purpose

This online documentation is written for users of AFS Light for Windows 95 and Windows 98.  It assumes that you are familiar with basic terms and concepts of the Microsoft® Windows operating system and Windows applications.

Online help describes features available in the AFS Light for Windows 95 and Windows 98 product.

Related Documentation

The AFS Light Release Notes provide important information not included in the online Help.

Note:	For additional information about Windows 95 or Windows 98,  see your Windows documentation.


Help Contents
Contents

Overview

About AFS?

AFS Storage Concepts

AFS Security Concepts

About AFS Light

About Help

Getting Started

Overview

Identifying an AFS Light Gateway

Mounting the AFS Filespace

Authenticating to AFS

Verifying Authentication

Unauthenticating from AFS

Managing AFS

Overview

The AFS Menu

The AFS Light Configuration Utility

The AFS Light Program Group

The AFS Light Property Box

Command Prompt Commands

Using AFS

Access Control Lists

Overview

Access Control Lists

Directory Level Access Control

Access Permissions

Additional Access Permissions

Normal and Negative Entries

Using Access Control Lists

Setting Access Control Lists

Adding Access Control List Entries

Removing Access Control List Entries

Copying an Access Control List

Volumes and Partitions

Overview

Displaying Volume and Partition Information

Refreshing Name/Volume ID Mapping

Mount Points

Overview

Displaying Mount Point Information

Removing Mount Points

Making Mount Points

Cached Files

Overview

Flushing Files and Directories

Flushing Volumes

Server Information

Overview

Showing File Servers

Showing the Status of File Servers

Cells

Listing Cell Information

Showing Cells

Cell Database

Overview

Adding Cells

Changing Cell Information

Removing Cells

Reference

Glossary of Terms

How To...


How To...

  Access the AFS Light Configuration utility

  Access the AFS Light program group

  Access the AFS Light property box

  Access the AFS Menu

  Add ACL entries

  Add new cells to the cell database

  Add servers to a cell

  Authenticate to AFS

  Connect network drives

  Copy access control lists

  Discard tokens

  Disconnect network drives

  Display the AFS Light icon in the taskbar

  Display mount points

  Display partition information

  Display volume information

  Flush files and directories

  Flush volumes

  Get started in AFS

  Identify an AFS Light Gateway

  Integrate your AFS logon with your Windows logon

  Make mount points

  Map network drives to AFS

  Obtain Tokens

  Remove mount points

  Set access control lists

  Show cells

  Show File Servers

  Show the status of File Servers

  Unauthenticate

  Verify authentication


How to access the AFS Light Configuration utility
To access the AFS Light Configuration utility:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

The AFS Light Configuration utility appears.


How to access the AFS Light program group
To access the AFS Light program group:

1.	From the Start menu, find the IBM AFS (or IBM WebSphere) program group and choose the Light entry.

The AFS Light Program Group is displayed.


How to access the AFS Light property box
To access the AFS Light property box:

1.	Display the AFS Light icon in the taskbar, which is located on the bottom right side of your monitor.

a.	From the Start menu, choose Settings, then choose Control Panel.

b.	Double-click the AFS Light Configuration icon to display the AFS Light Configuration utility.

c.	Select the General tab.

d.	Select Show the AFS Light icon in the taskbar.

e.	Click OK.

The AFS Light icon appears immediately as a small padlock in your taskbar.

2.	Click the AFS Light icon in the taskbar.

The AFS Light property box appears.


How to access the AFS menu
To access the AFS Menu:

1.	From the Start menu, open your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click any file or directory in the AFS filespace.

3.	Point to AFS.

The AFS Menu is displayed.


How to activate Integrated Logon
To activate Integrated logon

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon to display the AFS Light Configuration utility.

3.	Select the General tab.

4.	Select Obtain AFS tokens when logging into Windows.

5.	Click OK.

Note:	You must restart your machine for this change to take effect.


How to add a cell to your cell database
To add a cell to your cell database:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the AFS Cells tab.

4.	Select Add.

The New Cell dialog box appears.

5.	In the AFS Cell box, enter the name of the new AFS Cell.

6.	In the Description box, enter a description to identify the new cell.

7.	For each new cell, you must specify one or more Volume Location Servers.  Select the Add button to add server information.

The Add Server dialog box appears.

8.	In the Server Name box, enter the name of a Volume Location Server in the new cell.

9.	Select Use specific address and enter the IP address of the server or select Look up address automatically to have Windows look for the address.

10.	Click OK

The server's name and address now appear in the Servers field on the New Cell dialog box.

Repeat steps 7-10 for cells with multiple Volume Location Servers.

11.	Click OK to add the cell to the list of registered AFS cells on the AFS Cells tab.


How to add a server to a cell
To add server information to a cell:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the AFS Cells tab.

4.	Double-click the cell to which you want to add server information.

The Cell Properties dialog box appears.

5.	Select Add.

The Add Server dialog box appears.

6.	In the Server Name box, enter the name of a Volume Location Server that you want to add to the specified cell.

7.	Select Use specific address and enter an IP address or select Look up address automatically to have Windows look for the address.

8.	Click OK.

The server's name and address now appear in the Servers field on the Cell Properties dialog box.

9.	Click OK to close the Cell Properties dialog box.


How to add an ACL entry
To add an ACL entry

Note:	To add an entry to a directory's ACL, you must have Administer permission on the directory.  See AFS Access Permissions.

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the AFS directory to which you want to add an ACL entry.

3.	Point to AFS.  The AFS Menu is displayed.

4.	Select Access Control Lists.

The Set AFS ACL dialog box appears.

5.	Select Add.

The Add ACL Entry dialog box appears.

6.	In the Name box, enter the name of the user or group that you want to add to the ACL.

7.	In the Entry Type box, select the entry type.  A normal entry grants the user or group the specified permissions; a negative entry denies the user or group the specified permissions.  See Normal and Negative Entries for more information.

Note:	You must add normal and negative permissions separately.

8.	In the Permissions box, select all AFS access permissions that you want to apply (normal rights) or deny (negative rights) to the directory.  See AFS Access Permissions for more information.

9.	Click OK to close the Add ACL Entry dialog box.

The ACL entry that you added now appears in the Normal or Negative permissions list on the Set AFS ACL dialog box.


How to authenticate to AFS
To authenticate to AFS (obtain tokens):

1.	Display the Tokens tab on the AFS Light property box using one of the following methods:

From the Start menu, find the IBM AFS (or IBM WebSphere) program group and the Light program subgroup.  Choose Authentication.

Click the AFS Light icon in the taskbar and select the Tokens tab.  See Displaying the AFS Light Icon for more information.

2.	From the Tokens tab, select Obtain New Tokens.

The Obtain New AFS Tokens dialog box appears.

3.	In the AFS Cell box, type the name of the cell to which you want to authenticate or accept the default cell, which is your local cell.

4.	Type your AFS username in the User Name box.

5.	Type your password in the Password box.  The password is not echoed on the screen.

6.	Click OK to authenticate.  The Tokens tab displays the new token information.  For more details on the information displayed in the Tokens tab, see Tokens tab.

Note: 	If you want to authenticate to more than one cell, repeat Steps 2 through 6 for each cell.


How to connect network drive mappings
To connect network drive mappings:

1.	Access the Drive Letters tab by using one of the following methods:

From the AFS Light Configuration utility:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the Drive Letters tab.

From the AFS Light property box:

1.	Click the AFS Light icon in the taskbar.  See Displaying the AFS Light Icon for more information.

2.	Select the Drive Letters tab.

2.	In the Drive Letters field, select the check box next to the drive letter that you want to connect to the AFS filespace.

3.	Click OK.

The mapping is now connected, and the drive letter appears in your Windows Explorer.


How to copy an ACL
To copy an ACL entry to a destination directory:

Note:	To copy an ACL entry, you must have Lookup permission on the source directory and Administer permission on the destination directory.  See AFS Access Permissions.

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the directory (or a file within that directory) whose ACL you want to copy.

3.	Select Access Control Lists from the AFS Menu.  The Set AFS ACL dialog box appears.

4.	Select Copy.

The Copy ACL dialog box appears, with the Copy From box containing the path of the source directory.

5.	 In the Copy To box, enter the pathname for the destination directory.

6.	Select the Clear Current Entries check box if you want to remove all existing ACL entries from the destination directory before adding the access permissions.

7.	Click OK to copy the ACL to the specified directory.


How to designate an AFS Light Gateway
To designate an AFS Light Gateway:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

The AFS Light Configuration utility appears.

3.	Select the General tab.

4.	In the Gateway box, enter the name of a Windows NT machine that is configured as an AFS Light Gateway.

Note:	AFS Light belongs to the same cell as its AFS Light Gateway.  The name of your local cell is displayed in the Cell Name box.

5.	Click OK to close the AFS Light Configuration utility.


How to disconnect a network drive mapping
To disconnect network drive mappings:

1.	Access the Drive Letters tab by using one of the following methods:

From the AFS Light Configuration utility:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the Drive Letters tab.

From the AFS Light property box:

1.	Click the AFS Light icon in the taskbar.  See Displaying the AFS Light Icon for more information.

2.	Select the Drive Letters tab.

2.	In the Drive Letters box, clear the check box next to the drive letter that you want to disconnect.

3.	Click OK.

The mapping is now disconnected, and the drive letter no longer appears in your Windows Explorer.


How to display mount point information
To display mount point information:

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the directory whose mount point you want to display.

3.	Choose AFS, then choose Mount Point, then choose Show.

The Mount Point dialog box appears.  This dialog box displays information about the mount point of the selected directory.  If the selected directory is not a mount point, the message

Directory is not a mount point

is displayed, where directory is the name of the selected directory.


How to display partition information
To display partition information:

1.	From the Start menu, open your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the file or directory whose partition information you want to view.

3.	Choose AFS, then choose Volume/Partition, then choose Properties.

The Volume Information dialog box appears.  This dialog box displays information about the volume that houses the selected file or directory.

4.	From the Volume Information dialog box, select the Show Partition Info button.

The Partition Info dialog box appears.  This dialog box displays information about the partition that houses the selected volume.


How to display the AFS Light taskbar icon
To display the AFS Light icon in the taskbar:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon to display the AFS Light Configuration utility.

3.	Select the General tab.

4.	Select Show the AFS Light icon in the taskbar.

5.	Click OK.

The AFS Light icon appears immediately as a small padlock in your taskbar.

Note:	The AFS Light icon now automatically appears in your taskbar each time you start AFS.


How to display volume information
To display volume information:

1.	From the Start menu, open your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the file or directory whose volume information you want to view.

3.	Choose AFS, then choose Volume/Partition, then choose Properties.

The Volume Information dialog box appears.  This dialog box displays information about the volume that houses the selected file or directory.


How to flush files or directories
To flush files or directories:

1.	From the Start menu, open your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click an AFS file or directory that you want to update.

3.	Choose AFS, then choose Flush File/Dir.

AFS Light discards stored data and accesses the File Server for the latest version of a file the next time your application program requests information from the file.


How to flush volumes
To flush volumes:

1.	From the Start menu, open your Windows Explorer by selecting Programs, then choosing Windows Explorer.

2.	Right-click an AFS file or directory that resides on a volume that you want to flush.

3.	Choose AFS, then choose Flush Volume.

AFS Light discards stored data and will access the File Server for the latest version the next time your application program asks for more data from any file residing in the specified volume.


How to get started in AFS
To get started in AFS:

1.	Designate a Windows NT machine to serve as your gateway to the AFS filespace.  See Identifying an AFS Light Gateway.

2.	Connect a drive to the AFS filespace. See Mounting AFS.

You can now access AFS; however, your access to the AFS filespace is severely limited. To work effectively in the AFS filespace, you must authenticate to AFS.

3.	Establish your identity in AFS. See Authenticating to AFS.


How to make mount points
To create mount points:

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click an AFS directory.

3.	Choose AFS, then choose Mount Point, then choose Make.

The Make Mount Point dialog box appears.  The default directory, which is the current working directory, is displayed in the Directory box.

4.	Add the name of the directory to be created as a mount point to the pathname in the Directory box or replace the default pathname in the Directory box.

Note:	The specified directory must not already exist.

5.	In the Volume box, type the name of the volume to be mounted.  (Alternatively, you can specify a volume ID number.)

6.	In the Cell box, type the name of the cell in which the volume resides.

7.	In the Options box, select Regular or Read/Write as the mount type.

8.	Click OK to create the mount point.

The newly created directory now serves as a mount point to the volume you specified.


How to map drives to AFS
To map drives to AFS:

1.	Access the Map Drive Letter dialog box using one of the following methods:

From the AFS Light Configuration utility:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the Drive Letters tab.

4.	Select the Add button.  The Map Drive Letter dialog box appears.

From the AFS Light property box:

1.	Click the AFS Light icon in the taskbar.  See Displaying the AFS Light Icon for more information.

2.	Select the Drive Letters tab.

3.	Select the Add button.  The Map Drive Letter dialog box appears.

2.	In the Drive Letter box, select a network drive that is not being used or accept the default.

3.	In the AFS Path box, type a path to the AFS filespace.

4.	In the Description box, enter a short name to be associated with the specified drive letter and AFS path.

Note:	A drive letter description can have no more than 12 characters and cannot contain spaces or tabs.

5.	Select Restore this mapping whenever I log on if you want to connect to the specified AFS filespace each time you log on.

6.	Click OK to establish the connection.


How to remove a mount point
To remove a mount point:

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the directory whose mount point you want to remove.

3.	Choose AFS, then choose Mount Point, then choose Remove.

The AFS Light displays the following message:

Are you sure you want to remove the selected mount point(s)?

4.	Click Yes.  The Remove Mount Points dialog box appears and displays the result.


How to set an ACL
To set an ACL:

Note:	To set a directory's ACL, you must have Administer permission on the directory.  See AFS Access Permissions.

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the AFS directory whose ACL you want to set.

3.	Point to AFS.  The AFS Menu is displayed.

4.	Select Access Control Lists.

The Set AFS ACL dialog box appears.

You can now add entries, copy ACLs to other directories, delete entries, and clean your ACLs.


How to show File Servers
To show File Servers:

1.	From the Start menu, open your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the file or directory whose server location you want to view.

3.	Choose AFS, then choose Show File Servers.

The Show File Servers dialog box appears.  This dialog box displays the name of the server which houses the specified file or directory.


How to show cells
To show cells:

1.	From the Start menu, open your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the files or directories whose cells you want to view.

3.	Choose AFS, then choose Show Cell.

The Show Cell dialog box appears and lists the AFS cells in which the selected files and directories are located.


How to show the status of File Servers
To show the status of File Servers:

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right click an AFS file or directory.

3.	Choose AFS, then choose Show Server Status.

The Server Status dialog box appears.

4.	Select the set of File Servers for which you want to view a status report.  Your local cell is the default.

5.	Select Do Not Probe Servers if you want to view File Server information without having your client machine update the list.  Clear Do Not Probe Servers for an updated list.

6.	Click Show Status.

If any File Servers in the specified cell or cells are unavailable, the Down Servers dialog box appears with a list of the unavailable File Servers.  Otherwise a dialog box appears stating that all servers are running.


How to unauthenticate
To unauthenticate from AFS (discard tokens):

1.	Display the Tokens tab on the AFS Light property box by using one of the following methods:

From the Start menu, find the IBM AFS (or IBM WebSphere) program group and the Light program subgroup.  Choose Authentication.

Click the AFS Light icon in the taskbar and select the Tokens tab.  See Displaying the AFS Light Icon for more information.

2.	If you have tokens in more than one cell, select the tab with the name of the cell from which you want to unauthenticate.

3.	Select the Discard These Tokens button.

Note:	You can unauthenticate from only one cell at a time.  If you have tokens from more than one cell, repeat Steps 2 and 3 for each cell.


How to verify authentication
To verify authentication:

1.	Display the Tokens tab on the AFS Light property box by using one of the following methods:

From the Start menu, find the IBM AFS (or IBM WebSphere) program group and the Light program subgroup.  Choose Authentication.

Click the AFS Light icon in the taskbar and select the Tokens tab.  See Displaying the AFS Light Icon for more information.

The Tokens tab on the AFS Light property box displays token information.

If you have tokens for more than one cell, the cell name appears in place of the word tokens on the tab.  For example, if you have tokens for the abc.com cell and the xyz.com cell, the first two tabs in the AFS Light property box are the abc.com tab and the xyz.com tab.  These tabs replace the Tokens tab.  These tabs display the same information as the Tokens tab.

If you do not currently have any tokens in any AFS cells, your Tokens tab does not contain token information.  See Tokens Tab (No tokens).


Identifying an AFS Light Gateway

You must designate a Windows NT machine that is configured as an AFS Client to serve as a gateway to the AFS filespace before you can use AFS Light to access AFS files and directories.

Identify the gateway machine by its NetBIOS service name, in the form mach-afs, where mach is the host computer name up to a maximum of 11 characters.  AFS Light must be able to resolve this service name in order to communicate with the gateway machine.  Name resolution can be achieved by adding the gateway's NetBIOS service name to the client's LMHOSTS file or to the appropriate DNS or WINS servers.  If the AFS Light machine and its AFS Light Gateway machine reside on the same subnet, then name resolution succeeds automatically via a NetBIOS broadcast.

To designate an AFS Light Gateway:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

The AFS Light Configuration utility appears.

3.	Select the General tab.

4.	In the Gateway box, enter the name of a Windows NT machine that is configured as an AFS Light Gateway.

Note:	AFS Light belongs to the same cell as its AFS Light Gateway.  The name of your local cell is displayed in the Cell Name box.  The specified cell must be registered in your cell database.  If necessary, use the AFS Cells tab to enter information about the cell into your cell database.  See your System Administrator for information specific to the cell.

5.	Click OK to close the AFS Light Configuration utility.

Related Topics:

Getting Started in AFS


Integrated Logon

Integrated logon enables you to log onto Windows and AFS in a single step.  In order to take advantage of this feature, your logon ID and password must be the same for AFS as for Windows.  When logging onto Windows, enter the appropriate ID and password.  You are then logged onto Windows and have an AFS token for your client machine's local cell.  No further authentication is necessary.

Note that the AFS integrated logon does not replace the requirement that you must be defined to the local Windows machine.  AFS authentication is called by the Microsoft logon routines.  If you are not defined to the local Windows machine, the logon is rejected, and no AFS authentication takes place.

If your AFS and Windows passwords differ, you can log on successfully to Windows, and a message box from AFS appears indicating unsuccessful AFS authentication.  You can then use the Tokens tab on the AFS Light property box to acquire an AFS token.

To activate integrated logon

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon to display the AFS Light Configuration utility.

3.	Select the General tab.

4.	Select Obtain AFS tokens when logging into Windows.

5.	Click OK.

Note:	You must restart your machine for this change to take effect.

Related Topics:

Authenticating to AFS


Issuing Commands at the Command Prompt

To issue Command Prompt Commands on your Windows 95 or Windows 98 machine, you must use the command prompt window.  The DOS-prompt is the command line interface in Windows systems.

To issue command prompt commands:

1.	From the Start menu, choose Programs, then choose Command Prompt.

2. 	Enter the appropriate commands in the Command Prompt window.

Related Topics:

Command Prompt Commands


Listing File Server Information

You can view the following File Server information:

The current File Server machine that stores a selected file or directory.

Display this information by using the Show File Servers option on the AFS Menu.

See Showing File Servers for more information.

The status of File Server machines in your local cell, a specified cell, or all cells.

Display this information by using the Show Server Status option on the AFS Menu.

See Showing the Status of File Servers for more information.

Related Topics:

AFS File Storage Concepts


Make Mount Point Dialog Box

The Make Mount Point dialog box contains the following information:

  Directory

  Volume

  Cell

  Options

Related Topics:

Making Mount Points

Mount Points

File Storage Concepts


Make Mount Point Dialog Box - Cell Field
Cell

Specifies the name of the cell in which the volume resides.


Make Mount Point Dialog Box - Directory Field
Directory

Specifies the name of the directory to be created as a mount point to the volume named in the Volume box.

Note:	You cannot create a mount directory from an existing directory.


Make Mount Point Dialog Box - Options Field
Options (Regular or Read/Write)

Specifies the type of mount point to be created.

Regular mount points instruct your client machine to access data from volumes of the same type as the volume in which the mount point is located.  For example, if you create a mount point from a read-only volume, AFS Light looks for data from read-only volumes when that mount point is accessed.

A read/write mount point always looks for data from a read/write volume.


Make Mount Point Dialog Box - Volume Field
Volume

Specifies the name or ID of the volume to be mounted.


Making Mount Points
Creating Mount Points

AFS Light enables you to create mount points.

Note:	To create a mount point, you must have Insert and Administer access permissions for the directory that is to contain the mount point.  See Access Permissions for more information.

To create mount points:

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click an AFS directory.

3.	Choose AFS, then choose Mount Point, then choose Make.

The Make Mount Point dialog box appears.  The default directory, which is the current working directory, is displayed in the Directory box.

4.	Add the name of the directory to be created as a mount point to the pathname in the Directory box or replace the default pathname in the Directory box.

Note:	The specified directory must not already exist.

5.	In the Volume box, type the name of the volume to be mounted.  (Alternatively, you can specify a volume ID number.)

6.	In the Cell box, type the name of the cell in which the volume resides.

7.	In the Options box, select Regular or Read/Write as the mount type.

8.	Click OK to create the mount point.

The newly created directory now serves as a mount point to the volume you specified.

Related Topics:

Mount Points

File Storage Concepts


Managing AFS

After configuring AFS Light (see Getting Started in AFS), you can manage AFS through the AFS Menu, the AFS Light Configuration utility, the AFS Light program group, and the AFS Light property box directly from your desktop.  The method you use to access AFS depends on what you want to accomplish.

Note:	If you do not authenticate to AFS, your access to the AFS filespace is severely limited. To work effectively, you must establish your identity in AFS. See Authenticating to AFS for more information.

To access the AFS Menu:

1.	From the Start menu, open your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click any file or directory in the AFS filespace.

3.	Point to AFS.

The AFS Menu is displayed.

To access the AFS Light Configuration utility:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

The AFS Light Configuration utility appears.

To access the AFS Light program group:

1.	From the Start menu, find the IBM AFS (or IBM WebSphere) program group and choose the Light entry.

The AFS Light Program Group is displayed.

To access the AFS Light property box:

1.	Display the AFS Light icon in the taskbar, which is located on the bottom right side of your monitor.

a.	From the Start menu, choose Settings, then choose Control Panel.

b.	Double-click the AFS Light Configuration icon to display the AFS Light Configuration utility.

c.	Select the General tab.

d.	Select Show the AFS Light icon in the taskbar.

e.	Click OK.

The AFS Light icon appears immediately as a small padlock in your taskbar.

2.	Click the AFS Light icon in the taskbar.

The AFS Light property box appears.

Related Topics:

Getting Started in AFS

Command Prompt Commands


Map Drive Letter Dialog Box

This dialog box enables you to make an association between a drive letter on your Windows machine and a particular place in the AFS filespace.  To access files stored in AFS, you must map at least one drive letter to a path in the AFS filespace.

This dialog box is accessed from either the AFS Light Configuration utility or the AFS Light property box.

  Drive Letter

  AFS Path

  Description

  Restore this mapping whenever I log on

Related Topics:

Mounting the AFS Filespace

Mapping Drives to AFS


Map Drive Letter Dialog Box - AFS Path Field
AFS Path

Specifies the path to the desired place in the AFS filespace.


Map Drive Letter Dialog Box - Description Field
Description

Enables you to associate a short name with the specified drive letter and the AFS path.

This short name is useful if you are connecting more than one network drive to a place in the AFS filespace.

 Note:	A drive letter description can have no more than 12 characters and cannot contain spaces or tabs.


Map Drive Letter Dialog Box - Drive Letter Field
Drive Letter

Enables you to select a drive letter.  This is the drive on your Windows machine that will be mapped to the AFS filespace.


Map Drive Letter Dialog Box - Restore this Mapping Check Box
Restore this mapping whenever I log on

Select this check box if you want to connect to the specified location in the AFS filespace each time you log on.


Map Drive Letter Dialog Box

This dialog box enables you to make an association between a particular drive letter on your Windows machine and the AFS filespace.  To access files stored in AFS, you must map at least one drive letter to a path in the AFS filespace.

This dialog box is accessed from either the AFS Light Configuration utility or the AFS Light property box.

  Drive Letter

  AFS Path

  Description

  Restore this mapping whenever I log on

Related Topics:

Mapping Drives to AFS


Mapping Drives to AFS

To access files stored in AFS, you must map at least one drive letter to a path in the AFS filespace.

To map drives to AFS:

1.	Access the Map Drive Letter dialog box using one of the following methods:

From the AFS Light Configuration utility:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the Drive Letters tab.

4.	Select the Add button.  The Map Drive Letter dialog box appears.

From the AFS Light property box:

1.	Click the AFS Light icon in the taskbar.  See Displaying the AFS Light Icon for more information.

2.	Select the Drive Letters tab.

3.	Select the Add button.  The Map Drive Letter dialog box appears.

2.	In the Drive Letter box, select a network drive that is not being used or accept the default.

3.	In the AFS Path box, type a path to the AFS filespace.

4.	In the Description box, enter a short name to be associated with the specified drive letter and AFS path.

Note:	A drive letter description can have no more than 12 characters and cannot contain spaces or tabs.

5.	Select Restore this mapping whenever I log on if you want to connect to the specified location in the AFS filespace each time you log on.

6.	Click OK to establish the connection.

The drive letter and AFS path appear on the Drive Letters tab.  The drive letter and description now appear in your Windows Explorer.  (Note that a network share, or submount, is created as a result of mapping a drive to the AFS filespace.  Network shares created by AFS Light are not stored on the AFS Light machine; instead, submount information is stored on the AFS Light Gateway machine.)

Related Topics:

Mounting the AFS Filespace

Connecting and Disconnecting Network Drive Mappings

Changing Network Drive Mappings

Deleting Network Drive Mappings


Mount Point Command
The Mount Point Command

The Mount Point command is accessed from the AFS Menu.  It provides three options:

Show

This option displays mount point information.  When you select this option, the Mount Point dialog box is displayed.

See Displaying Mount Points for more information.

Remove

This option enables you to remove mount points.

See Removing Mount Points for more information.

Make

This option enables you to create mount points.  When you select this option, the Make Mount Point dialog box is displayed.

See Making Mount Points for more information.

Related Topics:

AFS File Storage Concepts

Mount Points


Mount Point Dialog Box

The Mount Point dialog box displays the following information:

  File

  Volume

  Cell

  Type

If the selected directory is not a mount point, the message

Directory is not a mount point

is displayed, where directory is the name of the selected directory.

Related Topics:

AFS File Storage Concepts

Mount Points

Displaying Mount Point Information


Mount Point Dialog Box - Cell Field
Cell

The name of the cell  in which the mounted volume resides.


Mount Point Dialog Box - File Field
File

The name of the directory that is a mount point.


Mount Point Dialog Box - Type Field
Type

The type of mount point (Regular or Read/Write).

Regular mount points instruct your client machine to access data from volumes of the same type as the volume in which the mount point is located.  For example, if you create a mount point from a read-only volume, AFS Light looks for data from read-only volumes when that mount point is accessed.

Read/Write mount points always look for data from read/write volumes.


Mount Point Dialog Box - Volume Field
Volume

The name of the volume to which the specified mount point refers.


Mount Point Overview
Mount Point

Access to a volume is through the mount point.  A mount point is a special type of link between a directory location in the file tree and the volume that houses the elements in that directory.  In the file tree, an AFS directory looks like a regular directory.  When you move to a new directory, it is possible to cross a mount point without even knowing it.  When you cross a mount point, you move from one volume to another and possibly from one File Server and partition to another.  This transition is transparent to you because AFS interprets the mount points and retrieves the requested files and directories from the appropriate location, making it unnecessary for you to know their volume, partition, and File Server locations.

AFS Light enables you to display mount point information, remove mount points, and create mount points.

Access to the Mount Point command is from the AFS Menu.  From the Mount Point option on the AFS Menu, there are three options:

Show

This option displays mount point information for a selected directory.

See  Displaying Mount Point Information for more information.

Remove

This option enables you to delete a selected directory that is a mount point.

Note:	Only system administrators can remove mount points.

See Removing Mount Points for more information.

Make

This option enables you to create a mount point.

Note:	Only system administrators can create mount points.

See Creating Mount Points for more information.

Related Topics:

File Storage Concepts


Mounting the AFS Filespace

To access files stored in AFS, you must map at least one drive letter to a path in AFS.

For easy access to files stored in AFS that you use often, you can map a drive directly to a specific place in the AFS filespace without changing directories from the AFS root.

For example, if you frequently use files located in /afs/acme.com/usr/chris, then you can map drive Q directly to that part of the AFS filespace.  The files available in AFS as /afs/acme.com/usr/chris/ will be visible in your computer's Q:\ directory.

Mapping a drive to the AFS filespace results in the following:

An association between a network drive and an AFS path

A network connection to the specified place in the AFS filespace

Related Topics:

Mapping Drives to AFS

Connecting and Disconnecting Network Drives


New Cell Dialog Box

This dialog box appears when you choose the Add button from the AFS Cells tab on the AFS Light Configuration utility.  It enables you to add new cells to AFS Light's cell database and to tell AFS how to contact these cells.  A cell's information must be in the cell database before users on the machine can access files and directories from that cell.

For each new cell, you must specify one or more Volume Location Servers.

Using the New Cell dialog box, you can enter information instructing AFS how to contact a new cell.

  AFS Cell

  Description

  Servers

The New Cell dialog box enables you to add server information to a cell, modify a cell's server information, and remove server information from a cell.

  Add

  Change

  Remove

Related Topics:

Adding Cells to your Cell Database


New Cell Dialog Box - AFS Cell Field
AFS Cell

Specifies the name of the cell being registered in the cell database.


New Cell Dialog Box - Add Button
Add

Displays the Add Server dialog box, which enables you to add the name and IP address of a server to the selected cell.

See Adding Server Information to Cells for more information.


New Cell Dialog Box - Change Button
Change

Displays the Edit Server dialog box, which enables you to modify the name and IP address of a selected Volume Location Server in the Servers list.

See Changing Server Information.


New Cell Dialog Box - Description Field
Description

A brief description identifying the cell.


New Cell Dialog Box - Remove Button
Remove

Removes a selected server entry from the Servers list.

See Removing Server Information from a Cell.


New Cell Dialog Box - Servers Field
Servers

Displays the names and IP addresses of the specified cell's Volume Location Servers.


Normal and Negative Entries

You can grant or deny a user or group any combination of the AFS Access Permissions.

When you create a normal entry, you give permission for a user or group to perform the specified actions.

When you create a negative entry, you explicitly deny a user or group permission to perform the specified action.

For example, if you want to give Read permission to all but one user in a group, put the group on the Normal Entries list and the user on the Negative Entries list.  The specified user is denied Read access since an entry on the Negative Entries list cancels out any permissions a user gains under the Normal Entries list.

Note:	Users on the Negative Entries list can acquire permissions you do not want them to have if the system-defined group system:anyuser has access permissions on the Normal Entries list.  Anyone who can gain access to your cell, including unauthenticated AFS users, is a member of the system:anyuser group.  Any user on the Negative Entries list can unauthenticate and use system:anyuser access permissions.

Related Topics:

An Overview of Access Control Lists

Access Permissions

Setting Access Control Lists


Obtain New AFS Tokens Dialog Box

When you select the Obtain New Tokens button from the Tokens tab, the Obtain New AFS Tokens dialog box appears.  Use this dialog box to authenticate to AFS by acquiring a token for the specified AFS cell.

  AFS Cell

  User Name

  Password

Related Topics:

Authenticating to AFS


Obtain New AFS Tokens Dialog Box - AFS Cell Field
AFS Cell

Specifies the AFS cell to which you are authenticating.


Obtain New AFS Tokens Dialog Box - Password Field
Password

Specifies your AFS password.


Obtain New AFS Tokens Dialog Box - User Name Field
User Name

Specifies your AFS username.


Other Variable Permissions

Additional AFS access permissions, represented by the uppercase letters A through H, are available for use on ACLs.  By default, these letters have no standard meanings and are ignored by the AFS server processes.  Your AFS system administrator can assign meanings to these variables.  If you encounter these permissions on an ACL, ask your AFS system administrator about their meaning.

Note:	The Access Control Lists command on the AFS Menu does not support these additional variable permissions.  To view or modify these permissions, you must use the fs listacl and fs setacl commands, respectively, from a command prompt window.  See Command Prompt Commands for more information.

Related Topics:

AFS Access Permissions

An Overview of Access Control Lists


Partition Info Dialog Box

The Partition Info dialog box displays information about the partition that houses the selected file or directory.  Access to this dialog box is from the Volume Information dialog box.

Note:	Only system administrators can modify partition properties.

The Partition Information dialog box displays the following information:

  Total Size

  Blocks Free

  % Used

Related Topics:

File Storage Concepts

Volumes and Partitions


Partition Info Dialog Box - % Used Field
%Used

Displays the percentage of disk partition being used.


Partition Info Dialog Box - Blocks Free Field
Blocks Free

Displays the number of 1 KB blocks still available on the partition.


Partition Info Dialog Box - Total Size Field
Total Size

Displays the size of the partition, in 1-KB blocks, that houses the selected file or directory.


Refreshing Name/Volume ID Mappings

When you request files from the AFS filespace, AFS Light accesses a table of mappings that associates volume names with corresponding volume ID numbers and obtains files from volumes based on the information stored in the table of mappings.  From time to time, volume information changes.  AFS provides a method for refreshing the mappings between volume names and volume ID numbers, ensuring that you are accessing the volume containing the most current information available on the File Server.

Note:	The table of mappings is automatically deleted and replaced once per hour.  However, if you know that a volume's name has changed or that there has been a release of read-only replicas, refreshing the table of mappings forces AFS Light to reference the volume with the most recent name or with the most recent read-only replica.

To refresh volume name/volume ID mappings:

1.	From the Start menu, display the Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click an AFS file or directory.

3.	Choose AFS, then choose Volume/Partition, then choose Refresh name/ID map.

AFS Light returns the following message:

All volumeID/name mappings checked

Related Topics:

File Storage Concepts

Volumes and Partitions


Remove Mount Points Dialog Box

The Remove Mount Points dialog box displays the name of the mount point and the result of the operation.

If the operation is successful, the following message appears:

Deleted Successfully.

If the operation fails (for example, the selected directory is not a mount point), an appropriate message is displayed.

Note:	To delete a mount point, you must have Delete access permission for the directory containing the mount point.  See Access Permissions for more information.

Related Topics:

File Storage Concepts

Removing Mount Points

Mount Points


Removing ACL Entries

You can remove an entry from a directory's access control list.   The procedure for removing user entries and group entries is the same.

To remove ACL entries:

Note:	To remove an entry from a directory's ACL, you must have Administer permission on the directory.  See AFS Access Permissions.

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the AFS directory from whose ACL you want to remove an entry.

3.	Point to AFS.  The AFS Menu is displayed.

4.	Select Access Control Lists.

The Set AFS ACL dialog box appears.

5.	In the Normal list or in the Negative list, select the entry to be removed.

6.	Select Remove.

7.	Click OK to close the Set AFS ACL dialog box.

Related Topics

An Overview of Access Control Lists

Adding ACL Entries

Copying ACLs


Removing Mount Points

You can remove an existing mount point.

Note:	You must have Delete access permission for the directory containing the mount point.  See Access Permissions for more information.

To remove a mount point:

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the directory whose mount point you want to remove.

3.	Choose AFS, then choose Mount Point, then choose Remove.

AFS Light displays the following message:

Are you sure you want to remove the selected mount point(s)?

4.	Click Yes.  The Remove Mount Points dialog box appears and displays the result.

Related Topics:

Mount Points

File Storage Concepts


Removing Network Drive Mappings

You can delete network drive mappings.

To remove network drive mappings:

Note:	A network drive that is being used cannot be deleted.

1.	Access the Drive Letters tab by using one of the following methods:

From the AFS Light Configuration utility:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the Drive Letters tab.

From the AFS Light property box:

1.	Click the AFS Light icon in the taskbar.  See Displaying the AFS Light Icon for more information.

2.	Select the Drive Letters tab.

2.	In the Drive Letters field, select the mapping that you want to delete.

3.	Select the Remove button.

4.	Click OK.

The mapping is removed from the Drive Letters field on the Drive Letters tab.  The network drive is also disconnected and removed from your Windows Explorer.

Related Topics:

Mapping Network Drives to AFS

Changing a Network Drive Mapping


Removing Servers from a Cell
Removing Server Information from a Cell

You can remove a server entry from a registered cell.

Note:	For each cell that is listed in AFS Light's cell database, AFS Light must be aware of at least one Volume Location Server in that cell.

To remove server information from a cell:

1.	From the Start menu, choose Settings, then choose Control Panel.

2.	Double-click the AFS Light Configuration icon.

3.	Select the AFS Cells tab.

4.	Select the cell from which you want to remove a server entry, and select Change.

The Cell Properties dialog box appears.

5.	From the Servers list, select the server entry that you want to remove, and select Remove.

6.	Click OK.

Related Topics:

Changing Cell Information

Adding Server Information to a Cell


Server Status Dialog Box

Use this dialog box to update and display information from AFS Light's list of File Server machines.  The following options are available on the Server Status dialog box:

  Cell

  Local Cell

  Specified Cell

  All Cells

  Do Not Probe Servers

  Show Status

Related Topics:

Showing the Status of File Servers


Server Status Dialog Box - All Cells Option
All Cells

Displays the status of File Servers in all cells contacted by your client machine.


Server Status Dialog Box - Cell Field
Cell

Specifies the cell or cells from which to display the status of File Servers, which can be selected as local, specified or all cells.


Server Status Dialog Box - Do Not Probe Servers Check Box
Do not probe servers

Forces AFS Light to display the information without updating its list of File Servers.


Server Status Dialog Box - Local Cell Option
Local Cell

Displays the status of File Servers in the local cell.


Server Status Dialog Box - Show Status Button
Show Status

Displays the status of File Servers according to the dialog box options selected.

If any File Servers in the specified cells are unavailable, the Down Servers dialog box appears with a list of the unavailable File Servers.  Otherwise, a dialog box appears stating that all servers are running.


Server Status Dialog Box - Specified Cell Option
Specified Cell

Displays the status of File Servers in a cell that you specify.


Set ACL Dialog Box - Add Button
Add

Adds a user or group entry to the Normal Entries list or Negative Entries list on a directory's ACL.

See Adding ACL Entries for more information.


Set ACL Dialog Box - Clean Button
Clean

Removes any ACL entries that specify a user or group no longer found in the Protection Database from the ACL of a specified directory.

Note:	The Protection Database contains the data required to protect the files and directories in the AFS filespace.  When users or groups are removed from the Protection Database, their AFS UIDs appear on ACLs rather than their names.  Cleaning an ACL removes these abandoned AFS UIDs from ACLs.


Set ACL Dialog Box - Copy Button
Copy

Copies the ACL from a selected directory to one or more destination directories.

See Copying ACLs for more information.


Set ACL Dialog Box - Directory field
Directory

Displays the path and name of the directory whose ACL is displayed and can be modified.


Set ACL Dialog Box - Negative Field
Negative

Displays the names of users and groups with their corresponding negative permissions.  Negative permissions deny users and groups the specified permissions.

See Normal and Negative Entries for more information.


Set ACL Dialog Box - Normal Field
Normal

Displays the names of users and groups with their corresponding normal permissions.  Normal permissions grant users and groups the specified permissions.

See Normal and Negative Entries for more information.


Set ACL Dialog Box - Permissions Field
Permissions

A series of check boxes enabling you to set AFS access permissions.

r 	Read allows the user to read the contents of the files in a directory.

l 	Lookup enables the user to access files or directories.  If a user is denied Lookup permission, all other permissions are denied.

i	Insert enables the user to create new subdirectories and add new files to a directory either by creating new files or by copying existing files.

d	Delete enables the user to remove files and subdirectories from a directory.

w	Write enables the user to modify the contents of the files in a directory.

k	Lock enables the user to run programs that place advisory locks on files in a directory.

a	Administer enables the user to change the ACL for a directory.  Users have the Administer permission on their home directory and its subdirectories.


Set ACL Dialog Box - Remove Button
Remove

Removes one or more selected user or group entries from the ACL.

See Removing ACL Entries for more information.


Set AFS ACL Dialog Box
The Set AFS ACL Dialog Box

The Set AFS ACL dialog box displays the following information.

  Directory

  Normal Entries

  Negative Entries

The Set AFS ACL dialog box enables a user to add new entries to an access control list, delete entries from a list, copy the ACLs of other directories, and clean or update an ACL.

  Permissions

  Add

  Remove

  Clean

  Copy

Related Topics:

Adding  ACL Entries

Copying ACLs

Removing ACL Entries

An Overview of Access Control Lists


Setting Access Control Lists

Use the Set AFS ACL dialog box to set Access Control Lists.  The Set AFS ACL dialog box appears when you select the Access Control Lists option from the AFS Menu; it enables you to add, modify, and remove an ACL entry for an AFS directory.  Setting an ACL consists of granting or denying any combination of AFS Access Permissions.

To set an ACL:

Note:	To set a directory's ACL, you must have Administer permission on the directory.  See AFS Access Permissions.

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the AFS directory whose ACL you want to set.

3.	Point to AFS.  The AFS Menu is displayed.

4.	Select Access Control Lists.

The Set AFS ACL dialog box appears.

You can now add entries, copy ACLs to other directories, delete entries, and clean your ACLs.

Related Topics:

Adding ACL Entries

Copying ACLs

An Overview of Access Control Lists


Show Cell Command
The Show Cell Command

This AFS Menu command displays the Show Cell dialog box, which lists the AFS cells in which the selected files and directories are located.

Note:	The cell is the administrative domain in the AFS filespace.  From a hardware perspective, a cell is a grouping of client machines and server machines that share common administration.  The cell's administrator determines how client machines are configured and how much storage space on the File Server machine is available to each user.

Related Topics:

Showing Cells

AFS File Storage Concepts


Show Cell Dialog Box
The Show Cell Dialog Box

The Show Cell dialog box lists the AFS cell in which each selected file or directory resides.

  File/Directory

  Cell

Related Topics:

Showing Cells

AFS File Storage Concepts


Show Cell Dialog Box - Cell Field
Cell

The name of the cell that houses the selected file or directory.


Show Cell Dialog Box - File/Directory Field
File/Directory

The name of the file or directory for which the cell name is reported.


Show File Server Command
The Show File Server Command

This AFS Menu command displays the Show File Servers dialog box, which displays the name of a specified file or directory and the name of the File Server that houses it.

Normally, you do not need to know which File Server machine stores a file or directory.  Given the pathname to a file, your client machine accesses the server machine automatically.  However, it is sometimes useful to know the location of a file or directory.  For example, if a File Server that houses a file you are working on becomes unavailable due to hardware problems, software problems, or routine maintenance, you will not be able to save the file until the server comes back into service.  Your system administrator can move volumes that house specific files to different File Server machines; it can be useful to occasionally verify the location of the files and directories that you commonly use.

Related Topics:

Showing File Servers

AFS File Storage Concepts


Show File Servers Dialog Box
The Show File Servers Dialog Box

This dialog box displays the following information:

  File/Directory

  File Server(s)

Related Topics:

Showing File Servers

Showing the Status of File Servers


Show File Servers Dialog Box - File Server Field
File Server(s)

Displays the current File Server machine that stores the selected file or directory.

Note:	If more than one File Server is listed, the volume containing the selected file or directory is replicated and exists at each listed site.  In general, popular files that do not change are often replicated so that if a server containing those files becomes unavailable, the files remain available from other File Servers.


Show File Servers Dialog Box - File/Directory Field
File/Directory

Displays the name of the file or directory whose server location is shown.


Show Server Status Command
The Show Server Status Command

This AFS Menu command updates and displays information from AFS Light's list of File Server machines.  Selecting the Show Server Status command displays the Server Status dialog box.

Your client machine constantly maintains a list of File Server machines that it has contacted or that it can possibly need to contact in the future.  It updates the list every three minutes by probing the File Server process on each server machine in the list.  If a process does not respond to the probe, the File Server machine is marked as nonfunctioning.  When a machine that previously did not respond begins to respond again, the nonfunctioning mark is erased.

Related Topics

Showing the Status of File Servers

AFS File Storage Concepts


Showing Cells

AFS enables you to list the AFS cells in which selected files and directories are located.

To show cells:

1.	From the Start menu, open your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the files or directories whose cells you want to view.

3.	Choose AFS, then choose Show Cell.

The Show Cell dialog box appears and lists the AFS cells in which the selected files and directories are located.

Related Topics:

Showing File Servers

Showing the Status of File Servers

AFS File Storage Concepts


Showing File Servers

You can determine the location of the files and directories that you commonly use.

In AFS, you normally do not need to know which File Server machine stores a file or directory.  Given the pathname to a file, your client machine accesses the appropriate server machine automatically.

However, it can be useful to know the location of a file or directory.  For example, if a File Server that houses a file you are working on becomes unavailable, you will not be able to save the file until the server comes back into service.

To show File Servers:

1.	From the Start menu, open your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right-click the file or directory whose server location you want to view.

3.	Choose AFS, then choose Show File Servers.

The Show File Servers dialog box appears.  This dialog box displays the name of the server that stores the specified file or directory.

Related Topics:

Showing the Status of File Servers


Showing the Status of File Servers

You can use the Show Server Status option from the AFS Menu to display which servers, if any, are unavailable.

A File Server machine in your cell can become unavailable due to hardware problems, software problems, or routine maintenance.  In this case, you are unable to access files stored on the File Server or save any changes you have made to files that are stored on the File Server until the machine comes back into service.  However, you can work on your files if AFS Light has copies stored locally.

Your client machine maintains a list of File Server machines that it has been in contact with or possibly needs to contact in the future.  It updates the list every 30 seconds by probing the File Server process on each machine in the list.  When a process does not respond to the probe, the File Server is marked as nonfunctioning.  If a machine that previously did not respond begins to respond again, the nonfunctioning mark is erased.

To show the status of File Servers:

1.	From the Start menu, display your Windows Explorer by choosing Programs, then choosing Windows Explorer.

2.	Right click an AFS file or directory.

3.	Choose AFS, then choose Show Server Status.

The Server Status dialog box appears.

4.	Select the set of File Servers for which you want to view a status report.  Your local cell is the default.

5.	Select Do Not Probe Servers if you want to view File Server information without having your client machine update the information.  Clear Do Not Probe Servers for an updated list.

6.	Click Show Status.

If any File Servers in the specified cell or cells are unavailable, the Down Servers dialog box appears with a list of the unavailable File Servers.  Otherwise, a dialog box appears stating that all servers are running.

Related Topics:

Showing File Servers


Tokens Tab

The Tokens tab displays the following information:

  Cell

  Tokens

The Tokens tab enables you to authenticate to AFS and unauthenticate from AFS.

  Obtain New Tokens

  Discard These Tokens

Note:	If you do not currently have any tokens in any AFS cells, your Tokens tab does not contain all of the above fields.  See Tokens Tab (No tokens).

If you have tokens for more than one cell, the cell name appears in place of the word tokens on the tab.  For example, if you have tokens for the abc.com cell and the xyz.com cell, the first two tabs in the AFS Light property box are the abc.com tab and the xyz.com tab.  These tabs replace the Tokens tab and display the same information as described above for the Tokens tab.

Related Topics:

Authenticating to AFS

Unauthenticating from AFS


Tokens Tab (No Tokens)
The Tokens Tab (No Tokens)

When you do not have any tokens for any AFS cells, this tab replaces the usual Tokens tab, indicating that you are not currently an authenticated AFS user.

The Tokens tab displays the following information:

You do not have tokens within any AFS Cell

Use the Tokens tab to authenticate to AFS:

  Obtain New Tokens

Related Topics:

Authenticating to AFS


Tokens Tab - Cell Field
Cell

Displays the name of the cell in which the user has a token and the name of the Windows NT machine that is serving as a gateway to the AFS filespace.


Tokens Tab - Discard These Tokens Button
Discard These Tokens

Enables you to unauthenticate from AFS.  After discarding your tokens, you cannot access AFS files as a valid AFS user.


Tokens Tab - Obtain New Tokens Button
Obtain New Tokens

Enables you to authenticate to AFS and become recognized as a valid AFS user.


Tokens Tab - Tokens Field
Tokens

Displays the AFS username of the user who acquired a token issued by AFS Light and the expiration date of the token.

Note:	Each token has an associated lifetime and expires after a set period of time.  The standard token lifetime is 25 hours.


Tokens Tab - Username Field
Username

Displays the username of the user currently logged onto the system.  The information is presented in the format:

Currently logged on to Windows Networking as "username"


Unauthenticating from AFS
Unauthenticating from AFS (Discarding Tokens)

Unauthentication is the process of discarding your tokens.  Discarding your tokens prevents others from using your tokens to access AFS when you are not attending your machine.

To unauthenticate from AFS

1.	Display the Tokens tab on the AFS Light property box by using one of the following methods:

From the Start menu, find the IBM AFS (or IBM WebSphere) program group and the Light program subgroup.  Choose Authentication.

Click the AFS Light icon in the taskbar, and select the Tokens tab.  See Displaying the AFS Light Icon for more information.

2.	If you have tokens in more than one cell, select the tab with the name of the cell from which you want to unauthenticate.

3.	Select the Discard These Tokens button.

Note:	You can unauthenticate from only one cell at a time.  If you have tokens from more than one cell, repeat Steps 2 and 3 for each cell.

You are no longer authenticated to AFS in the specified cell.  Use the Obtain New Tokens button to reauthenticate to AFS.

Related Topics:

Authenticating to AFS


Verifying Authentication

If you have a token, you are authenticated to an AFS cell.  You can list your tokens to verify that you are authenticated.

Displaying token information is useful for checking whether the Integrated Logon option is selected for your client machine.  Also, verify authentication if you cannot access a file in AFS and suspect a token has expired.  If your token has expired, you must reauthenticate to AFS.

To verify authentication:

1.	Display the Tokens tab on the AFS Light property box by using one of the following methods:

From the Start menu, find the IBM AFS (or IBM WebSphere) program group and the Light program subgroup.  Choose Authentication.

Click the AFS Light icon in the taskbar and select the Tokens tab.  See Displaying the AFS Light Icon for more information.

The Tokens tab on the AFS Light property box displays token information.

If you have tokens for more than one cell, the cell name appears in place of the word tokens on the tab.  For example, if you have tokens for the abc.com cell and the xyz.com cell, the first two tabs in the AFS Light property box are the abc.com tab and the xyz.com tab.  These tabs replace the Tokens tab.  These tabs display the same information as the Tokens tab.

If you do not currently have any tokens in any AFS cells, your Tokens tab does not contain token information.  See Tokens Tab (No tokens).

Related Topics:

Authenticating to AFS (Obtaining Tokens)

Unauthenticating from AFS (Discarding Tokens)


Volume Information Dialog Box

The Volume Information dialog box displays the following information:

  File/Directory

  Name

  ID

  Quota

  Used

  % Used

  New Quota

  Show Partition Info

Related Topics:

AFS File Storage Concepts

Volumes and Partitions


Volume Information Dialog Box - %Used Field
%Used

Displays the percentage of the volume's quota that is being used.


Volume Information Dialog Box - File/Directory Field
File/Directory

Displays the name of the selected file or directory whose volume information is being displayed.


Volume Information Dialog Box - ID Field
ID

Displays the volume's ID number.


Volume Information Dialog Box - Name Field
Name

Displays the name of the volume that houses the selected file or directory.


Volume Information Dialog Box - New Quota Field
New Quota

Enables you to set a new quota, in KBs, for the volume that contains the selected file or directory.

Note:  Only system administrators can increase the quota.


Volume Information Dialog Box - Quota Field
Quota

Displays the quota, in KBs, allocated to the volume.


Volume Information Dialog Box - Show Partition Info Button
Show Partition Info

Enables you to access the Partition Info dialog box, which displays information about the partition that houses the volume.


Volume Information Dialog Box - Used Field
Used

Displays the amount of disk space, in KBs, currently in use on the volume.


Volume/Partition Command
The Volume/Partition Command

The Volume/Partition command is accessed from the AFS Menu.  It provides two options:

Properties

This option displays volume and partition information.  When you select this option, the Volume Information dialog box appears.

See Displaying Volume and Partition Properties for more information.

Refresh Name/ID Map

This option discards your client machine's current table of mappings between volume names and volume ID numbers and updates it.  See Refreshing Name/Volume ID Mappings for more information.

Related Topics:

File Storage Concepts

Volumes and Partitions


Volumes and Partitions

Access to the Volumes and Partitions command is from the AFS Menu.  From the Volume/Partition option on the AFS Menu, there are two options:  Properties and Refresh Name/ID Map.

Properties

The disks in a computer are divided into sections called partitions.  AFS further divides partitions into subsections called volumes.  A volume houses a subtree of related files and directories, providing a convenient means for storing, backing up, and moving related files and directories.  Each volume has a size limit, or quota, representing the maximum amount of disk space the volume can contain.  Quotas are set by the system administrator.

The Properties option displays volume and partition information.  See Displaying Volume and Partition Properties for more information.

Refresh Name/ID Map

AFS Light accesses a table of mappings that associates volume names with corresponding volume ID numbers.  When you request files from the AFS filespace, a volume is accessed based on the information stored in your table of mappings.  From time to time, volume information changes.  For example, a volume's name can change, or your system administrator can release new read-only replicas.  AFS provides a method for refreshing the mappings between volume names and volume ID numbers, ensuring that you are accessing the volume containing the most current information available on the File Server.

The Refresh Name/ID Map option discards your current table of mappings between volume names and volume ID numbers and updates it.  See Refreshing Name/Volume ID Mappings for more information.

Related Topics:

File Storage Concepts