/ /home/user/loncapa/ 0444root:root 0644www:www 6755root:root 6755root:root 0444root:root 0600www:www 0444root:root 0444root:root 0644root:root 0644root:root 0700www:www 0500www:www 0444root:root 0400www:www 0644root:root 0644root:root 0700root:root 0700root:root root:root root:root 0755root:root 0755root:root 0700www:www 0755www:www 0500www:www 0700www:www Basic files for running a LON-CAPA server. LON-CAPA-base 3.1 1 Laboratory for Instructional Technology Education, Division of Science and Mathematics Education, Michigan State University. /home/harris41/LON-CAPA-BuildRoot GNU General Public License. Version 2, June 1991. Michigan State University patents may apply. Utilities/System LON-CAPA-base-3.1.tar.gz no This package facilitates a base installation of LON-CAPA files in their directories.\nThe files in this package are only those directly associated with the network communication\nlayer established through direct server-to-server communications (via lond and lonc); plus\nthose which configure (but otherwise not constitute) external software packages like Apache\nand Athena-Kerberos. For more on the LON-CAPA project, visit http://www.lon-capa.org/. echo '***********************************************************************'\necho 'LON-CAPA LearningOnline with CAPA'\necho 'http://www.lon-capa.org/'\necho 'Gerd Kortemeyer, et al'\necho 'Laboratory for Instructional Technology Education'\necho 'Michigan State University'\necho 'General Public License, Version 2, June 1991'\necho '** Michigan State University patents may apply **'\necho ' '\necho 'This installation assumes an installation of Redhat 6.2'\necho ' '\necho 'The server computer should be currently connected to the ethernet'\necho ' '\necho 'The files in this package are only those directly associated with the network communication'\necho 'layer established through direct server-to-server communications (via lond and lonc); plus'\necho 'those which configure (but otherwise not constitute) external software packages like Apache'\necho 'and Athena-Kerberos.'\necho '***********************************************************************'\n etc/httpd/conf standard web configuration files home/httpd/lonTabs standard tab-formatted reference files home/httpd standard start of the web server tree etc standard standard linux directory for configuration files home/httpd/perl standard perl scripts for managing the LON-CAPA system home/httpd/perl/logs server standard location where system performance and error logs are kept home/httpd/perl/tmp server standard location where temporary files (for caching) are stored home/httpd/lib/perl/Apache server readonly location of LON-CAPA web mod-perl handlers home/httpd/lonIDs server standard cookie jar home/httpd/sockets server standard lonc's sockets home/httpd/sockets/delayed server standard lonc's sockets (delayed) home/httpd/html server standard location of web-accessible file tree home/httpd/html/res server standard root of resource tree home/httpd/html/adm server readonly unauthenticated resources home/httpd/html/adm/rat server readonly home of the rat home/httpd/html/adm/lonIcons server readonly graphic widgets home/httpd/html/adm/lonMisc server readonly home/httpd/html/adm/lonKaputt server readonly error warnings and icons home/httpd/lonUsers server standard
Home directories of local users. There is a five-tier structure to the directories: [domain]/[firstletter]/[secondletter]/[thirdletter]/[userid]. For example, a user fredflint at MSU would have his information located in lonUsers/msu/f/r/e/fredflint.

Within this directory there are a variety of files which govern the scope of what a user can do within the LON-CAPA system. A passwd file determines the type of authentication mechanism to use. There is also are files such as roles.hist (and its database compilation, roles.db) which specify the roles and privileges for a user in the LON-CAPA system. home/httpd/html/lon-status server standard status reports usr/lib/perl5/site_perl/5.005 standard system perl tree (usually present on linux systems) home/httpd/html/adm/MathML server readonly mathematics markup language resources home/httpd/html/res/adm/includes server readonly files useful for including within customized scripting home/httpd/html/lon-status server standard status reports home/httpd/html/res/adm/pages server readonly web user interface resources home/httpd/html/res/adm/pages/bookmarkmenu server readonly bookmark user interface code home/httpd/html/res/adm/pages/annotations server readonly usr/sbin standard standard linux directory for superuser executables etc/cron.d standard standard linux directory for running time-based "jobs" etc/ntp standard configuration directory for network time protocol etc/rc.d/init.d standard scripts that run during system startup etc/rc.d/rc0.d standard scripts that run for run-level 0 etc/rc.d/rc1.d standard scripts that run for run-level 1 etc/rc.d/rc2.d standard scripts that run for run-level 2 etc/rc.d/rc3.d standard scripts that run for run-level 3 etc/rc.d/rc4.d standard scripts that run for run-level 4 etc/rc.d/rc5.d standard scripts that run for run-level 5 etc/rc.d/rc6.d standard scripts that run for run-level 6 etc/rc.d/rc7.d standard scripts that run for run-level 7 etc/atalk standard appletalk configuration files home/httpd/html/res/adm/pages/indexericons server readonly icons that help depict the file system loncom/access.conf etc/httpd/conf/access.conf conf This file has two major functions. For the Apache web server, it defines a global access configuration which defines what server options (Indexes", "Includes", "FollowSymLinks", "ExecCGI", or "MultiViews") are associated with specific directories ("/", "/home/httpd/html", "/home/httpd/cgi-bin", and "/usr/doc"). For the LON-CAPA network server and perl module handlers, it defines machine specific settings (lonHostID, lonRole, lonAdmEMail, lonDefDomain, lonLoadLim, lonExpire, and lonReceipt) and internal machine settings for specific directories, socket ports, and browser detection logic. 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
 loncom/httpd.conf etc/httpd/conf/httpd.conf static conf This is the main server configuration file. The settings here are more or less standard for the Apache web server. Most notably (and importantly!), perl handling and mod_perl are enabled in this configuration file. loncom/srm.conf etc/httpd/conf/srm.conf static conf

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>

loncom/startup.pl etc/httpd/conf/startup.pl static conf This file provides initializations for perl handlers. It adjusts what the module path space is (so as to include /home/httpd/lib/perl/Apache) as well as causing the Apache module to be used for every perl handler. startup.pl is invoked by access.conf. loncom/interface/filetypes.tab home/httpd/lonTabs/filetypes.tab static conf Descriptive list of file extensions, and extension groupings. loncom/homework/insertlist.tab home/httpd/lonTabs/insertlist.tab static conf Describes what tags are allowed inside other tags. loncom/interface/default.assesscalc home/httpd/html/res/adm/includes/default.assesscalc static conf Default spreadsheet for individual assessment. loncom/interface/default.studentcalc home/httpd/html/res/adm/includes/default.studentcalc static conf Default spreadsheet for assessment of students. loncom/auth/roles.tab home/httpd/lonTabs/roles.tab static conf List of privileges associated with users of multiple types (for example: Teaching Assistant, Exam Proctor, Course Coordinator) loncom/auth/rolesplain.tab home/httpd/lonTabs/rolesplain.tab static conf Descriptive list of abbreviations used in roles.tab for user types and privileges available in the network with function loncom/hosts.tab home/httpd/lonTabs/hosts.tab conf List of all machines in the LON-CAPA network. Relates lonHostID to lonDefDomain and IP address loncom/spare.tab home/httpd/lonTabs/spare.tab conf 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
loncom/htpasswd home/httpd/lonTabs/htpasswd conf Basic auth password to access /lon-status and /server-status loncom/krb.conf etc/krb.conf which Kerberos server to contact for which Kerberos domains
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
 loncom/smb.conf etc/smb.conf conf configuration file to make LON-CAPA server file space accessible to network neighborhood loncom/ntp.conf etc/ntp.conf conf 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
loncom/metadata_database/searchcat.pl home/httpd/perl/searchcat.pl script Batch script for updating SQL metadata database. loncom/lonc home/httpd/perl/lonc script proxy server loncom/lond home/httpd/perl/lond script This is a remote command interpreter on a TCP LON-CAPA network layer. It accepts and processes incoming requests from other LON-CAPA machines on the network. lond's functionality is self-contained in the sense that it does not reference (import, require, use) any other file described in this document. There are only 15 subroutines in this script, however the make_new_child subroutine is quite complex since it parses and responds about 29 different types of network requests (i.e. enc, ping, pong, ekey, load, auth, passwd, makeuser, home, update, unsub, sub, log, put, rolesput, get, eget, del, keys, dump, store, restore, querysend, queryreply, idput, idget, tmpput, tmpget, and ls). loncom/loncron home/httpd/perl/loncron script housekeeping loncom/lonsql home/httpd/perl/lonsql script maintain secondary database of metadata loncom/lcpasswd home/httpd/perl/lcpasswd setuid script coordinates the system services and files in order to allow lond to change user passwords loncom/lcuseradd home/httpd/perl/lcuseradd setuid script coordinates the system services and files in order to allow lond to add a new user loncom/lcuserdel home/httpd/perl/lcuserdel setuid script coordinates the system services and files in order to allow lond to delete a user loncom/lcnfson home/httpd/perl/lcnfson setuid script coordinates the system services and files in order to allow lond to enable NFS for a user loncom/lcnfsoff home/httpd/perl/lcnfsoff setuid script coordinates the system services and files in order to allow lond to disable NFS for a user loncom/publisher/publisher.html home/httpd/html/adm/publisher.html interface file HTML frame that presents a form element to allow for the publishing of resources, directories and underlying subdirectories. loncom/homework/lectureonline.sty home/httpd/html/res/adm/includes/lectureonline.sty static conf The relevant conditions and metadata to attach to LectureOnline-specific tags. loncom/misc/un_keyword.tab home/httpd/html/res/adm/includes/un_keyword.tab conf File which contains words which should not be keywords used to specify resource content. loncom/publisher/copyright.tab home/httpd/html/res/adm/includes/copyright.tab conf Table which contains list of copyright possibilities for educational resources. loncom/publisher/language.tab home/httpd/lonTabs/language.tab static conf Table which contains string abbreviations of language::font rendering combinations. loncom/publisher/addid.tab home/httpd/lonTabs/addid.tab static conf Table which has hash data necessary for distinguishing IDs from indices. loncom/interface/lonstatistics.pm home/httpd/lib/perl/Apache/lonstatistics.pm handler Handler to show statistics on solving LON-CAPA problems. works/unverified loncom/publisher/londiff.pm home/httpd/lib/perl/Apache/londiff.pm handler Handler to show difference between two files. works/unverified loncom/publisher/lonupload.pm home/httpd/lib/perl/Apache/lonupload.pm handler Handler to upload files through browser into construction space. works/unverified loncom/homework/essayresponse.pm home/httpd/lib/perl/Apache/essayresponse.pm handler Handler to evaluate essay (ungraded) style responses. works/unverified loncom/publisher/lonpubdir.pm home/httpd/lib/perl/Apache/lonpubdir.pm handler Handler to publish directories. loncom/publisher/lonretrieve.pm home/httpd/lib/perl/Apache/lonretrieve.pm handler Handler to retrieve old versions from resource space. works/unverified loncom/homework/edit.pm home/httpd/lib/perl/Apache/edit.pm handler Helper functions when in homework edit mode. loncom/interface/lonmeta.pm home/httpd/lib/perl/Apache/lonmeta.pm handler Metadata display handler. works/unverified rat/lonambiguous.pm home/httpd/lib/perl/Apache/lonambiguous.pm handler Handler to resolve ambiguous file locations. works/unverified rat/lonratparms.pm home/httpd/lib/perl/Apache/lonratparms.pm handler Handler to set resource parameters inside of the RAT based on metadata. works/unverified rat/lonsequence.pm home/httpd/lib/perl/Apache/lonsequence.pm handler Handler for showing sequence objects of educational resources. works/unverified loncom/interface/loncreatecourse.pm home/httpd/lib/perl/Apache/loncreatecourse.pm handler Creates a new course and assigns course coordinator. loncom/interface/loncreateuser.pm home/httpd/lib/perl/Apache/loncreateuser.pm handler Creates a new user and/or changes user privileges works/unverified loncom/interface/lonchart.pm home/httpd/lib/perl/Apache/lonchart.pm handler Produces simple LectureOnline-like student assessment performance chart loncom/interface/loncommon.pm home/httpd/lib/perl/Apache/loncommon.pm handler Makes a table out of the previous attempts. Inputs result_from_symbread, user, domain, home_server, course_id works/unverified loncom/homework/grades.pm home/httpd/lib/perl/Apache/grades.pm handler Handles the viewing of grades. loncom/homework/imageresponse.pm home/httpd/lib/perl/Apache/imageresponse.pm handler Coordinates the response to clicking an image. works/unverified loncom/homework/optionresponse.pm home/httpd/lib/perl/Apache/optionresponse.pm handler Handles tags associated with showing a list of options loncom/homework/outputtags.pm home/httpd/lib/perl/Apache/outputtags.pm handler Handles tags associated with output. Seems to relate to due dates of the assignment. loncom/interface/lontest.pm home/httpd/lib/perl/Apache/lontest.pm handler Used for debugging and testing the LON-CAPA system. loncom/homework/radiobuttonresponse.pm home/httpd/lib/perl/Apache/radiobuttonresponse.pm handler Handles multiple-choice style responses. loncom/interface/lonassignments.pm home/httpd/lib/perl/Apache/lonassignments.pm handler Handles processing of assignments. loncom/interface/loncommunicate.pm home/httpd/lib/perl/Apache/loncommunicate.pm handler Handles communication. loncom/interface/lonerrorhandler.pm home/httpd/lib/perl/Apache/lonerrorhandler.pm handler Handles errors. loncom/interface/lonevaluate.pm home/httpd/lib/perl/Apache/lonevaluate.pm handler Handles evaluation. loncom/interface/lonfeedback.pm home/httpd/lib/perl/Apache/lonfeedback.pm handler Handles feedback from students to instructors and system administrators. loncom/interface/lonfeedback.pm home/httpd/lib/perl/Apache/lonfeedback.pm handler Handles feedback from students to instructors and system administrators. loncom/interface/lonmydesk.pm home/httpd/lib/perl/Apache/lonmydesk.pm handler Unknown function. loncom/interface/lonnavmaps.pm home/httpd/lib/perl/Apache/lonnavmaps.pm handler Handles navigational maps. loncom/interface/lonpreferences.pm home/httpd/lib/perl/Apache/lonpreferences.pm handler Handles user preferences associated with customizing the online LON-CAPA educational environment. loncom/interface/lonprintout.pm home/httpd/lib/perl/Apache/lonprintout.pm handler Handles the production of printable files and resources. loncom/interface/lonsearchcat.pm home/httpd/lib/perl/Apache/lonsearchcat.pm handler Handles a searchable catalogue. loncom/interface/londropadd.pm home/httpd/lib/perl/Apache/londropadd.pm handler Handler to drop and add students in courses. loncom/interface/lonmsg.pm home/httpd/lib/perl/Apache/lonmsg.pm handler Routines for messaging. loncom/homework/hint.pm home/httpd/lib/perl/Apache/hint.pm handler This handler coordinates the delivery of hints to students working on LON-CAPA problems and assignments. loncom/interface/lonspreadsheet.pm home/httpd/lib/perl/Apache/lonspreadsheet.pm handler Spreadsheet/Grades Display Handler loncom/interface/lonparmset.pm home/httpd/lib/perl/Apache/lonparmset.pm handler Handler to resolve ambiguous file locations loncom/publisher/lonconstruct.pm home/httpd/lib/perl/Apache/lonconstruct.pm handler Page wrapper for handling construction space. loncom/publisher/lonpublisher.pm home/httpd/lib/perl/Apache/lonpublisher.pm handler Publishes an LON-CAPA educational resource complete with metadata (authorship, language, copyright, creation date, etc). loncom/interface/lonmenu.pm home/httpd/lib/perl/Apache/lonmenu.pm handler Has routines which control the remote control. rat/lonpageflip.pm home/httpd/lib/perl/Apache/lonpageflip.pm handler Deals with forward, backward, and other page flips. rat/lonratedt.pm home/httpd/lib/perl/Apache/lonratedt.pm handler Builds up frame set and loads in the right thing. loncom/html/res/adm/pages/homeworkmenu.html home/httpd/html/res/adm/pages/homeworkmenu.html handler Homework remote control. loncom/html/res/adm/pages/annotator/admannotations.pm home/httpd/lib/perl/Apache/admannotations.pm handler This will take annotations and then plug them into a page loncom/html/res/adm/pages/bookmarkmenu/admbookmarks.pm home/httpd/lib/perl/Apache/admbookmarks.pm handler This will take bookmarks and get/write/display them for the LON-CAPA user interface rat/lonratsrv.pm home/httpd/lib/perl/Apache/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.) rat/lonpage.pm home/httpd/lib/perl/Apache/lonpage.pm handler bundles pages into one page rat/lonuserstate.pm home/httpd/lib/perl/Apache/lonuserstate.pm handler compile course into binary data structure (in loncom/rat) loncom/xml/lontex.pm home/httpd/lib/perl/Apache/lontex.pm handler Handler for tex files (somewhere in modules) loncom/xml/lontexconvert.pm home/httpd/lib/perl/Apache/lontexconvert.pm handler Access to tth/ttm loncom/xml/lonxml.pm home/httpd/lib/perl/Apache/lonxml.pm handler XML Parsing Module loncom/xml/style.pm home/httpd/lib/perl/Apache/style.pm handler Style Parsing Module loncom/xml/londefdef.pm home/httpd/lib/perl/Apache/londefdef.pm handler Tags Default Definition Module loncom/xml/run.pm home/httpd/lib/perl/Apache/run.pm handler used to prevent poorly written problems from causing lingering after effects loncom/xml/scripttag.pm home/httpd/lib/perl/Apache/scripttag.pm handler implements <script>, <scriptlib>, <parserlib>, and <import> loncom/homework/lonhomework.pm home/httpd/lib/perl/Apache/lonhomework.pm handler handler loncom/homework/inputtags.pm home/httpd/lib/perl/Apache/inputtags.pm handler produces HTML input tags (<INPUT>) for rendering homework resources loncom/homework/structuretags.pm home/httpd/lib/perl/Apache/structuretags.pm handler produces HTML tags necessary for structuring the presentation of homework resources loncom/homework/response.pm home/httpd/lib/perl/Apache/response.pm handler defines different types of responses given to student as well as syntax for producing response values loncom/homework/caparesponse/caparesponse.pm home/httpd/lib/perl/Apache/caparesponse.pm handler handles request to the CAPA homework processing engine loncom/auth/lonacc.pm home/httpd/lib/perl/Apache/lonacc.pm handler (This module, like loncacc.pm also authenticates with cookies.) lonacc.pm coordinates access to a wide range of administrative-type functions (e.g. roles, logout, annotations, and bookmarks) as well as coordinating access to educational resources. loncom/auth/lonracc.pm home/httpd/lib/perl/Apache/lonracc.pm handler access handler for file transfers loncom/auth/loncacc.pm home/httpd/lib/perl/Apache/loncacc.pm handler This module provides access to an educational resource construction area. This module is invoked by the URL-related pattern syntax LocationMatch "^/priv.*" or LocationMatch "^/\~.*". Authentication of user identity is coordinated through cookies. The abbreviation "cacc" corresponds to "construction-space access"). If the cookie handle is invalid, then this module returns a forbidden status and makes appropriate log entries. If the cookie handle is valid, status is determined to be okay (and, for the "priv"-type access, the resource is delivered by the lonconstruct module). loncom/auth/lonauth.pm home/httpd/lib/perl/Apache/lonauth.pm handler authenticate, set up session environment loncom/auth/lonlogin.pm home/httpd/lib/perl/Apache/lonlogin.pm handler login screen loncom/auth/lonlogout.pm home/httpd/lib/perl/Apache/lonlogout.pm handler logout loncom/lonnet/perl/lonrep.pm home/httpd/lib/perl/Apache/lonrep.pm handler replication loncom/auth/lonroles.pm home/httpd/lib/perl/Apache/lonroles.pm handler This perl handling module reads in the available roles available for a LON-CAPA user (different courses, different privileges, etc) and produces a form-element HTML page which allows the user to select which role he wishes to exercise in the LON-CAPA system. For instance, a user may want to select between being a student in a thermodynamics physics course or a teaching assistant for an introductory calculus class. loncom/interface/lonindexer.pm home/httpd/lib/perl/Apache/lonindexer.pm handler cross server filesystem browser loncom/lonnet/perl/lonnet.pm home/httpd/lib/perl/Apache/lonnet.pm handler This file is an interface to the lonc processes of the LON-CAPA network as well as set of elaborated functions for handling information necessary for navigating through a given cluster of LON-CAPA machines within a domain. There are over 40 specialized functions in this module which handle the reading and transmission of metadata, user information (ids, names, environments, roles, logs), file information (storage, reading, directories, extensions, replication, embedded styles and descriptors), educational resources (course descriptions, section names and numbers), url hashing (to assign roles on a url basis), and translating abbreviated symbols to and from more descriptive phrases or explanations. loncom/html/index.html home/httpd/html/index.html interface file bumps to login etc/mime.types etc/httpd/conf/mime.types symbolic link symbolic link to /etc/mime.types home/httpd/html/res home/httpd/html/raw symbolic link symbolic link to /home/httpd/html/res loncom/html/adm/notfound.html home/httpd/html/adm/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 loncom/html/adm/unauthorized.html home/httpd/html/adm/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 rat/client/rat.html home/httpd/html/adm/rat/rat.html interface file frameset rat/client/parameter.html home/httpd/html/adm/rat/parameter.html interface file Parameter input window. rat/client/code.html home/httpd/html/adm/rat/code.html interface file javascript rat/client/map.html home/httpd/html/adm/rat/map.html interface file bumper rat/client/empty.html home/httpd/html/adm/rat/empty.html interface file A blank page with very minimal HTML structural elements.