Return to how_to_install_on_RedHat7.2.txt CVS log

Up to [LON-CAPA] / doc

Step by step, cut-and-paste'able info on setting up a lon-capa system on
RedHat 7.2  More work needs to be done on this document, but hopefully it
is a good first step.

$Id: how_to_install_on_RedHat7.2.txt,v 1.1 2002/02/04 11:13:41 matthew Exp $

Install RedHat 7.2 on your system.  Use a 'custom' install and include
the web and sql servers along with any others you need or desire.

1. Add the user www
/usr/sbin/adduser www

2. Determine the user id of www (needed in the next step):
grep ^www /etc/passwd | cut -d':' -f3

3. Work around authentication issues:
wget http://www.wwnet.net/~janc/software/mod_auth_external-2.1.13.tar.gz
tar zxvf mod_auth_external-2.1.13.tar.gz
cd mod_auth_external-2.1.13/pwauth/

edit config.h and change the line:

#define SERVER_UIDS 99          /* user "nobody" */

to

#define SERVER_UIDS 666         /* user "www" */

where 666 is the number that results from step 2 above.

make
cp pwauth /usr/local/sbin
chmod 6755 /usr/local/sbin/pwauth

edit (creating the file) /etc/pam.d/pwauth to have the contents
        auth       required     /lib/security/pam_pwdb.so shadow nullok
        auth       required     /lib/security/pam_nologin.so
        account    required     /lib/security/pam_pwdb.so

4. make sure you have mod_perl and apache on your system

5. Checkout CVS repository (I'm assuming you're already set up for cvs)
cvs co loncapa 

6. Install the needed RPMS

Needed rpms for RH7.2 install and where to get them (sort of)
-------------------------------------------------------------
lon-capa rpms    (install.lon-capa.org)
-------------------
LON-CAPA-base
LON-CAPA-systemperl
LON-CAPA-krb4
LON-CAPA-mysql
LON-CAPA-loncapaconfig
LON-CAPA-barcode

rpms on rpmfind.net (only accept these versions)
------------------------------------------------
ipxutils              ipxutils-2.2.0.18-6.i386.rpm    
netatalk              netatalk-1.5pre6-1rh7.i386.rpm  
libungif-progs        libungif-progs-4.1.0-9.i386.rpm 
libgd                 libgd-1.3-4.i386.rpm            
gnuplot               gnuplot-3.7.1-5.i386.rpm        

rpms on install cds or updates
------------------------------
+ sysreport           sysreport-1.2-1.noarch.rpm   
+ mars-nwe            mars-nwe-0.99pl20-6.i386.rpm 
+ wu-ftpd             wu-ftpd-2.6.1-20.i386.rpm    
+ linuxconf           linuxconf-1.25r7-3.i386.rpm  

install these all with rpm -Uvh, occasionally using --force and/or --nodeps

rpm -Uvh linuxconf-1.25r7-3.i386.rpm
rpm -Uvh sysreport-1.2-1.noarch.rpm   
rpm -Uvh mars-nwe-0.99pl20-6.i386.rpm 
rpm -Uvh wu-ftpd-2.6.1-20.i386.rpm    
rpm -Uvh ipxutils-2.2.0.18-6.i386.rpm    
rpm -Uvh netatalk-1.5pre6-1rh7.i386.rpm  
rpm -Uvh libungif-progs-4.1.0-9.i386.rpm 
rpm -Uvh libgd-1.3-4.i386.rpm            
rpm -Uvh gnuplot-3.7.1-5.i386.rpm        
rpm -Uvh --force --nodeps LON-CAPA-base
rpm -Uvh --force --nodeps rpm -Uvh LON-CAPA-systemperl.rpm
rpm -Uvh --force --nodeps rpm -Uvh LON-CAPA-krb4.rpm
rpm -Uvh --force --nodeps rpm -Uvh LON-CAPA-mysql.rpm
rpm -Uvh --force --nodeps rpm -Uvh LON-CAPA-loncapaconfig.rpm
rpm -Uvh --force --nodeps rpm -Uvh LON-CAPA-barcode.rpm

7. Correct some RPM errors
The Perl modules installed by the systemperl rpm are not in the proper place 
(the rpm was designed for 5.005 and RedHat 7.2 uses 5.6.0).
cd /usr/lib/perl5/site_perl/5.005
cp -R * ../5.6.0/

8. Fix CGI::Cookie.pm

edit /usr/lib/perl5/5.6.0/CGI/Cookie.pm
change the lines:
    # IE requires the path and domain to be present for some reason.
    $path   = CGI::url(-absolute=>1) unless defined $path;          
to:
    # IE requires the path and domain to be present for some reason.
    ($path = $ENV{'SCRIPT_NAME'})=~s![^/]+$!! unless $path;         

9.  update LON-CAPA-base files with CVS
cd ~/loncapa
cvs update -d
cd loncom/build
make DIST='redhat7.1' build; make DIST='redhat7.1' install

10. Update LON-CAPA config files

httpd configuration:

cd /etc/httpd/conf
cp access.conf.lpmlnew access.conf
edit access.conf to reflect the correct information:

PerlSetVar       lonHostID    YOUR LON-HOST ID
PerlSetVar       lonRole      library
PerlSetVar       lonAdmEMail  YOUR EMAIL ADDRESS
PerlSetVar       lonDefDomain YOUR DOMAIN
PerlSetVar       lonLoadLim   2.0
PerlSetVar       lonExpire    86400
PerlSetVar       lonReceipt   A RANDOM NUMBER (REAL, NOT INTEGER)
PerlSetVar       lonSqlAccess   123

Replace the capitalized text with your information

kerberos configuration

edit /etc/krb.conf to reflect your kerberos information

LON-CAPA hosts configuration:

/home/httpd/lonTabs/hosts.tab should be updated 

11. Restart the daemons
/etc/init.d/httpd restart
/etc/init.d/loncontrol restart

12. Updated documentation
Please help us keep our documentation up to date!  If there is something
in this document that was unclear or required further explaination, please help
us help others by improving it!



                 SOME NOTES ON THE RPMS INSTALLED
------------------------------------------------------------------
gnuplot               gnuplot-3.7.1-5.i386.rpm
     USE ONLY THIS VERSION OF GNUPLOT!  Other versions may not have 
     gif support compiled in and dynamically generated plots will fail!
libgd                 libgd-1.3-4.i386.rpm            
     Required by gnuplot