Annotation of doc/how_to_install_loncapa_on_a_preinstalled_system.txt, revision 1.5

1.1       ng          1: Scott Harrison
1.5     ! harris41    2: $Date: 2001/12/12 14:34:03 $; $Revision: 1.4 $
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: !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
        !            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: 
1.1       ng         39: 
1.3       harris41   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
1.1       ng         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: 
1.3       harris41   69: 2.  make sure you have a web server (apache)
1.1       ng         70: 
                     71: 3.  make sure you have mod_perl
1.3       harris41   72: RedHat 6.2:
                     73: http://install.lon-capa.org/3.1/latestRPMS/mod_perl-1.23-3.i386.rpm
1.1       ng         74: 
1.3       harris41   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)
1.1       ng         79: 
                     80: 5.  Install the LON-CAPA-base RPM
1.3       harris41   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
1.4       harris41   88: should go in
                     89: /usr/lib/perl5/site_perl/5.???/tth.so
1.1       ng         90: 
1.3       harris41   91: 6. Add a user www.
1.1       ng         92:     /usr/sbin/adduser www
                     93: 
1.3       harris41   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
1.1       ng        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
1.3       harris41  118:     make build; make install
                    119: NOTE!!!
                    120: REDHAT 7.1 or 7.2  (make DIST='redhat7.1' build; make DIST='redhat7.1' install)
1.1       ng        121: 
                    122: 9.  run /usr/sbin/loncapaconfig and change the settings on your
                    123:     machine
                    124: 
1.3       harris41  125:     OR
                    126: 
                    127:     manually edit 
                    128:     /etc/krb.conf
                    129:     /etc/httpd/conf/access.conf
                    130:     /home/httpd/lonTabs/hosts.tab
                    131: 
1.1       ng        132: 10. restart all the services
                    133: /etc/rc.d/init.d/httpd restart
                    134: /etc/rc.d/init.d/loncontrol restart
1.3       harris41  135: 
                    136: 11. The next step will be to experiment with your system.
                    137: If you are setting up a machine for test purposes, I recommend
                    138: you set up a domain coordinator.  See CVS:doc/how_to_domain_coordinator.txt

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