--- doc/loncapafiles/Attic/loncapafiles.html 2000/09/21 17:56:48 1.1 +++ doc/loncapafiles/Attic/loncapafiles.html 2000/12/08 23:19:23 1.28 @@ -1,421 +1,604 @@ - - Untitled Document + + LON-CAPA Files and Directories

LON-CAPA Files and Directories

-
Gerd Kortemeyer, Spring-Summer 2000
Scott Harrison, September 2000 +
Scott Harrison, October 2000 +
Scott Harrison, November 2000 +
Gerd Kortemeyer, Spring-Summer 2000 +

+

    +
  1. Contents and Structure of loncapafiles.html +
  2. Software Package Information +
+

+
+

1. Contents and Structure of this loncapafiles.html

+

+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."> +

-Note: these files only refer to +The NAME tags associated with TYPE=RPM are:

-and, these files +

+

+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. +

+
+

2. Software Package Information

+

+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. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +define handlers, set parameters + + +configure +
+ + + + + + + +
lonHostIDLON-internal HostID of this machine
lonRoleRole of this machine: library, access
lonAdmEMailServer Administration
lonDefDomainDefault domain
lonLoadLimLoad Limit ( 100% loadavg )
lonExpireExpiration for local copies in seconds
+
+
+ + + +main server configuration file + + + + + +name space configuration + + + + + +set paths to modules; invoked by access.conf + + + + + +Descriptive list of file extensions, and extension groupings + + + + + +List of privileges associated with users of multiple types (for example: Teaching +Assistant, Exam Proctor, Course Coordinator) + + + + + +Descriptive list of abbreviations used in roles.tab for user types +and privileges available in the network with function + + + + + +List of all machines in the LON-CAPA network. Relates lonHostID to +lonDefDomain and IP address + + + + + +Spare hosts to offload session to if the LON-CAPA machine is overloaded + + +configure
+ + + +
+list elements are separated by newlines +
+each list element consists of only one value; the value for lonHostID in access.conf +
+
+
+ + + +Basic auth password to access /lon-status and /server-status + + + + + +which Kerberos server to contact for which Kerberos domains + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + +image maps for the LON-CAPA remote control + + + + + +welcoming page to the LON-CAPA system upon login + + + + + +renders the HTML (including image maps) for the LON-CAPA remote control + + + + + +icons used for the bookmark portion of the LON-CAPA user interface + + +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 + + + + + +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 + + + + + +javascript for handling client-side interactions with bookmark interface + + + + + +checks the system RPMs against what install.lon-capa.org specifies + + + + + +checks the important base LON-CAPA files against what install.lon-capa.org specifies + + + + + +restores .rpmsave files after a LON-CAPA-base upgrade + + + + + +does all the things to coordinate updating of LON-CAPA base files. Should be used with +caution so that you do not lose work + + + + + +makes verification report using loncapaverifypackages and loncapaverifybasepackage + + + + + +file that specifies periodic processes to run for the LON-CAPA machine + + + + + +file that stimulates running of ntpdate upon init.d/xntpd initiation + + +
+list elements are separated by newlines +
+each list element consists of only two subelements separated by a colon +
    -
  • are all owned by user=www, group=users -
  • all represent their install-time configurations -(for instance, some directories start out as empty) -
  • are all ONLY under the read-write (and sometimes execute) privileges of user=www (-rwx------) +
  • Kerberos domain value +
  • Kerberos server IP address
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +
Files & DirectoriesTypeFunctionInstall
directory DIRECTORY -- /etc/httpd/conf 
configurableaccess.confconfdefine handlers, - set parametersconfigure machine - name, machine function, domain, server admin
configurablehttpd.confconf  
configurablesrm.confconf  
configurablestartup.plstatic confset paths to modules 
directory DIRECTORY -- /home/httpd/lonTabsLON-CAPA Tables
staticfiletypes.tabstatic confList of all machines - in the network with functionwww-readable
staticroles.tabstatic confList of all machines - in the network with functionwww-readable
staticrolesplain.tabstatic confList of all machines - in the network with functionwww-readable
statichosts.tabstatic confList of all machines - in the network with functionwww-readable
configurablespare.tabconfSpare hosts to - offload session to if this machine overloadedconfigure, - www-readable
statichtpasswdstatic confBasic auth - password to access /lon-status and /server-status 
directory DIRECTORY -- /etc 
configurablekrb.confconfwhich Kerberos - server to contact for which Kerberos domainsconfigure
directory DIRECTORY -- /home/httpd/perlCommunication
scriptloncscriptproxy serverwww-executable
scriptlondscriptremote command - interpreterwww-executable
scriptloncronscripthousekeepingwww-executable
scriptlonsqlscripthousekeepingwww-executable
empty directory EMPTY DIRECTORY -- /home/httpd/perl/logslogs and pids of lonc, lond and lonnet.pm
empty directory EMPTY DIRECTORY -- /home/httpd/perl/tmplogs and pids of lonc, lond and lonnet.pm
directory DIRECTORY -- /home/httpd/lib/perl/Apachehandlers
handler.giflonxml.pmhandleraccess to - res 
handler.gifstyle.pmhandleraccess to - res 
handler.giflondefdef.pmhandleraccess to - res 
handler.gifrun.pmhandleraccess to - res 
handler.gifscripttag.pmhandleraccess to - res 
handler.giflonhomework.pmhandleraccess to - res 
handler.gifinputtags.pmhandleraccess to - res 
handler.gifstructuretags.pmhandleraccess to - res 
handler.gifresponse.pmhandleraccess to - res 
handler.gifcaparesponse.pmhandleraccess to - res 
handler.giflonacc.pmhandleraccess to - res 
handler.giflonracc.pmhandleraccess to - raw 
handler.gifloncacc.pmhandleraccess to - construction space 
handler.giflonauth.pmhandlerauthenticate, - set up session environment 
handler.giflonlogin.pmhandlerlogin screen 
handler.giflonrep.pmhandlerreplication 
handler.giflonproblem.pmhandlerassessments 
handler.giflonroles.pmhandlerroles picking 
handler.giflonindexer.pmhandlercross server - filesystem browser 
handler.giflonnet.pmhandlerinterface - to lonc 
empty directory EMPTY DIRECTORY -- /home/httpd/lonIDscookie jar
empty directoryEMPTY DIRECTORY -- /home/httpd/socketslonc's sockets
empty directoryEMPTY DIRECTORY -- /home/httpd/sockets/delayedlonc's sockets
directory DIRECTORY -- /home/httpd/html  
interface fileindex.htmlinterface filebumps to login 
linkrawsymbolic linksymbolic link to /home/httpd/html/res 
emptydirectory EMPTY DIRECTORY -- /home/httpd/html/resroot of resource tree
directory DIRECTORY -- /home/httpd/html/admunauthenticated resources
interface filenotfound.htmlinterface filestatic html pages 
interface fileunauthorized.htmlinterface filestatic html pages 
directory DIRECTORY -- /home/httpd/html/adm/rathome of the rat
interface filerat.htmlinterface fileframeset 
interface filecode.htmlinterface filejavascript 
interface filemap.htmlinterface filebumper 
graphic file*.gifgraphic filesimages for - rat +
+ + + + + +configuration file to make LON-CAPA server file space accessible to network neighborhood + + +configure + + + + + +which NTP server to contact for information (XNTP3 standard) + + + + + +
+only one line needs to be changed to specify a server ip address +
+Example:
server ntp.msu.edu +
+
+
+ + + +proxy server + + + + + +remote command interpreter + + + + + +housekeeping + + + + + +maintain secondary database of metadata + + + + + +coordinates the system services and files in order to allow lond to change user passwords + + + + + +coordinates the system services and files in order to allow lond to add a new user + + + + + +coordinates the system services and files in order to allow lond to delete a user + + + + + +coordinates the system services and files in order to allow lond to enable NFS for a user + + + + + +coordinates the system services and files in order to allow lond to disable NFS for a user + + + + + +Has routines which control the remote control. + + + + + +Deals with forward, backward, and other page flips. + + + + + +Builds up frame set and loads in the right thing. + + + + + +This will take annotations and then plug them into a page + + + + + +This will take bookmarks and get/write/display them for the LON-CAPA user interface + + + + + +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.) + + + + + +bundles pages into one page + + + + + +compile course into binary data structure (in loncom/rat) + + + + + +Handler for tex files (somewhere in loncom/modules) + + + + + +Access to tth/ttm + + + + + +XML Parsing Module + + + + + +Style Parsing Module + + + + + +Tags Default Definition Module + + + + + +Tags Default Definition Module + + + + + +used to prevent poorly written problems from causing lingering after effects + + + + + +implements <script>, <scriptlib>, <parserlib>, and <import> + + + + + +handles requests for output, evaluation, and alteration of homework resource + + + + + +produces HTML input tags (<INPUT>) for rendering homework resources + + + + + +produces HTML tags necessary for structuring the presentation of homework resources + + + + + +defines different types of responses given to student as well as syntax for producing response values + + + + + +handles request to the CAPA homework processing engine + + + + + +access to for a LON-CAPA user session + + + + + +access handler for file transfers + + + + + +access to construction area + + + + + +authenticate, set up session environment + + + + + +login screen + + + + + +logout + + + + + +replication + + + + + +roles picking + + + + + +cross server filesystem browser + + + + + +interface to lonc + + + + + +bumps to login + + + + + +symbolic link to /home/httpd/html/res + + + + + +static html page that is shown when an attempt is made to access a document not present on the web server + + + + + +static html page that is shown when an attempt is made to access a document which is restricted based on +file or server configurations + + + + + +frameset + + + + + +javascript + + + + + +bumper + + + + + +graphic files + + 1.1.dt.gif 1.1.empty.gif 1.1.ld.gif @@ -521,63 +704,49 @@ start.gif std.gif stdl.gif sutd.gif - -
directory DIRECTORY -- /home/httpd/html/adm/lonIcons 
graphic file*.gifgraphic fileslogosliteani.gif, logo.gif, logos.gif
empty directory EMPTY DIRECTORY -- /home/httpd/lonUsershome dirs of local users
emptydirectory EMPTY DIRECTORY -- /home/httpd/html/lon-statusstatus reports
directory DIRECTORY -- /usr/lib/perl5/site_perl/5.005 
system filecapa.pmsystem file  
system filecapa.bssystem file  
system filecapa.sosystem file  
directory DIRECTORY -- /home/httpd/html/adm/MathML 
system file*.entstatic confentity files + + + + + +logos + + +liteani.gif +logo.gif +logos.gif + + + + + +perl module for invoking functions specific to Tex-to-HTML conversion + + + + + +perl module for invoking functions specific to CAPA + + + + + +bootstrap file associated with dynamic loading of this module on multiple architectures + + + + + +shared library file for dynamic loading and unloading + + + + + +entity files + + isoamsa.ent isoamsb.ent isoamsc.ent @@ -603,44 +772,38 @@ isotech.ent mathml.dtd mmlalias.ent mmlextra.ent - -
system filemathml.cssstatic confcascading style sheet 
system filemathml.dtdstatic confdocument type definition 
directory DIRECTORY -- /home/httpd/html/res/adm/includes 
graphic filelondes.jsscript  
directory DIRECTORY -- /home/httpd/html/res/adm/pages 
graphic file*.gifgraphic fileslogos + + + + + +cascading style sheet + + + + + +document type definition + + + + + +Encryption Routines according to Data Encryption Standard DES, written in javascript + + + + + +used by lonxml::xmlparse() as input variable $safeinit to Apache::run::run() + + + + + +icons used for the entire LON-CAPA user interface + + a.gif b.gif c.gif @@ -687,29 +850,156 @@ w.gif x.gif y.gif z.gif -
interface fileimgmaps.htmlinterface file  
interface fileindex.htmlinterface file  
interface filemenu.htmlinterface file  
+
just one line with the ip address of the server
+
+
+ + + + + + + + + + +system init and control handling for the LON-CAPA network + + + + + +configuration file to make LON-CAPA server file space accessible to Appleshares access (Macintosh) + +