Return to how_to_install_loncapa_on_a_preinstalled_system.txt CVS log

Up to [LON-CAPA] / doc

Annotation of doc/how_to_install_loncapa_on_a_preinstalled_system.txt, revision 1.7

1.1       ng          1: Scott Harrison
1.7     ! harris41    2: $Date: 2002/03/01 22:05:13 $; $Revision: 1.6 $
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.5       harris41   14: 
                     15: Also, an important bug that we keep forgetting with redhat 7.1
                     16: and LON-CAPA.  See below:
                     17: 
                     18: !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
1.7     ! harris41   19: !!!!!!!!!  REDHAT 7.*   NOTICE   !!!!!!!!!!!!!!!!!!!!
1.5       harris41   20: !!!!!!!!!  LINE IN Cookie.pm     !!!!!!!!!!!!!!!!!!!!
                     21: !!!!!!!!!  MUST BE REPLACED DUE  !!!!!!!!!!!!!!!!!!!!
                     22: !!!!!!!!!  TO PERL 5.6.0 ERROR   !!!!!!!!!!!!!!!!!!!!
                     23: !!!!!!!!!                        !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
                     24: !!!! The offending line is in CGI/Cookie.pm                           !!
                     25: !!!!                                                                  !!
1.7     ! harris41   26: !!!! it should be changed from                                        !!
        !            27: !!!! $path   = CGI::url(-absolute=>1) unless defined $path;           !!
        !            28: !!!! to                                                               !!
1.5       harris41   29: !!!! ($path = $ENV{'SCRIPT_NAME'})=~s![^/]+$!! unless $path;          !!
                     30: !!!!                                                                  !!
1.7     ! harris41   31: !!!! (This is just below the following line )                         !!
1.5       harris41   32: !!!! # IE requires the path and domain to be present for some reason. !!
                     33: !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
                     34: 
1.1       ng         35: 
1.3       harris41   36: SUMMARY
                     37: 
                     38: This is what has to happen in the installation.
                     39: * Install LON-CAPA files
                     40: * Configure system
                     41: * Make sure you have the right software packages (RPMS)
                     42: 
                     43: Note that
                     44: http://install.lon-capa.org/3.1/latestRPMS
                     45: are generally meant for RedHat 6.2 systems.
                     46: 
                     47: For RedHat 7.1/7.2, you will have to manually
                     48: inspect CVS:doc/otherfiles/rpm_list.txt
                     49: 
                     50: 1. (NOW OPTIONAL).  disable shadow and md5sum passwords
1.1       ng         51: remove 'md5 shadow' from 'password required' lines in
                     52: /etc/pam.d/login
                     53: /etc/pam.d/passwd
                     54: 
                     55: then run /usr/sbin/pwunconv and
                     56: /usr/sbin/grpunconv
                     57: 
                     58: and then, manually enter in all your passwords again
                     59: first for root
                     60: passwd
                     61: and then the usernames...
                     62: passwd username1
                     63: passwd username2
                     64: 
1.3       harris41   65: 2.  make sure you have a web server (apache)
1.1       ng         66: 
                     67: 3.  make sure you have mod_perl
1.3       harris41   68: RedHat 6.2:
                     69: http://install.lon-capa.org/3.1/latestRPMS/mod_perl-1.23-3.i386.rpm
1.1       ng         70: 
1.3       harris41   71: 4. Checkout CVS repository
                     72:   cvs co loncapa (see install.lon-capa.org
                     73: http://install.lon-capa.org/docs/cvsupgrade/
                     74:  for more cvs instructions)
1.1       ng         75: 
                     76: 5.  Install the LON-CAPA-base RPM
1.3       harris41   77: http://install.lon-capa.org/3.1/latestRPMS/LON-CAPA-base-3.1-1.i386.rpm
                     78: rpm -Uvh --force --nodeps LON-CAPA-base-3.1-1.i386.rpm
                     79: 
                     80: If you are using RedHat 7.1, the only file you really need from this
                     81: RPM is tth.so.
                     82: 
                     83: http://install.lon-capa.org/3.1/binaries/tth.so
1.4       harris41   84: should go in
                     85: /usr/lib/perl5/site_perl/5.???/tth.so
1.1       ng         86: 
1.3       harris41   87: 6. Add a user www.
1.1       ng         88:     /usr/sbin/adduser www
                     89: 
1.3       harris41   90: 7. Make sure you have all the needed RPMs
                     91: 
                     92:     The following instructions only work for RedHat 6.2.
                     93:     If you are using RedHat 7.1/7.2, you will need to
                     94:     manually inspect CVS:doc/otherfiles/rpm_list.txt.
                     95: 
                     96:     As root, cd loncapa/loncom/build; make rpmstatuspost
1.1       ng         97:     look at the status of your RPMS
                     98:     http://MACHINENAME/lon-status/rpmstatus.html
                     99: 
                    100:     install/upgrade the ones you don't have
                    101:     probably start with the out-of-date RPMs
                    102:     and then run make rpmstatuspost again
                    103: 
                    104:     install RPMs from the minimal set
                    105:     (you might want to be a little selective here.. like, you
                    106:      don't "need" autofs)
                    107: 
                    108:     install RPMs from the development set
                    109:     (you might want to be a LOT selective here)
                    110: 
                    111: 8.  update LON-CAPA-base files with CVS
                    112:     cvs update -d
                    113:     cd loncom/build
1.3       harris41  114:     make build; make install
                    115: NOTE!!!
1.7     ! harris41  116: REDHAT 7.1 or 7.2  (make DIST='redhat7' build; make DIST='redhat7' install)
1.1       ng        117: 
1.6       harris41  118: 9.  
                    119:     manually edit configuration files
                    120:     (see CVS:doc/build/reconfig.html)
1.3       harris41  121: 
1.1       ng        122: 10. restart all the services
                    123: /etc/rc.d/init.d/httpd restart
                    124: /etc/rc.d/init.d/loncontrol restart
1.3       harris41  125: 
                    126: 11. The next step will be to experiment with your system.
                    127: If you are setting up a machine for test purposes, I recommend
                    128: you set up a domain coordinator.  See CVS:doc/how_to_domain_coordinator.txt