Diff for /doc/build/Attic/install.html between versions 1.12 and 1.17

version 1.12, 2002/02/13 15:06:22 version 1.17, 2002/04/26 13:17:51
Line 1 Line 1
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
    "http://www.w3.org/TR/html4/loose.dtd">
 <!-- The LearningOnline Network with CAPA -->  <!-- The LearningOnline Network with CAPA -->
 <!-- $Id$ -->  <!-- $Id$ -->
 <html>  <html>
Line 13 Line 15
 You will need to check all the following things to ensure proper  You will need to check all the following things to ensure proper
 installation of your LON-CAPA system.  installation of your LON-CAPA system.
 <ul>  <ul>
 <li><a href='#shadow'>  <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>  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>  </ul>
 <br />&nbsp;  <br />&nbsp;
 <!-- preamble end -->  <!-- preamble end -->
 <!-- maintext start -->  <!-- maintext start -->
 <a name='shadow' />  <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>  <h3>Make a LON-CAPA system work with shadow passwords</h3>
 <p>  <p>
 <table border='1'>  <table border="1">
 <tr><th>Step #</th><th>Description</th></tr>  <tr><th>Step #</th><th>Description</th></tr>
 <tr><td>  <tr><td>
 <font size='+1'>1</font>  <font size="+1">1</font>
 </td><td>  </td><td>
 <p>Is your system using shadow passwords? (Note: LON-CAPA will  <p>Is your system using shadow passwords? (Note: LON-CAPA will
 work with either MD5/non-MD5 configured systems).  If your  work with either MD5/non-MD5 configured systems).  If your
Line 53  wget http://www.wwnet.net/~janc/software Line 74  wget http://www.wwnet.net/~janc/software
 </tt>  </tt>
 </p>  </p>
 </td></tr>  </td></tr>
   <tr><td>
   <font size='+1'>3</font>
   </td><td>
   <p><strong>Unpack the mod_auth_external source</strong> by
   running the following command
   </p>
   <p>
   <tt>tar xzvf mod_auth_external-2.1.13.tar.gz</tt>
   </p>
   </td></tr>
   <tr><td>
   <font size='+1'>4</font>
   </td><td>
   <p><strong>Go to the <tt>pwauth</tt> directory</strong> by
   running the following command
   </p>
   <p>
   <tt>cd mod_auth_external-2.1.13/pwauth/</tt>
   </p>
   </td></tr>
   <tr><td>
   <font size='+1'>5</font>
   </td><td>
   <p><strong>Edit <tt>config.h</tt> and change SERVER_UIDS definition</strong>
   </p>
   <p>
   Determine the user id of 'www':
   <br /><tt>grep ^www /etc/passwd | cut -d':' -f3</tt>
   <br />
   Change the line
   <br /><tt>#define SERVER_UIDS 99       /* user "nobody" */</tt>
   <br />to be
   <br /><tt>#define SERVER_UIDS 513      /* user "www" */</tt>
   <br />where in this example 513 corresponds to the user id of 'www'.
   </p>
   </td></tr>
   <tr><td>
   <font size='+1'>6</font>
   </td><td>
   <p><strong>Compile the <tt>pwauth</tt> executable</strong> by
   running the following command
   </p>
   <p>
   <tt>make</tt>
   </p>
   </td></tr>
   <tr><td>
   <font size='+1'>7</font>
   </td><td>
   <p><strong>Install <tt>pwauth</tt></strong> by doing the following
   </p>
   <p>
   <tt>cp pwauth /usr/local/sbin/</tt>
   <br /><tt>chmod 6755 /usr/local/sbin/pwauth</tt>
   </p>
   <p>
   Edit (creating the file) /etc/pam.d/pwauth to have the contents:
   <pre>
           auth       required     /lib/security/pam_pwdb.so shadow nullok
           auth       required     /lib/security/pam_nologin.so
           account    required     /lib/security/pam_pwdb.so
   </pre>
   </p>
   </td></tr>
 </table>  </table>
 </p>  </p>
 <!-- maintext end -->  <a name="install" />
 <h1>LON-CAPA Installation</h1>  <h3>Installing LON-CAPA files</h3>
 <h3>Current Installation Procedure</h3>  
 <p>  <p>
 Scott Harrison  Download the most current
   <a href="http://install.lon-capa.org/versions/current/loncapa.tar.gz">
   loncapa.tar.gz</a>.
 </p>  </p>
 <p>$Date$; $Revision$</p>  
 <p>  <p>
 This is the current list of steps to support LON-CAPA installation.  These  The <strong>UPDATE</strong> command will refresh your filesystem with all
 steps have been tested.</p>  the latest LON-CAPA software.
 <ol>  </p>
 <li>Get LON-CAPA on a CD by  <table bgcolor="#aaaaaa" border="1">
 <ul>  <tr><td><tt>./UPDATE</tt></td></tr>
 <li>Requesting a LON-CAPA installation CD (c/o Helen Keefe,   </table>
 helen@lon-capa.org).</li>  <a name="checkrpms" />
 <li>Or, downloading a LON-CAPA installation  <h3>Checking your Linux RPMs</h3>
 <a href="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and  <p>
 burning a CD.</li>  The <strong>CHECKRPMS</strong> command will check the RPMs on your machine
 <li>(Depending on whether your computer has a bootable CD-ROM, you may  against an FTP repository.
 need to also make a boot floppy.  Download this floppy disk image file:   </p>
 <a href=  <table bgcolor="#aaaaaa" border="1">
 "http://install.lon-capa.org/3.1/currentcdsource/images/boot-20000407.img">  <tr><td><tt>./CHECKRPMS</tt></td></tr>
 boot-20000407.img</a>.  (Download the image file; insert a blank floppy disk;  </table>
 and type this command: <tt>dd if=boot-20000407.img of=/dev/fd0</tt>).</li>  <a name="mysql" />
 </ul></li>  <h3>Configuring the MySQL database</h3>
 <li>Install with CD-ROM  <p>
 <ul>  The following commands describe how to configure the MySQL database
 <li>Follow the <A HREF="instructions_with_cd.html">  on your LON-CAPA server.
 CD-ROM installation instructions</a></li>  </p>
 </ul></li>  <table bgcolor="#aaaaaa" border="1"><tr><td>
 <li>After installation, restart the computer.  Login as root.  Enter this  <pre>
 command (you only need to do this after your first reboot):  Enter the mysql shell---
 <ol>  mysql -u root -p mysql
 <li><tt>sh /usr/sbin/loncapa_configure</tt></li>  
 </ol></li>  Run these commands---
 </ol>  CREATE DATABASE loncapa;
 <hr />  
 <p>  INSERT INTO user (Host, User, Password)
 You can also try to install LON-CAPA on an existing installation of  VALUES ('localhost','www',password('SOMEPASSWORD'));
 RedHat 6.2.  Please see <a  
 href='how_to_install_loncapa_on_a_preinstalled_system.txt'>  GRANT ALL PRIVILEGES ON *.* TO www@localhost;
 how_to_install_loncapa_on_a_preinstalled_system.txt</a>.  
   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>  </p>
   <!-- maintext end -->
 </body>  </body>
 </html>  </html>

Removed from v.1.12  
changed lines
  Added in v.1.17


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