File:  [LON-CAPA] / doc / Attic / how_to_install_loncapa_on_a_preinstalled_system.txt
Revision 1.6: download - view: text, annotated - select for diffs
Fri Mar 1 22:05:13 2002 UTC (22 years, 2 months ago) by harris41
Branches: MAIN
CVS tags: HEAD
removing reference to loncapaconfig

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

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