[BACK]Return to install.html CVS log [TXT] [DIR] Up to [LON-CAPA] / doc / build

Diff for /doc/build/Attic/install.html between versions 1.7 and 1.16

version 1.7, 2000/11/21 15:35:09 version 1.16, 2002/04/23 13:04:54
Line 1 Line 1
 <HTML>  <!-- The LearningOnline Network with CAPA -->
 <HEAD>  <!-- $Id$ -->
 <TITLE>LON-CAPA Installation</TITLE>  <html>
 </HEAD>  <head>
 <BODY>  <title>LON-CAPA Installation</title>
 <H1>LON-CAPA Installation</H1>  <!-- pdfahref install.pdf -->
 <H3>Current Installation Procedure</H3>  <!-- button INSTALL -->
 <P>  </head>
 Scott Harrison  <body bgcolor='#ffffff'>
 </P>  <!-- preamble start -->
 <P>  <br />&nbsp;
 Last updated: 11/21/2000  <p>
 </P>  You will need to check all the following things to ensure proper
 <P>  installation of your LON-CAPA system.
 This is the current list of steps to support LON-CAPA installation.  These steps have  <ul>
 been tested.  <li><a href="#wwwuser">
 <OL>  Creating a user 'www'</a></li>
 <LI>Get Redhat 6.2 on a CD by  <li><a href="#shadow">
 <UL>  Make a LON-CAPA system work with shadow passwords</a></li>
 <LI>Using a RedHat 6.2 CD  <li><a href="#install">
 <LI>Downloading a RedHat 6.2 <A HREF="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and burning a CD  Installing LON-CAPA files</a></li>
 <LI>Or, alternatively do a network install from a <A HREF="http://install.lon-capa.org/3.1/currentcdsource">  <li><a href="#checkrpms">
 RedHat 6.2 CD source tree</A>.  You need to burn a boot floppy disk with a network boot image;  Checking your Linux RPMs</a></li>
 <A HREF="http://install.lon-capa.org/3.1/currentcdsource/images/bootnet-20000407.img">  <li><a href="#mysql">
 bootnet-20000407.img</A>.  (Download the image file; insert a blank floppy disk; and type a  Configuring the MySQL database</a></li>
 command similar to: <TT>dd if=bootnet-20000407.img of=/dev/fd0</TT>).  For installation, you  <li><a href="#testing">
 need to specify <TT>hobbes.lite.msu.edu/~loninst</TT> as your download URL, and <TT>/3.1/currentcdsource</TT>  Testing to see if the LON-CAPA server is operational</a></li>
 as the source location.  </ul>
 </UL>  <br />&nbsp;
 <LI>Install RedHat 6.2  <!-- preamble end -->
 <UL>  <!-- maintext start -->
 <LI><B>Important: Do a "GNOME Workstation Install" and go with their default list of packages</B>  <a name="wwwuser" />
 <LI><B>Important: Make sure you add a user "www"</B>  <h3>Creating a user 'www'</h3>
 </UL>  <p>
 </P>  Execute the following command to create a user named 'www' on your
 <P>  LON-CAPA server:
 After installation, restart the computer.  Login as root.  Enter these two commands:  </p>
 <OL>  <table bgcolor="#aaaaaa" border="1"><tr><td>
 <LI><TT>lynx -source http://install.lon-capa.org/3.1/scripts/postinstall.pl&gt;postinstall.pl</TT>  <tt>/usr/sbin/useradd www</tt>
 <LI><TT>perl postinstall.pl</TT>  </td></tr></table>
 </OL>  <a name="shadow" />
 </P>  <h3>Make a LON-CAPA system work with shadow passwords</h3>
 <P>  <p>
 As postinstall.pl runs, you will be asked various questions.  Follow the instructions to correctly  <table border="1">
 enter in the appropriate parameter values.  <tr><th>Step #</th><th>Description</th></tr>
 </P>  <tr><td>
 <HR>  <font size="+1">1</font>
 <H1>Old steps; do not use these...</H1>  </td><td>
 Last updated: 11/01/2000  <p>Is your system using shadow passwords? (Note: LON-CAPA will
 </P>  work with either MD5/non-MD5 configured systems).  If your
 <P>  system is not using shadow passwords, then do not perform
 This is the current list of steps to support LON-CAPA installation.  These steps have  any of the additional steps.  If your system is using shadow
 been tested.  passwords, then you will need to perform the additional steps below.
 <OL>  </p>
 <LI>Get Redhat 6.2 on a CD by  <p>
 <UL>  <strong>How to detect:</strong>
 <LI>Using a RedHat 6.2 CD  <br />command: <tt>cat /etc/passwd | grep ':x:'</tt>
 <LI>Downloading a RedHat 6.2 <A HREF="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and burning a CD  </p>
 <LI>Or, alternatively do a network install from a <A HREF="http://install.lon-capa.org/3.1/currentcdsource">  <p>If there is output such as "<tt>root:x:0:0:root:/root:/bin/bash</tt>",
 RedHat 6.2 CD source tree</A>.  You need to burn a boot floppy disk with a network boot image;  then your system is using shadow passwords and you will need to continue with
 <A HREF="http://install.lon-capa.org/3.1/currentcdsource/images/bootnet-20000407.img">  the steps below.
 bootnet-20000407.img</A>.  (Download the image file; insert a blank floppy disk; and type a  </p>
 command similar to: <TT>dd if=bootnet-20000407.img of=/dev/fd0</TT>).  For installation, you  </td></tr>
 need to specify <TT>hobbes.lite.msu.edu/~loninst</TT> as your download URL, and <TT>/3.1/currentcdsource</TT>  <tr><td>
 as the source location.  <font size='+1'>2</font>
 </UL>  </td><td>
 <LI>Install RedHat 6.2  <p><strong>Retrieve the mod_auth_external source</strong> by
 <UL>  running the following command
 <LI><B>Important: Do a "GNOME Workstation Install" and go with their default list of packages</B>  </p>
 <LI><B>Important: Make sure you add a user "www"</B>  <p><tt>
 </UL>  wget http://www.wwnet.net/~janc/software/mod_auth_external-2.1.13.tar.gz
 <LI>After installation, install extra RPMs/upgrades by downloading all files from  </tt>
 <A HREF="http://install.lon-capa.org/3.1/SupplementalRPMS/">  </p>
 http://install.lon-capa.org/3.1/SupplementalRPMS</A>.  </td></tr>
 <UL>  <tr><td>
 <LI>Use this command to install the RPMs you download: <TT>rpm -Uvh --force *.rpm</TT>.  <font size='+1'>3</font>
 </UL>  </td><td>
 <LI>Remove extra RPMs by downloading and running the script   <p><strong>More steps...</strong>
 <A HREF="http://install.lon-capa.org/3.1/scripts/remove_extra.sh">  </p>
 http://install.lon-capa.org/3.1/scripts/remove_extra.sh</A> as root.  <p><tt>
 <LI>After installing the supplemental RPMS, install a final RPM set by downloading all files from  There are more steps to include here.
 <A HREF="http://install.lon-capa.org/3.1/FinalRPMS/">  </tt>
 http://install.lon-capa.org/3.1/FinalRPMS</A>.  </p>
 <UL>  </td></tr>
 <LI>Use this command to install the RPMs you download: <TT>rpm -Uvh --force *.rpm</TT>.  </table>
 </UL>  </p>
 <LI>Configure needed files.  <a name="install" />
 <UL>  <h3>Installing LON-CAPA files</h3>
 <LI>Currently, reconfiguration must be handled manually and involves an administrator  <p>
 altering configuration files present throughout the system.  For a list of these  Download the most current
 files and their descriptions, visit <A HREF="http://install.lon-capa.org/3.1/loncapafiles/loncapafiles.html">  <a href="http://install.lon-capa.org/versions/current/loncapa.tar.gz">
 http://install.lon-capa.org/3.1/loncapafiles/loncapafiles.html</A>.  loncapa.tar.gz</a>.
 </UL>  </p>
 <LI>Important files are /etc/httpd/conf/access.conf, /etc/ntp.conf, /etc/krb.conf,    <p>
 /home/httpd/lonTabs/spare.tab, /home/httpd/lonTabs/hosts.tab (if setting up a cluster different  The <strong>UPDATE</strong> command will refresh your filesystem with all
 than MSU's).  the latest LON-CAPA software.
 <LI>Unshadow passwords  </p>
 <UL>  <table bgcolor="#aaaaaa" border="1">
 <PRE>You can do this by these 5 steps:  <tr><td><tt>./UPDATE</tt></td></tr>
 1. enter the system command, as "root", pwunconv  </table>
 2. enter the system command, as "root", grpunconv  <a name="checkrpms" />
 3. Set the following to be the /etc/pam.d/login file on your system  <h3>Checking your Linux RPMs</h3>
 #%PAM-1.0  <p>
 auth       required     /lib/security/pam_securetty.so  The <strong>CHECKRPMS</strong> command will check the RPMs on your machine
 auth       required     /lib/security/pam_pwdb.so shadow nullok  against an FTP repository.
 auth       required     /lib/security/pam_nologin.so  </p>
 account    required     /lib/security/pam_pwdb.so  <table bgcolor="#aaaaaa" border="1">
 password   required     /lib/security/pam_cracklib.so  <tr><td><tt>./CHECKRPMS</tt></td></tr>
 password   required     /lib/security/pam_pwdb.so nullok use_authtok  </table>
 session    required     /lib/security/pam_pwdb.so  <a name="mysql" />
 session    optional     /lib/security/pam_console.so  <h3>Configuring the MySQL database</h3>
 4. Set the following to be the /etc/pam.d/passwd file on your system  <p>
 #%PAM-1.0  The following commands describe how to configure the MySQL database
 auth       required     /lib/security/pam_pwdb.so shadow nullok  on your LON-CAPA server.
 account    required     /lib/security/pam_pwdb.so  </p>
 password   required     /lib/security/pam_cracklib.so retry=3  <table bgcolor="#aaaaaa" border="1"><tr><td>
 password   required     /lib/security/pam_pwdb.so use_authtok nullok  <pre>
 5. Set/reset passwords.  As "root" use 'passwd', and 'passwd www'  Enter the mysql shell---
 to change the important passwords.  This creates crypt-processible  mysql -u root -p mysql
 passwords in /etc/passwd.  
 </PRE>  Run these commands---
 </UL>  CREATE DATABASE loncapa;
 <LI>Run, as root, <TT>ln -s /etc/mime.types /etc/httpd/conf/mime.types</TT>  
 <LI>Run, as root, <TT>/etc/rc.d/init.d/httpd start</TT>.  INSERT INTO user (Host, User, Password)
 <LI>Run, as root, <TT>/etc/rc.d/init.d/loncontrol start</TT>.  VALUES ('localhost','www',password('SOMEPASSWORD'));
 <LI>After 10 minutes, you should be able to check the file <TT>/home/httpd/html/lon-status/index.html</TT>  
 to see if your machine has been successfully set up.  GRANT ALL PRIVILEGES ON *.* TO www@localhost;
 </UL>  
 </OL>  FLUSH PRIVILEGES;
 </P>  
 <H3>Future Installation Procedure (not yet implemented)</H3>  shell> mysql -u root mysql
 <P>  mysql> SET PASSWORD FOR root@localhost=PASSWORD('new_password');
 In the future, LON-CAPA Installation will be distributed on a CD complete with a  </pre>
 customized interface.  Many elements for doing this have been coded, and are in place, but  </td></tr></table>
 it awaits completion.  <a name="testing" />
 </P>  <h3>Testing to see if the LON-CAPA server is operational</h3>
 </BODY>  <p>
 </HTML>  The <strong>TEST</strong> command will check the installation software,
   the perl libraries on your system, the MySQL database, and
   will also automatically test the real-time operation of the 
   LON-CAPA Apache web server.
   </p>
   <table bgcolor="#aaaaaa" border="1">
   <tr><td><tt>./TEST</tt></td></tr>
   </table>
   <p>
   Using the <strong>TEST</strong> command will likely
   be an iterative process.
   It is normal to expect that the <strong>TEST</strong> command
   will recommend you perform various steps to ensure optimal
   performance of your LON-CAPA server.
   </p>
   <!-- maintext end -->
   </body>
   </html>
Removed from v.1.7  
changed lines
  Added in v.1.16

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