--- doc/loncapafiles/Attic/loncapafiles.html 2000/12/18 23:25:46 1.38 +++ doc/loncapafiles/Attic/loncapafiles.html 2001/04/18 15:59:51 1.84 @@ -160,7 +160,10 @@ browser and can only be seen be examinin - + + + @@ -190,7 +193,16 @@ browser and can only be seen be examinin -define handlers, set parameters +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 @@ -208,25 +220,65 @@ define handlers, set parameters -main server configuration file +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. -name space configuration +

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

 -set paths to modules; invoked by access.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. -Descriptive list of file extensions, and extension groupings +Descriptive list of file extensions, and extension groupings. + + + + + +Default spreadsheet for individual assessment. + + + + + +Default spreadsheet for assessment of students. + + + + + +Default spreadsheet for assessment of a class. @@ -268,7 +320,7 @@ each list element consists of only one v - + Basic auth password to access /lon-status and /server-status @@ -320,6 +372,12 @@ Example:
server ntp.msu.edu + + +Batch script for updating SQL metadata database. + + + proxy server @@ -328,7 +386,17 @@ proxy server -remote command interpreter +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). @@ -413,6 +481,215 @@ Table which has hash data necessary for + + +Handler to upload files through browser into construction space. + +works/unverified + + + + +Handler to evaluate essay (ungraded) style responses. + +works/unverified + + + + +Handler to publish directories. + +works/unverified + + + + +Handler to retrieve old versions from resource space. + +works/unverified + + + + +Helper functions when in homework edit mode. + +works/unverified + + + + +Metadata display handler. + +works/unverified + + + + +Handler to resolve ambiguous file locations. + +works/unverified + + + + +Handler to set resource parameters inside of the RAT based on metadata. + +works/unverified + + + + +Handler for showing sequence objects of educational resources. + +works/unverified + + + + +Creates a new course and assigns course coordinator. + +works/unverified + + + + +Creates a new user and/or changes user privileges + +works/unverified + + + + +Produces simple LectureOnline-like student assessment performance chart + +works/unverified + + + + +Makes a table out of the previous attempts. Inputs result_from_symbread, +user, domain, home_server, course_id + +works/unverified + + + + +Handles the viewing of grades. + + + + + +Coordinates the response to clicking an image. + + + + + +Handles tags associated with showing a list of options. + + + + + +Handles tags associated with output. Seems to relate to due dates of the +assignment. + + + + + +Used for debugging and testing the LON-CAPA system. + + + + + +Handles multiple-choice style responses. + + + + + +Handles processing of assignments. + + + + + +Handles communication. + + + + + +Handles errors. + + + + + +Handles evaluation. + + + + + +Handles feedback from students to instructors and system administrators. + + + + + +Unknown function. + + + + + +Handles navigational maps. + + + + + +Handles user preferences associated with customizing the online LON-CAPA +educational environment. + + + + + +Handles the production of printable files and resources. + + + + + +Handles a searchable catalogue. + + + + + +Handler to drop and add students in courses. + + + + + +Routines for messaging. + + + + + +This handler coordinates the delivery of hints to students working on LON-CAPA +problems and assignments. + + + Spreadsheet/Grades Display Handler @@ -456,6 +733,12 @@ Builds up frame set and loads in the rig + + +Homework remote control. + + + This will take annotations and then plug them into a page @@ -562,7 +845,10 @@ handles request to the CAPA homework pro -access to for a LON-CAPA user session +(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. @@ -574,7 +860,16 @@ access handler for file transfers -access to construction area +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). @@ -604,9 +899,15 @@ replication -roles picking +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. - + @@ -616,7 +917,16 @@ cross server filesystem browser -interface to lonc +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. @@ -657,6 +967,12 @@ frameset + + +Parameter input window. + + + javascript @@ -668,6 +984,12 @@ javascript bumper + + + +A blank page with very minimal HTML structural elements. + + @@ -782,6 +1104,35 @@ sutd.gif + + +icons to indicate an unexpected result + + +lonconstruct.gif +lonlogo_broken.gif +lonlogo_broken_tsp.gif + + + + + +icon to indicate an unexpected result + + + + + +icon to indicate an unexpected result + + + + + +icon to indicate an unexpected result + + + logos @@ -792,6 +1143,15 @@ lonlogo.gif lonlogos.gif + + + +miscellaneous resources + + +cat_button.gif + + @@ -903,11 +1263,23 @@ Encryption Routines according to Data En + + +used by lonxml::xmlparse() as input variable $safeinit to Apache::run::run() + + + used by lonxml::xmlparse() as input variable $safeinit to Apache::run::run() + + + +Define unit prefixing and conversion for CAPA problem handling. + + @@ -935,6 +1307,7 @@ j.gif k.gif l.gif ledblink.gif +ledgreen.gif ledoff.gif ledon.gif ledsend.gif @@ -969,13 +1342,13 @@ image maps for the LON-CAPA remote contr - + welcoming page to the LON-CAPA system upon login - + renders the HTML (including image maps) for the LON-CAPA remote control @@ -1104,22 +1477,9 @@ ur_corner.gif associated with the frameset scheme of displaying bookmarks -aaloader.html -bookmarkmenu_bb.html -bookmarkmenu_left.html -bookmarkmenu_ll.html -bookmarkmenu_lr.html -bookmarkmenu_right.html bookmarkmenu_toolbar.html -bookmarkmenu_ul.html -bookmarkmenu_ur.html -bookmarkmenu_uu.html -bookmarkpal.html bookmarkpal_old.html -bookmarkpal_v2.html -bookmarkpal_v2_backup.html index.html -loading_bookmarks.html @@ -1160,7 +1520,7 @@ makes verification report using loncapav - + file that specifies periodic processes to run for the LON-CAPA machine