--- doc/loncapafiles/Attic/loncapafiles.html 2000/11/09 18:29:58 1.24 +++ doc/loncapafiles/Attic/loncapafiles.html 2001/03/06 14:47:48 1.69 @@ -27,7 +27,7 @@ The format of these tags is:
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" DEVCATEGORY="handler" CATEGORY="handler">
+
<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.">
@@ -48,6 +48,50 @@ The NAME tags associated with TYPE=RPM a
+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 @@ -60,6 +104,33 @@ you can just view the internal tags of t 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.
+-
--Name : LON-CAPA-base Relocations: (not relocateable) -Version : 3.1 Vendor: Laboratory for Instructional Technology Education, - Division of Science and Mathematics Education, - Michigan State University. -Release : 1 Build Date: Wed Sep 27 13:56:46 2000 -Install date: (not installed) Build Host: spock.lite.msu.edu -Group : Utilities/System Source RPM: LON-CAPA-base-3.1-1.src.rpm -Size : 3650773 License: GNU General Public License. Version 2, June 1991. - Michigan State University patents may apply. -Summary : Basic system files for running a LON-CAPA server. -Description : -This package facilitates a base installation of LON-CAPA files in their directories. -The files in this package are only those directly associated with the network communication -layer established through direct server-to-server communications (via lond and lonc); plus -those which configure (but otherwise not constitute) external software packages like Apache -and Athena-Kerberos. For more on the LON-CAPA project, visit http://www.lon-capa.org/. -- |
-Note: these files only refer to -
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 | -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 | -
+
+
+ +This file configures the "name space" of the Apache web server. +srm.conf +defines when specific perl modules should be called to handle a given +request. This definition is a function of both the name of the perl module, +and a specific regular expression associated with the URL, such as +"^/res/.*\.page". + ++Here is an example entry: + +<LocationMatch "^/res/.*\.page$> +SetHandler perl-script +PerlHandler Apache::lonpage +</LocationMatch> ++ +
|
- ||||||
- | 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 + + +
|
- ||||||
- | smb.conf | -conf | -configuration file to make LON-CAPA server file space accessible to network neighborhood | -configure - | ||||||
- | ntp.conf | -conf | -which NTP server to contact for information (XNTP3 standard) | -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 | -- | ||||||
- | lcpasswd | -setuid script | -coordinates the system services and files in order to allow lond to change user passwords | -- | ||||||
- | lcuseradd | -setuid script | -coordinates the system services and files in order to allow lond to add a new user | -- | ||||||
- | lcpasswd | -setuid script | -coordinates the system services and files in order to allow lond to add a new user | -- | ||||||
- | lcnfson | -setuid script | -coordinates the system services and files in order to allow lond to enable NFS for a user | -- | ||||||
- | lcnfsoff | -setuid script | -coordinates the system services and files in order to allow lond to enable NFS for a user | -- | ||||||
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 | -|||||||||
- | lonmenu.pm | -handler | -Has routines which control the remote control. | -- | ||||||
- | lonpageflip.pm | -handler | -Deals with forward, backward, and other page flips. | -- | ||||||
- | lonratedt.pm | -handler | -Builds up frame set and loads in the right thing. | -- | ||||||
- | admannotations.pm | -handler | -This will take annotations and then plug them into a page | -- | ||||||
- | admbookmarks.pm | -handler | -This will take bookmarks and get/write/display them for the LON-CAPA user interface | -- | ||||||
- | lonratsrv.pm | -handler | -Handler tat takes output from RAT and stores it on disk. Handles the upper hidden frame of the added window that comes up in RAT. (3 frames come up in RAT server, code, and output. This module handles server connection.) | -- | ||||||
- | lonpage.pm | -handler | -bundles pages into one page | -- | ||||||
- | lonuserstate.pm | -handler | -compile course into binary data structure (in loncom/rat) | -- | ||||||
- | lontex.pm | -handler | -Handler for tex files (somewhere in loncom/modules) | -- | ||||||
- | lontexconvert.pm | -handler | -Access to tth/ttm | -- | ||||||
- | lonxml.pm | -handler | -XML Parsing Module | -- | ||||||
- | style.pm | -handler | -Style Parsing Module | -- | ||||||
- | londefdef.pm | -handler | -Tags Default Definition Module | -- | ||||||
- | run.pm | -handler | -used to prevent poorly written problems from causing lingering after effects | -- | ||||||
- | scripttag.pm | -handler | -implements <script>, <scriptlib>, <parserlib>, and <import> | -- | ||||||
- | 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 | -- | ||||||
- | lonlogout.pm | -handler | -logout | -- | ||||||
- | lonrep.pm | -handler | -replication | -- | ||||||
- | 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 | -- | |||||||||
- | tth.pm | -system file | -perl module for invoking functions specific to Tex-to-HTML conversion | -- | ||||||
- | tth.so | -system file | -shared library file for dynamic loading and unloading | -- | ||||||
- | 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 | -interface file | -Encryption Routines according to Data Encryption Standard DES, written in javascript | -- | ||||||
- | default_homework.lcpm | -handler | -used by lonxml::xmlparse() as input variable $safeinit to Apache::run::run() | -- | ||||||
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 | -- | ||||||
DIRECTORY -- /home/httpd/html/res/adm/pages/bookmarkmenu | -- | |||||||||
- | *.gif | -graphic files | -icons used for the bookmark portion of the LON-CAPA user interface | -
-listing - + + + |
- ||||||
- | *.html | -interface file | -associated with the frameset scheme of displaying bookmarks | -
+
+
+ |
- ||||||
- | bookmarklib.js | -interface file | -javascript for handling client-side interactions with bookmark interface | -- | ||||||
EMPTY DIRECTORY -- /home/httpd/html/res/adm/pages/annotations | -- | |||||||||
DIRECTORY -- /usr/sbin | -- | |||||||||
- | loncapaverifypackages | -script | -checks the system RPMs against what install.lon-capa.org specifies | -- | ||||||
- | loncapaverifybasepackage | -script | -checks the important base LON-CAPA files against what install.lon-capa.org specifies | -- | ||||||
- | loncaparestoreconfigurations | -script | -restores .rpmsave files after a LON-CAPA-base upgrade | -- | ||||||
- | loncapaautoupgrade | -script | -does all the things to coordinate updating of LON-CAPA base files. Should be used with caution so that you do not lose work. | -- | ||||||
- | loncapaverify | -script | -makes verification report using loncapaverifypackages and loncapaverifybasepackage | -- | ||||||
DIRECTORY -- /etc/cron.d | -- | |||||||||
- | loncapa | -static conf | -file that specifies periodic processes to run for the LON-CAPA machine | -- | ||||||
DIRECTORY -- /etc/ntp | -- | |||||||||
- | step-tickers | -conf | -file that stimulates running of ntpdate upon init.d/xntpd initiation | -configure
+
+
+
|
- ||||||
DIRECTORY -- /etc/rc.d/init.d | -- | |||||||||
- | loncontrol | -root script | -system init and control handling for the LON-CAPA network | -
-multiple targets - - -/etc/rc.d/rc0.d/K05loncontrol -/etc/rc.d/rc1.d/K05loncontrol -/etc/rc.d/rc2.d/K05loncontrol -/etc/rc.d/rc3.d/S95loncontrol -/etc/rc.d/rc4.d/S95loncontrol -/etc/rc.d/rc5.d/S95loncontrol -/etc/rc.d/rc6.d/K05loncontrol -- |
- ||||||
DIRECTORY -- /etc/atalk | -- | |||||||||
- | config | -conf | -configuration file to make LON-CAPA server file space accessible to Appleshares access (Macintosh) | -configure - |