Diff for /doc/build/Attic/install.html between versions 1.14 and 1.29

version 1.14, 2002/04/23 12:41:23 version 1.29, 2002/06/03 06:13:08
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 38  LON-CAPA server: Line 44  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 73  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>
   <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>  </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 89  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>
   <table bgcolor="#aaaaaa" border="1">
   <tr><td><tt>wget http://install.lon-capa.org/versions/current/loncapa.tar.gz
   </tt>
   <br />
   <tt>tar xzvf loncapa.tar.gz</tt>
   <br />
   <tt>cd loncapa</tt></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 110  against an FTP repository. Line 176  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>  </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> 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" />
   <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>
 <!-- maintext end -->  <!-- maintext end -->
   <!-- validated -->
 </body>  </body>
 </html>  </html>

Removed from v.1.14  
changed lines
  Added in v.1.29


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