--- doc/loncapafiles/loncapafiles.lpml 2001/05/14 18:50:22 1.3 +++ doc/loncapafiles/loncapafiles.lpml 2001/05/15 19:36:25 1.5 @@ -2,108 +2,82 @@ / /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. @@ -120,115 +94,97 @@ 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 + etc/httpd/conf standard web configuration files - RedHat 6.2 - home/httpd/lonTabs + home/httpd/lonTabs standard tab-formatted reference files - RedHat 6.2 - home/httpd + home/httpd standard start of the web server tree - RedHat 6.2 - etc + etc standard standard linux directory for configuration files - RedHat 6.2 - home/httpd/perl + home/httpd/perl standard perl scripts for managing the LON-CAPA system - RedHat 6.2 - home/httpd/perl/logs + home/httpd/perl/logs server standard location where system performance and error logs are kept - RedHat 6.2 - home/httpd/perl/tmp + home/httpd/perl/tmp server standard location where temporary files (for caching) are stored - RedHat 6.2 - home/httpd/lib/perl/Apache + home/httpd/lib/perl/Apache server readonly location of LON-CAPA web mod-perl handlers - RedHat 6.2 - home/httpd/lonIDs + home/httpd/lonIDs server standard cookie jar - RedHat 6.2 - home/httpd/sockets + home/httpd/sockets server standard lonc's sockets - RedHat 6.2 - home/httpd/sockets/delayed + home/httpd/sockets/delayed server standard lonc's sockets (delayed) - RedHat 6.2 - home/httpd/html + home/httpd/html server standard location of web-accessible file tree - RedHat 6.2 - home/httpd/html/res + home/httpd/html/res server standard root of resource tree - RedHat 6.2 - home/httpd/html/adm + home/httpd/html/adm server readonly unauthenticated resources - RedHat 6.2 - home/httpd/html/adm/rat + home/httpd/html/adm/rat server readonly home of the rat - RedHat 6.2 - home/httpd/html/adm/lonIcons + home/httpd/html/adm/lonIcons server readonly graphic widgets - RedHat 6.2 - home/httpd/html/adm/lonMisc + home/httpd/html/adm/lonMisc server readonly - RedHat 6.2 - home/httpd/html/adm/lonKaputt + home/httpd/html/adm/lonKaputt server readonly error warnings and icons - RedHat 6.2 - home/httpd/lonUsers + home/httpd/lonUsers server standard
Home directories of local users. There is a five-tier structure to the directories: @@ -240,138 +196,894 @@ system. A passwd file determines the ty 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. - RedHat 6.2 - home/httpd/html/lon-status + home/httpd/html/lon-status server standard status reports - RedHat 6.2 - usr/lib/perl5/site_perl/5.005 + usr/lib/perl5/site_perl/5.005 standard system perl tree (usually present on linux systems) - RedHat 6.2 - home/httpd/html/adm/MathML + home/httpd/html/adm/MathML server readonly mathematics markup language resources - RedHat 6.2 - home/httpd/html/res/adm/includes + home/httpd/html/res/adm/includes server readonly files useful for including within customized scripting - RedHat 6.2 - home/httpd/html/lon-status + home/httpd/html/lon-status server standard status reports - RedHat 6.2 - home/httpd/html/res/adm/pages + home/httpd/html/res/adm/pages server readonly web user interface resources - RedHat 6.2 - home/httpd/html/res/adm/pages/bookmarkmenu + home/httpd/html/res/adm/pages/bookmarkmenu server readonly bookmark user interface code - RedHat 6.2 - home/httpd/html/res/adm/pages/annotations + home/httpd/html/res/adm/pages/annotations server readonly - RedHat 6.2 - usr/sbin + usr/sbin standard standard linux directory for superuser executables - RedHat 6.2 - etc/cron.d + etc/cron.d standard standard linux directory for running time-based "jobs" - RedHat 6.2 - etc/ntp + etc/ntp standard configuration directory for network time protocol - RedHat 6.2 - etc/rc.d/init.d + etc/rc.d/init.d standard scripts that run during system startup - RedHat 6.2 - etc/rc.d/rc0.d + etc/rc.d/rc0.d standard scripts that run for run-level 0 - RedHat 6.2 - etc/rc.d/rc1.d + etc/rc.d/rc1.d standard scripts that run for run-level 1 - RedHat 6.2 - etc/rc.d/rc2.d + etc/rc.d/rc2.d standard scripts that run for run-level 2 - RedHat 6.2 - etc/rc.d/rc3.d + etc/rc.d/rc3.d standard scripts that run for run-level 3 - RedHat 6.2 - etc/rc.d/rc4.d + etc/rc.d/rc4.d standard scripts that run for run-level 4 - RedHat 6.2 - etc/rc.d/rc5.d + etc/rc.d/rc5.d standard scripts that run for run-level 5 - RedHat 6.2 - etc/rc.d/rc6.d + etc/rc.d/rc6.d standard scripts that run for run-level 6 - RedHat 6.2 - etc/rc.d/rc7.d + etc/rc.d/rc7.d standard scripts that run for run-level 7 - RedHat 6.2 - etc/atalk + etc/atalk standard appletalk configuration files - RedHat 6.2 - home/httpd/html/res/adm/pages/indexericons + home/httpd/html/res/adm/pages/indexericons server readonly icons that help depict the file system - RedHat 6.2 + +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. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +