--- doc/loncapafiles/loncapafiles.lpml 2001/05/06 23:10:41 1.1 +++ doc/loncapafiles/loncapafiles.lpml 2001/05/15 19:36:25 1.5 @@ -2,107 +2,1088 @@ / /home/user/loncapa/ - 0444root:root - RedHat 6.2 + 0444root:root - 0644www:www - RedHat 6.2 + 0644www:www - 6755root:root - RedHat 6.2 + 6755root:root - 6755root:root - RedHat 6.2 + 6755root:root - 0444root:root - RedHat 6.2 + 0444root:root - 0600www:www - RedHat 6.2 + 0600www:www - 0444root:root - RedHat 6.2 + 0444root:root - 0444root:root - RedHat 6.2 + 0444root:root - 0644root:root - RedHat 6.2 + 0644root:root - 0644root:root - RedHat 6.2 + 0644root:root - 0700www:www - RedHat 6.2 + 0700www:www - 0500www:www - RedHat 6.2 + 0500www:www - 0444root:root - RedHat 6.2 + 0444root:root - 0400www:www - RedHat 6.2 + 0400www:www - 0644root:root - RedHat 6.2 + 0644root:root - 0644root:root - RedHat 6.2 + 0644root:root - 0700root:root - RedHat 6.2 + 0700root:root - 0700root:root - RedHat 6.2 + 0700root:root - root:root - RedHat 6.2 + root:root - root:root - RedHat 6.2 + root:root - 0755root:root - RedHat 6.2 + 0755root:root - 0755root:root - RedHat 6.2 + 0755root:root - 0700www:www - RedHat 6.2 + 0700www:www - 0755www:www - RedHat 6.2 + 0755www:www - 0500www:www - RedHat 6.2 + 0500www:www - 0700www:www - RedHat 6.2 + 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 + +Options available (or suggested) for different homework 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/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. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +