Return to config.frag CVS log

Up to [LON-CAPA] / doc / build

Moving to update install site.

    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>
   60: <li><a href="confexamples/spare.tab">[EXAMPLE]</a>
   61: /home/httpd/lonTabs/spare.tab</li>
   62: <li><a href="confexamples/krb.conf">[EXAMPLE]</a> /etc/krb.conf</li>
   63: <li><a href="confexamples/htpasswd">[EXAMPLE]</a>
   64: /home/httpd/lonTabs/htpasswd</li>
   65: <li><a href="confexamples/ntp.conf">[EXAMPLE]</a> /etc/ntp.conf</li>
   66: <li><a href="confexamples/step-tickers">[EXAMPLE]</a>
   67: /etc/ntp/step-tickers</li>
   68: <li><a href="confexamples/pwauth">[EXAMPLE]</a> /etc/pam.d/pwauth</li>
   69: </ul>
   70: <h3>Configuration files that do not have to be altered</h3>
   71: <p>
   72: The following configuration files are critical for the correct
   73: performance of a LON-CAPA server machine.  Typically, these configuration
   74: files do not need to be adjusted by the system administrator.
   75: </p>
   76: <ul>
   77: <li><a href="confexamples/loncapa_apache.conf">[EXAMPLE]</a>
   78: /etc/httpd/conf/loncapa_apache.conf</li>
   79: <li><a href="confexamples/un_keyword.tab">[EXAMPLE]</a>
   80: /home/httpd/html/res/adm/includes/un_keyword.tab</li>
   81: </ul>
   82: 
   83: <h3>Configuring Secondary Services</h3>
   84: <p>
   85: LON-CAPA does not provide integrated support for secondary services.
   86: The expectation is that knowledgeable system administrators will
   87: customize these secondary services for their institution.
   88: </p>
   89: <p>
   90: We do, however, provide example configurations of services that you
   91: may want to deliver with LON-CAPA (i.e. Samba and AppleChooser).
   92: </p>
   93: <ul>
   94: <li><a href="confexamples/smb.conf">[EXAMPLE]</a> /etc/smb.conf</li>
   95: <li><a href="confexamples/config">[EXAMPLE]</a> /etc/atalk/config</li>
   96: </ul>

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.