Scott Harrison
$Date: 2001/12/12 22:29:00 $; $Revision: 1.5 $
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.
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.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
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>