Annotation of doc/build/install.html, revision 1.15

1.11      harris41    1: <!-- The LearningOnline Network with CAPA -->
1.15    ! harris41    2: <!-- $Id: install.html,v 1.14 2002/04/23 12:41:23 harris41 Exp $ -->
1.11      harris41    3: <html>
                      4: <head>
                      5: <title>LON-CAPA Installation</title>
1.12      harris41    6: <!-- pdfahref install.pdf -->
                      7: <!-- button INSTALL -->
1.11      harris41    8: </head>
1.12      harris41    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>
1.13      harris41   16: <li><a href="#wwwuser">
                     17: Creating a user 'www'</a></li>
                     18: <li><a href="#shadow">
1.12      harris41   19: Make a LON-CAPA system work with shadow passwords</a></li>
1.13      harris41   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>
1.15    ! harris41   26: <li><a href="#testing">
        !            27: Testing to see if the LON-CAPA server is operational</a></li>
1.12      harris41   28: </ul>
                     29: <br />&nbsp;
                     30: <!-- preamble end -->
                     31: <!-- maintext start -->
1.13      harris41   32: <a name="wwwuser" />
                     33: <h3>Creating a user 'www'</h3>
                     34: <p>
1.14      harris41   35: Execute the following command to create a user named 'www' on your
                     36: LON-CAPA server:
1.13      harris41   37: </p>
1.14      harris41   38: <table bgcolor="#aaaaaa" border="1"><tr><td>
                     39: <tt>/usr/sbin/useradd www</tt>
                     40: </td></tr></table>
1.13      harris41   41: <a name="shadow" />
1.12      harris41   42: <h3>Make a LON-CAPA system work with shadow passwords</h3>
                     43: <p>
1.14      harris41   44: <table border="1">
1.12      harris41   45: <tr><th>Step #</th><th>Description</th></tr>
                     46: <tr><td>
1.14      harris41   47: <font size="+1">1</font>
1.12      harris41   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>
1.13      harris41   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>
1.14      harris41   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>
1.13      harris41  101: <a name="checkrpms" />
                    102: <h3>Checking your Linux RPMs</h3>
                    103: <p>
1.14      harris41  104: The <strong>CHECKRPMS</strong> command will check the RPMs on your machine
                    105: against an FTP repository.
1.13      harris41  106: </p>
1.14      harris41  107: <table bgcolor="#aaaaaa" border="1">
1.13      harris41  108: <tr><td><tt>./CHECKRPMS</tt></td></tr>
1.12      harris41  109: </table>
1.13      harris41  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.
1.12      harris41  115: </p>
1.14      harris41  116: <table bgcolor="#aaaaaa" border="1"><tr><td>
1.13      harris41  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>
1.15    ! harris41  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>
1.12      harris41  146: <!-- maintext end -->
1.11      harris41  147: </body>
                    148: </html>

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