AFS volumes & quotas
An AFS "volume " contains a subtree of related files and directories descending from a "mount points " that specifies where in the AFS directory tree the volume resides. For example, files for a typical SCS user named bovik would be contained in a dedicated volume called user.bovik and mounted at /afs/cs.cmu.edu/user/bovik .Types of volumes
SCS supports four main types of AFS volumes:- User volumes: Every SCS user has a volume located under /afs/cs.cmu.edu/user/<user_ID>
- Academic volumes: Instructors teaching graduate courses in SCS can request academic volumes under /afs/cs.cmu.edu/academic
- Project volumes: Individuals and research projects may request project volumes under /afs/cs.cmu.edu/project/
- Misc collection volumes are used for Unix software collections
Read-only & read-write volumes
To increase availability in case an AFS server fails, some software (in particular important system software and misc collections) located under /afs/cs.cmu.edu/ is replicated across several file servers. The replicated copies are read-only (they cannot be modified). The corresponding read/write volume is located under /afs/.cs.cmu.edu (note the "." in front of cs.cmu.edu ). Every night, the read/write contents are automatically released (copied) to the read-only volumes. Misc maintainers can also use Jeeves to release volumes manually.Quotas
Each volume in AFS, including that containing your user files, has an associated quota:- The user-volume quota is 1 GB for new accounts. Older user accounts can use Jeeves to increase their volume quota to 1 GB.
If you require more space, contact the SCS HelpDesk, <help+@cs.cmu.edu> or x8-4231. - The maximum academic-volume quota is the maximum volume size, 25 GB
- The maximum project-volume quota is the maximum project-space allocation, 100 GB
Determine quota use
The fs command is in /usr/local/bin on Facilitized Unix systems. The following commands will show current quota use for a volume:- fs lq <directory_name>
- will list the quota information for the given directory. For example:
% fs lq /afs/cs/user/bovik Volume Name Quota Used %Used Partition user.bovik 50000 42766 86% 59%
- fs lv -dir <directory-name>
- will list the current status of the named directory. The available remaining quota is the difference between the maximum quota and the number of blocks used. For example:
% fs lv /afs/cs/user/bovik Volume status for vid = 25836 named user.bovik Current disk quota is 50000 Current blocks used are 42766 The partition has 7023124 blocks available out of 17212287
Change AFS quotas
Jeeves is a telnet-based service that allows users to change AFS quotas and perform other AFS-related tasks. See the Jeeves documentation for details on how to connect to Jeeves and a list of all commands.Connect to Jeeves, jeeves.srv.cs.cmu.edu, using a Kerberized telnet client, such as PuTTy on a Windows PC or the standard telnet on Facilitized Unix hosts. Once connected, you will be presented with a menu-based interface. To change your AFS user quota, perform the following steps after you have connected:
- Type "afs" to go to the "AFS-related operations" submenu
- Type "quota" to go to the "AFS quota operations" submenu
- Type "change" to change your AFS quota
- You will be asked for the name for the volume. Type user.<your-username>, for example "user.bovik" if your username is "bovik"
- You will be asked for a new quota. Type the amount of space desired (in kilobytes). For example, "50000" if you want to change your quota to 50 MB. User volumes are initially created with 1 GB of storage. You may request up to 10 GB by contacting the SCS HelpDesk, <help+@cs.cmu.edu> or x8-4231.
An AFS volume resides on a single disk partition. If you request additional quota that exceeds the remaining partition space, Jeeves will automatically move the volume to a partition with more available space. Please do not increase your AFS quota to the maximum permitted if you do not need that space. We do not have enough free disk space online at any one time for everyone to do so.