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

version 1.16, 2002/04/23 13:04:54 version 1.40, 2003/05/02 19:25:01
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 21  Make a LON-CAPA system work with shadow Line 25  Make a LON-CAPA system work with shadow
 Installing LON-CAPA files</a></li>  Installing LON-CAPA files</a></li>
 <li><a href="#checkrpms">  <li><a href="#checkrpms">
 Checking your Linux RPMs</a></li>  Checking your Linux RPMs</a></li>
   <li><a href="#fixhosts">
   Fixing <tt>/etc/hosts</tt></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">  <li><a href="#testing">
 Testing to see if the LON-CAPA server is operational</a></li>  Testing to see if the LON-CAPA server is operational</a></li>
 </ul>  </ul>
   <p>
   <strong>NOTE:</strong>
   If you want to simultaneously install both RedHat 7.3 and LON-CAPA
   (to ensure 100% reliability), follow <a href="rh73.html">these
   alternative directions</a>.
   </p>
 <br />&nbsp;  <br />&nbsp;
 <!-- preamble end -->  <!-- preamble end -->
 <!-- maintext start -->  <!-- maintext start -->
Line 40  LON-CAPA server: Line 52  LON-CAPA server:
 </td></tr></table>  </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
 work with either MD5/non-MD5 configured systems).  If your  with either MD5/non-MD5 configured systems).  It is strongly
 system is not using shadow passwords, then do not perform  recommended to use shadow passwords. If your system is currently not
 any of the additional steps.  If your system is using shadow  using shadow passwords, run the "pwconv" command (as root) in order to
 passwords, then you will need to perform the additional steps below.  convert to shadow passwords.  If you choose not to use 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>
 <p>  <p>
 <strong>How to detect:</strong>  <strong>How to detect:</strong>
Line 68  the steps below. Line 82  the steps below.
 running the following command  running the following command
 </p>  </p>
 <p><tt>  <p><tt>
 wget http://www.wwnet.net/~janc/software/mod_auth_external-2.1.13.tar.gz  wget http://www.unixpapa.com/software/mod_auth_external-2.1.15.tar.gz
 </tt>  </tt>
 </p>  </p>
 </td></tr>  </td></tr>
 <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.15.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>
   <tt>cd mod_auth_external-2.1.15/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>id -u www</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>  </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>
 Download the most current  Download the most current
 <a href="http://install.lon-capa.org/versions/current/loncapa.tar.gz">  <a href="http://install.lon-capa.org/versions/loncapa-current.tar.gz">
 loncapa.tar.gz</a>.  loncapa-current.tar.gz</a>.
 </p>  </p>
   <table bgcolor="#aaaaaa" border="1">
   <tr><td><tt>wget http://install.lon-capa.org/versions/loncapa-current.tar.gz
   </tt>
   <br />
   <tt>tar xzvf loncapa-current.tar.gz</tt>
   <br />
   <tt>cd loncapa-N.N</tt> (N.N is the version number)</td></tr>
   </table>
 <p>  <p>
 The <strong>UPDATE</strong> command will refresh your filesystem with all  The <strong>UPDATE</strong> command will refresh your filesystem with all
 the latest LON-CAPA software.  the latest LON-CAPA software.
Line 107  against an FTP repository. Line 182  against an FTP repository.
 <table bgcolor="#aaaaaa" border="1">  <table bgcolor="#aaaaaa" border="1">
 <tr><td><tt>./CHECKRPMS</tt></td></tr>  <tr><td><tt>./CHECKRPMS</tt></td></tr>
 </table>  </table>
   <p>
   Also, please be sure to install the LON-CAPA-systemperl RPM as described on
   the <a href="/docs/downloads/index.html">Downloads</a> page.
   </p>
   <a name="fixhosts" />
   <h3>Fixing <tt>/etc/hosts</tt></h3>
   <p>
   A common RedHat glitch of new installations (RedHat's fault, not LON-CAPA)
   is the generation of /etc/hosts.
   </p>
   <p>
   It should look something like this (except the <tt>myschool</tt> line
   should be replaced with settings specific to your machine):
   </p>
   <table bgcolor="#aaaaaa" border="1">
   <tr><td>
   <pre>
   127.0.0.1 localhost.localdomain localhost
   12.34.56.78 www.myschool.edu myschool
   </pre></td></tr>
   </table>
 <a name="mysql" />  <a name="mysql" />
 <h3>Configuring the MySQL database</h3>  <h3>Configuring the MySQL database</h3>
 <p>  <p>
 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.
   <br />Note:
 </p>  </p>
   <ul>
   <li>you should substitute 'ROOTPASSWORD' with something very hard to guess
   (it does not have to be the Linux OS root password)
   </li>
   <li>The MySQL www@localhost user must always have a password of 'localhostkey'
   in order for there to be correct operation of a standard LON-CAPA system.
   </li>
   </ul>
   <p>
   The following instructions assume you are logged in as 'root'.
   </p>
   <p>Entering the mysql shell</p>
 <table bgcolor="#aaaaaa" border="1"><tr><td>  <table bgcolor="#aaaaaa" border="1"><tr><td>
 <pre>  <pre>
 Enter the mysql shell---  
 mysql -u root -p mysql  mysql -u root -p mysql
   OR
   mysql -u root mysql (depending on whether you have set a root password)
   </pre>
   </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;
   
 Run these commands---  mysql> INSERT INTO user (Host, User, Password)
 CREATE DATABASE loncapa;  mysql> VALUES ('localhost','www',password('localhostkey'));
   
 INSERT INTO user (Host, User, Password)  
 VALUES ('localhost','www',password('SOMEPASSWORD'));  
   
 GRANT ALL PRIVILEGES ON *.* TO www@localhost;  
   
 FLUSH PRIVILEGES;  mysql> INSERT INTO db VALUES ('localhost','loncapa','www',
   mysql> 'Y','Y','Y','Y','Y','Y','N','Y','Y','Y');
   
   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  shell> mysql -u root mysql
 mysql> SET PASSWORD FOR root@localhost=PASSWORD('new_password');  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&lt;&gt;'localhost';
 </pre>  </pre>
 </td></tr></table>  </td></tr></table>
 <a name="testing" />  <a name="testing" />
Line 151  will recommend you perform various steps Line 276  will recommend you perform various steps
 performance of your LON-CAPA server.  performance of your LON-CAPA server.
 </p>  </p>
 <!-- maintext end -->  <!-- maintext end -->
   <!-- validated -->
 </body>  </body>
 </html>  </html>

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


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