--- doc/Attic/how_to_install_loncapa_on_a_preinstalled_system.txt	2001/06/21 22:16:31	1.1
+++ doc/Attic/how_to_install_loncapa_on_a_preinstalled_system.txt	2001/12/12 22:29:00	1.5
@@ -1,12 +1,57 @@
 Scott Harrison
-June 21, 2001
+$Date: 2001/12/12 22:29:00 $; $Revision: 1.5 $
 
-NORMAL PEOPLE INSTALL LON-CAPA WITH THE INSTALLATION
-CD ON A FRESH SYSTEM.
+The standard process is to install LON-CAPA with an installation
+CD on a fresh system.  We provide this document as a secondary
+service to those who wish to install and experiment on an existing
+Linux system.
+
+These are the current steps for installing LON-CAPA on an existing
+RedHat 6.2 system.  Where possible, I have tried to indicate steps
+for RedHat 7.1.  Please note that step 1 is optional.  You can
+run LON-CAPA on a shadow-based system.  However, you need to follow
+steps at http://install.lon-capa.org/docs/loncapapasswordauthentication.html.
+
+Also, an important bug that we keep forgetting with redhat 7.1
+and LON-CAPA.  See below:
+
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+!!!!!!!!!  REDHAT 7.1   NOTICE   !!!!!!!!!!!!!!!!!!!!
+!!!!!!!!!  LINE IN Cookie.pm     !!!!!!!!!!!!!!!!!!!!
+!!!!!!!!!  MUST BE REPLACED DUE  !!!!!!!!!!!!!!!!!!!!
+!!!!!!!!!  TO PERL 5.6.0 ERROR   !!!!!!!!!!!!!!!!!!!!
+!!!!!!!!!                        !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+!!!! 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;          !!
+!!!!                                                                  !!
+!!!! to                                                               !!
+!!!!                                                                  !!
+!!!!                                                                  !!
+!!!! # IE requires the path and domain to be present for some reason. !!
+!!!! $path   = CGI::url(-absolute=>1) unless defined $path;           !!
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+
+SUMMARY
+
+This is what has to happen in the installation.
+* Install LON-CAPA files
+* Configure system
+* Make sure you have the right software packages (RPMS)
+
+Note that
+http://install.lon-capa.org/3.1/latestRPMS
+are generally meant for RedHat 6.2 systems.
 
-IF YOU ARE A FREAKZOID, READ BELOW.
+For RedHat 7.1/7.2, you will have to manually
+inspect CVS:doc/otherfiles/rpm_list.txt
 
-1.  disable shadow and md5sum passwords
+1. (NOW OPTIONAL).  disable shadow and md5sum passwords
 remove 'md5 shadow' from 'password required' lines in
 /etc/pam.d/login
 /etc/pam.d/passwd
@@ -21,22 +66,38 @@ and then the usernames...
 passwd username1
 passwd username2
 
-2.  make sure you have a web server
+2.  make sure you have a web server (apache)
 
 3.  make sure you have mod_perl
-http://install.lon-capa.org/3.1/currentcdsource/RedHat/RPMS/mod_perl-1.23-3.i386.rpm
+RedHat 6.2:
+http://install.lon-capa.org/3.1/latestRPMS/mod_perl-1.23-3.i386.rpm
 
-4.  cvs co loncapa (see install.lon-capa.org for instructions)
+4. Checkout CVS repository
+  cvs co loncapa (see install.lon-capa.org
+http://install.lon-capa.org/docs/cvsupgrade/
+ for more cvs instructions)
 
 5.  Install the LON-CAPA-base RPM
-http://install.lon-capa.org/3.1/currentcdsource/RedHat/RPMS/LON-CAPA-base-3.1-1.i386.rpm
-rpm -Uvh --force --nodeps /home/ng/RPMS/LON-CAPA-base-3.1-1.i386.rpm
+http://install.lon-capa.org/3.1/latestRPMS/LON-CAPA-base-3.1-1.i386.rpm
+rpm -Uvh --force --nodeps LON-CAPA-base-3.1-1.i386.rpm
 
-6.  Add a user www.
+If you are using RedHat 7.1, the only file you really need from this
+RPM is tth.so.
+
+http://install.lon-capa.org/3.1/binaries/tth.so
+should go in
+/usr/lib/perl5/site_perl/5.???/tth.so
+
+6. Add a user www.
     /usr/sbin/adduser www
 
-7.  make sure you have all the needed RPMs
-    as root, cd loncapa/loncom/build; make rpmstatuspost
+7. Make sure you have all the needed RPMs
+
+    The following instructions only work for RedHat 6.2.
+    If you are using RedHat 7.1/7.2, you will need to
+    manually inspect CVS:doc/otherfiles/rpm_list.txt.
+
+    As root, cd loncapa/loncom/build; make rpmstatuspost
     look at the status of your RPMS
     http://MACHINENAME/lon-status/rpmstatus.html
 
@@ -54,11 +115,24 @@ rpm -Uvh --force --nodeps /home/ng/RPMS/
 8.  update LON-CAPA-base files with CVS
     cvs update -d
     cd loncom/build
-    make install; make configinstall
+    make build; make install
+NOTE!!!
+REDHAT 7.1 or 7.2  (make DIST='redhat7.1' build; make DIST='redhat7.1' install)
 
 9.  run /usr/sbin/loncapaconfig and change the settings on your
     machine
 
+    OR
+
+    manually edit 
+    /etc/krb.conf
+    /etc/httpd/conf/access.conf
+    /home/httpd/lonTabs/hosts.tab
+
 10. restart all the services
 /etc/rc.d/init.d/httpd restart
 /etc/rc.d/init.d/loncontrol restart
+
+11. The next step will be to experiment with your system.
+If you are setting up a machine for test purposes, I recommend
+you set up a domain coordinator.  See CVS:doc/how_to_domain_coordinator.txt