File:  [LON-CAPA] / doc / Attic / how_to_install_loncapa_on_a_preinstalled_system.txt
Revision 1.3: download - view: text, annotated - select for diffs
Wed Dec 12 14:31:35 2001 UTC (20 years, 8 months ago) by harris41
Branches: MAIN
CVS tags: HEAD
adding in redhat 7.* specific notes -Scott Harrison

Scott Harrison
$Date: 2001/12/12 14:31:35 $; $Revision: 1.3 $

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.

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

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>