--- doc/build/Attic/install.html	2001/02/22 15:48:35	1.9
+++ doc/build/Attic/install.html	2002/04/23 13:04:54	1.16
@@ -1,39 +1,155 @@
-<HTML>
-<HEAD>
-<TITLE>LON-CAPA Installation</TITLE>
-</HEAD>
-<BODY>
-<H1>LON-CAPA Installation</H1>
-<H3>Current Installation Procedure</H3>
-<P>
-Scott Harrison
-</P>
-<P>
-Last updated: 02/22/2001
-</P>
-<P>
-This is the current list of steps to support LON-CAPA installation.  These steps have
-been tested.
-<OL>
-<LI>Get LON-CAPA on a CD by
-<UL>
-<LI>Requesting a LON-CAPA installation CD (c/o Dr. Kortemeyer, 
-korte@lon-capa.org).
-<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>(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>).
-</UL>
-<LI>Install with CD-ROM
-<UL>
-<LI>Follow the <A HREF="instructions_with_cd.html">
-CD-ROM installation instructions</A>
-</UL>
-<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>
-</OL>
-</OL>
-</BODY>
-</HTML>
+<!-- The LearningOnline Network with CAPA -->
+<!-- $Id: install.html,v 1.16 2002/04/23 13:04:54 harris41 Exp $ -->
+<html>
+<head>
+<title>LON-CAPA Installation</title>
+<!-- pdfahref install.pdf -->
+<!-- button INSTALL -->
+</head>
+<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><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>
+<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>
