Annotation of doc/how_to_install_loncapa_on_a_preinstalled_system.txt, revision 1.4

1.1       ng          1: Scott Harrison
1.4     ! harris41    2: $Date: 2001/12/12 14:31:35 $; $Revision: 1.3 $
1.1       ng          3: 
1.2       harris41    4: The standard process is to install LON-CAPA with an installation
                      5: CD on a fresh system.  We provide this document as a secondary
                      6: service to those who wish to install and experiment on an existing
                      7: Linux system.
1.1       ng          8: 
1.2       harris41    9: These are the current steps for installing LON-CAPA on an existing
1.3       harris41   10: RedHat 6.2 system.  Where possible, I have tried to indicate steps
                     11: for RedHat 7.1.  Please note that step 1 is optional.  You can
1.2       harris41   12: run LON-CAPA on a shadow-based system.  However, you need to follow
                     13: steps at http://install.lon-capa.org/docs/loncapapasswordauthentication.html.
1.1       ng         14: 
1.3       harris41   15: SUMMARY
                     16: 
                     17: This is what has to happen in the installation.
                     18: * Install LON-CAPA files
                     19: * Configure system
                     20: * Make sure you have the right software packages (RPMS)
                     21: 
                     22: Note that
                     23: http://install.lon-capa.org/3.1/latestRPMS
                     24: are generally meant for RedHat 6.2 systems.
                     25: 
                     26: For RedHat 7.1/7.2, you will have to manually
                     27: inspect CVS:doc/otherfiles/rpm_list.txt
                     28: 
                     29: 1. (NOW OPTIONAL).  disable shadow and md5sum passwords
1.1       ng         30: remove 'md5 shadow' from 'password required' lines in
                     31: /etc/pam.d/login
                     32: /etc/pam.d/passwd
                     33: 
                     34: then run /usr/sbin/pwunconv and
                     35: /usr/sbin/grpunconv
                     36: 
                     37: and then, manually enter in all your passwords again
                     38: first for root
                     39: passwd
                     40: and then the usernames...
                     41: passwd username1
                     42: passwd username2
                     43: 
1.3       harris41   44: 2.  make sure you have a web server (apache)
1.1       ng         45: 
                     46: 3.  make sure you have mod_perl
1.3       harris41   47: RedHat 6.2:
                     48: http://install.lon-capa.org/3.1/latestRPMS/mod_perl-1.23-3.i386.rpm
1.1       ng         49: 
1.3       harris41   50: 4. Checkout CVS repository
                     51:   cvs co loncapa (see install.lon-capa.org
                     52: http://install.lon-capa.org/docs/cvsupgrade/
                     53:  for more cvs instructions)
1.1       ng         54: 
                     55: 5.  Install the LON-CAPA-base RPM
1.3       harris41   56: http://install.lon-capa.org/3.1/latestRPMS/LON-CAPA-base-3.1-1.i386.rpm
                     57: rpm -Uvh --force --nodeps LON-CAPA-base-3.1-1.i386.rpm
                     58: 
                     59: If you are using RedHat 7.1, the only file you really need from this
                     60: RPM is tth.so.
                     61: 
                     62: http://install.lon-capa.org/3.1/binaries/tth.so
1.4     ! harris41   63: should go in
        !            64: /usr/lib/perl5/site_perl/5.???/tth.so
1.1       ng         65: 
1.3       harris41   66: 6. Add a user www.
1.1       ng         67:     /usr/sbin/adduser www
                     68: 
1.3       harris41   69: 7. Make sure you have all the needed RPMs
                     70: 
                     71:     The following instructions only work for RedHat 6.2.
                     72:     If you are using RedHat 7.1/7.2, you will need to
                     73:     manually inspect CVS:doc/otherfiles/rpm_list.txt.
                     74: 
                     75:     As root, cd loncapa/loncom/build; make rpmstatuspost
1.1       ng         76:     look at the status of your RPMS
                     77:     http://MACHINENAME/lon-status/rpmstatus.html
                     78: 
                     79:     install/upgrade the ones you don't have
                     80:     probably start with the out-of-date RPMs
                     81:     and then run make rpmstatuspost again
                     82: 
                     83:     install RPMs from the minimal set
                     84:     (you might want to be a little selective here.. like, you
                     85:      don't "need" autofs)
                     86: 
                     87:     install RPMs from the development set
                     88:     (you might want to be a LOT selective here)
                     89: 
                     90: 8.  update LON-CAPA-base files with CVS
                     91:     cvs update -d
                     92:     cd loncom/build
1.3       harris41   93:     make build; make install
                     94: NOTE!!!
                     95: REDHAT 7.1 or 7.2  (make DIST='redhat7.1' build; make DIST='redhat7.1' install)
1.1       ng         96: 
                     97: 9.  run /usr/sbin/loncapaconfig and change the settings on your
                     98:     machine
                     99: 
1.3       harris41  100:     OR
                    101: 
                    102:     manually edit 
                    103:     /etc/krb.conf
                    104:     /etc/httpd/conf/access.conf
                    105:     /home/httpd/lonTabs/hosts.tab
                    106: 
1.1       ng        107: 10. restart all the services
                    108: /etc/rc.d/init.d/httpd restart
                    109: /etc/rc.d/init.d/loncontrol restart
1.3       harris41  110: 
                    111: 11. The next step will be to experiment with your system.
                    112: If you are setting up a machine for test purposes, I recommend
                    113: you set up a domain coordinator.  See CVS:doc/how_to_domain_coordinator.txt

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>