--- doc/loncapafiles/Attic/loncapafiles.html 2000/09/21 17:56:48 1.1 +++ doc/loncapafiles/Attic/loncapafiles.html 2000/11/10 17:45:47 1.25 @@ -1,20 +1,1231 @@
- -+
+ +
+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. +
+lonHostID | LON-internal HostID of this machine |
lonRole | Role of this machine: library, access |
lonAdmEMail | Server Administration |
lonDefDomain | Default domain |
lonLoadLim | Load Limit ( 100% loadavg ) |
lonExpire | Expiration for local copies in seconds |
+list elements are separated by newlines + |
+each list element consists of only one value; the value for lonHostID in access.conf + |
+list elements are separated by newlines + |
+each list element consists of only two subelements separated by a colon
+ +
|
+only one line needs to be changed to specify a server ip address + |
+Example: |
just one line with the ip address of the server |
+/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 ++
+
++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 | @@ -40,30 +1262,37 @@ and, these filesaccess.conf | conf | -define handlers, - set parameters | -configure machine - name, machine function, domain, server admin | +define handlers, set parameters | +configure
+ +
| ||||||||||||||
+ | httpd.conf | -conf | -+ | static conf | +main server configuration file | |||||||||||||||
+ | srm.conf | -conf | -+ | static conf | +name space configuration | |||||||||||||||
startup.pl | static conf | -set paths to modules | +set paths to modules; invoked by access.conf | |||||||||||||||||
filetypes.tab | static conf | -List of all machines - in the network with function | -www-readable | +Descriptive list of file extensions, and extension groupings | +||||||||||||||||
roles.tab | static conf | -List of all machines - in the network with function | -www-readable | +List of privileges associated with users of multiple types (for example: Teaching Assistant, Exam Proctor, Course Coordinator) | +||||||||||||||||
rolesplain.tab | static conf | -List of all machines + | Descriptive list of abbreviations used in roles.tab for user types and privileges available in the network with function | -www-readable | +||||||||||||||||
+ | hosts.tab | -static conf | -List of all machines - in the network with function | -www-readable | +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 this machine overloaded | -configure, - www-readable | + offload session to if the LON-CAPA machine is overloaded +
+configure +
|
||||||||||||||||
@@ -127,9 +1362,45 @@ and, these files | krb.conf | conf | -which Kerberos - server to contact for which Kerberos domains | -configure | +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 | @@ -140,7 +1411,7 @@ and, these fileslonc | script | proxy server | -www-executable | +||||||||||||||||
@@ -148,21 +1419,56 @@ and, these files | script | remote command interpreter | -www-executable | +|||||||||||||||||
loncron | script | housekeeping | -www-executable | +|||||||||||||||||
lonsql | script | -housekeeping | -www-executable | +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 | @@ -178,114 +1484,170 @@ and, these files||||||||||||||||||||
+ | 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 | -access to - res | +XML Parsing Module | |||||||||||||||||
style.pm | handler | -access to - res | +Style Parsing Module | |||||||||||||||||
londefdef.pm | handler | -access to - res | +Tags Default Definition Module | |||||||||||||||||
run.pm | handler | -access to - res | +used to prevent poorly written problems from causing lingering after effects | |||||||||||||||||
scripttag.pm | handler | -access to - res | +implements <script>, <scriptlib>, <parserlib>, and <import> | |||||||||||||||||
lonhomework.pm | handler | -access to - res | +handles requests for output, evaluation, and alteration of homework resource | |||||||||||||||||
inputtags.pm | handler | -access to - res | +produces HTML input tags (<INPUT>) for rendering homework resources | |||||||||||||||||
structuretags.pm | handler | -access to - res | +produces HTML tags necessary for structuring the presentation of homework resourcese | |||||||||||||||||
response.pm | handler | -access to - res | +defines different types of responses given to student as well as syntax for producing response values | |||||||||||||||||
caparesponse.pm | handler | -access to - res | +handles request to the CAPA homework processing engine | |||||||||||||||||
lonacc.pm | handler | -access to - res | +access to for a LON-CAPA user session | |||||||||||||||||
lonracc.pm | handler | -access to - raw | +access handler for file transfers | |||||||||||||||||
loncacc.pm | handler | -access to - construction space | +access to construction area | |||||||||||||||||
lonauth.pm | handler | -authenticate, - set up session environment | +authenticate, set up session environment | |||||||||||||||||
- | lonrep.pm | +lonlogout.pm | handler | -replication | +logout | |||||||||||||||
- | lonproblem.pm | +lonrep.pm | handler | -assessments | +replication | |||||||||||||||
notfound.html | interface file | -static html pages | +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 pages | +static html page that is shown when an attempt is made to access a document which is restricted based on +file or server configurations | |||||||||||||||||
graphic files | images for rat | -+ | listing + 1.1.dt.gif 1.1.empty.gif 1.1.ld.gif @@ -533,7 +1897,13 @@ sutd.gif | *.gif | graphic files | logos | -liteani.gif, logo.gif, logos.gif | +
+listing + +liteani.gif +logo.gif +logos.gif + |
||||||||||||
EMPTY DIRECTORY -- /home/httpd/lonUsers | @@ -549,23 +1919,37 @@ sutd.gif||||||||||||||||||||
+ | 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 | |||||||||||||||||
*.ent | static conf | entity files | -+ |
+listing + isoamsa.ent isoamsb.ent isoamsc.ent @@ -625,10 +2011,17 @@ mmlextra.ent | ||||||||||||||||
+ | londes.js | -script | -+ | 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() | |||||||||||||||||
*.gif | graphic files | -logos | -+ | icons used for the entire LON-CAPA user interface | +
+listing + a.gif b.gif c.gif @@ -693,23 +2088,197 @@ z.gif | 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 + +button_close.gif +button_edit.gif +button_preview.gif +folder_closed.gif +folder_closed_pressed.gif +folder_new.gif +folder_opened.gif +folder_opened_pressed.gif +folder_pointer_closed.gif +folder_pointer_opened.gif +folder_spacer.gif +folder_trash.gif +left_bar.gif +line_l_shape.gif +line_side_T.gif +line_vertical.gif +link.gif +link_pressed.gif +ll_corner.gif +lower_bar.gif +lr_corner.gif +right_bar.gif +toolbar_bg.gif +ul_corner.gif +upper_bar.gif +ur_corner.gif + |
+ ||||||||||||||||
+ | *.html | +interface file | +associated with the frameset scheme of displaying bookmarks | ++aaloader.html +annotator_bb.html +annotator_left.html +annotator_ll.html +annotator_lr.html +annotator_right.html +annotator_toolbar.html +annotator_ul.html +annotator_ur.html +annotator_uu.html +bookmarkpal.html +bookmarkpal_old.html +bookmarkpal_v2.html +bookmarkpal_v2_backup.html +index.html +loading_bookmarks.html + | +||||||||||||||||
+ | 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 + |