Warning Livedoc is no longer being updated and will be deprecated shortly. Please refer to https://documentation.tjhsst.edu.

Difference between revisions of "AFS/Directory Structure"

From Livedoc - The Documentation Repository
Jump to: navigation, search
(netware no longer exists, new place for user home directories, other updates)
(Some cleaning (I think) - an import from what was going to be the new livedoc)
Line 1: Line 1:
 
==General Conventions==
 
==General Conventions==
Usually, if a mount point is read-only, then there will be another read-write mount point with the same name, except that there is a dot in front of it. For example, the mount point /afs/csl/service is read-only, but /afs/csl/.service is read-write. Both of those mount points are the same volume (service), but one is a read-only copy, and thus more likely to be available.
+
Usually, if a mount point is read-only, then there will be another read-write mount point with the same name with dot in front of the name. For example, the mount point /afs/csl/service is read-only, but /afs/csl/.service is read-write. Both of those mount points are the same volume (service), but one is a read-only copy, and thus more likely to be available.
  
We also try to have volume names roughly correspond to where the volume is typically mounted in the directory tree, using dots as delimeters instead of slashes. For example, /afs/csl/service/matlab is a mount point to service.matlab, and /afs/csl/web/www is web.www. They do not have to completely correspond (volume names can only be so long), but try to keep it kind of similar.
+
We also try to have volume names roughly correspond to where the volume is typically mounted in the directory tree, using dots as delimiters instead of slashes. For example, /afs/csl/service/matlab is a mount point to service.matlab, and /afs/csl/web/www is web.www. They do not have to completely correspond (volume names can only be so long), but they should be similar.
  
 
==Directory Hierarchy==
 
==Directory Hierarchy==
  
 
===<tt>/afs/csl.tjhsst.edu/</tt>===
 
===<tt>/afs/csl.tjhsst.edu/</tt>===
This is the read-only mount point for <tt>root.cell</tt> for our cell. /afs/.csl.tjhsst.edu/ is the read-write mount point, and /afs/csl/ is just a symlink to /afs/csl.tjhsst.edu/, and /afs/.csl/ is just a symlink to /afs/.csl.tjhsst.edu/
+
This is the read-only mount point for <tt>root.cell</tt> for our cell. /afs/.csl.tjhsst.edu/ is the read-write mount point, and /afs/csl/ is a symlink to /afs/csl.tjhsst.edu/, and /afs/.csl/ is a symlink to /afs/.csl.tjhsst.edu/
  
 
<blockquote>
 
<blockquote>
 
===<tt>cronos/</tt>===
 
===<tt>cronos/</tt>===
All of the home directories before the switch to AFS was made were copied here (the old fileserver was called 'cronos' at the time). They are still around so that their <tt>web-docs</tt> are still available, so we don't break links.
+
All of the home directories before the lab switched to AFS (the old fileserver was called 'cronos', and served data with [[NFS]]). They are still around so that their <tt>web-docs</tt> are still available, so we do not break links.
  
 
===<tt>staff/</tt>===
 
===<tt>staff/</tt>===
Staff home directories for accounts that auth against the windows servers are stored here.
+
Staff home directories for accounts that authenticate against the windows servers are stored here.
  
 
===<tt>students/</tt>===
 
===<tt>students/</tt>===
Student home directories for accounts that auth against the windows servers are stored here, each separated by graduation year.
+
Student home directories for accounts that authenticate against the windows servers are stored here, each separated by graduation year.
  
 
===<tt>user/</tt>===
 
===<tt>user/</tt>===
User directories for "old CSL" are stored here.
+
Legacy user accounts when all user accounts were separate from the rest of the school.
  
 
===<tt>web/</tt>===
 
===<tt>web/</tt>===
Line 27: Line 27:
 
<blockquote>
 
<blockquote>
 
====<tt>intranet/</tt>====
 
====<tt>intranet/</tt>====
Data files for the old [[Intranet]].
+
Data files for the original [[Intranet]].
  
 
====<tt>sitemap/</tt>====
 
====<tt>sitemap/</tt>====
Contains information for the sitemap for [[Krysalis]].
+
Contains information for the sitemap for the legacy [[Krysalis]] system.
  
 
====<tt>www/</tt>====
 
====<tt>www/</tt>====
Line 40: Line 40:
  
 
===<tt>service/</tt>===
 
===<tt>service/</tt>===
Various administrative scripts and files are in here.
+
Various administrative scripts and files are stored here.
  
 
<blockquote>
 
<blockquote>
Line 52: Line 52:
 
====<tt>postfix/</tt>====
 
====<tt>postfix/</tt>====
 
====<tt>httpd.intranet/</tt>====
 
====<tt>httpd.intranet/</tt>====
These are directories left over from when a few services ran with configuration files staight out of AFS. They no longer are, however.
+
These are directories left over from when a few services ran with configuration files stored in AFS. However, these files are no longer used.
  
 
====<tt>convert/</tt>====
 
====<tt>convert/</tt>====
A set of scripts to convert the old non-AFS accounts to AFS ones, from back when the lab was switching to AFS.
+
A set of scripts to convert the old non-AFS accounts to AFS ones, from the age when the lab was switching to AFS.
  
 
====<tt>emperor_stuff/</tt>====
 
