--- doc/loncapafiles/Attic/loncapafiles.html 2000/09/21 17:56:48 1.1 +++ doc/loncapafiles/Attic/loncapafiles.html 2000/11/09 18:29:58 1.24 @@ -1,20 +1,144 @@ - - 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" DEVCATEGORY="handler" 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: +

+

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

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Rolled in a RedHat 6.2 RPM, September 27, 2000 +

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

and, these files @@ -22,9 +146,20 @@ and, these files
  • 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------) +
  • are all ONLY under the read-write-execute privileges of user=www, +with different sets of permissions based on file type + - +
  • unless otherwise specified, lists are separated by newlines (and subelements are separated with colons ':') + +
    +

    2. File and Directory Table

    @@ -40,30 +175,37 @@ and, these files - - + + - + - - + + - + - - + + - + @@ -74,42 +216,48 @@ and, these files - - + + - - + + - - + - + - - - + + + - + offload session to if the LON-CAPA machine is overloaded + @@ -127,9 +275,45 @@ and, these files - - + + + + + + + + + + + + + + + @@ -140,7 +324,7 @@ and, these files - + @@ -148,21 +332,56 @@ and, these files - + - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -178,114 +397,170 @@ and, these files + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -297,16 +572,16 @@ and, these files - + - + - + - + @@ -374,14 +649,15 @@ and, these files - + - + @@ -415,7 +691,8 @@ and, these files - - + @@ -549,23 +832,37 @@ sutd.gif + + + + + + + + + + + + + + - + - + - + @@ -577,7 +874,9 @@ sutd.gif - - + - - + + + + + + + + + @@ -639,8 +945,10 @@ mmlextra.ent - - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Files & Directoriesconfigurable access.conf confdefine handlers, - set parametersconfigure machine - name, machine function, domain, server admindefine handlers, set parametersconfigure +
    + + + + + + + +
    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
    configurableconfigurable httpd.confconf static confmain server configuration file  
    configurableconfigurable srm.confconf static confname space configuration  
    configurable startup.pl static confset paths to modulesset paths to modules; invoked by access.conf  
    static filetypes.tab static confList of all machines - in the network with functionwww-readableDescriptive list of file extensions, and extension groupings 
    static roles.tab static confList of all machines - in the network with functionwww-readableList of privileges associated with users of multiple types (for example: Teaching Assistant, Exam Proctor, Course Coordinator) 
    static rolesplain.tab static confList of all machines + Descriptive list of abbreviations used in roles.tab for user types and privileges available in the network with functionwww-readable 
    staticconfigurable hosts.tabstatic confList of all machines - in the network with functionwww-readableconfList of all machines in the LON-CAPA network. Relates lonHostID to lonDefDomain and IP address 
    configurable spare.tab conf Spare hosts to - offload session to if this machine overloadedconfigure, - www-readable +configure
    + + + +
    +list elements are separated by newlines +
    +each list element consists of only one value; the value for lonHostID in access.conf +
    +
    staticconfigurable krb.conf confwhich Kerberos - server to contact for which Kerberos domainsconfigurewhich Kerberos server to contact for which Kerberos domainsconfigure
    + + + +
    +list elements are separated by newlines +
    +each list element consists of only two subelements separated by a colon +
    +
      +
    • Kerberos domain value +
    • Kerberos server IP address +
    +
    +
    configurablesmb.confconfconfiguration file to make LON-CAPA server file space accessible to network neighborhoodconfigure
    +
    configurablentp.confconfwhich NTP server to contact for information (XNTP3 standard)configure
    + + + +
    +only one line needs to be changed to specify a server ip address +
    +Example:
    server ntp.msu.edu +
    +
    directory DIRECTORY -- /home/httpd/perllonc script proxy serverwww-executable 
    scriptscript remote command interpreterwww-executable 
    script loncron script housekeepingwww-executable 
    script lonsql scripthousekeepingwww-executablemaintain secondary database of metadata 
    setuidlcpasswdsetuid scriptcoordinates the system services and files in order to allow lond to change user passwords 
    setuidlcuseraddsetuid scriptcoordinates the system services and files in order to allow lond to add a new user 
    setuidlcpasswdsetuid scriptcoordinates the system services and files in order to allow lond to add a new user 
    setuidlcnfsonsetuid scriptcoordinates the system services and files in order to allow lond to enable NFS for a user 
    setuidlcnfsoffsetuid scriptcoordinates the system services and files in order to allow lond to enable NFS for a user 
    empty directory EMPTY DIRECTORY -- /home/httpd/perl/logs
    handler.giflonmenu.pmhandlerHas routines which control the remote control. 
    handler.giflonpageflip.pmhandlerDeals with forward, backward, and other page flips. 
    handler.giflonratedt.pmhandlerBuilds up frame set and loads in the right thing. 
    handler.gifadmannotations.pmhandlerThis will take annotations and then plug them into a page 
    handler.gifadmbookmarks.pmhandlerThis will take bookmarks and get/write/display them for the LON-CAPA user interface 
    handler.giflonratsrv.pmhandlerHandler 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.) 
    handler.giflonpage.pmhandlerbundles pages into one page 
    handler.giflonuserstate.pmhandlercompile course into binary data structure (in loncom/rat) 
    handler.giflontex.pmhandlerHandler for tex files (somewhere in loncom/modules) 
    handler.giflontexconvert.pmhandlerAccess to tth/ttm 
    handler.gif lonxml.pm handleraccess to - resXML Parsing Module  
    handler.gif style.pm handleraccess to - resStyle Parsing Module  
    handler.gif londefdef.pm handleraccess to - resTags Default Definition Module  
    handler.gif run.pm handleraccess to - resused to prevent poorly written problems from causing lingering after effects  
    handler.gif scripttag.pm handleraccess to - resimplements <script>, <scriptlib>, <parserlib>, and <import>  
    handler.gif lonhomework.pm handleraccess to - reshandles requests for output, evaluation, and alteration of homework resource  
    handler.gif inputtags.pm handleraccess to - resproduces HTML input tags (<INPUT>) for rendering homework resources  
    handler.gif structuretags.pm handleraccess to - resproduces HTML tags necessary for structuring the presentation of homework resourcese  
    handler.gif response.pm handleraccess to - resdefines different types of responses given to student as well as syntax for producing response values  
    handler.gif caparesponse.pm handleraccess to - reshandles request to the CAPA homework processing engine  
    handler.gif lonacc.pm handleraccess to - resaccess to for a LON-CAPA user session  
    handler.gif lonracc.pm handleraccess to - rawaccess handler for file transfers  
    handler.gif loncacc.pm handleraccess to - construction spaceaccess to construction area  
    handler.gif lonauth.pm handlerauthenticate, - set up session environmentauthenticate, set up session environment  
    handler.giflonrep.pmlonlogout.pm handlerreplicationlogout  
    handler.giflonproblem.pmlonrep.pm handlerassessmentsreplication  
    interface file notfound.html interface filestatic html pagesstatic html page that is shown when an attempt is made to access a document not present on the web server  
    interface file unauthorized.html interface filestatic html pagesstatic 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 +810,13 @@ sutd.gif     		*.gif graphic files logosliteani.gif, logo.gif, logos.gif +listing
    + +liteani.gif +logo.gif +logos.gif +
    empty directory EMPTY DIRECTORY -- /home/httpd/lonUsers
    system filetth.pmsystem fileperl module for invoking functions specific to Tex-to-HTML conversion 
    system filetth.sosystem fileshared library file for dynamic loading and unloading 
    system file capa.pm system file perl module for invoking functions specific to CAPA  
    system file capa.bs system file bootstrap file associated with dynamic loading of this module on multiple architectures  
    system file 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 +924,17 @@ mmlextra.ent     		 
    graphic fileinterface file londes.jsscript interface fileEncryption Routines according to Data Encryption Standard DES, written in javascript 
    handlerdefault_homework.lcpmhandlerused by lonxml::xmlparse() as input variable $safeinit to Apache::run::run()  
    graphic file *.gif graphic fileslogos + icons used for the entire LON-CAPA user interface +listing
    + a.gif b.gif c.gif @@ -693,23 +1001,197 @@ z.gif     		interface file imgmaps.html interface file image maps for the LON-CAPA remote control  
    interface file index.html interface file welcoming page to the LON-CAPA system upon login  
    interface file menu.html interface file renders the HTML (including image maps) for the LON-CAPA remote control  
    directory DIRECTORY -- /home/httpd/html/res/adm/pages/bookmarkmenu 
    graphic file*.gifgraphic filesicons 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 +
    interface file*.htmlinterface fileassociated 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 +
    interface filebookmarklib.jsinterface filejavascript for handling client-side interactions with bookmark interface 
    empty directory EMPTY DIRECTORY -- /home/httpd/html/res/adm/pages/annotations 
    directory DIRECTORY -- /usr/sbin 
    script fileloncapaverifypackagesscriptchecks the system RPMs against what install.lon-capa.org specifies 
    script fileloncapaverifybasepackagescriptchecks the important base LON-CAPA files against what install.lon-capa.org specifies 
    script fileloncaparestoreconfigurationsscriptrestores .rpmsave files after a LON-CAPA-base upgrade 
    script fileloncapaautoupgradescriptdoes all the things to coordinate updating of LON-CAPA base files. Should be used with caution so that you do not lose work. 
    script fileloncapaverifyscriptmakes verification report using loncapaverifypackages and loncapaverifybasepackage 
    directory DIRECTORY -- /etc/cron.d 
    staticloncapastatic conffile that specifies periodic processes to run for the LON-CAPA machine 
    directory DIRECTORY -- /etc/ntp 
    configurablestep-tickersconffile that stimulates running of ntpdate upon init.d/xntpd initiationconfigure + + +
    just one line with the ip address of the server
    +
    directory DIRECTORY -- /etc/rc.d/init.d 
    root scriptloncontrolroot scriptsystem 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 DIRECTORY -- /etc/atalk 
    configurableconfigconfconfiguration file to make LON-CAPA server file space accessible to Appleshares access (Macintosh)configure
    +