[BACK]Return to reconfig.html CVS log [TXT] [DIR] Up to [LON-CAPA] / doc / build
File:  [LON-CAPA] / doc / build / Attic / reconfig.html
Revision 1.11: download - view: text, annotated - select for diffs
Sat Jul 27 23:08:10 2002 UTC (21 years, 10 months ago) by harris41
Branches: MAIN
CVS tags: version_1_0_3, version_1_0_2, version_1_0_1, version_1_0_0, version_0_99_5, version_0_99_4, version_0_99_3, version_0_99_2, version_0_99_1, version_0_99_0, version_0_6_2, version_0_6, version_0_5_1, version_0_5, conference_2003, HEAD
categorizing the different types of configuration files and
discussing how to treat them

    1: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    2:  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    3: <!-- $Id: reconfig.html,v 1.11 2002/07/27 23:08:10 harris41 Exp $ -->
    4: <html>
    5: <head>
    6: <meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
    7: <title>Configuration of a LON-CAPA Server</title>
    8: <!-- pdfahref index.pdf -->
    9: <!-- button CONFIGURE -->
   10: </head>
   11: <body bgcolor="#ffffff">
   12: <!-- preamble start -->
   13: <p>
   14: There are about a dozen files on the LON-CAPA server systems
   15: which the system administrator may need to adjust.
   16: </p>
   17: <p>
   18: The two most important configuration files are:
   19: </p>
   20: <ul>
   21: <li><strong>loncapa.conf</strong> -
   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>
   28: <br />&nbsp;
   29: </li>
   30: <li><strong>hosts.tab</strong> -
   31: typically located in the directory <tt>/home/httpd/lonTabs/</tt>;
   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 -->
   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>
   59: <p>
   60: LON-CAPA currently depends on the following list of configuration
   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.)
   66: </p>
   67: <ul>
   68: <li><a href="confexamples/loncapa.conf">[EXAMPLE]</a>
   69: /etc/httpd/conf/loncapa.conf</li>
   70: <li><a href="confexamples/hosts.tab">[EXAMPLE]</a>
   71: /home/httpd/lonTabs/hosts.tab</li>
   72: <li><a href="confexamples/spare.tab">[EXAMPLE]</a>
   73: /home/httpd/lonTabs/spare.tab</li>
   74: <li><a href="confexamples/krb.conf">[EXAMPLE]</a> /etc/krb.conf</li>
   75: <li><a href="confexamples/htpasswd">[EXAMPLE]</a>
   76: /home/httpd/lonTabs/htpasswd</li>
   77: <li><a href="confexamples/ntp.conf">[EXAMPLE]</a> /etc/ntp.conf</li>
   78: <li><a href="confexamples/step-tickers">[EXAMPLE]</a>
   79: /etc/ntp/step-tickers</li>
   80: <li><a href="confexamples/pwauth">[EXAMPLE]</a> /etc/pam.d/pwauth</li>
   81: </ul>
   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>
  101: <p>
  102: We do, however, provide example configurations of services that you
  103: may want to deliver with LON-CAPA (i.e. Samba and AppleChooser).
  104: </p>
  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>
  109: <!-- maintext end -->
  110: <!-- validated -->
  111: </body>
  112: </html>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>