Initial Check-In (because I get nervous when I don't "save")
authorDonald Guy <fawkes@mit.edu>
Sat, 10 Jan 2009 22:07:12 +0000 (17:07 -0500)
committerTrac <sipb-www@mit.edu>
Sun, 1 Feb 2009 07:25:21 +0000 (02:25 -0500)
doc/AFSAndYou [new file with mode: 0644]

diff --git a/doc/AFSAndYou b/doc/AFSAndYou
new file mode 100644 (file)
index 0000000..c7fd941
--- /dev/null
@@ -0,0 +1,40 @@
+[[PageOutline]]
+
+= What is AFS? =
+The '''Andrew File System''' or '''AFS''', is a distributed network file system invented at [http://www.cmu.edu/index.shtml Carnegie Mellon University] as part of Project Andrew (approximately their equivalent of MIT's Project Athena). More importantly, it is the file system used to store most files on Athena today. This includes your personal home directory, your dorm site, and probably some of the software you run, if you ever use clusters. (Though all user directories were migrated from NFS in the summer of 1992, some files probably still remain on NFS and, of course, various file systems are used on personal computers and servers).
+
+'''''In Short: AFS is probably where some of the files you care about live'''''
+
+For the most part using AFS, particularly at MIT, is well-hidden and can be used like any other UNIX file system. For some things, you will need to know a bit more 
+
+= Some MIT/AFS terminology = 
+
+ '''locker'''::
+    For practical purposes, a folder. Probably the what you'll care about most of the time. Technically any directory mountable under /mit, regardless of how its stored. Today, most lockers (possibly all) lockers are stored in AFS.
+
+ '''tokens'''::
+    Essentially proof to the AFS servers that you are who you say you are, thus allowing you to access files you are supposed to. Analogous to Kerberos tickets. 
+
+ '''cell'''::
+    AFS concept of an "administrative domain of authority." Each cell has its own set of users, groups, and administrators. Analogous to a Kerberos realm. Each top-level directory in /afs corresponds to a cell. The cells you are most likely to care about are athena.mit.edu and sipb.mit.edu
+
+= The Basics =
+
+== The Layout of an MIT User Locker ==
+Every Athena user has a locker (their home directory) which mounts at {{{/mit/<username>}}} From a technical standpoint, its stored in the volume {{{user.<username>}}} which is located at {{{/afs/athena.mit.edu/user/<first letter>/<second letter>/<user name>}}} For example, the user {{{sipbtest}}} has a home directory that mounts at {{{/mit/sipbtest}}, is volume {{{user.sipbtest}}, and is accessible at {{{/afs/user/s/i/sipbtest}}}.
+
+Within this folder there are 4 special subdirectories you want to care about
+
+ '''{{{Public}}}''':: 
+  By default, this directory can be read by everyone (and I do mean EVERYONE!), so put files here you want to share with the entire world.
+ '''{{{Private}}}'''::
+  By default, this directory can only be read and can only be ''listed'' by you (from AFS, not from web) whereas the files in other directories can (by default) only be read by you, but can be listed by anyone. This means that other people can't see the contents of your files, but they can see what files you have outside of {{{Private}}} 
+ '''{{{OldFiles}}}'''::
+  This folder is a link to a read-only copy of a backup of your files (created nightly at 3 a.m.) This copy can not be edited and does not count towards your quota. (From a technical standpoint, this is a separate volume, user.<username>.backup and is stored only as changes against the current copy). 
+ '''{{{www}}}'''::
+  Where you should put a website, if you want one. There is very little special about this directory from an AFS standpoint, but it is world readable (like Public) and is linked directly if someone goes to {{{http://www.mit.edu/~<username>}}} (e.g. http://www.mit.edu/)
+
+= Common Tasks =
+
+
+= Advanced Tasks =