Annotation of doc/build/config.frag, revision 1.2

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

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
500 Internal Server Error

Internal Server Error

The server encountered an internal error or misconfiguration and was unable to complete your request.

Please contact the server administrator at root@localhost to inform them of the time this error occurred, and the actions you performed just before this error.

More information about this error may be available in the server error log.