--- doc/loncapafiles/loncapafiles.lpml 2002/01/29 10:31:42 1.91
+++ doc/loncapafiles/loncapafiles.lpml 2002/06/04 05:09:13 1.133
@@ -1,7 +1,9 @@
+
-
+
-
+
+
+!!! REDHAT 6.2 NOTICE !!!
+!!! Sometimes an incorrect /etc/hosts file is incorrectly generated !!!
+!!! This sometimes happens (bad): !!!
+!!! 127.0.0.1 computer1 localhost.localdomain localhost !!!
+!!! Should be: !!!
+!!! 127.0.0.1 localhost.localdomain localhost !!!
+!!! 35.2.3.80 computer1 computer1.notreal.msu.edu !!!
+
+
!!!!!!!!! REDHAT 7.* NOTICE !!!!!!!!!!!!!!!!!!!!
!!!!!!!!! LINE IN Cookie.pm !!!!!!!!!!!!!!!!!!!!
!!!!!!!!! MUST BE REPLACED DUE !!!!!!!!!!!!!!!!!!!!
@@ -44,18 +56,15 @@ http://www.lon-capa.org/
!!!!!!!!! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!! The offending line is in CGI/Cookie.pm !!
!!!! !!
-!!!! it went from !!
-!!!! !!
-!!!! !!
-!!!! # IE requires the path and domain to be present for some reason. !!
-!!!! ($path = $ENV{'SCRIPT_NAME'})=~s![^/]+$!! unless $path; !!
-!!!! !!
+!!!! it should be changed from !!
+!!!! $path = CGI::url(-absolute=>1) unless defined $path; !!
!!!! to !!
+!!!! ($path = $ENV{'SCRIPT_NAME'})=~s![^/]+$!! unless $path; !!
!!!! !!
-!!!! !!
+!!!! (This is just below the following line ) !!
!!!! # IE requires the path and domain to be present for some reason. !!
-!!!! $path = CGI::url(-absolute=>1) unless defined $path; !!
+//home/user/loncapa/
@@ -185,11 +194,10 @@ Division of Science and Mathematics Educ
Utilities/SystemLON-CAPA-base-3.1.tar.gzno
- This package facilitates a base installation of LON-CAPA files in their directories.\n
-The files in this package are only those directly associated with the network communication\n
-layer established through direct server-to-server communications (via lond and lonc); plus\n
-those which configure (but otherwise not constitute) external software packages like Apache\n
-and Athena-Kerberos. For more on the LON-CAPA project, visit http://www.lon-capa.org/.
+ This package facilitates a base installation of LON-CAPA \n
+files in their directories.\n
+For more on the LON-CAPA project, visit http://www.lon-capa.org/.
+ echo '***********************************************************************'\n
echo 'LON-CAPA LearningOnline with CAPA'\n
echo 'http://www.lon-capa.org/'\n
@@ -203,236 +211,251 @@ echo 'This installation assumes an insta
echo ' '\n
echo 'The server computer should be currently connected to the ethernet'\n
echo ' '\n
-echo 'The files in this package are only those directly associated with the network communication'\n
-echo 'layer established through direct server-to-server communications (via lond and lonc); plus'\n
-echo 'those which configure (but otherwise not constitute) external software packages like Apache'\n
-echo 'and Athena-Kerberos.'\n
echo '***********************************************************************'\n
PreReq: LON-CAPA-setupPreReq: apache
-PreReq: /etc/httpd/conf/access.conf
+PreReq: /etc/httpd/conf/httpd.conf
-
+etcstandardstandard linux directory for configuration files
-
+etc/atalkstandardappletalk configuration files
-
+etc/cron.dstandardstandard linux directory for running time-based "jobs"
-
+etc/httpd/confstandardweb configuration files
-
+etc/ntpstandardconfiguration directory for network time protocol
-
+etc/pam.dstandardconfiguration directory for password authentication mechanism
-
+
+ etc/samba
+ standard
+ configuration directory for samba authentication
+
+
+etc/rc.d/init.d
- etc/init.d
+ etc/init.dstandardscripts that run during system startup
-
+etc/rc.d/rc0.d
- etc/rc0.d
+ etc/rc0.dstandardscripts that run for run-level 0
-
+etc/rc.d/rc1.d
- etc/rc1.d
+ etc/rc1.dstandardscripts that run for run-level 1
-
+etc/rc.d/rc2.d
- etc/rc2.d
+ etc/rc2.dstandardscripts that run for run-level 2
-
+etc/rc.d/rc3.d
- etc/rc3.d
+ etc/rc3.dstandardscripts that run for run-level 3
-
+etc/rc.d/rc4.d
- etc/rc4.d
+ etc/rc4.dstandardscripts that run for run-level 4
-
+etc/rc.d/rc5.d
- etc/rc5.d
+ etc/rc5.dstandardscripts that run for run-level 5
-
+etc/rc.d/rc6.d
- etc/rc6.d
+ etc/rc6.dstandardscripts that run for run-level 6
-
+home/httpd/lonTabsstandardtab-formatted reference files
-
+home/httpdstandardstart of the web server tree
-
+home/httpd/perlserver readonlyperl scripts for managing the LON-CAPA system
-
+home/httpd/perl/logsserver standardlocation where system performance and error logs are kept
-
- home/httpd/perl/londchld
+
+ home/httpd/html/lon-status/londchldserver standard
Used by lond parent to check if children are responding to USR1 signals
(otherwise they are killed and replaced).
-
+home/httpd/perl/tmpserver standardlocation where temporary files (for caching) are stored
-
+home/httpd/prtspoolserver standardfor the output of lonprintout.pm
-
+home/httpd/lib/perlserver readonlylocation of LON-CAPA non web mod-perl handlers
-
+home/httpd/lib/perl/Apacheserver readonlylocation of LON-CAPA web mod-perl handlers
-
+
+ home/httpd/lib/perl/HTML
+ server readonly
+ location of HTML specific perl module fixes and additions
+
+
+
+ home/httpd/lib/perl/LONCAPA
+ server readonly
+ location of HTML specific perl module fixes and additions
+
+
+home/httpd/lonIDsserver standardcookie jar
-
+home/httpd/socketsserver standardlonc's sockets
-
+home/httpd/sockets/delayedserver standardlonc's sockets (delayed)
-
+home/httpd/cgi-binstandardlocation of cgi scripts
-
+home/httpd/htmlserver standardlocation of web-accessible file tree
-
+home/httpd/html/resserver standardroot of resource tree
-
+home/httpd/html/admserver readonlyunauthenticated resources
-
+home/httpd/html/adm/ratserver readonlyhome of the rat
-
+home/httpd/html/adm/helpserver readonlyonline help documentation
-
- home/httpd/html/adm/help/api
+
+ home/httpd/html/adm/help/lib/perlserver readonlyonline help documentation for the LON-CAPA programming
interface
-
- home/httpd/html/adm/help/api/Apache
+
+ home/httpd/html/adm/help/lib/perl/Apache
+ server readonlyonline help documentation for the LON-CAPA programming
interface, Apache (mod_perl) handlers
-
+home/httpd/html/adm/help/scriptsserver readonlyonline help documentation for the LON-CAPA programming
interface, Apache (mod_perl) handlers
-
+home/httpd/html/adm/lonIconsserver readonlygraphic widgets
-
+home/httpd/html/adm/lonMiscserver readonlymiscellaneous resources
-
+home/httpd/html/adm/lonKaputtserver readonlyerror warnings and icons
-
+home/httpd/lonUsersserver standardHome 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
+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.
@@ -440,70 +463,81 @@ mechanism to use.
roles.db) which specify the roles and privileges for a user in the
LON-CAPA system.
-
+home/httpd/html/adm/MathMLserver readonlymathematics markup language resources
-
+home/httpd/html/res/adm/includesserver readonlyfiles useful for including within customized scripting
-
+home/httpd/html/res/adm/includes/templates
server readonlytemplate files useful for customized scripts
-
+home/httpd/html/lon-statusserver standard
- status reports
+ status reports; online logs are kept that
+are viewable over the world-wide web
-
+home/httpd/html/res/adm/pagesserver readonlyweb user interface resources
-
+home/httpd/html/res/adm/pages/bookmarkmenu
server readonlybookmark user interface code
-
+home/httpd/html/res/adm/pages/annotations
server readonly
-
+home/httpd/html/res/adm/pages/indexericons
server readonlyicons that help depict the file system (outdated)
-
+usr/lib/perl5/site_perl/5.005
- usr/lib/perl5/site_perl/5.6.0
+ usr/lib/perl5/site_perl/5.6.0usr/local/lib/perl/5.6.0standardsystem perl tree (usually present on linux systems)
-
+
+ usr/local/bin
+ standard
+ local binary files
+
+
+ usr/local/man/man1
+ standard
+ local manual pages
+
+usr/man/man1standardmanual pages
-
+usr/man/man3standardmanual pages
-
+usr/sbinstandardstandard linux directory for superuser executables
@@ -538,25 +572,23 @@ each list element consists of only two s
etc/httpd/conf/loncapa.confconf
+
The goal of this file is to implement all LON-CAPA specific
-customization of the Apache web server.
-
-
-
-
-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.
+customization of the Apache web server (most all of these values
+require manual input from the system administrator at some point).
+The values in this file, as opposed to loncapa_apache.conf, are
+meant to be machine and institution specific.
+
+
+For the LON-CAPA network server and perl module
+handlers, it defines machine specific settings including lonHostID, lonRole,
+lonAdmEMail, lonDefDomain, lonLoadLim, lonExpire, and lonReceipt.
+
+
+This file should not be viewable by regular users of the system.
+Only root and www should be able to view the contents of this file
+since lonReceipt is sensitive.
+
configure
@@ -578,38 +610,22 @@ MySQL database
-
-etc/httpd/conf/httpd.conf
+
+etc/httpd/conf/loncapa_apache.confstatic 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.
-
-
-
-
-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".
-