====<tt>emperor_stuff/</tt>====
Some files that were on [[emperor]] before the drives got replaced ([[HAA]] stuff and a few random scripts). This will most likely be gone soon when we are sure everything in there is accounted for somewhere else, if it needs to be.
+
A selection of files that were on [[emperor]] before the drives were replaced ([[HAA]] stuff and a few random scripts).
  
 
====<tt>images/</tt>====
 
====<tt>images/</tt>====
Some data for new workstation images is going in here. We're still experimenting with this, however, so the location of this may change over time.
+
Some data for experimental (now obsolete) workstation images is in here.
  
 
====<tt>imaging/</tt>====
 
====<tt>imaging/</tt>====
Some scripts and files for distributing files to workstations without imaging. However, this is not used at this point on the production machines.
+
Scripts and files for distributing files to workstations without imaging.
  
 
====<tt>logs/</tt>====
 
====<tt>logs/</tt>====
When log files start taking up too much space on a server's /var/log, we put the files in here to free up some space.
+
When log files start taking up too much space on a server's /var/log, the files were put here to free up space.
  
 
====<tt>matlab/</tt>====
 
====<tt>matlab/</tt>====
Line 73: Line 73:
  
 
====<tt>sysadmins/</tt>====
 
====<tt>sysadmins/</tt>====
More administrative scripts are in here. There's really not much distinction between these and the ones in service/; the separation is a legacy from previous years.
+
More administrative scripts are in here. There's really not much distinction between these and the ones in service/; the separation is a legacy from previous years. These scripts are largely obsolete.
  
 
<blockquote>
 
<blockquote>
=====<tt>haa/</tt>=====
+
====<tt>haa/</tt>====
 
Scripts for the [[HAA]] system.
 
Scripts for the [[HAA]] system.
  
=====<tt>sound/</tt>=====
+
===<tt>tokenizer/</tt>===
Even more scripts and cron information for the workstation bell, this directory is no longer used.
+
A set of scripts to let daemons (such as apache for the [[website]]) gain permission to access AFS in their init.d scripts and refresh their credentials after a specified interval of time.
</blockquote>
 
 
 
====<tt>tokenizer/</tt>====
 
A set of scripts to let daemons (such as apache for the [[website]] and [[Intranet]]) gain permissions to AFS in their init.d scripts, and makes sure they keep permissions by refreshing their credentials every so often.
 
 
</blockquote>
 
</blockquote>

Revision as of 00:16, 27 January 2008

General Conventions

Usually, if a mount point is read-only, then there will be another read-write mount point with the same name with dot in front of the name. For example, the mount point /afs/csl/service is read-only, but /afs/csl/.service is read-write. Both of those mount points are the same volume (service), but one is a read-only copy, and thus more likely to be available.

We also try to have volume names roughly correspond to where the volume is typically mounted in the directory tree, using dots as delimiters instead of slashes. For example, /afs/csl/service/matlab is a mount point to service.matlab, and /afs/csl/web/www is web.www. They do not have to completely correspond (volume names can only be so long), but they should be similar.

Directory Hierarchy

/afs/csl.tjhsst.edu/

This is the read-only mount point for root.cell for our cell. /afs/.csl.tjhsst.edu/ is the read-write mount point, and /afs/csl/ is a symlink to /afs/csl.tjhsst.edu/, and /afs/.csl/ is a symlink to /afs/.csl.tjhsst.edu/

cronos/

All of the home directories before the lab switched to AFS (the old fileserver was called 'cronos', and served data with NFS). They are still around so that their web-docs are still available, so we do not break links.

staff/

Staff home directories for accounts that authenticate against the windows servers are stored here.

students/

Student home directories for accounts that authenticate against the windows servers are stored here, each separated by graduation year.

user/

Legacy user accounts when all user accounts were separate from the rest of the school.

web/

Data for various web services. Almost all of the subdirectories here correspond to a subdomain http://<directory>.tjhsst.edu/.

intranet/

Data files for the original Intranet.

sitemap/

Contains information for the sitemap for the legacy Krysalis system.

www/

Data files for the main website under the www subdomain. Other web subdomains (such as arts, activities, sports, etc.) also have their own directories in web/.

webadmin/

Data files for the webadmin application. See the webadmin article for information on the subdirectories here.

service/

Various administrative scripts and files are stored here.

belltab/

music/

sound/

Contains cron information and scripts to run the bell on the workstations at the appropriate times. The three directories are of different ages, and each was used at one point or another (music is really old, belltab holds the current crontab file, and sound holds the scripts).

bind/

mailman/

postfix/

httpd.intranet/

These are directories left over from when a few services ran with configuration files stored in AFS. However, these files are no longer used.

convert/

A set of scripts to convert the old non-AFS accounts to AFS ones, from the age when the lab was switching to AFS.

emperor_stuff/

A selection of files that were on emperor before the drives were replaced (HAA stuff and a few random scripts).

images/

Some data for experimental (now obsolete) workstation images is in here.

imaging/

Scripts and files for distributing files to workstations without imaging.

logs/

When log files start taking up too much space on a server's /var/log, the files were put here to free up space.

matlab/

Data for Matlab.

sysadmins/

More administrative scripts are in here. There's really not much distinction between these and the ones in service/; the separation is a legacy from previous years. These scripts are largely obsolete.

haa/

Scripts for the HAA system.

tokenizer/

A set of scripts to let daemons (such as apache for the website) gain permission to access AFS in their init.d scripts and refresh their credentials after a specified interval of time.