[BACK]Return to install.html CVS log [TXT] [DIR] Up to [LON-CAPA] / doc / build
File:  [LON-CAPA] / doc / build / Attic / install.html
Revision 1.16: download - view: text, annotated - select for diffs
Tue Apr 23 13:04:54 2002 UTC (22 years, 1 month ago) by harris41
Branches: MAIN
CVS tags: HEAD
improving TEST description

    1: <!-- The LearningOnline Network with CAPA -->
    2: <!-- $Id: install.html,v 1.16 2002/04/23 13:04:54 harris41 Exp $ -->
    3: <html>
    4: <head>
    5: <title>LON-CAPA Installation</title>
    6: <!-- pdfahref install.pdf -->
    7: <!-- button INSTALL -->
    8: </head>
    9: <body bgcolor='#ffffff'>
   10: <!-- preamble start -->
   11: <br />&nbsp;
   12: <p>
   13: You will need to check all the following things to ensure proper
   14: installation of your LON-CAPA system.
   15: <ul>
   16: <li><a href="#wwwuser">
   17: Creating a user 'www'</a></li>
   18: <li><a href="#shadow">
   19: Make a LON-CAPA system work with shadow passwords</a></li>
   20: <li><a href="#install">
   21: Installing LON-CAPA files</a></li>
   22: <li><a href="#checkrpms">
   23: Checking your Linux RPMs</a></li>
   24: <li><a href="#mysql">
   25: Configuring the MySQL database</a></li>
   26: <li><a href="#testing">
   27: Testing to see if the LON-CAPA server is operational</a></li>
   28: </ul>
   29: <br />&nbsp;
   30: <!-- preamble end -->
   31: <!-- maintext start -->
   32: <a name="wwwuser" />
   33: <h3>Creating a user 'www'</h3>
   34: <p>
   35: Execute the following command to create a user named 'www' on your
   36: LON-CAPA server:
   37: </p>
   38: <table bgcolor="#aaaaaa" border="1"><tr><td>
   39: <tt>/usr/sbin/useradd www</tt>
   40: </td></tr></table>
   41: <a name="shadow" />
   42: <h3>Make a LON-CAPA system work with shadow passwords</h3>
   43: <p>
   44: <table border="1">
   45: <tr><th>Step #</th><th>Description</th></tr>
   46: <tr><td>
   47: <font size="+1">1</font>
   48: </td><td>
   49: <p>Is your system using shadow passwords? (Note: LON-CAPA will
   50: work with either MD5/non-MD5 configured systems).  If your
   51: system is not using shadow passwords, then do not perform
   52: any of the additional steps.  If your system is using shadow
   53: passwords, then you will need to perform the additional steps below.
   54: </p>
   55: <p>
   56: <strong>How to detect:</strong>
   57: <br />command: <tt>cat /etc/passwd | grep ':x:'</tt>
   58: </p>
   59: <p>If there is output such as "<tt>root:x:0:0:root:/root:/bin/bash</tt>",
   60: then your system is using shadow passwords and you will need to continue with
   61: the steps below.
   62: </p>
   63: </td></tr>
   64: <tr><td>
   65: <font size='+1'>2</font>
   66: </td><td>
   67: <p><strong>Retrieve the mod_auth_external source</strong> by
   68: running the following command
   69: </p>
   70: <p><tt>
   71: wget http://www.wwnet.net/~janc/software/mod_auth_external-2.1.13.tar.gz
   72: </tt>
   73: </p>
   74: </td></tr>
   75: <tr><td>
   76: <font size='+1'>3</font>
   77: </td><td>
   78: <p><strong>More steps...</strong>
   79: </p>
   80: <p><tt>
   81: There are more steps to include here.
   82: </tt>
   83: </p>
   84: </td></tr>
   85: </table>
   86: </p>
   87: <a name="install" />
   88: <h3>Installing LON-CAPA files</h3>
   89: <p>
   90: Download the most current
   91: <a href="http://install.lon-capa.org/versions/current/loncapa.tar.gz">
   92: loncapa.tar.gz</a>.
   93: </p>
   94: <p>
   95: The <strong>UPDATE</strong> command will refresh your filesystem with all
   96: the latest LON-CAPA software.
   97: </p>
   98: <table bgcolor="#aaaaaa" border="1">
   99: <tr><td><tt>./UPDATE</tt></td></tr>
  100: </table>
  101: <a name="checkrpms" />
  102: <h3>Checking your Linux RPMs</h3>
  103: <p>
  104: The <strong>CHECKRPMS</strong> command will check the RPMs on your machine
  105: against an FTP repository.
  106: </p>
  107: <table bgcolor="#aaaaaa" border="1">
  108: <tr><td><tt>./CHECKRPMS</tt></td></tr>
  109: </table>
  110: <a name="mysql" />
  111: <h3>Configuring the MySQL database</h3>
  112: <p>
  113: The following commands describe how to configure the MySQL database
  114: on your LON-CAPA server.
  115: </p>
  116: <table bgcolor="#aaaaaa" border="1"><tr><td>
  117: <pre>
  118: Enter the mysql shell---
  119: mysql -u root -p mysql
  120: 
  121: Run these commands---
  122: CREATE DATABASE loncapa;
  123: 
  124: INSERT INTO user (Host, User, Password)
  125: VALUES ('localhost','www',password('SOMEPASSWORD'));
  126: 
  127: GRANT ALL PRIVILEGES ON *.* TO www@localhost;
  128: 
  129: FLUSH PRIVILEGES;
  130: 
  131: shell> mysql -u root mysql
  132: mysql> SET PASSWORD FOR root@localhost=PASSWORD('new_password');
  133: </pre>
  134: </td></tr></table>
  135: <a name="testing" />
  136: <h3>Testing to see if the LON-CAPA server is operational</h3>
  137: <p>
  138: The <strong>TEST</strong> command will check the installation software,
  139: the perl libraries on your system, the MySQL database, and
  140: will also automatically test the real-time operation of the 
  141: LON-CAPA Apache web server.
  142: </p>
  143: <table bgcolor="#aaaaaa" border="1">
  144: <tr><td><tt>./TEST</tt></td></tr>
  145: </table>
  146: <p>
  147: Using the <strong>TEST</strong> command will likely
  148: be an iterative process.
  149: It is normal to expect that the <strong>TEST</strong> command
  150: will recommend you perform various steps to ensure optimal
  151: performance of your LON-CAPA server.
  152: </p>
  153: <!-- maintext end -->
  154: </body>
  155: </html>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>