--- doc/loncapafiles/Attic/loncapafiles.html 2000/09/24 01:08:06 1.2 +++ doc/loncapafiles/Attic/loncapafiles.html 2001/02/15 16:02:38 1.56 @@ -1,48 +1,200 @@
- --Note: these files only refer to -
+This file contains specialized markup tags which encode information readable
+by the LON-CAPA make/build process. This is meant to be "the master file" which
+encodes all necessary configuration information to the associated make process.
+The format of these tags is:
+
<LONCAPA TYPE=type [otherparameters]>
+
+Here are examples of all the different types of LONCAPA make/build tags.
+
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler">
+
<LONCAPA TYPE=DIRECTORY DIST="redhat6.2" TARGET="home/httpd/lib/perl/Apache" CATEGORY="writeable by server">
+
<LONCAPA TYPE=OWNERSHIP DIST="redhat6.2" CATEGORY="setuid" CHMOD="6755" CHOWN="root:root">
+
<LONCAPA TYPE=RPM NAME="Vendor" VALUE="Laboratory for Instructional Technology Education, Division of Science and Mathematics Education, Michigan State University.">
+
+The NAME tags associated with TYPE=RPM are:
+Data can also be attached to any LON-CAPA tag. This is especially important for files. This is shown by these three examples:
+
<METAGROUP>
+
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler">
+
<DESCRIPTION>
+
Handler for TeX files
+
</DESCRIPTION>
+
</METAGROUP>
+
+
<METAGROUP>
+
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/modules/TexConvert/tthperl/tth.so" TARGET="usr/lib/perl5/site_perl/5.005/tth.so" CATEGORY="system file">
+
<DESCRIPTION>
+
shared library file for dynamic loading and unloading of TeX-to-HTML functionality
+
</DESCRIPTION>
+
<BUILD>
+
loncom/modules/TexConvert/tthperl/commands
+
</BUILD>
+
<DEPENDENCIES>
+
../tthdynamic/tthfunc.c
+
../ttmdynamic/ttmfunc.c
+
</DEPENDENCIES>
+
</METAGROUP>
+
+
<METAGROUP>
+
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/access.conf" TARGET="etc/httpd/conf/access.conf" CATEGORY="conf">
+
<DESCRIPTION>
+
define handlers, set parameters
+
</DESCRIPTION>
+
<NOTE>
+
<TABLE CELLPADDING=0 CELLSPACING=0 BORDER=1>
+
<TR><TD><TT>lonHostID</TT></TD><TD>LON-internal HostID of this machine</TD></TR>
+
<TR><TD><TT>lonRole</TT></TD><TD>Role of this machine: library, access</TD></TR>
+
<TR><TD><TT>lonAdmEMail</TT></TD><TD>Server Administration</TD></TR>
+
<TR><TD><TT>lonDefDomain</TT></TD><TD>Default domain</TD></TR>
+
<TR><TD><TT>lonLoadLim</TT></TD><TD>Load Limit ( 100% loadavg )</TD></TR>
+
<TR><TD><TT>lonExpire</TT></TD><TD>Expiration for local copies in seconds</TD></TR>
+
</TABLE>
+
</NOTE>
+
</METAGROUP>
+
+The METAGROUP tags for files are anticipatively limited to: NOTE, BUILD, DEPENDENCIES and DESCRIPTION. +
++To allow for viewing the tag information in a tabular HTML format, the make process generates +doc/loncapafiles/latestinstallconfiguration.html which +has the latest HTML presentation of the current LONCAPA tag configuration settings
. Alternatively, +you can just view the internal tags of this HTML file. + ++This section contains the actual LONCAPA tag information. These tags are probably not viewable with your +browser and can only be seen be examining the HTML source. +
+Files & Directories | -Type | -Function | -Install | -|||||||
DIRECTORY -- /etc/httpd/conf | -- | |||||||||
- | access.conf | -conf | -define handlers, set parameters | -configure
+
| ||||||
- | httpd.conf | -static conf | -main server configuration file | -- | ||||||
- | srm.conf | -static conf | -name space configuration | -- | ||||||
- | startup.pl | -static conf | -set paths to modules; invoked by access.conf | -- | ||||||
DIRECTORY -- /home/httpd/lonTabs | -LON-CAPA Tables | -|||||||||
- | filetypes.tab | -static conf | -Descriptive list of file extensions, and extension groupings | -- | ||||||
- | roles.tab | -static conf | -List of privileges associated with users of multiple types (for example: Teaching Assistant, Exam Proctor, Course Coordinator) | -- | ||||||
- | rolesplain.tab | -static conf | -Descriptive list of abbreviations used in roles.tab for user types and privileges available - in the network with function | -- | ||||||
- | hosts.tab | -static conf | -List of all machines in the LON-CAPA network. Relates lonHostID to lonDefDomain and IP address | -- | ||||||
- | spare.tab | -conf | -Spare hosts to - offload session to if the LON-CAPA machine is overloaded | -
+
+
+
|
- ||||||
- | htpasswd | -static conf | -Basic auth - password to access /lon-status and /server-status | -- | ||||||
DIRECTORY -- /etc | -- | |||||||||
- | krb.conf | -conf | -which Kerberos - server to contact for which Kerberos domains | -configure + + +
|
- ||||||
DIRECTORY -- /home/httpd/perl | -Communication | -|||||||||
- | lonc | -script | -proxy server | -- | ||||||
- | lond | -script | -remote command - interpreter | -- | ||||||
- | loncron | -script | -housekeeping | -- | ||||||
- | lonsql | -script | -maintain secondary database of metadata | -- | ||||||
EMPTY DIRECTORY -- /home/httpd/perl/logs | -logs and pids of lonc, lond and lonnet.pm | -|||||||||
EMPTY DIRECTORY -- /home/httpd/perl/tmp | -logs and pids of lonc, lond and lonnet.pm | -|||||||||
DIRECTORY -- /home/httpd/lib/perl/Apache | -handlers | -|||||||||
- | lonxml.pm | -handler | -XML Parsing Module | -- | ||||||
- | style.pm | -handler | -Style Parsing Module | -- | ||||||
- | londefdef.pm | -handler | -Tags Default Definition Module | -- | ||||||
- | run.pm | -handler | -evaluates expression within a memory-safe environment (to protect system from break-in attempts) | -- | ||||||
- | scripttag.pm | -handler | -parse and evaluate contents of values within a <script> tag (this module invokes run.pm) | -- | ||||||
- | lonhomework.pm | -handler | -handles requests for output, evaluation, and alteration of homework resource | -- | ||||||
- | inputtags.pm | -handler | -produces HTML input tags (<INPUT>) for rendering homework resources | -- | ||||||
- | structuretags.pm | -handler | -produces HTML tags necessary for structuring the presentation of homework resourcese | -- | ||||||
- | response.pm | -handler | -defines different types of responses given to student as well as syntax for producing response values | -- | ||||||
- | caparesponse.pm | -handler | -handles request to the CAPA homework processing engine | -- | ||||||
- | lonacc.pm | -handler | -access to for a LON-CAPA user session | -- | ||||||
- | lonracc.pm | -handler | -access handler for file transfers | -- | ||||||
- | loncacc.pm | -handler | -access to construction area | -- | ||||||
- | lonauth.pm | -handler | -authenticate, set up session environment | -- | ||||||
- | lonlogin.pm | -handler | -login screen | -- | ||||||
- | lonrep.pm | -handler | -replication | -- | ||||||
- | lonproblem.pm | -handler | -assessments | -- | ||||||
- | lonroles.pm | -handler | -roles picking | -- | ||||||
- | lonindexer.pm | -handler | -cross server - filesystem browser | -- | ||||||
- | lonnet.pm | -handler | -interface - to lonc | -- | ||||||
EMPTY DIRECTORY -- /home/httpd/lonIDs | -cookie jar | -|||||||||
EMPTY DIRECTORY -- /home/httpd/sockets | -lonc's sockets | -|||||||||
EMPTY DIRECTORY -- /home/httpd/sockets/delayed | -lonc's sockets | -|||||||||
DIRECTORY -- /home/httpd/html | -- | |||||||||
- | index.html | -interface file | -bumps to login | -- | ||||||
- | raw | -symbolic link | -symbolic link to /home/httpd/html/res | -- | ||||||
EMPTY DIRECTORY -- /home/httpd/html/res | -root of resource tree | -|||||||||
DIRECTORY -- /home/httpd/html/adm | -unauthenticated resources | -|||||||||
- | notfound.html | -interface file | -static html page that is shown when an attempt is made to access a document not present on the web server | -- | ||||||
- | unauthorized.html | -interface file | -static html page that is shown when an attempt is made to access a document which is restricted based on -file or server configurations | -- | ||||||
DIRECTORY -- /home/httpd/html/adm/rat | -home of the rat | -|||||||||
- | rat.html | -interface file | -frameset | -- | ||||||
- | code.html | -interface file | -javascript | -- | ||||||
- | map.html | -interface file | -bumper | -- | ||||||
- | *.gif | -graphic files | -images for - rat | -listing - + + +
|
- ||||||
DIRECTORY -- /home/httpd/html/adm/lonIcons | -- | |||||||||
- | *.gif | -graphic files | -logos | -
-listing - + + + |
- ||||||
EMPTY DIRECTORY -- /home/httpd/lonUsers | -home dirs of local users | -|||||||||
EMPTY DIRECTORY -- /home/httpd/html/lon-status | -status reports | -|||||||||
DIRECTORY -- /usr/lib/perl5/site_perl/5.005 | -- | |||||||||
- | capa.pm | -system file | -perl module for invoking functions specific to CAPA | -- | ||||||
- | capa.bs | -system file | -bootstrap file associated with dynamic loading of this module on multiple architectures | -- | ||||||
- | capa.so | -system file | -shared library file for dynamic loading and unloading | -- | ||||||
DIRECTORY -- /home/httpd/html/adm/MathML | -- | |||||||||
- | *.ent | -static conf | -entity files | -
-listing - +lonlogo.gif +lonlogos.gif + + + |
- ||||||
- | mathml.css | -static conf | -cascading style sheet | -- | ||||||
- | mathml.dtd | -static conf | -document type definition | -- | ||||||
DIRECTORY -- /home/httpd/html/res/adm/includes | -- | |||||||||
- | londes.js | -script | -Encryption Routines according to Data Encryption Standard DES, written in javascript | -- | ||||||
DIRECTORY -- /home/httpd/html/res/adm/pages | -- | |||||||||
- | *.gif | -graphic files | -icons used for the entire LON-CAPA user interface | -
-listing - + + + |
- ||||||
- | imgmaps.html | -interface file | -image maps for the LON-CAPA remote control | -- | ||||||
- | index.html | -interface file | -welcoming page to the LON-CAPA system upon login | -- | ||||||
- | menu.html | -interface file | -renders the HTML (including image maps) for the LON-CAPA remote control | -- |
just one line with the ip address of the server |