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
(Initial edit. Much of the formatting taken from http://www.umbc.edu/oit/iss/syscore/wiki/AFS_servers_and_filespace_structure)
 
m (<tt>tokenizer/</tt>: categorize)
 
(7 intermediate revisions by 4 users not shown)
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>archive/</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.
+
This contains mountpoints for various volumes that are no longer used in day-to-day operations but that we want to continue to be accessible.
 +
 
 +
<blockquote>
 +
====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 <tt>web-docs</tt> are still available, so we do not break links.
 +
 
 +
====<tt>i1/</tt>====
 +
Data files for the original [[Intranet]].
 +
 
 +
====<tt>legacy/</tt>====
 +
Deactivated websites are remounted here in subfolders corresponding to their old subdomain.
 +
 
 +
====<tt>web.XXX/</tt>====
 +
These are various old versions of the main tjhsst.edu website.
 +
</blockquote>
 +
 
 +
===<tt>common/</tt>===
 +
This contains shared directories for various groups and functions.
 +
 
 +
===<tt>fcps/</tt>===
 +
Home directories for non-TJHSST FCPS students/staff. They are separated into sub-directories by site.
 +
 
 +
===<tt>parents/</tt>===
 +
Home directories for parents; primarily webmasters.
 +
 
 +
===<tt>staff/</tt>===
 +
Staff home directories for accounts that authenticate against the windows servers are stored here.
 +
 
 +
===<tt>students/</tt>===
 +
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>===
Current user directories are stored here.
+
Legacy user home directories from when CSL user accounts were separate from the rest of the school.
  
 
===<tt>web/</tt>===
 
===<tt>web/</tt>===
Data for various web services. Almost all of the subdirectories here correspond to a subdomain <nowiki>http://&lt;directory&gt;.tjhsst.edu/</nowiki>.
+
Data for various web services. Almost all of the sub-directories here correspond to a subdomain <nowiki>http://&lt;directory&gt;.tjhsst.edu/</nowiki>.
  
 
<blockquote>
 
<blockquote>
====<tt>intranet/</tt>====
 
Data files for [[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 34: Line 60:
  
 
===<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 40: Line 66:
 
====<tt>music/</tt>====
 
====<tt>music/</tt>====
 
====<tt>sound/</tt>====
 
====<tt>sound/</tt>====
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.
+
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).
  
 
====<tt>bind/</tt>====
 
====<tt>bind/</tt>====
Line 46: Line 72:
 
====<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>====
 +
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 64: Line 93:
  
 
====<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.
+
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>
 +
[[Category:AFS]]
 +
[[Category:Obsolete Page]]

Latest revision as of 15:32, 26 February 2016

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/

archive/

This contains mountpoints for various volumes that are no longer used in day-to-day operations but that we want to continue to be accessible.

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.

i1/

Data files for the original Intranet.

legacy/

Deactivated websites are remounted here in subfolders corresponding to their old subdomain.

web.XXX/

These are various old versions of the main tjhsst.edu website.

common/

This contains shared directories for various groups and functions.

fcps/

Home directories for non-TJHSST FCPS students/staff. They are separated into sub-directories by site.

parents/

Home directories for parents; primarily webmasters.

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 home directories from when CSL user accounts were separate from the rest of the school.

web/

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

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.