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>