--- doc/build/Attic/install.html 2002/02/13 15:06:22 1.12 +++ doc/build/Attic/install.html 2003/05/02 19:25:01 1.40 @@ -1,7 +1,10 @@ + - +
+You will need to check all the following things to ensure proper installation of your LON-CAPA system. +
+NOTE: +If you want to simultaneously install both RedHat 7.3 and LON-CAPA +(to ensure 100% reliability), follow these +alternative directions. +
-
+/usr/sbin/useradd www + |
Step # | Description |
---|---|
-1 +1 |
- Is your system using shadow passwords? (Note: LON-CAPA will -work with either MD5/non-MD5 configured systems). If your -system is not using shadow passwords, then do not perform -any of the additional steps. If your system is using shadow -passwords, then you will need to perform the additional steps below. + Is your system using shadow passwords? (Note: LON-CAPA will work +with either MD5/non-MD5 configured systems). It is strongly +recommended to use shadow passwords. If your system is currently not +using shadow passwords, run the "pwconv" command (as root) in order to +convert to shadow passwords. If you choose not to use shadow +passwords, then do not perform any of the additional steps. If your +system is using shadow passwords, then you will need to perform the +additional steps below. How to detect: @@ -49,54 +82,200 @@ the steps below. running the following command -wget http://www.wwnet.net/~janc/software/mod_auth_external-2.1.13.tar.gz +wget http://www.unixpapa.com/software/mod_auth_external-2.1.15.tar.gz |
+3 + |
+ Unpack the mod_auth_external source by +running the following command + ++tar xzvf mod_auth_external-2.1.15.tar.gz + + |
+4 + |
+ Go to the pwauth directory by +running the following command + ++cd mod_auth_external-2.1.15/pwauth/ + + |
+5 + |
+ Edit config.h and change SERVER_UIDS definition + +
+Determine the user id of 'www':
+ |
+6 + |
+ Compile the pwauth executable by +running the following command + ++make + + |
+7 + |
+ Install pwauth by doing the following + +
+cp pwauth /usr/local/sbin/
+ +Edit (creating the file) /etc/pam.d/pwauth to have the contents: + ++ auth required /lib/security/pam_pwdb.so shadow nullok + auth required /lib/security/pam_nologin.so + account required /lib/security/pam_pwdb.so ++ |
+Download the most current + +loncapa-current.tar.gz.
- -wget http://install.lon-capa.org/versions/loncapa-current.tar.gz
+
+ +tar xzvf loncapa-current.tar.gz + +cd loncapa-N.N (N.N is the version number) |
-Scott Harrison +The UPDATE command will refresh your filesystem with all +the latest LON-CAPA software.
-$Date: 2002/02/13 15:06:22 $; $Revision: 1.12 $
+./UPDATE |
-This is the current list of steps to support LON-CAPA installation. These -steps have been tested.
-./CHECKRPMS |
+Also, please be sure to install the LON-CAPA-systemperl RPM as described on +the Downloads page. +
+ ++A common RedHat glitch of new installations (RedHat's fault, not LON-CAPA) +is the generation of /etc/hosts. +
++It should look something like this (except the myschool line +should be replaced with settings specific to your machine): +
+
++127.0.0.1 localhost.localdomain localhost +12.34.56.78 www.myschool.edu myschool + |
+The following commands describe how to configure the MySQL database
+on your LON-CAPA server.
+
Note:
+
-You can also try to install LON-CAPA on an existing installation of -RedHat 6.2. Please see -how_to_install_loncapa_on_a_preinstalled_system.txt. +
+The following instructions assume you are logged in as 'root'. +
+Entering the mysql shell
+
++mysql -u root -p mysql +OR +mysql -u root mysql (depending on whether you have set a root password) ++ |
Creating the mysql 'www' user (after entering mysql shell)
+
++mysql> CREATE DATABASE loncapa; + +mysql> INSERT INTO user (Host, User, Password) +mysql> VALUES ('localhost','www',password('localhostkey')); + +mysql> INSERT INTO db VALUES ('localhost','loncapa','www', +mysql> 'Y','Y','Y','Y','Y','Y','N','Y','Y','Y'); + +mysql> FLUSH PRIVILEGES; ++ |
SECURITY: set a password for the mysql 'root' user
+
++shell> mysql -u root mysql +mysql> SET PASSWORD FOR root@localhost=PASSWORD('ROOTPASSWORD'); ++ |
SECURITY: only allow access from localhost
+
++shell> mysql -u root -p mysql +mysql> DELETE FROM user WHERE host<>'localhost'; ++ |
+The TEST command will check the installation software, +the perl libraries on your system, the MySQL database, and +will also automatically test the real-time operation of the +LON-CAPA Apache web server.
+./TEST |
+Using the TEST command will likely +be an iterative process. +It is normal to expect that the TEST command +will recommend you perform various steps to ensure optimal +performance of your LON-CAPA server. +
+ +