File:  [LON-CAPA] / doc / Attic / how_to_install_loncapa_on_a_preinstalled_system.txt
Revision 1.7: download - view: text, annotated - select for diffs
Sun Apr 14 17:17:32 2002 UTC (22 years, 1 month ago) by harris41
Branches: MAIN
CVS tags: version_0_6_2, version_0_6, version_0_5_1, version_0_5, version_0_4, stable_2002_july, stable_2002_april, STABLE, HEAD
DIST=redhat7 not just redhat7.1

    1: Scott Harrison
    2: $Date: 2002/04/14 17:17:32 $; $Revision: 1.7 $
    3: 
    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.
    8: 
    9: These are the current steps for installing LON-CAPA on an existing
   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
   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.
   14: 
   15: Also, an important bug that we keep forgetting with redhat 7.1
   16: and LON-CAPA.  See below:
   17: 
   18: !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   19: !!!!!!!!!  REDHAT 7.*   NOTICE   !!!!!!!!!!!!!!!!!!!!
   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: !!!!                                                                  !!
   26: !!!! it should be changed from                                        !!
   27: !!!! $path   = CGI::url(-absolute=>1) unless defined $path;           !!
   28: !!!! to                                                               !!
   29: !!!! ($path = $ENV{'SCRIPT_NAME'})=~s![^/]+$!! unless $path;          !!
   30: !!!!                                                                  !!
   31: !!!! (This is just below the following line )                         !!
   32: !!!! # IE requires the path and domain to be present for some reason. !!
   33: !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   34: 
   35: 
   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
   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: 
   65: 2.  make sure you have a web server (apache)
   66: 
   67: 3.  make sure you have mod_perl
   68: RedHat 6.2:
   69: http://install.lon-capa.org/3.1/latestRPMS/mod_perl-1.23-3.i386.rpm
   70: 
   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)
   75: 
   76: 5.  Install the LON-CAPA-base RPM
   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
   84: should go in
   85: /usr/lib/perl5/site_perl/5.???/tth.so
   86: 
   87: 6. Add a user www.
   88:     /usr/sbin/adduser www
   89: 
   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
   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
  114:     make build; make install
  115: NOTE!!!
  116: REDHAT 7.1 or 7.2  (make DIST='redhat7' build; make DIST='redhat7' install)
  117: 
  118: 9.  
  119:     manually edit configuration files
  120:     (see CVS:doc/build/reconfig.html)
  121: 
  122: 10. restart all the services
  123: /etc/rc.d/init.d/httpd restart
  124: /etc/rc.d/init.d/loncontrol restart
  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

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