[BACK]Return to install.html CVS log [TXT] [DIR] Up to [LON-CAPA] / doc / build

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

version 1.12, 2002/02/13 15:06:22 version 1.20, 2002/05/10 16:26:32
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='#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>Make a LON-CAPA system work with shadow passwords</h3>  <h3>Creating a user 'www'</h3>
 <p>  <p>
 <table border='1'>  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>
   <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 75  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:
   </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>  </table>
   <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>
 <!-- maintext end -->  
 <h1>LON-CAPA Installation</h1>  
 <h3>Current Installation Procedure</h3>  
 <p>  <p>
 Scott Harrison  The <strong>UPDATE</strong> command will refresh your filesystem with all
   the latest LON-CAPA software.
 </p>  </p>
 <p>$Date$; $Revision$</p>  <table bgcolor="#aaaaaa" border="1">
   <tr><td><tt>./UPDATE</tt></td></tr>
   </table>
   <a name="checkrpms" />
   <h3>Checking your Linux RPMs</h3>
 <p>  <p>
 This is the current list of steps to support LON-CAPA installation.  These  The <strong>CHECKRPMS</strong> command will check the RPMs on your machine
 steps have been tested.</p>  against an FTP repository.
 <ol>  </p>
 <li>Get LON-CAPA on a CD by  <table bgcolor="#aaaaaa" border="1">
 <ul>  <tr><td><tt>./CHECKRPMS</tt></td></tr>
 <li>Requesting a LON-CAPA installation CD (c/o Helen Keefe,   </table>
 helen@lon-capa.org).</li>  <a name="mysql" />
 <li>Or, downloading a LON-CAPA installation  <h3>Configuring the MySQL database</h3>
 <a href="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and  <p>
 burning a CD.</li>  The following commands describe how to configure the MySQL database
 <li>(Depending on whether your computer has a bootable CD-ROM, you may  on your LON-CAPA server.
 need to also make a boot floppy.  Download this floppy disk image file:   <br />Note:
 <a href=  </p>
 "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>  <ul>
 <li>Follow the <A HREF="instructions_with_cd.html">  <li>you should substitute 'WWWPASSWORD' with the value for 'lonSqlAccess'
 CD-ROM installation instructions</a></li>  present inside <tt>/etc/httpd/conf/loncapa.conf</tt> <i>or in access.conf</i>
 </ul></li>  </li>
 <li>After installation, restart the computer.  Login as root.  Enter this  <li>you should substitute 'ROOTPASSWORD' with something very hard to guess
 command (you only need to do this after your first reboot):  (it does not have to be the Linux OS root password)
 <ol>  </li>
 <li><tt>sh /usr/sbin/loncapa_configure</tt></li>  </ul>
 </ol></li>  <p>Entering the mysql shell</p>
 </ol>  <table bgcolor="#aaaaaa" border="1"><tr><td>
 <hr />  <pre>
 <p>  mysql -u root -p mysql
 You can also try to install LON-CAPA on an existing installation of  OR
 RedHat 6.2.  Please see <a  mysql -u root      (depending on whether you have set a root password)
 href='how_to_install_loncapa_on_a_preinstalled_system.txt'>  </pre>
 how_to_install_loncapa_on_a_preinstalled_system.txt</a>.  </td></tr></table>
   <p>Creating the mysql 'www' user (after entering mysql shell)</p>
   <table bgcolor="#aaaaaa" border="1"><tr><td>
   <pre>
   mysql> CREATE DATABASE loncapa;
   
   mysql> INSERT INTO user (Host, User, Password)
   mysql> VALUES ('localhost','www',password('WWWPASSWORD'));
   
   mysql> GRANT ALL PRIVILEGES ON *.* TO www@localhost;
   
   mysql> FLUSH PRIVILEGES;
   </pre>
   </td></tr></table>
   <p>SECURITY: set a password for the mysql 'root' user</p>
   <table bgcolor="#aaaaaa" border="1"><tr><td>
   <pre>
   shell> mysql -u root mysql
   mysql> SET PASSWORD FOR root@localhost=PASSWORD('ROOTPASSWORD');
   </pre>
   </td></tr></table>
   <p>SECURITY: set a password for the mysql 'root' user</p>
   <table bgcolor="#aaaaaa" border="1"><tr><td>
   <pre>
   shell> mysql -u root mysql
   mysql> SET PASSWORD FOR root@localhost=PASSWORD('ROOTPASSWORD');
   </pre>
   </td></tr></table>
   <p>SECURITY: only allow access from localhost</p>
   <table bgcolor="#aaaaaa" border="1"><tr><td>
   <pre>
   shell> mysql -u root -p mysql
   mysql> DELETE * FROM user WHERE host<>'localhost';
   </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 -->
   <!-- validated -->
 </body>  </body>
 </html>  </html>
Removed from v.1.12  
changed lines
  Added in v.1.20

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