--- doc/loncapafiles/loncapafiles.lpml 2001/05/14 19:22:31 1.4 +++ 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,143 +196,120 @@ 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 +etc/httpd/conf/access.conf conf This file has two major functions. @@ -390,7 +323,6 @@ lonAdmEMail, lonDefDomain, lonLoadLim, l and internal machine settings for specific directories, socket ports, and browser detection logic. -RedHat 6.2 configure
@@ -406,7 +338,7 @@ and browser detection logic.
loncom/httpd.conf -etc/httpd/conf/httpd.conf +etc/httpd/conf/httpd.conf static conf This is the main server configuration file. The settings here are @@ -414,11 +346,10 @@ more or less standard for the Apache web importantly!), perl handling and mod_perl are enabled in this configuration file. -RedHat 6.2 loncom/srm.conf -etc/httpd/conf/srm.conf +etc/httpd/conf/srm.conf static conf

@@ -439,11 +370,10 @@ PerlHandler Apache::lonpage

-RedHat 6.2
loncom/startup.pl -etc/httpd/conf/startup.pl +etc/httpd/conf/startup.pl static conf This file provides initializations for perl handlers. It adjusts what @@ -451,661 +381,709 @@ the module path space is (so as to inclu well as causing the Apache module to be used for every perl handler. startup.pl is invoked by access.conf. -RedHat 6.2 loncom/interface/filetypes.tab -home/httpd/lonTabs/filetypes.tab +home/httpd/lonTabs/filetypes.tab static conf Descriptive list of file extensions, and extension groupings. -RedHat 6.2 loncom/homework/insertlist.tab -home/httpd/lonTabs/insertlist.tab +home/httpd/lonTabs/insertlist.tab static conf Options available (or suggested) for different homework tags. -RedHat 6.2 loncom/interface/default.assesscalc -home/httpd/html/res/adm/includes/default.assesscalc +home/httpd/html/res/adm/includes/default.assesscalc static conf Default spreadsheet for individual assessment. -RedHat 6.2 loncom/interface/default.studentcalc -home/httpd/html/res/adm/includes/default.studentcalc +home/httpd/html/res/adm/includes/default.studentcalc static conf Default spreadsheet for assessment of students. -RedHat 6.2 loncom/auth/roles.tab -home/httpd/lonTabs/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) -RedHat 6.2 - - - - -RedHat 6.2 +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 + - - - - -RedHat 6.2 +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 + - - - - -RedHat 6.2 +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 +
+
- - - - -RedHat 6.2 +loncom/htpasswd +home/httpd/lonTabs/htpasswd +conf + +Basic auth password to access /lon-status and /server-status + - + -RedHat 6.2 - - +loncom/krb.conf +etc/krb.conf - -RedHat 6.2 + +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
  • +
