--- doc/build/Attic/install.html	2001/12/01 21:34:48	1.11
+++ doc/build/Attic/install.html	2002/04/23 12:46:58	1.15
@@ -1,51 +1,148 @@
 <!-- The LearningOnline Network with CAPA -->
-<!-- $Id: install.html,v 1.11 2001/12/01 21:34:48 harris41 Exp $ -->
+<!-- $Id: install.html,v 1.15 2002/04/23 12:46:58 harris41 Exp $ -->
 <html>
 <head>
 <title>LON-CAPA Installation</title>
+<!-- pdfahref install.pdf -->
+<!-- button INSTALL -->
 </head>
-<body>
-<h1>LON-CAPA Installation</h1>
-<h3>Current Installation Procedure</h3>
-<p>
-Scott Harrison
-</p>
-<p>$Date: 2001/12/01 21:34:48 $; $Revision: 1.11 $</p>
-<p>
-This is the current list of steps to support LON-CAPA installation.  These
-steps have been tested.</p>
-<ol>
-<li>Get LON-CAPA on a CD by
-<ul>
-<li>Requesting a LON-CAPA installation CD (c/o Helen Keefe, 
-helen@lon-capa.org).</li>
-<li>Or, downloading a LON-CAPA installation
-<a href="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and
-burning a CD.</li>
-<li>(Depending on whether your computer has a bootable CD-ROM, you may
-need to also make a boot floppy.  Download this floppy disk image file: 
-<a href=
-"http://install.lon-capa.org/3.1/currentcdsource/images/boot-20000407.img">
-boot-20000407.img</a>.  (Download the image file; insert a blank floppy disk;
-and type this command: <tt>dd if=boot-20000407.img of=/dev/fd0</tt>).</li>
-</ul></li>
-<li>Install with CD-ROM
+<body bgcolor='#ffffff'>
+<!-- preamble start -->
+<br />&nbsp;
+<p>
+You will need to check all the following things to ensure proper
+installation of your LON-CAPA system.
 <ul>
-<li>Follow the <A HREF="instructions_with_cd.html">
-CD-ROM installation instructions</a></li>
-</ul></li>
-<li>After installation, restart the computer.  Login as root.  Enter this
-command (you only need to do this after your first reboot):
-<ol>
-<li><tt>sh /usr/sbin/loncapa_configure</tt></li>
-</ol></li>
-</ol>
-<hr />
-<p>
-You can also try to install LON-CAPA on an existing installation of
-RedHat 6.2.  Please see <a
-href='how_to_install_loncapa_on_a_preinstalled_system.txt'>
-how_to_install_loncapa_on_a_preinstalled_system.txt</a>.
+<li><a href="#wwwuser">
+Creating a user 'www'</a></li>
+<li><a href="#shadow">
+Make a LON-CAPA system work with shadow passwords</a></li>
+<li><a href="#install">
+Installing LON-CAPA files</a></li>
+<li><a href="#checkrpms">
+Checking your Linux RPMs</a></li>
+<li><a href="#mysql">
+Configuring the MySQL database</a></li>
+<li><a href="#testing">
+Testing to see if the LON-CAPA server is operational</a></li>
+</ul>
+<br />&nbsp;
+<!-- preamble end -->
+<!-- maintext start -->
+<a name="wwwuser" />
+<h3>Creating a user 'www'</h3>
+<p>
+Execute the following command to create a user named 'www' on your
+LON-CAPA server:
+</p>
+<table bgcolor="#aaaaaa" border="1"><tr><td>
+<tt>/usr/sbin/useradd www</tt>
+</td></tr></table>
+<a name="shadow" />
+<h3>Make a LON-CAPA system work with shadow passwords</h3>
+<p>
+<table border="1">
+<tr><th>Step #</th><th>Description</th></tr>
+<tr><td>
+<font size="+1">1</font>
+</td><td>
+<p>Is your system using shadow passwords? (Note: LON-CAPA will
+work with either MD5/non-MD5 configured systems).  If your
+system is not using shadow passwords, then do not perform
+any of the additional steps.  If your system is using shadow
+passwords, then you will need to perform the additional steps below.
+</p>
+<p>
+<strong>How to detect:</strong>
+<br />command: <tt>cat /etc/passwd | grep ':x:'</tt>
+</p>
+<p>If there is output such as "<tt>root:x:0:0:root:/root:/bin/bash</tt>",
+then your system is using shadow passwords and you will need to continue with
+the steps below.
+</p>
+</td></tr>
+<tr><td>
+<font size='+1'>2</font>
+</td><td>
+<p><strong>Retrieve the mod_auth_external source</strong> by
+running the following command
+</p>
+<p><tt>
+wget http://www.wwnet.net/~janc/software/mod_auth_external-2.1.13.tar.gz
+</tt>
+</p>
+</td></tr>
+<tr><td>
+<font size='+1'>3</font>
+</td><td>
+<p><strong>More steps...</strong>
+</p>
+<p><tt>
+There are more steps to include here.
+</tt>
+</p>
+</td></tr>
+</table>
+</p>
+<a name="install" />
+<h3>Installing LON-CAPA files</h3>
+<p>
+Download the most current
+<a href="http://install.lon-capa.org/versions/current/loncapa.tar.gz">
+loncapa.tar.gz</a>.
+</p>
+<p>
+The <strong>UPDATE</strong> command will refresh your filesystem with all
+the latest LON-CAPA software.
+</p>
+<table bgcolor="#aaaaaa" border="1">
+<tr><td><tt>./UPDATE</tt></td></tr>
+</table>
+<a name="checkrpms" />
+<h3>Checking your Linux RPMs</h3>
+<p>
+The <strong>CHECKRPMS</strong> command will check the RPMs on your machine
+against an FTP repository.
+</p>
+<table bgcolor="#aaaaaa" border="1">
+<tr><td><tt>./CHECKRPMS</tt></td></tr>
+</table>
+<a name="mysql" />
+<h3>Configuring the MySQL database</h3>
+<p>
+The following commands describe how to configure the MySQL database
+on your LON-CAPA server.
+</p>
+<table bgcolor="#aaaaaa" border="1"><tr><td>
+<pre>
+Enter the mysql shell---
+mysql -u root -p mysql
+
+Run these commands---
+CREATE DATABASE loncapa;
+
+INSERT INTO user (Host, User, Password)
+VALUES ('localhost','www',password('SOMEPASSWORD'));
+
+GRANT ALL PRIVILEGES ON *.* TO www@localhost;
+
+FLUSH PRIVILEGES;
+
+shell> mysql -u root mysql
+mysql> SET PASSWORD FOR root@localhost=PASSWORD('new_password');
+</pre>
+</td></tr></table>
+<a name="testing" />
+<h3>Testing to see if the LON-CAPA server is operational</h3>
+<p>
+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>
+<!-- maintext end -->
 </body>
 </html>
