Diff for /doc/build/Attic/install.html between versions 1.13 and 1.18

version 1.13, 2002/04/23 12:33:40 version 1.18, 2002/05/02 01:30:15
Line 1 Line 1
   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <!-- The LearningOnline Network with CAPA -->  <!-- The LearningOnline Network with CAPA -->
 <!-- $Id$ -->  <!-- $Id$ -->
 <html>  <html>
 <head>  <head>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
 <title>LON-CAPA Installation</title>  <title>LON-CAPA Installation</title>
 <!-- pdfahref install.pdf -->  <!-- pdfahref install.pdf -->
 <!-- button INSTALL -->  <!-- button INSTALL -->
Line 12 Line 15
 <p>  <p>
 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.
   </p>
 <ul>  <ul>
 <li><a href="#wwwuser">  <li><a href="#wwwuser">
 Creating a user 'www'</a></li>  Creating a user 'www'</a></li>
Line 23  Installing LON-CAPA files</a></li> Line 27  Installing LON-CAPA files</a></li>
 Checking your Linux RPMs</a></li>  Checking your Linux RPMs</a></li>
 <li><a href="#mysql">  <li><a href="#mysql">
 Configuring the MySQL database</a></li>  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 -->
Line 30  Configuring the MySQL database</a></li> Line 36  Configuring the MySQL database</a></li>
 <a name="wwwuser" />  <a name="wwwuser" />
 <h3>Creating a user 'www'</h3>  <h3>Creating a user 'www'</h3>
 <p>  <p>
   Execute the following command to create a user named 'www' on your
   LON-CAPA server:
 </p>  </p>
   <table bgcolor="#aaaaaa" border="1"><tr><td>
   <tt>/usr/sbin/useradd www</tt>
   </td></tr></table>
 <a name="shadow" />  <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>  <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 69  wget http://www.wwnet.net/~janc/software Line 78  wget http://www.wwnet.net/~janc/software
 <tr><td>  <tr><td>
 <font size='+1'>3</font>  <font size='+1'>3</font>
 </td><td>  </td><td>
 <p><strong>More steps...</strong>  <p><strong>Unpack the mod_auth_external source</strong> by
   running the following command
 </p>  </p>
 <p><tt>  <p>
 There are more steps to include here.  <tt>tar xzvf mod_auth_external-2.1.13.tar.gz</tt>
 </tt>  
 </p>  </p>
 </td></tr>  </td></tr>
 </table>  <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>
   <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:
   </p>
   <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>
   </td></tr>
   </table>
 <a name="install" />  <a name="install" />
 <h3>Installing LON-CAPA files</h3>  <h3>Installing LON-CAPA files</h3>
 <p>  <p>
Line 85  Download the most current Line 147  Download the most current
 <a href="http://install.lon-capa.org/versions/current/loncapa.tar.gz">  <a href="http://install.lon-capa.org/versions/current/loncapa.tar.gz">
 loncapa.tar.gz</a>.  loncapa.tar.gz</a>.
 </p>  </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" />  <a name="checkrpms" />
 <h3>Checking your Linux RPMs</h3>  <h3>Checking your Linux RPMs</h3>
 <p>  <p>
 The CHECKRPMS command will check the RPMs on your machine against  The <strong>CHECKRPMS</strong> command will check the RPMs on your machine
 an FTP repository.  against an FTP repository.
 </p>  </p>
 <table bgcolor="#aaaaaa">  <table bgcolor="#aaaaaa" border="1">
 <tr><td><tt>./CHECKRPMS</tt></td></tr>  <tr><td><tt>./CHECKRPMS</tt></td></tr>
 </table>  </table>
 <a name="mysql" />  <a name="mysql" />
Line 100  an FTP repository. Line 169  an FTP repository.
 The following commands describe how to configure the MySQL database  The following commands describe how to configure the MySQL database
 on your LON-CAPA server.  on your LON-CAPA server.
 </p>  </p>
 <table bgcolor="#aaaaaa"><tr><td>  <table bgcolor="#aaaaaa" border="1"><tr><td>
 <pre>  <pre>
 Enter the mysql shell---  Enter the mysql shell---
 mysql -u root -p mysql  mysql -u root -p mysql
Line 119  shell> mysql -u root mysql Line 188  shell> mysql -u root mysql
 mysql> SET PASSWORD FOR root@localhost=PASSWORD('new_password');  mysql> SET PASSWORD FOR root@localhost=PASSWORD('new_password');
 </pre>  </pre>
 </td></tr></table>  </td></tr></table>
 <!-- maintext end -->  <a name="testing" />
 <h1>LON-CAPA Installation</h1>  <h3>Testing to see if the LON-CAPA server is operational</h3>
 <h3>Current Installation Procedure</h3>  
 <p>  <p>
 Scott Harrison  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>  </p>
 <p>$Date$; $Revision$</p>  <table bgcolor="#aaaaaa" border="1">
   <tr><td><tt>./TEST</tt></td></tr>
   </table>
 <p>  <p>
 This is the current list of steps to support LON-CAPA installation.  These  Using the <strong>TEST</strong> command will likely
 steps have been tested.</p>  be an iterative process.
 <ol>  It is normal to expect that the <strong>TEST</strong> command
 <li>Get LON-CAPA on a CD by  will recommend you perform various steps to ensure optimal
 <ul>  performance of your LON-CAPA server.
 <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  
 <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>.  
 </p>  </p>
   <!-- maintext end -->
   <!-- validated -->
 </body>  </body>
 </html>  </html>

Removed from v.1.13  
changed lines
  Added in v.1.18


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