[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.15 and 1.33

version 1.15, 2002/04/23 12:46:58 version 1.33, 2002/07/21 15:48:03
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 26  Configuring the MySQL database</a></li> Line 30  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 50  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 75  wget http://www.wwnet.net/~janc/software Line 84  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>
   <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>
   <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>
 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 112  against an FTP repository. Line 182  against an FTP repository.
 <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> 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  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 143  LON-CAPA Apache web server. Line 241  LON-CAPA Apache web server.
 <table bgcolor="#aaaaaa" border="1">  <table bgcolor="#aaaaaa" border="1">
 <tr><td><tt>./TEST</tt></td></tr>  <tr><td><tt>./TEST</tt></td></tr>
 </table>  </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>
 <!-- maintext end -->  <!-- maintext end -->
   <!-- validated -->
 </body>  </body>
 </html>  </html>
Removed from v.1.15  
changed lines
  Added in v.1.33

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