Annotation of doc/build/reconfig.html, revision 1.11

1.9       harris41    1: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
                      2:  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
1.11    ! harris41    3: <!-- $Id: reconfig.html,v 1.10 2002/06/17 05:52:41 harris41 Exp $ -->
1.3       harris41    4: <html>
                      5: <head>
1.9       harris41    6: <meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
1.6       harris41    7: <title>Configuration of a LON-CAPA Server</title>
                      8: <!-- pdfahref index.pdf -->
                      9: <!-- button CONFIGURE -->
1.3       harris41   10: </head>
1.9       harris41   11: <body bgcolor="#ffffff">
1.6       harris41   12: <!-- preamble start -->
                     13: <p>
                     14: There are about a dozen files on the LON-CAPA server systems
1.11    ! harris41   15: which the system administrator may need to adjust.
1.6       harris41   16: </p>
                     17: <p>
                     18: The two most important configuration files are:
1.9       harris41   19: </p>
1.6       harris41   20: <ul>
                     21: <li><strong>loncapa.conf</strong> -
1.11    ! harris41   22: typically located in the directory <tt>/etc/httpd/conf/</tt>;
        !            23: <br /><i>contains machine-specific and institution-specific
        !            24: variables and modifications necessary for
        !            25: the effective running of the Apache web server;
        !            26: note that there is also a <strong>loncapa_apache.conf</strong>
        !            27: which should be installed, but not modified</i>
1.6       harris41   28: <br />&nbsp;
                     29: </li>
                     30: <li><strong>hosts.tab</strong> -
1.11    ! harris41   31: typically located in the directory <tt>/home/httpd/lonTabs/</tt>;
1.6       harris41   32: <br /><i>is a listing of all other internet machines that a server
                     33: system considers to be valid server systems on the LON-CAPA
                     34: network</i>
                     35: <br />&nbsp;
                     36: </li>
                     37: </ul>
                     38: <!-- preamble end -->
                     39: <!-- maintext start -->
1.11    ! harris41   40: <h3>Current Reconfiguration Procedure</h3>
        !            41: <p>
        !            42: After making any configuration change, you will need to restart system
        !            43: services.  The two most important system services on a LON-CAPA system are
        !            44: <strong>loncapa</strong> and <strong>httpd</strong>.  Here are the
        !            45: commands for restarting the system services:
        !            46: </p>
        !            47: <table bgcolor="#aaaaaa" border="1"><tr><td>
        !            48: <tt>/etc/rc.d/init.d/loncapa restart</tt>
        !            49: <br /><tt>/etc/rc.d/init.d/httpd restart</tt>
        !            50: </td></tr></table>
        !            51: <p>
        !            52: We recommend that a knowledgeable system administrator should
        !            53: perform any adjustments on a LON-CAPA server machine.
        !            54: Locations of these files are by default.  Depending on your
        !            55: Linux distribution--RedHat, Mandrake, Debian, etc, the file paths
        !            56: may be elsewhere.
        !            57: </p>
        !            58: <h3>Configuration files that will have to be altered</h3>
1.9       harris41   59: <p>
1.3       harris41   60: LON-CAPA currently depends on the following list of configuration
1.11    ! harris41   61: files.  Note that <tt>loncapa.conf</tt> is automatically
        !            62: altered by the installation/upgrade scripts associated with
        !            63: the tarball-distribution (see the <b>INSTALL</b> and <b>UPGRADE</b>
        !            64: sections of this web-site).  (Thus, the system administrator should
        !            65: not have to further adjust <tt>loncapa.conf</tt> from the terminal.)
1.9       harris41   66: </p>
1.3       harris41   67: <ul>
1.9       harris41   68: <li><a href="confexamples/loncapa.conf">[EXAMPLE]</a>
1.7       harris41   69: /etc/httpd/conf/loncapa.conf</li>
1.9       harris41   70: <li><a href="confexamples/hosts.tab">[EXAMPLE]</a>
1.3       harris41   71: /home/httpd/lonTabs/hosts.tab</li>
1.9       harris41   72: <li><a href="confexamples/spare.tab">[EXAMPLE]</a>
1.3       harris41   73: /home/httpd/lonTabs/spare.tab</li>
1.11    ! harris41   74: <li><a href="confexamples/krb.conf">[EXAMPLE]</a> /etc/krb.conf</li>
1.9       harris41   75: <li><a href="confexamples/htpasswd">[EXAMPLE]</a>
1.3       harris41   76: /home/httpd/lonTabs/htpasswd</li>
1.9       harris41   77: <li><a href="confexamples/ntp.conf">[EXAMPLE]</a> /etc/ntp.conf</li>
                     78: <li><a href="confexamples/step-tickers">[EXAMPLE]</a>
1.3       harris41   79: /etc/ntp/step-tickers</li>
1.9       harris41   80: <li><a href="confexamples/pwauth">[EXAMPLE]</a> /etc/pam.d/pwauth</li>
1.3       harris41   81: </ul>
1.11    ! harris41   82: <h3>Configuration files that do not have to be altered</h3>
        !            83: <p>
        !            84: The following configuration files are critical for the correct
        !            85: performance of a LON-CAPA server machine.  Typically, these configuration
        !            86: files do not need to be adjusted by the system administrator.
        !            87: </p>
        !            88: <ul>
        !            89: <li><a href="confexamples/loncapa_apache.conf">[EXAMPLE]</a>
        !            90: /etc/httpd/conf/loncapa_apache.conf</li>
        !            91: <li><a href="confexamples/un_keyword.tab">[EXAMPLE]</a>
        !            92: /home/httpd/html/res/adm/includes/un_keyword.tab</li>
        !            93: </ul>
        !            94: 
        !            95: <h3>Configuring Secondary Services</h3>
        !            96: <p>
        !            97: LON-CAPA does not provide integrated support for secondary services.
        !            98: The expectation is that knowledgeable system administrators will
        !            99: customize these secondary services for their institution.
        !           100: </p>
1.3       harris41  101: <p>
1.11    ! harris41  102: We do, however, provide example configurations of services that you
        !           103: may want to deliver with LON-CAPA (i.e. Samba and AppleChooser).
1.3       harris41  104: </p>
1.11    ! harris41  105: <ul>
        !           106: <li><a href="confexamples/smb.conf">[EXAMPLE]</a> /etc/smb.conf</li>
        !           107: <li><a href="confexamples/config">[EXAMPLE]</a> /etc/atalk/config</li>
        !           108: </ul>
1.6       harris41  109: <!-- maintext end -->
1.9       harris41  110: <!-- validated -->
1.3       harris41  111: </body>
                    112: </html>

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