Annotation of doc/build/install.html, revision 1.8

1.1       harris41    1: <HTML>
                      2: <HEAD>
                      3: <TITLE>LON-CAPA Installation</TITLE>
                      4: </HEAD>
                      5: <BODY>
                      6: <H1>LON-CAPA Installation</H1>
                      7: <H3>Current Installation Procedure</H3>
                      8: <P>
1.4       harris41    9: Scott Harrison
                     10: </P>
                     11: <P>
1.7       harris41   12: Last updated: 11/21/2000
                     13: </P>
                     14: <P>
                     15: This is the current list of steps to support LON-CAPA installation.  These steps have
                     16: been tested.
                     17: <OL>
                     18: <LI>Get Redhat 6.2 on a CD by
                     19: <UL>
                     20: <LI>Using a RedHat 6.2 CD
                     21: <LI>Downloading a RedHat 6.2 <A HREF="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and burning a CD
                     22: <LI>Or, alternatively do a network install from a <A HREF="http://install.lon-capa.org/3.1/currentcdsource">
                     23: RedHat 6.2 CD source tree</A>.  You need to burn a boot floppy disk with a network boot image;
                     24: <A HREF="http://install.lon-capa.org/3.1/currentcdsource/images/bootnet-20000407.img">
                     25: bootnet-20000407.img</A>.  (Download the image file; insert a blank floppy disk; and type a
                     26: command similar to: <TT>dd if=bootnet-20000407.img of=/dev/fd0</TT>).  For installation, you
                     27: need to specify <TT>hobbes.lite.msu.edu/~loninst</TT> as your download URL, and <TT>/3.1/currentcdsource</TT>
                     28: as the source location.
                     29: </UL>
                     30: <LI>Install RedHat 6.2
                     31: <UL>
                     32: <LI><B>Important: Do a "GNOME Workstation Install" and go with their default list of packages</B>
                     33: <LI><B>Important: Make sure you add a user "www"</B>
                     34: </UL>
1.8     ! harris41   35: <LI>After installation, restart the computer.  Login as root.  Enter these two commands:
1.7       harris41   36: <OL>
                     37: <LI><TT>lynx -source http://install.lon-capa.org/3.1/scripts/postinstall.pl&gt;postinstall.pl</TT>
                     38: <LI><TT>perl postinstall.pl</TT>
                     39: </OL>
1.8     ! harris41   40: <LI>As postinstall.pl runs, you will be asked various questions.  Follow the instructions to correctly
1.7       harris41   41: enter in the appropriate parameter values.
1.8     ! harris41   42: </OL>
1.7       harris41   43: <HR>
                     44: <H1>Old steps; do not use these...</H1>
1.5       harris41   45: Last updated: 11/01/2000
1.4       harris41   46: </P>
                     47: <P>
1.1       harris41   48: This is the current list of steps to support LON-CAPA installation.  These steps have
1.3       harris41   49: been tested.
1.1       harris41   50: <OL>
                     51: <LI>Get Redhat 6.2 on a CD by
                     52: <UL>
                     53: <LI>Using a RedHat 6.2 CD
1.2       harris41   54: <LI>Downloading a RedHat 6.2 <A HREF="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and burning a CD
                     55: <LI>Or, alternatively do a network install from a <A HREF="http://install.lon-capa.org/3.1/currentcdsource">
1.1       harris41   56: RedHat 6.2 CD source tree</A>.  You need to burn a boot floppy disk with a network boot image;
1.2       harris41   57: <A HREF="http://install.lon-capa.org/3.1/currentcdsource/images/bootnet-20000407.img">
1.1       harris41   58: bootnet-20000407.img</A>.  (Download the image file; insert a blank floppy disk; and type a
                     59: command similar to: <TT>dd if=bootnet-20000407.img of=/dev/fd0</TT>).  For installation, you
1.6       harris41   60: need to specify <TT>hobbes.lite.msu.edu/~loninst</TT> as your download URL, and <TT>/3.1/currentcdsource</TT>
1.1       harris41   61: as the source location.
                     62: </UL>
                     63: <LI>Install RedHat 6.2
                     64: <UL>
                     65: <LI><B>Important: Do a "GNOME Workstation Install" and go with their default list of packages</B>
                     66: <LI><B>Important: Make sure you add a user "www"</B>
                     67: </UL>
                     68: <LI>After installation, install extra RPMs/upgrades by downloading all files from
1.2       harris41   69: <A HREF="http://install.lon-capa.org/3.1/SupplementalRPMS/">
                     70: http://install.lon-capa.org/3.1/SupplementalRPMS</A>.
1.1       harris41   71: <UL>
                     72: <LI>Use this command to install the RPMs you download: <TT>rpm -Uvh --force *.rpm</TT>.
                     73: </UL>
                     74: <LI>Remove extra RPMs by downloading and running the script 
1.2       harris41   75: <A HREF="http://install.lon-capa.org/3.1/scripts/remove_extra.sh">
                     76: http://install.lon-capa.org/3.1/scripts/remove_extra.sh</A> as root.
1.3       harris41   77: <LI>After installing the supplemental RPMS, install a final RPM set by downloading all files from
                     78: <A HREF="http://install.lon-capa.org/3.1/FinalRPMS/">
                     79: http://install.lon-capa.org/3.1/FinalRPMS</A>.
                     80: <UL>
                     81: <LI>Use this command to install the RPMs you download: <TT>rpm -Uvh --force *.rpm</TT>.
                     82: </UL>
1.1       harris41   83: <LI>Configure needed files.
                     84: <UL>
                     85: <LI>Currently, reconfiguration must be handled manually and involves an administrator
                     86: altering configuration files present throughout the system.  For a list of these
1.3       harris41   87: files and their descriptions, visit <A HREF="http://install.lon-capa.org/3.1/loncapafiles/loncapafiles.html">
                     88: http://install.lon-capa.org/3.1/loncapafiles/loncapafiles.html</A>.
1.5       harris41   89: </UL>
1.1       harris41   90: <LI>Important files are /etc/httpd/conf/access.conf, /etc/ntp.conf, /etc/krb.conf,  
                     91: /home/httpd/lonTabs/spare.tab, /home/httpd/lonTabs/hosts.tab (if setting up a cluster different
1.3       harris41   92: than MSU's).
1.5       harris41   93: <LI>Unshadow passwords
                     94: <UL>
                     95: <PRE>You can do this by these 5 steps:
                     96: 1. enter the system command, as "root", pwunconv
                     97: 2. enter the system command, as "root", grpunconv
                     98: 3. Set the following to be the /etc/pam.d/login file on your system
                     99: #%PAM-1.0
                    100: auth       required     /lib/security/pam_securetty.so
                    101: auth       required     /lib/security/pam_pwdb.so shadow nullok
                    102: auth       required     /lib/security/pam_nologin.so
                    103: account    required     /lib/security/pam_pwdb.so
                    104: password   required     /lib/security/pam_cracklib.so
                    105: password   required     /lib/security/pam_pwdb.so nullok use_authtok
                    106: session    required     /lib/security/pam_pwdb.so
                    107: session    optional     /lib/security/pam_console.so
                    108: 4. Set the following to be the /etc/pam.d/passwd file on your system
                    109: #%PAM-1.0
                    110: auth       required     /lib/security/pam_pwdb.so shadow nullok
                    111: account    required     /lib/security/pam_pwdb.so
                    112: password   required     /lib/security/pam_cracklib.so retry=3
                    113: password   required     /lib/security/pam_pwdb.so use_authtok nullok
                    114: 5. Set/reset passwords.  As "root" use 'passwd', and 'passwd www'
                    115: to change the important passwords.  This creates crypt-processible
                    116: passwords in /etc/passwd.
                    117: </PRE>
                    118: </UL>
                    119: <LI>Run, as root, <TT>ln -s /etc/mime.types /etc/httpd/conf/mime.types</TT>
                    120: <LI>Run, as root, <TT>/etc/rc.d/init.d/httpd start</TT>.
1.3       harris41  121: <LI>Run, as root, <TT>/etc/rc.d/init.d/loncontrol start</TT>.
1.1       harris41  122: <LI>After 10 minutes, you should be able to check the file <TT>/home/httpd/html/lon-status/index.html</TT>
                    123: to see if your machine has been successfully set up.
                    124: </UL>
                    125: </OL>
                    126: </P>
                    127: <H3>Future Installation Procedure (not yet implemented)</H3>
                    128: <P>
                    129: In the future, LON-CAPA Installation will be distributed on a CD complete with a
                    130: customized interface.  Many elements for doing this have been coded, and are in place, but
                    131: it awaits completion.
                    132: </P>
                    133: </BODY>
                    134: </HTML>

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