Scott Harrison $Date: 2002/04/14 17:17:32 $; $Revision: 1.7 $ 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.* NOTICE !!!!!!!!!!!!!!!!!!!! !!!!!!!!! LINE IN Cookie.pm !!!!!!!!!!!!!!!!!!!! !!!!!!!!! MUST BE REPLACED DUE !!!!!!!!!!!!!!!!!!!! !!!!!!!!! TO PERL 5.6.0 ERROR !!!!!!!!!!!!!!!!!!!! !!!!!!!!! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !!!! The offending line is in CGI/Cookie.pm !! !!!! !! !!!! 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. !! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 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. For RedHat 7.1/7.2, you will have to manually inspect CVS:doc/otherfiles/rpm_list.txt 1. (NOW OPTIONAL). disable shadow and md5sum passwords remove 'md5 shadow' from 'password required' lines in /etc/pam.d/login /etc/pam.d/passwd then run /usr/sbin/pwunconv and /usr/sbin/grpunconv and then, manually enter in all your passwords again first for root passwd and then the usernames... passwd username1 passwd username2 2. make sure you have a web server (apache) 3. make sure you have mod_perl RedHat 6.2: http://install.lon-capa.org/3.1/latestRPMS/mod_perl-1.23-3.i386.rpm 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/latestRPMS/LON-CAPA-base-3.1-1.i386.rpm rpm -Uvh --force --nodeps LON-CAPA-base-3.1-1.i386.rpm 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 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 install/upgrade the ones you don't have probably start with the out-of-date RPMs and then run make rpmstatuspost again install RPMs from the minimal set (you might want to be a little selective here.. like, you don't "need" autofs) install RPMs from the development set (you might want to be a LOT selective here) 8. update LON-CAPA-base files with CVS cvs update -d cd loncom/build make build; make install NOTE!!! REDHAT 7.1 or 7.2 (make DIST='redhat7' build; make DIST='redhat7' install) 9. manually edit configuration files (see CVS:doc/build/reconfig.html) 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