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

version 1.9, 2001/02/22 15:48:35 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: 02/22/2001  <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 LON-CAPA on a CD by  <li><a href="#shadow">
 <UL>  Make a LON-CAPA system work with shadow passwords</a></li>
 <LI>Requesting a LON-CAPA installation CD (c/o Dr. Kortemeyer,   <li><a href="#install">
 korte@lon-capa.org).  Installing LON-CAPA files</a></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><a href="#checkrpms">
 <LI>(Depending on whether your computer has a bootable CD-ROM, you may  Checking your Linux RPMs</a></li>
 need to also make a boot floppy.  Download this floppy disk image file:   <li><a href="#mysql">
 <A HREF="http://install.lon-capa.org/3.1/currentcdsource/images/boot-20000407.img">  Configuring the MySQL database</a></li>
 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><a href="#testing">
 </UL>  Testing to see if the LON-CAPA server is operational</a></li>
 <LI>Install with CD-ROM  </ul>
 <UL>  <br />&nbsp;
 <LI>Follow the <A HREF="instructions_with_cd.html">  <!-- preamble end -->
 CD-ROM installation instructions</A>  <!-- maintext start -->
 </UL>  <a name="wwwuser" />
 <LI>After installation, restart the computer.  Login as root.  Enter this command (you only need to do this after your first reboot):  <h3>Creating a user 'www'</h3>
 <OL>  <p>
 <LI><TT>sh /usr/sbin/loncapa_configure</TT>  Execute the following command to create a user named 'www' on your
 </OL>  LON-CAPA server:
 </OL>  </p>
 </BODY>  <table bgcolor="#aaaaaa" border="1"><tr><td>
 </HTML>  <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>

Removed from v.1.9  
changed lines
  Added in v.1.16


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