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
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>