--- doc/loncapafiles/Attic/loncapafiles.html 2000/09/24 01:08:06 1.2 +++ doc/loncapafiles/Attic/loncapafiles.html 2000/11/10 17:45:47 1.25 @@ -1,14 +1,1225 @@
- -+
+ +
+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 | @@ -101,9 +1322,9 @@ and, these files|||||||||
+ | hosts.tab | -static conf | +conf | List of all machines in the LON-CAPA network. Relates lonHostID to lonDefDomain and IP address | krb.conf | conf | -which Kerberos - server to contact for which Kerberos domains | +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 | @@ -192,6 +1435,41 @@ each list element consists of only two smaintain 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 | @@ -206,6 +1484,76 @@ each list element consists of only two s||||||||
+ | 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 | @@ -229,14 +1577,14 @@ each list element consists of only two srun.pm | handler | -evaluates expression within a memory-safe environment (to protect system from break-in attempts) | +used to prevent poorly written problems from causing lingering after effects | |||
scripttag.pm | handler | -parse and evaluate contents of values within a <script> tag (this module invokes run.pm) | +implements <script>, <scriptlib>, <parserlib>, and <import> | ||||||
- | lonrep.pm | +lonlogout.pm | handler | -replication | +logout | ||||
- | lonproblem.pm | +lonrep.pm | handler | -assessments | +replication | ||||
+ | 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 | @@ -649,12 +2011,19 @@ 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() | ++ | |||||
DIRECTORY -- /home/httpd/html/res/adm/pages | @@ -736,6 +2105,180 @@ z.gif | 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 + |