+
+
- - - - -RedHat 6.2 +loncom/smb.conf +etc/smb.conf +conf + +configuration file to make LON-CAPA server file space accessible to network neighborhood + - - - - -RedHat 6.2 +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 +
+
- + -RedHat 6.2 - - - - -RedHat 6.2 +loncom/metadata_database/searchcat.pl +home/httpd/perl/searchcat.pl +script + +Batch script for updating SQL metadata database. + - - - - -RedHat 6.2 +loncom/lonc +home/httpd/perl/lonc +script + +proxy server + - - - - -RedHat 6.2 +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). + - - - - -RedHat 6.2 +loncom/loncron +home/httpd/perl/loncron +script +housekeeping - - - - -RedHat 6.2 +loncom/lonsql +home/httpd/perl/lonsql +script +maintain secondary database of metadata - - - - -RedHat 6.2 +loncom/lcpasswd +home/httpd/perl/lcpasswd +setuid script + +coordinates the system services and files in order to allow lond to change +user passwords + - - - - -RedHat 6.2 +loncom/lcuseradd +home/httpd/perl/lcuseradd +setuid script + +coordinates the system services and files in order to allow lond to add a +new user + - - - - -RedHat 6.2 +loncom/lcuserdel +home/httpd/perl/lcuserdel +setuid script + +coordinates the system services and files in order to allow lond to delete a user + - - - - -RedHat 6.2 +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 + - - - - -RedHat 6.2 +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 + - - - - -RedHat 6.2 +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. + - - - - -RedHat 6.2 +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. + - - - - -RedHat 6.2 +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. + - - - - -RedHat 6.2 +loncom/publisher/copyright.tab +home/httpd/html/res/adm/includes/copyright.tab +conf + +Table which contains list of copyright possibilities for educational resources. + - - - - -RedHat 6.2 +loncom/publisher/language.tab +home/httpd/lonTabs/language.tab +static conf + +Table which contains string abbreviations of language::font rendering +combinations. + - + -RedHat 6.2 - - - - -RedHat 6.2 +loncom/publisher/addid.tab +home/httpd/lonTabs/addid.tab +static conf + +Table which has hash data necessary for distinguishing IDs from indices. + - - - - -RedHat 6.2 +loncom/publisher/londiff.pm +home/httpd/lib/perl/Apache/londiff.pm +handler + +Handler to show difference between two files. + +works/unverified - - - - -RedHat 6.2 +loncom/publisher/lonupload.pm +home/httpd/lib/perl/Apache/lonupload.pm +handler + +Handler to upload files through browser into construction space. + +works/unverified - - - - -RedHat 6.2 +loncom/homework/essayresponse.pm +home/httpd/lib/perl/Apache/essayresponse.pm +handler + +Handler to evaluate essay (ungraded) style responses. + +works/unverified - - - - -RedHat 6.2 +loncom/publisher/lonpubdir.pm +home/httpd/lib/perl/Apache/lonpubdir.pm +handler + +Handler to publish directories. + - - - - -RedHat 6.2 +loncom/publisher/lonretrieve.pm +home/httpd/lib/perl/Apache/lonretrieve.pm +handler + +Handler to retrieve old versions from resource space. + +works/unverified - - - - -RedHat 6.2 +loncom/homework/edit.pm +home/httpd/lib/perl/Apache/edit.pm +handler + +Helper functions when in homework edit mode. + - - - - -RedHat 6.2 +loncom/interface/lonmeta.pm +home/httpd/lib/perl/Apache/lonmeta.pm +handler +Metadata display handler. +works/unverified - - - - -RedHat 6.2 +rat/lonambiguous.pm +home/httpd/lib/perl/Apache/lonambiguous.pm +handler + +Handler to resolve ambiguous file locations. + +works/unverified - - - - -RedHat 6.2 +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 - + -RedHat 6.2 - - - - -RedHat 6.2 +rat/lonsequence.pm +home/httpd/lib/perl/Apache/lonsequence.pm +handler + +Handler for showing sequence objects of educational resources. + +works/unverified - - - - -RedHat 6.2 +loncom/interface/loncreatecourse.pm +home/httpd/lib/perl/Apache/loncreatecourse.pm +handler + +Creates a new course and assigns course coordinator. + - - - - -RedHat 6.2 +loncom/interface/loncreateuser.pm +home/httpd/lib/perl/Apache/loncreateuser.pm +handler + +Creates a new user and/or changes user privileges + +works/unverified - - - - -RedHat 6.2 +loncom/interface/lonchart.pm +home/httpd/lib/perl/Apache/lonchart.pm +handler + +Produces simple LectureOnline-like student assessment performance chart + - - - - -RedHat 6.2 +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 - - - - -RedHat 6.2 +loncom/homework/grades.pm +home/httpd/lib/perl/Apache/grades.pm +handler +Handles the viewing of grades. - - - - -RedHat 6.2 +loncom/homework/imageresponse.pm +home/httpd/lib/perl/Apache/imageresponse.pm +handler + +Coordinates the response to clicking an image. + +works/unverified - - - - -RedHat 6.2 +loncom/homework/optionresponse.pm +home/httpd/lib/perl/Apache/optionresponse.pm +handler +Handles tags associated with showing a list of options - - - - -RedHat 6.2 +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. + - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2 - + -RedHat 6.2