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

version 1.17, 2002/04/26 13:17:51 version 1.39, 2002/12/14 18:35:35
Line 1 Line 1
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/html4/loose.dtd">   "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 14 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  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 42  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>
Line 131  running the following command Line 140  running the following command
 </p>  </p>
 <p>  <p>
 Edit (creating the file) /etc/pam.d/pwauth to have the contents:  Edit (creating the file) /etc/pam.d/pwauth to have the contents:
   </p>
 <pre>  <pre>
         auth       required     /lib/security/pam_pwdb.so shadow nullok          auth       required     /lib/security/pam_pwdb.so shadow nullok
         auth       required     /lib/security/pam_nologin.so          auth       required     /lib/security/pam_nologin.so
         account    required     /lib/security/pam_pwdb.so          account    required     /lib/security/pam_pwdb.so
 </pre>  </pre>
 </p>  
 </td></tr>  </td></tr>
 </table>  </table>
 </p>  
 <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 163  against an FTP repository. Line 179  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>
   <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>
   <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 207  will recommend you perform various steps Line 273  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.17  
changed lines
  Added in v.1.39


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